Automatizar bibliotecas de variáveis usando APIs

Você pode usar as APIs REST do Microsoft Fabric para automatizar totalmente o gerenciamento de bibliotecas de variáveis no ALM (gerenciamento do ciclo de vida do aplicativo).

Se você estiver usando as APIs como parte do gerenciamento do ciclo de vida, as permissões para referência de item serão verificadas durante a atualização do Git e a implantação do pipeline.

Pré-requisitos

Para usar as APIs, você precisa:

• Os mesmos pré-requisitos do item de biblioteca de variáveis.
• Um token do Microsoft Entra para o serviço Fabric. Use o token no cabeçalho de autorização da chamada à API. Para obter informações sobre como obter um token, consulte Guia de início rápido da API do Fabric.

APIs variáveis de biblioteca

Você pode usar as APIs REST da biblioteca de variáveis para executar as seguintes funções:

• Criar uma biblioteca de variáveis: crie uma biblioteca de variáveis no workspace especificado.
• Obter uma biblioteca de variáveis: recuperar propriedades de uma biblioteca de variáveis. Você também pode recuperar o valor ativo definido usando o VariableLibraryProperties parâmetro.
• Atualizar uma biblioteca de variáveis: atualize as propriedades de uma biblioteca de variáveis. Você também pode atualizar o conjunto de valores ativos usando o VariableLibraryProperties parâmetro.
• Excluir uma biblioteca de variáveis: exclua a biblioteca de variáveis especificada.
• Listar bibliotecas de variáveis: listar bibliotecas de variáveis no workspace especificado.
• Obtenha a definição de uma biblioteca de variáveis: recupere a definição pública de uma biblioteca de variáveis.
• Atualize a definição de uma biblioteca de variáveis: substitua a definição de uma biblioteca de variáveis.

As APIs REST da biblioteca de variáveis dão suporte a entidades de serviço.

Exemplos

Para obter alguns exemplos de como usar as APIs, consulte a documentação REST para cada API.

Para obter um detalhamento da estrutura de definição de uma biblioteca de variáveis, consulte a definição da biblioteca de variáveis.

Considerações e limitações

Limitações de tamanho

• Pode haver até 1.000 variáveis e até 1.000 conjuntos de valores, desde que você atenda a ambos os requisitos:

  • O número total de células nos conjuntos de valores alternativos é menor que 10.000.
  • O tamanho do item não excede 1 MB.

  Esses requisitos são validados quando você salva as alterações.

• O campo de observação pode ter até 2.048 caracteres.

• O campo de descrição do conjunto de valores pode ter até 2.048 caracteres.

Limitações para conjuntos de valores alternativos

• Conjuntos de valores alternativos em uma biblioteca de variáveis aparecem na ordem em que você os adicionou. Atualmente, você não pode reordená-los na interface do usuário. Para alterar a ordem, edite o arquivo JSON diretamente.
• O nome de cada conjunto de valores deve ser exclusivo em uma biblioteca de variáveis.
• Os nomes de variáveis devem ser exclusivos em uma biblioteca de variáveis. Você pode ter duas variáveis com o mesmo nome em um workspace se elas estiverem em itens diferentes.
• Há sempre um (e apenas um) valor ativo definido em uma biblioteca de variáveis de cada vez. Não é possível excluir um conjunto de valores enquanto ele estiver ativo. Para excluí-lo, primeiro configure outro conjunto de valores para estar ativo. Você pode definir um valor ativo diferente para cada estágio de um pipeline de implantação.