az storage blob

Referência

Observação

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 o armazenamento de objetos para dados não estruturados (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 blob access	Gerencia as propriedades de controle de acesso de um blob quando o Namespace Hierárquico está habilitado.	Extensão	Preterido
az storage blob access set	Defina as propriedades de controle de acesso de um blob.	Extensão	Preterido
az storage blob access show	Mostre as propriedades de controle de acesso de um blob.	Extensão	Preterido
az storage blob access update	Atualize as propriedades de controle de acesso de um blob.	Extensão	Preterido
az storage blob copy	Gerencia as operações de cópia de blob. Use `az storage blob show` para verificar o status dos blobs.	Núcleo e Extensão	GA
az storage blob copy cancel	Anule uma operação de cópia em andamento.	Núcleo	GA
az storage blob copy start	Copie um blob de forma assíncrona. Use `az storage blob show` para verificar o status dos blobs.	Núcleo	GA
az storage blob copy start (storage-blob-preview extensão)	Inicie um trabalho de blob de cópia.	Extensão	GA
az storage blob copy start-batch	Copie vários blobs para um contêiner de blob. Use `az storage blob show` para verificar o status dos blobs.	Núcleo	GA
az storage blob delete	Marque um blob ou instantâneo para exclusão.	Núcleo	GA
az storage blob delete (storage-blob-preview extensão)	Marque um blob ou instantâneo para exclusão.	Extensão	GA
az storage blob delete-batch	Exclua blobs de um contêiner de blob recursivamente.	Núcleo	GA
az storage blob directory	Gerenciar diretórios de blob no contêiner da conta de armazenamento.	Extensão	Preterido
az storage blob directory access	Gerencia as propriedades de controle de acesso de um diretório quando o Namespace Hierárquico está habilitado.	Extensão	Pré-visualização e Obsoleto
az storage blob directory access set	Defina as propriedades de controle de acesso de um diretório.	Extensão	Pré-visualização e Obsoleto
az storage blob directory access show	Mostre as propriedades de controle de acesso de um diretório.	Extensão	Pré-visualização e Obsoleto
az storage blob directory access update	Atualize as propriedades de controle de acesso de um diretório.	Extensão	Pré-visualização e Obsoleto
az storage blob directory create	Crie um diretório de blob de armazenamento em um contêiner de armazenamento.	Extensão	Preterido
az storage blob directory delete	Exclua um diretório de blob de armazenamento em um contêiner de armazenamento.	Extensão	Preterido
az storage blob directory download	Baixar blobs para um caminho de arquivo local.	Extensão	Preterido
az storage blob directory exists	Verifique a existência de um diretório de blob em um contêiner de armazenamento.	Extensão	Preterido
az storage blob directory list	Listar blobs e subdiretórios de blob em um diretório de armazenamento.	Extensão	Preterido
az storage blob directory metadata	Gerencia metadados do diretório.	Extensão	Preterido
az storage blob directory metadata show	Mostre todos os metadados definidos pelo usuário para o diretório de blob especificado.	Extensão	Preterido
az storage blob directory metadata update	Defina metadados definidos pelo usuário para o diretório de blob especificado como um ou mais pares nome-valor.	Extensão	Preterido
az storage blob directory move	Mova um diretório de armazenamento para outro diretório de blob de armazenamento em um contêiner de armazenamento.	Extensão	Preterido
az storage blob directory show	Mostrar as propriedades do diretório de blob de armazenamento em um contêiner de armazenamento.	Extensão	Preterido
az storage blob directory upload	Carregue blobs ou subdiretórios em um diretório de blob de armazenamento.	Extensão	Preterido
az storage blob download	Baixar um blob para um caminho de arquivo.	Núcleo	GA
az storage blob download-batch	Baixe blobs de um contêiner de blob recursivamente.	Núcleo	GA
az storage blob exists	Verifique a existência de um blob em um contêiner.	Núcleo	GA
az storage blob filter	Liste blobs em todos os contêineres cujas marcas correspondam a uma determinada expressão de pesquisa.	Extensão	Visualizar
az storage blob generate-sas	Gere uma assinatura de acesso compartilhado para o blob.	Núcleo	GA
az storage blob generate-sas (storage-blob-preview extensão)	Gere uma assinatura de acesso compartilhado para o blob.	Extensão	GA
az storage blob immutability-policy	Gerenciar a política de imutabilidade de blob.	Núcleo	GA
az storage blob immutability-policy delete	Exclua a política de imutabilidade do blob.	Núcleo	GA
az storage blob immutability-policy set	Defina a política de imutabilidade do blob.	Núcleo	GA
az storage blob incremental-copy	Gerencia as operações de cópia incrementais do blob.	Núcleo	GA
az storage blob incremental-copy cancel	Anula uma operação de copy_blob pendente e deixa um blob de destino com comprimento zero e metadados completos.	Núcleo	GA
az storage blob incremental-copy start	Copia uma cópia incremental de um blob de forma assíncrona.	Núcleo	GA
az storage blob lease	Gerencia as concessões do blob de armazenamento.	Núcleo	GA
az storage blob lease acquire	Solicite uma nova concessão.	Núcleo	GA
az storage blob lease break	Interrompa a concessão, se o contêiner ou blob tiver uma concessão ativa.	Núcleo	GA
az storage blob lease change	Altere a ID de concessão de uma concessão ativa.	Núcleo	GA
az storage blob lease release	Libere o arrendamento.	Núcleo	GA
az storage blob lease renew	Renove o contrato.	Núcleo	GA
az storage blob list	Listar blobs em um determinado contêiner.	Núcleo	GA
az storage blob metadata	Gerencia os metadados do blob.	Núcleo	GA
az storage blob metadata show	Retorne todos os metadados definidos pelo usuário para o blob ou instantâneo especificado.	Núcleo	GA
az storage blob metadata update	Define metadados definidos pelo usuário para o blob como um ou mais pares nome-valor.	Núcleo	GA
az storage blob move	Mova um blob em um contêiner de armazenamento.	Extensão	Pré-visualização e Obsoleto
az storage blob query	Permita que os usuários selecionem/projetem dados de blob ou instantâneo de blob fornecendo expressões de consulta simples.	Núcleo	Visualizar
az storage blob restore	Restaure blobs nos intervalos de blobs especificados.	Núcleo	GA
az storage blob rewrite	Crie um novo Blob de Blocos em que o conteúdo do blob é lido de uma determinada URL.	Núcleo	Visualizar
az storage blob service-properties	Gerencia as propriedades de serviço do blob de armazenamento.	Núcleo e Extensão	GA
az storage blob service-properties delete-policy	Gerencia as propriedades de serviço da política de exclusão do blob de armazenamento.	Núcleo	GA
az storage blob service-properties delete-policy show	Mostre a política de exclusão do blob de armazenamento.	Núcleo	GA
az storage blob service-properties delete-policy update	Atualize a política de exclusão de blob de armazenamento.	Núcleo	GA
az storage blob service-properties show	Obtém as propriedades do serviço Blob de uma conta de armazenamento, incluindo a Análise de Armazenamento do Azure.	Núcleo	GA
az storage blob service-properties update	Atualiza as propriedades do serviço de blobs de armazenamento.	Núcleo	GA
az storage blob service-properties update (storage-blob-preview extensão)	Atualiza as propriedades do serviço de blobs de armazenamento.	Extensão	GA
az storage blob set-legal-hold	Defina a retenção legal do blob.	Núcleo	GA
az storage blob set-tier	Defina as camadas de bloco ou página no blob.	Núcleo	GA
az storage blob set-tier (storage-blob-preview extensão)	Defina as camadas de bloco ou página no blob.	Extensão	GA
az storage blob show	Obtenha os detalhes de um blob.	Núcleo	GA
az storage blob show (storage-blob-preview extensão)	Obtenha os detalhes de um blob.	Extensão	GA
az storage blob snapshot	Cria um instantâneo do blob.	Núcleo	GA
az storage blob sync	Sincronize blobs recursivamente com um contêiner de blob de armazenamento.	Núcleo	Visualizar
az storage blob tag	Gerenciar marcas de blob.	Extensão	Visualizar
az storage blob tag list	Obtenha marcas em um blob ou versão específica do blob ou instantâneo.	Extensão	Visualizar
az storage blob tag set	Defina marcas em um blob ou em uma versão específica do blob, mas não no instantâneo.	Extensão	Visualizar
az storage blob undelete	Restaure o blob ou instantâneo excluído de forma reversível.	Núcleo	GA
az storage blob update	Define as propriedades do sistema no blob.	Núcleo	GA
az storage blob upload	Carregue um arquivo em um blob de armazenamento.	Núcleo	GA
az storage blob upload-batch	Carregue arquivos de um diretório local para um contêiner de blob.	Núcleo	GA
az storage blob url	Crie a url para acessar um blob.	Núcleo	GA

az storage blob delete

Editar

Marque um blob ou instantâneo para exclusão.

O blob é marcado para exclusão posterior durante a coleta de lixo. Para excluir um blob, todos os seus instantâneos também devem ser excluídos. Ambos podem ser removidos ao mesmo tempo.

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

Exemplos

Excluir um blob.

az storage blob delete -c mycontainer -n MyBlob

Exclua um blob usando credenciais de logon.

az storage blob delete -c mycontainer -n MyBlob --account-name mystorageaccount --auth-mode login

Parâmetros Opcionais

--account-key

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

--account-name

Nome da conta de armazenamento. Variável de ambiente relacionada: AZURE_STORAGE_ACCOUNT. Deve ser usado em conjunto com a chave da 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 da API poderá ser atingida.

--auth-mode

O modo no qual executar o comando. O modo "login" usará diretamente suas credenciais de login 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.

Valores aceitos: key, login

--blob-endpoint

Ponto de extremidade do serviço de dados de armazenamento. Deve ser usado em conjunto com a chave da 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.

--blob-url

A URL completa do ponto de extremidade para o Blob, incluindo o token SAS e o instantâneo, se usado. Pode ser o endpoint primário ou o endpoint secundário, dependendo do .location_mode

--connection-string

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

--container-name -c

O nome do contêiner.

--delete-snapshots

Obrigatório se o blob tiver instantâneos associados. Os valores incluem: "only": exclui apenas os instantâneos de blobs. "include": exclui o blob junto com todos os instantâneos.

Valores aceitos: include, only

--if-match

Um valor ETag ou o caractere curinga (*). Especifique esse cabeçalho para executar a operação somente se a ETag do recurso corresponder ao valor especificado.

--if-modified-since

Inicie somente se modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

--if-none-match

Um valor ETag ou o caractere curinga (). Especifique esse cabeçalho para executar a operação somente se a ETag do recurso não corresponder ao valor especificado. Especifique o caractere curinga () para executar a operação somente se o recurso não existir e falhe na operação se ele existir.

--if-unmodified-since

Inicie somente se não tiver sido modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

--lease-id

Necessário se o blob tiver uma concessão ativa.

--name -n

O nome do blob.

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

--snapshot

O parâmetro de instantâneo é um valor DateTime opaco que, quando presente, especifica o instantâneo de blob a ser excluído.

--tags-condition

Especifique uma cláusula SQL where em marcas de blob para operar somente em blobs com um valor correspondente.

--timeout

Solicite o tempo limite em segundos. Aplica-se a cada chamada para o serviço.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az storage blob delete (storage-blob-preview extensão)

Marque um blob ou instantâneo para exclusão.

O blob é marcado para exclusão posterior durante a coleta de lixo. Para excluir um blob, todos os seus instantâneos também devem ser excluídos. Ambos podem ser removidos ao mesmo tempo.

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

Exemplos

Excluir um blob.

az storage blob delete -c mycontainer -n MyBlob

Exclua um blob usando credenciais de logon.

az storage blob delete -c mycontainer -n MyBlob --account-name mystorageaccount --auth-mode login

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

Valores aceitos: key, login

--blob-endpoint

--blob-url

A URL completa do ponto de extremidade para o Blob, incluindo o token SAS e o instantâneo, se usado. Pode ser o endpoint primário ou o endpoint secundário, dependendo do .location_mode

--connection-string

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

--container-name -c

O nome do contêiner.

--delete-snapshots

Obrigatório se o blob tiver instantâneos associados. "only": exclui apenas os instantâneos de blobs. "include": exclui o blob junto com todos os instantâneos.

Valores aceitos: include, only

--if-match

Um valor ETag ou o caractere curinga (*). Especifique esse cabeçalho para executar a operação somente se a ETag do recurso corresponder ao valor especificado.

--if-modified-since

Inicie somente se modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

--if-none-match

--if-unmodified-since

Inicie somente se não tiver sido modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

--lease-id

Necessário se o blob tiver uma concessão ativa.

--name -n

O nome do blob.

--sas-token

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

--snapshot

O parâmetro de instantâneo é um valor DateTime opaco que, quando presente, especifica o instantâneo de blob a ser recuperado.

--tags-condition

Especifique uma cláusula SQL where em marcas de blob para operar somente em blobs com um valor correspondente.

--timeout

Solicite o tempo limite em segundos. Aplica-se a cada chamada para o serviço.

--version-id

Uma ID de versão de blob opcional. Esse parâmetro é apenas para a conta habilitada para controle de versão.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az storage blob delete-batch

Editar

Exclua blobs de um contêiner de blob recursivamente.

az storage blob delete-batch --source
                             [--account-key]
                             [--account-name]
                             [--auth-mode {key, login}]
                             [--blob-endpoint]
                             [--connection-string]
                             [--delete-snapshots {include, only}]
                             [--dryrun]
                             [--if-match]
                             [--if-modified-since]
                             [--if-none-match]
                             [--if-unmodified-since]
                             [--lease-id]
                             [--pattern]
                             [--sas-token]
                             [--timeout]

Exemplos

Exclua todos os blobs que terminam com ".py" em um contêiner que não foram modificados por 10 dias.

date=`date -d "10 days ago" '+%Y-%m-%dT%H:%MZ'`
az storage blob delete-batch -s mycontainer --account-name mystorageaccount --pattern "*.py" --if-unmodified-since $date --auth-mode login

Exclua todos os blobs em um diretório chamado "dir" em um contêiner chamado "mycontainer".

az storage blob delete-batch -s mycontainer --pattern "dir/*"

Exclua os blobs com o formato 'cli-2018-xx-xx.txt' ou 'cli-2019-xx-xx.txt' em um contêiner.

az storage blob delete-batch -s mycontainer --pattern "cli-201[89]-??-??.txt"

Exclua todos os blobs com o formato 'cli-201x-xx-xx.txt', exceto cli-2018-xx-xx.txt' e 'cli-2019-xx-xx.txt' em um contêiner.

az storage blob delete-batch -s mycontainer --pattern "cli-201[!89]-??-??.txt"

Parâmetros Exigidos

--source -s

O contêiner de blob do qual os arquivos serão excluídos.

A origem pode ser a URL do contêiner ou o nome do contêiner. Quando a origem for a URL do contêiner, o nome da conta de armazenamento será analisado da URL.

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

Valores aceitos: key, login

--blob-endpoint

--connection-string

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

--delete-snapshots

Obrigatório se o blob tiver instantâneos associados.

Valores aceitos: include, only

--dryrun

Mostre o resumo das operações a serem realizadas em vez de realmente excluir o(s) arquivo(s).

Se isso for especificado, ele ignorará todos os Argumentos de Pré-condição que incluem --if-modified-since e --if-unmodified-since. Portanto, o(s) arquivo(s) será(ão) excluído(s) com o comando sem --dryrun pode ser diferente da lista de resultados com o sinalizador --dryrun ativado.

Valor padrão: False

--if-match

Um valor ETag ou o caractere curinga (*). Especifique esse cabeçalho para executar a operação somente se a ETag do recurso corresponder ao valor especificado.

--if-modified-since

Inicie somente se modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

--if-none-match

Um valor ETag ou o caractere curinga (*).

Especifique esse cabeçalho para executar a operação somente se a ETag do recurso não corresponder ao valor especificado. Especifique o caractere curinga (*) para executar a operação somente se o recurso não existir e falhe na operação se ele existir.

--if-unmodified-since

Inicie somente se não tiver sido modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

--lease-id

A ID de concessão ativa para o blob.

--pattern

O padrão usado para globbing de arquivos ou blobs na origem. Os padrões suportados são '*', '?', '[seq]' e '[!seq]'. Para obter mais informações, consulte https://docs.python.org/3.7/library/fnmatch.html.

Quando você usa '*' em --pattern, ele corresponderá a qualquer caractere, incluindo o separador de diretório '/'. Você também pode tentar o comando "az storage remove" com --include e --exclude com azure cli >= 2.0.70 para corresponder a vários padrões.

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

--timeout

Solicite o tempo limite em segundos. Aplica-se a cada chamada para o serviço.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az storage blob download

Editar

Baixar um blob para um caminho de arquivo.

az storage blob download [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--blob-endpoint]
                         [--blob-url]
                         [--connection-string]
                         [--container-name]
                         [--end-range]
                         [--file]
                         [--if-match]
                         [--if-modified-since]
                         [--if-none-match]
                         [--if-unmodified-since]
                         [--lease-id]
                         [--max-connections]
                         [--name]
                         [--no-progress]
                         [--open-mode]
                         [--overwrite {false, true}]
                         [--sas-token]
                         [--snapshot]
                         [--start-range]
                         [--tags-condition]
                         [--timeout]
                         [--validate-content]
                         [--version-id]

Exemplos

Baixe um blob.

az storage blob download -f /path/to/file -c mycontainer -n MyBlob

Baixe um conteúdo de blob para stdout(suporte a pipe).

az storage blob download -c mycontainer -n myblob --account-name mystorageaccount --account-key myaccountkey

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

Valores aceitos: key, login

--blob-endpoint

--blob-url

A URL completa do ponto de extremidade para o Blob, incluindo o token SAS e o instantâneo, se usado. Pode ser o endpoint primário ou o endpoint secundário, dependendo do .location_mode

--connection-string

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

--container-name -c

O nome do contêiner.

--end-range

Fim do intervalo de bytes a ser usado para baixar uma seção do blob. Se end_range for dado, start_range deve ser fornecido. Os parâmetros start_range e end_range são inclusivos. Ex: start_range=0, end_range=511 baixará os primeiros 512 bytes de blob.

--file -f

Caminho do arquivo para gravar. Se não for especificado, stdout será usado e max_connections será definido como 1.

--if-match

Um valor ETag ou o caractere curinga (*). Especifique esse cabeçalho para executar a operação somente se a ETag do recurso corresponder ao valor especificado.

--if-modified-since

Inicie somente se modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

--if-none-match

--if-unmodified-since

Inicie somente se não tiver sido modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

--lease-id

Necessário se o blob tiver uma concessão ativa.

--max-connections

O número de conexões paralelas com as quais fazer download.

Valor padrão: 2

--name -n

O nome do blob.

--no-progress

Inclua esse sinalizador para desabilitar o relatório de progresso para o comando.

Valor padrão: False

--open-mode

Modo a ser usado ao abrir o arquivo. Observe que especificar apenas acréscimo open_mode impede o download paralelo. Portanto, max_connections deve ser definido como 1 se esse open_mode for usado.

Valor padrão: wb

--overwrite

Substitua um arquivo existente quando especificado. O valor padrão é true.

Valores aceitos: false, true

Valor padrão: True

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

--snapshot

O parâmetro de instantâneo é um valor DateTime opaco que, quando presente, especifica o instantâneo de blob a ser recuperado.

--start-range

Início do intervalo de bytes a ser usado para baixar uma seção do blob. Se nenhum end_range for fornecido, todos os bytes após o start_range serão baixados. Os parâmetros start_range e end_range são inclusivos. Ex: start_range=0, end_range=511 baixará os primeiros 512 bytes de blob.

--tags-condition

Especifique uma cláusula SQL where em marcas de blob para operar somente em blobs com um valor correspondente.

--timeout

Solicite o tempo limite em segundos. Aplica-se a cada chamada para o serviço.

--validate-content

Se true, calcula um hash MD5 para cada parte do blob. O serviço de armazenamento verifica o hash do conteúdo que chegou com o hash que foi enviado. Isso é valioso principalmente para detectar bitflips no fio se usar http em vez de https, pois https (o padrão) já será validado. Observe que esse hash MD5 não é armazenado com o blob. Observe também que, se ativado, o algoritmo com eficiência de memória não será usado porque o cálculo do hash MD5 requer o buffer de blocos inteiros e, ao fazê-lo, anula a finalidade do algoritmo com eficiência de memória.

Valor padrão: False

--version-id

Uma ID de versão de blob opcional. Esse parâmetro é apenas para a conta habilitada para controle de versão.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az storage blob download-batch

Editar

Baixe blobs de um contêiner de blob recursivamente.

az storage blob download-batch --destination
                               --source
                               [--account-key]
                               [--account-name]
                               [--auth-mode {key, login}]
                               [--blob-endpoint]
                               [--connection-string]
                               [--dryrun]
                               [--max-connections]
                               [--no-progress]
                               [--overwrite {false, true}]
                               [--pattern]
                               [--sas-token]

Exemplos

Baixe todos os blobs que terminam com .py

az storage blob download-batch -d . --pattern "*.py" -s mycontainer --account-name mystorageaccount --account-key 00000000

Baixe todos os blobs em um diretório chamado "dir" do contêiner chamado "mycontainer".

az storage blob download-batch -d . -s mycontainer --pattern "dir/*"

Baixe todos os blobs com o formato 'cli-2018-xx-xx.txt' ou 'cli-2019-xx-xx.txt' no contêiner para o caminho atual.

az storage blob download-batch -d . -s mycontainer --pattern "cli-201[89]-??-??.txt"

Baixe todos os blobs com o formato 'cli-201x-xx-xx.txt', exceto cli-2018-xx-xx.txt' e 'cli-2019-xx-xx.txt' no contêiner para o caminho atual.

az storage blob download-batch -d . -s mycontainer --pattern "cli-201[!89]-??-??.txt"

Parâmetros Exigidos

--destination -d

A pasta de destino existente para esta operação de download.

--source -s

O contêiner de blob de onde os arquivos serão baixados.

A origem pode ser a URL do contêiner ou o nome do contêiner. Quando a origem for a URL do contêiner, o nome da conta de armazenamento será analisado da URL.

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

Valores aceitos: key, login

--blob-endpoint

--connection-string

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

--dryrun

Mostre o resumo das operações a serem realizadas em vez de realmente baixar o(s) arquivo(s).

Valor padrão: False

--max-connections

O número de conexões paralelas com as quais fazer download.

Valor padrão: 2

--no-progress

Inclua esse sinalizador para desabilitar o relatório de progresso para o comando.

Valor padrão: False

--overwrite

Substitua um arquivo existente quando especificado. O valor padrão é falso.

Valores aceitos: false, true

Valor padrão: False

--pattern

Quando você usa '*' em --pattern, ele corresponderá a qualquer caractere, incluindo o separador de diretório '/'.

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

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az storage blob exists

Editar

Verifique a existência de um blob em um contêiner.

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

Exemplos

Verifique a existência de um blob em um contêiner. (gerado automaticamente)

az storage blob exists --account-key 00000000 --account-name MyAccount --container-name mycontainer --name MyBlob

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

Valores aceitos: key, login

--blob-endpoint

--blob-url

A URL completa do ponto de extremidade para o Blob, incluindo o token SAS e o instantâneo, se usado. Pode ser o endpoint primário ou o endpoint secundário, dependendo do .location_mode

--connection-string

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

--container-name -c

O nome do contêiner.

--name -n

O nome do blob.

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

--snapshot

O parâmetro snapshot é um valor DateTime opaco que, quando presente, especifica o snapshot.

--timeout

Solicite o tempo limite em segundos. Aplica-se a cada chamada para o serviço.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az storage blob filter

Versão Prévia

Esse comando está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Liste blobs em todos os contêineres cujas marcas correspondam a uma determinada expressão de pesquisa.

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

Parâmetros Exigidos

--tag-filter

A expressão para localizar blobs cujas marcas correspondem à condição especificada. ex. ""yourtagname"='firsttag' e "yourtagname2"='secondtag'".

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

Valores aceitos: key, login

--blob-endpoint

--connection-string

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

--container-name -c

Usado quando você deseja listar blobs em um contêiner especificado.

--sas-token

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

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az storage blob generate-sas

Editar

Gere uma assinatura de acesso compartilhado para o blob.

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

Exemplos

Gere um token sas para um blob com permissões somente leitura.

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob generate-sas -c myycontainer -n MyBlob --permissions r --expiry $end --https-only

Gere um token sas para um blob com intervalo de ip especificado.

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob generate-sas -c myycontainer -n MyBlob --ip "176.134.171.0-176.134.171.255" --permissions r --expiry $end --https-only

Gere uma assinatura de acesso compartilhado para o blob. (gerado automaticamente)

az storage blob generate-sas --account-key 00000000 --account-name MyStorageAccount --container-name mycontainer --expiry 2018-01-01T00:00:00Z --name MyBlob --permissions r

Parâmetros Opcionais

--account-key

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

--account-name

--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 '--auth-mode login' são necessários se esse argumento for especificado.

Valor padrão: False

--auth-mode

Valores aceitos: key, login

--blob-endpoint

--blob-url

A URL completa do ponto de extremidade para o Blob, incluindo o token SAS e o instantâneo, se usado. Pode ser o endpoint primário ou o endpoint secundário, dependendo do .location_mode

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

--container-name -c

O nome do contêiner.

--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 a data e hora UTC (Y-m-d'T'H:M'Z') na qual a SAS se torna inválida. Não use se uma política de acesso armazenada for referenciada com --policy-name que especifica esse valor.

--full-uri

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

Valor padrão: False

--https-only

Permitir apenas 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. Suporta apenas endereços de estilo IPv4.

--name -n

O nome do blob.

--permissions

As permissões que a SAS concede. Valores permitidos: (a)dd (c)reate (d)elete (e)xecute (i)set_immutability_policy (m)ove (r)ead (t)ag (w)rite (x)delete_previous_version (y)permanent_delete. Não use se uma política de acesso armazenada for referenciada com --id que especifica esse valor. Pode ser combinado.

--policy-name

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

--snapshot

Uma ID de instantâneo de blob opcional. Valor DateTime opaco que, quando presente, especifica o instantâneo de blob para conceder permissão.

--start

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

--timeout

Solicite o tempo limite em segundos. Aplica-se a cada chamada para o serviço.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

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

Gere uma assinatura de acesso compartilhado para o blob.

az storage blob generate-sas --container-name
                             --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]
                             [--snapshot]
                             [--start]
                             [--version-id]

Exemplos

Gere um token sas para um blob com permissões somente leitura.

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob generate-sas -c myycontainer -n MyBlob --permissions r --expiry $end --https-only

Gere um token sas para um blob com intervalo de ip especificado.

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob generate-sas -c myycontainer -n MyBlob --ip "176.134.171.0-176.134.171.255" --permissions r --expiry $end --https-only

Gere uma assinatura de acesso compartilhado para o blob. (gerado automaticamente)

az storage blob generate-sas --account-key 00000000 --account-name MyStorageAccount --container-name mycontainer --expiry 2018-01-01T00:00:00Z --name MyBlob --permissions r

Parâmetros Exigidos

--container-name -c

O nome do contêiner.

--name -n

O nome do blob.

Parâmetros Opcionais

--account-key

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

--account-name

--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 '--auth-mode login' são necessários se esse argumento for especificado.

Valor padrão: False

--auth-mode

Valores aceitos: key, login

--blob-endpoint

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

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

--expiry

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

--full-uri

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

Valor padrão: False

--https-only

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

--ip

Especifique um endereço IP ou um intervalo de endereços IP dos quais aceitar solicitações. Se o endereço IP do qual a solicitação se origina não corresponder ao endereço IP ou ao intervalo de endereços especificado no token SAS, a solicitação não será autenticada. Por exemplo, especificar ip=168.1.5.65 ou ip=168.1.5.60-168.1.5.70 na SAS restringe a solicitação a esses endereços IP.

