Compartilhar via

az storage container

Note

Esse grupo de comandos tem comandos definidos na CLI do Azure e em pelo menos uma extensão. Instale cada extensão para se beneficiar de seus recursos estendidos. Saiba mais sobre extensões.

Gerencia os contêineres do armazenamento de blobs.

Especifique um dos seguintes parâmetros de autenticação para seus comandos: --auth-mode, --account-key, --connection-string, --sas-token. Você também pode usar variáveis de ambiente correspondentes para armazenar suas credenciais de autenticação, por exemplo, AZURE_STORAGE_KEY, AZURE_STORAGE_CONNECTION_STRING e AZURE_STORAGE_SAS_TOKEN.

Comandos

Nome Description Tipo Status
az storage container create

Crie um contêiner em uma conta de armazenamento.

 Core GA
az storage container delete

Marque o contêiner especificado para exclusão.

 Core GA
az storage container exists

Verifique a existência de um recipiente de armazenamento.

 Core GA
az storage container generate-sas

Gere um token SAS para um contêiner de armazenamento.

 Core GA
az storage container generate-sas (storage-blob-preview extensão)

Gere um token SAS para um contêiner de armazenamento.

 Extension GA
az storage container immutability-policy

Gerencia as políticas de imutabilidade de contêiner.

 Core GA
az storage container immutability-policy create

Crie ou atualize uma política de imutabilidade desbloqueada.

 Core GA
az storage container immutability-policy delete

Anula uma política de imutabilidade desbloqueada.

 Core GA
az storage container immutability-policy extend

Estenda a imutabilidadePeriodSinceCreationInDays de uma imutabilidadePolicy bloqueada.

 Core GA
az storage container immutability-policy lock

Define o ImmutabilityPolicy como estado bloqueado.

 Core GA
az storage container immutability-policy show

Obtém a política de imutabilidade existente junto com a ETag correspondente em cabeçalhos de resposta e corpo.

 Core GA
az storage container lease

Gerencia as concessões de contêineres do armazenamento de blobs.

 Core GA
az storage container lease acquire

Solicite uma nova concessão.

 Core GA
az storage container lease break

Interrompa a concessão, se o contêiner tiver uma concessão ativa.

 Core GA
az storage container lease change

Altere a ID de concessão de uma concessão ativa.

 Core GA
az storage container lease release

Libere o arrendamento.

 Core GA
az storage container lease renew

Renove o contrato.

 Core GA
az storage container legal-hold

Gerencia as retenções legais de contêiner.

 Core GA
az storage container legal-hold clear

Limpe as etiquetas de retenção legal.

 Core GA
az storage container legal-hold set

Defina tags de retenção legal.

 Core GA
az storage container legal-hold show

Obtenha as propriedades de retenção legal de um contêiner.

 Core GA
az storage container list

Listar contêineres em uma conta de armazenamento.

 Core GA
az storage container metadata

Gerencia os metadados de contêiner.

 Core GA
az storage container metadata show

Retorna todos os metadados definidos pelo usuário para o contêiner especificado.

 Core GA
az storage container metadata update

Defina um ou mais pares de nome-valor definidos pelo usuário para o contêiner especificado.

 Core GA
az storage container policy

Gerencie políticas de acesso armazenadas em contêineres.

 Core GA
az storage container policy create

Crie uma política de acesso armazenada no objeto que o contém.

 Core GA
az storage container policy delete

Exclua uma política de acesso armazenada em um objeto que o contém.

 Core GA
az storage container policy list

Listar as políticas de acesso armazenadas em um objeto recipiente.

 Core GA
az storage container policy show

Mostrar uma política de acesso armazenada em um objeto que o contém.

 Core GA
az storage container policy update

Defina uma política de acesso armazenada em um objeto que o contém.

 Core GA
az storage container restore

Restaurar contêiner excluído de forma reversível.

 Core GA
az storage container set-permission

Defina as permissões para o contêiner especificado.

 Core GA
az storage container show

Retorna todos os metadados definidos pelo usuário e propriedades do sistema para o contêiner especificado.

 Core GA
az storage container show-permission

Obtenha as permissões para o contêiner especificado.

 Core GA

az storage container create

