您现在访问的是微软AZURE全睃版技术文档网站,若需覝访问由世纪互蝔违蝥的MICROSOFT AZURE中国区技术文档网站,请访问 https://docs.azure.cn.

az cosmosdb sql role assignment

管理 Azure Cosmos DB SQL 角色分配。

命令

az cosmosdb sql role assignment create

在 Azure Cosmos DB 帐户下创建 SQL 角色分配。

az cosmosdb sql role assignment delete

删除 Azure Cosmos DB 帐户下的 SQL 角色分配。

az cosmosdb sql role assignment exists

检查是否存在 Azure Cosmos DB 角色分配。

az cosmosdb sql role assignment list

列出 Azure Cosmos DB 帐户下的所有 SQL 角色分配。

az cosmosdb sql role assignment show

在 Azure Cosmos DB 帐户下显示 SQL 角色分配的属性。

az cosmosdb sql role assignment update

在 Azure Cosmos DB 帐户下更新 SQL 角色分配。

az cosmosdb sql role assignment wait

在满足特定条件之前,轮询 SQL 角色分配。

az cosmosdb sql role assignment create

在 Azure Cosmos DB 帐户下创建 SQL 角色分配。

az cosmosdb sql role assignment create --account-name
                                       --principal-id
                                       --resource-group
                                       --scope
                                       [--no-wait]
                                       [--role-assignment-id]
                                       [--role-definition-id]
                                       [--role-definition-name]
                                       [--subscription]

示例

使用角色定义名称在 Azure Cosmos DB 帐户下创建 SQL 角色分配。

az cosmosdb sql role assignment create --account-name MyAccount --resource-group MyResourceGroup \
  --role-assignment-id cb8ed2d7-2371-4e3c-bd31-6cc1560e84f8 \
  --role-definition-name "My Read Only Role" \
  --scope "/dbs/mydb/colls/mycontainer" \
  --principal-id 6328f5f7-dbf7-4244-bba8-fbb9d8066506

使用角色定义 ID 在 Azure Cosmos DB 帐户下创建 SQL 角色分配。

az cosmosdb sql role assignment create --account-name MyAccount --resource-group MyResourceGroup \
  --role-assignment-id cb8ed2d7-2371-4e3c-bd31-6cc1560e84f8 \
  --role-definition-id be79875a-2cc4-40d5-8958-566017875b39 \
  --scope "/dbs/mydb/colls/mycontainer" \
  --principal-id 6328f5f7-dbf7-4244-bba8-fbb9d8066506

必需参数

--account-name -a

Cosmosdb 帐户名称。

--principal-id -p

向其授予此角色分配的主体的 AAD 对象 ID。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--scope -s

正在授予此角色分配的数据平面资源路径。

可选参数

--no-wait

不等待长时间运行的操作完成。

--role-assignment-id -i

Create 的可选。 角色分配的唯一 ID。 如果未提供,则将使用新的 GUID。

--role-definition-id -d

此角色分配所指的角色定义的唯一 ID。

--role-definition-name -n

此角色分配所指的角色定义的唯一名称。 例如 "Contoso 读者角色"。

--subscription

订阅的名称或 ID。 您可以使用配置默认订阅 az account set -s NAME_OR_ID

az cosmosdb sql role assignment delete

删除 Azure Cosmos DB 帐户下的 SQL 角色分配。

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

示例

删除 Azure Cosmos DB 帐户下的 SQL 角色分配。

az cosmosdb sql role assignment delete --account-name MyAccount --resource-group MyResourceGroup --role-assignment-id cb8ed2d7-2371-4e3c-bd31-6cc1560e84f8

必需参数

--account-name -a

Cosmosdb 帐户名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--role-assignment-id -i

Create 的可选。 角色分配的唯一 ID。 如果未提供,则将使用新的 GUID。

可选参数

--no-wait

不等待长时间运行的操作完成。

--subscription

订阅的名称或 ID。 您可以使用配置默认订阅 az account set -s NAME_OR_ID

--yes -y

不提示确认。

az cosmosdb sql role assignment exists

检查是否存在 Azure Cosmos DB 角色分配。

az cosmosdb sql role assignment exists --account-name
                                       --resource-group
                                       --role-assignment-id
                                       [--subscription]

示例

检查是否存在 Azure Cosmos DB 角色分配。

az cosmosdb sql role assignment exists --account-name MyAccount --resource-group MyResourceGroup --role-assignment-id cb8ed2d7-2371-4e3c-bd31-6cc1560e84f8

必需参数

--account-name -a

