Share via


az providerhub resource-type-registration

Nota

Essa referência faz parte da extensão providerhub para a CLI do Azure (versão 2.15.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az providerhub resource-type-registration . Saiba mais sobre extensões.

Gerencie o registro de tipo de recurso com providerhub.

Comandos

Name Description Tipo Estado
az providerhub resource-type-registration create

Crie um tipo de recurso.

Extensão GA
az providerhub resource-type-registration delete

Exclui um tipo de recurso.

Extensão GA
az providerhub resource-type-registration list

Obtém a lista dos tipos de recursos para um determinado provedor.

Extensão GA
az providerhub resource-type-registration show

Obtém detalhes de um tipo de recurso na assinatura e no provedor fornecidos.

Extensão GA

az providerhub resource-type-registration create

Crie um tipo de recurso.

az providerhub resource-type-registration create --provider-namespace
                                                 --resource-type
                                                 [--allowed-unauthorized-actions]
                                                 [--auth-mappings]
                                                 [--check-name-availability-specifications]
                                                 [--creation-begin]
                                                 [--dav]
                                                 [--default-api-version]
                                                 [--deletion-policy {CascadeDeleteAll, CascadeDeleteProxyOnlyChildren, NotSpecified}]
                                                 [--enable-async-operation {false, true}]
                                                 [--enable-third-party-s2s {false, true}]
                                                 [--endpoints]
                                                 [--extended-locations]
                                                 [--identity-management]
                                                 [--is-pure-proxy {false, true}]
                                                 [--linked-access-checks]
                                                 [--logging-rules]
                                                 [--marketplace-type {AddOn, Bypass, NotSpecified, Store}]
                                                 [--opt-in-headers {ClientGroupMembership, NotSpecified, SignedAuxiliaryTokens, SignedUserToken, UnboundedClientGroupMembership}]
                                                 [--override-actions]
                                                 [--patch-begin]
                                                 [--regionality {Global, NotSpecified, Regional}]
                                                 [--req-features-policy {All, Any}]
                                                 [--required-features]
                                                 [--resource-move-policy]
                                                 [--routing-type]
                                                 [--service-tree-infos]
                                                 [--soft-delete-ttl]
                                                 [--sub-state-rules]
                                                 [--swagger-specifications]
                                                 [--template-deployment-options]
                                                 [--throttling-rules]

Exemplos

ResourceTypeRegistrations_CreateOrUpdate

az providerhub resource-type-registration create     --endpoints api-versions="2019-01-01" locations="Global"     required-features="Microsoft.Contoso/RPaaSSampleApp"     extension-endpoint-uri="https://contoso-test-extension-endpoint.com/"     extension-categories="ResourceReadValidate" extension-categories="ResourceDeletionValidate"     --regionality "Global"     --routing-type "ProxyOnly"     --swagger-specifications api-versions="2019-01-01"     swagger-spec-folder-uri="https://github.com/pathtoresourceproviderswaggerspecfolder"     --provider-namespace "Microsoft.Contoso"     --enable-async-operation false     --template-deployment-options preflight-supported="true"     preflight-options="DefaultValidationOnly" preflight-options="continueDeploymentOnFailure"     --resource-type "testResourceType"

Parâmetros Obrigatórios

--provider-namespace

O nome do provedor de recursos hospedado no ProviderHub.

--resource-type

O tipo de recurso.

Parâmetros Opcionais

--allowed-unauthorized-actions --aua

As ações não autorizadas permitidas.

Uso: --allowed-unauthorized-actions "Microsoft.Contoso/rpResourceType/read, Microsoft.Contoso/rpResourceType/delete".

--auth-mappings --authorization-action-mappings

Permite que RP substitua o verbo de ação para fins de RBAC no ARM.

Uso: --auth-mappings original=XX desired=XX

original: Obrigatório. O nome da ação original. desejado: Obrigatório. O nome da ação desejada.

Várias ações podem ser especificadas usando mais de um argumento --auth-mappings.

--check-name-availability-specifications --checkname-specs

Recurso de verificação de disponibilidade de nomes no nível da plataforma.

Uso: --check-name-availability-specifications enable-default-validation=XX resource-types-with-custom-validation=XX

enable-default-validation: Boolean indica se o RP optou por desativar o RPaaS para executar o nome de verificação. resource-types-with-custom-validation: Os tipos que precisam de validação adicional do RP.

--creation-begin --resource-creation-begin

As opções de extensão para lidar com a criação de recursos iniciam a solicitação de extensão.

Uso: --creation-begin request=XX response=XX request: A lista de tipos de opções de extensão. response: A lista de tipos de opções de extensão.

--dav --disallowed-action-verbs

Os verbos de ação não permitidos.

Uso: --dav "ler".

--default-api-version

A versão padrão da API para o ponto de extremidade.

Uso: --default-api-version "2021-01-01".

--deletion-policy --resource-deletion-policy

A política de exclusão de recursos.

Uso: --deletion-policy "CascadeDeleteAll".

valores aceites: CascadeDeleteAll, CascadeDeleteProxyOnlyChildren, NotSpecified
--enable-async-operation

Indica se a operação assíncrona está habilitada para esse tipo de recurso.

Uso: --enable-async-operation "false".

valores aceites: false, true
--enable-third-party-s2s

Indica se o s2s de terceiros está habilitado para esse tipo de recurso.

Uso: --enable-third-party-s2s "false".

valores aceites: false, true
--endpoints

Os pontos de extremidade do tipo de recurso.

Uso: --endpoints api-versions=XX locations=XX required-features=XX api-versions: Obrigatório. Lista separada por vírgulas de versões da API. locais: Obrigatório. Lista de locais separada por vírgula. required-features: Obrigatório. Lista de recursos necessários. Vários recursos necessários podem ser especificados. Várias ações podem ser especificadas usando mais de um argumento --endpoints.

--extended-locations

As opções de localização estendida.

Uso: --extended-locations type=XX supported-policy=XX

type: O tipo de local estendido. supported-policy: A política suportada.

Várias ações podem ser especificadas usando mais de um argumento --extended-locations.

--identity-management

Configurações relacionadas ao MSI.

Uso: --identity-management type=XX application-id=XX

type: O tipo de gerenciamento de identidade. application-id: o ID do aplicativo que manipula a identidade.

--is-pure-proxy

Indica se este é um tipo de recurso PureProxy.

Uso: --is-pure-proxy "false".

valores aceites: false, true
--linked-access-checks

Permite verificações adicionais de RBAC (Controle de Acesso Baseado em Função) em recursos relacionados.

Uso: --linked-access-checks action-name=XX linked-property=XX linked-action=XX linked-action-verb=XX linked-type=XX

action-name: O nome da ação. link-property: A propriedade vinculada. link-action: A ação vinculada. linked-action-verb: O verbo de ação ligado. linked-type: O tipo vinculado.

Várias ações podem ser especificadas usando mais de um argumento --linked-access-checks.

--logging-rules

As regras de registo.

Uso: --logging-rules action=XX direction=XX detail-level=XX

ação: Obrigatório. O nome da ação. direção: Obrigatório. A direção. nível de detalhe: Obrigatório. O nível de detalhe.

Várias ações podem ser especificadas usando mais de um argumento --logging-rules.

--marketplace-type

O tipo de comportamento de mercado para o tipo de recurso.

Uso: --marketplace-type "AddOn".

valores aceites: AddOn, Bypass, NotSpecified, Store
--opt-in-headers

Os cabeçalhos de aceitação.

Uso: --opt-in-headers "SignedUserToken".

valores aceites: ClientGroupMembership, NotSpecified, SignedAuxiliaryTokens, SignedUserToken, UnboundedClientGroupMembership
--override-actions --subscription-state-override-actions

As ações de substituição do estado da assinatura.

Uso: --subscription-state-override-actions state=XX action=XX

Várias ações podem ser especificadas usando mais de um argumento --subscription-state-override-actions.

--patch-begin --resource-patch-begin

As opções de extensão para lidar com o patch de recurso iniciam a solicitação de extensão.

Uso: --patch-start request=XX response=XX request: A lista de tipos de opções de extensão. response: A lista de tipos de opções de extensão.

--regionality

A regionalidade do tipo de recurso.

Uso: --regionalidade "Regional".

valores aceites: Global, NotSpecified, Regional
--req-features-policy --required-features-policy

Os valores aceites são "Qualquer" ou "Todos". Se o valor for "Todos", apenas as assinaturas registradas em todos os sinalizadores de recursos correspondentes serão permitidas..

Uso: --req-features-policy "Todos".

valores aceites: All, Any
--required-features

Os recursos necessários.

Uso: --required-features "Microsoft.Contoso/feature1, Microsoft.Contoso/feature2".

--resource-move-policy

A política de movimentação de recursos.

Uso: --resource-move-policy validation-required=XX cross-resource-group-move-enabled=XX cross-subscription-move-enabled=XX

validation-required: Boolean indicando se a validação é necessária para mover o recurso. cross-resource-group-move-enabled: Booleano que indica se a movimentação de recursos entre grupos de recursos é permitida. cross-subscription-move-enabled: Booleano que indica se a movimentação de recursos entre assinaturas é permitida.

--routing-type

O tipo de roteamento de recursos..

Uso: --routing-type "Default"

Os tipos de roteamento disponíveis incluem: Default, ProxyOnly, HostBased, Extension, Tenant, Fanout, LocationBased, Failover, CascadeExtension, ChildFanout, CascadeAuthorizedExtension, BypassEndpointSelectionOptimization.

--service-tree-infos

As informações ServiceTree para o provedor de recursos.

Uso: --service-tree-infos service-id=XX component-id=XX

service-id: Obrigatório. O ID do serviço. component-id: Obrigatório. O ID do componente.

Várias ações podem ser especificadas usando mais de um argumento --service-tree-infos.

--soft-delete-ttl

O tempo de exclusão suave para viver.

--sub-state-rules --subscription-state-rules

As regras do estado da subscrição.

Uso: --sub-state-rules state=XX allowed-actions=XX

state: O estado da assinatura. allowed-actions: As ações permitidas.

Várias ações podem ser especificadas usando mais de um argumento --sub-state-rules.

--swagger-specifications

A especificação Swagger do tipo de recurso.

Uso: --swagger-specifications api-versions=XX swagger-spec-folder-uri=XX

api-versions: Obrigatório. As versões da API do tipo de recurso, separadas por vírgulas. swagger-spec-folder-uri: Obrigatório. O URI de especificação do Swagger.

Várias ações podem ser especificadas usando mais de um argumento --swagger-specifications.

--template-deployment-options --tmplt-deploy-opt

As opções de implantação do modelo.

Uso: --template-deployment-options preflight-supported=XX preflight-options=XX

suportado por comprovação: Booleano que indica se a validação de comprovação é suportada. opções de comprovação: As opções de comprovação.

--throttling-rules

Permite definir limites individuais para diferentes ações em termos de número de solicitações ou número de recursos (somente para solicitações de leitura de coleta).

Uso: --throttling-rules action=XX metrics=XX required-features=XX

ação: Obrigatório. O nome da ação. métricas: Obrigatório. As métricas de limitação. required-features: A regra de limitação exigia recursos.

Várias ações podem ser especificadas usando mais de um argumento --throttling-rules.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az providerhub resource-type-registration delete

Exclui um tipo de recurso.

az providerhub resource-type-registration delete [--ids]
                                                 [--provider-namespace]
                                                 [--resource-type]
                                                 [--subscription]
                                                 [--yes]

Exemplos

ResourceTypeRegistrations_Delete

az providerhub resource-type-registration delete --provider-namespace "Microsoft.Contoso" --resource-type "testResourceType"

Parâmetros Opcionais

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--provider-namespace

O nome do provedor de recursos hospedado no ProviderHub.

--resource-type

O tipo de recurso.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--yes -y

Não solicite confirmação.

valor predefinido: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az providerhub resource-type-registration list

Obtém a lista dos tipos de recursos para um determinado provedor.

az providerhub resource-type-registration list --provider-namespace

Exemplos

ResourceTypeRegistrations_ListByProviderRegistration

az providerhub resource-type-registration list --provider-namespace "Microsoft.Contoso"

Parâmetros Obrigatórios

--provider-namespace

O nome do provedor de recursos hospedado no ProviderHub.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az providerhub resource-type-registration show

Obtém detalhes de um tipo de recurso na assinatura e no provedor fornecidos.

az providerhub resource-type-registration show [--ids]
                                               [--provider-namespace]
                                               [--resource-type]
                                               [--subscription]

Exemplos

ResourceTypeRegistrations_Get

az providerhub resource-type-registration show --provider-namespace "Microsoft.Contoso" --resource-type "employees"

Parâmetros Opcionais

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--provider-namespace

O nome do provedor de recursos hospedado no ProviderHub.

--resource-type

O tipo de recurso.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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