Partilhar via


az storage blob

Note

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 Status
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 disponibilidade geral
az storage blob copy cancel

Anular uma operação de cópia em curso.

Core disponibilidade geral
az storage blob copy start

Copie um blob de forma assíncrona. Use az storage blob show para verificar o status dos blobs.

Core disponibilidade geral
az storage blob copy start (storage-blob-preview extensão)

Inicie um trabalho de blob de cópia.

Extension disponibilidade geral
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.

Core disponibilidade geral
az storage blob delete

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

Core disponibilidade geral
az storage blob delete (storage-blob-preview extensão)

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

Extension disponibilidade geral
az storage blob delete-batch

Exclua blobs de um contêiner de blob recursivamente.

Core disponibilidade geral
az storage blob download

Baixe um blob para um caminho de arquivo.

Core disponibilidade geral
az storage blob download-batch

Baixe blobs de um contêiner de blob recursivamente.

Core disponibilidade geral
az storage blob exists

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

Core disponibilidade geral
az storage blob filter

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

Extension Preview
az storage blob generate-sas

Gere uma assinatura de acesso compartilhado para o blob.

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

Gere uma assinatura de acesso compartilhado para o blob.

Extension disponibilidade geral
az storage blob immutability-policy

Gerencie a política de imutabilidade de blob.

Core disponibilidade geral
az storage blob immutability-policy delete

Exclua a política de imutabilidade do blob.

Core disponibilidade geral
az storage blob immutability-policy set

Defina a política de imutabilidade do blob.

Core disponibilidade geral
az storage blob incremental-copy

Gerencie operações de cópia incremental de blob.

Core disponibilidade geral
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.

Core disponibilidade geral
az storage blob incremental-copy start

Copia uma cópia incremental de um blob de forma assíncrona.

Core disponibilidade geral
az storage blob lease

Gerencie locações de blob de armazenamento.

Core disponibilidade geral
az storage blob lease acquire

Solicite um novo arrendamento.

Core disponibilidade geral
az storage blob lease break

Quebre a locação, se o contêiner ou blob tiver uma concessão ativa.

Core disponibilidade geral
az storage blob lease change

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

Core disponibilidade geral
az storage blob lease release

Libere o contrato de locação.

Core disponibilidade geral
az storage blob lease renew

Renovar o contrato de arrendamento.

Core disponibilidade geral
az storage blob list

Listar blobs em um determinado contêiner.

Core disponibilidade geral
az storage blob metadata

Gerencie metadados de blob.

Core disponibilidade geral
az storage blob metadata show

Retorne todos os metadados definidos pelo usuário para o blob ou instantâneo especificado.

Core disponibilidade geral
az storage blob metadata update

Define metadados definidos pelo usuário para o blob como um ou mais pares nome-valor.

Core disponibilidade geral
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.

Core Preview
az storage blob restore

Restaure blobs nos intervalos de blob especificados.

Core disponibilidade geral
az storage blob rewrite

Crie um novo Blob de Bloco onde o conteúdo do blob é lido de uma determinada URL.

Core Preview
az storage blob service-properties

Gerencie as propriedades do serviço de blob de armazenamento.

Núcleo e Extensão disponibilidade geral
az storage blob service-properties delete-policy

Gerencie as propriedades do serviço de política de exclusão de blob de armazenamento.

Core disponibilidade geral
az storage blob service-properties delete-policy show

Mostrar a política de exclusão do blob de armazenamento.

Core disponibilidade geral
az storage blob service-properties delete-policy update

Atualize a política de exclusão do blob de armazenamento.

Core disponibilidade geral
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.

Core disponibilidade geral
az storage blob service-properties update

Atualize as propriedades do serviço de blob de armazenamento.

Core disponibilidade geral
az storage blob service-properties update (storage-blob-preview extensão)

Atualize as propriedades do serviço de blob de armazenamento.

Extension disponibilidade geral
az storage blob set-legal-hold

Definir retenção legal de blob.

Core disponibilidade geral
az storage blob set-tier

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

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

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

Extension disponibilidade geral
az storage blob show

Obtenha os detalhes de um blob.

Core disponibilidade geral
az storage blob show (storage-blob-preview extensão)

Obtenha os detalhes de um blob.

Extension disponibilidade geral
az storage blob snapshot

Cria um instantâneo do blob.

Core disponibilidade geral
az storage blob sync

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

Core Preview
az storage blob tag

Gerencie tags de blob.

Extension Preview
az storage blob tag list

Obtenha tags em um blob ou versão específica de blob ou snapshot.

Extension Preview
az storage blob tag set

Defina tags em uma versão de blob ou blob específica, mas não snapshot.

Extension Preview
az storage blob undelete

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

Core disponibilidade geral
az storage blob update

Define as propriedades do sistema no blob.

Core disponibilidade geral
az storage blob upload

Carregue um arquivo para um blob de armazenamento.

Core disponibilidade geral
az storage blob upload-batch

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

Core disponibilidade geral
az storage blob url

Crie a url para acessar um blob.

Core disponibilidade geral

az storage blob delete

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

Eliminar 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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--if-modified-since

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--if-unmodified-since

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

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

Eliminar 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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--account-key

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--if-modified-since

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--if-unmodified-since

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

az storage blob delete-batch

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--connection-string

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--delete-snapshots

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

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

Propriedade Valor
Default value: 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.

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--if-modified-since

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--if-unmodified-since

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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/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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

az storage blob download

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--if-modified-since

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--if-unmodified-since

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Default value: 2
--name -n

O nome blob.

--no-progress

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

Propriedade Valor
Default value: 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.

Propriedade Valor
Default value: wb
--overwrite

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

Propriedade Valor
Default value: True
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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Default value: 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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

az storage blob download-batch

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--connection-string

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--dryrun

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

Propriedade Valor
Default value: False
--max-connections

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

Propriedade Valor
Default value: 2
--no-progress

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

Propriedade Valor
Default value: False
--overwrite

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

Propriedade Valor
Default value: False
Valores aceites: false, true
--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/library/fnmatch.html.

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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

az storage blob exists

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. (autogenerated)

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

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. eg. ""yourtagname"='firsttag' e "yourtagname2"='secondtag'".

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--account-key

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--connection-string

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

az storage blob generate-sas

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. (autogenerated)

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--as-user

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

Propriedade Valor
Default value: False
--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.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

--cache-control

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

--connection-string

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Default value: 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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

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. (autogenerated)

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--account-key

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--as-user

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

Propriedade Valor
Default value: False
--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.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--cache-control

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

--connection-string

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--content-disposition

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

--content-encoding

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

--content-language

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

--content-type

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

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

Propriedade Valor
Default value: 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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

az storage blob list

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--connection-string

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Default value: 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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

az storage blob query

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://learn.microsoft.com/azure/storage/blobs/query-acceleration-sql-reference.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--if-modified-since

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--if-unmodified-since

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--in-column-separator

A cadeia de caracteres usada para separar colunas.

Propriedade Valor
Grupo de parâmetros: Input Delimited Text Configuration Arguments
Default value: ,
--in-escape-char

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

Propriedade Valor
Grupo de parâmetros: Input Delimited Text Configuration Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Input Delimited Text Configuration Arguments
Default value: False
--in-line-separator

A cadeia de caracteres usada para separar registros.

Propriedade Valor
Grupo de parâmetros: Input Json Text Configuration Arguments
Default value:
--in-quote-char

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

Propriedade Valor
Grupo de parâmetros: Input Delimited Text Configuration Arguments
Default value: "
--in-record-separator

A cadeia de caracteres usada para separar registros.

Propriedade Valor
Grupo de parâmetros: Input Delimited Text Configuration Arguments
Default value:
--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.

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

Propriedade Valor
Grupo de parâmetros: Output Delimited Text Configuration Arguments
Default value: ,
--out-escape-char

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

Propriedade Valor
Grupo de parâmetros: Output Delimited Text Configuration Arguments
--out-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.

Propriedade Valor
Grupo de parâmetros: Output Delimited Text Configuration Arguments
Default value: False
--out-line-separator

A cadeia de caracteres usada para separar registros.

Propriedade Valor
Grupo de parâmetros: Output Json Text Configuration Arguments
Default value:
--out-quote-char

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

Propriedade Valor
Grupo de parâmetros: Output Delimited Text Configuration Arguments
Default value: "
--out-record-separator

A cadeia de caracteres usada para separar registros.

Propriedade Valor
Grupo de parâmetros: Output Delimited Text Configuration Arguments
Default value:
--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.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--tags-condition

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

az storage blob restore

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

Propriedade Valor
Default value: False
--resource-group -g

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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

az storage blob rewrite

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--connection-string

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--if-modified-since

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--if-unmodified-since

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--tags-condition

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

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]

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
--container-name -c

O nome do contêiner.

--legal-hold

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

Propriedade Valor
Valores aceites: false, true
--name -n

O nome blob.

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--connection-string

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

az storage blob set-tier

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. (autogenerated)

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Default value: block
Valores aceites: block, page
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

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. (autogenerated)

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--account-key

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Default value: block
Valores aceites: block, page
--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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

az storage blob show

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--if-modified-since

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--if-unmodified-since

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--account-key

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--if-modified-since

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--if-unmodified-since

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

az storage blob snapshot

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--if-modified-since

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--if-unmodified-since

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--tags-condition

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

az storage blob sync

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]
                     [--auth-mode {key, login}]
                     [--connection-string]
                     [--delete-destination {false, prompt, true}]
                     [--destination]
                     [--exclude-path]
                     [--exclude-pattern]
                     [--include-pattern]
                     [--sas-token]
                     [--service-endpoint]
                     []

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Valores aceites: key, login
--connection-string

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Additional Flags Arguments
Default value: true
Valores aceites: false, prompt, 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.

Propriedade Valor
Grupo de parâmetros: Additional Flags Arguments
--exclude-pattern

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

Propriedade Valor
Grupo de parâmetros: Additional Flags Arguments
--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 (*).

Propriedade Valor
Grupo de parâmetros: Additional Flags Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--service-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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
<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 .

Propriedade Valor
Grupo de parâmetros: Positional
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

az storage blob undelete

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

az storage blob update

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-cache-control]
                       [--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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Valores aceites: false, true
--connection-string

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--if-modified-since

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--if-unmodified-since

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--tags-condition

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

az storage blob upload

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-cache-control]
                       [--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. (autogenerated)

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--container-name -c

O nome do contêiner.

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

A cadeia de caracteres de controle de cache.

Propriedade Valor
Grupo de parâmetros: Content Control Arguments
--content-disposition

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

Propriedade Valor
Grupo de parâmetros: Content Control Arguments
--content-encoding

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

Propriedade Valor
Grupo de parâmetros: Content Control Arguments
--content-language

A linguagem do conteúdo.

Propriedade Valor
Grupo de parâmetros: Content Control Arguments
--content-md5

O hash MD5 do conteúdo.

Propriedade Valor
Grupo de parâmetros: Content Control Arguments
--content-type

O tipo MIME de conteúdo.

Propriedade Valor
Grupo de parâmetros: Content Control Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Additional Flags Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--if-modified-since

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--if-unmodified-since

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Additional Flags Arguments
Default value: 2
--maxsize-condition

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

Propriedade Valor
Grupo de parâmetros: Content Control Arguments
--metadata

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

Propriedade Valor
Grupo de parâmetros: Additional Flags Arguments
--name -n

O nome blob.

--no-progress

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

Propriedade Valor
Grupo de parâmetros: Additional Flags Arguments
Default value: 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.

Propriedade Valor
Grupo de parâmetros: Additional Flags Arguments
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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Additional Flags Arguments
--tags-condition

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Additional Flags Arguments
--timeout

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

Propriedade Valor
Grupo de parâmetros: Additional Flags Arguments
--type -t

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

Propriedade Valor
Grupo de parâmetros: Additional Flags Arguments
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.

Propriedade Valor
Grupo de parâmetros: Content Control Arguments
Default value: False
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

az storage blob upload-batch

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-cache-control]
                             [--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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--connection-string

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--content-cache --content-cache-control

A cadeia de caracteres de controle de cache.

Propriedade Valor
Grupo de parâmetros: Content Control Arguments
--content-disposition

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

Propriedade Valor
Grupo de parâmetros: Content Control Arguments
--content-encoding

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

Propriedade Valor
Grupo de parâmetros: Content Control Arguments
--content-language

A linguagem do conteúdo.

Propriedade Valor
Grupo de parâmetros: Content Control Arguments
--content-md5

O hash MD5 do conteúdo.

Propriedade Valor
Grupo de parâmetros: Content Control Arguments
--content-type

O tipo MIME de conteúdo.

Propriedade Valor
Grupo de parâmetros: Content Control Arguments
--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).

Propriedade Valor
Default value: 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.

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--if-modified-since

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--if-unmodified-since

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Additional Flags Arguments
Default value: 2
--maxsize-condition

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

Propriedade Valor
Grupo de parâmetros: Content Control Arguments
--metadata

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

Propriedade Valor
Grupo de parâmetros: Additional Flags Arguments
--no-progress

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

Propriedade Valor
Grupo de parâmetros: Additional Flags Arguments
Default value: 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.

Propriedade Valor
Grupo de parâmetros: Additional Flags Arguments
Valores aceites: false, true
--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/library/fnmatch.html.

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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--tags

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

Propriedade Valor
Grupo de parâmetros: Additional Flags Arguments
--tags-condition

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

Propriedade Valor
Grupo de parâmetros: Precondition Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Additional Flags Arguments
--timeout

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

Propriedade Valor
Grupo de parâmetros: Additional Flags Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Additional Flags Arguments
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.

Propriedade Valor
Grupo de parâmetros: Content Control Arguments
Default value: False
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

az storage blob url

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--connection-string

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

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--protocol

Protocolo a utilizar.

Propriedade Valor
Default value: https
Valores aceites: http, 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.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False