Lite 予約の作成と管理

このページでは、Lite 予約の概要と、予約の作成、表示、削除を行う方法について説明します。

予約の仕組み

Lite 予約は、リージョン内の複数のトピック間でスループット容量を予約して共有する方法です。予約を使用した容量管理は、個々のトピックの容量を 2 つの方法で設定するよりも簡単です。まず、モニタリングして管理するリソースが少なくなります。2 番目に、個々のトピックの容量を選択する必要はありません。予約の最大容量と、すべてのパーティションに適用される上限まで自動的にスケーリングされます。

予約を使用するには、同じリージョンにあるトピックを追加するだけです。予約はリージョン リソースです。

予約容量

予約の容量は、容量単位でプロビジョニングされます。予約にアタッチされている各 Lite トピックは、1 MiB/秒のパブリッシャー スループット、または 2 MiB/秒のサブスクライバー スループットに対して 1 容量単位を使用します。

予約内のトピックの合計スループットが容量を超えると、パブリッシングとサブスクリプションが抑制されます。たとえば、10 スループット単位の予約を作成すると、それぞれ 1 つのパーティションを持つ 5 つのトピックで 1 MiB/秒でのパブリッシュと 2 MiB/秒でのサブスクライブ、または 1 つのパーティションを持つ 1 つのトピックで 5 MiB/秒でのパブリッシュと 10 MiB/秒でのサブスクライブを行うことができます。

スループットを計算する際、各メッセージは少なくとも 256 バイトとしてカウントされます。

予約に含まれるすべての Lite トピック間でのパーティション数は、予約した容量単位数以下にする必要があります。上の例では、5 つのパーティションを持つ予約にトピックをもう 1 つ追加できます。ただし、6 つ目のパーティション トピックを追加しようとすると、処理が失敗します。

予約のない容量の構成

予約を行うと、あるトピックのクライアントが、同じ予約内の他の クライアントの妨げとなる可能性があります。これを防ぐ必要がある場合は、トピックを独自の予約に配置するか、トピックのパブリッシャーとサブスクライバーの容量を明示的にプロビジョニングします。

  • トピックのパブリッシュのスループット容量: スループット容量として 1 秒あたり 4~16 MiB を指定できます。この値は整数にする必要があります。
  • トピックのサブスクライブのスループット容量: スループット容量として 1 秒あたり 4~32 MiB を指定できます。この値は整数にする必要があります。

個々のトピックに対してプロビジョニングされたパブリッシャーとサブスクライバーの容量は変更できません。このため、常に予約を使用することをおすすめします。

Lite 予約の作成

Lite 予約は、関連付けられた Lite トピックと同じプロジェクトとリージョン内に存在する必要があります。使用可能なゾーンとリージョンのリストについては、Pub/Sub Lite のロケーションをご覧ください。

Lite トピックは、Cloud Console、gcloud コマンドライン ツール、または Pub/Sub Lite API を使用して作成できます。

Console

  1. Cloud Console で、[Lite 予約] ページに移動します。

    [Lite 予約] ページに移動

  2. [Lite 予約を作成] をクリックします。

  3. リージョンを選択します。

  4. Lite 予約 ID を入力します。

  5. スループット容量ユニットの量をプロビジョニングします。

  6. [作成] をクリックします。

gcloud

Lite 予約を作成するには、gcloud pubsub lite-reservations create コマンドを使用します。

gcloud pubsub lite-reservations create myRes \
  --location=us-central1 \
  --throughput-capacity=INTEGER_NUMBER_OF_UNITS
gcloud pubsub lite-topics create myTopic \
  --throughput-reservation=myRez \
  --zone=ZONE \
  --location=us-central1a \
  --partitions \
  --storage

Lite 予約の更新

Lite 予約は、Cloud Console、gcloud コマンドライン ツール、または Pub/Sub Lite API を使用して更新できます。

Console

  1. Cloud Console で、[Lite 予約] ページに移動します。

    [Lite 予約] ページに移動

  2. [Lite 予約 ID] をクリックします。

  3. [Lite 予約の詳細] ページで [編集] をクリックします。

gcloud

Lite 予約を更新するには、gcloud pubsub lite-reservations update コマンドを使用します。

gcloud pubsub lite-reservations update RESERVATION_ID \
  --location=REGION

次のように置き換えます。

  • RESERVATION_ID: Lite 予約の ID
  • REGION: 予約のリージョン

Lite 予約の詳細の取得

Lite 予約の詳細は、Cloud Console、gcloud コマンドライン ツール、または Pub/Sub Lite API を使用して取得できます。

Console

  1. Cloud Console で、[Lite 予約] ページに移動します。

    [Lite 予約] ページに移動

  2. [Lite 予約 ID] をクリックします。

gcloud

Lite 予約の詳細を取得するには、gcloud pubsub lite-reservations describe コマンドを使用します。

gcloud pubsub lite-reservations describe RESERVATION_ID \
  --location=REGION

次のように置き換えます。

  • RESERVATION_ID: Lite 予約の ID
  • REGION: 予約のリージョン

Lite 予約の一覧表示

Console

プロジェクト内の Lite 予約のリストを表示するには、Lite 予約ページに移動します。

[Lite 予約] ページに移動

gcloud

プロジェクト内の Lite 予約のリストを表示するには、gcloud pubsub lite-reservations list コマンドを使用します。

gcloud pubsub lite-reservations list \
  --location=REGION

次のように置き換えます。

  • REGION: 予約のリージョン

Lite 予約の削除

Lite 予約は、Cloud Console、gcloud コマンドライン ツール、または Pub/Sub Lite API を使用して削除できます。予約を削除する際に、予約にトピックが含まれていないことがあります。既存のトピックを別の予約にアタッチすると、予約を削除できます。

Console

  1. Cloud Console で、[Lite 予約] ページに移動します。

    [Lite 予約] ページに移動

  2. [Lite 予約 ID] をクリックします。

  3. [Lite 予約の詳細] ページで [削除] をクリックします。

  4. 表示されたダイアログで [削除] をクリックして、削除する Lite 予約の削除を確定します。

gcloud

Lite サブスクリプションを削除するには、gcloud pubsub lite-reservations delete コマンドを使用します。

gcloud pubsub lite-reservations delete RESERVATION_ID \
  --location=REGION

次のように置き換えます。

  • RESERVATION_ID: Lite 予約の ID
  • REGION: 予約のリージョン