azcopy set-properties (versão prévia)
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 Gen2 –> Camada, Metadados, Marcas
- Arquivos –> Metadados
Observação
Os pontos de extremidade do Data Lake Storage Gen2 serão substituídos por pontos de extremidade do Armazenamento de Blobs.
Confira os exemplos para saber mais.
Artigos conceituais relacionados
- Introdução ao AzCopy
- Substituir propriedades e metadados de blobs usando o AzCopy v10 (versão prévia)
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 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 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
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
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
string Defina tags 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.