az providerhub resource-type-registration

Nota:

Esta referencia forma parte de la extensión providerhub para la CLI de Azure (versión 2.15.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az providerhub resource-type-registration . Obtenga más información sobre las extensiones.

Administrar el registro de tipo de recurso con providerhub.

Comandos

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

Cree un tipo de recurso.

Extensión GA
az providerhub resource-type-registration delete

Elimina un tipo de recurso.

Extensión GA
az providerhub resource-type-registration list

Obtiene la lista de los tipos de recursos para el proveedor especificado.

Extensión GA
az providerhub resource-type-registration show

Obtiene los detalles de un tipo de recurso en la suscripción y el proveedor especificados.

Extensión GA

az providerhub resource-type-registration create

Cree un 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]

Ejemplos

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 requeridos

--provider-namespace

Nombre del proveedor de recursos hospedado en ProviderHub.

--resource-type

Tipo de recurso.

Parámetros opcionales

--allowed-unauthorized-actions --aua

Acciones no autorizadas permitidas.

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

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

Permite a RP invalidar el verbo de acción con fines de RBAC en ARM.

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

original: obligatorio. Nombre de la acción original. deseado: obligatorio. Nombre de la acción deseada.

Se pueden especificar varias acciones mediante más de un argumento --auth-mappings.

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

Característica de comprobaciones de disponibilidad de nombres en el nivel de plataforma.

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

enable-default-validation: booleano que indica si RP ha elegido no participar en RPaaS para realizar la comprobación de nombre. resource-types-with-custom-validation: los tipos que necesitan validación adicional del RP.

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

Opciones de extensión para controlar la solicitud de inicio de la extensión de creación de recursos.

Uso: --creation-begin request=XX response=XX request: la lista de tipos de opciones de extensión. response: la lista de tipos de opciones de extensión.

--dav --disallowed-action-verbs

Verbos de acción no permitidos.

Uso: --dav "read".

--default-api-version

La versión predeterminada de la API para el punto de conexión.

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

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

Directiva de eliminación de recursos.

Uso: --deletion-policy "CascadeDeleteAll".

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

Indica si la operación asincrónica está habilitada para este tipo de recurso.

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

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

Indica si los s2s de terceros están habilitados para este tipo de recurso.

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

valores aceptados: false, true
--endpoints

Puntos de conexión de tipo de recurso.

Uso: --endpoints api-versions=XX locations=XX required-features=XX api-versions: Required. Lista separada por comas de versiones de API. locations: Obligatorio. Lista separada por comas de ubicaciones. required-features: Obligatorio. Lista de características necesarias. Se pueden especificar varias características necesarias. Se pueden especificar varias acciones mediante más de un argumento --endpoints.

--extended-locations

Las opciones de ubicación extendida.

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

type: tipo de ubicación extendida. supported-policy: la directiva admitida.

Se pueden especificar varias acciones mediante más de un argumento --extended-locations.

--identity-management

Configuración relacionada con MSI.

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

type: el tipo de administración de identidades. application-id: identificador de aplicación que controla la identidad.

--is-pure-proxy

Indica si se trata de un tipo de recurso PureProxy.

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

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

Habilita comprobaciones adicionales de Control de acceso basado en rol (RBAC) en recursos relacionados.

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

action-name: el nombre de la acción. linked-property: la propiedad vinculada. linked-action: la acción vinculada. linked-action-verb: verbo de acción vinculada. linked-type: tipo vinculado.

Se pueden especificar varias acciones mediante más de un argumento --linked-access-checks.

--logging-rules

Reglas de registro.

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

action: Obligatorio. Nombre de la acción. dirección: obligatorio. Dirección. nivel de detalle: obligatorio. Nivel de detalle.

Se pueden especificar varias acciones mediante más de un argumento --logging-rules.

--marketplace-type

Tipo de comportamiento de Marketplace para el tipo de recurso.

Uso: --marketplace-type "AddOn".

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

Encabezados de participación.

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

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

Acciones de invalidación del estado de la suscripción.

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

Se pueden especificar varias acciones mediante más de un argumento --subscription-state-override-actions.

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

Opciones de extensión para controlar la solicitud de extensión de inicio de la revisión de recursos.

Uso: --patch-begin request=XX response=XX request: la lista de tipos de opciones de extensión. response: la lista de tipos de opciones de extensión.

--regionality

Regionalidad del tipo de recurso.

Uso: --regionality "Regional".

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

Los valores aceptados son "Any" o "All". Si el valor es "All", solo se permitirán las suscripciones registradas en toda la marca de característica correspondiente..

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

valores aceptados: All, Any
--required-features

Características necesarias.

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

--resource-move-policy

Directiva de movimiento de recursos.

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

validation-required: booleano que indica si la validación es necesaria para mover el recurso. cross-resource-group-move-enabled: booleano que indica si se permiten mover recursos entre grupos de recursos. cross-subscription-move-enabled: booleano que indica si se permiten mover recursos entre suscripciones.

--routing-type

Tipo de enrutamiento de recursos..

Uso: --routing-type "Default"

Los tipos de enrutamiento disponibles incluyen: Default, ProxyOnly, HostBased, Extension, Tenant, Fanout, LocationBased, Failover, CascadeExtension, ChildFanout, CascadeAuthorizedExtension, BypassEndpointSelectionOptimization.

--service-tree-infos

Información de ServiceTree para el proveedor de recursos.

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

service-id: obligatorio. Identificador de servicio. component-id: Required. Identificador del componente.

Se pueden especificar varias acciones mediante más de un argumento --service-tree-infos.

--soft-delete-ttl

El período de vida de la eliminación temporal.

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

Reglas de estado de la suscripción.

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

state: el estado de la suscripción. allowed-actions: las acciones permitidas.

Se pueden especificar varias acciones mediante más de un argumento --sub-state-rules.

--swagger-specifications

Especificación de Swagger del tipo de recurso.

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

api-versions: obligatorio. Las versiones de API de tipo de recurso, separadas por comas. swagger-spec-folder-uri: obligatorio. Identificador URI de especificación de Swagger.

Se pueden especificar varias acciones mediante más de un argumento --swagger-specifications.

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

Las opciones de implementación de plantillas.

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

preflight-supported: booleano que indica si se admite la validación preparatoria. preflight-options: las opciones preparatorias.

--throttling-rules

Habilita la configuración de límites individuales para diferentes acciones en términos de número de solicitudes o número de recursos (solo para solicitudes de lectura de recopilación).

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

action: Obligatorio. Nombre de la acción. métricas: obligatorio. Métricas de limitación. required-features: las características necesarias de la regla de limitación.

Se pueden especificar varias acciones mediante más de un argumento --throttling-rules.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az providerhub resource-type-registration delete

Elimina un tipo de recurso.

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

Ejemplos

ResourceTypeRegistrations_Delete

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

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--provider-namespace

Nombre del proveedor de recursos hospedado en ProviderHub.

--resource-type

Tipo de recurso.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--yes -y

No solicita confirmación.

valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az providerhub resource-type-registration list

Obtiene la lista de los tipos de recursos para el proveedor especificado.

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

Ejemplos

ResourceTypeRegistrations_ListByProviderRegistration

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

Parámetros requeridos

--provider-namespace

Nombre del proveedor de recursos hospedado en ProviderHub.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az providerhub resource-type-registration show

Obtiene los detalles de un tipo de recurso en la suscripción y el proveedor especificados.

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

Ejemplos

ResourceTypeRegistrations_Get

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

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--provider-namespace

Nombre del proveedor de recursos hospedado en ProviderHub.

--resource-type

Tipo de recurso.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.