az storage container lease

Administrar concesiones de contenedores de Blob Storage.

Comandos

Nombre	Description	Tipo	Estado
az storage container lease acquire	Solicita una nueva concesión.	Principal	GA
az storage container lease break	Interrumpa la concesión si el contenedor tiene una concesión activa.	Principal	GA
az storage container lease change	Cambie el identificador de concesión de una concesión activa.	Principal	GA
az storage container lease release	Libere la concesión.	Principal	GA
az storage container lease renew	Renueve la concesión.	Principal	GA

az storage container lease acquire

Solicita una nueva concesión.

Si el contenedor no tiene una concesión activa, Blob service crea una concesión en el contenedor y devuelve un nuevo identificador de concesión.

az storage container lease acquire --container-name
                                   [--account-key]
                                   [--account-name]
                                   [--auth-mode {key, login}]
                                   [--blob-endpoint]
                                   [--connection-string]
                                   [--if-match]
                                   [--if-modified-since]
                                   [--if-none-match]
                                   [--if-unmodified-since]
                                   [--lease-duration]
                                   [--proposed-lease-id]
                                   [--sas-token]
                                   [--tags-condition]
                                   [--timeout]

Ejemplos

Solicita una nueva concesión.

az storage container lease acquire --container-name mycontainer --account-name mystorageaccount --account-key 0000-0000

Parámetros requeridos

--container-name -c

El nombre del contenedor.

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

Nombre de la cuenta de almacenamiento. Variable de entorno relacionada: AZURE_STORAGE_ACCOUNT. Debe usarse junto con una clave de cuenta de almacenamiento o un token de SAS. Si ninguno está presente, el comando intentará consultar la clave de la cuenta de almacenamiento mediante la cuenta de Azure autenticada. Si se ejecuta un gran número de comandos de almacenamiento, se puede alcanzar la cuota de API.

--auth-mode

Modo en el que se va a ejecutar el comando. El modo "login" usará directamente las credenciales de inicio de sesión para la autenticación. El modo "clave" heredado intentará consultar una clave de cuenta si no se proporcionan parámetros de autenticación para la cuenta. Variable de entorno: AZURE_STORAGE_AUTH_MODE.

valores aceptados: key, login

--blob-endpoint

Punto de conexión de servicio de datos de almacenamiento. Debe usarse junto con una clave de cuenta de almacenamiento o un token de SAS. Puede encontrar cada punto de conexión principal de servicio con az storage account show. Variable de entorno: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--if-match

Un valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.

--if-modified-since

Comience solo si se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--if-none-match

Un valor ETag o el carácter comodín (). Especifique este encabezado para realizar la operación solo si la ETag del recurso no coincide con el valor especificado. Especifique el carácter comodín () para realizar la operación solo si el recurso no existe y produce un error en la operación si existe.

--if-unmodified-since

Comience solo si no se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--lease-duration

Especifique la duración de la concesión, en segundos o una negativa (-1) para una concesión que nunca expira. Una concesión no infinita puede estar entre 15 y 60 segundos. No se puede cambiar la duración de una concesión mediante la renovación o el cambio. El valor predeterminado es -1 (concesión infinita).

valor predeterminado: -1

--proposed-lease-id

Identificador de concesión propuesto, en formato de cadena GUID. Blob service devuelve 400 (solicitud no válida) si el identificador de concesión propuesto no tiene el formato correcto.

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--tags-condition

Especifique una cláusula SQL where en etiquetas de blob para que funcione solo en blobs con un valor coincidente.

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

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 storage container lease break

Interrumpa la concesión si el contenedor tiene una concesión activa.

Una vez que se interrumpe una concesión, no se puede renovar. Cualquier solicitud autorizada puede interrumpir la concesión; la solicitud no es necesaria para especificar un identificador de concesión coincidente. Cuando se interrumpe una concesión, el período de interrupción de concesión puede transcurrir, durante el cual no se puede realizar ninguna operación de concesión, excepto interrupción y liberación en el contenedor. Cuando una concesión se interrumpe correctamente, la respuesta indica el intervalo en segundos hasta que se pueda adquirir una nueva concesión.

az storage container lease break --container-name
                                 [--account-key]
                                 [--account-name]
                                 [--auth-mode {key, login}]
                                 [--blob-endpoint]
                                 [--connection-string]
                                 [--if-match]
                                 [--if-modified-since]
                                 [--if-none-match]
                                 [--if-unmodified-since]
                                 [--lease-break-period]
                                 [--sas-token]
                                 [--tags-condition]
                                 [--timeout]

Ejemplos

Interrumpir la concesión.

az storage container lease break -c mycontainer --lease-break-period 10 --account-name mystorageaccount --account-key 0000-0000

Parámetros requeridos

--container-name -c

El nombre del contenedor.

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

Nombre de la cuenta de almacenamiento. Variable de entorno relacionada: AZURE_STORAGE_ACCOUNT. Debe usarse junto con una clave de cuenta de almacenamiento o un token de SAS. Si ninguno está presente, el comando intentará consultar la clave de la cuenta de almacenamiento mediante la cuenta de Azure autenticada. Si se ejecuta un gran número de comandos de almacenamiento, se puede alcanzar la cuota de API.

