View a markdown version of this page

RDS データベーススタック | 更新 (Aurora 用) - AMS Advanced Change Type リファレンス

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

RDS データベーススタック | 更新 (Aurora 用)

CT ID ct-2jvzjwunghrhy、バージョン 1.0 を使用して作成された既存の AWS Relational Database Service (RDS) Aurora スタックのプロパティを変更します。

完全分類: 管理 | 高度なスタックコンポーネント | RDS データベーススタック | 更新 (Aurora 用)

変更タイプの詳細

変更タイプ ID

ct-2dphvdy1krpj6

現在のバージョン

1.0

予想される実行期間

60 分

AWS の承認

必須

お客様の承認

不要

実行モード

自動

追加情報

DB の更新 (Aurora 用)

AMS コンソールでのこの変更タイプのスクリーンショット:

仕組み:

  1. RFC の作成ページに移動します。AMS コンソールの左側のナビゲーションペインでRFCs をクリックして RFCsリストページを開き、RFC の作成をクリックします。

  2. デフォルトの変更タイプ参照ビューで一般的な変更タイプ (CT) を選択するか、カテゴリ別選択ビューで CT を選択します。

    • 変更タイプ別に参照: クイック作成エリアで一般的な CT をクリックすると、すぐに RFC の実行ページを開くことができます。クイック作成で古い CT バージョンを選択することはできません。

      CTs をソートするには、カードビューまたはテーブルビューですべての変更タイプエリアを使用します。どちらのビューでも、CT を選択し、RFC の作成をクリックして RFC の実行ページを開きます。必要に応じて、RFC の作成ボタンの横に古いバージョンで作成オプションが表示されます。

    • カテゴリ別に選択: カテゴリ、サブカテゴリ、項目、オペレーションを選択すると、CT 詳細ボックスが開き、必要に応じて古いバージョンで作成するオプションが表示されます。RFC の作成をクリックして、RFC の実行ページを開きます。

  3. RFC の実行ページで、CT 名エリアを開き、CT の詳細ボックスを表示します。件名は必須です (変更タイプの参照ビューで CT を選択した場合は入力されます)。追加設定エリアを開き、RFC に関する情報を追加します。

    実行設定領域で、使用可能なドロップダウンリストを使用するか、必要なパラメータの値を入力します。オプションの実行パラメータを設定するには、追加設定エリアを開きます。

  4. 完了したら、実行 をクリックします。エラーがない場合、RFC が正常に作成されたページに、送信された RFC の詳細と最初の実行出力が表示されます。

  5. Run parameters エリアを開き、送信した設定を確認します。ページを更新して RFC 実行ステータスを更新します。必要に応じて、RFC をキャンセルするか、ページ上部のオプションを使用して RFC のコピーを作成します。

仕組み:

  1. インライン作成 (すべての RFC と実行パラメータを含むcreate-rfcコマンドを発行) またはテンプレート作成 (2 つの JSON ファイルを作成し、1 つは RFC パラメータ用、もう 1 つは実行パラメータ用) のいずれかを使用し、2 つのファイルを入力としてcreate-rfcコマンドを発行します。どちらの方法もここで説明します。

  2. 返された 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
注記

変更タイプのスキーマの一部であるかどうかにかかわらず、任意の RFC で任意のCreateRfcパラメータを使用できます。たとえば、RFC ステータスが変更されたときに通知を受け取るには、リクエストの RFC パラメータ部分 (実行パラメータではなく) --notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}"にこの行を追加します。すべての CreateRfc パラメータのリストについては、AMS 変更管理 API リファレンスを参照してください。

インライン作成:

インラインで指定された実行パラメータ (インラインで実行パラメータを指定する場合は引用符をエスケープ) を指定して create RFC コマンドを発行し、返された RFC ID を送信します。たとえば、コンテンツを次のような内容に置き換えることができます。

aws amscm create-rfc --region us-east-1 --change-type-id "ct-2dphvdy1krpj6" --change-type-version "1.0" --title "Test - Update Aurora RDS" --execution-parameters "{\"VpcId\":\"VPC_ID\",\"StackId\":\"STACK_ID\",\"Parameters\":{\"AutoMinorVersionUpgrade\":\"true\",\"BackupRetentionPeriod\":5,\"EngineVersion\":\"10.4\",\"InstanceType\":\"db.r4.large\",\"MultiAZ\":\"true\",\"PerformanceInsights\":\"true\",\"PerformanceInsightsKMSKey\":\"default\",\"PerformanceInsightsRetentionPeriod\":\"7\",\"Port\":\"1151\",\"PreferredBackupWindow\":\"22:00-23:00\",\"PreferredMaintenanceWindow\":\"wed:03:32-wed:04:02\",\"MasterUserPassword\":\"PW\"}}"

テンプレート作成 (すべてのパラメータを表示):

  1. この変更タイプの実行パラメータを UpdateAuroraRdsParams.json.

    aws amscm get-change-type-version --change-type-id "ct-2dphvdy1krpj6" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > UpdateAuroraRdsParams.json
  2. 実行パラメータ JSON ファイルを変更して保存します。たとえば、コンテンツを次のような内容に置き換えることができます。

    { "VpcId": "VPC_ID", "StackId": "STACK_ID", "Parameters": { "AutoMinorVersionUpgrade": "true", "BackupRetentionPeriod": 5, "EngineVersion": "10.4", "InstanceType": "db.r4.large", "MultiAZ": "true", "PerformanceInsights": "true", "PerformanceInsightsKMSKey": "default", "PerformanceInsightsRetentionPeriod": "7", "Port": "1151", "PreferredBackupWindow": "22:00-23:00", "PreferredMaintenanceWindow": "wed:03:32-wed:04:02", "MasterUserPassword": "**********" } }
  3. JSON テンプレートを現在のフォルダ内のファイルに出力します。この例では UpdateAuroraRdsRfc.json:

    aws amscm create-rfc --generate-cli-skeleton > UpdateAuroraRdsRfc.json
  4. UpdateAuroraRdsRfc.json ファイルを変更して保存します。たとえば、コンテンツを次のような内容に置き換えることができます。

    { "ChangeTypeVersion": "1.0", "ChangeTypeId": "ct-2dphvdy1krpj6", "Title": "RDS-Aurora-Update-RFC" }
  5. RFC を作成し、実行パラメータファイルと UpdateAuroraRdsRfc ファイルを指定します。

    aws amscm create-rfc --cli-input-json file://UpdateAuroraRdsRfc.json --execution-parameters file://UpdateAuroraRdsParams.json

    レスポンスで新しい RFC の ID を受け取り、それを使用して RFC を送信およびモニタリングできます。送信するまで、RFC は編集状態のままであり、開始されません。

  6. RDS を表示するには、実行出力を確認します。「stack_id」を使用して Cloud Formation コンソールで RDS を表示します。

注記

AMS は、RDS スタックを含む特定のスタックでドリフト検出を使用して、設定が変更されるかどうかを判断します。AMS は、設定ドリフトがあると判断された RDS スタックの更新を禁止します。RFC は失敗し、次のエラーメッセージが表示されます。「このスタックでは更新を実行できません。詳細については、AMS にお問い合わせください。」

サイズのレコメンデーションを含む Amazon RDS の詳細については、Amazon Relational Database Service ドキュメント」を参照してください。

Aurora 以外の RDS スタックを更新するには、「」を参照してくださいDB スタックを更新する

実行入力パラメータ

実行入力パラメータの詳細については、「」を参照してください変更タイプ ct-2dphvdy1krpj6 のスキーマ

例: 必須パラメータ

Example not available.

例: すべてのパラメータ

{ "VpcId": "vpc-12345678901234567", "StackId": "stack-a1b2c3d4e5f67890e", "Parameters": { "AutoMinorVersionUpgrade": "true", "BackupRetentionPeriod": 7, "InstanceType": "db.serverless", "MasterUserPassword": "dbpassword", "MultiAZ": "true", "PerformanceInsights": "true", "PerformanceInsightsKMSKey": "default", "PerformanceInsightsRetentionPeriod": "7", "Port": "1150", "PreferredBackupWindow": "22:00-23:00", "PreferredMaintenanceWindow": "wed:03:32-wed:04:02", "ServerlessScalingMinCapacity": 1.0, "ServerlessScalingMaxCapacity": 2.0 } }