Editar

Crie um contêiner em uma conta de armazenamento.

Por padrão, os dados do contêiner são privados ("desativados") para o proprietário da conta. Use "blob" para permitir acesso público de leitura para blobs. Use "contêiner" para permitir o acesso público de leitura e lista a todo o contêiner. Você pode configurar o --public-access usando 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]

Exemplos

Crie um contêiner de armazenamento em uma conta de armazenamento.

az storage container create -n mystoragecontainer

Crie um contêiner de armazenamento em uma conta de armazenamento e retorne um erro se o contêiner já existir.

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

Crie um contêiner de armazenamento em uma conta de armazenamento e permita o acesso público de leitura para blobs.

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

Crie um contêiner de armazenamento em uma conta de armazenamento 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 Exigidos

--name -n

O nome do contêiner.

Parâmetros Opcionais

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

--account-key

Chave da conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade de serviço. Variável de ambiente: AZURE_STORAGE_KEY.

Propriedade Valor
Parameter group: Storage Account Arguments
--account-name

Nome da conta de armazenamento. Variável de ambiente relacionada: AZURE_STORAGE_ACCOUNT.

Propriedade Valor
Parameter group: Storage Account Arguments
--auth-mode

O modo no qual executar o comando. O modo de "logon" usará diretamente suas credenciais de logon para a autenticação. O modo "chave" herdado tentará consultar uma chave de conta se nenhum parâmetro de autenticação para a conta for fornecido. Variável de ambiente: AZURE_STORAGE_AUTH_MODE.

Propriedade Valor
Valores aceitos: key, login
--blob-endpoint

Ponto de extremidade do serviço de dados de armazenamento. Deve ser usado em conjunto com uma chave de conta de armazenamento ou um token SAS. Você pode encontrar cada ponto de extremidade primário de serviço com az storage account show. Variável de ambiente: AZURE_STORAGE_SERVICE_ENDPOINT.

Propriedade Valor
Parameter group: Storage Account Arguments
--connection-string

Cadeia de conexão da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_CONNECTION_STRING.

Propriedade Valor
Parameter group: Storage Account Arguments
--default-encryption-scope -d
Versão Prévia

Padrão, o contêiner usará o escopo de criptografia especificado para todas as gravações.

Propriedade Valor
Parameter group: Encryption Policy Arguments
--fail-on-exist

Gere uma exceção se o contêiner já existir.

Propriedade Valor
Valor padrão: False
--metadata

Metadados em pares separados por espaço no formato key=value. Isso substitui todos os metadados existentes.

--prevent-encryption-scope-override -p
Versão Prévia

Bloquear a substituição do escopo de criptografia do padrão do contêiner.

Propriedade Valor
Parameter group: Encryption Policy Arguments
Valores aceitos: false, true
--public-access

Especifica se os dados no contêiner podem ser acessados publicamente.

Propriedade Valor
Valores aceitos: blob, container, off
--resource-group -g
Preterido

O argumento 'resource_group_name' foi preterido e será removido em uma versão futura.

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--sas-token

Uma SAS (Assinatura de Acesso Compartilhado). Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade de serviço. Variável de ambiente: AZURE_STORAGE_SAS_TOKEN.

Propriedade Valor
Parameter group: Storage Account Arguments
--timeout

Tempo limite da solicitação em segundos. Aplica-se a cada chamada ao serviço.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az storage container delete

Editar

Marque o contêiner especificado para exclusão.

O contêiner e todos os blobs contidos nele são excluídos posteriormente durante a coleta de lixo.

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]

Exemplos

Marca o contêiner especificado para exclusão. (autogenerated)

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

Parâmetros Exigidos

--name -n

O nome do contêiner.

Parâmetros Opcionais

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

--account-key

Chave da conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade de serviço. Variável de ambiente: AZURE_STORAGE_KEY.

Propriedade Valor
Parameter group: Storage Account Arguments
--account-name

Nome da conta de armazenamento. Variável de ambiente relacionada: AZURE_STORAGE_ACCOUNT. Deve ser usado em conjunto com uma chave de conta de armazenamento ou um token SAS. Se nenhum dos dois estiver presente, o comando tentará consultar a chave da conta de armazenamento usando a conta autenticada do Azure. Se um grande número de comandos de armazenamento for executado, a cota de API poderá ser atingida.