--auth-mode

Modo en el que se va a ejecutar el comando. El modo "login" usará directamente las credenciales de inicio de sesión para la autenticación. El modo "clave" heredado intentará consultar una clave de cuenta si no se proporcionan parámetros de autenticación para la cuenta. Variable de entorno: AZURE_STORAGE_AUTH_MODE.

valores aceptados: key, login

--blob-endpoint

Punto de conexión de servicio de datos de almacenamiento. Debe usarse junto con una clave de cuenta de almacenamiento o un token de SAS. Puede encontrar cada punto de conexión principal de servicio con az storage account show. Variable de entorno: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--if-match

Un valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.

--if-modified-since

Comience solo si se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--if-none-match

Un valor ETag o el carácter comodín (). Especifique este encabezado para realizar la operación solo si la ETag del recurso no coincide con el valor especificado. Especifique el carácter comodín () para realizar la operación solo si el recurso no existe y produce un error en la operación si existe.

--if-unmodified-since

Comience solo si no se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--lease-break-period

Esta es la duración propuesta de segundos que la concesión debe continuar antes de que se rompa, entre 0 y 60 segundos. Este período de interrupción solo se usa si es menor que el tiempo restante en la concesión. Si es más largo, se usa el tiempo restante en la concesión. Una nueva concesión no estará disponible antes de que haya expirado el período de interrupción, pero la concesión puede mantenerse durante más tiempo que el período de interrupción. Si este encabezado no aparece con una operación de interrupción, se interrumpe una concesión de duración fija una vez transcurrido el período de concesión restante y se interrumpe inmediatamente una concesión infinita.

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--tags-condition

Especifique una cláusula SQL where en etiquetas de blob para que funcione solo en blobs con un valor coincidente.

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

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 storage container lease change

Cambie el identificador de concesión de una concesión activa.

Un cambio debe incluir el identificador de concesión actual y un nuevo identificador de concesión.

az storage container lease change --container-name
                                  --lease-id
                                  --proposed-lease-id
                                  [--account-key]
                                  [--account-name]
                                  [--auth-mode {key, login}]
                                  [--blob-endpoint]
                                  [--connection-string]
                                  [--if-match]
                                  [--if-modified-since]
                                  [--if-none-match]
                                  [--if-unmodified-since]
                                  [--sas-token]
                                  [--tags-condition]
                                  [--timeout]

Ejemplos

Cambie la concesión.

az storage container lease change -c mycontainer --lease-id "32fe23cd-4779-4919-adb3-357e76c9b1bb" --proposed-lease-id "sef2ef2d-4779-4919-adb3-357e76c9b1bb" --account-name mystorageaccount --account-key 0000-0000

Parámetros requeridos

--container-name -c

El nombre del contenedor.

--lease-id

Identificador de concesión para la concesión activa.

--proposed-lease-id

Identificador de concesión propuesto, en formato de cadena GUID. Blob service devuelve 400 (solicitud no válida) si el identificador de concesión propuesto no tiene el formato correcto.

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

Nombre de la cuenta de almacenamiento. Variable de entorno relacionada: AZURE_STORAGE_ACCOUNT. Debe usarse junto con una clave de cuenta de almacenamiento o un token de SAS. Si ninguno está presente, el comando intentará consultar la clave de la cuenta de almacenamiento mediante la cuenta de Azure autenticada. Si se ejecuta un gran número de comandos de almacenamiento, se puede alcanzar la cuota de API.

--auth-mode

Modo en el que se va a ejecutar el comando. El modo "login" usará directamente las credenciales de inicio de sesión para la autenticación. El modo "clave" heredado intentará consultar una clave de cuenta si no se proporcionan parámetros de autenticación para la cuenta. Variable de entorno: AZURE_STORAGE_AUTH_MODE.

valores aceptados: key, login

--blob-endpoint

Punto de conexión de servicio de datos de almacenamiento. Debe usarse junto con una clave de cuenta de almacenamiento o un token de SAS. Puede encontrar cada punto de conexión principal de servicio con az storage account show. Variable de entorno: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--if-match

Un valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.

--if-modified-since

Comience solo si se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--if-none-match

Un valor ETag o el carácter comodín (). Especifique este encabezado para realizar la operación solo si la ETag del recurso no coincide con el valor especificado. Especifique el carácter comodín () para realizar la operación solo si el recurso no existe y produce un error en la operación si existe.

--if-unmodified-since

Comience solo si no se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--tags-condition

Especifique una cláusula SQL where en etiquetas de blob para que funcione solo en blobs con un valor coincidente.

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

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 storage container lease release

Libere la concesión.

La concesión se puede liberar si el lease_id especificado coincide con el asociado al contenedor. Liberar la concesión permite a otro cliente adquirir inmediatamente la concesión del contenedor en cuanto se complete la versión.