Cosmosdb 帐户名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--role-assignment-id -i

Create 的可选。 角色分配的唯一 ID。 如果未提供,则将使用新的 GUID。

可选参数

--subscription

订阅的名称或 ID。 您可以使用配置默认订阅 az account set -s NAME_OR_ID

az cosmosdb sql role assignment list

列出 Azure Cosmos DB 帐户下的所有 SQL 角色分配。

az cosmosdb sql role assignment list --account-name
                                     --resource-group
                                     [--query-examples]
                                     [--subscription]

示例

列出 Azure Cosmos DB 帐户下的所有 SQL 角色分配。

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

必需参数

--account-name -a

Cosmosdb 帐户名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

可选参数

--query-examples

建议 JMESPath 字符串。 可以复制其中一个查询,然后将其粘贴在双引号内,以查看结果。 您可以添加一个或多个位置关键字,以便我们可以根据这些关键字提供建议。

--subscription

订阅的名称或 ID。 您可以使用配置默认订阅 az account set -s NAME_OR_ID

az cosmosdb sql role assignment show

在 Azure Cosmos DB 帐户下显示 SQL 角色分配的属性。

az cosmosdb sql role assignment show --account-name
                                     --resource-group
                                     --role-assignment-id
                                     [--query-examples]
                                     [--subscription]

示例

在 Azure Cosmos DB 帐户下显示 SQL 角色分配的属性。

az cosmosdb sql role assignment show --account-name MyAccount --resource-group MyResourceGroup --role-assignment-id cb8ed2d7-2371-4e3c-bd31-6cc1560e84f8

必需参数

--account-name -a

Cosmosdb 帐户名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--role-assignment-id -i

Create 的可选。 角色分配的唯一 ID。 如果未提供,则将使用新的 GUID。

可选参数

--query-examples

建议 JMESPath 字符串。 可以复制其中一个查询,然后将其粘贴在双引号内,以查看结果。 您可以添加一个或多个位置关键字,以便我们可以根据这些关键字提供建议。

--subscription

订阅的名称或 ID。 您可以使用配置默认订阅 az account set -s NAME_OR_ID

az cosmosdb sql role assignment update

在 Azure Cosmos DB 帐户下更新 SQL 角色分配。

az cosmosdb sql role assignment update --account-name
                                       --resource-group
                                       --role-assignment-id
                                       [--no-wait]
                                       [--principal-id]
                                       [--role-definition-id]
                                       [--role-definition-name]
                                       [--scope]
                                       [--subscription]

示例

在 Azure Cosmos DB 帐户下更新 SQL 角色分配。

az cosmosdb sql role assignment update --account-name MyAccount --resource-group MyResourceGroup \
  --role-assignment-id cb8ed2d7-2371-4e3c-bd31-6cc1560e84f8 \
  --role-definition-id updated-role-definition-id

必需参数

--account-name -a

Cosmosdb 帐户名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--role-assignment-id -i

Create 的可选。 角色分配的唯一 ID。 如果未提供,则将使用新的 GUID。

可选参数

--no-wait

不等待长时间运行的操作完成。

--principal-id -p

向其授予此角色分配的主体的 AAD 对象 ID。

--role-definition-id -d

此角色分配所指的角色定义的唯一 ID。

--role-definition-name -n

此角色分配所指的角色定义的唯一名称。 例如 "Contoso 读者角色"。

--scope -s

正在授予此角色分配的数据平面资源路径。

--subscription

订阅的名称或 ID。 您可以使用配置默认订阅 az account set -s NAME_OR_ID

az cosmosdb sql role assignment wait

在满足特定条件之前,轮询 SQL 角色分配。

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

示例

轮询 SQL 角色分配,直到它被删除。

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

必需参数

--account-name -a

Cosmosdb 帐户名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--role-assignment-id -i

Create 的可选。 角色分配的唯一 ID。 如果未提供,则将使用新的 GUID。

可选参数

--created

等待 "provisioningState" 在 "Succeeded" 处创建。

--custom

等到条件满足自定义 JMESPath 查询。 例如 provisioningState! = "InProgress",instanceView [? code = = ' PowerState/正在运行 ']。

--deleted

等待,直到被删除。

--exists

等待该资源存在。

--interval

轮询间隔(秒)。

默认值: 30
--subscription

订阅的名称或 ID。 您可以使用配置默认订阅 az account set -s NAME_OR_ID

--timeout

最长等待时间(秒)。

默认值: 3600
--updated

请等待,直到在 "Succeeded" 中更新 provisioningState。