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](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html). 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. 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`. 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`). 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](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html). 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](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html#DataSync-CreateTask-request-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 que indicam a última vez que um arquivo foi lido ou gravado devem ser preservados antes da etapa de `PREPARING` da 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`. 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](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes). + `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](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html). + `PRESERVE` (padrão): preserva as permissões no estilo POSIX, o que é recomendado. + `NONE`: ignora as permissões no estilo POSIX. 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](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes) 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. 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. 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](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html). + `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](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions), [FSx Windows File Server](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions) ou [FSx ONTAP](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-smb) (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](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#running-multiple-tasks). 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 estiver planejando transferências recorrentes, talvez queira transferir somente 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](https://docs.aws.amazon.com/datasync/latest/userguide/special-files.html#metadata-copied) 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](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Recomendamos esta opção ao transferir para as classes 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](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes). + `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](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html) e atualmente não é compatível com as tarefas do modo Avançado. Se você usa um [manifesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html), 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](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes). + `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: + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/Options) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/Options) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/Options)