# Amazon RDS のマルチ AZ DB クラスターの変更
<a name="modify-multi-az-db-cluster"></a>

マルチ AZ DB クラスターには、3 つの別々のアベイラビリティーゾーンに 1 つのライターDB インスタンスと 2 つのリーダー DB インスタンスがあります。マルチ AZ DB クラスターは、マルチ AZ 配置と比較して、高可用性、読み取りワークロードの容量の増加、および低レイテンシーを提供します。マルチ AZ DBクラスターの詳細ついては、「[Amazon RDS のマルチ AZ DB クラスターデプロイ](multi-az-db-clusters-concepts.md)」を参照してください。

マルチ AZ DB クラスターを変更して、設定を変更することができます。スナップショットの作成など、マルチ AZ DB クラスターで操作を実行することもできます。

**重要**  
マルチ AZ DB クラスター内の DB インスタンスは変更できません。変更はすべて DB クラスターレベルで行う必要があります。マルチ AZ DB クラスター内の DB インスタンスで実行できるのは、再起動のみです。

マルチ AZ DB クラスターは、AWS マネジメントコンソール、AWS CLI、または RDS API を使用して変更できます。

## コンソール
<a name="modify-multi-az-db-cluster-console"></a>

**マルチ DB クラスターを変更するには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

1. ナビゲーションペインで、「**データベース**」 を選択し、変更したいマルチ AZ DB クラスターを選択します。

1. [**Modify**] を選択します。[**DB クラスターの変更**] ページが表示されます。

