az resource

Administración de recursos de Azure.

Comandos

Nombre Description Tipo Estado
az resource create

Crear un recurso.

Principal GA
az resource delete

Eliminar un recurso.

Principal GA
az resource invoke-action

Invoque una acción en el recurso.

Principal GA
az resource link

Administrar vínculos entre recursos.

Principal GA
az resource link create

Cree un vínculo entre recursos.

Principal GA
az resource link delete

Elimine un vínculo entre recursos.

Principal GA
az resource link list

Enumerar vínculos de recursos.

Principal GA
az resource link show

Obtiene un vínculo de recurso con el identificador especificado.

Principal GA
az resource link update

Actualizar vínculo entre recursos.

Principal GA
az resource list

Enumera los recursos.

Principal GA
az resource lock

Administrar bloqueos de nivel de recurso de Azure.

Principal GA
az resource lock create

Cree un bloqueo de nivel de recurso.

Principal GA
az resource lock delete

Elimine un bloqueo de nivel de recurso.

Principal GA
az resource lock list

Enumera la información de bloqueo en el nivel de recurso.

Principal GA
az resource lock show

Muestra los detalles de un bloqueo de nivel de recurso.

Principal GA
az resource lock update

Actualice un bloqueo de nivel de recurso.

Principal GA
az resource move

Mover recursos de un grupo de recursos a otro (puede estar en una suscripción diferente).

Principal GA
az resource patch

Actualice un recurso mediante solicitud PATCH.

Principal GA
az resource show

Obtenga los detalles de un recurso.

Principal GA
az resource tag

Etiquete un recurso.

Principal GA
az resource update

Actualice un recurso mediante solicitud PUT.

Principal GA
az resource wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición de recursos.

Principal GA

az resource create

Crear un recurso.

az resource create --properties
                   [--api-version]
                   [--id]
                   [--is-full-object]
                   [--latest-include-preview]
                   [--location]
                   [--name]
                   [--namespace]
                   [--parent]
                   [--resource-group]
                   [--resource-type]

Ejemplos

Cree una aplicación de API proporcionando una configuración JSON completa.

az resource create -g myRG -n myApiApp --resource-type Microsoft.web/sites \
    --is-full-object --properties "{ \"kind\": \"api\", \"location\": \
        \"West US\", \"properties\": { \"serverFarmId\": \
            \"/subscriptions/{SubID}/resourcegroups/{ResourceGroup} \
                /providers/Microsoft.Web/serverfarms/{ServicePlan}\" } }"

Cree un recurso cargando la configuración JSON desde un archivo.

az resource create -g myRG -n myApiApp --resource-type Microsoft.web/sites --is-full-object --properties @jsonConfigFile

Cree una aplicación web con la información de configuración mínima necesaria.

az resource create -g myRG -n myWeb --resource-type Microsoft.web/sites \
    --properties "{ \"serverFarmId\":\"/subscriptions/{SubID}/resourcegroups/ \
        {ResourceGroup}/providers/Microsoft.Web/serverfarms/{ServicePlan}\" }"

Cree un recurso mediante la versión más reciente de api si esta versión es una versión preliminar.

az resource create -g myRG -n myApiApp --resource-type Microsoft.web/sites --is-full-object --properties @jsonConfigFile --latest-include-preview

Creación de una extensión de sitio en una aplicación web

az resource create -g myRG --api-version "2018-02-01" \
    --name "{sitename+slot}/siteextensions/Contrast.NetCore.Azure.SiteExtension"  \
        --resource-type Microsoft.Web/sites/siteextensions --is-full-object \
            --properties "{ \"id\": \"Contrast.NetCore.Azure.SiteExtension\", \
                \"location\": \"West US\", \"version\": \"1.9.0\" }"

Parámetros requeridos

--properties -p

Cadena con formato JSON que contiene propiedades de recursos.

Parámetros opcionales

--api-version

La versión de api del recurso (omita para la versión estable más reciente).

--id

Identificador del recurso.

--is-full-object

Indique que el objeto properties incluye otras opciones, como ubicación, etiquetas, sku o plan.

