az logicapp connection

Note

Esta referência faz parte da extensão logicapp para a CLI do Azure (versão 2.67.0 ou superior). A extensão instala-se automaticamente na primeira vez que executares um comando de ligação az logicapp . Saiba mais sobre extensões.

Criar a localização local e inspecionar as ligações Logic Apps Standard implementadas.

Comandos

Nome Descrição Tipo Estado
az logicapp connection acl

Gerir políticas de acesso numa ligação API gerida.

Extension disponibilidade geral
az logicapp connection acl add

Conceda a uma identidade Entra acesso a uma ligação API gerida.

Extension disponibilidade geral
az logicapp connection acl list

Liste as políticas de acesso numa ligação API gerida.

Extension disponibilidade geral
az logicapp connection acl remove

Remover uma política de acesso de uma ligação API gerida.

Extension disponibilidade geral
az logicapp connection acl show

Mostrar uma política de acesso numa ligação API gerida.

Extension disponibilidade geral
az logicapp connection create

Adicione uma ligação de fornecedor de serviços a um projeto local, ou uma ligação à API gerida a uma aplicação implementada.

Extension disponibilidade geral
az logicapp connection delete

Remover uma ligação de uma aplicação Logic implementada.

Extension disponibilidade geral
az logicapp connection list

Liste ligações ligadas a uma aplicação Logic App Standard implementada.

Extension disponibilidade geral
az logicapp connection managed

Criar ligações API geridas pelo Azure para projetos locais ou sites Standard implementados.

Extension disponibilidade geral
az logicapp connection managed create

Crie uma ligação à API gerida do Azure e ligue um projeto local ou uma aplicação implementada.

Extension disponibilidade geral
az logicapp connection show

Mostrar uma ligação ligada a uma aplicação Logic App Standard implementada.

Extension disponibilidade geral
az logicapp connection test

Teste uma ligação Logic Apps Standard configurada.

Extension disponibilidade geral

az logicapp connection create

Adicione uma ligação de fornecedor de serviços a um projeto local, ou uma ligação à API gerida a uma aplicação implementada.

Dois modos. Por defeito, isto grava uma ligação de fornecedor de serviços num projeto local. Com --managed-api, cria-se antes uma ligação Azure managed API para uma Logic App implementada, e --name significa a Logic App em vez da ligação; nomeie a ligação com --connection-name.

Modo local: Escreve a ligação em connections.json e qualquer valor secreto em local.settings.json, que o pacote de implementação exclui. Um segredo nunca é aceite na linha de comandos: --o segredo nomeia a definição da aplicação e o valor é lido a partir da entrada padrão. Para ligações baseadas em identidade, omitem --secret completamente e forneçam --parâmetro NAME=VALUE em vez disso; dots aninham valores, por isso authProvider.Type torna-se um objeto aninhado, que é o que o runtime requer. Os parâmetros obtidos a partir da configuração da app precisam de uma configuração correspondente. local.settings.json é adicionado ao .gitignore, a menos que --no-gitignore seja dado. Não idempotente: falha se a configuração de ligação ou aplicação já existir, por isso é seguro tentar novamente apenas com --force.

Modo API gerida (--managed-api): Cria três coisas acopladas, porque a primeira sozinha é inutilizável: o recurso ARM Microsoft. Web/conexões, uma política de acesso que nomeia a identidade gerida da aplicação e uma entrada ApiConnections gerida na connections.jsonda aplicação. A ligação é sempre criada com o tipo V2, uma vez que as ligações V1 rejeitam políticas de acesso e o tipo não pode ser alterado posteriormente. A aplicação já deve ter uma identidade gerida; sem uma, o comando para antes de criar qualquer coisa. Também é necessário um connections.json válido existente com um ETag VFS forte antes de mutações ARM. Ficheiros em falta ou revisões não versionadas/fracas falham no fechamento; a CLI não tenta escritas de ficheiros apenas de criação não qualificadas. A restauração de publicações e entradas de ficheiros utiliza exatamente o ETag de releitura recente, nunca um coringa. Os conflitos de revisão não são retentados; os guardas de ficheiros não são uma transação ARM. --oauth em modo de autenticação abre um navegador para que possas aprovar a ligação. A CLI ouve numa porta de loopback para o redirecionamento, que é assim que aprende o consentimento terminado; o serviço de consentimento resgata o código de autorização ele próprio, pelo que a callback normalmente não transporta código e nada mais é confirmado. Use --no-browser numa máquina headless para imprimir o URL em vez de lançar um. Se falhar o consentimento, a criação de políticas de acesso ou connections.json cablagem, os recursos e políticas de acesso ARM são mantidos para inspeção manual. Um PUT incondicional pode atualizar o recurso de outro escritor mesmo após ausência pré-voo; não autoriza eliminação automática ou restauro de políticas. Propriedades, credenciais ou acesso concedido podem ter mudado. Inspecionar e recuperar deliberadamente o estado retido antes de tentar novamente; --força não é garantia de concorrência. Apenas se tenta a restauração de entradas de ficheiros protegidas. As credenciais existentes nem sempre podem ser recuperadas a partir da leitura ARM. Um connections.json existente ilegível ou deformado não é substituído por um ficheiro vazio.

