Compartir a través de


az resource

Administración de recursos de Azure.

Comandos

Nombre Description Tipo Estado
az resource create

Cree un recurso.

Core GA
az resource delete

Elimine un recurso.

Core GA
az resource invoke-action

Invoque una acción en el recurso.

Core GA
az resource link

Administrar vínculos entre recursos.

Core GA
az resource link create

Cree un vínculo entre recursos.

Core GA
az resource link delete

Elimine un vínculo entre recursos.

Core GA
az resource link list

Enumerar vínculos de recursos.

Core GA
az resource link show

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

Core GA
az resource link update

Actualizar vínculo entre recursos.

Core GA
az resource list

List resources.

Core GA
az resource lock

Administrar bloqueos de nivel de recurso de Azure.

Core GA
az resource lock create

Cree un bloqueo de nivel de recurso.

Core GA
az resource lock delete

Elimine un bloqueo de nivel de recurso.

Core GA
az resource lock list

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

Core GA
az resource lock show

Muestra los detalles de un bloqueo de nivel de recurso.

Core GA
az resource lock update

Actualice un bloqueo de nivel de recurso.

Core GA
az resource move

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

Core GA
az resource patch

Actualice un recurso mediante solicitud PATCH.

Core GA
az resource show

Obtenga los detalles de un recurso.

Core GA
az resource tag

Etiquete un recurso.

Core GA
az resource update

Actualice un recurso mediante solicitud PUT.

Core GA
az resource wait

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

Core GA

az resource create

Cree 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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version

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

Propiedad Valor
Parameter group: Resource Id Arguments
--id

Resource ID.

--is-full-object

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

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

Propiedad Valor
Parameter group: Resource Id Arguments
Valor predeterminado: False
--location -l

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

--name -n

Nombre del recurso. (Ex: myC).

Propiedad Valor
Parameter group: Resource Id Arguments
--namespace

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

Propiedad Valor
Parameter group: Resource Id Arguments
--parent

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

Propiedad Valor
Parameter group: Resource Id Arguments
--resource-group -g

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

Propiedad Valor
Parameter group: Resource Id Arguments
--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").

Propiedad Valor
Parameter group: Resource Id Arguments
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az resource delete

Elimine 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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version

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

Propiedad Valor
Parameter group: Resource Id Arguments
--ids

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

Propiedad Valor
Parameter group: Resource Id Arguments
--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.

Propiedad Valor
Parameter group: Resource Id Arguments
Valor predeterminado: False
--name -n

Nombre del recurso. (Ex: myC).

Propiedad Valor
Parameter group: Resource Id Arguments
--namespace

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

Propiedad Valor
Parameter group: Resource Id Arguments
--no-wait

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

Propiedad Valor
Valor predeterminado: False
--parent

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

Propiedad Valor
Parameter group: Resource Id Arguments
--resource-group -g

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

Propiedad Valor
Parameter group: Resource Id Arguments
--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").

Propiedad Valor
Parameter group: Resource Id Arguments
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az resource invoke-action

Invoque una acción en el recurso.

Puede encontrar una lista de posibles acciones correspondientes a un recurso en https://learn.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 se 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://learn.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. (autogenerated)

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version

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

Propiedad Valor
Parameter group: Resource Id Arguments
--ids

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

Propiedad Valor
Parameter group: Resource Id Arguments
--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.

Propiedad Valor
Parameter group: Resource Id Arguments
Valor predeterminado: False
--name -n

Nombre del recurso. (Ex: myC).

Propiedad Valor
Parameter group: Resource Id Arguments
--namespace

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

Propiedad Valor
Parameter group: Resource Id Arguments
--no-wait

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

Propiedad Valor
Valor predeterminado: False
--parent

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

Propiedad Valor
Parameter group: Resource Id Arguments
--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>.

Propiedad Valor
Parameter group: Resource Id Arguments
--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").

Propiedad Valor
Parameter group: Resource Id Arguments
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az resource list

List resources.

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--location -l

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

--name -n

Nombre del recurso. (Ex: myC).

--namespace

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

Propiedad Valor
Parameter group: Resource Id Arguments
--resource-group -g

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

Propiedad Valor
Parameter group: Resource Id Arguments
--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").

Propiedad Valor
Parameter group: Resource Id Arguments
--tag

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

Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--destination-subscription-id

Identificador de suscripción de destino.

Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version

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

Propiedad Valor
Parameter group: Resource Id Arguments
--ids

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

Propiedad Valor
Parameter group: Resource Id Arguments
--is-full-object

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

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

Propiedad Valor
Parameter group: Resource Id Arguments
Valor predeterminado: False
--name -n

Nombre del recurso. (Ex: myC).

Propiedad Valor
Parameter group: Resource Id Arguments
--namespace

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