Propriedade Valor
Parameter group: Storage Account Arguments
--auth-mode

O modo no qual executar o comando. O modo de "logon" usará diretamente suas credenciais de logon para a autenticação. O modo "chave" herdado tentará consultar uma chave de conta se nenhum parâmetro de autenticação para a conta for fornecido. Variável de ambiente: AZURE_STORAGE_AUTH_MODE.

Propriedade Valor
Valores aceitos: key, login
--blob-endpoint

Ponto de extremidade do serviço de dados de armazenamento. Deve ser usado em conjunto com uma chave de conta de armazenamento ou um token SAS. Você pode encontrar cada ponto de extremidade primário de serviço com az storage account show. Variável de ambiente: AZURE_STORAGE_SERVICE_ENDPOINT.

Propriedade Valor
Parameter group: Storage Account Arguments
--bypass-immutability-policy

Ignora o comportamento de serviço que bloqueará a exclusão de um contêiner se ele tiver uma política de imutabilidade. Especificar isso ignorará os argumentos além daqueles usados para identificar o contêiner ("--name", "--account-name").

Propriedade Valor
Valor padrão: False
--connection-string

Cadeia de conexão da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_CONNECTION_STRING.

Propriedade Valor
Parameter group: Storage Account Arguments
--fail-not-exist

Gere uma exceção se o contêiner não existir.

Propriedade Valor
Valor padrão: False
--if-modified-since

Comece somente se modificado desde o datetime UTC fornecido (Y-m-d'T'H:M'Z').

Propriedade Valor
Parameter group: Precondition Arguments
--if-unmodified-since

Comece somente se não modificado desde o horário utc fornecido (Y-m-d'T'H:M'Z').

Propriedade Valor
Parameter group: Precondition Arguments
--lease-id

Se especificado, delete_container só terá êxito se a concessão do contêiner estiver ativa e corresponder a essa ID. Obrigatório se o contêiner tiver uma concessão ativa.

--sas-token

Uma SAS (Assinatura de Acesso Compartilhado). Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade de serviço. Variável de ambiente: AZURE_STORAGE_SAS_TOKEN.

Propriedade Valor
Parameter group: Storage Account Arguments
--timeout

Tempo limite da solicitação em segundos. Aplica-se a cada chamada ao serviço.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az storage container exists

Editar

Verifique a existência de um recipiente de armazenamento.

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

Exemplos

Verifique a existência de um recipiente de armazenamento. (autogenerated)

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

Parâmetros Exigidos

--name -n

O nome do contêiner.

Parâmetros Opcionais

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

--account-key

Chave da conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade de serviço. Variável de ambiente: AZURE_STORAGE_KEY.

Propriedade Valor
Parameter group: Storage Account Arguments
--account-name

Nome da conta de armazenamento. Variável de ambiente relacionada: AZURE_STORAGE_ACCOUNT. Deve ser usado em conjunto com uma chave de conta de armazenamento ou um token SAS. Se nenhum dos dois estiver presente, o comando tentará consultar a chave da conta de armazenamento usando a conta autenticada do Azure. Se um grande número de comandos de armazenamento for executado, a cota de API poderá ser atingida.

Propriedade Valor
Parameter group: Storage Account Arguments
--auth-mode

O modo no qual executar o comando. O modo de "logon" usará diretamente suas credenciais de logon para a autenticação. O modo "chave" herdado tentará consultar uma chave de conta se nenhum parâmetro de autenticação para a conta for fornecido. Variável de ambiente: AZURE_STORAGE_AUTH_MODE.

Propriedade Valor
Valores aceitos: key, login
--blob-endpoint

Ponto de extremidade do serviço de dados de armazenamento. Deve ser usado em conjunto com uma chave de conta de armazenamento ou um token SAS. Você pode encontrar cada ponto de extremidade primário de serviço com az storage account show. Variável de ambiente: AZURE_STORAGE_SERVICE_ENDPOINT.

Propriedade Valor
Parameter group: Storage Account Arguments
--connection-string

Cadeia de conexão da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_CONNECTION_STRING.

