az storage blob

Referência

Nota

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

Gerencie 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

Name	Description	Tipo	Estado
az storage blob access	Gerencie as propriedades de controle de acesso de um blob quando o Namespace Hierárquico estiver 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	Gerencie 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 curso.	Principal	GA
az storage blob copy start	Copie um blob de forma assíncrona. Use `az storage blob show` para verificar o status dos blobs.	Principal	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.	Principal	GA
az storage blob delete	Marque um blob ou instantâneo para exclusão.	Principal	GA
az storage blob delete (storage-blob-preview extensão)	Marque um blob ou instantâneo para exclusão.	Extensão	GA
az storage blob delete-batch	Exclua blobs de um contêiner de blob recursivamente.	Principal	GA
az storage blob directory	Gerencie diretórios de blob no contêiner da conta de armazenamento.	Extensão	Pré-visualização e preterido
az storage blob directory access	Gerencie as propriedades de controle de acesso de um diretório quando o Namespace Hierárquico estiver 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	Baixe 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 blob em um contêiner de armazenamento.	Extensão	Pré-visualização e preterido
az storage blob directory list	Liste blobs e subdiretórios de blob em um diretório de armazenamento.	Extensão	Pré-visualização e preterido
az storage blob directory metadata	Gerencie metadados de 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 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 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 para 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.	Principal	GA
az storage blob download-batch	Baixe blobs de um contêiner de blob recursivamente.	Principal	GA
az storage blob exists	Verifique a existência de um blob em um contêiner.	Principal	GA
az storage blob filter	Liste blobs em todos os contêineres cujas tags correspondam a uma determinada expressão de pesquisa.	Extensão	Pré-visualizar
az storage blob generate-sas	Gere uma assinatura de acesso compartilhado para o blob.	Principal	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	Gerencie a política de imutabilidade de blob.	Principal	GA
az storage blob immutability-policy delete	Exclua a política de imutabilidade do blob.	Principal	GA
az storage blob immutability-policy set	Defina a política de imutabilidade do blob.	Principal	GA
az storage blob incremental-copy	Gerencie operações de cópia incremental de blob.	Principal	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.	Principal	GA
az storage blob incremental-copy start	Copia uma cópia incremental de um blob de forma assíncrona.	Principal	GA
az storage blob lease	Gerencie locações de blob de armazenamento.	Principal	GA
az storage blob lease acquire	Solicite um novo arrendamento.	Principal	GA
az storage blob lease break	Quebre a locação, se o contêiner ou blob tiver uma concessão ativa.	Principal	GA
az storage blob lease change	Altere o ID de concessão de uma concessão ativa.	Principal	GA
az storage blob lease release	Libere o contrato de locação.	Principal	GA
az storage blob lease renew	Renovar o contrato de arrendamento.	Principal	GA
az storage blob list	Listar blobs em um determinado contêiner.	Principal	GA
az storage blob metadata	Gerencie metadados de blob.	Principal	GA
az storage blob metadata show	Retorne todos os metadados definidos pelo usuário para o blob ou instantâneo especificado.	Principal	GA
az storage blob metadata update	Define metadados definidos pelo usuário para o blob como um ou mais pares nome-valor.	Principal	GA
az storage blob move	Mova um blob em um contêiner de armazenamento.	Extensão	Pré-visualização e preterido
az storage blob query	Permita que os usuários selecionem/projetem em dados de instantâneo de blob ou blob fornecendo expressões de consulta simples.	Principal	Pré-visualizar
az storage blob restore	Restaure blobs nos intervalos de blob especificados.	Principal	GA
az storage blob rewrite	Crie um novo Blob de Bloco onde o conteúdo do blob é lido de uma determinada URL.	Principal	Pré-visualizar
az storage blob service-properties	Gerencie as propriedades do serviço de blob de armazenamento.	Núcleo e Extensão	GA
az storage blob service-properties delete-policy	Gerencie as propriedades do serviço de política de exclusão de blob de armazenamento.	Principal	GA
az storage blob service-properties delete-policy show	Mostrar a política de exclusão do blob de armazenamento.	Principal	GA
az storage blob service-properties delete-policy update	Atualize a política de exclusão do blob de armazenamento.	Principal	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.	Principal	GA
az storage blob service-properties update	Atualize as propriedades do serviço de blob de armazenamento.	Principal	GA
az storage blob service-properties update (storage-blob-preview extensão)	Atualize as propriedades do serviço de blob de armazenamento.	Extensão	GA
az storage blob set-legal-hold	Definir retenção legal de blob.	Principal	GA
az storage blob set-tier	Defina as camadas de bloco ou página no blob.	Principal	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.	Principal	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.	Principal	GA
az storage blob sync	Sincronize blobs recursivamente com um contêiner de blob de armazenamento.	Principal	Pré-visualizar
az storage blob tag	Gerencie tags de blob.	Extensão	Pré-visualizar
az storage blob tag list	Obtenha tags em um blob ou versão específica de blob ou snapshot.	Extensão	Pré-visualizar
az storage blob tag set	Defina tags em uma versão de blob ou blob específica, mas não snapshot.	Extensão	Pré-visualizar
az storage blob undelete	Restaure o blob ou instantâneo excluído suavemente.	Principal	GA
az storage blob update	Define as propriedades do sistema no blob.	Principal	GA
az storage blob upload	Carregue um arquivo para um blob de armazenamento.	Principal	GA
az storage blob upload-batch	Carregue arquivos de um diretório local para um contêiner de blob.	Principal	GA
az storage blob url	Crie a url para acessar um blob.	Principal	GA

