S3 儲存 | 新增複寫規則

將 S3 複寫規則新增至指定的 S3 儲存貯體。

完整分類：管理 | 進階堆疊元件 | S3 儲存 | 新增複寫規則

變更類型詳細資訊

變更類型 ID	ct-31eb7rrxb7qju
目前版本	1.0
預期的執行持續時間	10 分鐘
AWS 核准	必要
客戶核准	非必要
執行模式	自動化

其他資訊

新增複寫規則

以下顯示 AMS 主控台中的此變更類型。

運作方式：

導覽至建立 RFC 頁面：在 AMS 主控台的左側導覽窗格中，按一下 RFCs以開啟 RFCs清單頁面，然後按一下建立 RFC。
在預設瀏覽變更類型檢視中選擇熱門的變更類型 (CT)，或在依類別選擇檢視中選擇 CT。
- 依變更類型瀏覽：您可以在快速建立區域中按一下熱門的 CT，以立即開啟執行 RFC 頁面。請注意，您無法透過快速建立選擇較舊的 CT 版本。
  
  若要排序 CTs，請使用卡片或資料表檢視中的所有變更類型區域。在任一檢視中，選取 CT，然後按一下建立 RFC 以開啟執行 RFC 頁面。如果適用，建立較舊版本選項會顯示在建立 RFC 按鈕旁。
- 依類別選擇：選取類別、子類別、項目和操作，如果適用，CT 詳細資訊方塊會開啟，其中包含使用較舊版本建立的選項。按一下建立 RFC 以開啟執行 RFC 頁面。
在執行 RFC 頁面上，開啟 CT 名稱區域以查看 CT 詳細資訊方塊。需要主旨（如果您在瀏覽變更類型檢視中選擇 CT，則會為您填入）。開啟其他組態區域以新增 RFC 的相關資訊。

在執行組態區域中，使用可用的下拉式清單或輸入必要參數的值。若要設定選用的執行參數，請開啟其他組態區域。
完成後，請按一下執行。如果沒有錯誤，RFC 成功建立的頁面會顯示已提交的 RFC 詳細資訊，以及初始的執行輸出。
開啟執行參數區域以查看您提交的組態。重新整理頁面以更新 RFC 執行狀態。或者，取消 RFC 或使用頁面頂端的選項建立 RFC 的副本。

運作方式：

使用內嵌建立（您發出包含所有 RFC 和執行參數的create-rfc命令）或範本建立（您建立兩個 JSON 檔案，一個用於 RFC 參數，另一個用於執行參數），並使用兩個檔案作為輸入發出create-rfc命令。此處說明這兩種方法。
使用傳回的 RFC ID 提交 RFC： aws amscm submit-rfc --rfc-id ID命令。

監控 RFC： aws amscm get-rfc --rfc-id ID命令。

若要檢查變更類型版本，請使用下列命令：


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

注意

您可以將任何CreateRfc參數與任何 RFC 搭配使用，無論它們是否為變更類型結構描述的一部分。例如，若要在 RFC 狀態變更時取得通知，請將此行新增至請求的 --notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}" RFC 參數部分（而非執行參數）。如需所有 CreateRfc 參數的清單，請參閱 AMS 變更管理 API 參考。

內嵌建立：

使用內嵌提供的執行參數發出建立 RFC 命令（在內嵌提供執行參數時逸出引號），然後提交傳回的 RFC ID。例如，您可以將內容取代為如下內容：

對於一個規則的所有參數：


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\"]}}"

範本建立：

建立並儲存 PutReplicationRuleParams 檔案。


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

將 RFC 範本輸出至目前資料夾中的檔案；此範例會將其命名為 PutReplicationRuleRfc.json:
```
aws amscm create-rfc --generate-cli-skeleton > PutReplicationRuleRfc.json
```

修改並儲存 PutReplicationRuleRfc.json 檔案。例如，您可以將內容取代為如下內容：


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

建立 RFC，指定 PutReplicationRuleParams 檔案和 PutReplicationRuleRfc 檔案：
```
aws amscm create-rfc --cli-input-json file://PutReplicationRuleRfc.json --execution-parameters file://PutReplicationRuleParams.json
```
您會在回應中收到新 RFC 的 ID，並且可以使用它來提交和監控 RFC。在您提交之前，RFC 會保持在編輯狀態，不會啟動。

注意

這是新的變更類型，可讓您將複寫規則新增至指定的 Amazon S3 儲存貯體。如果您想要在 Amazon S3 儲存貯體中接收複寫複本，請使用 S3 儲存體：接收複寫複本變更類型。

若要進一步了解 Amazon S3 複寫規則，請參閱如何將複寫規則新增至 S3 儲存貯體？

執行輸入參數

如需執行輸入參數的詳細資訊，請參閱變更類型的結構描述 ct-31eb7rrxb7qju。

範例：必要參數


{
    "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"]
    }
}

範例：所有參數


{
    "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"]
    }
}

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

S3 儲存 | 新增事件通知

S3 儲存 | 刪除政策（受管自動化）