Propriedade Valor
Parameter group: Storage Account Arguments
--sas-token

Uma SAS (Assinatura de Acesso Compartilhado). Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade de serviço. Variável de ambiente: AZURE_STORAGE_SAS_TOKEN.

Propriedade Valor
Parameter group: Storage Account Arguments
--timeout

Tempo limite da solicitação em segundos. Aplica-se a cada chamada ao serviço.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az storage container generate-sas

Editar

Gere um token SAS para um contêiner de armazenamento.

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]

Exemplos

Gere um token sas para o contêiner de blob e use-o para carregar um 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

Gerar uma assinatura de acesso compartilhado para o contêiner (gerado automaticamente)

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

Gere um token SAS para um contêiner de armazenamento. (autogenerated)

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

Parâmetros Exigidos

--name -n

O nome do contêiner.

Parâmetros Opcionais

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

--account-key

Chave da conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade de serviço. Variável de ambiente: AZURE_STORAGE_KEY.

Propriedade Valor
Parameter group: Storage Account Arguments
--account-name

Nome da conta de armazenamento. Variável de ambiente relacionada: AZURE_STORAGE_ACCOUNT. Deve ser usado em conjunto com uma chave de conta de armazenamento ou um token SAS. Se nenhum dos dois estiver presente, o comando tentará consultar a chave da conta de armazenamento usando a conta autenticada do Azure. Se um grande número de comandos de armazenamento for executado, a cota de API poderá ser atingida.

Propriedade Valor
Parameter group: Storage Account Arguments
--as-user

Indica que esse comando retorna a SAS assinada com a chave de delegação do usuário. O parâmetro de expiração e o "logon no modo de autenticação" são necessários se esse argumento for especificado.

Propriedade Valor
Valor padrão: False
--auth-mode

O modo no qual executar o comando. O modo de "logon" usará diretamente suas credenciais de logon para a autenticação. O modo "chave" herdado tentará consultar uma chave de conta se nenhum parâmetro de autenticação para a conta for fornecido. Variável de ambiente: AZURE_STORAGE_AUTH_MODE.

Propriedade Valor
Valores aceitos: key, login
--blob-endpoint

Ponto de extremidade do serviço de dados de armazenamento. Deve ser usado em conjunto com uma chave de conta de armazenamento ou um token SAS. Você pode encontrar cada ponto de extremidade primário de serviço com az storage account show. Variável de ambiente: AZURE_STORAGE_SERVICE_ENDPOINT.

Propriedade Valor
Parameter group: Storage Account Arguments
--cache-control

Valor do cabeçalho de resposta para Cache-Control quando o recurso é acessado usando essa assinatura de acesso compartilhado.

--connection-string

Cadeia de conexão da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_CONNECTION_STRING.

Propriedade Valor
Parameter group: Storage Account Arguments
--content-disposition

Valor do cabeçalho de resposta para Content-Disposition quando o recurso é acessado usando essa assinatura de acesso compartilhado.

--content-encoding

Valor do cabeçalho de resposta para Content-Encoding quando o recurso é acessado usando essa assinatura de acesso compartilhado.

--content-language

Valor do cabeçalho de resposta para Content-Language quando o recurso é acessado usando essa assinatura de acesso compartilhado.

--content-type

Valor do cabeçalho de resposta para Content-Type quando o recurso é acessado usando essa assinatura de acesso compartilhado.

--encryption-scope

Um escopo de criptografia predefinido usado para criptografar os dados no serviço.

--expiry

Especifica o datetime UTC (Y-m-d'T'H:M'Z') no qual a SAS se torna inválida. Não use se uma política de acesso armazenado for referenciada com --policy-name que especifica esse valor.

--https-only

Permitir somente solicitações feitas com o protocolo HTTPS. Se omitido, as solicitações do protocolo HTTP e HTTPS serão permitidas.

--ip

Especifica o endereço IP ou o intervalo de endereços IP dos quais aceitar solicitações. Dá suporte apenas a endereços de estilo IPv4.

--permissions

As permissões concedidas pela 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. Não use se uma política de acesso armazenado for referenciada com --id que especifica esse valor. Pode ser combinado.

