Partilhar via

az iot ops registry

Note

Essa referência faz parte da extensão azure-iot-ops para a CLI do Azure (versão 2.67.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando de registro az iot ops . Saiba mais sobre extensões.

Gerencie pontos de extremidade do registro de contêiner.

Comandos

Name Description Tipo Status
az iot ops registry create

Crie um ponto de extremidade do registro de contêiner para uma instância.

 Extension disponibilidade geral
az iot ops registry delete

Exclua um ponto de extremidade do Registro de contêiner.

 Extension disponibilidade geral
az iot ops registry list

Listar pontos de extremidade de registro de contêiner configurados.

 Extension disponibilidade geral
az iot ops registry show

Mostrar detalhes de um ponto de extremidade do Registro de contêiner.

 Extension disponibilidade geral
az iot ops registry update

Atualize um ponto de extremidade do Registro de contêiner.

 Extension disponibilidade geral

az iot ops registry create

Crie um ponto de extremidade do registro de contêiner para uma instância.

Por padrão, o ponto de extremidade do Registro usará a autenticação de Identidade Gerenciada Atribuída pelo Sistema. Use o sinalizador --no-auth para configurar explicitamente a autenticação anônima.

az iot ops registry create --host
                           --instance
                           --name
                           --resource-group
                           [--aud --audience]
                           [--auth-type {Anonymous, ArtifactPullSecret, SystemAssignedManagedIdentity, UserAssignedManagedIdentity}]
                           [--cid --client-id]
                           [--cs-config-map-refs --cscmr]
                           [--cs-secret-refs --cssr]
                           [--no-auth {false, true}]
                           [--scope]
                           [--secret-ref]
                           [--tenant-id --tid]

Exemplos

Crie um ponto de extremidade do Registro com a autenticação padrão de Identidade Gerenciada Atribuída pelo Sistema.

az iot ops registry create -n myregistry --host myregistry.azurecr.io -i myinstance -g myresourcegroup

Crie um ponto de extremidade do Registro com autenticação anônima explícita.

az iot ops registry create -n myregistry --host myregistry.azurecr.io -i myinstance -g myresourcegroup --no-auth

Criar um ponto de extremidade do Registro com identidade gerenciada atribuída pelo sistema e configuração de audiência opcional

az iot ops registry create -n myregistry --host myregistry.azurecr.io -i myinstance -g myresourcegroup --auth-type SystemAssignedManagedIdentity --aud myaudience

Criar um ponto de extremidade do registro com autenticação de referência secreta do kubernetes

az iot ops registry create -n myregistry --host myregistry.azurecr.io -i myinstance -g myresourcegroup --auth-type ArtifactPullSecret --secret-ref mysecret

Criar um ponto de extremidade do Registro com configuração de identidade gerenciada atribuída pelo usuário

az iot ops registry create -n myregistry --host myregistry.azurecr.io -i myinstance -g myresourcegroup --auth-type UserAssignedManagedIdentity --scope myscope --cid myclientid --tid mytenantid

Criar um ponto de extremidade do Registro com uma referência secreta de CA de assinatura de código

az iot ops registry create -n myregistry --host myregistry.azurecr.io -i myinstance -g myresourcegroup --cs-secret-refs mysecret

Criar um ponto de extremidade do Registro com várias referências de código de assinatura de CA, secreto e configmap

az iot ops registry create -n myregistry --host myregistry.azurecr.io -i myinstance -g myresourcegroup --cs-config-map-refs configmap1 configmap2 --cs-secret-refs secret1 secret2

Parâmetros Obrigatórios

--host

O ponto de extremidade do Registro de Contêiner do Azure.

--instance -i

Nome da instância de Operações IoT.

--name -n

Nome do ponto de extremidade do Registro.

--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 tornar-se necessários para que o comando seja executado com êxito.

--aud --audience

Audiência para autenticação de registro de identidade gerenciada atribuída pelo sistema.

Propriedade Valor
Grupo de parâmetros: System-Assigned Identity Arguments
--auth-type

O tipo de autenticação para o ponto de extremidade do Registro. Se não for fornecido, o tipo de autenticação será determinado com base nos parâmetros de autenticação fornecidos. Se nenhum parâmetro de autenticação for fornecido, a autenticação de identidade gerenciada atribuída ao sistema será usada.

Propriedade Valor
Valores aceites: Anonymous, ArtifactPullSecret, SystemAssignedManagedIdentity, UserAssignedManagedIdentity
--cid --client-id

ID do cliente para autenticação de registro de identidade gerenciada atribuída pelo usuário.

Propriedade Valor
Grupo de parâmetros: User-Assigned Identity Arguments
--cs-config-map-refs --cscmr

Lista separada por espaço de referências de mapa de configuração de CA de assinatura de código.

Propriedade Valor
Grupo de parâmetros: Code Signing CA Arguments
--cs-secret-refs --cssr

Lista separada por espaços de referências secretas da autoridade de certificação de assinatura de código.

Propriedade Valor
Grupo de parâmetros: Code Signing CA Arguments
--no-auth

Use explicitamente a autenticação anônima.

Propriedade Valor
Valores aceites: false, true
--scope

Escopo para autenticação de registro de identidade gerenciada atribuída pelo usuário.

Propriedade Valor
Grupo de parâmetros: User-Assigned Identity Arguments
--secret-ref

Referência secreta do Kubernetes para autenticação do registro.

Propriedade Valor
Grupo de parâmetros: Artifact Pull Secret Arguments
--tenant-id --tid

ID do locatário para autenticação de registro de identidade gerenciada atribuída pelo usuário.

Propriedade Valor
Grupo de parâmetros: User-Assigned Identity Arguments
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: 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 da subscrição. 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
Default value: False

az iot ops registry delete

Exclua um ponto de extremidade do Registro de contêiner.

az iot ops registry delete --instance
                           --name
                           --resource-group
                           [--yes {false, true}]

Exemplos

Exclua um ponto de extremidade do Registro.

az iot ops registry delete -n myregistry -i myinstance -g myresourcegroup

Parâmetros Obrigatórios

--instance -i

Nome da instância de Operações IoT.

--name -n

Nome do ponto de extremidade do Registro.

--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 tornar-se necessários para que o comando seja executado com êxito.

--yes -y

Confirme [s]es sem um prompt. Útil para cenários de CI e automação.

Propriedade Valor
Valores aceites: false, true
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: 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 da subscrição. 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
Default value: False

az iot ops registry list

Listar pontos de extremidade de registro de contêiner configurados.

az iot ops registry list --instance
                         --resource-group

Exemplos

Liste todos os pontos de extremidade do Registro para uma instância.

az iot ops registry list -i myinstance -g myresourcegroup

Parâmetros Obrigatórios

--instance -i

Nome da instância de Operações IoT.

--resource-group -g

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

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: 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 da subscrição. 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
Default value: False

az iot ops registry show

Mostrar detalhes de um ponto de extremidade do Registro de contêiner.

az iot ops registry show --instance
                         --name
                         --resource-group

Exemplos

Mostrar detalhes de um ponto de extremidade do Registro.

az iot ops registry show -n myregistry -i myinstance -g myresourcegroup

Parâmetros Obrigatórios

--instance -i

Nome da instância de Operações IoT.

--name -n

Nome do ponto de extremidade do Registro.

--resource-group -g

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

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: 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 da subscrição. 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
Default value: False

az iot ops registry update

Atualize um ponto de extremidade do Registro de contêiner.

Nota: a atualização das propriedades de referência da autoridade de certificação de assinatura de código substituirá o mapa de configuração existente e as referências secretas.

az iot ops registry update --instance
                           --name
                           --resource-group
                           [--aud --audience]
                           [--auth-type {Anonymous, ArtifactPullSecret, SystemAssignedManagedIdentity, UserAssignedManagedIdentity}]
                           [--cid --client-id]
                           [--cs-config-map-refs --cscmr]
                           [--cs-secret-refs --cssr]
                           [--host]
                           [--no-auth {false, true}]
                           [--scope]
                           [--secret-ref]
                           [--tenant-id --tid]

Exemplos

Atualizar o nome de host e o tipo de autenticação de um ponto de extremidade para usar uma identidade gerenciada atribuída ao sistema

az iot ops registry update -n myregistry --host newregistry.azurecr.io -i myinstance -g myresourcegroup --auth-type SystemAssignedManagedIdentity

Atualizar um ponto de extremidade para definir uma referência de mapa de configuração de CA de assinatura de código

az iot ops registry update -n myregistry -i myinstance -g myresourcegroup --cs-config-map-refs myconfigmap

Atualizar um ponto de extremidade para definir várias referências secretas de CA de assinatura de código

az iot ops registry update -n myregistry -i myinstance -g myresourcegroup --cs-secret-refs secret1 secret2

Parâmetros Obrigatórios

--instance -i

Nome da instância de Operações IoT.

--name -n

Nome do ponto de extremidade do Registro.

--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 tornar-se necessários para que o comando seja executado com êxito.

--aud --audience

Audiência para autenticação de registro de identidade gerenciada atribuída pelo sistema.

Propriedade Valor
Grupo de parâmetros: System-Assigned Identity Arguments
--auth-type

O tipo de autenticação para o ponto de extremidade do Registro. Se não for fornecido, o tipo de autenticação será determinado com base nos parâmetros de autenticação fornecidos. Se nenhum parâmetro de autenticação for fornecido, a autenticação de identidade gerenciada atribuída ao sistema será usada.

Propriedade Valor
Valores aceites: Anonymous, ArtifactPullSecret, SystemAssignedManagedIdentity, UserAssignedManagedIdentity
--cid --client-id

ID do cliente para autenticação de registro de identidade gerenciada atribuída pelo usuário.

Propriedade Valor
Grupo de parâmetros: User-Assigned Identity Arguments
--cs-config-map-refs --cscmr

Lista separada por espaço de referências de mapa de configuração de CA de assinatura de código.

Propriedade Valor
Grupo de parâmetros: Code Signing CA Arguments
--cs-secret-refs --cssr

Lista separada por espaços de referências secretas da autoridade de certificação de assinatura de código.

Propriedade Valor
Grupo de parâmetros: Code Signing CA Arguments
--host

O ponto de extremidade do Registro de Contêiner do Azure.

--no-auth

Use explicitamente a autenticação anônima.

Propriedade Valor
Valores aceites: false, true
--scope

Escopo para autenticação de registro de identidade gerenciada atribuída pelo usuário.

Propriedade Valor
Grupo de parâmetros: User-Assigned Identity Arguments
--secret-ref

Referência secreta do Kubernetes para autenticação do registro.

Propriedade Valor
Grupo de parâmetros: Artifact Pull Secret Arguments
--tenant-id --tid

ID do locatário para autenticação de registro de identidade gerenciada atribuída pelo usuário.

Propriedade Valor
Grupo de parâmetros: User-Assigned Identity Arguments
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: 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 da subscrição. 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
Default value: False