DestinationToCreate - Amazon Elastic File System

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á.

DestinationToCreate

Descreve o sistema de arquivos de destino novo ou existente na configuração de replicação.

  • Se você quiser replicar para um novo sistema de arquivos, não especifique o ID do sistema de arquivos de destino. O Amazon EFS cria um sistema de arquivos vazio. Para o armazenamento One Zone, especifique a zona de disponibilidade na qual criar o sistema de arquivos. Para usar uma chave do AWS Key Management Service diferente da chave do KMS padrão, especifique-a. Para acessar mais informações, consulte Configurar a replicação para o novo sistema de arquivos EFS no Guia do usuário do Amazon EFS.

    nota

    Após a criação do sistema de arquivos, você não poderá alterar a chave do KMS nem o modo de performance.

  • Se você quiser realizar a replicação para um sistema de arquivos existente que esteja na mesma conta que o sistema de arquivos de origem, precisará fornecer o ID ou o nome do recurso da Amazon (ARN) do sistema de arquivos para o qual replicar. A proteção contra substituição de replicação do sistema de arquivos deve estar desabilitada. Para acessar mais informações, consulte Replicar para um sistema de arquivos existente no Guia do usuário do Amazon EFS.

  • Se você estiver replicando o sistema de arquivos em um sistema que esteja em uma conta diferente do sistema de arquivos de origem (replicação entre contas), precisará fornecer o ARN para o sistema de arquivos e o perfil do IAM que permite que o Amazon EFS execute a replicação na conta de destino. A proteção contra substituição de replicação do sistema de arquivos deve estar desabilitada. Para acessar mais informações, consulte Replicar em Contas da AWS no Guia do usuário do Amazon EFS.

Conteúdo

AvailabilityZoneName

Para criar um sistema de arquivos que usa armazenamento One Zone, especifique o nome da zona de disponibilidade que deseja criar o sistema de arquivos de destino.

Tipo: String

Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.

Padrão: : .+

Obrigatório: Não

FileSystemId

O ID ou o ARN do sistema de arquivos a ser usado para o destino. Para replicação entre contas, isso deve ser um ARN. A replicação por substituição do sistema de arquivos deve estar desativada. Se nenhum ID ou ARN for especificado, um novo sistema de arquivos será criado.

nota

Quando você configura inicialmente a replicação para um sistema de arquivos existente, o Amazon EFS grava ou remove dados existentes do sistema de arquivos de destino para comparar com os dados no sistema de arquivos de origem. Se você não quiser alterar os dados no sistema de arquivos de destino, deverá realizar a replicação para um novo sistema de arquivos. Para obter mais informações, consulte https://docs.aws.amazon.com/efs/latest/ug/create-replication.html.

Tipo: String

Restrições de tamanho: tamanho máximo de 128.

Padrão: : ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

Obrigatório: Não

KmsKeyId

Especifique a chave AWS Key Management Service (AWS KMS) que você deseja usar para criptografar o sistema de arquivos de destino. Se você não especificar uma chave do KMS, o Amazon EFS usará a chave padrão do KMS para o Amazon EFS, /aws/elasticfilesystem. Esse ID pode ter um dos seguintes formatos:

  • ID da chave: um identificador exclusivo da chave, por exemplo, 1234abcd-12ab-34cd-56ef-1234567890ab.

  • ARN: o ARN da chave, por exemplo, arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab.

  • Alias da chave: um nome de exibição criado anteriormente para uma chave, por exemplo, alias/projectKey1.

  • ARN do alias da chave: um ARN para um alias da chave, por exemplo, arn:aws:kms:us-west-2:444455556666:alias/projectKey1.

Tipo: String

Restrições de tamanho: tamanho máximo de 2048.

Padrão: : ^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|mrk-[0-9a-f]{32}|alias/[a-zA-Z0-9/_-]+|(arn:aws[-a-z]*:kms:[a-z0-9-]+:\d{12}:((key/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})|(key/mrk-[0-9a-f]{32})|(alias/[a-zA-Z0-9/_-]+))))$

Obrigatório: Não

Region

Para criar um sistema de arquivos que use armazenamento regional, especifique a Região da AWS no qual criar o sistema de arquivos de destino. A região deve estar habilitada para Conta da AWS proprietária do sistema de arquivos de origem. Para mais informações, consulte Gerenciar Regiões da AWS em Guia de referência geral da AWS

Tipo: String

Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.

Padrão: : ^[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-{0,1}[0-9]{0,1}$

Obrigatório: Não

RoleArn

O nome do recurso da Amazon (ARN) do perfil do IAM na conta de origem que permite ao Amazon EFS realizar a replicação em seu nome. Isso é opcional para replicação na mesma conta, mas necessário para replicação entre contas.

Tipo: String

Restrições de tamanho: tamanho máximo de 2048.

Padrão: : arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+

Obrigatório: Não

Consulte também

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte: