Options - AWS DataSync
ConteúdoConsulte também

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Options

Indica como sua tarefa de transferência está configurada. Essas opções incluem como DataSync manipula arquivos, objetos e seus metadados associados durante a transferência. Você também pode especificar como verificar a integridade dos dados, definir limites de largura de banda para sua tarefa, entre outras opções.

Cada opção tem um valor padrão. A menos que seja necessário, você não precisa configurar nenhuma opção antes de ligar StartTaskExecution.

Você também pode substituir suas opções de tarefa para cada execução de tarefa. Por exemplo, pode ser bom ajustar o LogLevel para uma execução individual.

Conteúdo

Atime

Especifica se os metadados que indicam a última vez que um arquivo foi lido ou gravado devem ser preservados.

nota

O comportamento do Atime não é totalmente padrão em todas as plataformas, então só DataSync posso fazer isso com base no melhor esforço.

  • BEST_EFFORT(padrão) - DataSync tenta preservar o Atime atributo original em todos os arquivos de origem (ou seja, a versão anterior às PREPARING etapas da execução da tarefa). Essa opção não é recomendada.

  • NONE: ignora Atime.

nota

Se Atime estiver definido como BEST_EFFORT, o Mtime deverá ser definido como PRESERVE.

Se Atime estiver definido como NONE, o Mtime também deverá ser NONE.

Tipo: string

Valores Válidos: NONE | BEST_EFFORT

Obrigatório: não

BytesPerSecond

Limita a largura de banda usada por uma DataSync tarefa. Por exemplo, se você quiser DataSync usar no máximo 1 MB, defina esse valor como 1048576 (=1024*1024).

nota

Não aplicável às tarefas do modo Avançado.

Tipo: longo

Intervalo válido: valor mínimo de -1.

Obrigatório: não

Gid

O ID do grupo (GID) POSIX dos proprietários do arquivo.

  • INT_VALUE (padrão): preserva o valor inteiro do ID do usuário (UID) e do ID de grupo (GID), o que é recomendado.

  • NONE: ignora o UID e o GID.

Para obter mais informações, consulte Entendendo como DataSync manipula metadados de arquivos e objetos.

Tipo: string

Valores Válidos: NONE | INT_VALUE | NAME | BOTH

Obrigatório: não

LogLevel

Especifica o tipo de registros que são DataSync publicados em um grupo de registros do Amazon CloudWatch Logs. Para especificar o grupo de registros, consulte CloudWatchLogGroupArn.

  • BASIC: publica logs apenas com informações básicas (como erros de transferência).

  • TRANSFER- Publica registros de todos os arquivos ou objetos que sua DataSync tarefa transfere e realiza verificações de integridade de dados.

  • OFF: nenhum log é publicado.

Tipo: string

Valores Válidos: OFF | BASIC | TRANSFER

Obrigatório: não

Mtime

Especifica se os metadados devem ser preservados indicando a última vez em que um arquivo foi gravado antes da PREPARING etapa de execução da tarefa. Esta opção é necessária para casos em que você precisa executar a mesma tarefa mais de uma vez.

  • PRESERVE (padrão): preserva o Mtime original, o que é recomendado.

  • NONE: ignora Mtime.

nota

Se Mtime estiver definido como PRESERVE, o Atime deverá ser definido como BEST_EFFORT.

Se Mtime estiver definido como NONE, o Atime também deverá ser definido como NONE.

Tipo: string

Valores Válidos: NONE | PRESERVE

Obrigatório: não

ObjectTags

Especifica se você deseja DataSync PRESERVE objetar tags (comportamento padrão) ao transferir entre sistemas de armazenamento de objetos. Se você quiser que sua DataSync tarefa ignore as tags de objeto, especifique o NONE valor.

Tipo: string

Valores Válidos: PRESERVE | NONE

Obrigatório: não

OverwriteMode

Especifica se os dados DataSync devem ser modificados ou preservados no local de destino.

  • ALWAYS(padrão) - DataSync modifica os dados no local de destino quando os dados de origem (incluindo metadados) são alterados.

    Se DataSync sobrescrever objetos, você poderá incorrer em cobranças adicionais para determinadas classes de armazenamento do Amazon S3 (por exemplo, para recuperação ou exclusão antecipada). Para obter mais informações, consulte Considerações sobre classes de armazenamento com transferências do Amazon S3.

  • NEVER- DataSync não sobrescreve os dados no local de destino, mesmo que os dados de origem tenham sido alterados. Você pode usar essa opção como proteção contra a substituição de alterações feitas em arquivos ou objetos no destino.

Tipo: string

Valores Válidos: ALWAYS | NEVER

Obrigatório: não

PosixPermissions

Especifica quais usuários ou grupos podem acessar um arquivo para uma finalidade específica, como leitura, gravação ou execução do arquivo.

Para obter mais informações, consulte Entendendo como DataSync manipula metadados de arquivos e objetos.

  • PRESERVE (padrão): preserva as permissões no estilo POSIX, o que é recomendado.

  • NONE: ignora as permissões no estilo POSIX.

nota

DataSync pode preservar as permissões existentes de um local de origem.

Tipo: string

Valores Válidos: NONE | PRESERVE

Obrigatório: não

PreserveDeletedFiles

Especifica se os arquivos no local de destino que não existem na origem devem ser preservados. Esta opção pode afetar seu custo do armazenamento no Amazon S3. Se a tarefa excluir objetos, você poderá estar sujeito a cobranças mínimas de duração de armazenamento para determinadas classes de armazenamento. Para obter informações detalhadas, consulte Considerações ao trabalhar com as classes de armazenamento do Amazon S3 em. DataSync

  • PRESERVE (padrão): ignora esses arquivos de destino, o que é recomendado.

  • REMOVE: exclui os arquivos de destino que não estão presentes na origem.