az storage container lease release --container-name
                                   --lease-id
                                   [--account-key]
                                   [--account-name]
                                   [--auth-mode {key, login}]
                                   [--blob-endpoint]
                                   [--connection-string]
                                   [--if-match]
                                   [--if-modified-since]
                                   [--if-none-match]
                                   [--if-unmodified-since]
                                   [--sas-token]
                                   [--tags-condition]
                                   [--timeout]

Ejemplos

Libere la concesión.

az storage container lease release -c mycontainer --lease-id "32fe23cd-4779-4919-adb3-357e76c9b1bb" --account-name mystorageaccount --account-key 0000-0000

Parámetros requeridos

--container-name -c

El nombre del contenedor.

--lease-id

Identificador de concesión para la concesión activa.

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

Nombre de la cuenta de almacenamiento. Variable de entorno relacionada: AZURE_STORAGE_ACCOUNT. Debe usarse junto con una clave de cuenta de almacenamiento o un token de SAS. Si ninguno está presente, el comando intentará consultar la clave de la cuenta de almacenamiento mediante la cuenta de Azure autenticada. Si se ejecuta un gran número de comandos de almacenamiento, se puede alcanzar la cuota de API.

--auth-mode

Modo en el que se va a ejecutar el comando. El modo "login" usará directamente las credenciales de inicio de sesión para la autenticación. El modo "clave" heredado intentará consultar una clave de cuenta si no se proporcionan parámetros de autenticación para la cuenta. Variable de entorno: AZURE_STORAGE_AUTH_MODE.

valores aceptados: key, login

--blob-endpoint

Punto de conexión de servicio de datos de almacenamiento. Debe usarse junto con una clave de cuenta de almacenamiento o un token de SAS. Puede encontrar cada punto de conexión principal de servicio con az storage account show. Variable de entorno: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--if-match

Un valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.

--if-modified-since

Comience solo si se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--if-none-match

Un valor ETag o el carácter comodín (). Especifique este encabezado para realizar la operación solo si la ETag del recurso no coincide con el valor especificado. Especifique el carácter comodín () para realizar la operación solo si el recurso no existe y produce un error en la operación si existe.

--if-unmodified-since

Comience solo si no se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--tags-condition

Especifique una cláusula SQL where en etiquetas de blob para que funcione solo en blobs con un valor coincidente.

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

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 storage container lease renew

Renueve la concesión.

La concesión se puede renovar si el identificador de concesión especificado coincide con el asociado al contenedor. Tenga en cuenta que la concesión se puede renovar incluso si ha expirado siempre que el contenedor no se haya concedido de nuevo desde la expiración de esa concesión. Al renovar una concesión, el reloj de duración de la concesión se restablece.

az storage container lease renew --container-name
                                 --lease-id
                                 [--account-key]
                                 [--account-name]
                                 [--auth-mode {key, login}]
                                 [--blob-endpoint]
                                 [--connection-string]
                                 [--if-match]
                                 [--if-modified-since]
                                 [--if-none-match]
                                 [--if-unmodified-since]
                                 [--sas-token]
                                 [--tags-condition]
                                 [--timeout]

Ejemplos

Renueve la concesión.

az storage container lease renew -c mycontainer --lease-id "32fe23cd-4779-4919-adb3-357e76c9b1bb" --account-name mystorageaccount --account-key 0000-0000

Parámetros requeridos

--container-name -c

El nombre del contenedor.

--lease-id

Identificador de concesión para la concesión activa.

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

Nombre de la cuenta de almacenamiento. Variable de entorno relacionada: AZURE_STORAGE_ACCOUNT. Debe usarse junto con una clave de cuenta de almacenamiento o un token de SAS. Si ninguno está presente, el comando intentará consultar la clave de la cuenta de almacenamiento mediante la cuenta de Azure autenticada. Si se ejecuta un gran número de comandos de almacenamiento, se puede alcanzar la cuota de API.

--auth-mode

Modo en el que se va a ejecutar el comando. El modo "login" usará directamente las credenciales de inicio de sesión para la autenticación. El modo "clave" heredado intentará consultar una clave de cuenta si no se proporcionan parámetros de autenticación para la cuenta. Variable de entorno: AZURE_STORAGE_AUTH_MODE.

valores aceptados: key, login

--blob-endpoint

Punto de conexión de servicio de datos de almacenamiento. Debe usarse junto con una clave de cuenta de almacenamiento o un token de SAS. Puede encontrar cada punto de conexión principal de servicio con az storage account show. Variable de entorno: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--if-match

Un valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.

--if-modified-since

Comience solo si se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--if-none-match

Un valor ETag o el carácter comodín (). Especifique este encabezado para realizar la operación solo si la ETag del recurso no coincide con el valor especificado. Especifique el carácter comodín () para realizar la operación solo si el recurso no existe y produce un error en la operación si existe.

--if-unmodified-since

Comience solo si no se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--tags-condition

Especifique una cláusula SQL where en etiquetas de blob para que funcione solo en blobs con un valor coincidente.

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

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.