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
- Data Lake Storage Gen2 -> Nível, Metadados, Tags
- Arquivos -> Metadados
Nota
Os pontos de extremidade do Data Lake Storage Gen2 serão substituídos pelos pontos de extremidade do Armazenamento de Blob.
Consulte os exemplos para obter mais informações.
Artigos conceptuais relacionados
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.