nota

Se você definir este parâmetro como REMOVE, não poderá definir TransferMode como ALL. Quando você transfere todos os dados, DataSync não escaneia sua localização de destino e não sabe o que excluir.

Tipo: string

Valores Válidos: PRESERVE | REMOVE

Obrigatório: não

PreserveDevices

Especifica se os metadados dos dispositivos de blocos e caracteres DataSync devem ser preservados no local de origem e recriar os arquivos com o nome do dispositivo e os metadados no destino. DataSync copia somente o nome e os metadados desses dispositivos.

nota

DataSync não consigo copiar o conteúdo real desses dispositivos porque eles não são terminais e não retornam um marcador end-of-file (EOF).

  • NONE (padrão): ignora dispositivos especiais (recomendado).

  • PRESERVE: preserva os metadados de caractere e dispositivo de blocos. Esta opção não é compatível, no momento, com o Amazon EFS.

Tipo: string

Valores Válidos: NONE | PRESERVE

Obrigatório: não

SecurityDescriptorCopyFlags

Especifica os componentes do descritor de segurança SMB que são copiados dos objetos de origem para o destino.

Esse valor é usado somente para transferências entre SMB e Amazon FSx para locais do Windows File Server ou entre dois FSx para locais do Windows File Server. Para obter mais informações, consulte Entendendo como DataSync manipula metadados de arquivos e objetos.

  • OWNER_DACL(padrão) - Para cada objeto copiado, DataSync copia os seguintes metadados:

    • O proprietário do objeto.

    • Listas de controle de acesso discricionário do NTFS (DACLs), que determinam se o acesso a um objeto deve ser concedido.

      DataSync não copiará listas de controle de acesso do sistema NTFS (SACLs) com essa opção.

  • OWNER_DACL_SACL- Para cada objeto copiado, DataSync copie os seguintes metadados:

    • O proprietário do objeto.

    • Listas de controle de acesso discricionário do NTFS (DACLs), que determinam se o acesso a um objeto deve ser concedido.

    • SACLs, que são usados pelos administradores para registrar tentativas de acesso a um objeto protegido.

      A cópia SACLs requer a concessão de permissões adicionais ao usuário do Windows que DataSync usa para acessar sua localização SMB. Para obter informações sobre como escolher um usuário com as permissões corretas, consulte Permissões necessárias para SMB, FSx Windows File Server ou FSx ONTAP (dependendo do tipo de local em sua transferência).

  • NONE: nenhum dos componentes do descritor de segurança SMB é copiado. Os objetos de destino pertencem ao usuário que foi fornecido para acessar o local de destino. DACLs e SACLs são definidos com base na configuração do servidor de destino.

Tipo: string

Valores Válidos: NONE | OWNER_DACL | OWNER_DACL_SACL

Obrigatório: não

TaskQueueing

Especifica se suas tarefas de transferência devem ser colocadas em uma fila em determinados cenários ao executar várias tarefas. Isto é ENABLED por padrão.

Tipo: string

Valores Válidos: ENABLED | DISABLED

Obrigatório: não

TransferMode

Especifica se DataSync transfere somente os dados (incluindo metadados) que diferem entre os locais após uma cópia inicial ou se transfere todos os dados sempre que você executa a tarefa. Se você planeja transferências recorrentes, talvez queira transferir apenas o que mudou desde a execução anterior da tarefa.

  • CHANGED(padrão) - Após a transferência inicial completa, DataSync copia somente os dados e os metadados que diferem entre o local de origem e o local de destino.

  • ALL- DataSync copia tudo na origem para o destino sem comparar as diferenças entre os locais.

Tipo: string

Valores Válidos: CHANGED | ALL

Obrigatório: não

Uid

Especifica o ID de usuário (UID) do POSIX do proprietário do arquivo.

  • INT_VALUE (padrão): preserva o valor inteiro do UID do usuário e do ID de grupo (GID), o que é recomendado.

  • NONE: ignora o UID e o GID.

Para obter mais informações, consulte Metadados copiados por. DataSync

Tipo: string

Valores Válidos: NONE | INT_VALUE | NAME | BOTH

Obrigatório: não

VerifyMode

Especifica se e como DataSync verifica a integridade dos seus dados no final da transferência.

  • ONLY_FILES_TRANSFERRED(recomendado) - DataSync calcula a soma de verificação dos dados transferidos (incluindo metadados) no local de origem. Ao final da transferência, DataSync compara essa soma de verificação com a soma de verificação calculada com base nesses dados no destino.

    nota

    Essa é a opção padrão para tarefas do modo Avançado.

    Recomendamos esta opção ao transferir para asclasses de armazenamento do S3 Glacier Flexible Retrieval ou para o S3 Glacier Deep Archive. Para obter mais informações, consulte Considerações sobre a classe de armazenamento com locais do Amazon S3.

  • POINT_IN_TIME_CONSISTENT- Ao final da transferência, DataSync verifica toda a origem e o destino para verificar se os dois locais estão totalmente sincronizados.

    nota

    Essa é a opção padrão para tarefas do modo Básico e atualmente não é compatível com as tarefas do modo Avançado.

    Se você usa um manifesto, DataSync apenas digitaliza e verifica o que está listado no manifesto.

    Você não pode usar esta opção em transferências para as classes de armazenamento S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive. Para obter mais informações, consulte Considerações sobre a classe de armazenamento com locais do Amazon S3.

  • NONE- DataSync realiza verificações de integridade de dados somente durante sua transferência. Ao contrário de outras opções, não há verificação adicional no fim da transferência.

Tipo: string

Valores Válidos: POINT_IN_TIME_CONSISTENT | ONLY_FILES_TRANSFERRED | NONE

Obrigatório: Não

Consulte também

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte: