CreateReplicationConfiguration - Amazon Elastic File System
Sintaxe da SolicitaçãoParâmetros da Solicitação de URICorpo da SolicitaçãoSintaxe da RespostaElementos de RespostaErrosConsulte Também

CreateReplicationConfiguration

Cria uma configuração de replicação de um sistema de arquivos EFS existente para um novo sistema de arquivos somente para leitura. Para obter mais informações, consulte Replicação do Amazon EFS no Guia do usuário do Amazon EFS. A configuração de replicação básica especifica o seguinte:

  • Sistema de arquivos de origem: um sistema de arquivos EFS que você deseja replicar. O sistema de arquivos de origem não pode ser um sistema de arquivos de destino em uma configuração de replicação existente.

  • Região da AWS: a Região da AWS na qual o sistema de arquivos de destino é criado. A replicação do Amazon EFS está disponível em todas as Regiões da AWS em que o EFS está disponível. A região deve estar habilitada. Para mais informações, consulte Gerenciar Regiões da AWS em Guia de referência geral da AWS

  • Configuração do sistema de arquivos de destino; a configuração do sistema de arquivos de destino para o qual o sistema de arquivos de origem será replicado. Só pode haver um sistema de arquivos de destino em uma configuração de replicação.

    Os parâmetros para a configuração de replicação incluem:

    • ID do sistema de arquivos: o ID do sistema de arquivos de destino para a replicação. Se nenhuma ID for fornecida, o EFS criará um novo sistema de arquivos com as configurações padrão. Para sistemas de arquivos existentes, a proteção contra substituição de replicação do sistema de arquivos deve estar desativada. Para obter mais informações, consulte Como replicar para um sistema de arquivos existente.

    • Zona de disponibilidade: se você quiser que o sistema de arquivos de destino use o armazenamento One Zone, você deverá especificar a zona de disponibilidade na qual criar o sistema de arquivos. Para obter mais informações, consulte Tipos de sistema de arquivos EFS no Guia do usuário do Amazon EFS.

    • Criptografia: todos os sistemas de arquivos de destino são criados com a criptografia em repouso ativada. Você pode especificar a chave AWS Key Management Service (AWS KMS) usada para criptografar o sistema de arquivos de destino. Se você não especificar uma chave KMS, sua chave KMS gerenciada pelo serviço para Amazon EFS será usada.

      nota

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

Para novos sistemas de arquivos de destino, as seguintes propriedades são definidas por padrão:

  • Modo de desempenho: o modo de desempenho do sistema de arquivos de destino corresponde ao do sistema de arquivos de origem, a menos que o sistema de arquivos de destino use o armazenamento EFS One Zone. Nesse caso, o modo de desempenho de uso geral é usado. O modo de desempenho não pode ser alterado.

  • Modo de throughput: o modo de throughput do sistema de arquivos de destino corresponde ao do sistema de arquivos de origem. Depois que o sistema de arquivos for criado, você poderá modificar o modo de throughput.

  • Gerenciamento do ciclo de vida: o gerenciamento do ciclo de vida não está habilitado no sistema de arquivos de destino. Depois que o sistema de arquivos de destino for criado, você poderá ativar o gerenciamento do ciclo de vida.

  • Backups automáticos: os backups diários automáticos são ativados no sistema de arquivos de destino. Depois que o sistema de arquivos for criado, você poderá alterar essa configuração.

Para obter mais informações, consulte Replicação do Amazon EFS no Guia do usuário do Amazon EFS.

Sintaxe da Solicitação

POST /2015-02-01/file-systems/SourceFileSystemId/replication-configuration HTTP/1.1
Content-type: application/json

{
   "Destinations": [ 
      { 
         "AvailabilityZoneName": "string",
         "FileSystemId": "string",
         "KmsKeyId": "string",
         "Region": "string"
      }
   ]
}

Parâmetros da Solicitação de URI

A solicitação usa os seguintes parâmetros de URI:

SourceFileSystemId

Especifica o sistema de arquivos do Amazon EFS que você deseja replicar. Esse sistema de arquivos não pode ser um sistema de arquivos de origem ou destino em outra configuração de replicação.

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})$

Exigido: Sim

Corpo da Solicitação

A solicitação aceita os dados a seguir no formato JSON.

Destinations

Uma matriz de objetos de configuração de destino. Somente um objeto de configuração de destino é compatível.

Tipo: matriz de objetos DestinationToCreate

Exigido: Sim

Sintaxe da Resposta

HTTP/1.1 200
Content-type: application/json

{
   "CreationTime": number,
   "Destinations": [ 
      { 
         "FileSystemId": "string",
         "LastReplicatedTimestamp": number,
         "Region": "string",
         "Status": "string"
      }
   ],
   "OriginalSourceFileSystemArn": "string",
   "SourceFileSystemArn": "string",
   "SourceFileSystemId": "string",
   "SourceFileSystemRegion": "string"
}

Elementos de Resposta

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

CreationTime

Descreve quando a configuração de replicação foi criada.

Tipo: carimbo de data/hora

Destinations

Uma matriz de objetos de destino. Somente um objeto de destino é compatível.

Tipo: matriz de objetos Destination

OriginalSourceFileSystemArn

O nome do recurso da Amazon (ARN) do sistema de arquivos do EFS de origem original na configuração de replicação.

Tipo: string

SourceFileSystemArn

O nome do recurso da Amazon (ARN) do sistema de arquivos de origem atual na configuração de replicação.

Tipo: string

SourceFileSystemId

O ID do sistema de arquivos do Amazon EFS de origem que está sendo replicado.

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})$

SourceFileSystemRegion

A Região da AWS em que o sistema de arquivos EFS de origem está localizado.

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}$

Erros

BadRequest

Retornado se a solicitação estiver malformada ou contiver um erro, como um valor de parâmetro inválido ou um parâmetro obrigatório ausente.

Código de Status HTTP: 400

ConflictException

Retornado se o sistema de arquivos de origem em uma replicação estiver criptografado, mas o sistema de arquivos de destino não estiver criptografado.

Código de Status HTTP: 409

FileSystemLimitExceeded

Retornado se a Conta da AWS já tiver criado o número máximo de sistemas de arquivos permitidos por conta.

Código de Status HTTP: 403

FileSystemNotFound

Retornado se o valor especificado de FileSystemId não existir na Conta da AWS solicitante.

Código de Status HTTP: 404

IncorrectFileSystemLifeCycleState

Retornado se o estado do ciclo de vida do sistema de arquivos não estiver “disponível”.

Código de Status HTTP: 409

InsufficientThroughputCapacity

Retornado se não houver capacidade suficiente para provisionar throughput adicional. Esse valor pode ser retornado ao tentar criar um sistema de arquivos no modo de taxa de transferência provisionada, ao tentar aumentar a taxa de transferência provisionada de um sistema de arquivos existente ou ao tentar alterar um sistema de arquivos existente do modo de taxa de transferência intermitente para o modo de taxa de transferência provisionada. Tente novamente mais tarde.

Código de status HTTP: 503

InternalServerError

Retornado se ocorreu um erro no lado do servidor.

Código de Status HTTP: 500

ReplicationNotFound

Retornado se o sistema de arquivos especificado não tiver uma configuração de replicação.

Código de Status HTTP: 404

ThroughputLimitExceeded

Retornado se o modo de taxa de transferência ou a quantidade de taxa de transferência provisionada não puderem ser alterados porque o limite de taxa de transferência de 1024 MiB/s foi atingido.

Código de Status HTTP: 400

UnsupportedAvailabilityZone

Retornado se a funcionalidade solicitada do Amazon EFS não estiver disponível na zona de disponibilidade especificada.

Código de Status HTTP: 400

ValidationException

Retornado se o serviço de AWS Backup não estiver disponível na Região da AWS em que a solicitação foi feita.

Código de Status HTTP: 400

Consulte Também

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