az storage blob lease

  • Referencia

Administrar concesiones de blobs de almacenamiento.

Comandos

Nombre Description Tipo Estado
az storage blob lease acquire

Solicita una nueva concesión.

 Principal GA
az storage blob lease break

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

 Principal GA
az storage blob lease change

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

 Principal GA
az storage blob lease release

Libere la concesión.

 Principal GA
az storage blob lease renew

Renueve la concesión.

 Principal GA

az storage blob lease acquire

Editar

Solicita una nueva concesión.

az storage blob lease acquire --blob-name
                              --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 blob lease acquire -b myblob -c mycontainer --account-name mystorageaccount --account-key 0000-0000

Parámetros requeridos

--blob-name -b

Nombre del blob.

--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 blob lease break

Editar

Interrumpa la concesión, si el contenedor o blob 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 o blob. 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 blob lease break --blob-name
                            --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]

Parámetros requeridos

--blob-name -b

Nombre del blob.

--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 blob lease change

Editar

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

az storage blob lease change --blob-name
                             --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]

Parámetros requeridos

--blob-name -b

Nombre del blob.

--container-name -c

El nombre del contenedor.

--lease-id

Obligatorio si el blob tiene una 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 blob lease release

Editar

Libere la concesión.

La concesión se puede liberar si el identificador de concesión de cliente especificado coincide con el asociado al contenedor o blob. Liberar la concesión permite a otro cliente adquirir inmediatamente la concesión para el contenedor o blob tan pronto como se complete la versión. :keyword ~datetime.datetime if_modified_since: un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las horas de fecha y hora no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si el recurso se ha modificado desde la hora especificada. :keyword ~datetime.datetime if_unmodified_since: un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las horas de fecha y hora no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si el recurso no se ha modificado desde la fecha y hora especificadas. :keyword str etag: un valor ETag o el carácter comodín (*). Se usa para comprobar si el recurso ha cambiado y actuar según la condición especificada por el match_condition parámetro . :keyword ~azure.core.MatchConditions match_condition: condición de coincidencia que se va a usar en el etag. :keyword str if_tags_match_condition: especifique una cláusula SQL donde en las etiquetas de blob funcione solo en blob con un valor coincidente. P. ej. "\"tagname\"='my tag'" .. versionadded:: 12.4.0 :keyword int timeout: establece el tiempo de espera del lado servidor para la operación en segundos. Para más información, consulte https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Este valor no se realiza un seguimiento ni se valida en el cliente. Para configurar tiempos de espera de red del lado cliente, consulte here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob #other-client--per-operation-configuration>_. :return: None.

az storage blob lease release --blob-name
                              --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]

Parámetros requeridos

--blob-name -b

Nombre del blob.

--container-name -c

El nombre del contenedor.

--lease-id

Obligatorio si el blob tiene una 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 blob lease renew

Editar

Renueve la concesión.

az storage blob lease renew --blob-name
                            --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 blob lease renew -b myblob -c mycontainer --lease-id "32fe23cd-4779-4919-adb3-357e76c9b1bb" --account-name mystorageaccount --account-key 0000-0000

Parámetros requeridos

--blob-name -b

Nombre del blob.

--container-name -c

El nombre del contenedor.

--lease-id

Obligatorio si el blob tiene una 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.