--policy-name

O nome de uma política de acesso armazenada dentro da ACL do contêiner.

--start

Especifica o datetime UTC (Y-m-d'T'H:M'Z') no qual a SAS se torna válida. Não use se uma política de acesso armazenado for referenciada com --policy-name que especifica esse valor. O padrão é a hora da solicitação.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az storage container generate-sas (storage-blob-preview extensão)

Gere um token SAS para um contêiner de armazenamento.

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]

Exemplos

Gere um token sas para o contêiner de blob e use-o para carregar um 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

Gerar uma assinatura de acesso compartilhado para o contêiner (gerado automaticamente)

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

Gere um token SAS para um contêiner de armazenamento. (autogenerated)

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

Parâmetros Exigidos

--name -n

O nome do contêiner.

Parâmetros Opcionais

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

--account-key

Chave da conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_KEY.

Propriedade Valor
Parameter group: Storage Account Arguments
--account-name

Nome da conta de armazenamento. Variável de ambiente relacionada: AZURE_STORAGE_ACCOUNT. Deve ser usado em conjunto com uma chave de conta de armazenamento ou um token SAS. Se nenhum dos dois estiver presente, o comando tentará consultar a chave da conta de armazenamento usando a conta autenticada do Azure. Se um grande número de comandos de armazenamento for executado, a cota de API poderá ser atingida.

Propriedade Valor
Parameter group: Storage Account Arguments
--as-user

Indica que esse comando retorna a SAS assinada com a chave de delegação do usuário. O parâmetro de expiração e o "logon no modo de autenticação" são necessários se esse argumento for especificado.

Propriedade Valor
Valor padrão: False
--auth-mode

O modo no qual executar o comando. O modo de "logon" usará diretamente suas credenciais de logon para a autenticação. O modo "chave" herdado tentará consultar uma chave de conta se nenhum parâmetro de autenticação para a conta for fornecido. Variável de ambiente: AZURE_STORAGE_AUTH_MODE.

Propriedade Valor
Valores aceitos: key, login
--blob-endpoint

Ponto de extremidade do serviço de dados de armazenamento. Deve ser usado em conjunto com uma chave de conta de armazenamento ou um token SAS. Você pode encontrar cada ponto de extremidade primário de serviço com az storage account show. Variável de ambiente: AZURE_STORAGE_SERVICE_ENDPOINT.

Propriedade Valor
Parameter group: Storage Account Arguments
--cache-control

Valor do cabeçalho de resposta para Cache-Control quando o recurso é acessado com essa assinatura de acesso compartilhado.

--connection-string

Cadeia de conexão da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_CONNECTION_STRING.

Propriedade Valor
Parameter group: Storage Account Arguments
--content-disposition

Valor do cabeçalho de resposta para Content-Disposition quando o recurso é acessado com essa assinatura de acesso compartilhado.

--content-encoding

Valor do cabeçalho de resposta para Codificação de Conteúdo quando o recurso é acessado, que usa essa assinatura de acesso compartilhado.

--content-language

Valor do cabeçalho de resposta para Content-Language quando o recurso é acessado com essa assinatura de acesso compartilhado.

--content-type

Valor do cabeçalho de resposta para Content-Type quando o recurso é acessado com essa assinatura de acesso compartilhado.

--expiry

Especifica o datetime UTC (Y-m-d'T'H:M'Z') no qual a SAS se torna inválida. Não use se uma política de acesso armazenado for referenciada com --id que especifica esse valor.

--full-uri
Versão Prévia

Indique que esse comando retorna o URI de blob completo e o token de assinatura de acesso compartilhado.

Propriedade Valor
Valor padrão: False
--https-only

Permitir somente solicitações feitas com o protocolo HTTPS. Se omitido, as solicitações do protocolo HTTP e HTTPS serão permitidas.

--ip

Especifica o endereço IP ou o intervalo de endereços IP dos quais aceitar solicitações. Dá suporte apenas a endereços de estilo IPv4.

--permissions

As permissões concedidas pela 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. Não use se uma política de acesso armazenado for referenciada com --policy-name que especifica esse valor. Pode ser combinado.

--policy-name

O nome de uma política de acesso armazenada dentro da ACL do contêiner.