No PowerShell do Windows, um @appsetting(valor 'NOME') tem de chegar intacto a az. O PowerShell encaminha os parênteses não aspas para cmd.exe, que termina o bloco IF EXIST dentro de az.cmd e falha com "--parâmetro era inesperado neste momento". Insira o token PowerShell de stop-parsing imediatamente antes do primeiro parâmetro -- para passar o resto da linha sem analisar.

az logicapp connection create --connector
                              --name
                              [--acquire-policy-token]
                              [--app-setting]
                              [--auth-mode {managed-identity, oauth, raw, service-principal}]
                              [--change-reference]
                              [--connection-name]
                              [--consent-timeout]
                              [--context]
                              [--display-name]
                              [--force]
                              [--location]
                              [--managed-api]
                              [--no-browser]
                              [--no-gitignore]
                              [--parameter]
                              [--parameter-set]
                              [--path]
                              [--resource-group]
                              [--secret]
                              [--secret-parameter]
                              [--user-assigned-identity]

Exemplos

Adicione uma ligação ao Service Bus, valor canalizado (PowerShell).

$env:SB_CONNECTION | az logicapp connection create --path .\orders --name serviceBus --connector serviceBus --secret serviceBus_connectionString

Adicione uma ligação Service Bus, valor canalizado (bash).

printf '%s' "$SB_CONNECTION" | az logicapp connection create --path ./orders --name serviceBus --connector serviceBus --secret serviceBus_connectionString

Adicione uma ligação Service Bus que use identidade gerida, sem segredo em lado nenhum.

az logicapp connection create --path ./orders --name serviceBus --connector serviceBus --parameter-set ManagedServiceIdentity --parameter "fullyQualifiedNamespace=@appsetting('serviceBus_fullyQualifiedNamespace')" authProvider.Type=ManagedServiceIdentity --app-setting serviceBus_fullyQualifiedNamespace=contoso.servicebus.windows.net

Crie uma ligação API gerida pelo Azure Blob que autentique como identidade da aplicação.

az logicapp connection create --managed-api -g rg-lacli-ri2bg8 -n la-cli-pilot-ri2bg8 --connection-name blobProd --connector azureblob -l eastus --auth-mode managed-identity

Crie uma ligação ao Office 365 e aprove-a num navegador.

az logicapp connection create --managed-api -g rg-lacli-ri2bg8 -n la-cli-pilot-ri2bg8 --connection-name outlook --connector office365 -l eastus --auth-mode oauth

O mesmo, numa máquina headless – imprime o URL de consentimento em vez de abrir um navegador.

az logicapp connection create --managed-api -g rg-lacli-ri2bg8 -n la-cli-pilot-ri2bg8 --connection-name outlook --connector office365 -l eastus --auth-mode oauth --no-browser

Parâmetros Obrigatórios

--connector

Conector de fornecedor de serviços, por exemplo 'serviceBus'.

--name -n

Nome da ligação referenciado pelos fluxos de trabalho. Com --managed-api, este é o nome da Logic App, e a ligação é nomeada por --connection-name.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--app-setting

Definição de aplicação não secreta como NOME=VALOR, repetível. Escrito para local.settings.json parâmetros provenientes da configuração da aplicação.

--auth-mode

Autenticação que a ligação utiliza. A OAUTH abre um navegador para obter consentimento. É obrigatório com --managed-api.

Propriedade Valor
Valores aceites: managed-identity, oauth, raw, service-principal
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--connection-name

Nome da ligação à API gerida a criar. É obrigatório com --managed-api.

--consent-timeout

Segundos para esperar pelo consentimento do navegador antes de falhar. Padrão 300. Os recursos de ligação/política de acesso podem ser mantidos; inspecione-os antes de tentar novamente. Só com --auth-mode oauth.

Propriedade Valor
Grupo de parâmetros: OAuth consent Arguments
--context

Contexto local do projeto nomeado. Os contextos na cloud são recusados; indisponíveis no modo legacy --managed-API.

--display-name

Nome de exibição para a ligação. Por defeito, é --nome-conexão.

--force

Substitua uma ligação ou configuração de aplicação existente.

Propriedade Valor
Valor predefinido: False
--location -l

Localização do Azure para a ligação e a sua API gerida. É obrigatório com --managed-api.

--managed-api

