Compartir a través de


az storage container

Nota:

Este grupo de comandos tiene comandos definidos en la CLI de Azure y al menos una extensión. Instale cada extensión para beneficiarse de sus funcionalidades extendidas. Obtenga más información sobre las extensiones.

Administrar contenedores de Blob Storage.

Especifique uno de los siguientes parámetros de autenticación para los comandos: --auth-mode, --account-key, --connection-string, --sas-token. También puede usar las variables de entorno correspondientes para almacenar las credenciales de autenticación, por ejemplo, AZURE_STORAGE_KEY, AZURE_STORAGE_CONNECTION_STRING y AZURE_STORAGE_SAS_TOKEN.

Comandos

Nombre Description Tipo Estado
az storage container create

Cree un contenedor en una cuenta de almacenamiento.

Core GA
az storage container delete

Marque el contenedor especificado para su eliminación.

Core GA
az storage container exists

Compruebe la existencia de un contenedor de almacenamiento.

Core GA
az storage container generate-sas

Genere un token de SAS para un contenedor de almacenamiento.

Core GA
az storage container generate-sas (storage-blob-preview extensión)

Genere un token de SAS para un contenedor de almacenamiento.

Extensión GA
az storage container immutability-policy

Administrar directivas de inmutabilidad del contenedor.

Core GA
az storage container immutability-policy create

Cree o actualice una directiva de inmutabilidad desbloqueada.

Core GA
az storage container immutability-policy delete

Anula una directiva de inmutabilidad desbloqueada.

Core GA
az storage container immutability-policy extend

Amplíe la inmutabilidadPeriodSinceCreationInDays de un valor immutabilityPolicy bloqueado.

Core GA
az storage container immutability-policy lock

Establece immutabilityPolicy en Estado bloqueado.

Core GA
az storage container immutability-policy show

Obtiene la directiva de inmutabilidad existente junto con la ETag correspondiente en los encabezados de respuesta y el cuerpo.

Core GA
az storage container lease

Administrar concesiones de contenedores de Blob Storage.

Core GA
az storage container lease acquire

Solicita una nueva concesión.

Core GA
az storage container lease break

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

Core GA
az storage container lease change

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

Core GA
az storage container lease release

Libere la concesión.

Core GA
az storage container lease renew

Renueve la concesión.

Core GA
az storage container legal-hold

Administrar las retenciones legales de los contenedores.

Core GA
az storage container legal-hold clear

Borre las etiquetas de suspensión legal.

Core GA
az storage container legal-hold set

Establezca etiquetas de suspensión legal.

Core GA
az storage container legal-hold show

Obtenga las propiedades de suspensión legal de un contenedor.

Core GA
az storage container list

Enumeración de contenedores en una cuenta de almacenamiento.

Core GA
az storage container metadata

Administrar los metadatos de los contenedores.

Core GA
az storage container metadata show

Devuelve todos los metadatos definidos por el usuario para el contenedor especificado.

Core GA
az storage container metadata update

Establezca uno o varios pares de nombre-valor definidos por el usuario para el contenedor especificado.

Core GA
az storage container policy

Administrar directivas de acceso almacenadas de contenedor.

Core GA
az storage container policy create

Cree una directiva de acceso almacenada en el objeto contenedor.

Core GA
az storage container policy delete

Elimine una directiva de acceso almacenada en un objeto contenedor.

Core GA
az storage container policy list

Enumerar las directivas de acceso almacenadas en un objeto contenedor.

Core GA
az storage container policy show

Mostrar una directiva de acceso almacenada en un objeto contenedor.

Core GA
az storage container policy update

Establezca una directiva de acceso almacenada en un objeto contenedor.

Core GA
az storage container restore

Restaure el contenedor eliminado temporalmente.

Core GA
az storage container set-permission

Establezca los permisos para el contenedor especificado.

Core GA
az storage container show

Devuelve todos los metadatos definidos por el usuario y las propiedades del sistema para el contenedor especificado.

Core GA
az storage container show-permission

