azcopy set-properties
Considerando um local, altere todas as propriedades válidas do sistema desse armazenamento (blob ou arquivo).
Sinopse
azcopy set-properties [resourceURL] [flags]
Define as propriedades do armazenamento de blobs e arquivos. No momento, as propriedades que têm suporte deste comando são:
- Blobs –> Camada, Metadados, Marcas
- Data Lake Storage -> Camada, Metadados, Tags
- Arquivos –> Metadados
Observação
Os pontos de extremidade do Data Lake Storage serão substituídos por pontos de extremidade do Armazenamento de Blobs.
Confira os exemplos para saber mais.
Artigos conceituais relacionados
Exemplos
Altere a camada de blob para frequente:
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 do blob de frequente para arquivo:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=archive
Altere a camada de blob do arquivo para esporádica com prioridade de reidratação definida como alta:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=cool --rehydrate-priority=high
Altere a camada do blob de frio para quente com a prioridade de reidratar 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 camada de um blob de páginas:
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 do 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
Desmarque 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 as marcas do 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 marcas nos blobs, há outras permissões ('t' para marcas) com SAS. Sem essas marcas, o serviço retornará um erro de autorização.
Desmarque todas as marcas existentes do blob:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --blob-tags=clear
Ao definir marcas nos blobs, há outras permissões ('t' para marcas) com SAS. Sem essas marcas, o serviço retornará um erro de autorização.
Opções
--blob-tags cadeia de caracteres Definir marcas em blobs para categorizar dados em sua conta de armazenamento (separados por '&')
--block-blob-tier (cadeia de caracteres) Altera a camada de acesso dos blobs para a camada especificada (o padrão é "Nenhum")
--dry-run Imprime os caminhos de arquivo que seriam afetados por este comando. Esse sinalizador não afeta os arquivos reais.
--exclude-path (cadeia de caracteres) Exclui esses caminhos ao remover. Essa opção não dá suporte a caracteres curinga (*). Verifica o prefixo do caminho relativo. Por exemplo: myFolder;myFolder/subDirName/file.pdf
--exclude-pattern (cadeira de caracteres) Exclui os arquivos com nomes que correspondem à lista padrão. Por exemplo: .jpg;.pdf;exactName
--from-to (cadeia de caracteres) Especifica opcionalmente a combinação de origem e destino. Valores válidos: BlobNone, FileNone, BlobFSNone
-h, --help ajuda para set-properties
--include-path (cadeia de caracteres) Inclua apenas esses caminhos ao definir a propriedade. Essa opção não dá suporte a caracteres curinga (*). Verifica o prefixo do caminho relativo. Por exemplo: myFolder;myFolder/subDirName/file.pdf
--include-pattern (cadeira de caracteres) Inclua somente os arquivos cujo nome corresponde à lista padrão. Por exemplo: .jpg;.pdf;exactName
--list-of-files (cadeia de caracteres) Define o local do arquivo de texto que tem a lista de arquivos a serem copiados.
--metadata (cadeia de caracteres) Defina a localização com esses pares chave-valor (separados por ';') como metadados.
--page-blob-tier (cadeia de caracteres) Carregue um blob de páginas no Armazenamento do Azure usando esta camada de blob. (padrão 'None'). (padrão “Nenhum”)
--recursive Examina os subdiretórios recursivamente ao carregar do sistema de arquivos local.
--rehydrate-priority (cadeia de caracteres) Sinalizador opcional que define a prioridade de reidratação. Valores válidos: Standard, High. Padrão – standard (padrão "Standard")
Opções herdadas de comandos pai
--cap-mbps float Limita a taxa de transferência em megabits por segundo. A taxa de transferência por minuto pode variar um pouco do limite. Caso essa opção esteja definida como zero ou omitida, a taxa de transferência não tem limite.
--log-level (cadeia de caracteres) define o detalhamento do arquivo de log, com os níveis disponíveis: INFORMAÇÕES (todas as solicitações/respostas), AVISO (respostas lentas), ERRO (somente solicitações com falha) e NENHUM (sem logs de saída). (padrão 'INFO'). (padrão "INFO")
--output-type (cadeia de caracteres) Formato da saída do comando. As opções incluem: text, JSON. O valor padrão é "texto". (padrão “text”)
--output-level (cadeia de caracteres) Defina o detalhamento de saída. Níveis disponíveis: essenciais, silenciosos. (padrão "padrão")
--trusted-microsoft-suffixes (cadeia de caracteres) Especifica outros sufixos de domínio para onde os tokens de logon 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”. Todos listados aqui são adicionados ao padrão. Por segurança, você deve colocar apenas domínios do Microsoft Azure aqui. Separar várias entradas com ponto e vírgula.