Modo de compatibilidade obsoleto. Prefira ligação gerida criar --nome CONEXÃO --logic-app-nome APP. Legado -- nome ainda significa a aplicação.

Propriedade Valor
Valor predefinido: False
--no-browser

Imprime o URL de consentimento em vez de lançar um navegador. O comando ainda escuta o redirecionamento, por isso o navegador deve conseguir aceder a esta máquina em loopback. Só com --auth-mode oauth.

Propriedade Valor
Grupo de parâmetros: OAuth consent Arguments
Valor predefinido: False
--no-gitignore

Não adiciones local.settings.json ao .gitignore.

Propriedade Valor
Valor predefinido: False
--parameter

Parâmetro de ligação como NOME=VALOR, repetível. Use pontos para aninhar, por exemplo authProvider.Type=Managed ServiceIdentity. Os valores não devem ser segredos.

--parameter-set

Nome do conjunto de parâmetros do conector. Por defeito é connectionString.

--path

Raiz do projeto existente. Por defeito, é o caminho do contexto local ou o diretório atual.

--resource-group -g

Grupo de recursos da Logic App. É obrigatório com --managed-api.

--secret

Definição da aplicação NAME que guarda um segredo. O valor é lido a partir da entrada padrão e nunca da linha de comandos. Omita ligações baseadas na identidade.

--secret-parameter

Caminho do parâmetro ao qual o segredo se liga. Por defeito é connectionString.

--user-assigned-identity

ID de recurso de uma identidade atribuída pelo utilizador já atribuída à aplicação. Por defeito é a identidade atribuída pelo sistema.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False

az logicapp connection delete

Remover uma ligação de uma aplicação Logic implementada.

Remove a connections.json entrada. Para uma ligação gerida à API, apenas as políticas de acesso que correspondam à identidade atribuída exclusivamente ao sistema da entrada podem ser removidas, e o recurso só é eliminado quando a propriedade exclusiva é estabelecida. As identidades atribuídas pelo utilizador podem ser partilhadas por várias aplicações, pelo que as suas políticas e recursos de ligação são mantidos, com uma razão reportada. Identidades simplesmente atribuídas a esta aplicação não são prova de propriedade da ligação. Passe --keep-resource para manter o recurso mesmo para uma política exclusivamente detida; esta bandeira não revoga o acesso de identidade partilhado atribuído pelo utilizador. As definições de aplicação referenciadas por uma ligação de um fornecedor de serviços nunca são apagadas, apenas reportadas, pois outras ligações podem ainda as ler. A remoção requer um ETag forte do connections.json atual para reler e enviar exatamente essa revisão. ETags em falta/fracos ou um conflito de revisão param o comando sem limpeza do ARM ou uma tentativa incondicional. Verificações de receção/leitura VFS continuam a ser necessárias; estas não são transações entre recursos. O ID de ligação gerido criado deve ser um ID de recurso relativo canónico na subscrição e grupo de recursos selecionados. IDs absolutos, malformados ou cross-scope recusam-se antes do acesso ou desligamento do ARM por recurso de conexão, incluindo com --keep-resource. Gerir recursos de âmbito múltiplo explicitamente.

az logicapp connection delete --connection
                              --name
                              --resource-group
                              [--acquire-policy-token]
                              [--change-reference]
                              [--class {managedApiConnections, serviceProviderConnections}]
                              [--keep-resource]
                              [--yes]

Exemplos

Remova uma ligação de uma aplicação, sem necessidade de ser solicitado.

az logicapp connection delete -g rg-lacli-ri2bg8 -n la-cli-pilot-ri2bg8 --connection cliPilotBlob --yes

Remova a entrada e as apólices exclusivas desta aplicação, mantendo o recurso.

az logicapp connection delete -g rg-lacli-ri2bg8 -n la-cli-pilot-ri2bg8 --connection sharedBlob --keep-resource --yes

Desambigue um nome que exista em ambas as classes de ligação.

az logicapp connection delete -g rg-lacli-ri2bg8 -n la-cli-pilot-ri2bg8 --connection blob --class managedApiConnections --yes

Parâmetros Obrigatórios

--connection

Nome da ligação em connections.json.

--name -n

Nome do site Logic App Standard.

--resource-group -g

Nome do grupo de recursos que contém o site Logic App Standard.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--class

Classe de ligação para pesquisa. É obrigatório apenas quando o mesmo nome existe em ambas as aulas.

Propriedade Valor
Valores aceites: managedApiConnections, serviceProviderConnections
--keep-resource

Mantém o recurso de ligação ARM. Remover apenas políticas de acesso exclusivamente pertencentes a esta aplicação; as políticas de identidade partilhadas atribuídas pelo utilizador são mantidas. Apenas ligações API geridas.