Obtenga los permisos para el contenedor especificado.

Core GA

az storage container create

Cree un contenedor en una cuenta de almacenamiento.

De forma predeterminada, los datos del contenedor son privados ("off") para el propietario de la cuenta. Use "blob" para permitir el acceso de lectura público a los blobs. Use "container" para permitir el acceso público de lectura y lista a todo el contenedor. Puede configurar --public-access mediante az storage container set-permission -n CONTAINER_NAME --public-access blob/container/off.

az storage container create --name
                            [--account-key]
                            [--account-name]
                            [--auth-mode {key, login}]
                            [--blob-endpoint]
                            [--connection-string]
                            [--default-encryption-scope]
                            [--fail-on-exist]
                            [--metadata]
                            [--prevent-encryption-scope-override {false, true}]
                            [--public-access {blob, container, off}]
                            [--resource-group]
                            [--sas-token]
                            [--timeout]

Ejemplos

Cree un contenedor de almacenamiento en una cuenta de almacenamiento.

az storage container create -n mystoragecontainer

Cree un contenedor de almacenamiento en una cuenta de almacenamiento y devuelva un error si el contenedor ya existe.

az storage container create -n mystoragecontainer --fail-on-exist

Cree un contenedor de almacenamiento en una cuenta de almacenamiento y permita el acceso de lectura público para blobs.

az storage container create -n mystoragecontainer --public-access blob

Parámetros requeridos

--name -n

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.

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

--default-encryption-scope -d
Vista previa

El contenedor debe usar el ámbito de cifrado especificado para todas las escrituras.

--fail-on-exist

Inicie una excepción si el contenedor ya existe.

valor predeterminado: False
--metadata

Metadatos en pares clave=valor separados por espacios. Esto sobrescribe los metadatos existentes.

--prevent-encryption-scope-override -p
Vista previa

Bloquear la invalidación del ámbito de cifrado del valor predeterminado del contenedor.

valores aceptados: false, true
--public-access

Especifica si se puede acceder a los datos del contenedor públicamente.

valores aceptados: blob, container, off
--resource-group -g
Obsoleto

El argumento "resource_group_name" está en desuso y se quitará en una versión futura.

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

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

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

Marque el contenedor especificado para su eliminación.

El contenedor y los blobs contenidos en él se eliminan posteriormente durante la recolección de elementos no utilizados.

az storage container delete --name
                            [--account-key]
                            [--account-name]
                            [--auth-mode {key, login}]
                            [--blob-endpoint]
                            [--bypass-immutability-policy]
                            [--connection-string]
                            [--fail-not-exist]
                            [--if-modified-since]
                            [--if-unmodified-since]
                            [--lease-id]
                            [--sas-token]
                            [--timeout]

Ejemplos

Marca el contenedor especificado para su eliminación. (generado automáticamente)

az storage container delete --account-key 00000000 --account-name MyAccount --name mycontainer

Parámetros requeridos

--name -n

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.

--bypass-immutability-policy

Omite el próximo comportamiento del servicio que impedirá que se elimine un contenedor si tiene una directiva de inmutabilidad. Al especificar esto se omitirán los argumentos que se usan para identificar el contenedor ("--name", "--account-name").

valor predeterminado: False
--connection-string

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

--fail-not-exist

Inicie una excepción si el contenedor no existe.

valor predeterminado: False
--if-modified-since

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

--if-unmodified-since

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

--lease-id

Si se especifica, delete_container solo se realiza correctamente si la concesión del contenedor está activa y coincide con este identificador. Obligatorio si el contenedor tiene una concesión activa.

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

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

Compruebe la existencia de un contenedor de almacenamiento.

az storage container exists --name
                            [--account-key]
                            [--account-name]
                            [--auth-mode {key, login}]
                            [--blob-endpoint]
                            [--connection-string]
                            [--sas-token]
                            [--timeout]

Ejemplos

Compruebe la existencia de un contenedor de almacenamiento. (generado automáticamente)

az storage container exists --account-name mystorageccount --account-key 00000000 --name mycontainer

Parámetros requeridos

--name -n

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.

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

--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 generate-sas

Genere un token de SAS para un contenedor de almacenamiento.

az storage container generate-sas --name
                                  [--account-key]
                                  [--account-name]
                                  [--as-user]
                                  [--auth-mode {key, login}]
                                  [--blob-endpoint]
                                  [--cache-control]
                                  [--connection-string]
                                  [--content-disposition]
                                  [--content-encoding]
                                  [--content-language]
                                  [--content-type]
                                  [--encryption-scope]
                                  [--expiry]
                                  [--https-only]
                                  [--ip]
                                  [--permissions]
                                  [--policy-name]
                                  [--start]

Ejemplos

Genere un token sas para el contenedor de blobs y úselo para cargar un blob.

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
sas=`az storage container generate-sas -n mycontainer --https-only --permissions dlrw --expiry $end -o tsv`
az storage blob upload -n MyBlob -c mycontainer -f file.txt --sas-token $sas

Generación de una firma de acceso compartido para el contenedor (generada automáticamente)

az storage container generate-sas --account-key 00000000 --account-name mystorageaccount --expiry 2020-01-01 --name mycontainer --permissions dlrw

Genere un token de SAS para un contenedor de almacenamiento. (generado automáticamente)

az storage container generate-sas --account-name mystorageaccount --as-user --auth-mode login --expiry 2020-01-01 --name container1 --permissions dlrw

Parámetros requeridos

--name -n

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.

--as-user

Indica que este comando devuelve la SAS firmada con la clave de delegación de usuarios. El parámetro de expiración y el inicio de sesión "--auth-mode" son necesarios si se especifica este argumento.

valor predeterminado: False
--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.

--cache-control

Valor de encabezado de respuesta para Cache-Control cuando se accede al recurso mediante esta firma de acceso compartido.

--connection-string

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

--content-disposition

Valor de encabezado de respuesta para Content-Disposition cuando se accede al recurso mediante esta firma de acceso compartido.

--content-encoding

Valor de encabezado de respuesta para Content-Encoding cuando se accede al recurso mediante esta firma de acceso compartido.

--content-language

Valor de encabezado de respuesta para Content-Language cuando se accede al recurso mediante esta firma de acceso compartido.

--content-type

Valor de encabezado de respuesta para Content-Type cuando se accede a un recurso mediante esta firma de acceso compartido.

--encryption-scope

Ámbito de cifrado predefinido que se usa para cifrar los datos en el servicio.

--expiry

Especifica la fecha y hora UTC (Y-m-d'T'H:M'Z') en la que la SAS deja de ser válida. No use si se hace referencia a una directiva de acceso almacenada con --policy-name que especifica este valor.

--https-only

Solo permite solicitudes realizadas con el protocolo HTTPS. Si se omite, se permiten las solicitudes del protocolo HTTP y HTTPS.

--ip

Especifica la dirección IP o el intervalo de direcciones IP desde las que se van a aceptar solicitudes. Solo admite direcciones de estilo IPv4.

--permissions

Permisos que concede la SAS. Valores permitidos: (a)dd (c)reate (d)elete (e)xecute (f)ilter_by_tags (i)set_immutability_policy (l)ist (m)ove (r)ead (t)ag (w)rite (x)delete_previous_version (y)permanent_delete. No use si se hace referencia a una directiva de acceso almacenada con --id que especifica este valor. Se puede combinar.

--policy-name

Nombre de una directiva de acceso almacenada dentro de la ACL del contenedor.

--start

Especifica la fecha y hora UTC (Y-m-d'T'H:M'Z') en la que la SAS se vuelve válida. No use si se hace referencia a una directiva de acceso almacenada con --policy-name que especifica este valor. El valor predeterminado es la hora de la solicitud.

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 generate-sas (storage-blob-preview extensión)

Genere un token de SAS para un contenedor de almacenamiento.

