Compartilhar via


az apic

Note

Essa referência faz parte da extensão apic-extension para a CLI do Azure (versão 2.57.0 ou superior). A extensão instalará automaticamente na primeira vez que você executar um comando az apic . Saiba mais sobre extensões.

Gerenciar serviços do Centro de API do Azure.

Comandos

Nome Description Tipo Status
az apic api

Comandos para gerenciar APIs no API Center.

Extension GA
az apic api-analysis

Gerenciar recursos de análise de API de serviço do Centro de API do Azure.

Extension Preview
az apic api-analysis create

Crie novas ou atualize a configuração do analisador de API existente.

Extension Preview
az apic api-analysis delete

Excluir exclui a configuração do analisador de API.

Extension Preview
az apic api-analysis export-ruleset

Exporta o conjunto de regras do analisador de API.

Extension Preview
az apic api-analysis import-ruleset

Importa o conjunto de regras do analisador de API.

Extension Preview
az apic api-analysis list

Listar configurações do analisador de API.

Extension Preview
az apic api-analysis show

Obtenha detalhes da configuração do analisador de API.

Extension Preview
az apic api-analysis update

Atualize nova ou atualize a configuração do analisador de API existente.

Extension Preview
az apic api create

Registre uma nova API ou atualize uma API existente.

Extension GA
az apic api definition

Comandos para gerenciar definições de API no Centro de API.

Extension GA
az apic api definition create

Crie uma nova definição de API ou atualize uma definição de API existente.

Extension GA
az apic api definition delete

Exclua a definição de API especificada.

Extension GA
az apic api definition export-specification

Exporta a especificação da API.

Extension GA
az apic api definition import-specification

Importa a especificação da API.

Extension GA
az apic api definition list

Listar uma coleção de definições de API.

Extension GA
az apic api definition show

Obtenha detalhes da definição da API.

Extension GA
az apic api definition update

Atualize a definição de API existente.

Extension GA
az apic api delete

Exclua a API especificada.

Extension GA
az apic api deployment

Comandos para gerenciar implantações de API no Centro de API.

Extension GA
az apic api deployment create

Crie uma nova implantação de API ou atualize uma implantação de API existente.

Extension GA
az apic api deployment delete

Excluir implantação de API.

Extension GA
az apic api deployment list

Listar uma coleção de implantações de API.

Extension GA
az apic api deployment show

Obtenha detalhes da implantação da API.

Extension GA
az apic api deployment update

Atualize a implantação de API existente.

Extension GA
az apic api list

Liste uma coleção de APIs.

Extension GA
az apic api register

Registra uma nova API com versão, definição e implantações associadas usando o arquivo de especificação como a fonte da verdade. Por enquanto, oferecemos suporte apenas ao formato OpenAPI JSON/YAML.

Extension Preview
az apic api show

Obtenha detalhes da API.

Extension GA
az apic api update

Atualize a API existente.

Extension GA
az apic api version

Comandos para gerenciar versões de API no Centro de APIs.

Extension GA
az apic api version create

Crie uma nova versão da API ou atualize uma versão existente da API.

Extension GA
az apic api version delete

Exclua a versão da API especificada.

Extension GA
az apic api version list

Liste uma coleção de versões de API.

Extension GA
az apic api version show

Obtenha detalhes da versão da API.

Extension GA
az apic api version update

Atualize a versão existente da API.

Extension GA
az apic create

Cria uma instância ou atualiza uma instância existente de um serviço do Centro de API do Azure.

Extension GA
az apic delete

Exclui uma instância de um serviço do Centro de API do Azure.

Extension GA
az apic environment

Comandos para gerenciar ambientes no API Center.

Extension GA
az apic environment create

Crie um novo ambiente ou atualize um ambiente existente.

Extension GA
az apic environment delete

Exclua o ambiente.

Extension GA
az apic environment list

Liste uma coleção de ambientes.

Extension GA
az apic environment show

Obtenha detalhes do ambiente.

Extension GA
az apic environment update

Atualize o ambiente existente.

Extension GA
az apic integration

Gerencia integrações no Centro de API do Azure.

Extension GA
az apic integration create

Gerenciar serviços do Centro de API do Azure.

Extension GA
az apic integration create apim

Adicione o APIM do Azure como uma fonte de API.

Extension GA
az apic integration create aws

Adicione o Gateway de API da Amazon como uma fonte de API.

Extension GA
az apic integration delete