az storage blob delete

Editar

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

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

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

Exemplos

Exclua um blob.

az storage blob delete -c mycontainer -n MyBlob

Exclua um blob usando credenciais de login.

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

Parâmetros Opcionais

--account-key

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

--account-name

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

--auth-mode

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

valores aceites: 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 do serviço com az storage account showo . Variável de ambiente: AZURE_STORAGE_SERVICE_ENDPOINT.

--blob-url

A URL completa do ponto de extremidade para o Blob, incluindo token SAS e instantâneo, se usado. Este pode ser o parâmetro de avaliação primário ou o parâmetro de avaliação secundário, dependendo do objetivo atual 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

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

valores aceites: include, only

--if-match

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

--if-modified-since

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

--if-none-match

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

--if-unmodified-since

Comece apenas se não for modificado desde que forneceu data/hora UTC (Y-m-d'T'H:M'Z').

--lease-id

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

--name -n

O nome 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 do 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 de solicitação em segundos. Aplica-se a cada chamada para o serviço.

Parâmetros de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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

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

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

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

Exemplos

Exclua um blob.

az storage blob delete -c mycontainer -n MyBlob

Exclua um blob usando credenciais de login.

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

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

valores aceites: 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

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

valores aceites: include, only

--if-match

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

--if-modified-since

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

--if-none-match

--if-unmodified-since

Comece apenas se não for modificado desde que forneceu data/hora UTC (Y-m-d'T'H:M'Z').

--lease-id

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

--name -n

O nome 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 de solicitação em segundos. Aplica-se a cada chamada para o serviço.

--version-id

Um ID de versão de blob opcional. Este parâmetro é apenas para conta habilitada para controle de versão.

Parâmetros de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 terminados 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 Obrigatórios

--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 da conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade do serviço. Variável de ambiente: AZURE_STORAGE_KEY.

--account-name

--auth-mode

valores aceites: key, login

--blob-endpoint

--connection-string

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

--delete-snapshots

Necessário se o blob tiver instantâneos associados.

valores aceites: include, only

--dryrun

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

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

valor predefinido: False

--if-match

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

--if-modified-since

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

--if-none-match

Um valor ETag ou o caractere curinga (*).

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

--if-unmodified-since

Comece apenas se não for modificado desde que forneceu data/hora UTC (Y-m-d'T'H:M'Z').

--lease-id

A id de concessão ativa para o blob.

--pattern

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

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

--sas-token

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

--timeout

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

Parâmetros de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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

Faça o download de um blob.

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

Faça o download de um conteúdo de blob para stdout (suporte de pipe).

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

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

valores aceites: 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 dada, deve ser fornecida start_range. Os parâmetros start_range e end_range são inclusivos. Ex: start_range=0, end_range=511 baixará os primeiros 512 bytes de blob.

--file -f

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

--if-match

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

--if-modified-since

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

--if-none-match

--if-unmodified-since