Propriedade Valor
Valor predefinido: False
--yes -y

Não solicite confirmação.

Propriedade Valor
Valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False

az logicapp connection list

Liste ligações ligadas a uma aplicação Logic App Standard implementada.

Lê apenas o ficheiro connections.json da aplicação através do proxy VFS ARM. Esta é a fiação do plano de ficheiros que os fluxos de trabalho podem usar; não se reconcilia com o ARM Microsoft. Recursos web/conexões, por isso ligações criadas por ARM mas sem ligação e referências de ficheiros pendentes não são apresentadas. parameterValues e URLs de runtime são censurados por defeito.

az logicapp connection list --name
                            --resource-group
                            [--continuation-token --next-token]
                            [--max-items]
                            [--show-runtime-urls]

Exemplos

Lista ligações por aplicativo por cabo.

az logicapp connection list --resource-group rg-lacli-ri2bg8 --name la-cli-pilot-ri2bg8

Liste as ligações por cabo da app, incluindo URLs de runtime.

az logicapp connection list -g rg-lacli-ri2bg8 -n la-cli-pilot-ri2bg8 --show-runtime-urls

Parâmetros Obrigatórios

--name -n

Nome do site Logic App Standard.

--resource-group -g

Nome do grupo de recursos que contém o site Logic App Standard.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--continuation-token --next-token

Token retornado como nextContinuationToken por uma chamada anterior, para obter a página seguinte.

Propriedade Valor
Grupo de parâmetros: Pagination Arguments
--max-items

Número máximo de ligações a devolver nesta página.

Propriedade Valor
Grupo de parâmetros: Pagination Arguments
--show-runtime-urls

Mostrar URLs de execução da ligação. O padrão redige-os.

Propriedade Valor
Valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False

az logicapp connection show

Mostrar uma ligação ligada a uma aplicação Logic App Standard implementada.

Só lê connections.json através do proxy ARM VFS. Esta vista do plano de ficheiros pode diferir da ARM Microsoft. Inventário web/ligações. parameterValues e URLs de runtime são censurados por defeito; use --show-runtime-urls apenas quando precisar do URL de runtime na sua shell atual.

az logicapp connection show --connection
                            --name
                            --resource-group
                            [--class {managedApiConnections, serviceProviderConnections}]
                            [--show-runtime-urls]

Exemplos

Mostrar uma ligação com fio por aplicação.

az logicapp connection show --resource-group rg-lacli-ri2bg8 --name la-cli-pilot-ri2bg8 --connection cliPilotBlob

Mostrar uma ligação API gerida da classe gerida.

az logicapp connection show -g rg-lacli-ri2bg8 -n la-cli-pilot-ri2bg8 --connection office365-prod --class managedApiConnections

Parâmetros Obrigatórios

--connection

Nome da ligação em connections.json.

--name -n

Nome do site Logic App Standard.

--resource-group -g

Nome do grupo de recursos que contém o site Logic App Standard.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--class

Classe de ligação para pesquisa.

Propriedade Valor
Valores aceites: managedApiConnections, serviceProviderConnections
--show-runtime-urls

Mostrar URLs de execução da ligação. O padrão redige-os.

Propriedade Valor
Valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False

az logicapp connection test

Teste uma ligação Logic Apps Standard configurada.

Testa uma ligação de fornecedor de serviço com fio por app, uma ligação API gerida por aplicação ou um Microsoft ARM. ID de recurso web/conexões. Um conector sem endpoint de teste anunciado não é tratado como saudável: o comando reporta o resultado noTestAvailable, diz que a ligação não foi verificada e sai 3. As respostas 5xx devolvidas são falhas, e as respostas 429 são podemNãoAlcançar com retryAfter preservadas quando fornecidas.

az logicapp connection test --connection
                            --name
                            --resource-group
                            [--acquire-policy-token]
                            [--change-reference]
                            [--class {managedApiConnections, serviceProviderConnections}]

Exemplos

Testa uma ligação com fios de aplicação pelo nome.

az logicapp connection test --resource-group rg-lacli-ri2bg8 --name la-cli-pilot-ri2bg8 --connection cliPilotBlob

Teste um recurso de ligação ARM gerido por id.

az logicapp connection test -g rg-lacli-ri2bg8 -n la-cli-pilot-ri2bg8 --connection /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg-lacli-ri2bg8/providers/Microsoft.Web/connections/office365-prod

Parâmetros Obrigatórios

--connection

Nome da ligação ou ARM Microsoft. ID web/ligações.

--name -n

Nome do site Logic App Standard.

--resource-group -g

Nome do grupo de recursos que contém o site Logic App Standard.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--class

Classe de conexão para pesquisar quando --conexão é um nome.

Propriedade Valor
Valores aceites: managedApiConnections, serviceProviderConnections
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False