--start

Especifica o datetime UTC (Y-m-d'T'H:M'Z') no qual a SAS se torna válida. Não use se uma política de acesso armazenado for referenciada com --id que especifica esse valor. O padrão é a hora da solicitação.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az storage container list

Editar

Listar contêineres em uma conta de armazenamento.

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]

Exemplos

Listar contêineres em uma conta de armazenamento.

az storage container list

Listar contêineres excluídos suavemente em uma conta de armazenamento.

az storage container list --include-deleted

Parâmetros Opcionais

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

--account-key

Chave da conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade de serviço. Variável de ambiente: AZURE_STORAGE_KEY.

Propriedade Valor
Parameter group: Storage Account Arguments
--account-name

Nome da conta de armazenamento. Variável de ambiente relacionada: AZURE_STORAGE_ACCOUNT. Deve ser usado em conjunto com uma chave de conta de armazenamento ou um token SAS. Se nenhum dos dois estiver presente, o comando tentará consultar a chave da conta de armazenamento usando a conta autenticada do Azure. Se um grande número de comandos de armazenamento for executado, a cota de API poderá ser atingida.

Propriedade Valor
Parameter group: Storage Account Arguments
--auth-mode

O modo no qual executar o comando. O modo de "logon" usará diretamente suas credenciais de logon para a autenticação. O modo "chave" herdado tentará consultar uma chave de conta se nenhum parâmetro de autenticação para a conta for fornecido. Variável de ambiente: AZURE_STORAGE_AUTH_MODE.

Propriedade Valor
Valores aceitos: key, login
--blob-endpoint

Ponto de extremidade do serviço de dados de armazenamento. Deve ser usado em conjunto com uma chave de conta de armazenamento ou um token SAS. Você pode encontrar cada ponto de extremidade primário de serviço com az storage account show. Variável de ambiente: AZURE_STORAGE_SERVICE_ENDPOINT.

Propriedade Valor
Parameter group: Storage Account Arguments
--connection-string

Cadeia de conexão da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_CONNECTION_STRING.

Propriedade Valor
Parameter group: Storage Account Arguments
--include-deleted

Especifique os contêineres excluídos a serem retornados na resposta. Isso é para a conta habilitada para restauração de contêiner. O valor padrão é False.

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--include-metadata

Especifique os metadados de contêiner a serem retornados na resposta.

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--marker

Um valor de cadeia de caracteres que identifica a parte da lista de contêineres a serem retornados com a próxima operação de listagem. A operação retornará o valor NextMarker dentro do corpo da resposta se a operação de listagem não retornar todos os contêineres restantes a serem listados com a página atual. Se especificado, este gerador começará a retornar resultados do ponto em que o gerador anterior parou.

--num-results

Especifique o número máximo a ser retornado. Se a solicitação não especificar num_results ou especificar um valor maior que 5000, o servidor retornará até 5000 itens. Observe que, se a operação de listagem cruzar um limite de partição, o serviço retornará um token de continuação para recuperar o restante dos resultados. Forneça "*" para retornar tudo.

Propriedade Valor
Valor padrão: 5000
--prefix

Filtre os resultados para retornar apenas blobs cujo nome começa com o prefixo especificado.

--sas-token

Uma SAS (Assinatura de Acesso Compartilhado). Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade de serviço. Variável de ambiente: AZURE_STORAGE_SAS_TOKEN.

Propriedade Valor
Parameter group: Storage Account Arguments
--show-next-marker
Versão Prévia

Mostrar nextMarker no resultado quando especificado.

--timeout

Tempo limite da solicitação em segundos. Aplica-se a cada chamada ao serviço.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az storage container restore

Editar

Restaurar contêiner excluído de forma reversível.

A operação só será bem-sucedida se usada dentro do número especificado de dias definido na política de retenção de exclusão.

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

Exemplos

Listar e restaurar contêiner com exclusão reversível.

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

Parâmetros Exigidos

--deleted-version

Especifique a versão do contêiner excluído a ser restaurado.

--name -n

Especifique o nome do contêiner excluído a ser restaurado.

Parâmetros Opcionais

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

--account-key