Comece apenas se não for modificado desde que forneceu data/hora UTC (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 o download.

valor predefinido: 2

--name -n

O nome blob.

--no-progress

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

valor predefinido: False

--open-mode

Modo a utilizar ao abrir o ficheiro. Observe que especificar apenas acrescentar open_mode impede o download paralelo. Assim, max_connections deve ser definido como 1 se este open_mode for usado.

valor predefinido: wb

--overwrite

Substitua um arquivo existente quando especificado. O valor predefinido é verdadeiro.

valores aceites: false, true

valor predefinido: 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 do 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 nenhum end_range for fornecido, todos os bytes após o start_range serão baixados. Os parâmetros start_range e end_range são inclusivos. Ex: start_range=0, end_range=511 baixará os primeiros 512 bytes de blob.

--tags-condition

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

--timeout

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

--validate-content

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

valor predefinido: False

--version-id

Um ID de versão de blob opcional. Este parâmetro é apenas para conta habilitada para controle de versão.

Parâmetros de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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

Faça o download de 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 Obrigatórios

--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 da conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade do serviço. Variável de ambiente: AZURE_STORAGE_KEY.

--account-name

--auth-mode

valores aceites: 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 predefinido: False

--max-connections

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

valor predefinido: 2

--no-progress

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

valor predefinido: False

--overwrite

Substitua um arquivo existente quando especificado. O valor predefinido é falso.

valores aceites: false, true

valor predefinido: 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 do serviço. Variável de ambiente: AZURE_STORAGE_SAS_TOKEN.

Parâmetros de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 da conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade do serviço. Variável de ambiente: AZURE_STORAGE_KEY.

--account-name

--auth-mode

valores aceites: 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 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 do serviço. Variável de ambiente: AZURE_STORAGE_SAS_TOKEN.

--snapshot

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

--timeout

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

Parâmetros de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az storage blob filter

Pré-visualizar

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

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

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

Parâmetros Obrigatórios

--tag-filter

A expressão para localizar blobs cujas tags correspondem à condição especificada. Por exemplo, ""yourtagname"='firsttag' e "yourtagname2"='secondtag'".

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

valores aceites: 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 de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 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 da conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade do serviço. Variável de ambiente: AZURE_STORAGE_KEY.

--account-name

--as-user

Indica que esse comando retorna a SAS assinada com a chave de delegação do usuário. O parâmetro de expiração e '--auth-mode login' são necessários se esse argumento for especificado.

valor predefinido: False

--auth-mode

valores aceites: key, login

--blob-endpoint

--blob-url

--cache-control

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

--connection-string

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

--container-name -c

O nome do contêiner.

--content-disposition

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

--content-encoding

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

--content-language

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

--content-type

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

--encryption-scope

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

--expiry

Especifica a data/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 predefinido: False

--https-only

Permita apenas solicitações feitas com o protocolo HTTPS. Se omitidas, as solicitações dos protocolos HTTP e HTTPS sã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 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 armazenada 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 para conceder permissão.

--start

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

--timeout

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

Parâmetros de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 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 Obrigatórios

--container-name -c

O nome do contêiner.

--name -n

O nome blob.

Parâmetros Opcionais

--account-key

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

--account-name

--as-user

Indica que esse comando retorna a SAS assinada com a chave de delegação do usuário. O parâmetro de expiração e '--auth-mode login' são necessários se esse argumento for especificado.

valor predefinido: False

--auth-mode

valores aceites: key, login

--blob-endpoint

--cache-control

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

--connection-string

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

--content-disposition

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

--content-encoding

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

--content-language

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

--content-type

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

--expiry

Especifica a data/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 retorne o URI de blob completo e o token de assinatura de acesso compartilhado.

valor predefinido: False

--https-only

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

--ip

Especifique um endereço IP ou um intervalo de endereços IP a partir dos quais aceitar solicitações. Se o endereço IP do qual a solicitação se origina não corresponder ao endereço IP ou 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 armazenada 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 o SAS se torna válido. Não use se uma política de acesso armazenado for referenciada com --id que especifica esse valor. O padrão é a hora da solicitação.

--version-id

Pré-visualizar

Um ID de versão de blob opcional. Este parâmetro é apenas para conta habilitada para controle de versão.

Parâmetros de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 comecem com 'foo'; corresponderá a nomes como 'foo', 'foobar' e 'foo/bar'

az storage blob list -c mycontainer --prefix foo

Parâmetros Obrigatórios

--container-name -c

O nome do contêiner.

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

valores aceites: 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 substring 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 de 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 predefinido: 5000

--prefix

Filtre os resultados para retornar apenas blobs cujo nome comece 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 do serviço. Variável de ambiente: AZURE_STORAGE_SAS_TOKEN.

--show-next-marker

Mostrar nextMarker no resultado quando especificado.

--timeout

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

Parâmetros de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az storage blob move

Pré-visualizar Preterido

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

Este comando foi preterido e será removido em versões futuras. Use 'az storage fs file move' em vez disso. Para obter mais informações, aceda a https://github.com/Azure/azure-cli/blob/dev/src/azure-cli/azure/cli/command_modules/storage/docs/ADLS%20Gen2.md

Mova um blob em um contêiner de armazenamento.

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

Exemplos

Mova um blob em um contêiner de armazenamento.

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

Parâmetros Obrigatórios

--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 da 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 aceites: key, login

--connection-string

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

--lease-id

Opcional. Um 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. Um ID de locaçã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 de solicitação em segundos. Aplica-se a cada chamada para o serviço.

Parâmetros de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az storage blob query

Editar

Pré-visualizar

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

Permita que os usuários selecionem/projetem em 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

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

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

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

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

Parâmetros Obrigatórios

--query-expression

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

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

valores aceites: 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 a ETag do recurso corresponder ao valor especificado.

--if-modified-since

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

--if-none-match

--if-unmodified-since

Comece apenas se não for modificado desde que forneceu data/hora UTC (Y-m-d'T'H:M'Z').

--in-column-separator

A cadeia de caracteres usada para separar colunas.

valor predefinido: ,

--in-escape-char

A cadeia de caracteres usada como um caractere de escape. Padrão para 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 exclusivamente da primeira linha.

valor predefinido: False

--in-line-separator

A cadeia de caracteres usada para separar registros.

valor predefinido:

--in-quote-char

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

valor predefinido: "

--in-record-separator

A cadeia de caracteres usada para separar registros.

valor predefinido:

--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 em conformidade; Se você escolher csv, por favor especifique Output Delimited Text Configuration Arguments.

valores aceites: csv, json

--lease-id

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

--name -n

O nome blob.

--out-column-separator

A cadeia de caracteres usada para separar colunas.

valor predefinido: ,

--out-escape-char

A cadeia de caracteres usada como um caractere de escape. Padrão para vazio.

--out-has-header

valor predefinido: False

--out-line-separator

A cadeia de caracteres usada para separar registros.

valor predefinido:

--out-quote-char

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

valor predefinido: "

--out-record-separator

A cadeia de caracteres usada para separar registros.

valor predefinido:

--output-format

Tipo de serialização de saída para o fluxo de dados. Por padrão, os dados serão retornados conforme 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 em conformidade; Se você escolher csv, por favor especifique Output Delimited Text Configuration Arguments.

valores aceites: 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 do 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 de solicitação em segundos. Aplica-se a cada chamada para o serviço.

Parâmetros de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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.. container2/blob4).

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

