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 como
BEST_EFFORT
,Atime
DataSync tentará preservar oAtime
atributo original em todos os arquivos de origem (ou seja, a versão antes daPREPARING
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 valorAtime
por arquivo (recomendado).NONE
: ignorarAtime
.nota
Se
Atime
estiver definido comoBEST_EFFORT
, oMtime
deverá ser definido comoPRESERVE
.Se
Atime
estiver definido comoNONE
, oMtime
também deverá serNONE
.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
comoOFF
, 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
: PreservarMtime
original (recomendado)NONE
: ignorarMtime
.nota
Se
Mtime
estiver definido comoPRESERVE
, oAtime
deverá ser definido comoBEST_EFFORT
.Se
Mtime
estiver definido comoNONE
, oAtime
também deverá ser definido comoNONE
.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 como
REMOVE
, 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: