Automatize 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 gerenciamento do ciclo de vida do aplicativo (ALM).

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 que para o item de biblioteca variável.
• Um token do Microsoft Entra para o serviço Fabric. Use o token no cabeçalho de autorização da chamada de API. Para obter informações sobre como obter um token, consulte Fabric API quickstart.

APIs de biblioteca variável

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 espaço de trabalho especificado.
• Obter uma biblioteca de variáveis: recupere 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 valor ativo definido usando o VariableLibraryProperties parâmetro.
• Excluir uma biblioteca de variáveis: exclua a biblioteca de variáveis especificada.
• Listar bibliotecas de variáveis: liste bibliotecas de variáveis no espaço de trabalho especificado.
• Obter a definição de uma biblioteca de variáveis: recupere a definição pública de uma biblioteca de variáveis.
• Atualizar a definição de uma biblioteca de variáveis: substituir a definição de uma biblioteca de variáveis.

As APIs REST da biblioteca de variáveis suportam entidades de serviço.

Exemplos

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

Para obter um detalhamento da estrutura de definição de uma biblioteca de variáveis, consulte Definição de 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 é inferior a 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 notas 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

• Os conjuntos de valores alternativos em uma biblioteca de variáveis aparecem na ordem em que foram adicionados. Atualmente, não é possível 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 dentro de uma biblioteca de variáveis.
• Os nomes das variáveis devem ser exclusivos dentro de uma biblioteca de variáveis. Você pode ter duas variáveis com o mesmo nome em um espaço de trabalho se elas estiverem em itens diferentes.
• Há sempre um (e apenas um) valor ativo definido em uma biblioteca variável 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 ter um valor ativo diferente definido para cada estágio de um pipeline de implantação.