Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Storage S3 \| Aggiungi regola di replica
Aggiungi una regola di replica S3 al bucket S3 specificato.
**Classificazione completa:** gestione \| Componenti dello stack avanzati \| Storage S3 \| Aggiungi regola di replica
## Dettagli del tipo di modifica
****
| | |
| --- |--- |
| Cambia tipo ID | ct-31eb7rrxb7qju |
| Versione corrente | 1.0 |
| Durata di esecuzione prevista | 10 minuti |
| Approvazione AWS | Richiesto |
| Approvazione del cliente | Campo non obbligatorio |
| Modalità di esecuzione | Automatizzata |
## Informazioni aggiuntive
### Aggiungi regola di replica
#### Aggiungere regole di replica a un bucket Amazon S3 specificato utilizzando la console
Di seguito viene illustrato questo tipo di modifica nella console AMS.
Come funziona:
1. Vai alla pagina **Crea RFC**: nel riquadro di navigazione a sinistra della console AMS, fai clic **RFCs**per aprire la pagina di RFCs elenco, quindi fai clic su **Crea RFC**.
1. Scegli un tipo di modifica (CT) popolare nella visualizzazione predefinita **Sfoglia i tipi di modifica** o seleziona un CT nella visualizzazione **Scegli per categoria**.
+ **Naviga per tipo di modifica**: puoi fare clic su un CT popolare nell'area di **creazione rapida** per aprire immediatamente la pagina **Run RFC**. Nota che non puoi scegliere una versione CT precedente con creazione rapida.
Per ordinare CTs, utilizzate l'area **Tutti i tipi di modifica** nella vista a **scheda** o **tabella**. In entrambe le visualizzazioni, selezionate un CT, quindi fate clic su **Crea RFC** per aprire la pagina **Esegui RFC**. Se applicabile, accanto al **pulsante Crea **RFC viene visualizzata l'opzione Crea** con una versione precedente**.
+ **Scegli per categoria**: seleziona una categoria, sottocategoria, articolo e operazione e la casella dei dettagli CT si apre con l'opzione **Crea con una versione precedente, se applicabile**. Fai clic su **Crea RFC** per aprire la pagina **Esegui RFC**.
1. Nella pagina **Run RFC**, apri l'area del nome CT per visualizzare la casella dei dettagli CT. È richiesto un **Oggetto** (questo campo viene compilato automaticamente se si sceglie il CT nella vista **Sfoglia i tipi di modifica**). Apri l'area **di configurazione aggiuntiva** per aggiungere informazioni sull'RFC.
Nell'area di **configurazione dell'esecuzione**, utilizza gli elenchi a discesa disponibili o inserisci i valori per i parametri richiesti. Per configurare i parametri di esecuzione opzionali, aprite l'area di **configurazione aggiuntiva**.
1. Al termine, fate clic su **Esegui**. Se non sono presenti errori, viene visualizzata la pagina **RFC creata correttamente** con i dettagli RFC inviati e l'output iniziale di **Run**.
1. Apri l'area dei **parametri di esecuzione** per visualizzare le configurazioni inviate. Aggiorna la pagina per aggiornare lo stato di esecuzione RFC. Facoltativamente, annulla la RFC o creane una copia con le opzioni nella parte superiore della pagina.
#### Aggiungere regole di replica a un bucket Amazon S3 specificato utilizzando la CLI
Come funziona:
1. Usa Inline Create (esegui un `create-rfc` comando con tutti i parametri RFC e di esecuzione inclusi) o Template Create (crei due file JSON, uno per i parametri RFC e uno per i parametri di esecuzione) ed emetti il comando con i due file come input. `create-rfc` Entrambi i metodi sono descritti qui.
1. Invia il `aws amscm submit-rfc --rfc-id {{ID}}` comando RFC: con l'ID RFC restituito.
Monitora il comando RFC:. `aws amscm get-rfc --rfc-id {{ID}}`
Per verificare la versione del tipo di modifica, usa questo comando:
```
aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value={{CT_ID}}
```
**Nota**
È possibile utilizzare qualsiasi `CreateRfc` parametro con qualsiasi RFC, indipendentemente dal fatto che faccia parte o meno dello schema per il tipo di modifica. Ad esempio, per ricevere notifiche quando lo stato RFC cambia, aggiungi questa riga `--notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}"` alla parte dei parametri RFC della richiesta (non ai parametri di esecuzione). Per un elenco di tutti i CreateRfc parametri, consulta l'[AMS Change Management API](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_CreateRfc.html) Reference.
*CREAZIONE IN LINEA*:
Esegui il comando create RFC con i parametri di esecuzione forniti in linea (evita le virgolette quando fornisci i parametri di esecuzione in linea), quindi invia l'ID RFC restituito. Ad esempio, puoi sostituire il contenuto con qualcosa del genere:
Con tutti i parametri per una regola:
```
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}}\"]}}"
```
*CREAZIONE DEL MODELLO*:
1. Crea e salva il PutReplicationRuleParams file.
```
aws amscm get-change-type-version --change-type-id "ct-31eb7rrxb7qju" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > PutReplicationRuleParams.json
```
1.
```
{
"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}}"
}
}
```
1. Esporta il modello RFC in un file nella cartella corrente; questo esempio lo chiama PutReplicationRuleRfc .json:
```
aws amscm create-rfc --generate-cli-skeleton > PutReplicationRuleRfc.json
```
1. Modifica e salva il file.json. PutReplicationRuleRfc Ad esempio, puoi sostituire il contenuto con qualcosa del genere:
```
{
"ChangeTypeVersion": "1.0",
"ChangeTypeId": "ct-31eb7rrxb7qju",
"Title": "{{Add S3 replication rule in the source bucket."}}
}
```
1. Crea la RFC, specificando il PutReplicationRuleParams file e il PutReplicationRuleRfc file:
```
aws amscm create-rfc --cli-input-json file://PutReplicationRuleRfc.json --execution-parameters file://PutReplicationRuleParams.json
```
Nella risposta ricevi l'ID della nuova RFC e puoi utilizzarlo per inviare e monitorare la RFC. Finché non la invii, la RFC rimane nello stato di modifica e non si avvia.
#### Suggerimenti
**Nota**
Si tratta di un nuovo tipo di modifica che consente di aggiungere regole di replica a un bucket Amazon S3 specificato. Se desideri ricevere una replica di replica nel tuo bucket Amazon S3, usa lo [storage S3: Receive replication replica change](management-advanced-s3-storage-receive-replication-replica.md#ex-s3-receive-replication-replica-col) type.
Per ulteriori informazioni sulle regole di replica di Amazon S3, consulta [Come aggiungere una regola di replica a un bucket](https://docs.aws.amazon.com/AmazonS3/latest/user-guide/enable-replication.html) S3?
## Parametri di input di esecuzione
Per informazioni dettagliate sui parametri di input di esecuzione, vedere[Schema per il tipo di modifica ct-31eb7rrxb7qju](schemas.md#ct-31eb7rrxb7qju-schema-section).
## Esempio: parametri obbligatori
```
{
"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"]
}
}
```
## Esempio: tutti i parametri
```
{
"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"]
}
}
```