az storage container generate-sas --name
                                  [--account-key]
                                  [--account-name]
                                  [--as-user]
                                  [--auth-mode {key, login}]
                                  [--blob-endpoint]
                                  [--cache-control]
                                  [--connection-string]
                                  [--content-disposition]
                                  [--content-encoding]
                                  [--content-language]
                                  [--content-type]
                                  [--expiry]
                                  [--full-uri]
                                  [--https-only]
                                  [--ip]
                                  [--permissions]
                                  [--policy-name]
                                  [--start]

Ejemplos

Genere un token sas para el contenedor de blobs y úselo para cargar un blob.

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
sas=`az storage container generate-sas -n mycontainer --https-only --permissions dlrw --expiry $end -o tsv`
az storage blob upload -n MyBlob -c mycontainer -f file.txt --sas-token $sas

Generación de una firma de acceso compartido para el contenedor (generada automáticamente)

az storage container generate-sas --account-key 00000000 --account-name mystorageaccount --expiry 2020-01-01 --name mycontainer --permissions dlrw

Genere un token de SAS para un contenedor de almacenamiento. (generado automáticamente)

az storage container generate-sas --account-name mystorageaccount --as-user --auth-mode login --expiry 2020-01-01 --name container1 --permissions dlrw

Parámetros requeridos

--name -n

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

--as-user

Indica que este comando devuelve la SAS firmada con la clave de delegación de usuarios. El parámetro de expiración y el inicio de sesión "--auth-mode" son necesarios si se especifica este argumento.

valor predeterminado: False
--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.

--cache-control

Valor de encabezado de respuesta para Cache-Control cuando se accede al recurso mediante esta firma de acceso compartido.

--connection-string

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

--content-disposition

Valor de encabezado de respuesta para Content-Disposition cuando se accede al recurso mediante esta firma de acceso compartido.

--content-encoding

Valor de encabezado de respuesta para Content-Encoding cuando se accede al recurso mediante esta firma de acceso compartido.

--content-language

Valor de encabezado de respuesta para Content-Language cuando se accede al recurso mediante esta firma de acceso compartido.

--content-type

Valor de encabezado de respuesta para Content-Type cuando se accede al recurso mediante esta firma de acceso compartido.

--expiry

Especifica la fecha y hora UTC (Y-m-d'T'H:M'Z') en la que la SAS deja de ser válida. No use si se hace referencia a una directiva de acceso almacenada con --id que especifica este valor.

--full-uri
Vista previa

Indique que este comando devuelve el URI de blob completo y el token de firma de acceso compartido.

valor predeterminado: False
--https-only

Solo permite solicitudes realizadas con el protocolo HTTPS. Si se omite, se permiten las solicitudes del protocolo HTTP y HTTPS.

--ip

Especifica la dirección IP o el intervalo de direcciones IP desde las que se van a aceptar solicitudes. Solo admite direcciones de estilo IPv4.

--permissions

Permisos que concede la SAS. Valores permitidos: (a)dd (c)reate (d)elete (x)delete_previous_version (e)xecute (f)ilter_by_tags (l)ist (m)ove (p)ermanent_delete (r)ead (s)et_immutability_policy (t)ag (w)rite. No use si se hace referencia a una directiva de acceso almacenada con --policy-name que especifica este valor. Se puede combinar.

--policy-name

Nombre de una directiva de acceso almacenada dentro de la ACL del contenedor.

--start

Especifica la fecha y hora UTC (Y-m-d'T'H:M'Z') en la que la SAS se vuelve válida. No use si se hace referencia a una directiva de acceso almacenada con --id que especifica este valor. El valor predeterminado es la hora de la solicitud.

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 list

Enumeración de contenedores en una cuenta de almacenamiento.

az storage container list [--account-key]
                          [--account-name]
                          [--auth-mode {key, login}]
                          [--blob-endpoint]
                          [--connection-string]
                          [--include-deleted {false, true}]
                          [--include-metadata {false, true}]
                          [--marker]
                          [--num-results]
                          [--prefix]
                          [--sas-token]
                          [--show-next-marker]
                          [--timeout]

Ejemplos

