

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

# Amazon MSK クラスターのブローカーサイズを更新する
<a name="msk-update-broker-type"></a>

Apache Kafka パーティションを再割り当てしなくても、ブローカーのサイズを変更することで、MSK クラスターをオンデマンドマンドでスケールできます。ブローカーのサイズを変更すると、クラスター I/O を中断することなく、ワークロードの変化に基づいて MSK クラスターのコンピューティング性能を柔軟に調整できます。Amazon MSK では、特定のクラスター内のすべてのブローカーに対して同じブローカーサイズを使用します。

スタンダードブローカーの場合、クラスターブローカーサイズを M5 または T3 から M7g へ、T3 から M5 へ、または M7g から M5 へ更新できます。

**注記**  
より大きなブローカーサイズからより小さなブローカーサイズに移行することはできません。例えば、M7g.large から T3.small などです。

Express ブローカーでは、M7g ブローカーサイズのみを使用できます。

このトピックでは、MSK クラスターのブローカーサイズを更新する方法について説明します。

ブローカーサイズを小さくすると、パフォーマンスが低下し、達成できるブローカーあたりの最大スループットが低下する可能性があることに注意してください。より大きなブローカーサイズへの移行はパフォーマンス向上につながる可能性があるが、コストが増加する可能性がある。

ブローカーサイズの更新は、クラスターの稼働中にローリング方式で行われます。そのため、Amazon MSK がブローカーサイズの更新を実行する際には、一度に 1 つずつブローカーを停止します。ブローカーサイズを更新する際にクラスターの可用性を高める方法については、「[高可用性クラスターの構築](bestpractices.md#ensure-high-availability)」を参照してください。生産性に影響が出る可能性をさらに減らすには、トラフィックが少ない期間にブローカーサイズの更新を実行することもできます。

ブローカーサイズの更新中は、引き続きデータの生成と消費を行うことができます。ただし、更新が完了するまでは、ブローカーの再起動や[Amazon MSK オペレーション](https://docs.aws.amazon.com/msk/1.0/apireference/operations.html)に記載されている更新操作を呼び出すことはできません。

クラスターをより小さいブローカーサイズに更新する場合、まずテストクラスターで更新を試して、シナリオへの影響を確認することをお勧めします。

**重要**  
各ブローカーごとのパーティション数が [クラスターの適切なサイズ設定: 標準ブローカーあたりのパーティション数](bestpractices.md#partitions-per-broker) で指定された上限を超える場合、クラスターをより小さなブローカーサイズに更新することはできません。

**Topics**
+ [を使用して Amazon MSK クラスターブローカーのサイズを更新する AWS マネジメントコンソール](#update-broker-type-console)
+ [を使用して Amazon MSK クラスターブローカーのサイズを更新する AWS CLI](#update-broker-type-cli)
+ [API を使用したブローカーサイズの更新](#update-broker-type-api)

## を使用して Amazon MSK クラスターブローカーのサイズを更新する AWS マネジメントコンソール
<a name="update-broker-type-console"></a>

このプロセスでは、 を使用して Amazon MSK クラスターブローカーのサイズを更新する方法を示します。 AWS マネジメントコンソール

1. にサインインし AWS マネジメントコンソール、[https://console.aws.amazon.com/msk/home?region=us-east-1\$1/home/](https://console.aws.amazon.com/msk/home?region=us-east-1#/home/) で Amazon MSK コンソールを開きます。

1. ブローカーサイズを更新する MSK クラスターを選択します。

1. クラスターの詳細ページで、**[ブローカーの概要]** セクションにある、**[ブローカーサイズの編集]** を選択します。

1. リストから必要なブローカーサイズを選択します。

1. 変更の保存。

## を使用して Amazon MSK クラスターブローカーのサイズを更新する AWS CLI
<a name="update-broker-type-cli"></a>

*ClusterArn*をクラスターの作成時に取得したAmazon リソースネーム (ARN) に置き換えて、次のコマンドを実行します。クラスターの ARN がない場合は、すべてのクラスターを一覧表示することで見つけられます。詳細については、「[Amazon MSK クラスターを一覧表示する](msk-list-clusters.md)」を参照してください。

1. *[Current-Cluster-Version]* をクラスターの現在のバージョンに、*[TargetType]* を変更先の新しいブローカーサイズに変更します。ブローカーサイズについての詳細は、「[Amazon MSK ブローカー タイプ](broker-instance-types.md)」を参照してください。

   ```
   aws kafka update-broker-type --cluster-arn ClusterArn --current-version Current-Cluster-Version --target-instance-type TargetType
   ```

   次に、このコマンドの使用例を示します。

   ```
   aws kafka update-broker-type --cluster-arn "arn:aws:kafka:us-east-1:0123456789012:cluster/exampleName/abcd1234-0123-abcd-5678-1234abcd-1" --current-version "K1X5R6FKA87" --target-instance-type kafka.m5.large 
   ```

   このコマンドの出力は、次の JSON の例のようになります。

   ```
   {
       "ClusterArn": "arn:aws:kafka:us-east-1:0123456789012:cluster/exampleName/abcd1234-0123-abcd-5678-1234abcd-1",
       "ClusterOperationArn": "arn:aws:kafka:us-east-1:012345678012:cluster-operation/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2/0123abcd-abcd-4f7f-1234-9876543210ef"
   }
   ```

1. `update-broker-type` オペレーションの結果を取得するには、*ClusterOperationArn*を `update-broker-type` コマンドの出力で取得した ARN に置き換えて、次のコマンドを実行します。

   ```
   aws kafka describe-cluster-operation --cluster-operation-arn ClusterOperationArn
   ```

   この `describe-cluster-operation` コマンドの出力は、次の JSON の例のようになります。

   ```
   {
     "ClusterOperationInfo": {
       "ClientRequestId": "982168a3-939f-11e9-8a62-538df00285db",
       "ClusterArn": "arn:aws:kafka:us-east-1:0123456789012:cluster/exampleName/abcd1234-0123-abcd-5678-1234abcd-1",
       "CreationTime": "2021-01-09T02:24:22.198000+00:00",
       "OperationArn": "arn:aws:kafka:us-east-1:012345678012:cluster-operation/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2/0123abcd-abcd-4f7f-1234-9876543210ef",
       "OperationState": "UPDATE_COMPLETE",
       "OperationType": "UPDATE_BROKER_TYPE",
       "SourceClusterInfo": {
         "InstanceType": "t3.small"
       },
       "TargetClusterInfo": {
         "InstanceType": "m5.large"
       }
     }
   }
   ```

   `OperationState` の値が `UPDATE_IN_PROGRESS` の場合は、しばらく待ってから再度 `describe-cluster-operation` コマンドを実行します。

## API を使用したブローカーサイズの更新
<a name="update-broker-type-api"></a>

API を使用してブローカーサイズを更新するには、「[UpdateBrokerType](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn-nodes-type.html#UpdateBrokerType)」を参照してください。

`UpdateBrokerType` を使用して、クラスターのブローカーサイズを M5 または T3 から M7g に、または M7g から M5 に更新できます。