Options - AWS DataSync

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

Define as configurações da sua AWS DataSync tarefa. Essas opções incluem como DataSync manipula arquivos, objetos e seus metadados associados. Você também pode especificar como DataSync verifica a integridade dos dados, define limites de largura de banda para sua tarefa, entre outras opções.

Cada configuração de tarefa tem um valor padrão. A menos que seja necessário, você não precisa configurar nenhum deles Options antes de iniciar sua tarefa.

Índice

Atime

Especifica se o deve preservar os metadados indicando a última vez que um arquivo foi lido ou gravado. Se você definir comoBEST_EFFORT, Atime DataSync tentará preservar o Atime atributo original em todos os arquivos de origem (ou seja, a versão antes da PREPARING fase de execução da tarefa).

nota

O comportamento do Atime não é totalmente padrão em todas as plataformas; portanto, o só DataSync pode fazer isso com o melhor esforço.

Valor padrão: BEST_EFFORT

BEST_EFFORT: tente preservar o valor Atime por arquivo (recomendado).

NONE: ignorar 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ê DataSync quiser que o use no máximo 1 MB, defina esse valor como 1048576 (=1024*1024).

Type: longo

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

Obrigatório: não

Gid

Especifica o ID de grupo POSIX (GID) dos proprietários do arquivo.

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

Valor padrão: INT_VALUE. Isso preserva o valor inteiro do ID.

INT_VALUE: preserve o valor inteiro de ID de usuário (UID) e GID (recomendado).

NONE: ignore UID e GID.

Tipo: String

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

Obrigatório: não

LogLevel

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

Se você definiu LogLevel como OFF, nenhum log será publicado. BASIC publica logs em erros de arquivos individuais transferidos. TRANSFER publica logs para cada arquivo ou objeto que é transferido e tem integridade verificada.

Tipo: String

Valores válidos: OFF | BASIC | TRANSFER

Obrigatório: não

Mtime

Especifica se o deve preservar os metadados indicando a última vez que um arquivo foi gravado antes da PREPARING fase de execução da tarefa. Essa opção é necessária quando você precisa executar a tarefa mais de uma vez.

Valor padrão: PRESERVE

PRESERVE: Preservar Mtime original (recomendado)

NONE: ignorar 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 as tags do objeto são preservadas durante a transferência entre sistemas de armazenamento de objetos. Se você quiser que a DataSync tarefa ignore as tags de objeto, especifique o NONE valor.

Valor padrão: PRESERVE

Tipo: String

Valores válidos: PRESERVE | NONE

Obrigatório: não

OverwriteMode

Especifica se os dados no local de destino devem ser sobrescritos ou preservados. Se definido como NEVER, um arquivo de destino, por exemplo, não será substituído por um arquivo de origem (mesmo que o arquivo de destino seja diferente do arquivo de origem). Se você modificar arquivos no destino e sincronizar os arquivos, poderá usar esse valor para proteção contra a substituição dessas alterações.

Algumas classes de armazenamento têm comportamentos específicos que podem afetar o custo de armazenamento do Amazon S3. Para obter informações detalhadas, consulte Considerações ao trabalhar com classes de armazenamento do Amazon S3 em. DataSync

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 Metadados copiados por. DataSync

Valor padrão: PRESERVE

PRESERVE: preserve as permissões de estilo POSIX (recomendado).

NONE: ignore permissões.

nota

O AWS 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. Essa opção pode afetar o custo de armazenamento do 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 classes de armazenamento do Amazon S3 em. DataSync

Valor padrão: PRESERVE

PRESERVE: ignore esses arquivos de destino (recomendado).

REMOVE: exclua arquivos de destino que não estão presentes na origem.

nota

Se você definir esse parâmetro comoREMOVE, não poderá TransferMode definir comoALL. Quando você transfere todos os dados, DataSync não verifica 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 o DataSync deve preservar os metadados dos dispositivos de bloco e caracteres no local de origem e recriar os arquivos com este nome de dispositivo e metadados no destino. DataSynccopia apenas o nome e os metadados desses dispositivos.

nota

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

Valor padrão: NONE

NONE: ignore dispositivos especiais (recomendado).

PRESERVE: preserve os caracteres e os metadados do dispositivo de blocos. Essa opção não é suportada, no momento, para o Amazon EFS.

Tipo: String

Valores válidos: NONE | PRESERVE

Obrigatório: não

SecurityDescriptorCopyFlags

Especifica quais componentes do descritor de segurança SMB devem ser copiados dos objetos de origem para o destino.

Esse valor é usado apenas para transferências entre SMB e locais do Amazon FSx for Windows File Server ou entre dois FSx para locais do Windows File Server. Para obter mais informações, consulte como DataSync lida com os metadados.

Valor padrão: OWNER_DACL

OWNER_DACL: para cada objeto copiado, DataSync copia os seguintes metadados:

  • O proprietário do objeto.

  • Listas de acesso discricionário (DACLs) do NTFS, que determinam a concessão de acesso a um objeto.

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

OWNER_DACL_SACL: para cada objeto copiado, DataSync copia os seguintes metadados:

  • O proprietário do objeto.

  • Listas de acesso discricionário (DACLs) do NTFS, que determinam a concessão de acesso a um objeto.

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

    A cópia de SACLs exige a concessão de permissões adicionais ao usuário do Windows que DataSync usa para acessar a localização da sua pequena empresa. Para obter informações sobre como escolher um usuário que garanta permissões suficientes a arquivos, pastas e metadados, consulte user.

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 definidas 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 durante determinados cenários ao executar várias tarefas. Isso é ENABLED por padrão.

Tipo: String

Valores válidos: ENABLED | DISABLED

Obrigatório: não

TransferMode

Determina se DataSync transfere apenas os dados e os metadados diferentes entre a origem e o local de destino ou transfere todo o conteúdo da origem (sem comparar o que está no destino).

CHANGED: DataSync copia apenas dados ou metadados que são conteúdo novo ou diferente do local de origem para o local de destino.

ALL: DataSync copia todo o conteúdo do local de origem para o destino (sem comparar o que está no destino).

Tipo: String

Valores válidos: CHANGED | ALL

Obrigatório: não

Uid

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

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

Valor padrão: INT_VALUE. Isso preserva o valor inteiro do ID.

INT_VALUE: preserve o valor inteiro de UID e ID de grupo (GID) (recomendado).

NONE: ignore UID e GID.

Tipo: String

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

Obrigatório: não

VerifyMode

Especifica como e quando DataSync verifica a integridade dos seus dados durante uma transferência.

Valor padrão: POINT_IN_TIME_CONSISTENT

ONLY_FILES_TRANSFERRED(recomendado): DataSync calcula a soma de verificação dos arquivos e metadados transferidos no local de origem. No final da transferência, DataSync compara essa soma de verificação com a soma de verificação calculada nesses arquivos no destino.

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

POINT_IN_TIME_CONSISTENT: no final da transferência, DataSync examina toda a origem e o destino para verificar se os dois locais estão totalmente sincronizados.

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

NONE: DataSync não executa verificação adicional no final da transferência. Todas as transmissões de dados ainda têm a integridade verificada com a verificação da soma de verificação durante a 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 um dos AWS SDKs específicos de linguagem, consulte o seguinte: