az cosmosdb sql role definition

  • Riferimento

Gestire le definizioni dei ruoli SQL di Azure Cosmos DB.

Comandi

Nome Descrizione Tipo Stato
az cosmosdb sql role definition create

Creare una definizione di ruolo SQL in un account Azure Cosmos DB.

 Memoria centrale Disponibilità generale
az cosmosdb sql role definition delete

Eliminare una definizione di ruolo SQL in un account Azure Cosmos DB.

 Memoria centrale Disponibilità generale
az cosmosdb sql role definition exists

Controllare se esiste una definizione di ruolo di Azure Cosmos DB.

 Memoria centrale Disponibilità generale
az cosmosdb sql role definition list

Elencare tutte le definizioni di ruolo SQL in un account Azure Cosmos DB.

 Memoria centrale Disponibilità generale
az cosmosdb sql role definition show

Visualizzare le proprietà di una definizione di ruolo SQL in un account Azure Cosmos DB.

 Memoria centrale Disponibilità generale
az cosmosdb sql role definition update

Aggiornare una definizione di ruolo SQL in un account Azure Cosmos DB.

 Memoria centrale Disponibilità generale
az cosmosdb sql role definition wait

Eseguire il polling su una definizione di ruolo SQL fino a quando non viene soddisfatta una condizione specifica.

 Memoria centrale Disponibilità generale

az cosmosdb sql role definition create

Modifica

Creare una definizione di ruolo SQL in un account Azure Cosmos DB.

az cosmosdb sql role definition create --account-name
                                       --body
                                       --resource-group
                                       [--no-wait]

Esempio

Creare una definizione di ruolo SQL in un account Azure Cosmos DB usando una stringa JSON.

az cosmosdb sql role definition create --account-name MyAccount --resource-group MyResourceGroup --body '{
  "Id": "be79875a-2cc4-40d5-8958-566017875b39",
  "RoleName": "My Read Only Role",
  "Type": "CustomRole",
  "AssignableScopes": ["/dbs/mydb/colls/mycontainer"],
  "Permissions": [{
    "DataActions": [
      "Microsoft.DocumentDB/databaseAccounts/readMetadata",
      "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers/items/read",
      "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers/executeQuery",
      "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers/readChangeFeed"
    ]
  }]
}'

Creare una definizione di ruolo SQL in un account Azure Cosmos DB usando un file JSON.

az cosmosdb sql role definition create --account-name MyAccount --resource-group MyResourceGroup --body @role-definition.json

Parametri necessari

--account-name -a

Nome dell'account Cosmosdb.

--body -b

Corpo della definizione del ruolo con ID (facoltativo per la creazione), DataActions o Permissions, Type (Default è CustomRole) e AssignableScopes. È possibile immetterlo come stringa o come file, ad esempio --body o --body @rdbody-file.json "{ "Id": "be79875a-2cc4-40d5-8958-566017875b39", "RoleName": "My Read Write Role", "Type": "CustomRole", "AssignableScopes": [ "/" ], "DataActions": [ "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers/items/create", "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers/items/read" ]}".

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

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 cosmosdb sql role definition delete

Modifica

Eliminare una definizione di ruolo SQL in un account Azure Cosmos DB.

az cosmosdb sql role definition delete --account-name
                                       --id
                                       --resource-group
                                       [--no-wait]
                                       [--yes]

Esempio

Eliminare una definizione di ruolo SQL in un account Azure Cosmos DB.

az cosmosdb sql role definition delete --account-name MyAccount --resource-group MyResourceGroup --id be79875a-2cc4-40d5-8958-566017875b39

Parametri necessari

--account-name -a

Nome dell'account Cosmosdb.

--id -i

ID univoco per la definizione del ruolo.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

valore predefinito: False
--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 cosmosdb sql role definition exists

Modifica

Controllare se esiste una definizione di ruolo di Azure Cosmos DB.

az cosmosdb sql role definition exists --account-name
                                       --id
                                       --resource-group

Esempio

Controllare se esiste una definizione di ruolo di Azure Cosmos DB.

az cosmosdb sql role definition exists --account-name MyAccount --resource-group MyResourceGroup --id be79875a-2cc4-40d5-8958-566017875b39

Parametri necessari

--account-name -a

Nome dell'account Cosmosdb.

--id -i

ID univoco per la definizione del ruolo.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

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 cosmosdb sql role definition list

Modifica

Elencare tutte le definizioni di ruolo SQL in un account Azure Cosmos DB.

az cosmosdb sql role definition list --account-name
                                     --resource-group

Esempio

Elencare tutte le definizioni di ruolo SQL in un account Azure Cosmos DB.

az cosmosdb sql role definition list --account-name MyAccount --resource-group MyResourceGroup

Parametri necessari

--account-name -a

Nome dell'account Cosmosdb.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

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 cosmosdb sql role definition show

Modifica

Visualizzare le proprietà di una definizione di ruolo SQL in un account Azure Cosmos DB.

az cosmosdb sql role definition show --account-name
                                     --id
                                     --resource-group

Esempio

Visualizzare le proprietà di una definizione di ruolo SQL in un account Azure Cosmos DB.

az cosmosdb sql role definition show --account-name MyAccount --resource-group MyResourceGroup --id be79875a-2cc4-40d5-8958-566017875b39

Parametri necessari

--account-name -a

Nome dell'account Cosmosdb.

--id -i

ID univoco per la definizione del ruolo.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

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 cosmosdb sql role definition update

Modifica

Aggiornare una definizione di ruolo SQL in un account Azure Cosmos DB.

az cosmosdb sql role definition update --account-name
                                       --body
                                       --resource-group
                                       [--no-wait]

Esempio

Aggiornare una definizione di ruolo SQL in un account Azure Cosmos DB.

az cosmosdb sql role definition update --account-name MyAccount --resource-group MyResourceGroup --body @role-definition.json

Parametri necessari

--account-name -a

Nome dell'account Cosmosdb.

--body -b

Corpo della definizione del ruolo con ID (facoltativo per la creazione), DataActions o Permissions, Type (Default è CustomRole) e AssignableScopes. È possibile immetterlo come stringa o come file, ad esempio --body o --body @rdbody-file.json "{ "Id": "be79875a-2cc4-40d5-8958-566017875b39", "RoleName": "My Read Write Role", "Type": "CustomRole", "AssignableScopes": [ "/" ], "DataActions": [ "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers/items/create", "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers/items/read" ]}".

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

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 cosmosdb sql role definition wait

Modifica

Eseguire il polling su una definizione di ruolo SQL fino a quando non viene soddisfatta una condizione specifica.

az cosmosdb sql role definition wait --account-name
                                     --id
                                     --resource-group
                                     [--created]
                                     [--custom]
                                     [--deleted]
                                     [--exists]
                                     [--interval]
                                     [--timeout]
                                     [--updated]

Esempio

Eseguire il polling su una definizione di ruolo SQL fino a quando non viene eliminato.

az cosmosdb sql role definition wait --account-name MyAccount --resource-group MyResourceGroup --id cb8ed2d7-2371-4e3c-bd31-6cc1560e84f8 --deleted

Parametri necessari

--account-name -a

Nome dell'account Cosmosdb.

--id -i

ID univoco per la definizione del ruolo.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--created

Attendere fino a quando non viene creato con 'provisioningState' in 'Succeeded'.

valore predefinito: False
--custom

Attendere che la condizione soddisfi una query JMESPath personalizzata. Ad esempio provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Attendere l'eliminazione.

valore predefinito: False
--exists

Attendere che la risorsa esista.

valore predefinito: False
--interval

Intervallo di polling in secondi.

valore predefinito: 30
--timeout

Attesa massima in secondi.

valore predefinito: 3600
--updated

Attendere fino a quando non viene aggiornato con provisioningState in 'Succeeded'.

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.