az cosmosdb sql role definition

Verwalten von Azure Cosmos DB SQL-Rollendefinitionen.

Befehle

az cosmosdb sql role definition create	Erstellen Sie eine SQL-Rollendefinition unter einem Azure Cosmos DB-Konto.
az cosmosdb sql role definition delete	Löschen Einer SQL-Rollendefinition unter einem Azure Cosmos DB-Konto.
az cosmosdb sql role definition exists	Überprüfen Sie, ob eine Azure Cosmos DB-Rollendefinition vorhanden ist.
az cosmosdb sql role definition list	Listet alle SQL-Rollendefinitionen unter einem Azure Cosmos DB-Konto auf.
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 update	Aktualisieren einer SQL-Rollendefinition unter einem Azure Cosmos DB-Konto.
az cosmosdb sql role definition wait	Abfragen einer SQL-Rollendefinition, bis eine bestimmte Bedingung erfüllt ist.

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 mit 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 für das Erstellen), DataActions oder Berechtigungen, Typ (Standard ist CustomRole) und ZuweisenableScopes. Sie können es als Zeichenfolge oder als Datei eingeben, z. B. -- @rdbody-file.json body oder --body "{ "Id": "be79875a-2cc4-40d5-8958-566017875b39", "RoleName": "Meine Schreibrolle", "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

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.

--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 Einer 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 Einer 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

--yes -y

Nicht zur Bestätigung auffordern

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.

--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.

--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

Listet alle SQL-Rollendefinitionen unter einem Azure Cosmos DB-Konto auf.

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

Beispiele

Listet alle SQL-Rollendefinitionen unter einem Azure Cosmos DB-Konto auf.

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.

--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.

--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 einer SQL-Rollendefinition unter einem Azure Cosmos DB-Konto.

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

Beispiele

Aktualisieren einer 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 für das Erstellen), DataActions oder Berechtigungen, Typ (Standard ist CustomRole) und ZuweisenableScopes. Sie können es als Zeichenfolge oder als Datei eingeben, z. B. -- @rdbody-file.json body oder --body "{ "Id": "be79875a-2cc4-40d5-8958-566017875b39", "RoleName": "Meine Schreibrolle", "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

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.

--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

Abfragen 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

Abfragen 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 "Erfolgreich" erstellt wurden.

--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.

--exists

Warten Sie, bis die Ressource vorhanden ist.

--interval

Abfrageintervall in Sekunden.

Standardwert: 30

--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600

--updated

Warten Sie, bis sie mit provisioningState unter "Erfolgreich" aktualisiert wurde.

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.

--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.