Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
CreateReplicationConfiguration
Crea una configuración de replicación que replica un sistema de EFS archivos existente en un nuevo sistema de archivos de solo lectura. Para obtener más información, consulte la EFSreplicación de Amazon en la Guía del EFS usuario de Amazon. La siguiente configuración de replicación básica especifica lo siguiente:
-
Sistema de archivos de origen: el sistema de EFS archivos que desea replicar. El sistema de archivos de origen no puede ser un sistema de archivos de destino en una configuración de replicación existente.
-
Región de AWS — El sistema Región de AWS en el que se crea el sistema de archivos de destino. La EFS replicación de Amazon está disponible Regiones de AWS en todos los EFS lugares disponibles. Debe habilitarse la región. Para obtener más información, consulte Administración Regiones de AWS en la Guía de referencia de referencia AWS general.
-
Configuración del sistema de archivos de destino: la configuración del sistema de archivos de destino en el que se replicará el sistema de archivos de origen. Solo puede haber un sistema de archivos de destino en una configuración de replicación.
Los parámetros de la configuración de replicación incluyen:
-
ID del sistema de archivos: el ID del sistema de archivos de destino para la replicación. Si no se proporciona ningún identificador, EFS crea un nuevo sistema de archivos con la configuración predeterminada. Para los sistemas de archivos existentes, la protección contra sobrescritura de la replicación del sistema de archivos debe estar deshabilitada. Para obtener más información, consulte Replicación en un sistema de archivos existente.
-
Zona de disponibilidad: si quiere que el sistema de archivos de destino utilice almacenamiento One Zone, debe especificar la zona de disponibilidad en la que crear el sistema de archivos. Para obtener más información, consulta los tipos de sistemas de EFS archivos en la Guía del EFS usuario de Amazon.
-
Cifrado: todos los sistemas de archivos de destino se crean con el cifrado en reposo activado. Puede especificar la clave AWS Key Management Service (AWS KMS) que se utiliza para cifrar el sistema de archivos de destino. Si no especificas una KMS clave, se utilizará tu KMS clave gestionada por el servicio para AmazonEFS.
nota
Una vez creado el sistema de archivos, no puedes cambiar la KMS clave.
-
Para los nuevos sistemas de archivos de destino, las siguientes propiedades están configuradas de forma predeterminada:
-
Modo de rendimiento: el modo de rendimiento del sistema de archivos de destino coincide con el del sistema de archivos de origen, a menos que el sistema de archivos de destino utilice el almacenamiento EFS One Zone. En ese caso, se utiliza el modo de rendimiento de uso general. El modo de rendimiento no se puede cambiar.
-
Modo de rendimiento: el modo de rendimiento del sistema de archivos de destino coincide con el del sistema de archivos de origen. Después de crear el sistema de archivos, puede modificar el modo de rendimiento.
-
administración del ciclo de vida: la administración del ciclo de vida no está habilitada en el sistema de archivos de destino. Una vez creado el sistema de archivos de destino, puede habilitar la administración del ciclo de vida.
-
Copias de seguridad automáticas: las copias de seguridad diarias automáticas están habilitadas en el sistema de archivos de destino. Después de crear el sistema de archivos, puede cambiar esta configuración.
Para obtener más información, consulte la EFSreplicación de Amazon en la Guía del EFS usuario de Amazon.
Sintaxis de la solicitud
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 solicitud
La solicitud utiliza los siguientes URI parámetros.
- SourceFileSystemId
-
Especifica el sistema de EFS archivos de Amazon que desea replicar. Este sistema de archivos no puede ser un sistema de archivos de origen o de destino en otra configuración de replicación.
Limitaciones de longitud: longitud máxima de 128 caracteres.
Patrón:
^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$Obligatorio: sí
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en JSON formato.
- Destinations
-
Una gama de objetos de configuración de destino. Solo se admite un objeto de configuración de destino.
Tipo: matriz de objetos DestinationToCreate
Obligatorio: sí
Sintaxis de la respuesta
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 respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta de HTTP 200.
El servicio devuelve los siguientes datos en JSON formato.
- CreationTime
-
Describe cuándo se creó la configuración de replicación.
Tipo: marca temporal
- Destinations
-
Una gama de objetos de destino. Solo se admite un objeto de destino.
Tipo: matriz de objetos Destination
- OriginalSourceFileSystemArn
-
El nombre del recurso de Amazon (ARN) del sistema de EFS archivos de origen original en la configuración de replicación.
Tipo: cadena
- SourceFileSystemArn
-
El nombre del recurso de Amazon (ARN) del sistema de archivos fuente actual en la configuración de replicación.
Tipo: cadena
- SourceFileSystemId
-
El ID del sistema de EFS archivos Amazon de origen que se está replicando.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 128 caracteres.
Patrón:
^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$ - SourceFileSystemRegion
-
El Región de AWS en el que se encuentra el sistema de EFS archivos de origen.
Tipo: string
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.
Patrón:
^[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-{0,1}[0-9]{0,1}$
Errores
- BadRequest
-
Se devuelve si la solicitud tiene un formato incorrecto o contiene un error, como un valor de parámetro no válido, o falta un parámetro obligatorio.
HTTPCódigo de estado: 400
- ConflictException
-
Se devuelve si el sistema de archivos de origen de una replicación está cifrado pero el sistema de archivos de destino no está cifrado.
HTTPCódigo de estado: 409
- FileSystemLimitExceeded
-
Se devuelve si ya Cuenta de AWS se ha creado el número máximo de sistemas de archivos permitidos por cuenta.
HTTPCódigo de estado: 403
- FileSystemNotFound
-
Se devuelve si el
FileSystemIdvalor especificado no existe en el del Cuenta de AWS solicitante.HTTPCódigo de estado: 404
- IncorrectFileSystemLifeCycleState
-
Se devuelve si el estado del ciclo de vida del sistema de archivos es no “disponible”.
HTTPCódigo de estado: 409
- InsufficientThroughputCapacity
-
Se devuelve si no hay suficiente capacidad para aprovisionar un rendimiento adicional. Este valor puede devolverse al intentar crear un sistema de archivos en el modo de rendimiento aprovisionado, al intentar aumentar el rendimiento aprovisionado de un sistema de archivos existente o al intentar cambiar un sistema de archivos existente del modo de rendimiento de ráfaga al de rendimiento aprovisionado. Inténtelo de nuevo más tarde.
HTTPCódigo de estado: 503
- InternalServerError
-
Se devuelve si se ha producido un error en el servidor.
HTTPCódigo de estado: 500
- ReplicationNotFound
-
Se devuelve si el sistema de archivos especificado no tiene una configuración de replicación.
HTTPCódigo de estado: 404
- ThroughputLimitExceeded
-
Se devuelve si el modo de rendimiento o la cantidad de rendimiento aprovisionada no se pueden cambiar porque se ha alcanzado el límite de rendimiento de 1024 MiB/s.
HTTPCódigo de estado: 400
- UnsupportedAvailabilityZone
-
Se devuelve si la EFS funcionalidad de Amazon solicitada no está disponible en la zona de disponibilidad especificada.
HTTPCódigo de estado: 400
- ValidationException
-
Se devuelve si el AWS Backup servicio no está disponible en el lugar Región de AWS en el que se realizó la solicitud.
HTTPCódigo de estado: 400
Véase también
Para obtener más información sobre cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
