メッセージを転送するバスを作成する

コンソール

1. Google Cloud コンソールで、[Eventarc] > [バス] ページに移動します。

   [バス] に移動

2. [add_box バスを作成] をクリックします。

3. [バスの作成] ページで、次の操作を行います。

   1. バス名を入力します。これはバスの ID です。
   2. 省略可: [バスの表示名] に、[バスの詳細] ページに表示される名前を入力します。
   3. [リージョン] リストで、バスをデプロイするサポートされているリージョンを選択します。
   4. [ログの重大度] リストで、ログエントリに記述されているイベントの最小重大度を選択します。デフォルトは None です。詳細については、LogSeverity をご覧ください。
   5. [暗号化] で、デフォルトの Google-managed encryption key を受け入れるか、[Cloud KMS 鍵] を選択します。詳細については、顧客管理の暗号鍵（CMEK）を使用するをご覧ください。

   6. [Cloud KMS 鍵] を選択した場合は、次の操作を行います。

      1. [鍵の種類] リストで、鍵を管理する方法を選択します。

         鍵は手動で管理することも、Autokey を使用してオンデマンドでキーリングと鍵を生成することもできます。[Cloud KMS with Autokey] オプションが無効になっている場合、このオプションは現在のリソースタイプとまだ統合されていません。

      2. [Cloud KMS 鍵の選択] で、鍵を選択します。

         顧客管理の暗号鍵を表示するには、リージョンを選択する必要があります。

      3. （省略可）鍵のリソース名を手動で入力するには、[顧客管理の暗号鍵を選択] リストで [手動でキーを入力] をクリックして、指定された形式で鍵の名前を入力します。

      4. プロンプトが表示されたら、Eventarc サービス エージェントに cloudkms.cryptoKeyEncrypterDecrypter ロールを付与します。

   7. 省略可: メッセージ ソースを追加するには、add [ソースを追加] をクリックします。

      1. [メッセージ ソースを追加] ペインで、Google API メッセージ プロバイダのデフォルトの google-api-source をそのまま使用するか、別のソース名を入力します。

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

         これにより、Google ソースから直接送信されるイベントを自動的に収集できます。

         バスと同じ Google Cloudプロジェクト内のリソースからのイベントのみがパブリッシュされます。詳細については、Google ソースからイベントをパブリッシュするをご覧ください。

   8. 省略可: ラベルを追加するには、add [ラベルを追加] をクリックします。ラベルは、Google Cloud リソースの整理に役立つ Key-Value ペアです。詳細については、ラベルとはをご覧ください。

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

gcloud

1. ターミナルを開きます。

2. gcloud beta eventarc message-buses create コマンドを使用してバスを作成します。

   gcloud beta eventarc message-buses create BUS_NAME \
       --location=REGION
   

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

   • BUS_NAME: バスの ID または完全修飾識別子

   • REGION: バスのサポートされているロケーション

     または、Google Cloud CLI の場所プロパティを設定することもできます。

     gcloud config set eventarc/location REGION
     

   省略可: 次のフラグも使用できます。

   • --async: 処理中のオペレーションの完了を待たずに、コマンドからすぐに戻ります。
   • --crypto-key: 顧客管理の暗号鍵の完全修飾名を指定します。指定しない場合は、 Google-owned and managed keys が使用されます。
   • --logging-config: ログエントリに記述されているイベントの最小重大度を構成します。NONE、DEBUG、INFO、NOTICE、WARNING、ERROR、CRITICAL、ALERT、EMERGENCY のいずれかである必要があります。デフォルトは NONE です。詳細については、LogSeverity をご覧ください。

REST API

バスを作成するには、projects.locations.messageBuses.create メソッドを使用します。

リクエストのデータを使用する前に、次のように置き換えます。

• BUS_NAME: バスの表示名（例: my_bus）。
• LABEL_KEY、LABEL_VALUE: 省略可。 Google Cloud リソースの整理に役立つラベルの Key-Value ペアのマップです。詳細については、ラベルとはをご覧ください。
• ANNOTATION_KEY、ANNOTATION_VALUE: 省略可。自由形式のテキストのアノテーション キーと値のペアのマップ。これらを使用して、リソースに関連付けられた任意の情報を付加できます。詳細については、アノテーションをご覧ください。
• ENCRYPT_KEY: 省略可。バスが projects/PROJECT_NAME/locations/LOCATION/keyRings/RING_NAME/cryptoKeys/KEY_NAME 形式のデータ暗号化に使用する Cloud KMS 鍵。詳細については、顧客管理の暗号鍵の使用をご覧ください。
• PROJECT_ID: 実際の Google Cloudプロジェクト ID。
• LOCATION: バスを作成するリージョン（例: us-central1）。
• LOG_SEVERITY: 省略可。ログエントリに記述されているイベントの最小重大度。NONE、DEBUG、INFO、NOTICE、WARNING、ERROR、CRITICAL、ALERT、EMERGENCY のいずれか。デフォルトは NONE です。詳細については、LogSeverity をご覧ください。

リクエストの本文（JSON）:

{
  "display_name": "BUS_NAME",
  "labels": {"LABEL_KEY":"LABEL_VALUE"},
  "annotations": {"ANNOTATION_KEY":"ANNOTATION_VALUE"},
  "cryptoKeyName": "ENCRYPT_KEY",
  "loggingConfig": {"logSeverity":"LOG_SEVERITY"}
}

リクエストを送信するには、次のいずれかのオプションを展開します。

cat > request.json << 'EOF'
{
  "display_name": "BUS_NAME",
  "labels": {"LABEL_KEY":"LABEL_VALUE"},
  "annotations": {"ANNOTATION_KEY":"ANNOTATION_VALUE"},
  "cryptoKeyName": "ENCRYPT_KEY",
  "loggingConfig": {"logSeverity":"LOG_SEVERITY"}
}
EOF

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://eventarc.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/messageBuses?messageBusId=BUS_NAME"

@'
{
  "display_name": "BUS_NAME",
  "labels": {"LABEL_KEY":"LABEL_VALUE"},
  "annotations": {"ANNOTATION_KEY":"ANNOTATION_VALUE"},
  "cryptoKeyName": "ENCRYPT_KEY",
  "loggingConfig": {"logSeverity":"LOG_SEVERITY"}
}
'@  | Out-File -FilePath request.json -Encoding utf8

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://eventarc.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/messageBuses?messageBusId=BUS_NAME" | Select-Object -Expand Content

成功した場合、レスポンスの本文には、新しく作成された Operation のインスタンスが含まれます。

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.eventarc.v1.OperationMetadata",
    "createTime": "2024-01-25T17:17:45.782370139Z",
    "target": "projects/PROJECT_ID/locations/LOCATION/messageBuses/BUS_NAME",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

コンソール

1. Google Cloud コンソールで、[Eventarc] > [バス] ページに移動します。

   [バス] に移動

   [バスの詳細] ページが開きます。

2. delete [削除] をクリックします。

3. バスの削除を求めるメッセージが表示されたら、バスを使用するように構成されているメッセージ ソースが使用できなくなることを確認し、[続行しますか？] チェックボックスをオンにします。

4. 削除を確定するには、「Delete」と入力します。

5. [削除] をクリックします。

gcloud

1. ターミナルを開きます。

2. gcloud beta eventarc message-buses delete コマンドを使用してバスを削除します。

   gcloud beta eventarc message-buses delete BUS_NAME \
       --location=REGION
   

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

   • BUS_NAME: バスの ID または完全修飾識別子
   • REGION: バスのサポートされているロケーション

REST API

バスを削除するには、projects.locations.messageBuses.delete メソッドを使用します。

リクエストのデータを使用する前に、次のように置き換えます。

• PROJECT_ID: 実際の Google Cloudプロジェクト ID。
• LOCATION: バスが作成されるリージョン（例: us-central1）。
• BUS_NAME: 削除するバスの名前。

リクエストを送信するには、次のいずれかのオプションを展開します。

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://eventarc.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/messageBuses/BUS_NAME"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://eventarc.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/messageBuses/BUS_NAME" | Select-Object -Expand Content

成功した場合、レスポンスの本文には、新しく作成された Operation のインスタンスが含まれます。

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.eventarc.v1.OperationMetadata",
    "createTime": "2024-01-25T17:17:45.782370139Z",
    "target": "projects/PROJECT_ID/locations/LOCATION/messageBuses/BUS_NAME",
    "verb": "delete",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}