Leer en inglés

Compartir vía

az cosmosdb sql role definition

  • Referencia

Administración de definiciones de roles de SQL de Azure Cosmos DB.

Comandos

Nombre Description Tipo Estado
az cosmosdb sql role definition create

Cree una definición de rol de SQL en una cuenta de Azure Cosmos DB.

 Principal GA
az cosmosdb sql role definition delete

Elimine una definición de rol de SQL en una cuenta de Azure Cosmos DB.

 Principal GA
az cosmosdb sql role definition exists

Compruebe si existe una definición de rol de Azure Cosmos DB.

 Principal GA
az cosmosdb sql role definition list

Enumere todas las definiciones de roles de SQL en una cuenta de Azure Cosmos DB.

 Principal GA
az cosmosdb sql role definition show

Mostrar las propiedades de una definición de rol de SQL en una cuenta de Azure Cosmos DB.

 Principal GA
az cosmosdb sql role definition update

Actualice una definición de rol de SQL en una cuenta de Azure Cosmos DB.

 Principal GA
az cosmosdb sql role definition wait

Sondee en una definición de rol de SQL hasta que se cumpla una condición específica.

 Principal GA

az cosmosdb sql role definition create

Editar

Cree una definición de rol de SQL en una cuenta de Azure Cosmos DB.

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

Ejemplos

Cree una definición de rol de SQL en una cuenta de Azure Cosmos DB mediante una cadena JSON.

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

Cree una definición de rol de SQL en una cuenta de Azure Cosmos DB mediante un archivo JSON.

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

Parámetros requeridos

--account-name -a

Nombre de la cuenta de Cosmosdb.

--body -b

Cuerpo de definición de roles con id. (opcional para crear), DataActions o Permisos, Tipo (el valor predeterminado es CustomRole) y AssignableScopes. Puede escribirlo como una cadena o como un archivo, por ejemplo, --body @rdbody-file.json o --body "{ "Id": "be79875a-2cc4-40d5-8958-566017875b39", "RoleName": "My Read Write Role", "Type": "Type": ""CustomRole", "AssignableScopes": [ "/" ], "DataActions": [ "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers/items/create", "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers/items/read" ]}".

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az cosmosdb sql role definition delete

Editar

Elimine una definición de rol de SQL en una cuenta de Azure Cosmos DB.

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

Ejemplos

Elimine una definición de rol de SQL en una cuenta de Azure Cosmos DB.

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

Parámetros requeridos

--account-name -a

Nombre de la cuenta de Cosmosdb.

--id -i

Identificador único para la definición de roles.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False
--yes -y

No solicita confirmación.

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az cosmosdb sql role definition exists

Editar

Compruebe si existe una definición de rol de Azure Cosmos DB.

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

Ejemplos

Compruebe si existe una definición de rol de Azure Cosmos DB.

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

Parámetros requeridos

--account-name -a

Nombre de la cuenta de Cosmosdb.

--id -i

Identificador único para la definición de roles.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az cosmosdb sql role definition list

Editar

Enumere todas las definiciones de roles de SQL en una cuenta de Azure Cosmos DB.

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

Ejemplos

Enumere todas las definiciones de roles de SQL en una cuenta de Azure Cosmos DB.

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

Parámetros requeridos

--account-name -a

Nombre de la cuenta de Cosmosdb.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az cosmosdb sql role definition show

Editar

Mostrar las propiedades de una definición de rol de SQL en una cuenta de Azure Cosmos DB.

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

Ejemplos

Mostrar las propiedades de una definición de rol de SQL en una cuenta de Azure Cosmos DB.

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

Parámetros requeridos

--account-name -a

Nombre de la cuenta de Cosmosdb.

--id -i

Identificador único para la definición de roles.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az cosmosdb sql role definition update

Editar

Actualice una definición de rol de SQL en una cuenta de Azure Cosmos DB.

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

Ejemplos

Actualice una definición de rol de SQL en una cuenta de Azure Cosmos DB.

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

Parámetros requeridos

--account-name -a

Nombre de la cuenta de Cosmosdb.

--body -b

Cuerpo de definición de roles con id. (opcional para crear), DataActions o Permisos, Tipo (el valor predeterminado es CustomRole) y AssignableScopes. Puede escribirlo como una cadena o como un archivo, por ejemplo, --body @rdbody-file.json o --body "{ "Id": "be79875a-2cc4-40d5-8958-566017875b39", "RoleName": "My Read Write Role", "Type": "Type": ""CustomRole", "AssignableScopes": [ "/" ], "DataActions": [ "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers/items/create", "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers/items/read" ]}".

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az cosmosdb sql role definition wait

Editar

Sondee en una definición de rol de SQL hasta que se cumpla una condición específica.

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

Ejemplos

Sondee en una definición de rol de SQL hasta que se elimine.

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

Parámetros requeridos

--account-name -a

Nombre de la cuenta de Cosmosdb.

--id -i

Identificador único para la definición de roles.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--created

Espere hasta que se cree con "provisioningState" en "Succeeded".

Valor predeterminado: False
--custom

Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Espere hasta que se elimine.

Valor predeterminado: False
--exists

Espere hasta que exista el recurso.

Valor predeterminado: False
--interval

Intervalo de sondeo en segundos.

Valor predeterminado: 30
--timeout

Espera máxima en segundos.

Valor predeterminado: 3600
--updated

Espere hasta que se actualice con provisioningState en "Succeeded".

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.