Freigeben über


az cosmosdb sql role definition

Verwalten von Azure Cosmos DB SQL-Rollendefinitionen.

Befehle

Name Beschreibung Typ Status
az cosmosdb sql role definition create

Erstellen Sie eine SQL-Rollendefinition unter einem Azure Cosmos DB-Konto.

Kernspeicher Allgemein verfügbar
az cosmosdb sql role definition delete

Löschen Sie eine SQL-Rollendefinition unter einem Azure Cosmos DB-Konto.

Kernspeicher Allgemein verfügbar
az cosmosdb sql role definition exists

Überprüfen Sie, ob eine Azure Cosmos DB-Rollendefinition vorhanden ist.

Kernspeicher Allgemein verfügbar
az cosmosdb sql role definition list

Auflisten aller SQL-Rollendefinitionen unter einem Azure Cosmos DB-Konto.

Kernspeicher Allgemein verfügbar
az cosmosdb sql role definition show

Zeigen Sie die Eigenschaften einer SQL-Rollendefinition unter einem Azure Cosmos DB-Konto an.

Kernspeicher Allgemein verfügbar
az cosmosdb sql role definition update

Aktualisieren Sie eine SQL-Rollendefinition unter einem Azure Cosmos DB-Konto.

Kernspeicher Allgemein verfügbar
az cosmosdb sql role definition wait

Abrufen einer SQL-Rollendefinition, bis eine bestimmte Bedingung erfüllt ist.

Kernspeicher Allgemein verfügbar

az cosmosdb sql role definition create

Erstellen Sie eine SQL-Rollendefinition unter einem Azure Cosmos DB-Konto.

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

Beispiele

Erstellen Sie eine SQL-Rollendefinition unter einem Azure Cosmos DB-Konto mithilfe einer JSON-Zeichenfolge.

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"
    ]
  }]
}'

Erstellen Sie eine SQL-Rollendefinition unter einem Azure Cosmos DB-Konto mithilfe einer JSON-Datei.

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

Erforderliche Parameter

--account-name -a

Cosmosdb-Kontoname.

--body -b

Rollendefinitionstext mit ID (Optional zum Erstellen), DataActions oder Berechtigungen, Typ (Standard ist CustomRole) und AssignableScopes. Sie können sie als Zeichenfolge oder als Datei eingeben, z. B. --body oder --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

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az cosmosdb sql role definition delete

Löschen Sie eine SQL-Rollendefinition unter einem Azure Cosmos DB-Konto.

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

Beispiele

Löschen Sie eine SQL-Rollendefinition unter einem Azure Cosmos DB-Konto.

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

Erforderliche Parameter

--account-name -a

Cosmosdb-Kontoname.

--id -i

Eindeutige ID für die Rollendefinition.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--yes -y

Nicht zur Bestätigung auffordern

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az cosmosdb sql role definition exists

Überprüfen Sie, ob eine Azure Cosmos DB-Rollendefinition vorhanden ist.

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

Beispiele

Überprüfen Sie, ob eine Azure Cosmos DB-Rollendefinition vorhanden ist.

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

Erforderliche Parameter

--account-name -a

Cosmosdb-Kontoname.

--id -i

Eindeutige ID für die Rollendefinition.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az cosmosdb sql role definition list

Auflisten aller SQL-Rollendefinitionen unter einem Azure Cosmos DB-Konto.

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

Beispiele

Auflisten aller SQL-Rollendefinitionen unter einem Azure Cosmos DB-Konto.

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

Erforderliche Parameter

--account-name -a

Cosmosdb-Kontoname.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az cosmosdb sql role definition show

Zeigen Sie die Eigenschaften einer SQL-Rollendefinition unter einem Azure Cosmos DB-Konto an.

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

Beispiele

Zeigen Sie die Eigenschaften einer SQL-Rollendefinition unter einem Azure Cosmos DB-Konto an.

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

Erforderliche Parameter

--account-name -a

Cosmosdb-Kontoname.

--id -i

Eindeutige ID für die Rollendefinition.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az cosmosdb sql role definition update

Aktualisieren Sie eine SQL-Rollendefinition unter einem Azure Cosmos DB-Konto.

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

Beispiele

Aktualisieren Sie eine SQL-Rollendefinition unter einem Azure Cosmos DB-Konto.

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

Erforderliche Parameter

--account-name -a

Cosmosdb-Kontoname.

--body -b

Rollendefinitionstext mit ID (Optional zum Erstellen), DataActions oder Berechtigungen, Typ (Standard ist CustomRole) und AssignableScopes. Sie können sie als Zeichenfolge oder als Datei eingeben, z. B. --body oder --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

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az cosmosdb sql role definition wait

Abrufen einer SQL-Rollendefinition, bis eine bestimmte Bedingung erfüllt ist.

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

Beispiele

Abrufen einer SQL-Rollendefinition, bis sie gelöscht wird.

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

Erforderliche Parameter

--account-name -a

Cosmosdb-Kontoname.

--id -i

Eindeutige ID für die Rollendefinition.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--created

Warten Sie, bis sie mit 'provisioningState' unter 'Succeeded' erstellt wurde.

Standardwert: False
--custom

Warten Sie, bis die Bedingung eine benutzerdefinierte JMESPath-Abfrage erfüllt. Beispiel: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Warten Sie, bis sie gelöscht wurde.

Standardwert: False
--exists

Warten Sie, bis die Ressource vorhanden ist.

Standardwert: False
--interval

Abrufintervall in Sekunden.

Standardwert: 30
--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600
--updated

Warten Sie, bis sie mit provisioningState unter 'Succeeded' aktualisiert wurde.

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.