Propiedad Valor
Parameter group: Resource Id Arguments
--parent

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

Propiedad Valor
Parameter group: Resource Id Arguments
--resource-group -g

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

Propiedad Valor
Parameter group: Resource Id Arguments
--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").

Propiedad Valor
Parameter group: Resource Id Arguments
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version

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

Propiedad Valor
Parameter group: Resource Id Arguments
--ids

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

Propiedad Valor
Parameter group: Resource Id Arguments
--include-response-body

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

Propiedad Valor
Valor predeterminado: False
Valores aceptados: false, true
--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.

Propiedad Valor
Parameter group: Resource Id Arguments
Valor predeterminado: False
--name -n

Nombre del recurso. (Ex: myC).

Propiedad Valor
Parameter group: Resource Id Arguments
--namespace

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

Propiedad Valor
Parameter group: Resource Id Arguments
--parent

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

Propiedad Valor
Parameter group: Resource Id Arguments
--resource-group -g

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

Propiedad Valor
Parameter group: Resource Id Arguments
--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").

Propiedad Valor
Parameter group: Resource Id Arguments
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version

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

Propiedad Valor
Parameter group: Resource Id Arguments
--ids

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

Propiedad Valor
Parameter group: Resource Id Arguments
--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.

Propiedad Valor
Parameter group: Resource Id Arguments
Valor predeterminado: False
--name -n

Nombre del recurso. (Ex: myC).

Propiedad Valor
Parameter group: Resource Id Arguments
--namespace

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

Propiedad Valor
Parameter group: Resource Id Arguments
--parent

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

Propiedad Valor
Parameter group: Resource Id Arguments
--resource-group -g

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

Propiedad Valor
Parameter group: Resource Id Arguments
--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").

Propiedad Valor
Parameter group: Resource Id Arguments
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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

Actualice un recurso. (autogenerated)

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

Actualice un recurso. (autogenerated)

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

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Propiedad Valor
Parameter group: Generic Update Arguments
Valor predeterminado: []
--api-version

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

Propiedad Valor
Parameter group: Resource Id Arguments
--force-string

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

Propiedad Valor
Parameter group: Generic Update Arguments
Valor predeterminado: False
--ids

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

Propiedad Valor
Parameter group: Resource Id Arguments
--include-response-body

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

Propiedad Valor
Valor predeterminado: False
Valores aceptados: false, true
--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.

Propiedad Valor
Parameter group: Resource Id Arguments
Valor predeterminado: False
--name -n

Nombre del recurso. (Ex: myC).

Propiedad Valor
Parameter group: Resource Id Arguments
--namespace

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

Propiedad Valor
Parameter group: Resource Id Arguments
--parent

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

Propiedad Valor
Parameter group: Resource Id Arguments
--remove

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

Propiedad Valor
Parameter group: Generic Update Arguments
Valor predeterminado: []
--resource-group -g

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

Propiedad Valor
Parameter group: Resource Id Arguments
--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").

Propiedad Valor
Parameter group: Resource Id Arguments
--set

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

Propiedad Valor
Parameter group: Generic Update Arguments
Valor predeterminado: []
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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. (autogenerated)

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. (autogenerated)

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. (autogenerated)

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

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version

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

Propiedad Valor
Parameter group: Resource Id Arguments
--created

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

Propiedad Valor
Parameter group: Wait Condition Arguments
Valor predeterminado: False
--custom

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

Propiedad Valor
Parameter group: Wait Condition Arguments
--deleted

Espere hasta que se elimine.

Propiedad Valor
Parameter group: Wait Condition Arguments
Valor predeterminado: False
--exists

Espere hasta que exista el recurso.

Propiedad Valor
Parameter group: Wait Condition Arguments
Valor predeterminado: False
--ids

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

Propiedad Valor
Parameter group: Resource Id Arguments
--include-response-body

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

Propiedad Valor
Valor predeterminado: False
Valores aceptados: false, true
--interval

Intervalo de sondeo en segundos.

Propiedad Valor
Parameter group: Wait Condition Arguments
Valor predeterminado: 30
--name -n

Nombre del recurso. (Ex: myC).

Propiedad Valor
Parameter group: Resource Id Arguments
--namespace

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

Propiedad Valor
Parameter group: Resource Id Arguments
--parent

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

Propiedad Valor
Parameter group: Resource Id Arguments
--resource-group -g

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

Propiedad Valor
Parameter group: Resource Id Arguments
--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").

Propiedad Valor
Parameter group: Resource Id Arguments
--timeout

Espera máxima en segundos.

Propiedad Valor
Parameter group: Wait Condition Arguments
Valor predeterminado: 3600
--updated

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

Propiedad Valor
Parameter group: Wait Condition Arguments
Valor predeterminado: False
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False