Chave da conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade de serviço. Variável de ambiente: AZURE_STORAGE_KEY.

Propriedade Valor
Parameter group: Storage Account Arguments
--account-name

Nome da conta de armazenamento. Variável de ambiente relacionada: AZURE_STORAGE_ACCOUNT. Deve ser usado em conjunto com uma chave de conta de armazenamento ou um token SAS. Se nenhum dos dois estiver presente, o comando tentará consultar a chave da conta de armazenamento usando a conta autenticada do Azure. Se um grande número de comandos de armazenamento for executado, a cota de API poderá ser atingida.

Propriedade Valor
Parameter group: Storage Account Arguments
--auth-mode

O modo no qual executar o comando. O modo de "logon" usará diretamente suas credenciais de logon para a autenticação. O modo "chave" herdado tentará consultar uma chave de conta se nenhum parâmetro de autenticação para a conta for fornecido. Variável de ambiente: AZURE_STORAGE_AUTH_MODE.

Propriedade Valor
Valores aceitos: key, login
--blob-endpoint

Ponto de extremidade do serviço de dados de armazenamento. Deve ser usado em conjunto com uma chave de conta de armazenamento ou um token SAS. Você pode encontrar cada ponto de extremidade primário de serviço com az storage account show. Variável de ambiente: AZURE_STORAGE_SERVICE_ENDPOINT.

Propriedade Valor
Parameter group: Storage Account Arguments
--connection-string

Cadeia de conexão da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_CONNECTION_STRING.

Propriedade Valor
Parameter group: Storage Account Arguments
--sas-token

Uma SAS (Assinatura de Acesso Compartilhado). Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade de serviço. Variável de ambiente: AZURE_STORAGE_SAS_TOKEN.

Propriedade Valor
Parameter group: Storage Account Arguments
--timeout

Tempo limite da solicitação em segundos. Aplica-se a cada chamada ao serviço.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az storage container set-permission

Editar

Defina as permissões para o contêiner 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 Exigidos

--name -n

O nome do contêiner.

Parâmetros Opcionais

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

--account-key

Chave da conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade de serviço. Variável de ambiente: AZURE_STORAGE_KEY.

Propriedade Valor
Parameter group: Storage Account Arguments
--account-name

Nome da conta de armazenamento. Variável de ambiente relacionada: AZURE_STORAGE_ACCOUNT. Deve ser usado em conjunto com uma chave de conta de armazenamento ou um token SAS. Se nenhum dos dois estiver presente, o comando tentará consultar a chave da conta de armazenamento usando a conta autenticada do Azure. Se um grande número de comandos de armazenamento for executado, a cota de API poderá ser atingida.

Propriedade Valor
Parameter group: Storage Account Arguments
--auth-mode

O modo no qual executar o comando. O modo "chave" herdado tentará consultar uma chave de conta se nenhum parâmetro de autenticação para a conta for fornecido. Variável de ambiente: AZURE_STORAGE_AUTH_MODE.

Propriedade Valor
Valores aceitos: key
--blob-endpoint

Ponto de extremidade do serviço de dados de armazenamento. Deve ser usado em conjunto com uma chave de conta de armazenamento ou um token SAS. Você pode encontrar cada ponto de extremidade primário de serviço com az storage account show. Variável de ambiente: AZURE_STORAGE_SERVICE_ENDPOINT.

Propriedade Valor
Parameter group: Storage Account Arguments
--connection-string

Cadeia de conexão da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_CONNECTION_STRING.

Propriedade Valor
Parameter group: Storage Account Arguments
--if-modified-since

Comece somente se modificado desde o datetime UTC fornecido (Y-m-d'T'H:M'Z').

Propriedade Valor
Parameter group: Precondition Arguments
--if-unmodified-since

Comece somente se não modificado desde o horário utc fornecido (Y-m-d'T'H:M'Z').

Propriedade Valor
Parameter group: Precondition Arguments
--lease-id

Se especificado, só terá êxito se a concessão do contêiner estiver ativa e corresponder a essa ID.

--public-access

Especifica se os dados no contêiner podem ser acessados publicamente.

Propriedade Valor
Valores aceitos: blob, container, off
--timeout