valor predeterminado: False
--latest-include-preview -v
Vista previa

Indique que se usará la versión más reciente de api independientemente de si es versión preliminar (por ejemplo, 2020-01-01-preview) o no. Por ejemplo, si la versión de API-version admitida del proveedor de recursos es 2020-01-01-preview y 2019-01-01: al pasar este parámetro, tomará la versión más reciente 2020-01-01-preview; de lo contrario, tomará la versión estable más reciente 2019-01-01 sin pasar este parámetro.

valor predeterminado: False
--location -l

Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--name -n

Nombre del recurso. (Por ejemplo: myC).

--namespace

Espacio de nombres del proveedor (por ejemplo: "Microsoft.Provider").

--parent

La ruta de acceso primaria (por ejemplo: "resA/myA/resB/myB").

--resource-group -g

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

--resource-type

Tipo de recurso (por ejemplo: "resC"). También puede aceptar el formato de espacio de nombres o tipo (por ejemplo: "Microsoft.Provider/resC").

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

Eliminar un recurso.

az resource delete [--api-version]
                   [--ids]
                   [--latest-include-preview]
                   [--name]
                   [--namespace]
                   [--no-wait]
                   [--parent]
                   [--resource-group]
                   [--resource-type]

Ejemplos

Elimine una máquina virtual denominada "MyVm".

az resource delete -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines"

Elimine una aplicación web mediante un identificador de recursos.

az resource delete --ids /subscriptions/0b1f6471-1bf0-4dda-aec3-111111111111/resourceGroups/MyResourceGroup/providers/Microsoft.Web/sites/MyWebapp

Elimine una subred mediante un identificador de recurso.

az resource delete --ids /subscriptions/0b1f6471-1bf0-4dda-aec3-111111111111/resourceGroups/MyResourceGroup/providers/Microsoft.Network/virtualNetworks/MyVnet/subnets/MySubnet

Elimine una máquina virtual denominada "MyVm" mediante la versión de API más reciente si esta versión es una versión preliminar.

az resource delete -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines" --latest-include-preview

Parámetros opcionales

--api-version

La versión de api del recurso (omita para la versión estable más reciente).

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Si se proporciona, no se deben especificar otros argumentos "Id. de recurso".

--latest-include-preview -v
Vista previa

Indique que se usará la versión más reciente de api independientemente de si es versión preliminar (por ejemplo, 2020-01-01-preview) o no. Por ejemplo, si la versión de API-version admitida del proveedor de recursos es 2020-01-01-preview y 2019-01-01: al pasar este parámetro, tomará la versión más reciente 2020-01-01-preview; de lo contrario, tomará la versión estable más reciente 2019-01-01 sin pasar este parámetro.

valor predeterminado: False
--name -n

Nombre del recurso. (Por ejemplo: myC).

--namespace

Espacio de nombres del proveedor (por ejemplo: "Microsoft.Provider").

--no-wait

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

valor predeterminado: False
--parent

La ruta de acceso primaria (por ejemplo: "resA/myA/resB/myB").

--resource-group -g

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

--resource-type

Tipo de recurso (por ejemplo: "resC"). También puede aceptar el formato de espacio de nombres o tipo (por ejemplo: "Microsoft.Provider/resC").

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 resource invoke-action

Invoque una acción en el recurso.

Puede encontrar una lista de posibles acciones correspondientes a un recurso en https://docs.microsoft.com/rest/api/. Todas las solicitudes POST son acciones que se pueden invocar y se especifican al final de la ruta de acceso del URI. Por ejemplo, para detener una máquina virtual, el URI de solicitud es https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.Compute/virtualMachines/{VM}/powerOff?api-version={APIVersion} y la acción correspondiente es powerOff. Esto se puede encontrar en https://docs.microsoft.com/rest/api/compute/virtualmachines/virtualmachines-stop.

az resource invoke-action --action
                          [--api-version]
                          [--ids]
                          [--latest-include-preview]
                          [--name]
                          [--namespace]
                          [--no-wait]
                          [--parent]
                          [--request-body]
                          [--resource-group]
                          [--resource-type]

Ejemplos

Apague una máquina virtual, especificada por Id.

