Partilhar via


azcopy set-propriedades

Dado um local, altere todas as propriedades válidas do sistema desse armazenamento (blob ou arquivo).

Sinopse

azcopy set-properties [resourceURL] [flags]

Define propriedades de armazenamento de Blob e Arquivo. As propriedades atualmente suportadas por este comando são:

  • Blobs -> camada, metadados, tags
  • Armazenamento Data Lake -> camadas, metadados, tags
  • Arquivos -> Metadados

Nota

Os pontos de extremidade de Armazenamento Data Lake serão substituídos por pontos de extremidade de Armazenamento de Blob.

Consulte os exemplos para obter mais informações.

Exemplos

Altere a camada de blob para quente:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=hot

Altere a camada de blob para frio:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=cold

Altere a camada de blob de hot para archive:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=archive

Mude a camada de blob de arquivo para resfriamento com prioridade de hidratação definida como alta:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=cool --rehydrate-priority=high

Mude o nível de blob de frio para quente com prioridade de hidratação definida como padrão:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=hot --rehydrate-priority=standard

Altere a camada de todos os arquivos em um diretório para arquivar:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --block-blob-tier=archive --recursive=true

Alterar a camada de um blob de página:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --page-blob-tier=[P10/P15/P20/P30/P4/P40/P50/P6]--rehydrate-priority=[Standard/High]

Altere os metadados de blob para {key = "abc", val = "def"} e {key = "ghi", val = "jkl"}:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --metadata=abc=def;ghi=jkl

Altere os metadados de todos os arquivos em um diretório para {key = "abc", val = "def"} e {key = "ghi", val = "jkl"}:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --metadata=abc=def;ghi=jkl --recursive=true

Limpe todos os metadados existentes do blob:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --metadata=clear

Limpe todos os metadados existentes de todos os arquivos:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --recursive --metadata=clear

Altere blob-tags de blob para {key = "abc", val = "def"} e {key = "ghi", val = "jkl"}:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --blob-tags=abc=def&ghi=jkl

Ao definir tags nos blobs, há outras permissões('t' para tags) com o SAS. Sem essas tags, o serviço retornará um erro de autorização.

Limpe todas as blob-tags existentes de blob:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --blob-tags=clear

Ao definir tags nos blobs, há outras permissões('t' para tags) com o SAS. Sem essas tags, o serviço retornará um erro de autorização.

Opções

--blob-tags string Definir tags em blobs para categorizar dados em sua conta de armazenamento (separados por '&')

--block-blob-tier string Altera a camada de acesso dos blobs para a camada dada (padrão "Nenhum")

--dry-run Imprime os caminhos de arquivo que seriam afetados por esse comando. Esse sinalizador não afeta os arquivos reais.

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

--exclude-pattern string Excluir arquivos em que o nome corresponde à lista de padrões. Por exemplo: .jpg;. pdf; exactName

--from-to string Opcionalmente, especifica a combinação de destino de origem. Valores válidos: BlobNone, FileNone, BlobFSNone

-h, --help ajuda para set-properties

--include-path string Inclua apenas esses caminhos ao definir a propriedade. Esta opção não suporta caracteres curinga (*). Verifica o prefixo do caminho relativo. Por exemplo: myFolder;myFolder/subDirName/file.pdf

--include-pattern string Inclua apenas arquivos em que o nome corresponde à lista de padrões. Por exemplo: .jpg;. pdf; exactName

--list-of-files string Define o local do arquivo de texto que tem a lista de arquivos a serem copiados.

--metadata string Defina o local fornecido com esses pares chave-valor (separados por ';') como metadados.

--page-blob-tier string Carregar blob de página para o Armazenamento do Azure usando essa camada de blob. (por defeito, «Nenhum»). (padrão "Nenhum")

--recursive Analise os subdiretórios recursivamente ao carregar a partir do sistema de arquivos local.

--rehydrate-priority string Sinalizador opcional que define a prioridade de reidratação para reidratação. Valores válidos: Standard, High. Padrão padrão (padrão "Padrão")

Opções herdadas dos comandos pai

--cap-mbps float Limita a taxa de transferência, em megabits por segundo. A taxa de transferência momento a momento pode variar ligeiramente do limite. Se essa opção estiver definida como zero ou for omitida, a taxa de transferência não será limitada.

--log-level (string) Defina a verbosidade do log para o arquivo de log, níveis disponíveis: INFO(todas as solicitações/respostas), WARNING(respostas lentas), ERROR(somente solicitações com falha) e NONE(sem logs de saída). (padrão 'INFO'). (padrão "INFO")

--output-type (string) Formato da saída do comando. As opções incluem: texto, json. O valor padrão é 'text'. (padrão "texto")

--output-level (string) Defina a verbosidade da saída. Níveis disponíveis: essencial, silencioso. (padrão "padrão")

--trusted-microsoft-suffixes (string) Especifica outros sufixos de domínio para os quais os tokens de login do Microsoft Entra ID podem ser enviados. O padrão é '.core.windows.net;. core.chinacloudapi.cn;. core.cloudapi.de;. core.usgovcloudapi.net;*.storage.azure.net'. Qualquer listado aqui é adicionado ao padrão. Por segurança, você só deve colocar domínios do Microsoft Azure aqui. Separe várias entradas com ponto-e-vírgula.

Consulte também