AMS CloudFormation 擷取

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

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

1. 準備用於建立堆疊的 CloudFormation 範本，並將其上傳至 S3 儲存貯體。如需重要詳細資訊，請參閱 AWS CloudFormation 擷取準則、最佳實務和限制。

2. 建立 RFC 並將其提交至 AMS：

   1. 建立並儲存執行參數 JSON 檔案，包括您想要的 CloudFormation 範本參數。下列範例將其命名為 CreateCfnParams.json.

      範例 Web 應用程式堆疊 CreateCfnParams.json 檔案：

      {
        "Name": "cfn-ingest",
        "Description": "CFNIngest Web Application Stack",
        "VpcId": "VPC_ID",
        "CloudFormationTemplateS3Endpoint": "$S3_URL",
        "TimeoutInMinutes": 120,
        "Tags": [
         {
          "Key":   "Enviroment Type"
          "Value": "Dev",
         },
         {
          "Key":   "Application"
          "Value": "PCS",
         }
        ],
        "Parameters": [
         {
          "Name": "Parameter-for-S3Bucket-Name",
          "Value":  "BUCKET-NAME"
         },
         {
          "Name": "Parameter-for-Image-Id",
          "Value":  "AMI-ID"
         }
        ],
      }

      範例 SNS 主題 CreateCfnParams.json 檔案：

      {
        "Name": "cfn-ingest",
        "Description": "CFNIngest Web Application Stack",
        "CloudFormationTemplateS3Endpoint": "$S3_URL",
        "Tags": [
          {"Key": "Enviroment Type", "Value": "Dev"}
        ],
        "Parameters": [
          {"Name": "TopicName", "Value": "MyTopic1"}
        ]
      }

3. 使用下列內容建立並儲存 RFC 參數 JSON 檔案。下列範例會將其命名為 CreateCfnRfc.json 檔案：

   {
      "ChangeTypeId": "ct-36cn2avfrrj9v",
      "ChangeTypeVersion": "2.0",
      "Title": "cfn-ingest"
   }

4. 建立 RFC，指定 CreateCfnRfc 檔案和 CreateCfnParams 檔案：

   aws amscm create-rfc --cli-input-json file://CreateCfnRfc.json  --execution-parameters file://CreateCfnParams.json

   您會在回應中收到新 RFC 的 ID，並且可以使用它來提交和監控 RFC。在您提交之前，RFC 會保持在編輯狀態，不會啟動。

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

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

1. 準備您要用來更新堆疊的 AWS CloudFormation 範本，並將其上傳至 S3 儲存貯體。如需重要詳細資訊，請參閱 AWS CloudFormation 擷取準則、最佳實務和限制。

2. 建立 RFC 並將其提交至 AMS：

   1. 建立並儲存執行參數 JSON 檔案，包括您想要的 CloudFormation 範本參數。此範例會將其命名為 UpdateCfnParams.json.

      具有內嵌參數更新的範例 UpdateCfnParams.json 檔案：

      {
        "StackId": "stack-yjjoo9aicjyqw4ro2",
        "VpcId": "VPC_ID",
        "CloudFormationTemplate": "{\"AWSTemplateFormatVersion\":\"2010-09-09\",\"Description\":\"Create a SNS topic\",\"Parameters\":{\"TopicName\":{\"Type\":\"String\"},\"DisplayName\":{\"Type\":\"String\"}},\"Resources\":{\"SnsTopic\":{\"Type\":\"AWS::SNS::Topic\",\"Properties\":{\"TopicName\":{\"Ref\":\"TopicName\"},\"DisplayName\":{\"Ref\":\"DisplayName\"}}}}}",
        "TemplateParameters": [
          {
            "Key": "TopicName",
            "Value": "TopicNameCLI"
          },
          {
            "Key": "DisplayName",
            "Value": "DisplayNameCLI"
          }
        ],
        "TimeoutInMinutes": 1440
      }

      包含更新 CloudFormation 範本之 S3 儲存貯體端點的 UpdateCfnParams.json 檔案範例：

      {
        "StackId": "stack-yjjoo9aicjyqw4ro2",
        "VpcId": "VPC_ID",
        "CloudFormationTemplateS3Endpoint": "s3_url",
        "TemplateParameters": [
          {
            "Key": "TopicName",
            "Value": "TopicNameCLI"
          },
          {
            "Key": "DisplayName",
            "Value": "DisplayNameCLI"
          }
        ],
        "TimeoutInMinutes": 1080
      }

3. 使用下列內容建立並儲存 RFC 參數 JSON 檔案。此範例會將其命名為 UpdateCfnRfc.json 檔案。

   {
      "ChangeTypeId": "ct-361tlo1k7339x",
      "ChangeTypeVersion": "1.0",
      "Title": "cfn-ingest-template-update"
   }

4. 建立 RFC，指定 UpdateCfnRfc 檔案和 UpdateCfnParams 檔案：

   aws amscm create-rfc --cli-input-json file://UpdateCfnRfc.json  --execution-parameters file://UpdateCfnParams.json

   您會在回應中收到新 RFC 的 ID，並且可以使用它來提交和監控 RFC。在您提交之前，RFC 會保持在編輯狀態，不會啟動。

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

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

1. 將此變更類型的執行參數 JSON 結構描述輸出到目前資料夾中的檔案。此範例會將其命名為 CreateAsgParams.json:

   aws amscm create-rfc --change-type-id "ct-1404e21baa2ox" --change-type-version "1.0" --title "Approve Update" --execution-parameters file://PATH_TO_EXECUTION_PARAMETERS --profile saml

2. 修改和儲存結構描述，如下所示：

   {
     "StackId": "STACK_ID",
     "VpcId": "VPC_ID",
     "ChangeSetName": "UPDATE-ef81e2bc-03f6-4b17-a3c7-feb700e78faa",
     "TimeoutInMinutes": 1080
   }
   

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

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

僅指定您要變更的參數。缺少參數會保留現有的值。

內嵌建立：

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

aws amscm create-rfc \
--change-type-id "ct-2uzbqr7x7mekd" \
--change-type-version "1.0" \
--title "Enable termination protection on CFN stack" \
--execution-parameters "{\"DocumentName\":\"AWSManagedServices-ManageResourceTerminationProtection\",\"Region\":\"us-east-1\",\"Parameters\":{\"ResourceId\":[\"stack-psvnq6cupymio3enl\"],\"TerminationProtectionDesiredState\":[\"enabled\"]}}"

範本建立：

1. 將此變更類型的執行參數輸出至 JSON 檔案；此範例會將其命名為 EnableTermProCFNParams.json:

   aws amscm get-change-type-version --change-type-id "ct-2uzbqr7x7mekd" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > EnableTermProCFNParams.json

2. 修改並儲存 EnableTermProCFNParams 檔案，只保留您要變更的參數。例如，您可以將內容取代為如下內容：

   {
     "DocumentName": "AWSManagedServices-ManageResourceTerminationProtection",
     "Region": "us-east-1",
     "Parameters": {
       "ResourceId": ["stack-psvnq6cupymio3enl"],
       "TerminationProtectionDesiredState": ["enabled"]
     }
   }

3. 將 RFC 範本輸出至目前資料夾中的檔案；此範例會將其命名為 EnableTermProCFNRfc.json:

   aws amscm create-rfc --generate-cli-skeleton > EnableTermProCFNRfc.json

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

   {
       "ChangeTypeId": "ct-2uzbqr7x7mekd",
       "ChangeTypeVersion": "1.0",
       "Title": "Enable termination protection on CFN instance"
   }

5. 建立 RFC，指定 EnableTermProCFNRfc 檔案和 EnableTermProCFNParams 檔案：

   aws amscm create-rfc --cli-input-json file://EnableTermProCFNRfc.json  --execution-parameters file://EnableTermProCFNParams.json

   您會在回應中收到新 RFC 的 ID，並且可以使用它來提交和監控 RFC。在您提交之前，RFC 會保持在編輯狀態，不會啟動。