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	Pré-visualização e preterido
az storage blob access set	Defina as propriedades de controle de acesso de um blob.	Extensão	Pré-visualização e preterido
az storage blob access show	Mostrar as propriedades de controle de acesso de um blob.	Extensão	Pré-visualização e preterido
az storage blob access update	Atualize as propriedades de controle de acesso de um blob.	Extensão	Pré-visualização e 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	Anular 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 snapshot para exclusão.	Núcleo	GA
az storage blob delete (storage-blob-preview extensão)	Marque um blob ou snapshot 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 de conta de armazenamento.	Extensão	Pré-visualização e 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 preterido
az storage blob directory access set	Defina as propriedades de controle de acesso de um diretório.	Extensão	Pré-visualização e preterido
az storage blob directory access show	Mostrar as propriedades de controle de acesso de um diretório.	Extensão	Pré-visualização e preterido
az storage blob directory access update	Atualize as propriedades de controle de acesso de um diretório.	Extensão	Pré-visualização e preterido
az storage blob directory create	Crie um diretório de blob de armazenamento em um contêiner de armazenamento.	Extensão	Pré-visualização e preterido
az storage blob directory delete	Exclua um diretório de blob de armazenamento em um contêiner de armazenamento.	Extensão	Pré-visualização e preterido
az storage blob directory download	Baixar blobs para um caminho de arquivo local.	Extensão	Pré-visualização e preterido
az storage blob directory exists	Verifique a existência de um diretório de blob em um contêiner de armazenamento.	Extensão	Pré-visualização e preterido
az storage blob directory list	Listar blobs e subdiretórios de blob em um diretório de armazenamento.	Extensão	Pré-visualização e preterido
az storage blob directory metadata	Gerencia metadados do diretório.	Extensão	Pré-visualização e preterido
az storage blob directory metadata show	Mostrar todos os metadados definidos pelo usuário para o diretório de blob especificado.	Extensão	Pré-visualização e 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	Pré-visualização e 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	Pré-visualização e preterido
az storage blob directory show	Mostrar as propriedades de um diretório de blob de armazenamento em um contêiner de armazenamento.	Extensão	Pré-visualização e preterido
az storage blob directory upload	Carregue blobs ou subdiretórios em um diretório de blob de armazenamento.	Extensão	Pré-visualização e preterido
az storage blob download	Baixe 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	Listar blobs em todos os contêineres cujas marcas correspondem 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 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	Quebre a concessão, se o contêiner ou blob tiver uma locaçã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 a locação.	Núcleo	GA
az storage blob lease renew	Renovar o contrato de locação.	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	Retornar 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	Mover um blob em um contêiner de armazenamento.	Extensão	Pré-visualização e preterido
az storage blob query	Permitir que os usuários selecionem/projetem dados de instantâneo de blob ou blob fornecendo expressões de consulta simples.	Núcleo	Visualizar
az storage blob restore	Restaure blobs nos intervalos de blob especificados.	Núcleo	GA
az storage blob rewrite	Crie um novo Blob de Blocos onde 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	Mostrar a política de exclusão de 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 de 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	Definir retenção legal de 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 tags de blob.	Extensão	Visualizar
az storage blob tag list	Obtenha tags em um blob ou versão específica de blob ou snapshot.	Extensão	Visualizar
az storage blob tag set	Defina tags em uma versão de blob ou blob específica, mas não em snapshot.	Extensão	Visualizar
az storage blob undelete	Restaure o blob ou snapshot excluído suavemente.	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 snapshot 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 relacionado: 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 de 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 showo . Variável de ambiente: AZURE_STORAGE_SERVICE_ENDPOINT.

--blob-url

A URL de ponto de extremidade completa para o Blob, incluindo token SAS e instantâneo, se usado. Esse pode ser o ponto de extremidade primário ou o ponto de extremidade 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 snapshots associados. Os valores incluem: "only": exclui somente 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 o ETag do recurso corresponder ao valor especificado.

--if-modified-since

Iniciar 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 o 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 ela existir.

--if-unmodified-since

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

--lease-id