1. 必要に応じて任意の設定を変更してください。各設定の詳細については、「[マルチ AZ DB クラスターの変更の設定](#modify-multi-az-db-cluster-settings)」を参照してください。

1. すべての変更が正しいことを確認したら、[**Continue**] を選択して変更の概要を確認します。

1. (省略可能) 変更をすぐに適用するには、[**すぐに適用**] を選択します。このオプションを選択すると、ダウンタイムを発生させる場合があります。(詳しくは、「[今すぐ変更を適用する](#modify-multi-az-db-cluster-apply-immediately)」を参照してください。) 

1. 確認ページで、変更内容を確認します。正しい場合は、「**DB クラスターの変更**」を選択して変更を保存します。

   または、[**戻る**] を選択して変更を編集するか、**キャンセル**を選択して変更をキャンセルします。

## AWS CLI
<a name="modify-multi-az-db-cluster-cli"></a>

AWS CLIを使用してマルチAZ DBクラスターを変更するには、[modify-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) コマンドを呼び出します。DB クラスター識別子と、変更したいオプションの値を指定します。各オプションの詳細については、「[マルチ AZ DB クラスターの変更の設定](#modify-multi-az-db-cluster-settings)」を参照してください。

**Example**  
次のコードでは、バックアップ保存期間を 1 週間 (7 日間) に設定して、`my-multi-az-dbcluster` を変更します。このコードは、`--deletion-protection` を使用して削除保護を有効にします。`--no-deletion-protection`を使用して、削除保護を無効にするには、変更は、`--no-apply-immediately` を使用して次のメンテナンスウィンドウ中に適用されます。今すぐ変更を適用するには、`--apply-immediately` を使用します。詳細については、「[今すぐ変更を適用する](#modify-multi-az-db-cluster-apply-immediately)」を参照してください。  
Linux、macOS、Unix の場合:  

```
aws rds modify-db-cluster \
    --db-cluster-identifier {{my-multi-az-dbcluster}} \
    --backup-retention-period {{7}} \
    {{--deletion-protection}} \
    {{--no-apply-immediately}}
```
Windows の場合:  

```
aws rds modify-db-cluster ^
    --db-cluster-identifier {{my-multi-az-dbcluster}} ^
    --backup-retention-period {{7}} ^
    {{--deletion-protection}} ^
    {{--no-apply-immediately}}
```

## RDS API
<a name="modify-multi-az-db-cluster-api"></a>

Amazon RDS API を使用して マルチAZ DB クラスターを変更するには、[ModifyDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) オペレーションを呼び出します。DB クラスター識別子と、変更したい設定のパラメータを指定します。各パラメータの詳細については、「[マルチ AZ DB クラスターの変更の設定](#modify-multi-az-db-cluster-settings)」を参照してください。

## 今すぐ変更を適用する
<a name="modify-multi-az-db-cluster-apply-immediately"></a>

マルチ AZ DB クラスターを変更する際に、変更内容を即時に適用することができます。変更をすぐに適用するには、AWS マネジメントコンソール で [**Apply Immediately (すぐに適用)**] オプションを選択します。または、AWS CLI を呼び出す際に`--apply-immediately`オプションを使用するか、`true`Amazon RDS API を使用する際に`ApplyImmediately`のパラメータを設定します。

変更の即時適用を選択しない場合、この変更は保留中の変更キューに保存されます。次のメンテナンスウィンドウ実行中に、キューのすべての保留中の変更が適用されます。変更の即時適用を選択した場合は、新しい変更と、保留中の変更キューにあるすべての変更が適用されます。

**重要**  
保留中の変更のいずれかで DB クラスターをテンポラリに使用不可にする必要がある場合 (ダウンタイム)、*すぐに適用*オプションを選択すると、予期しないダウンタイムが発生する可能性があります。  
変更をすぐに適用することを選択した場合、保留中の変更も、次のメンテナンス時間中ではなく、すぐに適用されます。  
次のメンテナンスウィンドウで保留中の変更を適用しない場合は、変更を元に戻すように DB インスタンスを変更できます。これを行うには、AWS CLI を使用し、`--apply-immediately` オプションを指定します。

変更の延期を選択した場合でも、一部のデータベース設定に対する変更は即時に適用されます。さまざまなデータベース設定が [Apply immediately (すぐに適用)] の設定とどのように相互作用するかについては、「[マルチ AZ DB クラスターの変更の設定](#modify-multi-az-db-cluster-settings)」を参照してください。

## マルチ AZ DB クラスターの変更の設定
<a name="modify-multi-az-db-cluster-settings"></a>

マルチ AZ DB クラスターの変更に使用できる設定の詳細については、次の表を参照してください。AWS CLIのオプションの詳細については、[modify-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html)を参照してください。RDS API パラメータの詳細については、[ModifyDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html)を参照してください。


| コンソール設定 | 設定の説明 | CLI オプションと RDS API パラメータ | 変更を行った場合 | ダウンタイムに関する注意 | 
| --- | --- | --- | --- | --- | 
| **ストレージ割り当て** | DB クラスター内の各 DB インスタンスに割り当てるストレージの量 (ギビバイト単位)。(詳しくは、「[Amazon RDS DB インスタンスストレージ](CHAP_Storage.md)」を参照してください。) <br />  | **CLI オプション:**<br />`--allocated-storage`<br />**RDS API パラメータ:**<br /> `AllocatedStorage` | 変更をすぐに適用するように選択した場合は、直ちに適用されます。<br />変更をすぐに適用ように選択しない場合は、次のメンテナンス期間中に適用されます。 | この変更時にダウンタイムは発生しません。 | 
| マイナーバージョン自動アップグレード | **自動マイナーバージョンアップグレード**を有効にして、DB クラスターが優先マイナー DB エンジンバージョンアップグレードを利用可能になったときに自動的に受信するようにします。Amazon RDS では、メンテナンスウィンドウでマイナーバージョンの自動アップグレードが実行されます。 | **CLI オプション:**<br />`--auto-minor-version-upgrade`<br />`--no-auto-minor-version-upgrade`<br />**RDS API パラメータ:**<br />`AutoMinorVersionUpgrade` | 変更はただちに発生します。この設定は、[Apply immediately (すぐに適用)] 設定を無視します。 | この変更中に、ダウンタイムが発生します。 | 
| バックアップの保存期間  | DB クラスターの自動バックアップを保持する日数。この値はゼロより大きくなければなりません。<br />詳細については、「[バックアップの概要](USER_WorkingWithAutomatedBackups.md)」を参照してください。 | **CLI オプション:**<br />`--backup-retention-period`<br />**RDS API パラメータ:**<br />`BackupRetentionPeriod` | 変更をすぐに適用するように選択した場合は、直ちに適用されます。<br />変更をすぐに適用ように選択しない場合は、次のメンテナンス期間中に適用されます。<br />  | この変更時にダウンタイムは発生しません。 | 
| バックアップ期間: | Amazon RDS が DB クラスターのバックアップを自動的に作成する期間。データベースのバックアップを保持する期間を指定しない場合は、デフォルトの「**指定なし**」 を使用します。<br />詳細については、「[バックアップの概要](USER_WorkingWithAutomatedBackups.md)」を参照してください。 | **CLI オプション:**<br />`--preferred-backup-window`<br />**RDS API パラメータ:**<br />`PreferredBackupWindow` | 変更は、可能な限り早く非同期的に適用されます。 | この変更時にダウンタイムは発生しません。 | 
| **認証局** | DB クラスターによって使用されるサーバー証明書の認定機関 (CA)。<br />詳細については、「[SSL/TLS を使用した DB インスタンスまたはクラスターへの接続の暗号化](UsingWithRDS.SSL.md)」を参照してください。 | **CLI オプション:**<br />`--ca-certificate-identifier`<br />**RDS API パラメータ:**<br />`CACertificateIdentifier` | 変更をすぐに適用するように選択した場合は、直ちに適用されます。<br />変更をすぐに適用ように選択しない場合は、次のメンテナンス期間中に適用されます。 | ダウンタイムは、DB エンジンが再起動なしのローテーションをサポートしていない場合にのみ発生します。[describe-db-engine-versions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-engine-versions.html) AWS CLI コマンドを使用すると、DB エンジンが再起動なしのローテーションをサポートしているかどうかを判断できます。 | 
|  Copy tags to snapshots  | このオプションは、DB スナップショットの作成時に、DB クラスターの任意のタグを、そのスナップショットにコピーします。<br />(詳しくは、「[ Amazon RDS リソースのタグ付け](USER_Tagging.md)」を参照してください。)  | **CLI オプション:**<br />`-copy-tags-to-snapshot`<br />`-no-copy-tags-to-snapshot`<br />**RDS API パラメータ:**<br />`CopyTagsToSnapshot` | 変更はただちに発生します。この設定は、[Apply immediately (すぐに適用)] 設定を無視します。 | この変更時にダウンタイムは発生しません。 | 
|  データベース認証  | マルチ AZ DB クラスターの場合、**パスワード認証**のみがサポートされています。 | パスワード認証がデフォルトであるため、なし。 | 変更をすぐに適用するように選択した場合は、直ちに適用されます。<br />変更をすぐに適用ように選択しない場合は、次のメンテナンス期間中に適用されます。 | この変更時にダウンタイムは発生しません。 | 
| **DB cluster identifier (DB クラスター識別子** | DB クラスター識別子。この値は小文字で保存されます。<br />DB クラスター識別子を変更すると、DB クラスターエンドポイントが変更されます。DB クラスター内の識別子とエンドポイントも変更されます。新しい DB クラスタークラスターの名前は一意である必要があります。最大長は 63 文字です。<br />DB クラスター内の DB インスタンスの名前が、DB クラスターの新しい名前に対応するように変更されます。新しい DB インスタンスと既存の DB インスタンスを同じ名前にすることはできません。例えば、DB クラスターの名前を `maz` に変更すると、DB インスタンス名は `maz-instance-1` に変更されることがあります。この場合、`maz-instance-1` という名前の既存の DB インスタンスは存在できません。<br />詳細については、「[Amazon RDS のマルチ AZ DB クラスターの名前の変更](multi-az-db-cluster-rename.md)」を参照してください。 | **CLI オプション:**<br />`--new-db-cluster-identifier`<br />**RDS API パラメータ:**<br />`NewDBClusterIdentifier` | 変更をすぐに適用するように選択した場合は、直ちに適用されます。<br />変更をすぐに適用ように選択しない場合は、次のメンテナンス期間中に適用されます。 | この変更時にダウンタイムは発生しません。 | 
|  DB クラスターインスタンスクラス  | マルチ AZ DB クラスター内の各 DB インスタンス (`db.r6gd.xlarge`など) の計算容量とメモリ容量。<br />可能であれば、一般的なクエリの作業セットをメモリに保持できる十分な大きさの DB インスタンスクラスを選択します。作業セットがメモリに保持されていると、システムによるディスクへの書き込みが回避され、これによりパフォーマンスが向上します。<br />詳細については、「[マルチ AZ DB クラスターで利用できるインスタンスクラス](multi-az-db-clusters-concepts.md#multi-az-db-clusters-concepts.InstanceAvailability)」を参照してください。 | **CLI オプション:**<br />`--db-cluster-instance-class`<br />**RDS API パラメータ:**<br />`DBClusterInstanceClass` | 変更をすぐに適用するように選択した場合は、直ちに適用されます。<br />変更をすぐに適用ように選択しない場合は、次のメンテナンス期間中に適用されます。 | この変更中に、ダウンタイムが発生します。 | 
| **DB クラスターのパラメータグループ** | DB クラスターに関連付ける DB クラスターのパラメータグループ。<br />(詳しくは、「[マルチ AZ DB クラスターのパラメータグループ](multi-az-db-clusters-concepts.md#multi-az-db-clusters-concepts-parameter-groups)」を参照してください。)  | **CLI オプション:**<br />`--db-cluster-parameter-group-name`<br />**RDS API パラメータ:**<br />`DBClusterParameterGroupName` | パラメータグループの変更は直ちに行われます。 | この変更時にダウンタイムは発生しません。パラメータグループを変更すると、一部のパラメータの変更は、再起動なしで マルチ AZ DB クラスター内の DB インスタンスに即時に適用されます。他のパラメータへの変更は、DB インスタンスの再起動後にのみ適用されます。 | 
|  DB エンジンバージョン  | 使用するデータベースエンジンのバージョン。 | **CLI オプション:**<br />`--engine-version`<br />**RDS API パラメータ:**<br />`EngineVersion` | 変更をすぐに適用するように選択した場合は、直ちに適用されます。<br />変更をすぐに適用ように選択しない場合は、次のメンテナンス期間中に適用されます。 | この変更中に、ダウンタイムが発生します。 | 
| 削除保護 | **削除保護を有効**にして、DB クラスターが削除されないようにします。<br />(詳しくは、「[DB インスタンスを削除する](USER_DeleteInstance.md)」を参照してください。) | **CLI オプション:**<br />`--deletion-protection`<br />`--no-deletion-protection`<br />**RDS API パラメータ:**<br />`DeletionProtection` | 変更はただちに発生します。この設定は、[Apply immediately (すぐに適用)] 設定を無視します。 | この変更時にダウンタイムは発生しません。 | 
|  メンテナンスウィンドウ  | DB クラスターへの変更保留が適用される 30 分単位のウィンドウ。期間が重要ではない場合は、「**No Preference**」 を選択します。<br />詳細については、「[Amazon RDS メンテナンスウィンドウ](USER_UpgradeDBInstance.Maintenance.md#Concepts.DBMaintenance)」を参照してください。 | **CLI オプション:**<br />`--preferred-maintenance-window`<br />**RDS API パラメータ:**<br />`PreferredMaintenanceWindow` | 変更はただちに発生します。この設定は、[Apply immediately (すぐに適用)] 設定を無視します。 | ダウンタイムを引き起こす保留中のアクションが 1 つ以上あり、現在の時刻を含むようにメンテナンス時間を変更した場合、それらの保留中のアクションはすぐに適用され、ダウンタイムが発生します。 | 
|   でマスター認証情報を管理するAWS Secrets Manager  | **[Manage master credentials in AWS Secrets Manager]** ( でマスター認証情報を管理する) を選択して、Secrets Manager でユーザーのパスワードをシークレットに管理します。<br />オプションで、シークレットを保護するために使用する KMS キーを選択します。お客様のアカウントの KMS キーから選択するか、別のアカウントからキーを入力します。<br />RDS によって既に DB クラスターのマスターユーザーのパスワードを管理している場合は、**[Rotate secret immediately]** (すぐにシークレットをローテーションする) を選択してマスターユーザーパスワードをすぐにローテーションできます。<br />詳細については、「[Amazon RDS および AWS Secrets Manager によるパスワード管理](rds-secrets-manager.md)」を参照してください。 | **CLI オプション:**<br />`--manage-master-user-password \| --no-manage-master-user-password`<br />`--master-user-secret-kms-key-id`<br />`--rotate-master-user-password \| --no-rotate-master-user-password`<br />**RDS API パラメータ:**<br />`ManageMasterUserPassword`<br />`MasterUserSecretKmsKeyId`<br />`RotateMasterUserPassword` | マスターユーザーパスワードの自動管理をオンまたはオフにすると、すぐに変更が行われます。この変更は、[Apply immediately] (すぐに適用) の設定を無視します。<br />マスターユーザーのパスワードをローテーションする場合は、変更がすぐに適用されるように指定する必要があります。 | この変更時にダウンタイムは発生しません。 | 
|  新しいマスターパスワード  | マスターユーザーアカウントのパスワード。 | **CLI オプション:**<br />`--master-user-password`<br />**RDS API パラメータ:**<br />`MasterUserPassword` | 変更は、可能な限り早く非同期的に適用されます。この設定は、[Apply immediately (すぐに適用)] 設定を無視します。 | この変更時にダウンタイムは発生しません。 | 
|  プロビジョンド IOPS  | 初めに DB クラスターに割り当てられるプロビジョンド IOPS (1 秒あたりの入力/出力操作数) の合計です。 | **CLI オプション:**<br />`--iops`<br />**RDS API パラメータ:**<br />`Iops` | 変更をすぐに適用するように選択した場合は、直ちに適用されます。<br />変更をすぐに適用ように選択しない場合は、次のメンテナンス期間中に適用されます。 | この変更時にダウンタイムは発生しません。 | 
|  パブリックアクセス  | パブリック IP アドレスを DB クラスターに付与する場合は **パブリックアクセス可能** を選択します。これにより、DB インスタンスは Virtual Private Cloud (VPC) 外からアクセス可能になります。パブリックにアクセス可能となるよう、DB クラスターは、VPC のパブリックサブネット内にある必要があります。<br />VPC 内からのみ DB クラスターにアクセス可能にするには、「**パブリックアクセス不可**」 です。<br />(詳しくは、「[VPC 内の DB インスタンスをインターネットから隠す](USER_VPC.WorkingWithRDSInstanceinaVPC.md#USER_VPC.Hiding)」を参照してください。)<br />VPC の外部から DB クラスターに接続するには、DB クラスターがパブリックにアクセスできる必要があります。また、DB クラスターのセキュリティグループのインバウンドルールを使用してアクセスを許可し、その他の要件を満たしている必要があります。(詳しくは、「[Amazon RDS DB インスタンスに接続できない](CHAP_Troubleshooting.md#CHAP_Troubleshooting.Connecting)」を参照してください。) <br />DB クラスターがパブリックアクセス可能でない場合は、AWS Site-to-Site VPN 接続またはDirect Connect接続を使用してプライベートネットワークからアクセスすることもできます。詳細については、「[ネットワーク間のトラフィックのプライバシー](inter-network-traffic-privacy.md)」を参照してください。 | DB クラスターの変更時には使用できません。 | 変更はただちに発生します。この設定は、[Apply immediately (すぐに適用)] 設定を無視します。 | この変更時にダウンタイムは発生しません。 | 
| ストレージタイプ | DB クラスターのストレージタイプ。<br />汎用 SSD (gp3)、プロビジョンド IOPS (io1)、およびプロビジョンド IOPS SSD (io2) ストレージのみがサポートされています。<br />詳細については、「[Amazon RDS ストレージタイプ](CHAP_Storage.md#Concepts.Storage)」を参照してください。 | **CLI オプション:**<br />`--storage-type`<br />**RDS API パラメータ:**<br />`StorageType` | 変更をすぐに適用するように選択した場合は、直ちに適用されます。<br />変更をすぐに適用ように選択しない場合は、次のメンテナンス期間中に適用されます。 | この変更時にダウンタイムは発生しません。 | 
|  VPC セキュリティグループ  | DB クラスターに関連付けるセキュリティグループ。<br />(詳しくは、「[VPC セキュリティグループの概要](Overview.RDSSecurityGroups.md#Overview.RDSSecurityGroups.VPCSec)」を参照してください。) | **CLI オプション:**<br />`--vpc-security-group-ids`<br />**RDS API パラメータ:**<br />`VpcSecurityGroupIds` | 変更は、可能な限り早く非同期的に適用されます。この設定は、[Apply immediately (すぐに適用)] 設定を無視します。 | この変更時にダウンタイムは発生しません。 | 

## マルチ AZ DB クラスターの変更時に適用されない設定
<a name="modify-multi-az-db-cluster-settings-not-applicable"></a>

AWS CLI コマンド [modify-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) および RDS API オペレーション [ModifyDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) の次の設定は、マルチAZ DBクラスターには適用されません。

コンソールでマルチ AZ DB クラスターの設定を変更することもできません。


| AWS CLI の設定 | RDS API の設定 | 
| --- | --- | 
| `--backtrack-window` | `BacktrackWindow` | 
| `--cloudwatch-logs-export-configuration` | `CloudwatchLogsExportConfiguration` | 
| `--copy-tags-to-snapshot \| --no-copy-tags-to-snapshot` | `CopyTagsToSnapshot` | 
| `--db-instance-parameter-group-name` | `DBInstanceParameterGroupName` | 
| `--domain` | `Domain` | 
| `--domain-iam-role-name` | `DomainIAMRoleName` | 
| `--enable-global-write-forwarding \| --no-enable-global-write-forwarding` | `EnableGlobalWriteForwarding` | 
| `--enable-http-endpoint \| --no-enable-http-endpoint` | `EnableHttpEndpoint` | 
| `--option-group-name` | `OptionGroupName` | 
| `--port` | `Port` | 
| `--scaling-configuration` | `ScalingConfiguration` | 
| `--storage-type` | `StorageType` |