az providerhub resource-type-registration

Nota

Questo riferimento fa parte dell'estensione providerhub per l'interfaccia della riga di comando di Azure (versione 2.15.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az providerhub resource-type-registration . Altre informazioni sulle estensioni.

Gestire la registrazione del tipo di risorsa con providerhub.

Comandi

Nome Descrizione Tipo Stato
az providerhub resource-type-registration create

Creare un tipo di risorsa.

Estensione Disponibilità generale
az providerhub resource-type-registration delete

Elimina un tipo di risorsa.

Estensione Disponibilità generale
az providerhub resource-type-registration list

Ottiene l'elenco dei tipi di risorsa per il provider specificato.

Estensione Disponibilità generale
az providerhub resource-type-registration show

Ottiene i dettagli di un tipo di risorsa nella sottoscrizione e nel provider specificati.

Estensione Disponibilità generale

az providerhub resource-type-registration create

Creare un tipo di risorsa.

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]

Esempio

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"

Parametri necessari

--provider-namespace

Nome del provider di risorse ospitato in ProviderHub.

--resource-type

Tipo di risorsa.

Parametri facoltativi

--allowed-unauthorized-actions --aua

Azioni non autorizzate consentite.

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

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

Consente a RP di eseguire l'override del verbo di azione per scopi di controllo degli accessi in base al ruolo in ARM.

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

originale: obbligatorio. Nome dell'azione originale. desiderato: obbligatorio. Nome dell'azione desiderato.

È possibile specificare più azioni usando più di un argomento --auth-mappings.

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

Funzionalità dei controlli di disponibilità dei nomi a livello di piattaforma.

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

enable-default-validation: valore booleano che indica se rp ha scelto di rifiutare esplicitamente RPaaS per eseguire il nome del controllo. resource-types-with-custom-validation: tipi che devono essere convalidati ulteriormente dal punto di ripristino.

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

Opzioni di estensione per la gestione della richiesta di inizio dell'estensione per la creazione della risorsa.

Utilizzo: --creation-begin request=XX response=XX request: elenco di tipi di opzioni di estensione. response: elenco di tipi di opzioni di estensione.

--dav --disallowed-action-verbs

Verbi di azione non consentiti.

Utilizzo: --dav "read".

--default-api-version

Versione dell'API predefinita per l'endpoint.

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

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

Criteri di eliminazione delle risorse.

Utilizzo: --deletion-policy "CascadeDeleteAll".

valori accettati: CascadeDeleteAll, CascadeDeleteProxyOnlyChildren, NotSpecified
--enable-async-operation

Indica se l'operazione asincrona è abilitata per questo tipo di risorsa.

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

valori accettati: false, true
--enable-third-party-s2s

Indica se per questo tipo di risorsa è abilitato s2s di terze parti.

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

valori accettati: false, true
--endpoints

Endpoint del tipo di risorsa.

Utilizzo: --endpoints api-versions=XX locations=XX required-features=XX api-versions: Required. Elenco delimitato da virgole delle versioni dell'API. locations: obbligatorio. Elenco delimitato da virgole di posizioni. funzionalità obbligatorie: obbligatorio. Elenco delle funzionalità necessarie. È possibile specificare più funzionalità obbligatorie. È possibile specificare più azioni usando più di un argomento --endpoints.

--extended-locations

Opzioni di posizione estesa.

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

type: tipo di posizione estesa. supported-policy: i criteri supportati.

È possibile specificare più azioni usando più di un argomento --extended-locations.

--identity-management

Impostazioni correlate all'identità del servizio gestito.

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

type: tipo di gestione delle identità. application-id: ID applicazione che gestisce l'identità.

--is-pure-proxy

Indica se si tratta di un tipo di risorsa PureProxy.

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

valori accettati: false, true
--linked-access-checks

Abilita controlli aggiuntivi di controllo degli Controllo di accesso accessi in base al ruolo (RBAC) sulle risorse correlate.

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

action-name: nome dell'azione. linked-property: proprietà collegata. linked-action: azione collegata. linked-action-verb: verbo di azione collegato. linked-type: tipo collegato.

È possibile specificare più azioni usando più di un argomento --linked-access-checks.

--logging-rules

Regole di registrazione.

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

azione: obbligatorio. Nome dell'azione. direzione: obbligatorio. Direzione. livello dettaglio: obbligatorio. Livello di dettaglio.

È possibile specificare più azioni usando più di un argomento --logging-rules.

--marketplace-type

Tipo di comportamento del marketplace per il tipo di risorsa.

Utilizzo: --marketplace-type "AddOn".

valori accettati: AddOn, Bypass, NotSpecified, Store
--opt-in-headers

Intestazioni di consenso esplicito.

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

valori accettati: ClientGroupMembership, NotSpecified, SignedAuxiliaryTokens, SignedUserToken, UnboundedClientGroupMembership
--override-actions --subscription-state-override-actions

Le azioni di override dello stato della sottoscrizione.

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

È possibile specificare più azioni usando più di un argomento --subscription-state-override-actions.

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

Opzioni di estensione per la gestione della richiesta di inizio dell'estensione della patch di risorsa.

Utilizzo: --patch-begin request=XX response=XX request: elenco di tipi di opzioni di estensione. response: elenco di tipi di opzioni di estensione.

--regionality

Area del tipo di risorsa.

Utilizzo: --regionality "Regional".

valori accettati: Global, NotSpecified, Regional
--req-features-policy --required-features-policy

I valori accettati sono "Any" o "All". Se il valore è "All", saranno consentite solo le sottoscrizioni registrate in tutti i flag di funzionalità corrispondenti..

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

valori accettati: All, Any
--required-features

Funzionalità necessarie.

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

--resource-move-policy

Criterio di spostamento delle risorse.

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

validation-required: valore booleano che indica se la convalida è necessaria per lo spostamento della risorsa. cross-resource-group-move-enabled: valore booleano che indica se lo spostamento di risorse tra gruppi di risorse è consentito. cross-subscription-move-enabled: valore booleano che indica se lo spostamento di risorse tra sottoscrizioni è consentito.

--routing-type

Tipo di routing delle risorse..

Utilizzo: --routing-type "Default"

I tipi di routing disponibili includono: Default, ProxyOnly, HostBased, Extension, Tenant, Fanout, LocationBased, Failover, CascadeExtension, ChildFanout, CascadeAuthorizedExtension, BypassEndpointSelectionOptimization.

--service-tree-infos

Informazioni su ServiceTree per il provider di risorse.

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

service-id: obbligatorio. ID del servizio. component-id: obbligatorio. ID componente.

È possibile specificare più azioni usando più argomenti --service-tree-infos.

--soft-delete-ttl

Durata dell'eliminazione temporanea.

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

Regole di stato della sottoscrizione.

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

state: stato della sottoscrizione. allowed-actions: azioni consentite.

È possibile specificare più azioni usando più di un argomento --sub-state-rules.

--swagger-specifications

Specifica Swagger del tipo di risorsa.

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

api-versions: obbligatorio. Versioni api del tipo di risorsa, separate da virgole. swagger-spec-folder-uri: obbligatorio. URI della specifica Swagger.

È possibile specificare più azioni usando più di un argomento --swagger-specifications.

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

Opzioni di distribuzione del modello.

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

preflight-supported: valore booleano che indica se è supportata la convalida preliminare. preflight-options: opzioni preliminari.

--throttling-rules

Abilita l'impostazione di singoli limiti per azioni diverse in termini di numero di richieste o numero di risorse (solo per le richieste di lettura della raccolta).

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

azione: obbligatorio. Nome dell'azione. metrics: obbligatorio. Metriche di limitazione. funzionalità obbligatorie: la regola di limitazione richiede funzionalità.

È possibile specificare più azioni usando più di un argomento --throttling-rules.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az providerhub resource-type-registration delete

Elimina un tipo di risorsa.

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

Esempio

ResourceTypeRegistrations_Delete

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

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--provider-namespace

Nome del provider di risorse ospitato in ProviderHub.

--resource-type

Tipo di risorsa.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--yes -y

Indica che non è richiesta la conferma.

valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az providerhub resource-type-registration list

Ottiene l'elenco dei tipi di risorsa per il provider specificato.

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

Esempio

ResourceTypeRegistrations_ListByProviderRegistration

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

Parametri necessari

--provider-namespace

Nome del provider di risorse ospitato in ProviderHub.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az providerhub resource-type-registration show

Ottiene i dettagli di un tipo di risorsa nella sottoscrizione e nel provider specificati.

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

Esempio

ResourceTypeRegistrations_Get

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

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--provider-namespace

Nome del provider di risorse ospitato in ProviderHub.

--resource-type

Tipo di risorsa.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.