Obrigatório se o blob tiver uma concessão ativa.

--name -n

O nome do blob.

--sas-token

Uma assinatura de acesso compartilhado (SAS). 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 instantâneo de blob a ser excluído.

--tags-condition

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

--timeout

Tempo limite da solicitação 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 snapshot 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

--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 snapshots 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 o ETag do recurso corresponder ao valor especificado.

--if-modified-since

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

--if-none-match

--if-unmodified-since

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

--lease-id

Obrigatório se o blob tiver uma concessão ativa.

--name -n

O nome do blob.

--sas-token

Uma assinatura de acesso compartilhado (SAS). Deve ser usado em conjunto com o nome da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_SAS_TOKEN.

--snapshot

O parâmetro snapshot é 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 tags de blob para operar somente em blobs com um valor correspondente.

--timeout

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

--version-id

Um 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 de onde 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 a partir 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 snapshots associados.

valores aceitos: include, only

--dryrun

Mostre o resumo das operações a serem executadas 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. Assim, 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 o ETag do recurso corresponder ao valor especificado.

--if-modified-since

Iniciar 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 o 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 ela existir.

--if-unmodified-since

Iniciar somente se não for 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 arquivos globbing 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 assinatura de acesso compartilhado (SAS). 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

Tempo limite da solicitação 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

Baixe 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

--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 start_range e end_range params 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 o ETag do recurso corresponder ao valor especificado.

--if-modified-since

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

--if-none-match

--if-unmodified-since

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

--lease-id

Obrigató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 somente acrescentar 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

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

valores aceitos: false, true

valor padrão: True

--sas-token

Uma assinatura de acesso compartilhado (SAS). 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 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 nenhuma end_range for dada, todos os bytes após o start_range serão baixados. Os start_range e end_range params 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 tags de blob para operar somente em blobs com um valor correspondente.

--timeout

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

--validate-content

Se true, calcula um hash MD5 para cada bloco do blob. O serviço de armazenamento verifica o hash do conteúdo que chegou com o hash que foi enviado. Isso é principalmente valioso para detectar bitflips no fio se o uso de http em vez de https, como https (o padrão), já será validado. Observe que esse hash MD5 não é armazenado com o blob. Observe também que, se habilitado, o algoritmo de eficiência de memória não será usado porque a computação do hash MD5 requer o armazenamento em buffer de blocos inteiros, e isso derrota o propósito do algoritmo de eficiência de memória.

valor padrão: False

--version-id

Um 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 a partir 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

Substituir 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 assinatura de acesso compartilhado (SAS). 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

--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 assinatura de acesso compartilhado (SAS). 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 instantâneo.

--timeout

Tempo limite da solicitação 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

Este comando está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Listar blobs em todos os contêineres cujas marcas correspondem 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 assinatura de acesso compartilhado (SAS). 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 o SAS assinado 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

--cache-control

Valor de 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 de cabeçalho de resposta para Content-Disposition quando o recurso é acessado usando essa assinatura de acesso compartilhado.

--content-encoding

Valor de cabeçalho de resposta para Codificação de Conteúdo 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 de 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/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 armazenado 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

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

--ip

Especifica o endereço IP ou o intervalo de endereços IP a partir do qual aceitar solicitações. Suporta apenas endereços de estilo IPv4.

--name -n

O nome do blob.

--permissions

As permissões que o 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 armazenado for referenciada com --id que especifica esse valor. Pode ser combinado.

--policy-name

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

--snapshot

Um ID de instantâneo de blob opcional. Valor DateTime opaco que, quando presente, especifica o instantâneo de blob a ser concedido.

--start

Especifica a data/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 armazenado for referenciada com --policy-name que especifica esse valor. Padrão para a hora da solicitação.

--timeout

Tempo limite da solicitação 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 o SAS assinado 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 de 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 Codificação de Conteúdo quando o recurso é acessado usando essa assinatura de acesso compartilhado.

--content-language

Valor de 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/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 armazenado 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

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

--ip

Especifique um endereço IP ou um intervalo de endereços IP a partir do qual 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 no SAS restringe a solicitação a esses endereços IP.

