az role definition

Administrar definiciones de roles.

Comandos

az role definition create

Cree una definición de rol personalizada.

az role definition delete

Elimine una definición de rol.

az role definition list

Enumera las definiciones de roles.

az role definition update

Actualice una definición de rol.

az role definition create

Cree una definición de rol personalizada.

az role definition create --role-definition
                          [--subscription]

Ejemplos

Cree un rol con acceso de solo lectura a los recursos de almacenamiento y red, y la capacidad de iniciar o reiniciar las máquinas virtuales. (Bash)

az role definition create --role-definition '{
    "Name": "Contoso On-call",
    "Description": "Perform VM actions and read storage and network information.",
    "Actions": [
        "Microsoft.Compute/*/read",
            "Microsoft.Compute/virtualMachines/start/action",
            "Microsoft.Compute/virtualMachines/restart/action",
            "Microsoft.Network/*/read",
        "Microsoft.Storage/*/read",
            "Microsoft.Authorization/*/read",
        "Microsoft.Resources/subscriptions/resourceGroups/read",
        "Microsoft.Resources/subscriptions/resourceGroups/resources/read",
        "Microsoft.Insights/alertRules/*",
            "Microsoft.Support/*"
    ],
    "DataActions": [
        "Microsoft.Storage/storageAccounts/blobServices/containers/blobs/*"
    ],
    "NotDataActions": [
        "Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write"
    ],
    "AssignableScopes": ["/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"]
}'

Cree un rol a partir de un archivo que contenga una descripción JSON.

az role definition create --role-definition @ad-role.json

Parámetros requeridos

--role-definition

Descripción de un rol como JSON o una ruta de acceso a un archivo que contiene una descripción JSON.

Parámetros opcionales

--subscription

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

az role definition delete

Elimine una definición de rol.

az role definition delete --name
                          [--custom-role-only {false, true}]
                          [--resource-group]
                          [--scope]
                          [--subscription]

Ejemplos

Elimine una definición de rol. (generado automáticamente)

az role definition delete --name MyRole

Parámetros requeridos

--name -n

Nombre del rol.

Parámetros opcionales

--custom-role-only

Solo roles personalizados (frente a los de compilación).

valores aceptados: false, true
--resource-group -g

Úselo solo si el rol o la asignación se agregaron en el nivel de un grupo de recursos.

--scope

Ámbito al que se aplica la asignación o definición de roles, por ejemplo, /subscriptions/0b1f6471-1bf0-4dda-aec3-111122223333, /subscriptions/0b1f6471-1bf0-4dda-aec3-111122223333/resourceGroups/myGroup, o /subscriptions/0b1f6471-1bf0-4dda-aec3-111122223333/resourceGroups/myGroup/providers/Microsoft.Compute/virtualMachines/myVM.

--subscription

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

az role definition list

Enumera las definiciones de roles.

az role definition list [--custom-role-only {false, true}]
                        [--name]
                        [--query-examples]
                        [--resource-group]
                        [--scope]
                        [--subscription]

Parámetros opcionales

--custom-role-only

Solo roles personalizados (frente a los de compilación).

valores aceptados: false, true
--name -n

Nombre del rol.

--query-examples

Se recomienda la cadena JMESPath. Puede copiar una de las consultas y pegarla después del parámetro --query entre comillas dobles para ver los resultados. Puede agregar una o varias palabras clave posicionales para que podamos proporcionar sugerencias basadas en estas palabras clave.

--resource-group -g

Úselo solo si el rol o la asignación se agregaron en el nivel de un grupo de recursos.

--scope

Ámbito al que se aplica la asignación o definición de roles, por ejemplo, /subscriptions/0b1f6471-1bf0-4dda-aec3-111122223333, /subscriptions/0b1f6471-1bf0-4dda-aec3-111122223333/resourceGroups/myGroup, o /subscriptions/0b1f6471-1bf0-4dda-aec3-111122223333/resourceGroups/myGroup/providers/Microsoft.Compute/virtualMachines/myVM.

--subscription

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

az role definition update

Actualice una definición de rol.

az role definition update --role-definition
                          [--subscription]

Ejemplos

Actualice un rol mediante la salida de "az role definition list". (Bash)

az role definition update --role-definition '{
    "roleName": "Contoso On-call",
    "Description": "Perform VM actions and read storage and network information.",
    "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Authorization/roleDefinitions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "roleType": "CustomRole",
    "type": "Microsoft.Authorization/roleDefinitions",
    "Actions": [
        "Microsoft.Compute/*/read",
            "Microsoft.Compute/virtualMachines/start/action",
            "Microsoft.Compute/virtualMachines/restart/action",
            "Microsoft.Network/*/read",
        "Microsoft.Storage/*/read",
            "Microsoft.Authorization/*/read",
        "Microsoft.Resources/subscriptions/resourceGroups/read",
        "Microsoft.Resources/subscriptions/resourceGroups/resources/read",
        "Microsoft.Support/*"
        ],
        "DataActions": [
            "Microsoft.Storage/storageAccounts/blobServices/containers/blobs/*"
    ],
    "NotDataActions": [
        "Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write"
    ],
    "AssignableScopes": ["/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"]
}'

Parámetros requeridos

--role-definition

Descripción de un rol existente como JSON o una ruta de acceso a un archivo que contiene una descripción JSON.

Parámetros opcionales

--subscription

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