Tempo limite da solicitação em segundos. Aplica-se a cada chamada ao serviço.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az storage container show

Editar

Retorna todos os metadados definidos pelo usuário e propriedades do sistema para o contêiner 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 Exigidos

--name -n

O nome do contêiner.

Parâmetros Opcionais

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

--account-key

Chave da conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade de serviço. Variável de ambiente: AZURE_STORAGE_KEY.

Propriedade Valor
Parameter group: Storage Account Arguments
--account-name

Nome da conta de armazenamento. Variável de ambiente relacionada: AZURE_STORAGE_ACCOUNT. Deve ser usado em conjunto com uma chave de conta de armazenamento ou um token SAS. Se nenhum dos dois estiver presente, o comando tentará consultar a chave da conta de armazenamento usando a conta autenticada do Azure. Se um grande número de comandos de armazenamento for executado, a cota de API poderá ser atingida.

Propriedade Valor
Parameter group: Storage Account Arguments
--auth-mode

O modo no qual executar o comando. O modo de "logon" usará diretamente suas credenciais de logon para a autenticação. O modo "chave" herdado tentará consultar uma chave de conta se nenhum parâmetro de autenticação para a conta for fornecido. Variável de ambiente: AZURE_STORAGE_AUTH_MODE.

Propriedade Valor
Valores aceitos: key, login
--blob-endpoint

Ponto de extremidade do serviço de dados de armazenamento. Deve ser usado em conjunto com uma chave de conta de armazenamento ou um token SAS. Você pode encontrar cada ponto de extremidade primário de serviço com az storage account show. Variável de ambiente: AZURE_STORAGE_SERVICE_ENDPOINT.

Propriedade Valor
Parameter group: Storage Account Arguments
--connection-string

Cadeia de conexão da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_CONNECTION_STRING.

Propriedade Valor
Parameter group: Storage Account Arguments
--lease-id

Se especificado, só terá êxito se a concessão do contêiner estiver ativa e corresponder a essa ID.

--sas-token

Uma SAS (Assinatura de Acesso Compartilhado). Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade de serviço. Variável de ambiente: AZURE_STORAGE_SAS_TOKEN.

Propriedade Valor
Parameter group: Storage Account Arguments
--timeout

Tempo limite da solicitação em segundos. Aplica-se a cada chamada ao serviço.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az storage container show-permission

Editar

Obtenha as permissões para o contêiner especificado.

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

Parâmetros Exigidos

--name -n

O nome do contêiner.

Parâmetros Opcionais

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

--account-key

Chave da conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade de serviço. Variável de ambiente: AZURE_STORAGE_KEY.

Propriedade Valor
Parameter group: Storage Account Arguments
--account-name

Nome da conta de armazenamento. Variável de ambiente relacionada: AZURE_STORAGE_ACCOUNT. Deve ser usado em conjunto com uma chave de conta de armazenamento ou um token SAS. Se nenhum dos dois estiver presente, o comando tentará consultar a chave da conta de armazenamento usando a conta autenticada do Azure. Se um grande número de comandos de armazenamento for executado, a cota de API poderá ser atingida.

Propriedade Valor
Parameter group: Storage Account Arguments
--auth-mode

O modo no qual executar o comando. O modo "chave" herdado tentará consultar uma chave de conta se nenhum parâmetro de autenticação para a conta for fornecido. Variável de ambiente: AZURE_STORAGE_AUTH_MODE.

Propriedade Valor
Valores aceitos: key
--blob-endpoint

Ponto de extremidade do serviço de dados de armazenamento. Deve ser usado em conjunto com uma chave de conta de armazenamento ou um token SAS. Você pode encontrar cada ponto de extremidade primário de serviço com az storage account show. Variável de ambiente: AZURE_STORAGE_SERVICE_ENDPOINT.

Propriedade Valor
Parameter group: Storage Account Arguments
--connection-string

Cadeia de conexão da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_CONNECTION_STRING.

Propriedade Valor
Parameter group: Storage Account Arguments
--lease-id

Se especificado, só terá êxito se a concessão do contêiner estiver ativa e corresponder a essa ID.

--timeout

Tempo limite da solicitação em segundos. Aplica-se a cada chamada ao serviço.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False