az resource invoke-action --action powerOff \
  --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Compute/virtualMachines/{VMName}

Capture información de una máquina virtual detenida.

az resource invoke-action --action capture \
  --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/ \
    Microsoft.Compute/virtualMachines/{VMName} \
  --request-body "{ \"vhdPrefix\": \"myPrefix\", \"destinationContainerName\": \
    \"myContainer\", \"overwriteVhds\": true }"

Invoque una acción en el recurso. (generado automáticamente)

az resource invoke-action --action capture --name MyResource --resource-group MyResourceGroup --resource-type Microsoft.web/sites

Parámetros requeridos

--action

Acción que se invocará en el recurso especificado.

Parámetros opcionales

--api-version

La versión de api del recurso (omita para la versión estable más reciente).

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Si se proporciona, no se deben especificar otros argumentos "Id. de recurso".

--latest-include-preview -v
Vista previa

Indique que se usará la versión más reciente de api independientemente de si es versión preliminar (por ejemplo, 2020-01-01-preview) o no. Por ejemplo, si la versión de API-version admitida del proveedor de recursos es 2020-01-01-preview y 2019-01-01: al pasar este parámetro, tomará la versión más reciente 2020-01-01-preview; de lo contrario, tomará la versión estable más reciente 2019-01-01 sin pasar este parámetro.

valor predeterminado: False
--name -n

Nombre del recurso. (Por ejemplo: myC).

--namespace

Espacio de nombres del proveedor (por ejemplo: "Microsoft.Provider").

--no-wait

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

valor predeterminado: False
--parent

La ruta de acceso primaria (por ejemplo: "resA/myA/resB/myB").

--request-body

Argumentos de parámetro codificados json para la acción que se pasará en el cuerpo de la solicitud posterior. Use @{file} para cargar desde un archivo.

--resource-group -g

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

--resource-type

Tipo de recurso (por ejemplo: "resC"). También puede aceptar el formato de espacio de nombres o tipo (por ejemplo: "Microsoft.Provider/resC").

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

Enumera los recursos.

az resource list [--location]
                 [--name]
                 [--namespace]
                 [--resource-group]
                 [--resource-type]
                 [--tag]

Ejemplos

Enumere todos los recursos de la región Oeste de EE. UU.

az resource list --location westus

Enumere todos los recursos con el nombre "resourceName".

az resource list --name 'resourceName'

Enumere todos los recursos con la etiqueta "test".

az resource list --tag test

Enumere todos los recursos con una etiqueta que comience por "test".

az resource list --tag 'test*'

Enumere todos los recursos con la etiqueta "test" que tengan el valor "example".

az resource list --tag test=example

Parámetros opcionales

--location -l

Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--name -n

Nombre del recurso. (Por ejemplo: myC).

--namespace

Espacio de nombres del proveedor (por ejemplo: "Microsoft.Provider").

--resource-group -g

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

--resource-type

Tipo de recurso (por ejemplo: "resC"). También puede aceptar el formato de espacio de nombres o tipo (por ejemplo: "Microsoft.Provider/resC").

--tag

Una sola etiqueta en formato 'key[=value]'. Use "" para borrar las etiquetas existentes.

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

Mover recursos de un grupo de recursos a otro (puede estar en una suscripción diferente).

az resource move --destination-group
                 --ids
                 [--destination-subscription-id]

Ejemplos

Traslado de varios recursos al grupo de recursos de destino en la suscripción de destino

az resource move --destination-group ResourceGroup --destination-subscription-id SubscriptionId --ids "ResourceId1" "ResourceId2" "ResourceId3"

Parámetros requeridos

--destination-group

Nombre del grupo de recursos de destino.

--ids

Identificadores de recursos separados por espacios que se van a mover.

Parámetros opcionales

--destination-subscription-id

Identificador de suscripción de destino.

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

Actualice un recurso mediante solicitud PATCH.

Admite la actualización de recursos con cadena con formato JSON. Si se produce un error en la operación de revisión, pruebe a ejecutar "az resource update" en su lugar.

az resource patch --properties
                  [--api-version]
                  [--ids]
                  [--is-full-object]
                  [--latest-include-preview]
                  [--name]
                  [--namespace]
                  [--parent]
                  [--resource-group]
                  [--resource-type]

Ejemplos

Actualice una aplicación web mediante la versión más reciente de api si esta versión es una versión preliminar.

az resource patch --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Web/sites/{WebApp} \
  --latest-include-preview --is-full-object --properties "{ \"tags\": { \"key\": \"value\" } }"

Actualice un recurso mediante la configuración JSON de un archivo.

az resource patch --name MyResource --resource-group MyResourceGroup --resource-type Microsoft.web/sites \
  --is-full-object --properties @jsonConfigFile

Actualice una aplicación de API proporcionando una configuración JSON.

az resource patch --name MyApiApp --resource-group MyResourceGroup --resource-type Microsoft.web/sites \
    --is-full-object --properties "{ \"kind\": \"api\", \"properties\": { \"serverFarmId\": \
            \"/subscriptions/{SubID}/resourcegroups/{ResourceGroup} \
                /providers/Microsoft.Web/serverfarms/{ServicePlan}\" } }"

Parámetros requeridos

--properties -p

Cadena con formato JSON que contiene propiedades de recursos.

Parámetros opcionales

--api-version

La versión de api del recurso (omita para la versión estable más reciente).

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Si se proporciona, no se deben especificar otros argumentos "Id. de recurso".

--is-full-object

Indique que el objeto properties incluye otras opciones, como ubicación, etiquetas, sku o plan.

valor predeterminado: False
--latest-include-preview -v
Vista previa

Indique que se usará la versión más reciente de api independientemente de si es versión preliminar (por ejemplo, 2020-01-01-preview) o no. Por ejemplo, si la versión de API-version admitida del proveedor de recursos es 2020-01-01-preview y 2019-01-01: al pasar este parámetro, tomará la versión más reciente 2020-01-01-preview; de lo contrario, tomará la versión estable más reciente 2019-01-01 sin pasar este parámetro.

valor predeterminado: False
--name -n

Nombre del recurso. (Por ejemplo: myC).

--namespace

Espacio de nombres del proveedor (por ejemplo: "Microsoft.Provider").

--parent

La ruta de acceso primaria (por ejemplo: "resA/myA/resB/myB").

--resource-group -g

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

--resource-type

Tipo de recurso (por ejemplo: "resC"). También puede aceptar el formato de espacio de nombres o tipo (por ejemplo: "Microsoft.Provider/resC").

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

Obtenga los detalles de un recurso.

az resource show [--api-version]
                 [--ids]
                 [--include-response-body {false, true}]
                 [--latest-include-preview]
                 [--name]
                 [--namespace]
                 [--parent]
                 [--resource-group]
                 [--resource-type]

Ejemplos

Mostrar un recurso de máquina virtual denominado "MyVm".

az resource show -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines"

Mostrar una aplicación web mediante un identificador de recurso.

az resource show --ids /subscriptions/0b1f6471-1bf0-4dda-aec3-111111111111/resourceGroups/MyResourceGroup/providers/Microsoft.Web/sites/MyWebapp

Mostrar una subred.

az resource show -g MyResourceGroup -n MySubnet --namespace Microsoft.Network --parent virtualnetworks/MyVnet --resource-type subnets

Mostrar una subred mediante un identificador de recursos.

az resource show --ids /subscriptions/0b1f6471-1bf0-4dda-aec3-111111111111/resourceGroups/MyResourceGroup/providers/Microsoft.Network/virtualNetworks/MyVnet/subnets/MySubnet

Mostrar una regla de ruta de acceso de puerta de enlace de aplicaciones.

az resource show -g MyResourceGroup --namespace Microsoft.Network --parent applicationGateways/ag1/urlPathMaps/map1 --resource-type pathRules -n rule1

Muestre un recurso de máquina virtual denominado "MyVm" mediante la versión de API más reciente si esta versión es una versión preliminar.

az resource show -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines" --latest-include-preview

Parámetros opcionales

--api-version

La versión de api del recurso (omita para la versión estable más reciente).

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Si se proporciona, no se deben especificar otros argumentos "Id. de recurso".

--include-response-body

Use si la salida predeterminada del comando no captura todos los datos de propiedad.

valores aceptados: false, true
valor predeterminado: False
--latest-include-preview -v
Vista previa

Indique que se usará la versión más reciente de api independientemente de si es versión preliminar (por ejemplo, 2020-01-01-preview) o no. Por ejemplo, si la versión de API-version admitida del proveedor de recursos es 2020-01-01-preview y 2019-01-01: al pasar este parámetro, tomará la versión más reciente 2020-01-01-preview; de lo contrario, tomará la versión estable más reciente 2019-01-01 sin pasar este parámetro.

valor predeterminado: False
--name -n

Nombre del recurso. (Por ejemplo: myC).

--namespace

Espacio de nombres del proveedor (por ejemplo: "Microsoft.Provider").

--parent

La ruta de acceso primaria (por ejemplo: "resA/myA/resB/myB").

--resource-group -g

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

--resource-type

Tipo de recurso (por ejemplo: "resC"). También puede aceptar el formato de espacio de nombres o tipo (por ejemplo: "Microsoft.Provider/resC").

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

Etiquete un recurso.

az resource tag --tags
                [--api-version]
                [--ids]
                [--is-incremental]
                [--latest-include-preview]
                [--name]
                [--namespace]
                [--parent]
                [--resource-group]
                [--resource-type]

Ejemplos

Etiquete la máquina virtual "MyVm" con la clave "vmlist" y el valor "vm1".

az resource tag --tags vmlist=vm1 -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines"

Etiquete una aplicación web con la clave "vmlist" y el valor "vm1", mediante un identificador de recurso.

az resource tag --tags vmlist=vm1 --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Web/sites/{WebApp}

Etiquete la máquina virtual "MyVm" con la clave "vmlist" y el valor "vm1" incrementalmente. No vacía las etiquetas existentes.

az resource tag --tags vmlist=vm1 -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines" -i

Etiquete la máquina virtual "MyVm" con la clave "vmlist" y el valor "vm1" mediante la versión de API más reciente si esta versión es una versión preliminar.

az resource tag --tags vmlist=vm1 -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines" --latest-include-preview

Parámetros requeridos

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

Parámetros opcionales

--api-version

La versión de api del recurso (omita para la versión estable más reciente).

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Si se proporciona, no se deben especificar otros argumentos "Id. de recurso".

--is-incremental -i

Opción para agregar etiquetas de forma incremental sin eliminar las etiquetas originales. Si la clave de la nueva etiqueta y la etiqueta original están duplicadas, se sobrescribirá el valor original.

--latest-include-preview -v
Vista previa

Indique que se usará la versión más reciente de api independientemente de si es versión preliminar (por ejemplo, 2020-01-01-preview) o no. Por ejemplo, si la versión de API-version admitida del proveedor de recursos es 2020-01-01-preview y 2019-01-01: al pasar este parámetro, tomará la versión más reciente 2020-01-01-preview; de lo contrario, tomará la versión estable más reciente 2019-01-01 sin pasar este parámetro.

valor predeterminado: False
--name -n

Nombre del recurso. (Por ejemplo: myC).

--namespace

Espacio de nombres del proveedor (por ejemplo: "Microsoft.Provider").

--parent

La ruta de acceso primaria (por ejemplo: "resA/myA/resB/myB").

--resource-group -g

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

--resource-type

Tipo de recurso (por ejemplo: "resC"). También puede aceptar el formato de espacio de nombres o tipo (por ejemplo: "Microsoft.Provider/resC").

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

Actualice un recurso mediante solicitud PUT.

Admite la actualización genérica (mediante la ruta de acceso de propiedad) para actualizar los recursos. Si se produce un error en la operación de actualización, pruebe a ejecutar "az resource patch" en su lugar.

az resource update [--add]
                   [--api-version]
                   [--force-string]
                   [--ids]
                   [--include-response-body {false, true}]
                   [--latest-include-preview]
                   [--name]
                   [--namespace]
                   [--parent]
                   [--remove]
                   [--resource-group]
                   [--resource-type]
                   [--set]

Ejemplos

Actualice una aplicación web mediante la versión más reciente de api si esta versión es una versión preliminar.

az resource update --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Web/sites/{WebApp} --set tags.key=value --latest-include-preview

Actualizar un recurso. (generado automáticamente)

az resource update --ids $id --set properties.connectionType=Proxy

Actualizar un recurso. (generado automáticamente)

az resource update --name MyResource --resource-group MyResourceGroup --resource-type subnets --set tags.key=value

Parámetros opcionales

--add

Agregue un objeto a una lista de objetos especificando una ruta de acceso y pares clave-valor. Ejemplo: --add property.listProperty <key=value, string or JSON string>.

valor predeterminado: []
--api-version

La versión de api del recurso (omita para la versión estable más reciente).

--force-string

Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir en JSON.

valor predeterminado: False
--ids

Uno o varios identificadores de recursos (delimitados por espacios). Si se proporciona, no se deben especificar otros argumentos "Id. de recurso".

--include-response-body

Use si la salida predeterminada del comando no captura todos los datos de propiedad.

valores aceptados: false, true
valor predeterminado: False
--latest-include-preview -v
Vista previa

Indique que se usará la versión más reciente de api independientemente de si es versión preliminar (por ejemplo, 2020-01-01-preview) o no. Por ejemplo, si la versión de API-version admitida del proveedor de recursos es 2020-01-01-preview y 2019-01-01: al pasar este parámetro, tomará la versión más reciente 2020-01-01-preview; de lo contrario, tomará la versión estable más reciente 2019-01-01 sin pasar este parámetro.

valor predeterminado: False
--name -n

Nombre del recurso. (Por ejemplo: myC).

--namespace

Espacio de nombres del proveedor (por ejemplo: "Microsoft.Provider").

--parent

La ruta de acceso primaria (por ejemplo: "resA/myA/resB/myB").

--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list <indexToRemove> O --remove propertyToRemove.

valor predeterminado: []
--resource-group -g

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

--resource-type

Tipo de recurso (por ejemplo: "resC"). También puede aceptar el formato de espacio de nombres o tipo (por ejemplo: "Microsoft.Provider/resC").

--set

Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=<value>.

valor predeterminado: []
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 resource wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición de recursos.

az resource wait [--api-version]
                 [--created]
                 [--custom]
                 [--deleted]
                 [--exists]
                 [--ids]
                 [--include-response-body {false, true}]
                 [--interval]
                 [--name]
                 [--namespace]
                 [--parent]
                 [--resource-group]
                 [--resource-type]
                 [--timeout]
                 [--updated]

Ejemplos

Coloque la CLI en un estado de espera hasta que se cumpla una condición de recursos. (generado automáticamente)

az resource wait --exists --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Web/sites/{WebApp}

Coloque la CLI en un estado de espera hasta que se cumpla una condición de recursos. (generado automáticamente)

az resource wait --exists --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Web/sites/{WebApp} --include-response-body true

Coloque la CLI en un estado de espera hasta que se cumpla una condición de recursos. (generado automáticamente)

az resource wait --exists --name MyResource --resource-group MyResourceGroup --resource-type subnets

Parámetros opcionales

--api-version

La versión de api del recurso (omita para la versión estable más reciente).

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

Uno o varios identificadores de recursos (delimitados por espacios). Si se proporciona, no se deben especificar otros argumentos "Id. de recurso".

--include-response-body

Use si la salida predeterminada del comando no captura todos los datos de propiedad.

valores aceptados: false, true
valor predeterminado: False
--interval

Intervalo de sondeo en segundos.

valor predeterminado: 30
--name -n

Nombre del recurso. (Por ejemplo: myC).

--namespace

Espacio de nombres del proveedor (por ejemplo: "Microsoft.Provider").

--parent

La ruta de acceso primaria (por ejemplo: "resA/myA/resB/myB").

--resource-group -g

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

--resource-type

Tipo de recurso (por ejemplo: "resC"). También puede aceptar el formato de espacio de nombres o tipo (por ejemplo: "Microsoft.Provider/resC").

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