--permissions

As permissões que o 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 armazenado for referenciada com --policy-name que especifica esse valor. Pode ser combinado.

--policy-name

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

--snapshot

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

--start

Especifica a data/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 armazenado for referenciada com --id que especifica esse valor. Padrão para a hora da solicitação.

--version-id

Versão Prévia

Um 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'; combinará 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 a serem incluídos 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 serem retornados com a próxima operação de listagem. A operação retorna o valor NextMarker dentro do corpo da resposta se a operação de listagem não retornar todos os contêineres restantes a serem listados com a página atual. Se especificado, este gerador começará a retornar resultados do ponto onde 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 devolver tudo.

valor padrão: 5000

--prefix

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

--sas-token

Uma assinatura de acesso compartilhado (SAS). 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

Tempo limite da solicitação 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

O grupo de comando 'az storage' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Este comando foi preterido e será removido em versões futuras. 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

Mover 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

Mover 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 concessão para o new_path. O new_path deve ter uma concessão ativa e o ID da concessão deve corresponder.

--sas-token

Uma assinatura de acesso compartilhado (SAS). 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 o 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 o 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. Uma ID de concessão para o source_path. O source_path deve ter uma concessão ativa e o ID da concessão deve corresponder.

--timeout

Tempo limite da solicitação 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

Este comando está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Permitir que os usuários selecionem/projetem dados de instantâneo de blob ou 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

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

Permitir 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 no 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

--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 o ETag do recurso corresponder ao valor especificado.

--if-modified-since

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

--if-none-match

--if-unmodified-since

Iniciar somente se não for 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 de 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, por favor, 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

Obrigató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 como são representados no blob. Ao fornecer um formato de saída, os dados de blob serão reformatados de acordo com esse perfil. Se você escolher json, por favor, 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 assinatura de acesso compartilhado (SAS). 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 tags de blob para operar somente em blobs com um valor correspondente.

--timeout

Tempo limite da solicitação 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 blob especificados.

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

Exemplos

Restaure blobs em dois intervalos de blob especificados. Por exemplo, (container1/blob1, container2/blob2) e (container2/blob3.. contêiner2/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

Restaurar blobs 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 blob 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 blob especificado sem esperar e consulte o status de restauração do 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 em (Y-m-d'T'H:M:S'Z').

Parâmetros Opcionais

--blob-range -r

Intervalos de blobs 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. Nota: 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

Este comando está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Crie um novo Blob de Blocos onde 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 o 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 por URL como apareceria em um URI de solicitação. Se a origem estiver em outra conta, ela deverá ser pública ou autenticada por meio de uma assinatura de acesso compartilhado. Se a origem 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 em nível de 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 o ETag do recurso corresponder ao valor especificado.

--if-modified-since

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

--if-none-match

--if-unmodified-since

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

--lease-id

Obrigató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 assinatura de acesso compartilhado (SAS). 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 tags 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ó se aplica a blobs de bloco em contas de armazenamento padrão.

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

--timeout

Tempo limite da solicitação 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

Definir retenção legal de 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

Configurar retenção legal de blob.

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

Limpar retenção legal de blob.

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 assinatura de acesso compartilhado (SAS). 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

Tempo limite da solicitação 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 bloco, esse comando só oferece suporte a blob de bloco em contas de armazenamento padrão. Para blob de página, esse comando só oferece suporte para blobs de página 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

--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 assinatura de acesso compartilhado (SAS). 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.

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

--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 assinatura de acesso compartilhado (SAS). 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 tags 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

Um 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

--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 o ETag do recurso corresponder ao valor especificado.

--if-modified-since

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

--if-none-match

--if-unmodified-since

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

--lease-id

Obrigatório se o blob tiver uma concessão ativa.

--name -n

O nome do blob.

--sas-token

Uma assinatura de acesso compartilhado (SAS). 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 instantâneo de blob a ser recuperado.

--tags-condition

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

--timeout

Tempo limite da solicitação 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

--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 o ETag do recurso corresponder ao valor especificado.

--if-modified-since

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

--if-none-match

--if-unmodified-since

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

--lease-id

Obrigatório se o blob tiver uma concessão ativa.

--name -n

O nome do blob.

--sas-token

Uma assinatura de acesso compartilhado (SAS). Deve ser usado em conjunto com o nome da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_SAS_TOKEN.

--snapshot

O parâmetro snapshot é 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 tags de blob para operar somente em blobs com um valor correspondente.

--timeout

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

--version-id

Versão Prévia

Um 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 anexado 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

--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 o ETag do recurso corresponder ao valor especificado.

--if-modified-since

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

--if-none-match

--if-unmodified-since

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

--lease-id

Obrigatório se o blob tiver uma concessão ativa.

--metadata

Metadados em pares key=value separados por espaço. Isso substitui quaisquer metadados existentes.

--name -n

O nome do blob.

--sas-token

Uma assinatura de acesso compartilhado (SAS). 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 tags de blob para operar somente em blobs com um valor correspondente.

--timeout

Tempo limite da solicitação 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

Este comando está em pré-visualização 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]
                     [--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

Sincronizar 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 a passagem de opções azcopy (neste caso, limitando a banda de upload 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 do qual 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

--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; Nome exato. 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; Nome exato. Essa opção dá suporte a caracteres curinga (*).

--sas-token

Uma assinatura de acesso compartilhado (SAS). 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 --arquivo .

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 snapshot excluído suavemente.

A operação só será bem-sucedida se for 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 é excluído suavemente terá êxito sem alterações.

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

Cancelar a exclusão de um blob.

az storage blob undelete -c mycontainer -n MyBlob

Cancelar a exclusão de 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

--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 assinatura de acesso compartilhado (SAS). 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

Tempo limite da solicitação 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 for definido, se qualquer uma ou mais das seguintes propriedades (--content-cache-control, --content-disposition, --content-encoding, --content-language, --content-md5, --content-type) estiver definida, 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 estiver definida, essa propriedade será limpa.

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 de 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 o ETag do recurso corresponder ao valor especificado.

--if-modified-since

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

--if-none-match

--if-unmodified-since

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

--lease-id

Obrigatório se o blob tiver uma concessão ativa.

--sas-token

Uma assinatura de acesso compartilhado (SAS). 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 tags de blob para operar somente em blobs com um valor correspondente.

--timeout

Tempo limite da solicitação 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 a partir de um caminho de arquivo ou atualize o conteúdo de um blob existente com notificações automáticas de fragmentação e 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

Carregue em um blob.

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

Carregue 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

Carregue em 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

--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 de 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 o ETag do recurso corresponder ao valor especificado.

--if-modified-since

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

--if-none-match

--if-unmodified-since

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

--lease-id

Obrigató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. Cooperar com --data.

--max-connections

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

valor padrão: 2

--maxsize-condition

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

--metadata

Metadados em pares key=value separados por espaço. Isso substitui quaisquer 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 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 para o acima é com tipos de blob Append: se definido como False e os dados já existirem, um erro não será gerado e os dados serão anexados 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 assinatura de acesso compartilhado (SAS). 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 (segs), 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 tags de blob para operar somente em blobs com um valor correspondente.

--tier

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

--timeout

Tempo limite da solicitação 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 bloco do blob e verificado pelo serviço quando o bloco 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 determinada data.

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 onde 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 a partir 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 de 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 o ETag do recurso corresponder ao valor especificado.

--if-modified-since

Iniciar 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

Iniciar somente se não for 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 64MB.

valor padrão: 2

--maxsize-condition

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

--metadata

Metadados em pares key=value separados por espaço. Isso substitui quaisquer 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 assinatura de acesso compartilhado (SAS). 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 tags de blob para operar somente em blobs com um valor correspondente.

--tier

--timeout

Tempo limite da solicitação 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 bloco do blob e verificado pelo serviço quando o bloco 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 assinatura de acesso compartilhado (SAS). 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 cadeia de caracteres que identifica exclusivamente o instantâneo. O valor desse parâmetro de consulta indica a versão do snapshot.

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.