--permissions

As permissões que a SAS concede. Valores permitidos: (a)dd (c)reate (d)elete (x)delete_previous_version (e)xecute (m)ove (p)ermanent_delete (r)ead (s)et_immutability_policy (t)ag (w)rite. Não use se uma política de acesso armazenada for referenciada com --policy-name que especifica esse valor. Pode ser combinado.

--policy-name

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

--snapshot

O parâmetro de instantâneo é um valor DateTime opaco que, quando presente, especifica o instantâneo de blob a ser recuperado.

--start

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

--version-id

Versão Prévia

Uma ID de versão de blob opcional. Esse parâmetro é apenas para a conta habilitada para controle de versão.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az storage blob list

Editar

Listar blobs em um determinado contêiner.

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

Exemplos

Listar todos os blobs de armazenamento em um contêiner cujos nomes começam com 'foo'; corresponderá a nomes como 'foo', 'foobar' e 'foo/bar'

az storage blob list -c mycontainer --prefix foo

Parâmetros Exigidos

--container-name -c

O nome do contêiner.

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

Valores aceitos: key, login

--blob-endpoint

--connection-string

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

--delimiter

Quando a solicitação inclui esse parâmetro, a operação retorna um elemento BlobPrefix na lista de resultados que atua como um espaço reservado para todos os blobs cujos nomes começam com a mesma subcadeia de caracteres até a aparência do caractere delimitador. O delimitador pode ser um único caractere ou uma cadeia de caracteres.