Excluir a origem da API especificada.

Extension GA
az apic integration list

Listar uma coleção de fontes de API.

Extension GA
az apic integration show

Obtenha detalhes da origem da API.

Extension GA
az apic list

Lista os serviços do Centro de API do Azure em uma assinatura do Azure.

Extension GA
az apic metadata

Comandos para gerenciar esquemas de metadados no Centro de API.

Extension GA
az apic metadata create

Crie um novo esquema de metadados ou atualize um esquema de metadados existente.

Extension GA
az apic metadata delete

Exclua o esquema de metadados especificado.

Extension GA
az apic metadata export

Exporta o esquema de metadados.

Extension GA
az apic metadata list

Listar uma coleção de esquemas de metadados.

Extension GA
az apic metadata show

Obtenha detalhes do esquema de metadados.

Extension GA
az apic metadata update

Atualize o esquema de metadados existente.

Extension GA
az apic show

Mostrar detalhes de uma instância de serviço do Centro de API do Azure.

Extension GA
az apic update

Atualize uma instância de um serviço do Centro de API do Azure.

Extension GA

az apic create

Cria uma instância ou atualiza uma instância existente de um serviço do Centro de API do Azure.

az apic create --name
               --resource-group
               [--identity]
               [--location]
               [--tags]

Exemplos

Criar exemplo de serviço

az apic create -g contoso-resources -n contoso -l eastus

Criar serviço com o exemplo de identidade atribuída pelo sistema

az apic create -g contoso-resources -n contoso -l eastus --identity '{type:systemassigned}'

Parâmetros Exigidos

--name -n

O nome do serviço do Centro de API.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--identity

As identidades de serviço gerenciadas atribuídas a esse recurso. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

--location -l

A localização geográfica onde o recurso reside Quando não especificado, o local do grupo de recursos será usado.

--tags

Tags de recursos. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az apic delete

Exclui uma instância de um serviço do Centro de API do Azure.

az apic delete [--ids]
               [--name]
               [--resource-group]
               [--subscription]
               [--yes]

Exemplos

Excluir serviço

az apic delete -n contoso -g contoso-resources

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

O nome do serviço do Centro de API.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--yes -y

Não solicite confirmação.

Propriedade Valor
Valor padrão: False
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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.

--verbose

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

Propriedade Valor
Valor padrão: False

az apic list

Lista os serviços do Centro de API do Azure em uma assinatura do Azure.

Há um problema conhecido de que listar todos os recursos em uma assinatura não funciona. Liste os recursos por grupo de recursos.

az apic list [--max-items]
             [--next-token]
             [--resource-group]

Exemplos

Listar serviços no grupo de recursos

az apic list -g contoso-resources

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--max-items

Número total de itens a serem retornados na saída do comando. Se o número total de itens disponíveis for maior do que o valor especificado, um token será fornecido na saída do comando. Para retomar a paginação, forneça o valor do token em --next-token argumento de um comando subsequente.

Propriedade Valor
Grupo de parâmetros: Pagination Arguments
--next-token

Token para especificar onde iniciar a paginação. Esse é o valor do token de uma resposta truncada anteriormente.

Propriedade Valor
Grupo de parâmetros: Pagination Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az apic show

Mostrar detalhes de uma instância de serviço do Centro de API do Azure.

az apic show [--ids]
             [--name]
             [--resource-group]
             [--subscription]

Exemplos

Mostrar detalhes do serviço

az apic show -g contoso-resources -n contoso

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

O nome do serviço do Centro de API.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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.

--verbose

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

Propriedade Valor
Valor padrão: False

az apic update

Atualize uma instância de um serviço do Centro de API do Azure.

az apic update [--add]
               [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
               [--identity]
               [--ids]
               [--name]
               [--remove]
               [--resource-group]
               [--set]
               [--subscription]
               [--tags]

Exemplos

Atualizar detalhes do serviço

az apic update -g contoso-resources -n contoso

Exemplo de atualização do serviço com identidade atribuída pelo sistema

az apic update -g contoso-resources -n contoso --identity '{type:systemassigned}'

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valor de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
--force-string

Ao usar 'set' ou 'add', preserve literais de cadeia de caracteres em vez de tentar converter em JSON.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--identity

As identidades de serviço gerenciadas atribuídas a esse recurso. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

O nome do serviço do Centro de API.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=<value>.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--tags

Tags de recursos. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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.

--verbose

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

Propriedade Valor
Valor padrão: False