Enumeración de contenedores en una cuenta de almacenamiento.

az storage container list

Enumeración de contenedores eliminados temporalmente en una cuenta de almacenamiento.

az storage container list --include-deleted

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.

--include-deleted

Especifique que los contenedores eliminados se devolverán en la respuesta. Esto es para la cuenta habilitada para la restauración de contenedores. El valor predeterminado es False.

valores aceptados: false, true
valor predeterminado: False
--include-metadata

Especifique los metadatos del contenedor que se van a devolver en la respuesta.

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

Valor de cadena que identifica la parte de la lista de contenedores que se va a devolver con la siguiente operación de lista. La operación devuelve el valor NextMarker dentro del cuerpo de la respuesta si la operación de lista no devolvió todos los contenedores restantes para que se muestren con la página actual. Si se especifica, este generador comenzará a devolver resultados desde el punto en el que se detuvo el generador anterior.

--num-results

Especifique el número máximo que se va a devolver. Si la solicitud no especifica num_results o especifica un valor mayor que 5000, el servidor devolverá hasta 5000 elementos. Tenga en cuenta que si la operación de lista cruza un límite de partición, el servicio devolverá un token de continuación para recuperar el resto de los resultados. Proporcione "*" para devolver todo.

valor predeterminado: 5000
--prefix

Filtre los resultados para devolver solo blobs cuyo nombre comienza con el prefijo especificado.

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

--show-next-marker
Vista previa

Muestra nextMarker en el resultado cuando se especifica.

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

Restaure el contenedor eliminado temporalmente.

La operación solo se realizará correctamente si se usa en el número de días especificado establecido en la directiva de retención de eliminación.

az storage container restore --deleted-version
                             --name
                             [--account-key]
                             [--account-name]
                             [--auth-mode {key, login}]
                             [--blob-endpoint]
                             [--connection-string]
                             [--sas-token]
                             [--timeout]

Ejemplos

Enumerar y restaurar el contenedor eliminado temporalmente.

az storage container list --include-deleted
az storage container restore -n deletedcontainer --deleted-version deletedversion

Parámetros requeridos

--deleted-version

Especifique la versión del contenedor eliminado que se va a restaurar.

--name -n

Especifique el nombre del contenedor eliminado que se va a restaurar.

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.

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

--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 set-permission

Establezca los permisos para el contenedor especificado.

az storage container set-permission --name
                                    [--account-key]
                                    [--account-name]
                                    [--auth-mode {key}]
                                    [--blob-endpoint]
                                    [--connection-string]
                                    [--if-modified-since]
                                    [--if-unmodified-since]
                                    [--lease-id]
                                    [--public-access {blob, container, off}]
                                    [--timeout]

Parámetros requeridos

--name -n

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 "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
--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-modified-since

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

--if-unmodified-since

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

--lease-id

Si se especifica, solo se realiza correctamente si la concesión del contenedor está activa y coincide con este identificador.

--public-access

Especifica si se puede acceder a los datos del contenedor públicamente.

valores aceptados: blob, container, off
--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 show

Devuelve todos los metadatos definidos por el usuario y las propiedades del sistema para el contenedor especificado.

az storage container show --name
                          [--account-key]
                          [--account-name]
                          [--auth-mode {key, login}]
                          [--blob-endpoint]
                          [--connection-string]
                          [--lease-id]
                          [--sas-token]
                          [--timeout]

Parámetros requeridos

--name -n

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.

--lease-id

Si se especifica, solo se realiza correctamente si la concesión del contenedor está activa y coincide con este identificador.

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

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

Obtenga los permisos para el contenedor especificado.

az storage container show-permission --name
                                     [--account-key]
                                     [--account-name]
                                     [--auth-mode {key}]
                                     [--blob-endpoint]
                                     [--connection-string]
                                     [--lease-id]
                                     [--timeout]

Parámetros requeridos

--name -n

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

--lease-id

Si se especifica, solo se realiza correctamente si la concesión del contenedor está activa y coincide con este identificador.

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