Restaure blobs nos intervalos de blob especificados do início à conta final.

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 Obrigatórios

--account-name -n

O nome da conta de armazenamento.

--time-to-restore -t

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

Parâmetros Opcionais

--blob-range -r

Intervalos de Blob para restauração. 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 início da conta como valor do intervalo inicial e significa fim da conta para intervalo final.

--no-wait

Não espere que a operação de longa duração termine.

valor predefinido: False

--resource-group -g

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

Parâmetros de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az storage blob rewrite

Editar

Pré-visualizar

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

Crie um novo Blob de Bloco 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 Obrigatórios

--container-name -c

O nome do contêiner.

--name -n

O nome 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 fonte estiver em outra conta, a fonte deve ser pública ou deve ser 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 da conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade do serviço. Variável de ambiente: AZURE_STORAGE_KEY.

--account-name

--auth-mode

valores aceites: key, login

--blob-endpoint

--connection-string

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

--encryption-scope

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

--if-match

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

--if-modified-since

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

--if-none-match

--if-unmodified-since

Comece apenas se não for modificado desde que forneceu data/hora UTC (Y-m-d'T'H:M'Z').

--lease-id

Obrigatório se o blob tiver uma concessão ativa. Value pode ser um objeto BlobLeaseClient ou o 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 do 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ó é aplicável a blobs de bloco em contas de armazenamento padrão.

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

--timeout

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

Parâmetros de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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

Configure a retenção legal do blob.

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

Clear blob legal hold.

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

Parâmetros Obrigatórios

--container-name -c

O nome do contêiner.

--legal-hold

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

valores aceites: false, true

--name -n

O nome blob.

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

valores aceites: 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 do serviço. Variável de ambiente: AZURE_STORAGE_SAS_TOKEN.

--timeout

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

Parâmetros de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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, este comando suporta apenas blob de bloco em contas de armazenamento padrão. Para blob de página, este comando suporta apenas 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 Obrigatórios

--tier

O valor da camada para definir o blob.

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

valores aceites: 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 blob.

--rehydrate-priority -r

Pré-visualizar

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

valores aceites: 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 do 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 blob.

valores aceites: block, page

valor predefinido: block

Parâmetros de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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

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

Para blob de bloco, este comando suporta apenas blob de bloco em contas de armazenamento padrão. Para blob de página, este comando suporta apenas 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]
                         [--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 Obrigatórios

--tier

O valor da camada para definir o blob.

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

valores aceites: 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 blob.

--rehydrate-priority -r

Pré-visualizar

Indique a prioridade com a qual hidratar um blob arquivado.

valores aceites: 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 blob.

valores aceites: block, page

valor predefinido: block

--version-id

Um ID de versão de blob opcional. Este parâmetro é apenas para conta habilitada para controle de versão.

Parâmetros de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 da conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade do serviço. Variável de ambiente: AZURE_STORAGE_KEY.

--account-name

--auth-mode

valores aceites: 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 a ETag do recurso corresponder ao valor especificado.

--if-modified-since

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

--if-none-match

--if-unmodified-since

Comece apenas se não for modificado desde que forneceu data/hora UTC (Y-m-d'T'H:M'Z').

--lease-id

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

--name -n

O nome 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 do 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 de solicitação em segundos. Aplica-se a cada chamada para o serviço.

Parâmetros de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 da 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 aceites: 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 a ETag do recurso corresponder ao valor especificado.

--if-modified-since

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

--if-none-match

--if-unmodified-since

Comece apenas se não for modificado desde que forneceu data/hora UTC (Y-m-d'T'H:M'Z').

--lease-id

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

--name -n

O nome 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 de solicitação em segundos. Aplica-se a cada chamada para o serviço.

--version-id

Pré-visualizar

Um ID de versão de blob opcional. Este parâmetro é apenas para conta habilitada para controle de versão.

Parâmetros de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 que é tirado em um determinado momento. Ele pode ser lido, copiado ou excluído, mas não modificado. Os instantâneos fornecem uma maneira de fazer backup de um blob como ele aparece em um momento no tempo. 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 da conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade do serviço. Variável de ambiente: AZURE_STORAGE_KEY.

--account-name

--auth-mode

valores aceites: 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 a ETag do recurso corresponder ao valor especificado.

--if-modified-since

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

--if-none-match

--if-unmodified-since

Comece apenas se não for modificado desde que forneceu data/hora UTC (Y-m-d'T'H:M'Z').

--lease-id

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

--metadata

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

--name -n

O nome 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 do 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 de solicitação em segundos. Aplica-se a cada chamada para o serviço.

Parâmetros de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az storage blob sync

Editar

Pré-visualizar

Este comando está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: 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

Sincronize um diretório com um contêiner.

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

Sincronize um diretório com um contêiner com opções azcopy pass-through (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 Obrigatórios

--container -c

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

--source -s

O caminho do arquivo de origem a partir do qual sincronizar.

Parâmetros Opcionais

--account-key

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

--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 devem ser excluídos que não estão presentes na origem. Pode ser definido como true, false ou prompt. Se definido para solicitar, será feita uma pergunta ao usuário antes de agendar arquivos e blobs para exclusão.

valores aceites: false, prompt, true

valor predefinido: true

--destination -d

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

--exclude-path

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

--exclude-pattern

Exclua esses arquivos onde o nome corresponde à lista de padrões. Por exemplo: .jpg;. pdf; exactName. Esta opção suporta caracteres curinga (*).

--include-pattern

Inclua apenas esses arquivos em que o nome corresponde à lista de padrões. Por exemplo: .jpg;. pdf; exactName. Esta opção suporta 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>

Experimental

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

Parâmetros de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az storage blob undelete

Editar

Restaure o blob ou instantâneo excluído suavemente.

A operação só será bem-sucedida se usada dentro do número especificado de dias definido na política de retenção de exclusão. A tentativa de recuperar a exclusão de um blob ou instantâneo que não seja excluído suavemente será bem-sucedida 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

Cancele a exclusão de um blob usando credenciais de login.

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

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

valores aceites: 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 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 do serviço. Variável de ambiente: AZURE_STORAGE_SAS_TOKEN.

--timeout

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

Parâmetros de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az storage blob update

Editar

Define as propriedades do sistema no blob.

Se uma propriedade estiver 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 Obrigatórios

--container-name -c

O nome do contêiner.

--name -n

O nome blob.

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

valores aceites: key, login

--blob-endpoint

--clear-content-settings

Se esse sinalizador estiver definido, se qualquer uma ou mais das seguintes propriedades (--content-cache-control, --content-disposition, --content-encoding, --content-language, --content-md5, --content-type) 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 for definida, essa propriedade será limpa.

valores aceites: 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 a ETag do recurso corresponder ao valor especificado.

--if-modified-since

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

--if-none-match

--if-unmodified-since

Comece apenas se não for modificado desde que forneceu data/hora UTC (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 do 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 de solicitação em segundos. Aplica-se a cada chamada para o serviço.

Parâmetros de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az storage blob upload

Editar

Carregue um arquivo para 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 para um blob.

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

Carregue para 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 para 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 para um blob.

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

Carregue para um tubo 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 da conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade do serviço. Variável de ambiente: AZURE_STORAGE_KEY.

--account-name

--auth-mode

valores aceites: 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

Pré-visualizar

Os dados de blob a serem carregados.

--encryption-scope

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

--file -f

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

--if-match

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

--if-modified-since

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

--if-none-match

--if-unmodified-since

Comece apenas se não for modificado desde que forneceu data/hora UTC (Y-m-d'T'H:M'Z').

--lease-id

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

--length

Pré-visualizar

Número de bytes para ler a partir do fluxo. Isso é opcional, mas deve ser fornecido para um desempenho ideal. Cooperar com --dados.

--max-connections

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

valor predefinido: 2

--maxsize-condition

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

--metadata

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

--name -n

O nome blob.

--no-progress

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

valor predefinido: False

--overwrite

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

valores aceites: 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 do 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 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 ao tamanho do blob e ao 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ó é aplicável 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ó é aplicável a blobs de bloco em contas de armazenamento padrão.

--timeout

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

--type -t

Padrão para 'página' para arquivos *.vhd, ou 'bloquear' caso contrário.

valores aceites: append, block, page

--validate-content

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

valor predefinido: False

Parâmetros de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 do caminho local.

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

Carregue todos os ficheiros com o formato 'cli-201x-xx-xx.txt', exceto cli-2018-xx-xx.txt' e 'cli-2019-xx-xx.txt' num contentor.

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

Parâmetros Obrigatórios

--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 da conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade do serviço. Variável de ambiente: AZURE_STORAGE_KEY.

--account-name

--auth-mode

valores aceites: 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 predefinido: False

--if-match

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

--if-modified-since

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

--if-none-match

Um valor ETag ou o caractere curinga (*).

--if-unmodified-since

Comece apenas se não for modificado desde que forneceu data/hora UTC (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 predefinido: 2

--maxsize-condition

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

--metadata

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

--no-progress

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

valor predefinido: False

--overwrite

valores aceites: 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 do serviço. Variável de ambiente: AZURE_STORAGE_SAS_TOKEN.

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar 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 de 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 aceites: append, block, page

--validate-content

Especifica que um hash MD5 será calculado para cada segmento do blob e verificado pelo serviço quando o segmento tiver chegado.

valor predefinido: False

Parâmetros de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 Obrigatórios

--container-name -c

O nome do contêiner.

--name -n

O nome blob.

Parâmetros Opcionais

--account-key

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

--account-name

--auth-mode

valores aceites: 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 utilizar.

valores aceites: http, https

valor predefinido: 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 do 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 instantâneo.

Parâmetros de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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