az storage container
Note
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. Learn more about extensions.
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. |
Extension | 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 |
Solicite 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
Cree un contenedor de almacenamiento en una cuenta de almacenamiento habilitada para PartitionedDNS.
az storage container create --account-name mystorageaccount --name mystoragecontainer --account-key "enter-your-storage_account-key" --blob-endpoint "https://mystorageaccount.z3.blob.storage.azure.net/"
Parámetros requeridos
Nombre del contenedor.
Parámetros opcionales
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Clave de 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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
Nombre de la cuenta de almacenamiento. Variable de entorno relacionada: AZURE_STORAGE_ACCOUNT.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
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.
Propiedad | Valor |
---|---|
Valores aceptados: | key, login |
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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
El contenedor debe usar el ámbito de cifrado especificado para todas las escrituras.
Propiedad | Valor |
---|---|
Parameter group: | Encryption Policy Arguments |
Inicie una excepción si el contenedor ya existe.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
Metadatos en forma de pares clave=valor separados por espacios. Esto sobrescribe los metadatos existentes.
Bloquear la invalidación del ámbito de cifrado del valor predeterminado del contenedor.
Propiedad | Valor |
---|---|
Parameter group: | Encryption Policy Arguments |
Valores aceptados: | false, true |
Especifica si se puede acceder a los datos del contenedor públicamente.
Propiedad | Valor |
---|---|
Valores aceptados: | blob, container, off |
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>
.
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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
Output format.
Propiedad | Valor |
---|---|
Valor predeterminado: | json |
Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
az storage container delete
Marque el contenedor especificado para su eliminación.
El contenedor y cualquier blob que contenga se eliminan posteriormente durante la recolección de basura.
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. (autogenerated)
az storage container delete --account-key 00000000 --account-name MyAccount --name mycontainer
Parámetros requeridos
Nombre del contenedor.
Parámetros opcionales
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Clave de 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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
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.
Propiedad | Valor |
---|---|
Valores aceptados: | key, login |
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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
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").
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
Inicie una excepción si el contenedor no existe.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
Comience solo si se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').
Propiedad | Valor |
---|---|
Parameter group: | Precondition Arguments |
Comience solo si no se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').
Propiedad | Valor |
---|---|
Parameter group: | Precondition Arguments |
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.
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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
Output format.
Propiedad | Valor |
---|---|
Valor predeterminado: | json |
Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
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. (autogenerated)
az storage container exists --account-name mystorageccount --account-key 00000000 --name mycontainer
Parámetros requeridos
Nombre del contenedor.
Parámetros opcionales
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Clave de 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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
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.
Propiedad | Valor |
---|---|
Valores aceptados: | key, login |
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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
Output format.
Propiedad | Valor |
---|---|
Valor predeterminado: | json |
Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
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. (autogenerated)
az storage container generate-sas --account-name mystorageaccount --as-user --auth-mode login --expiry 2020-01-01 --name container1 --permissions dlrw
Parámetros requeridos
Nombre del contenedor.
Parámetros opcionales
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Clave de 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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
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.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
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.
Propiedad | Valor |
---|---|
Valores aceptados: | key, login |
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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
Valor de encabezado de respuesta para Cache-Control cuando se accede al recurso mediante esta firma de acceso compartido.
Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
Valor de encabezado de respuesta para Content-Disposition cuando se accede al recurso mediante esta firma de acceso compartido.
Valor de encabezado de respuesta para Content-Encoding cuando se accede al recurso mediante esta firma de acceso compartido.
Valor de encabezado de respuesta para Content-Language cuando se accede al recurso mediante esta firma de acceso compartido.
Valor de encabezado de respuesta para Content-Type cuando se accede a un recurso mediante esta firma de acceso compartido.
Ámbito de cifrado predefinido que se usa para cifrar los datos en el servicio.
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.
Solo permite solicitudes realizadas con el protocolo HTTPS. Si se omite, se permiten las solicitudes del protocolo HTTP y HTTPS.
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.
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.
Nombre de una directiva de acceso almacenada dentro de la ACL del contenedor.
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
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
Output format.
Propiedad | Valor |
---|---|
Valor predeterminado: | json |
Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
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. (autogenerated)
az storage container generate-sas --account-name mystorageaccount --as-user --auth-mode login --expiry 2020-01-01 --name container1 --permissions dlrw
Parámetros requeridos
Nombre del contenedor.
Parámetros opcionales
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Clave de cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_KEY.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
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.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
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.
Propiedad | Valor |
---|---|
Valores aceptados: | key, login |
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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
Valor del encabezado de respuesta para Cache-Control cuando se accede al recurso mediante esta firma de acceso compartido.
Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
Valor de encabezado de respuesta para Content-Disposition cuando se accede al recurso mediante esta firma de acceso compartido.
Valor de encabezado de respuesta para Content-Encoding cuando se accede al recurso mediante esta firma de acceso compartido.
Valor de encabezado de respuesta para Content-Language cuando se accede al recurso mediante esta firma de acceso compartido.
Valor de encabezado de respuesta para Content-Type cuando se accede al recurso mediante esta firma de acceso compartido.
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.
Indique que este comando devuelve el URI de blob completo y el token de firma de acceso compartido.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
Solo permite solicitudes realizadas con el protocolo HTTPS. Si se omite, se permiten las solicitudes del protocolo HTTP y HTTPS.
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.
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.
Nombre de una directiva de acceso almacenada dentro de la ACL del contenedor.
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
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
Output format.
Propiedad | Valor |
---|---|
Valor predeterminado: | json |
Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
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
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Clave de 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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
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.
Propiedad | Valor |
---|---|
Valores aceptados: | key, login |
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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
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
.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
Valores aceptados: | false, true |
Especifique los metadatos del contenedor que se van a devolver en la respuesta.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
Valores aceptados: | false, true |
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.
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. Introduzca "*" para mostrar todo.
Propiedad | Valor |
---|---|
Valor predeterminado: | 5000 |
Filtre los resultados para devolver solo blobs cuyo nombre comienza con el prefijo especificado.
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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
Muestra nextMarker en el resultado cuando se especifica.
Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
Output format.
Propiedad | Valor |
---|---|
Valor predeterminado: | json |
Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
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
Especifique la versión del contenedor eliminado que se va a restaurar.
Especifique el nombre del contenedor eliminado que se va a restaurar.
Parámetros opcionales
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Clave de 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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
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.
Propiedad | Valor |
---|---|
Valores aceptados: | key, login |
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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
Output format.
Propiedad | Valor |
---|---|
Valor predeterminado: | json |
Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
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
Nombre del contenedor.
Parámetros opcionales
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Clave de 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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
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.
Propiedad | Valor |
---|---|
Valores aceptados: | key |
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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
Comience solo si se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').
Propiedad | Valor |
---|---|
Parameter group: | Precondition Arguments |
Comience solo si no se modifica desde la fecha y hora UTC proporcionada (Y-m-d'T'H:M'Z').
Propiedad | Valor |
---|---|
Parameter group: | Precondition Arguments |
Si se especifica, solo se realiza correctamente si la concesión del contenedor está activa y coincide con este identificador.
Especifica si se puede acceder a los datos del contenedor públicamente.
Propiedad | Valor |
---|---|
Valores aceptados: | blob, container, off |
Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
Output format.
Propiedad | Valor |
---|---|
Valor predeterminado: | json |
Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
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
Nombre del contenedor.
Parámetros opcionales
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Clave de 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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
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.
Propiedad | Valor |
---|---|
Valores aceptados: | key, login |
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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
Si se especifica, solo se realiza correctamente si la concesión del contenedor está activa y coincide con este identificador.
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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
Output format.
Propiedad | Valor |
---|---|
Valor predeterminado: | json |
Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
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
Nombre del contenedor.
Parámetros opcionales
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Clave de 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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
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.
Propiedad | Valor |
---|---|
Valores aceptados: | key |
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.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.
Propiedad | Valor |
---|---|
Parameter group: | Storage Account Arguments |
Si se especifica, solo se realiza correctamente si la concesión del contenedor está activa y coincide con este identificador.
Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |
Output format.
Propiedad | Valor |
---|---|
Valor predeterminado: | json |
Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
Propiedad | Valor |
---|---|
Valor predeterminado: | False |