--include

Especifique um ou mais conjuntos de dados adicionais para incluir na resposta. As opções incluem: (c)opy, (d)eleted, (m)etadata, (s)napshots, (v)ersions, (t)ags, (i)mmutabilitypolicy, (l)egalhold, (d)eletedwithversions. Pode ser combinado.

--marker

Um valor de cadeia de caracteres que identifica a parte da lista de contêineres a ser retornada 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 retornou todos os contêineres restantes para 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.

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.

--show-next-marker

Mostrar nextMarker no resultado quando especificado.

--timeout

Solicite o tempo limite em segundos. Aplica-se a cada chamada para o serviço.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az storage blob move

Versão Prévia Preterido

Esse comando está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Esse comando foi descontinuado e será removido em uma versão futura. Em vez disso, use 'az storage fs file move'. Para obter mais informações, acesse https://github.com/Azure/azure-cli/blob/dev/src/azure-cli/azure/cli/command_modules/storage/docs/ADLS%20Gen2.md

Mova um blob em um contêiner de armazenamento.

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

Exemplos

Mova um blob em um contêiner de armazenamento.

az storage blob move -c MyContainer -d DestinationBlobPath -s SourceBlobPath --account-name MyStorageAccount

Parâmetros Exigidos

--container-name -c

O nome do contêiner.

--destination-blob -d

O nome do blob de destino. Deve ser um caminho absoluto sob o contêiner. por exemplo, 'topdir1/dirbar'.

--source-blob -s

O nome do blob de origem. Deve ser um caminho absoluto sob o contêiner. por exemplo, 'topdir1 / dirsubfoo'.

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

Valores aceitos: key, login

--connection-string

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

--lease-id

Opcional. Uma ID de locação para o new_path. O new_path deve ter uma concessão ativa e a ID da concessão deve corresponder.

--sas-token

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

--source-if-match

Opcional. Um valor ETag. Especifique esse cabeçalho para executar a operação de renomeação somente se a ETag da origem corresponder ao valor especificado.

--source-if-modified-since

Opcional. Um valor de data e hora. Especifique esse cabeçalho para executar a operação de renomeação somente se a origem tiver sido modificada desde a data e hora especificadas.

--source-if-none-match

Opcional. Um valor ETag ou o valor curinga especial ("*"). Especifique esse cabeçalho para executar a operação de renomeação somente se a ETag da origem não corresponder ao valor especificado.

--source-if-unmodified-since

Opcional. Um valor de data e hora. Especifique esse cabeçalho para executar a operação de renomeação somente se a origem não tiver sido modificada desde a data e hora especificadas.

--source-lease-id

Opcional. Um ID de locação para o source_path. O source_path deve ter uma concessão ativa e a ID da concessão deve corresponder.

--timeout

Solicite o tempo limite em segundos. Aplica-se a cada chamada para o serviço.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az storage blob query

Editar

Versão Prévia

Esse comando está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Permita que os usuários selecionem/projetem dados de blob ou instantâneo de blob fornecendo expressões de consulta simples.

az storage blob query --query-expression
                      [--account-key]
                      [--account-name]
                      [--auth-mode {key, login}]
                      [--blob-endpoint]
                      [--blob-url]
                      [--connection-string]
                      [--container-name]
                      [--if-match]
                      [--if-modified-since]
                      [--if-none-match]
                      [--if-unmodified-since]
                      [--in-column-separator]
                      [--in-escape-char]
                      [--in-has-header]
                      [--in-line-separator]
                      [--in-quote-char]
                      [--in-record-separator]
                      [--input-format {csv, json}]
                      [--lease-id]
                      [--name]
                      [--out-column-separator]
                      [--out-escape-char]
                      [--out-has-header]
                      [--out-line-separator]
                      [--out-quote-char]
                      [--out-record-separator]
                      [--output-format {csv, json}]
                      [--result-file]
                      [--sas-token]
                      [--tags-condition]
                      [--timeout]

Exemplos

Permita que os usuários selecionem/projetem no blob fornecendo expressões de consulta simples.

az storage blob query -c mycontainer -n myblob --query-expression "SELECT _2 from BlobStorage"

Permita que os usuários selecionem/projetem no blob fornecendo expressões de consulta simples e salvem no arquivo de destino.

az storage blob query -c mycontainer -n myblob --query-expression "SELECT _2 from BlobStorage" --result-file result.csv

Parâmetros Exigidos

--query-expression

A expressão de consulta em SQL. O tamanho máximo da expressão de consulta é 256KiB. Para obter mais informações sobre a sintaxe da expressão, consulte https://docs.microsoft.com/azure/storage/blobs/query-acceleration-sql-reference.

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

Valores aceitos: key, login

--blob-endpoint

