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á.
CreateReplicationConfiguration
Cria uma configuração de replicação que replica um sistema de EFS arquivos existente em um novo sistema de arquivos somente para leitura. Para obter mais informações, consulte a EFSreplicação da Amazon no Guia do EFS usuário da Amazon. A configuração de replicação básica especifica o seguinte:
-
Sistema de arquivos de origem — O sistema de EFS arquivos 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 — O Região da AWS no qual o sistema de arquivos de destino é criado. A EFS replicação da Amazon está disponível Regiões da AWS em tudo o que EFS está disponível. A região deve estar habilitada. Para obter mais informações, consulte Gerenciando Regiões da AWS no Guia de referência AWS geral.
-
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 nenhum ID for fornecido, 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 os tipos de sistema de EFS arquivos no Guia EFS do usuário da Amazon.
-
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 KMS chave, sua KMS chave gerenciada por serviços para a Amazon EFS será usada.
nota
Depois que o sistema de arquivos for criado, você não poderá alterar a KMS chave.
-
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 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 taxa de transferência: o modo de taxa de transferência 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á ativado 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 a EFSreplicação da Amazon no Guia do EFS usuário da Amazon.
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"
}
]
}URIParâmetros de solicitação
A solicitação usa os seguintes URI parâmetros.
- SourceFileSystemId
-
Especifica o sistema de EFS arquivos da Amazon 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 seguintes dados no JSON formato.
- 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 de 200.
Os dados a seguir são retornados em JSON formato 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 Amazon Resource Name (ARN) do sistema de EFS arquivos de origem original na configuração de replicação.
Tipo: string
- SourceFileSystemArn
-
O Amazon Resource Name (ARN) do sistema de arquivos de origem atual na configuração de replicação.
Tipo: string
- SourceFileSystemId
-
O ID do sistema de EFS arquivos de origem da Amazon 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
-
O Região da AWS em que o sistema de EFS arquivos 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.
HTTPCódigo de status: 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.
HTTPCódigo de status: 409
- FileSystemLimitExceeded
-
Retornado se o já Conta da AWS tiver criado o número máximo de sistemas de arquivos permitidos por conta.
HTTPCódigo de status: 403
- FileSystemNotFound
-
Retornado se o
FileSystemIdvalor especificado não existir no valor do Conta da AWS solicitante.HTTPCódigo de status: 404
- IncorrectFileSystemLifeCycleState
-
Retornado se o estado do ciclo de vida do sistema de arquivos não estiver “disponível”.
HTTPCódigo de status: 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.
HTTPCódigo de status: 503
- InternalServerError
-
Retornado se ocorreu um erro no lado do servidor.
HTTPCódigo de status: 500
- ReplicationNotFound
-
Retornado se o sistema de arquivos especificado não tiver uma configuração de replicação.
HTTPCódigo de status: 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.
HTTPCódigo de status: 400
- UnsupportedAvailabilityZone
-
Retornado se a EFS funcionalidade solicitada pela Amazon não estiver disponível na zona de disponibilidade especificada.
HTTPCódigo de status: 400
- ValidationException
-
Retornado se o AWS Backup serviço não estiver disponível no Região da AWS local em que a solicitação foi feita.
HTTPCódigo de status: 400
Consulte também
Para obter mais informações sobre como usar isso API em um idioma específico AWS SDKs, consulte o seguinte:
