Detalles del tipo de cambio Información adicional Parámetros de entrada de ejecución Ejemplo: Parámetros necesarios Ejemplo: todos los parámetros

Almacenamiento S3 | Agregar regla de replicación

Agregue una regla de replicación de S3 al depósito de S3 especificado.

Clasificación completa: administración | Componentes de pila avanzados | Almacenamiento S3 | Agregar regla de replicación

Detalles del tipo de cambio

ID de tipo de cambio	ct-31eb7rrxb7qju
Versión actual	1.0
Duración prevista de la ejecución	10 minutos
Aprobación de AWS	Obligatorio
Aprobación del cliente	No obligatorio
Modo de ejecución	Automatizado

Información adicional

Añadir regla de replicación

A continuación se muestra este tipo de cambio en la consola AMS.

Add S3 replication rule interface with description, ID, and version fields.

Cómo funciona:

Vaya a la página Crear RFC: en el panel de navegación izquierdo de la consola AMS, haga clic RFCspara abrir la página de RFCs listas y, a continuación, haga clic en Crear RFC.
Elija un tipo de cambio (CT) popular en la vista predeterminada de búsqueda de tipos de cambios o seleccione un CT en la vista Elegir por categoría.
- Busque por tipo de cambio: puede hacer clic en un CT popular del área de creación rápida para abrir inmediatamente la página Ejecutar RFC. Tenga en cuenta que no puede elegir una versión antigua de CT con Quick Create.
  
  Para ordenar CTs, utilice el área Todos los tipos de cambios en la vista de tarjeta o de tabla. En cualquiera de las vistas, seleccione una CT y, a continuación, haga clic en Crear RFC para abrir la página Ejecutar RFC. Si corresponde, aparece la opción Crear con una versión anterior junto al botón Crear RFC.
- Elegir por categoría: seleccione una categoría, una subcategoría, un elemento y una operación, y se abrirá el cuadro de detalles del CT con la opción Crear con una versión anterior, si corresponde. Haga clic en Crear RFC para abrir la página Ejecutar RFC.
En la página Ejecutar RFC, abra el área del nombre del CT para ver el cuadro de detalles del CT. Se requiere un asunto (lo rellena automáticamente si elige su CT en la vista Buscar tipos de cambios). Abra el área de configuración adicional para añadir información sobre la RFC.

En el área de configuración de ejecución, utilice las listas desplegables disponibles o introduzca valores para los parámetros necesarios. Para configurar los parámetros de ejecución opcionales, abra el área de configuración adicional.
Cuando haya terminado, haga clic en Ejecutar. Si no hay errores, aparecerá la página de la RFC creada correctamente con los detalles de la RFC enviada y el resultado inicial de la ejecución.
Abra el área de parámetros de ejecución para ver las configuraciones que envió. Actualice la página para actualizar el estado de ejecución de la RFC. Si lo desea, cancele la RFC o cree una copia de la misma con las opciones de la parte superior de la página.

Cómo funciona:

Utilice la función de creación en línea (se emite un create-rfc comando con todos los parámetros de ejecución y RFC incluidos) o la de plantilla (se crean dos archivos JSON, uno para los parámetros de RFC y otro para los parámetros de ejecución) y ejecute el create-rfc comando con los dos archivos como entrada. Ambos métodos se describen aquí.
Envíe el aws amscm submit-rfc --rfc-id ID comando RFC: con el ID de RFC devuelto.

Supervise el comando RFC:. aws amscm get-rfc --rfc-id ID

Para comprobar la versión del tipo de cambio, utilice este comando:


aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CT_ID

nota

Puede utilizar cualquier CreateRfc parámetro con cualquier RFC, forme o no parte del esquema del tipo de cambio. Por ejemplo, para recibir notificaciones cuando cambie el estado de la RFC, añada esta línea --notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}" a la parte de los parámetros de la RFC de la solicitud (no a los parámetros de ejecución). Para ver una lista de todos los CreateRfc parámetros, consulta la referencia de la API de administración de cambios de AMS.

CREACIÓN EN LÍNEA:

Ejecute el comando create RFC con los parámetros de ejecución incluidos en línea (comillas de escape al proporcionar los parámetros de ejecución en línea) y, a continuación, envíe el ID de RFC devuelto. Por ejemplo, puedes reemplazar el contenido por algo como esto:

Con todos los parámetros para una regla:


aws amscm create-rfc --change-type-id "ct-31eb7rrxb7qju" --change-type-version "1.0" --title "Put S3 replication rule in the source bucket."--execution-parameters"{\"DocumentName\":\"AWSManagedServices-PutReplicationRule\",\"Region\":\"us-east-1\",\"Parameters\":{\"ReplicationRuleName\":[\"test-replication-all-params\"],\"SourceBucketName\":[\"amzn-s3-demo-source-bucket\"],\"DestinationAccount\":[\"123456789012\"],\"DestinationBucketName\":[\"amzn-s3-demo-destination-bucket\"],\"ReplicationRole\":[\"arn:aws:iam::123456789012:role/customer_test_s3_replication\"],\"OwnerTranslation\":[\"false\"],\"DecryptObjectKMSKey\":[\"arn:aws:kms:us-east-1:123456789012:key/12345678-aaaa-bbbb-cccc-123456789012\"],\"EncryptReplicaKMSKey\":[\"arn:aws:kms:eu-west-1:012987654321:key/87654321-aaaa-bbbb-cccc-012987654321\"],\"Prefix\":[\"\"],\"Priority\":[\"1\"]}}"

CREACIÓN DE PLANTILLA:

Cree y guarde el PutReplicationRuleParams archivo.


aws amscm get-change-type-version --change-type-id "ct-31eb7rrxb7qju" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > PutReplicationRuleParams.json


{
    "DocumentName" : "AWSManagedServices-PutReplicationRule",
    "Region": "us-east-1",
    "Parameters": {
      "ReplicationRuleName" : "test-replication-all-params",
      "SourceBucketName" : "amzn-s3-demo-source-bucket",
      "DestinationAccount" : "123456789012",
      "DestinationBucketName" : "amzn-s3-demo-destination-bucket",
      "ReplicationRole" : "arn:aws:iam::123456789012:role/customer_test_s3_replication",
      "OwnerTranslation" : "false",
      "DecryptObjectKMSKey" : ["arn:aws:kms:us-east-1:123456789012:key/12345678-aaaa-bbbb-cccc-123456789012"],
      "EncryptReplicaKMSKey" : "arn:aws:kms:eu-west-1:012987654321:key/87654321-aaaa-bbbb-cccc-012987654321",
      "Prefix" : " ",
      "Priority" : "1"
    }
}

Envía la plantilla RFC a un archivo de tu carpeta actual; en este ejemplo se le asigna el nombre PutReplicationRuleRfc .json:
```
aws amscm create-rfc --generate-cli-skeleton > PutReplicationRuleRfc.json
```

Modifique y guarde el PutReplicationRuleRfc archivo.json. Por ejemplo, puedes reemplazar el contenido por algo como esto:


{
    "ChangeTypeVersion": "1.0",    
    "ChangeTypeId": "ct-31eb7rrxb7qju",
    "Title": "Add S3 replication rule in the source bucket."
}

Cree el RFC, especificando el PutReplicationRuleParams archivo y el PutReplicationRuleRfc archivo:
```
aws amscm create-rfc --cli-input-json file://PutReplicationRuleRfc.json --execution-parameters file://PutReplicationRuleParams.json
```
Recibirá el ID de la nueva RFC en la respuesta y podrá utilizarla para enviar y supervisar la RFC. Hasta que la envíe, la RFC permanece en estado de edición y no se inicia.

nota

Se trata de un nuevo tipo de cambio que le permite añadir reglas de replicación a un bucket de Amazon S3 específico. Si desea recibir una réplica de replicación en su bucket de Amazon S3, utilice el tipo de cambio de almacenamiento S3: Receive Replication Réplica Change.

Para obtener más información sobre las reglas de replicación de Amazon S3, consulte ¿Cómo añado una regla de replicación a un bucket de S3?

Parámetros de entrada de ejecución

Para obtener información detallada sobre los parámetros de entrada de la ejecución, consulteEsquema para el tipo de cambio ct-31eb7rrxb7qju.

Ejemplo: Parámetros necesarios


{
    "DocumentName" : "AWSManagedServices-PutReplicationRule",
    "Region": "us-east-1",
    "Parameters": {
      "ReplicationRuleName": ["test-replication-only-required-params"],
      "SourceBucketName": ["source-s3-test"],
      "DestinationAccount": ["555555555555"],
      "DestinationBucketName": ["destination-s3-test"],
      "ReplicationRole": ["arn:aws:iam::123456789012:role/customer_test_s3_replication"]
    }
}

Ejemplo: todos los parámetros


{
    "DocumentName" : "AWSManagedServices-PutReplicationRule",
    "Region": "us-east-1",
    "Parameters": {
      "ReplicationRuleName": ["test-replication-all-params"],
      "SourceBucketName": ["s3-replication-test"],
      "DestinationAccount": ["555555555555"],
      "DestinationBucketName": ["test-replication-destination"],
      "ReplicationRole": ["arn:aws:iam::123456789012:role/customer_test_s3_replication"],
      "OwnerTranslation": ["false"],
      "DecryptObjectKMSKey": ["arn:aws:kms:us-east-1:123456789012:key/bfb30098-2f19-4375-91f5-12345682129a"],
      "EncryptReplicaKMSKey": ["arn:aws:kms:eu-west-1:123456789012:key/d5e68703-8199-4265-a103-12345637bd47"],
      "Prefix":[""],
      "Priority": ["1"]
    }
}

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

S3 Storage | Agregar notificación de evento

S3 Storage | Política de eliminación (se requiere revisión)