--blob-url

A URL completa do ponto de extremidade para o Blob, incluindo o token SAS e o instantâneo, se usado. Pode ser o endpoint primário ou o endpoint secundário, dependendo do .location_mode

--connection-string

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

--container-name -c

O nome do contêiner.

--if-match

Um valor ETag ou o caractere curinga (*). Especifique esse cabeçalho para executar a operação somente se a ETag do recurso corresponder ao valor especificado.

--if-modified-since

Inicie somente se modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

--if-none-match

--if-unmodified-since

Inicie somente se não tiver sido modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

--in-column-separator

A cadeia de caracteres usada para separar colunas.

Valor padrão: ,

--in-escape-char

A cadeia de caracteres usada como um caractere de escape. O padrão é vazio.

--in-has-header

Se os dados do blob incluem cabeçalhos na primeira linha. O valor padrão é False, o que significa que os dados serão retornados incluindo a primeira linha. Se definido como True, os dados serão retornados exclusivos da primeira linha.

Valor padrão: False

--in-line-separator

A cadeia de caracteres usada para separar registros.

Valor padrão:

--in-quote-char

A cadeia de caracteres usada para citar um campo específico.

Valor padrão: "

--in-record-separator

A cadeia de caracteres usada para separar registros.

Valor padrão:

--input-format

Tipo de serialização dos dados atualmente armazenados no blob. O padrão é tratar os dados de blob como dados CSV formatados no dialeto padrão. Os dados de blob serão reformatados de acordo com esse perfil quando o formato de blob for especificado. Se você escolher json, especifique Output Json Text Configuration Arguments de acordo; Se você escolher csv, por favor, especifique Output Delimited Text Configuration Arguments.

Valores aceitos: csv, json

--lease-id

Necessário se o blob tiver uma concessão ativa.

--name -n

O nome do blob.

--out-column-separator

A cadeia de caracteres usada para separar colunas.

Valor padrão: ,

--out-escape-char

A cadeia de caracteres usada como um caractere de escape. O padrão é vazio.

--out-has-header

Valor padrão: False

--out-line-separator

A cadeia de caracteres usada para separar registros.

Valor padrão:

--out-quote-char

A cadeia de caracteres usada para citar um campo específico.

Valor padrão: "

--out-record-separator

A cadeia de caracteres usada para separar registros.

Valor padrão:

--output-format

Tipo de serialização de saída para o fluxo de dados. Por padrão, os dados serão retornados conforme representados no blob. Ao fornecer um formato de saída, os dados do blob serão reformatados de acordo com esse perfil. Se você escolher json, especifique Output Json Text Configuration Arguments de acordo; Se você escolher csv, por favor, especifique Output Delimited Text Configuration Arguments.

Valores aceitos: csv, json

--result-file

Especifique o caminho do arquivo para salvar o resultado.

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

--tags-condition

Especifique uma cláusula SQL where em marcas de blob para operar somente em blobs com um valor correspondente.

--timeout

Solicite o tempo limite em segundos. Aplica-se a cada chamada para o serviço.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az storage blob restore

Editar

Restaure blobs nos intervalos de blobs especificados.

az storage blob restore --account-name
                        --time-to-restore
                        [--blob-range]
                        [--no-wait]
                        [--resource-group]

Exemplos

Restaure blobs em dois intervalos de blobs especificados. Por exemplo, (container1/blob1, container2/blob2) e (container2/blob3.. container2/blob4).

az storage blob restore --account-name mystorageaccount -g MyResourceGroup -t 2020-02-27T03:59:59Z -r container1/blob1 container2/blob2 -r container2/blob3 container2/blob4

Os blobs de restauração nos intervalos de blob especificados do início ao fim da conta.

az storage blob restore --account-name mystorageaccount -g MyResourceGroup -t 2020-02-27T03:59:59Z -r "" ""

Restaure blobs no intervalo de blobs especificado.

time=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob restore --account-name mystorageaccount -g MyResourceGroup -t $time -r container0/blob1 container0/blob2

Restaure blobs no intervalo de blobs especificado sem esperar e consulte o status de restauração de blob com 'az storage account show'.

time=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob restore --account-name mystorageaccount -g MyResourceGroup -t $time -r container0/blob1 container0/blob2 --no-wait

Parâmetros Exigidos

--account-name -n

O nome da conta de armazenamento.

--time-to-restore -t

Restaure o blob para a hora especificada, que deve ser UTC datetime in (Y-m-d'T'H:M:S'Z').

Parâmetros Opcionais

--blob-range -r

Intervalos de blob a serem restaurados. Você precisa de dois valores para especificar start_range e end_range para cada intervalo de blob, por exemplo, -r blob1 blob2. Observação: Vazio significa o início da conta como valor do intervalo inicial e significa o fim da conta para o intervalo final.

--no-wait

Não aguarde a conclusão da operação de execução longa.

Valor padrão: False

--resource-group -g

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

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az storage blob rewrite

Editar

Versão Prévia

Esse comando está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Crie um novo Blob de Blocos em que o conteúdo do blob é lido de uma determinada URL.

O conteúdo de um blob existente é substituído pelo novo blob.

az storage blob rewrite --container-name
                        --name
                        --source-uri
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--blob-endpoint]
                        [--connection-string]
                        [--encryption-scope]
                        [--if-match]
                        [--if-modified-since]
                        [--if-none-match]
                        [--if-unmodified-since]
                        [--lease-id]
                        [--sas-token]
                        [--tags-condition]
                        [--tier {Archive, Cold, Cool, Hot, P10, P15, P20, P30, P4, P40, P50, P6, P60, P70, P80}]
                        [--timeout]

Exemplos

Atualize o escopo de criptografia para blob existente.

az storage blob rewrite --source-uri https://srcaccount.blob.core.windows.net/mycontainer/myblob?<sastoken> --encryption-scope newscope -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000

Parâmetros Exigidos

--container-name -c

O nome do contêiner.

--name -n

O nome do blob.

--source-uri -u

Uma URL de até 2 KB de comprimento que especifica um arquivo ou blob. O valor deve ser codificado em URL como apareceria em um URI de solicitação. Se a fonte estiver em outra conta, a fonte deverá ser pública ou autenticada por meio de uma assinatura de acesso compartilhado. Se a fonte for pública, nenhuma autenticação será necessária.

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

Valores aceitos: key, login

--blob-endpoint

--connection-string

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

--encryption-scope

Um escopo de criptografia predefinido usado para criptografar os dados no serviço. Um escopo de criptografia pode ser criado usando a API de Gerenciamento e referenciado aqui pelo nome. Se um escopo de criptografia padrão tiver sido definido no contêiner, esse valor o substituirá se o escopo no nível do contêiner estiver configurado para permitir substituições. Caso contrário, um erro será gerado.

--if-match

Um valor ETag ou o caractere curinga (*). Especifique esse cabeçalho para executar a operação somente se a ETag do recurso corresponder ao valor especificado.

--if-modified-since

Inicie somente se modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

--if-none-match

--if-unmodified-since

Inicie somente se não tiver sido modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

--lease-id

Necessário se o blob tiver uma concessão ativa. O valor pode ser um objeto BlobLeaseClient ou a ID de concessão como uma cadeia de caracteres.

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

--tags-condition

Especifique uma cláusula SQL where em marcas de blob para operar somente em blobs com um valor correspondente.

--tier

Um valor de camada de blob padrão para definir o blob. Para esta versão da biblioteca, isso só é aplicável a blobs de blocos em contas de armazenamento padrão.

Valores aceitos: Archive, Cold, Cool, Hot, P10, P15, P20, P30, P4, P40, P50, P6, P60, P70, P80

--timeout

Solicite o tempo limite em segundos. Aplica-se a cada chamada para o serviço.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az storage blob set-legal-hold

Editar

Defina a retenção legal do blob.

az storage blob set-legal-hold --container-name
                               --legal-hold {false, true}
                               --name
                               [--account-key]
                               [--account-name]
                               [--auth-mode {key, login}]
                               [--blob-endpoint]
                               [--connection-string]
                               [--sas-token]
                               [--timeout]

Exemplos

Configure a retenção legal do blob.

az storage blob set-legal-hold --legal-hold -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000

Limpe a retenção legal da bolha.

az storage blob set-legal-hold --legal-hold false -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000

Parâmetros Exigidos

--container-name -c

O nome do contêiner.

--legal-hold

Especificado se uma retenção legal deve ser definida no blob.

Valores aceitos: false, true

--name -n

O nome do blob.

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

Valores aceitos: key, login

--blob-endpoint

--connection-string

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

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

--timeout

Solicite o tempo limite em segundos. Aplica-se a cada chamada para o serviço.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az storage blob set-tier

Editar

Defina as camadas de bloco ou página no blob.

Para blob de blocos, esse comando só dá suporte ao blob de blocos em contas de armazenamento padrão. Para blob de páginas, esse comando só dá suporte a blobs de páginas em contas premium.

az storage blob set-tier --tier
                         [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--blob-endpoint]
                         [--blob-url]
                         [--connection-string]
                         [--container-name]
                         [--name]
                         [--rehydrate-priority {High, Standard}]
                         [--sas-token]
                         [--timeout]
                         [--type {block, page}]

Exemplos

Defina as camadas de bloco ou página no blob. (gerado automaticamente)

az storage blob set-tier --account-key 00000000 --account-name MyAccount --container-name mycontainer --name MyBlob --tier P10

Parâmetros Exigidos

--tier

O valor da camada para definir o blob.

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

Valores aceitos: key, login

--blob-endpoint

--blob-url

A URL completa do ponto de extremidade para o Blob, incluindo o token SAS e o instantâneo, se usado. Pode ser o endpoint primário ou o endpoint secundário, dependendo do .location_mode

--connection-string

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

--container-name -c

O nome do contêiner.

--name -n

O nome do blob.

--rehydrate-priority -r

Versão Prévia

Indique a prioridade com a qual reidratar um blob arquivado. A prioridade pode ser definida em um blob apenas uma vez, o valor padrão é Standard.

Valores aceitos: High, Standard

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

--timeout

O parâmetro de tempo limite é expresso em segundos. Esse método pode fazer várias chamadas para o serviço do Azure e o tempo limite será aplicado a cada chamada individualmente.

--type -t

O tipo de blob.

Valores aceitos: block, page

Valor padrão: block

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az storage blob set-tier (storage-blob-preview extensão)

Defina as camadas de bloco ou página no blob.

Para blob de blocos, esse comando só dá suporte ao blob de blocos em contas de armazenamento padrão. Para blob de páginas, esse comando só dá suporte a blobs de páginas em contas premium.

az storage blob set-tier --tier
                         [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--blob-endpoint]
                         [--blob-url]
                         [--connection-string]
                         [--container-name]
                         [--name]
                         [--rehydrate-priority {High, Standard}]
                         [--sas-token]
                         [--tags-condition]
                         [--timeout]
                         [--type {block, page}]
                         [--version-id]

Exemplos

Defina as camadas de bloco ou página no blob. (gerado automaticamente)

az storage blob set-tier --account-key 00000000 --account-name MyAccount --container-name mycontainer --name MyBlob --tier P10

Parâmetros Exigidos

--tier

O valor da camada para definir o blob.

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

Valores aceitos: key, login

--blob-endpoint

--blob-url

A URL completa do ponto de extremidade para o Blob, incluindo o token SAS e o instantâneo, se usado. Pode ser o endpoint primário ou o endpoint secundário, dependendo do .location_mode

--connection-string

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

--container-name -c

O nome do contêiner.

--name -n

O nome do blob.

--rehydrate-priority -r

Versão Prévia

Indique a prioridade com a qual reidratar um blob arquivado.

Valores aceitos: High, Standard

--sas-token

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

--tags-condition

Especifique uma cláusula SQL where em marcas de blob para operar somente em blobs com um valor correspondente.

--timeout

O parâmetro de tempo limite é expresso em segundos. Esse método pode fazer várias chamadas para o serviço do Azure e o tempo limite será aplicado a cada chamada individualmente.

--type -t

O tipo de blob.

Valores aceitos: block, page

Valor padrão: block

--version-id

Uma ID de versão de blob opcional. Esse parâmetro é apenas para a conta habilitada para controle de versão.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az storage blob show

Editar

Obtenha os detalhes de um blob.

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

Exemplos

Mostrar todas as propriedades de um blob.

az storage blob show -c mycontainer -n MyBlob

Obter os detalhes de um blob (gerado automaticamente)

az storage blob show --account-name mystorageccount --account-key 00000000 --container-name mycontainer --name MyBlob

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

Valores aceitos: key, login

--blob-endpoint

--blob-url

A URL completa do ponto de extremidade para o Blob, incluindo o token SAS e o instantâneo, se usado. Pode ser o endpoint primário ou o endpoint secundário, dependendo do .location_mode

--connection-string

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

--container-name -c

O nome do contêiner.

--if-match

Um valor ETag ou o caractere curinga (*). Especifique esse cabeçalho para executar a operação somente se a ETag do recurso corresponder ao valor especificado.

--if-modified-since

Inicie somente se modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

--if-none-match

--if-unmodified-since

Inicie somente se não tiver sido modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

--lease-id

Necessário se o blob tiver uma concessão ativa.

--name -n

O nome do blob.

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

--snapshot

O parâmetro de instantâneo é um valor DateTime opaco que, quando presente, especifica o instantâneo de blob a ser recuperado.

--tags-condition

Especifique uma cláusula SQL where em marcas de blob para operar somente em blobs com um valor correspondente.

--timeout

Solicite o tempo limite em segundos. Aplica-se a cada chamada para o serviço.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az storage blob show (storage-blob-preview extensão)

Obtenha os detalhes de um blob.

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

Exemplos

Mostrar todas as propriedades de um blob.

az storage blob show -c mycontainer -n MyBlob

Obter os detalhes de um blob (gerado automaticamente)

az storage blob show --account-name mystorageccount --account-key 00000000 --container-name mycontainer --name MyBlob

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

Valores aceitos: key, login

--blob-endpoint

--blob-url

A URL completa do ponto de extremidade para o Blob, incluindo o token SAS e o instantâneo, se usado. Pode ser o endpoint primário ou o endpoint secundário, dependendo do .location_mode

--connection-string

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

--container-name -c

O nome do contêiner.

--if-match

Um valor ETag ou o caractere curinga (*). Especifique esse cabeçalho para executar a operação somente se a ETag do recurso corresponder ao valor especificado.

--if-modified-since

Inicie somente se modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

--if-none-match

--if-unmodified-since

Inicie somente se não tiver sido modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

--lease-id

Necessário se o blob tiver uma concessão ativa.

--name -n

O nome do blob.

--sas-token

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

--snapshot

O parâmetro de instantâneo é um valor DateTime opaco que, quando presente, especifica o instantâneo de blob a ser recuperado.

--tags-condition

Especifique uma cláusula SQL where em marcas de blob para operar somente em blobs com um valor correspondente.

--timeout

Solicite o tempo limite em segundos. Aplica-se a cada chamada para o serviço.

--version-id

Versão Prévia

Uma ID de versão de blob opcional. Esse parâmetro é apenas para a conta habilitada para controle de versão.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az storage blob snapshot

Editar

Cria um instantâneo do blob.

Um instantâneo é uma versão somente leitura de um blob capturada em um momento no tempo. Ele pode ser lido, copiado ou excluído, mas não modificado. Os instantâneos fornecem uma maneira de fazer backup de um blob da maneira como ele aparece em um momento específico. Um instantâneo de um blob tem o mesmo nome que o blob base do qual o instantâneo é tirado, com um valor DateTime acrescentado para indicar a hora em que o instantâneo foi tirado.

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

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

Valores aceitos: key, login

--blob-endpoint

--blob-url

A URL completa do ponto de extremidade para o Blob, incluindo o token SAS e o instantâneo, se usado. Pode ser o endpoint primário ou o endpoint secundário, dependendo do .location_mode

--connection-string

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

--container-name -c

O nome do contêiner.

--if-match

Um valor ETag ou o caractere curinga (*). Especifique esse cabeçalho para executar a operação somente se a ETag do recurso corresponder ao valor especificado.

--if-modified-since

Inicie somente se modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

--if-none-match

--if-unmodified-since

Inicie somente se não tiver sido modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

--lease-id

Necessário se o blob tiver uma concessão ativa.

--metadata

Metadados em pares chave=valor separados por espaço. Isso substitui todos os metadados existentes.

--name -n

O nome do blob.

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

--tags-condition

Especifique uma cláusula SQL where em marcas de blob para operar somente em blobs com um valor correspondente.

--timeout

Solicite o tempo limite em segundos. Aplica-se a cada chamada para o serviço.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az storage blob sync

Editar

Versão Prévia

Esse comando está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Sincronize blobs recursivamente com um contêiner de blob de armazenamento.

az storage blob sync --container
                     --source
                     [--account-key]
                     [--account-name]
                     [--auth-mode {key, login}]
                     [--connection-string]
                     [--delete-destination {false, prompt, true}]
                     [--destination]
                     [--exclude-path]
                     [--exclude-pattern]
                     [--include-pattern]
                     [--sas-token]
                     [<EXTRA_OPTIONS>]

Exemplos

Sincronize um único blob com um contêiner.

az storage blob sync -c mycontainer -s "path/to/file" -d NewBlob

Sincronize um diretório com um contêiner.

az storage blob sync -c mycontainer --account-name mystorageccount --account-key 00000000 -s "path/to/directory"

Sincronize um diretório com um contêiner com azcopy options passagem (nesse caso, limitando a largura de banda de carregamento a 20 MBit/s).

az storage blob sync -c mycontainer --account-name mystorageccount --account-key 00000000 -s "path/to/directory" -- --cap-mbps=20

Parâmetros Exigidos

--container -c

O contêiner de destino de sincronização.

--source -s

O caminho do arquivo de origem para sincronizar.

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

Valores aceitos: key, login

--connection-string

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

--delete-destination

Define se os arquivos extras do destino que não estão presentes na origem devem ser excluídos. Pode ser definido como true, false ou prompt. Se definida como prompt, uma pergunta será feita ao usuário antes de agendar arquivos e blobs para exclusão.

Valores aceitos: false, prompt, true

Valor padrão: true

--destination -d

O caminho de destino que será anexado ao nome do blob.

--exclude-path

Exclua esses caminhos. Essa opção não dá suporte a caracteres curinga (*). Verifica o prefixo do caminho relativo. Por exemplo: myFolder; myFolder/subDirName/file.pdf.

--exclude-pattern

Exclua esses arquivos onde o nome corresponde à lista de padrões. Por exemplo: .jpg;. Pdf; exactName. Essa opção dá suporte a caracteres curinga (*).

--include-pattern

Inclua apenas esses arquivos em que o nome corresponda à lista de padrões. Por exemplo: .jpg;. Pdf; exactName. Essa opção dá suporte a caracteres curinga (*).

--sas-token

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

<EXTRA_OPTIONS>

Habilitação

Outras opções que serão passadas para azcopy como está. Por favor, coloque todas as opções extras após um --.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az storage blob undelete

Editar

Restaure o blob ou instantâneo 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. A tentativa de recuperar um blob ou instantâneo que não seja excluído temporariamente será bem-sucedida sem nenhuma alteração.

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

Exemplos

Recuperar um blob.

az storage blob undelete -c mycontainer -n MyBlob

Recuperar um blob usando credenciais de logon.

az storage blob undelete -c mycontainer -n MyBlob --account-name mystorageaccount --auth-mode login

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

Valores aceitos: key, login

--blob-endpoint

--blob-url

A URL completa do ponto de extremidade para o Blob, incluindo o token SAS e o instantâneo, se usado. Pode ser o endpoint primário ou o endpoint secundário, dependendo do .location_mode

--connection-string

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

--container-name -c

O nome do contêiner.

--name -n

O nome do blob.

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

--timeout

Solicite o tempo limite em segundos. Aplica-se a cada chamada para o serviço.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az storage blob update

Editar

Define as propriedades do sistema no blob.

Se uma propriedade for definida para o content_settings, todas as propriedades serão substituídas.

az storage blob update --container-name
                       --name
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--blob-endpoint]
                       [--clear-content-settings {false, true}]
                       [--connection-string]
                       [--content-cache]
                       [--content-disposition]
                       [--content-encoding]
                       [--content-language]
                       [--content-md5]
                       [--content-type]
                       [--if-match]
                       [--if-modified-since]
                       [--if-none-match]
                       [--if-unmodified-since]
                       [--lease-id]
                       [--sas-token]
                       [--tags-condition]
                       [--timeout]

Parâmetros Exigidos

--container-name -c

O nome do contêiner.

--name -n

O nome do blob.

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

Valores aceitos: key, login

--blob-endpoint

--clear-content-settings

Se esse sinalizador estiver definido, se qualquer uma ou mais das seguintes propriedades (--content-cache-control, --content-disposition, --content-encoding, --content-language, --content-md5, --content-type) estiverem definidas, todas essas propriedades serão definidas juntas. Se um valor não for fornecido para uma determinada propriedade quando pelo menos uma das propriedades listadas abaixo for definida, essa propriedade será desmarcada.

Valores aceitos: false, true

--connection-string

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

--content-cache --content-cache-control

A cadeia de caracteres de controle de cache.

--content-disposition

Transmite informações adicionais sobre como processar a carga útil da resposta e também pode ser usado para anexar metadados adicionais.

--content-encoding

O tipo de codificação de conteúdo.

--content-language

A linguagem do conteúdo.

--content-md5

O hash MD5 do conteúdo.

--content-type

O tipo MIME de conteúdo.

--if-match

Um valor ETag ou o caractere curinga (*). Especifique esse cabeçalho para executar a operação somente se a ETag do recurso corresponder ao valor especificado.

--if-modified-since

Inicie somente se modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

--if-none-match

--if-unmodified-since

Inicie somente se não tiver sido modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

--lease-id

Necessário se o blob 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.

--tags-condition

Especifique uma cláusula SQL where em marcas de blob para operar somente em blobs com um valor correspondente.

--timeout

Solicite o tempo limite em segundos. Aplica-se a cada chamada para o serviço.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az storage blob upload

Editar

Carregue um arquivo em um blob de armazenamento.

Crie um novo blob de um caminho de arquivo ou atualize o conteúdo de um blob existente com agrupamento automático e notificações de progresso.

az storage blob upload [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--blob-endpoint]
                       [--blob-url]
                       [--connection-string]
                       [--container-name]
                       [--content-cache]
                       [--content-disposition]
                       [--content-encoding]
                       [--content-language]
                       [--content-md5]
                       [--content-type]
                       [--data]
                       [--encryption-scope]
                       [--file]
                       [--if-match]
                       [--if-modified-since]
                       [--if-none-match]
                       [--if-unmodified-since]
                       [--lease-id]
                       [--length]
                       [--max-connections]
                       [--maxsize-condition]
                       [--metadata]
                       [--name]
                       [--no-progress]
                       [--overwrite {false, true}]
                       [--sas-token]
                       [--socket-timeout]
                       [--tags]
                       [--tags-condition]
                       [--tier]
                       [--timeout]
                       [--type {append, block, page}]
                       [--validate-content]

Exemplos

Carregar em um blob.

az storage blob upload -f /path/to/file -c mycontainer -n MyBlob

Carregar em um blob com blob sas url.

az storage blob upload -f /path/to/file --blob-url https://mystorageaccount.blob.core.windows.net/mycontainer/myblob?sv=2019-02-02&st=2020-12-22T07%3A07%3A29Z&se=2020-12-23T07%3A07%3A29Z&sr=b&sp=racw&sig=redacted

Carregue um arquivo em um blob de armazenamento. (gerado automaticamente)

az storage blob upload --account-name mystorageaccount --account-key 0000-0000 --container-name mycontainer --file /path/to/file --name myblob

Carregue uma cadeia de caracteres em um blob.

az storage blob upload --data "teststring" -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000

Faça upload para um pipe de passagem.

echo $data | az storage blob upload --data @- -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

Valores aceitos: key, login

--blob-endpoint

--blob-url

A URL completa do ponto de extremidade para o Blob, incluindo o token SAS e o instantâneo, se usado. Pode ser o endpoint primário ou o endpoint secundário, dependendo do .location_mode

--connection-string

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

--container-name -c

O nome do contêiner.

--content-cache --content-cache-control

A cadeia de caracteres de controle de cache.

--content-disposition

Transmite informações adicionais sobre como processar a carga útil da resposta e também pode ser usado para anexar metadados adicionais.

--content-encoding

O tipo de codificação de conteúdo.

--content-language

A linguagem do conteúdo.

--content-md5

O hash MD5 do conteúdo.

--content-type

O tipo MIME de conteúdo.

--data

Versão Prévia

Os dados de blob a serem carregados.

--encryption-scope

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

--file -f

Caminho do arquivo a ser carregado como o conteúdo do blob.

--if-match

Um valor ETag ou o caractere curinga (*). Especifique esse cabeçalho para executar a operação somente se a ETag do recurso corresponder ao valor especificado.

--if-modified-since

Inicie somente se modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

--if-none-match

--if-unmodified-since

Inicie somente se não tiver sido modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

--lease-id

Necessário se o blob tiver uma concessão ativa.

--length

Versão Prévia

Número de bytes a serem lidos do fluxo. Isso é opcional, mas deve ser fornecido para um desempenho ideal. Coopere com --data.

--max-connections

Número máximo de conexões paralelas a serem usadas quando o tamanho do blob exceder 64 MB.

Valor padrão: 2

--maxsize-condition

O comprimento máximo em bytes permitido para um blob de acréscimo.

--metadata

Metadados em pares chave=valor separados por espaço. Isso substitui todos os metadados existentes.

--name -n

O nome do blob.

--no-progress

Inclua esse sinalizador para desabilitar o relatório de progresso para o comando.

Valor padrão: False

--overwrite

Se o blob a ser carregado deve substituir os dados atuais. Se for True, a operação de carregamento de blob substituirá os dados existentes. Se definido como False, a operação falhará com ResourceExistsError. A exceção acima é com os tipos de blob Append: se definido como False e os dados já existirem, um erro não será gerado e os dados serão acrescentados ao blob existente. Se definido overwrite=True, o blob de acréscimo existente será excluído e um novo será criado. Usa False como padrão.

Valores aceitos: false, true

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

--socket-timeout

O tempo limite do soquete (segundos), usado pelo serviço para regular o fluxo de dados.

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as tags existentes.

--tags-condition

Especifique uma cláusula SQL where em marcas de blob para operar somente em blobs com um valor correspondente.

--tier

O valor da camada para definir o blob. Para o blob de páginas, a camada se correlaciona com o tamanho do blob e o número de IOPS permitidos. Os valores possíveis são P10, P15, P20, P30, P4, P40, P50, P6, P60, P70, P80 e isso só é aplicável a blobs de páginas em contas de armazenamento premium; Para blob de blocos, os valores possíveis são Archive, Cold, Cool e Hot. Isso só é aplicável a blobs de blocos em contas de armazenamento padrão.

--timeout

Solicite o tempo limite em segundos. Aplica-se a cada chamada para o serviço.

--type -t

O padrão é 'page' para arquivos *.vhd ou 'block' caso contrário.

Valores aceitos: append, block, page

--validate-content

Especifique que um hash MD5 deve ser calculado para cada parte do blob e verificado pelo serviço quando a parte chegar.

Valor padrão: False

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az storage blob upload-batch

Editar

Carregue arquivos de um diretório local para um contêiner de blob.

az storage blob upload-batch --destination
                             --source
                             [--account-key]
                             [--account-name]
                             [--auth-mode {key, login}]
                             [--blob-endpoint]
                             [--connection-string]
                             [--content-cache]
                             [--content-disposition]
                             [--content-encoding]
                             [--content-language]
                             [--content-md5]
                             [--content-type]
                             [--destination-path]
                             [--dryrun]
                             [--if-match]
                             [--if-modified-since]
                             [--if-none-match]
                             [--if-unmodified-since]
                             [--lease-id]
                             [--max-connections]
                             [--maxsize-condition]
                             [--metadata]
                             [--no-progress]
                             [--overwrite {false, true}]
                             [--pattern]
                             [--sas-token]
                             [--tags]
                             [--tags-condition]
                             [--tier]
                             [--timeout]
                             [--type {append, block, page}]
                             [--validate-content]

Exemplos

Carregue todos os arquivos que terminam com .py a menos que o blob exista e tenha sido modificado desde a data determinada.

az storage blob upload-batch -d mycontainer --account-name mystorageaccount --account-key 00000000 -s <path-to-directory> --pattern "*.py" --if-unmodified-since 2018-08-27T20:51Z

Carregue todos os arquivos do diretório de caminho local para um contêiner chamado "mycontainer".

az storage blob upload-batch -d mycontainer -s <path-to-directory>

Carregue todos os arquivos com o formato 'cli-2018-xx-xx.txt' ou 'cli-2019-xx-xx.txt' no diretório de caminho local.

az storage blob upload-batch -d mycontainer -s <path-to-directory> --pattern "cli-201[89]-??-??.txt"

Carregue todos os arquivos com o formato 'cli-201x-xx-xx.txt', exceto cli-2018-xx-xx.txt' e 'cli-2019-xx-xx.txt' em um contêiner.

az storage blob upload-batch -d mycontainer -s <path-to-directory> --pattern "cli-201[!89]-??-??.txt"

Parâmetros Exigidos

--destination -d

O contêiner de blob em que os arquivos serão carregados.

O destino pode ser a URL do contêiner ou o nome do contêiner. Quando o destino for a URL do contêiner, o nome da conta de armazenamento será analisado da URL.

--source -s

O diretório onde os arquivos a serem carregados estão localizados.

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

Valores aceitos: key, login

--blob-endpoint

--connection-string

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

--content-cache --content-cache-control

A cadeia de caracteres de controle de cache.

--content-disposition

Transmite informações adicionais sobre como processar a carga útil da resposta e também pode ser usado para anexar metadados adicionais.

--content-encoding

O tipo de codificação de conteúdo.

--content-language

A linguagem do conteúdo.

--content-md5

O hash MD5 do conteúdo.

--content-type

O tipo MIME de conteúdo.

--destination-path

O caminho de destino que será anexado ao nome do blob.

--dryrun

Mostre o resumo das operações a serem realizadas em vez de realmente carregar o(s) arquivo(s).

Valor padrão: False

--if-match

Um valor ETag ou o caractere curinga (*). Especifique esse cabeçalho para executar a operação somente se a ETag do recurso corresponder ao valor especificado.

--if-modified-since

Inicie somente se modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

--if-none-match

Um valor ETag ou o caractere curinga (*).

--if-unmodified-since

Inicie somente se não tiver sido modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

--lease-id

A ID de concessão ativa para o blob.

--max-connections

Número máximo de conexões paralelas a serem usadas quando o tamanho do blob exceder 64 MB.

Valor padrão: 2

--maxsize-condition

O comprimento máximo em bytes permitido para um blob de acréscimo.

--metadata

Metadados em pares chave=valor separados por espaço. Isso substitui todos os metadados existentes.

--no-progress

Inclua esse sinalizador para desabilitar o relatório de progresso para o comando.

Valor padrão: False

--overwrite

Valores aceitos: false, true

--pattern

Quando você usa '*' em --pattern, ele corresponderá a qualquer caractere, incluindo o separador de diretório '/'.

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

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as tags existentes.

--tags-condition

Especifique uma cláusula SQL where em marcas de blob para operar somente em blobs com um valor correspondente.

--tier

--timeout

Solicite o tempo limite em segundos. Aplica-se a cada chamada para o serviço.

--type -t

O padrão é 'page' para arquivos *.vhd ou 'block' caso contrário. A configuração substituirá os tipos de blob para cada arquivo.

Valores aceitos: append, block, page

--validate-content

Especifica que um hash MD5 deve ser calculado para cada parte do blob e verificado pelo serviço quando a parte chegar.

Valor padrão: False

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az storage blob url

Editar

Crie a url para acessar um blob.

az storage blob url --container-name
                    --name
                    [--account-key]
                    [--account-name]
                    [--auth-mode {key, login}]
                    [--blob-endpoint]
                    [--connection-string]
                    [--protocol {http, https}]
                    [--sas-token]
                    [--snapshot]

Exemplos

Criar a url para acessar um blob (gerado automaticamente)

az storage blob url --connection-string $connectionString --container-name container1 --name blob1

Criar a url para acessar um blob (gerado automaticamente)

az storage blob url --account-name storageacct --account-key 00000000 --container-name container1 --name blob1

Parâmetros Exigidos

--container-name -c

O nome do contêiner.

--name -n

O nome do blob.

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

Valores aceitos: key, login

--blob-endpoint

--connection-string

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

--protocol

Protocolo a ser usado.

Valores aceitos: http, https

Valor padrão: https

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

--snapshot

Um valor de string que identifica exclusivamente o instantâneo. O valor desse parâmetro de consulta indica a versão do instantâneo.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

Compartilhar via

az storage blob

Comandos

az storage blob delete

Exemplos

Parâmetros Opcionais

az storage blob delete (storage-blob-preview extensão)

Exemplos

Parâmetros Opcionais

az storage blob delete-batch

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az storage blob download

Exemplos

Parâmetros Opcionais

az storage blob download-batch

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az storage blob exists

Exemplos

Parâmetros Opcionais

az storage blob filter

Parâmetros Exigidos

Parâmetros Opcionais

az storage blob generate-sas

Exemplos

Parâmetros Opcionais

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

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az storage blob list

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az storage blob move

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az storage blob query

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az storage blob restore

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az storage blob rewrite

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az storage blob set-legal-hold

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az storage blob set-tier

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az storage blob set-tier (storage-blob-preview extensão)

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az storage blob show

Exemplos

Parâmetros Opcionais

az storage blob show (storage-blob-preview extensão)

Exemplos

Parâmetros Opcionais

az storage blob snapshot

Parâmetros Opcionais

az storage blob sync

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az storage blob undelete

Exemplos

Parâmetros Opcionais