このドキュメントでは、Pub/Sub Lite トピックの作成、表示、削除について説明します。
Lite トピックの概要
Pub/Sub Lite サービスには、サブスクライバーがメッセージを受信できるよう、パブリッシャーがメッセージを送信できるトピックが必要です。Pub/Sub Lite では、ゾーンまたはリージョンの Lite トピックを作成できます。
ゾーン Lite トピックとリージョン Lite トピックでは、データの複製方法のみが異なります。その他のトピック プロパティはすべて、このドキュメントの後半のセクションで説明するものと同じです。
Lite トピックのデータ レプリケーション
Pub/Sub Lite リージョン トピックでは、単一リージョンの 2 つのゾーンにデータが保存されます。Pub/Sub Lite ゾーン トピックでは、データは 1 つのゾーン内でのみ複製されます。Pub/Sub Lite ではデータは非同期で複製されます。
Pub/Sub Lite を使用できるかどうかは、アプリケーションのフロントエンドとストレージの両方を含む、基盤となるコンポーネントを使用できるかどうかに左右されます。
Pub/Sub Lite ゾーンのトピックを使用できるかどうかは、構成されたゾーンでのアプリケーション フロントエンドとストレージを使用できるかどうかに左右されます。アプリケーションのフロントエンドまたはストレージでゾーンの障害が発生すると、停止中はゾーン Lite トピックを使用できなくなります。
Pub/Sub Lite リージョンのトピックを使用できるかどうかは、構成されたリージョンでのアプリケーション フロントエンドとストレージを使用できるかどうかに左右されます。次のような種類の障害が発生する可能性があります。
アプリケーションのフロントエンド、またはストレージでゾーン障害が発生しても、リージョンの Lite トピックは引き続き使用できます。
アプリケーションのフロントエンドとストレージの両方でゾーンの障害が発生しても、両方のコンポーネントで同時に障害が発生しない限り、リージョン Lite トピックは引き続き使用できます。
アプリケーションのフロントエンドとストレージの両方で同時に障害が発生した場合、停止中はリージョン Lite トピックを使用できません。この間、クライアントはメッセージのパブリッシュまたは使用に失敗する可能性がありますが、メッセージは正しい順序で配信されます。
リージョン Lite トピックは、ほとんどの種類の単一ゾーンの障害から保護します。ただし、レプリケーションの非同期の性質上、単一のゾーン内で複数のコンポーネントが同時に障害となることがあります。その結果、リージョン Lite トピックは使用できなくなります。
Lite トピックのプロパティ
Lite トピックのプロパティは次のとおりです。
パーティションの数。パーティションは、Pub/Sub Lite の並列処理の基本単位です。Lite トピックには 1 つ以上のパーティションを設定できます。
パーティションの容量。パーティションの容量は、次の 3 つのプロパティで表されます。
パブリッシュのスループット(MiBps)。 メッセージをパブリッシュできる最大レート。
サブスクライブのスループット(MiBps)。Lite サブスクリプションにメッセージが転送される最大レート。
ストレージ(GiB)。パーティション内のメッセージの最大サイズ。パーティションの構成可能な最小容量は 30 GiB です。
Lite トピックのストレージ容量を増やす。Lite トピック内のすべてのパーティションには、同じストレージ容量が構成されています。Lite トピックのストレージ容量は、トピック内のすべてのパーティションのストレージ容量の合計です。たとえば、Lite トピックに 8 つのパーティションがあり、各パーティションのサイズが 30 GiB の場合、Lite トピックの合計ストレージ容量は 240 GiB(8 x 30)です。
Lite トピックのスループット容量。スループット容量は、Lite トピック内にあるすべてのパーティションのパブリッシュ スループットとサブスクライブ スループットの合計容量で構成されています。全体として 1 GiB のパブリッシュ スループットをサポートできるトピックがあっても、効果的にスループットを制限するのはパーティションごとのパブリッシュ上限です。
サブスクライバー クライアントとサブスクリプションの制限。Pub/Sub Lite では、単一のパーティションと単一のサブスクリプションに対して 1 つのサブスクライバー クライアントがサポートされています。たとえば、5 つのパーティションがある 1 つのトピックに対する 1 つのサブスクリプションには、そのサブスクリプションのメッセージを使用するサブスクライバー クライアントを最大 5 つ含めることができます。これより多くのサブスクライバー クライアントを構成しても、超過しているクライアントはアイドル状態のままになります。同じトピックに 2 個のサブスクリプションがある場合は、各サブスクリプションにクライアントを 5 個ずつ、最大 10 個のサブスクライバー クライアントを含めることができます。
予約 予約は、複数のトピックのスループット容量をプロビジョニングして管理する最も簡単な方法です。予約によるスループット容量のプロビジョニングは、リージョン Lite では必須ですが、ゾーン Lite トピックでは省略可です。
ゾーン Lite トピックに予約を使用しない場合は、トピックのパブリッシュとサブスクライブのスループット容量を明示的にプロビジョニングする必要があります。予約がない場合、Lite トピック内のすべてのパーティションには同じスループット容量が構成されます。詳細については、予約なしでスループット容量を構成するをご覧ください。
ストレージ構成。ストレージを構成するには、ストレージ容量と、必要に応じてメッセージの保持期間の両方を指定する必要があります。
メッセージ保持期間。Lite トピックでメッセージが保存される最長時間。メッセージ保持期間を指定しなかった場合、Lite トピックはストレージ容量を超過するまでメッセージを保存します。
ストレージ容量。Pub/Sub Lite トピックの容量は、トピック内のパーティションの数と各パーティションのストレージ容量によって決まります。パーティションあたりのストレージ: 各パーティションのストレージ容量(バイト)。リージョン Lite トピックでは、パブリッシュされるバイトごとに 2 バイトのストレージ容量が使用されます。ゾーン Lite トピックは、パブリッシュされるバイトごとに 1 バイトのストレージ容量を使用します。
ストレージ容量を超えると、Pub/Sub Lite サービスによってメッセージのパブリッシュが続行されます。ただし、ストレージ容量を増やすために、パーティションから最も古いメッセージが削除されます。最も古いメッセージは、そのメッセージがメッセージ保持期間内にある場合でも削除されます。TTL が期限切れになる前に、サービスによってメッセージが削除されることはありません。ただし、新しくパブリッシュされたメッセージ用にスペースを確保する必要がある場合は、メッセージを削除する必要があります。容量と料金の関係については、Pub/Sub Lite の料金をご覧ください。
トピックへの名前付けに関するガイドライン
Pub/Sub Lite リソース名は、トピック、サブスクリプション、予約などの Pub/Sub Lite リソースを一意に識別します。リソース名は次の形式にする必要があります。
projects/project-identifier/collection/ID
project-identifier
: Google Cloud コンソールから取得可能なプロジェクト ID またはプロジェクト番号を指定する必要があります。たとえば、my-cool-project
はプロジェクト ID です。123456789123
はプロジェクト番号です。collection
:topics
、subscriptions
、reservations
のいずれかにする必要があります。ID
: 次のガイドラインに従う必要があります。- 文字列
goog
で始めないこと。 - 文字から始まる
- 3~255 文字の長さであること。
- 次の文字だけが含まれている: 文字
[A-Za-z]
、数字[0-9]
、ダッシュ-
、アンダースコア_
、ピリオド.
、チルダ~
、プラス記号+
、パーセント記号%
URL エンコードのないリソース名で、上記リストの特殊文字を使用できます。ただし、URL で使用されている場合、その他すべての特殊文字が適切にエンコードまたはデコードされることを確認する必要があります。たとえば、
mi-tópico
は無効な ID です。mi-t%C3%B3pico
は有効です。この形式は、REST 呼び出しを行う場合に重要です。- 文字列
Lite トピックのスループット容量を向上させる
Lite 予約を使用しない場合は、ゾーン Lite トピックの各パーティションのスループット容量を、次の上限で設定された値に設定できます。
パブリッシュのスループットは 4~16 MiBps
サブスクライブのスループットは 4~32 MiBps
これらの上限は、Lite 予約に関連付けられたパーティションにも適用されます。予約を設定することにより、予約の合計容量を超えない限り、指定された制限内のスループット容量を各パーティションで使用できます。必要に応じて、パーティションあたりの実際のスループットに下限を設定すると、トラフィックが予測しやすくなります。
トピック内のパーティションの数を増やして、水平方向にスケーリングできます。トピック内のパーティションの数を減らすことはできません。
パーティションの数を変更した場合は、メッセージの相対的な順序は保持されません。内部的には、メッセージはハッシュ関数を使用してパーティションに割り当てられています。 トピック内のパーティションの数を更新すると、このハッシュ関数は変更されます。同じキーであっても、パーティション カウントの更新後にパブリッシュされたメッセージは、更新の前にパブリッシュされたものとは異なるパーティションにマッピングされる可能性が高くなります。
また、トピックのサイズ変更がすべてのパブリッシャーに反映されるまでには数秒かかります。一部のパブリッシャーが新しいハッシュ関数を使用し、一部のパブリッシャーが古いハッシュ関数を使用している期間が短時間ながら存在します。
Lite トピックのストレージ容量を増やす
Lite トピックのストレージ容量を増減することもできます。Lite トピックでは、各パーティションに同じ容量のストレージをプロビジョニングします。ストレージを 60 GiB に増やすと、各パーティションのストレージ容量が 60 GiB になります。
Lite トピックでストレージ容量を減らすと、Pub/Sub Lite サービスは最初に最も古いメッセージを削除します。
容量と料金の関係については、Pub/Sub Lite の料金をご覧ください。
Lite トピックの作成
Lite トピックは、Google Cloud コンソール、Google Cloud CLI、または Pub/Sub Lite API を使用して作成できます。
使用可能なリージョンとゾーンのリストについては、Pub/Sub Lite のロケーションをご覧ください。
Console
[Lite トピック] ページに移動します。
[Lite トピックを作成] をクリックします。
ゾーン Lite トピックを作成するには、リージョンとリージョン内のゾーンを選択します。
リージョン Lite トピックを作成するには、リージョンを選択します。
トピックの作成後にロケーションを更新することはできません。
[名前] セクションでLite トピック ID を入力します。
Lite トピック名には、Lite のトピック ID、ロケーション、プロジェクト番号が含まれます。
[スループット] セクションで次の操作を行います。
予約を選択または作成します。
これは、ゾーン Lite トピックでは省略可、リージョン Lite トピックでは必須です。
パブリッシュのピーク スループットとサブスクライブのピーク スループットを入力します。
パーティションの数は、入力に基づいて自動的に設定されます。この数は、トピックを保存した後に編集できます。
[メッセージ ストレージ] セクションで、次の操作を行います。
パーティションあたりのストレージを入力します。
メッセージの保持期間として、次のいずれかのオプションを選択します。
変更内容を確認し、[作成] をクリックします。
gcloud
Lite トピックを作成するには、gcloud pubsub lite-topics create
コマンドを使用します。
gcloud pubsub lite-topics create TOPIC_ID \ --location=LOCATION \ --partitions=NUMBER_OF_PARTITIONS \ --per-partition-bytes=STORAGE_PER_PARTITION \ [--throughput-reservation=RESERVATION_NAME \] [--message-retention-period=MESSAGE_RETENTION_PERIOD]
以下を置き換えます。
TOPIC_ID: Lite トピックの ID
LOCATION: Pub/Sub Lite がサポートするロケーションの名前
NUMBER_OF_PARTITIONS: Lite トピックのパーティション数の整数
STORAGE_PER_PARTITION: 各パーティションのストレージ容量(
30GiB
など)RESERVATION_NAME: Lite 予約の完全修飾パス(
projects/123456789/locations/us-west1/reservations/my-reservation
など)MESSAGE_RETENTION_PERIOD: Lite トピックがメッセージを保存する期間(
1d
、2w
など)
リクエストが成功すると、コマンドラインに確認メッセージが表示されます。
Created [TOPIC_ID].
プロトコル
Lite トピックを作成するには、次のような POST
リクエストを送信します。
POST https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID Authorization: Bearer $(gcloud auth print-access-token)
次のように置き換えます。
REGION: Lite トピックを保存するリージョン
PROJECT_NUMBER: Lite トピックを作成するプロジェクトのプロジェクト番号
LOCATION: Pub/Sub Lite がサポートするロケーションの名前
TOPIC_ID: Lite トピックの ID
リクエスト本文に次のフィールドを指定します。
{ "partitionConfig": { "count": NUMBER_OF_PARTITIONS, "capacity": { "publishMibPerSec": publish_CAPACITY, "subscribeMibPerSec": subscribe_CAPACITY, } }, "retentionConfig": { "perPartitionBytes": STORAGE_PER_PARTITION, "period": MESSAGE_RETENTION_PERIOD, }, "reservationConfig": { "throughputReservation": RESERVATION_NAME } }
以下を置き換えます。
NUMBER_OF_PARTITIONS: Lite トピックのパーティション数の整数
STORAGE_PER_PARTITION: 各パーティションのストレージ容量(
30GiB
など)publish_CAPACITY: 各パーティションのパブリッシュ スループット容量を表す整数
subscribe_CAPACITY: 各パーティションのサブスクライブ スループット容量を表す整数
MESSAGE_RETENTION_PERIOD: Lite トピックがメッセージを保存する期間(
1d
、2w
など)RESERVATION_NAME: Lite 予約の完全修飾パス(
projects/123456789/locations/us-west1/reservations/my-reservation
など)
リクエストが成功すると、レスポンスは JSON 形式の Lite トピックになります。
{ "name": projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID, "partitionConfig": { "count": NUMBER_OF_PARTITIONS, "capacity": { "publishMibPerSec": publish_CAPACITY, "subscribeMibPerSec": subscribe_CAPACITY, } }, "retentionConfig": { "perPartitionBytes": STORAGE_PER_PARTITION, "period": MESSAGE_RETENTION_PERIOD, }, "reservationConfig": { "throughputReservation": RESERVATION_NAME } }
Go
このサンプルを実行する前に、Pub/Sub Lite クライアント ライブラリの Go の設定手順を実施してください。
Java
このサンプルを実行する前に、Pub/Sub Lite クライアント ライブラリの Java の設定手順を実施してください。
Python
このサンプルを実行する前に、Pub/Sub Lite クライアント ライブラリの Python の設定手順を実施してください。
Lite トピックを作成した後は、パーティションごとのスループットとストレージ容量をスケーリングできます。パーティション数は増やすことはできますが、減らすことはできません。
Lite トピックを更新する
Lite トピックの次のプロパティを更新できます。
Lite トピックに関連付けられている予約
トピック内のパーティションの数(増やすのみ可能)
パブリッシュとサブスクライブのスループット容量の上限
パーティションあたりのストレージ
メッセージ保持のタイプ
トピックのスループット容量またはストレージ容量をスケーリングする前に、スループット容量をスケーリングするとストレージ容量をスケーリングするをご覧ください。
Lite トピックは、Google Cloud コンソール、Google Cloud CLI、または Pub/Sub Lite API を使用して更新できます。
Console
[Lite トピック] ページに移動します。
[Lite トピック ID] をクリックします。
[編集] をクリックします。
次の更新の一部またはすべてを行うことができます。
- 別の予約を使用する。ゾーントピックの場合は、予約を使用しないことを選択できます。
- パーティション数を入力する。この値は増やすことはできますが、減らすことはできません。
- パブリッシュとサブスクライブの最大許容スループットを有効または無効にする。
- ゾーントピックの場合は、予約済みのパブリッシュとサブスクライブのスループットを更新する。トピックに予約が関連付けられている場合、更新されたスループットには新しい上限が反映されます。
- パーティションあたりのストレージ容量を編集する。
- メッセージの保持期間を編集する。
[更新] をクリックします。
gcloud
Lite トピックを更新するには、gcloud pubsub lite-topics update
コマンドを使用します。
gcloud pubsub lite-topics update TOPIC_ID \ --location=LOCATION \ --partitions=NUMBER_OF_PARTITIONS \ --per-partition-publish-mib=publish_CAPACITY \ --per-partition-subscribe-mib=subscribe_CAPACITY \ --per-partition-bytes=STORAGE_PER_PARTITION \ --message-retention-period=MESSAGE_RETENTION_PERIOD
以下を置き換えます。
TOPIC_ID: Lite トピックの ID
LOCATION: Lite トピックが存在しているロケーションの名前
NUMBER_OF_PARTITIONS: Lite トピックに構成するパーティションの数
publish_CAPACITY: 各パーティションのパブリッシュ スループット容量を表す整数
subscribe_CAPACITY: 各パーティションのサブスクライブ スループット容量を表す整数
STORAGE_PER_PARTITION: 各パーティションのストレージ容量(
30GiB
など)MESSAGE_RETENTION_PERIOD: Lite トピックがメッセージを保存する期間(
1d
、2w
など)
リクエストが成功すると、コマンドラインに Lite トピックが表示されます。
name: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID partitionConfig: count: NUMBER_OF_PARTITIONS capacity: publishMibPerSec: publish_CAPACITY subscribeMibPerSec: subscribe_CAPACITY retentionConfig: perPartitionBytes: STORAGE_PER_PARTITION period: MESSAGE_RETENTION_PERIOD
プロトコル
Lite トピックを更新するには、次のような PATCH
リクエストを送信します。
PATCH https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID?updateMask=partitionConfig.capacity,retentionConfig.perPartitionBytes,retentionConfig.period,partitionConfig.count Authorization: Bearer $(gcloud auth print-access-token)
次のように置き換えます。
REGION: Lite トピックが配置されているリージョン
PROJECT_NUMBER: Lite トピックのプロジェクトのプロジェクト番号
LOCATION: Lite トピックが存在しているロケーションの名前
TOPIC_ID: Lite トピックの ID
リクエスト本文に次のフィールドを指定します。
{ "partitionConfig": { "count": NUMBER_OF_PARTITIONS, "capacity": { "publishMibPerSec": publish_CAPACITY, "subscribeMibPerSec": subscribe_CAPACITY, } }, "retentionConfig": { "perPartitionBytes": STORAGE_PER_PARTITION, "period": MESSAGE_RETENTION_PERIOD, }, }
次のように置き換えます。
publish_CAPACITY: 各パーティションのパブリッシュ スループット容量を表す整数
subscribe_CAPACITY: 各パーティションのサブスクライブ スループット容量を表す整数
STORAGE_PER_PARTITION: 各パーティションのストレージ容量(
30GiB
など)MESSAGE_RETENTION_PERIOD: Lite トピックがメッセージを保存する期間(
1d
、2w
など)NUMBER_OF_PARTITIONS: Lite トピックに構成するパーティションの数
リクエストが成功すると、レスポンスは JSON 形式の Lite トピックになります。
{ "name": projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID, "partitionConfig": { "count": NUMBER_OF_PARTITIONS, "capacity": { "publishMibPerSec": publish_CAPACITY, "subscribeMibPerSec": subscribe_CAPACITY, } }, "retentionConfig": { "perPartitionBytes": STORAGE_PER_PARTITION, "period": MESSAGE_RETENTION_PERIOD, }, }
Go
このサンプルを実行する前に、Pub/Sub Lite クライアント ライブラリの Go の設定手順を実施してください。
Java
このサンプルを実行する前に、Pub/Sub Lite クライアント ライブラリの Java の設定手順を実施してください。
Python
このサンプルを実行する前に、Pub/Sub Lite クライアント ライブラリの Python の設定手順を実施してください。
Lite トピックの詳細を表示する
Lite トピックの詳細は、Google Cloud コンソール、Google Cloud CLI、または Pub/Sub Lite API を使用して取得できます。
Console
[Lite トピック] ページに移動します。
[Lite トピック ID] をクリックします。
gcloud
Lite トピックの詳細を取得するには、gcloud pubsub lite-topics describe
コマンドを使用します。
gcloud pubsub lite-topics describe TOPIC_ID \ --location=LOCATION
以下を置き換えます。
TOPIC_ID: Lite トピックの ID
LOCATION: Lite トピックが存在しているロケーションの名前
リクエストが成功すると、コマンドラインに Lite トピックが表示されます。
name: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID partitionConfig: count: NUMBER_OF_PARTITIONS capacity: publishMibPerSec: publish_CAPACITY subscribeMibPerSec: subscribe_CAPACITY retentionConfig: perPartitionBytes: STORAGE_PER_PARTITION period: MESSAGE_RETENTION_PERIOD
プロトコル
Lite トピックの詳細を取得するには、次のような GET
リクエストを送信します。
GET https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID Authorization: Bearer $(gcloud auth print-access-token)
次のように置き換えます。
REGION: Lite トピックが配置されているリージョン
PROJECT_NUMBER: Lite トピックのプロジェクトのプロジェクト番号
LOCATION: Lite トピックが存在しているロケーションの名前
TOPIC_ID: Lite トピックの ID
リクエストが成功すると、レスポンスは JSON 形式の Lite トピックになります。
{ "name": projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID, "partitionConfig": { "count": NUMBER_OF_PARTITIONS, "capacity": { "publishMibPerSec": publish_CAPACITY, "subscribeMibPerSec": subscribe_CAPACITY, } }, "retentionConfig": { "perPartitionBytes": STORAGE_PER_PARTITION, "period": MESSAGE_RETENTION_PERIOD, }, }
Go
このサンプルを実行する前に、Pub/Sub Lite クライアント ライブラリの Go の設定手順を実施してください。
Java
このサンプルを実行する前に、Pub/Sub Lite クライアント ライブラリの Java の設定手順を実施してください。
Python
このサンプルを実行する前に、Pub/Sub Lite クライアント ライブラリの Python の設定手順を実施してください。
Lite トピックのリスト表示
Google Cloud コンソール、Google Cloud CLI、または Pub/Sub Lite API を使用して、プロジェクト内の Lite トピックを一覧表示できます。
Console
プロジェクトの Lite トピックのリストを表示するには、[Lite トピック] ページに移動します。
gcloud
- プロジェクト内の Lite トピックを一覧表示するには、
gcloud pubsub lite-topics list
コマンドを使用します。
gcloud pubsub lite-topics list \ --location=LOCATION
LOCATION は、Lite トピックが配置されているロケーションの名前に置き換えます。
リクエストが成功すると、コマンドラインに Lite トピックが表示されます。
--- name: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID partitionConfig: count: NUMBER_OF_PARTITIONS capacity: publishMibPerSec: publish_CAPACITY subscribeMibPerSec: subscribe_CAPACITY retentionConfig: perPartitionBytes: STORAGE_PER_PARTITION period: MESSAGE_RETENTION_PERIOND --- name: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID partitionConfig: count: NUMBER_OF_PARTITIONS capacity: publishMibPerSec: publish_CAPACITY subscribeMibPerSec: subscribe_CAPACITY retentionConfig: perPartitionBytes: STORAGE_PER_PARTITION period: MESSAGE_RETENTION_PERIOND
プロトコル
プロジェクト内の Lite トピックを一覧表示するには、次のように GET
リクエストを送信します。
GET https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/topics Authorization: Bearer $(gcloud auth print-access-token)
次のように置き換えます。
REGION: Lite トピックが配置されているリージョン
PROJECT_NUMBER: Lite トピックのプロジェクトのプロジェクト番号
リクエストが成功すると、Lite トピックのリストが JSON 形式で返されます。
{ "topics": [ { "name": "projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID", }, { "name": "projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID", } ] }
Go
このサンプルを実行する前に、Pub/Sub Lite クライアント ライブラリの Go の設定手順を実施してください。
Java
このサンプルを実行する前に、Pub/Sub Lite クライアント ライブラリの Java の設定手順を実施してください。
Python
このサンプルを実行する前に、Pub/Sub Lite クライアント ライブラリの Python の設定手順を実施してください。
Lite トピックを削除する
Lite トピックは、Google Cloud コンソール、Google Cloud CLI、または Pub/Sub Lite API を使用して削除できます。
Console
[Lite トピック] ページに移動します。
[Lite トピック ID] をクリックします。
[Lite トピックの詳細] ページで [削除] をクリックします。
表示されるフィールドに、「
delete
」と入力して削除する Lite トピックを確定します。[削除] をクリックします。
gcloud
Lite トピックを削除するには、gcloud pubsub lite-topics delete
コマンドを使用します。
delete
コマンドを実行します。gcloud pubsub lite-topics delete TOPIC_ID \ --location=LOCATION
以下を置き換えます。
TOPIC_ID: Lite トピックの ID
LOCATION: Lite トピックが存在しているロケーションの名前
確定するには「
Y
」と入力します。
リクエストが成功した場合のレスポンスは、次のようになります。
Deleted topic [TOPIC_ID].
プロトコル
Lite トピックを削除するには、次のような DELETE
リクエストを送信します。
DELETE https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID Authorization: Bearer $(gcloud auth print-access-token)
次のように置き換えます。
REGION: Lite トピックが配置されているリージョン
PROJECT_NUMBER: Lite トピックのプロジェクトのプロジェクト番号
LOCATION: Lite トピックが存在しているロケーションの名前
TOPIC_ID: Lite トピックの ID
リクエストが成功した場合のレスポンスは空の JSON オブジェクトです。
Go
このサンプルを実行する前に、Pub/Sub Lite クライアント ライブラリの Go の設定手順を実施してください。
Java
このサンプルを実行する前に、Pub/Sub Lite クライアント ライブラリの Java の設定手順を実施してください。
Python
このサンプルを実行する前に、Pub/Sub Lite クライアント ライブラリの Python の設定手順を実施してください。
Lite トピックを削除すると、そのトピックにメッセージをパブリッシュすることはできません。Lite トピックの Lite サブスクリプションは引き続き存在しますが、Lite サブスクリプションからメッセージを受信することはできません。
次のステップ
- Lite トピックにメッセージをパブリッシュする。
- Lite トピックに Lite サブスクリプションを作成する。
- Lite サブスクリプションからメッセージを受信する。