CLI の前提条件

CLI を使用してターゲットを管理する前に、以下の手順を実行します。

1. IBM Cloud CLI をインストールします。

2. IBM Cloud Logs Routing CLI をインストールします。

3. IBM Cloud にログインします。 次のコマンドを実行します。 ibmcloud login

CLIを使った IBM Cloud Logs ターゲットの作成

IBM Cloud Logs ターゲットを作成するにはこのコマンドを使用する：

 ibmcloud logs-router target create --name TARGET_NAME  --destination-crn CLOUD_LOGS_TARGET_CRN [--region REGION] [--managed-by MANAGED-BY] [--output FORMAT]

説明

--region REGION | -r REGION

リージョンの名前 (us-south や eu-gb など)。 指定しないと、ログインしたリージョン、またはターゲットのリージョンが使用されます。

接続されている地域とは別の地域にターゲットを作成したい場合は、このフィールドを含める。

最大文字数は1000文字です。 最小文字数は3文字です。

--name TARGET_NAME

ターゲットに付ける名前。

名前は1000文字以内で、(スペース)、 -、 .、 _、 : 以外の特殊文字を含めることはできません。

最大文字数は1000文字です。 最小長は1文字です。

リソース名に個人識別情報 (PII) を含めないでください。

--destination-crn CLOUD_LOGS_TARGET_CRN

IBM Cloud Logs インスタンスの CRN。

最大文字数は1000文字です。 最小文字数は3文字です。

--managed-by MANAGED-BY

このターゲットの管理者を特定する。

enterprise に設定すると、ターゲットはエンタープライズ管理され、エンタープライズアクションを許可された ID によってのみ変更できるようになります。

省略または account に設定された場合、ターゲットはアカウント管理される。

この値は作成後も不変である。

有効な値は enterprise account。

--output FORMAT

現在サポートされている形式は JSON です。 指定すると、出力が JSON 形式で返されます。 JSON を指定しない場合は、出力が表形式で返されます。

help | --help | -h

コマンドで使用できるオプションがリストされます。

Id                6f9137b3-2bb9-4724-851b-153e23c82d80
Name              my-target
Destination Crn   crn:v1:bluemix:public:logs:au-syd:a/xxxxxxxxxx:619801ea-7cd8-4792-80cf-49a8359b4357::
Target Type       cloud_logs
Region            eu-gb
Write Status
                  status   success

Created At        2026-04-28T21:33:18.632Z
Updated At        2026-04-28T21:33:18.632Z
Managed By        account

CLI を使用した IBM Cloud Logs ターゲットの更新

IBM Cloud Logs Routing リージョンの IBM Cloud Logs ターゲットを更新するには、このコマンドを使う。

ターゲットが最初に作成された時の値とは異なる値をコマンドで指定すると、その値がコマンドの指定値に更新されます。

ibmcloud logs-router target update --id TARGET [--name TARGET_NAME] --destination-crn CLOUD_LOGS_TARGET_CRN]]] [--output FORMAT]

ここで

--id TARGET

ターゲットを一意に識別する4つのUUID。

最大文字数は1028文字。 最小文字数は24文字です。

--name TARGET_NAME

ターゲットに付ける名前。

名前は1000文字以内で、(スペース)、 -、 .、 _、 :' 以外の特殊文字を含めることはできません。

最大文字数は1000文字です。 最小長は1文字です。

リソース名に個人識別情報 (PII) を含めないでください。

--destination-crn CLOUD_LOGS_TARGET_CRN

IBM Cloud Logs インスタンスの CRN。

--output FORMAT

現在サポートされている形式は JSON です。 指定すると、出力が JSON 形式で返されます。 JSON を指定しない場合は、出力が表形式で返されます。

help | --help | -h

コマンドで使用できるオプションがリストされます。

Id                6f9137b3-2bb9-4724-851b-153e23c82d80
Name              cl-platform-logs-sydney-113
Destination Crn   crn:v1:bluemix:public:logs:au-syd:a/xxxxxxxxxx:619801ea-7cd8-4792-80cf-49a8359b4357::
Target Type       cloud_logs
Region            eu-gb
Write Status
                  status   success

Created At        2026-04-28T21:33:18.632Z
Updated At        2026-04-28T21:35:22.184Z
Managed By        account

CLI を使用したターゲットの削除

このコマンドは、ターゲットを削除するために使用します。

ibmcloud logs-router target delete --id TARGET [--force]

ここで

--id TARGET

ターゲットを一意に識別する4つのUUID。

最大文字数は1028文字。 最小文字数は24文字です。

--force | -f

ユーザーに追加のプロンプトを出さずにターゲットを削除します。

help | --help | -h

コマンドで使用できるオプションがリストされます。

Are you sure you want to remove the target with target ID xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx? [y/N]>y
OK
Target with target ID xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx was successfully removed.

Are you sure you want to remove the Target bearing Target ID 33333333-3333-3333-3333-333333333333? [y/N]> y
FAILED
Something went wrong. Error:
 Status Code:  404
 Incident ID:  67a33257-d5a4-46ec-94d9-14eb70e94f3d
 Code:         not_found
 Message:      The target id specified in `target_id` field is not found.

CLIを使用したターゲットの検証と詳細表示

このコマンドを使用して、IBM Cloud Logs Routing リージョンのターゲットに関する情報を取得します。

ibmcloud logs-router target get --id TARGET [--output FORMAT]

説明

--id TARGET

ターゲットを一意に識別する4つのUUID。

最大文字数は1028文字。 最小文字数は24文字です。

--output FORMAT

現在サポートされている形式は JSON です。 指定すると、出力が JSON 形式で返されます。 JSON を指定しない場合は、出力が表形式で返されます。

help | --help | -h

コマンドで使用できるオプションがリストされます。

レスポンスには、 write_status レスポンスオブジェクトにターゲットのステータスに関する情報が含まれる。 このオブジェクトには以下の情報が含まれる：

• Write Status 情報を提供する。 有効な値は success または failed。
• Last Failure 最後の失敗のタイムスタンプの日時情報。
• Reason for last failure の情報を、故障の原因について詳しく説明する。

Target
Name:                       new-target-name
ID:                         xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
CRN:                        crn:v1:bluemix:public:atracker:us-south:a/xxxxxxxxxx
Type:                       cloud_logs
Cloud Logs Target CRN:      crn:v1:bluemix:public:logs:global:a/xxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx:
Service to Service Enabled: true
Write Status:               success
Created:                    2024-06-02T16:04:15.174Z
Updated:                    2024-06-05T17:49:56.452Z

リージョン内のすべてのターゲットのリスト

このコマンドを使用して、IBM Cloud Logs Routing リージョンの構成済みターゲットを表示します。

ibmcloud logs-router target list [--output FORMAT]

説明

--output FORMAT

現在サポートされている形式は JSON です。 指定すると、出力が JSON 形式で返されます。 JSON を指定しない場合は、出力が表形式で返されます。

help | --help | -h

コマンドで使用できるオプションがリストされます。

Name                       ID                                     Region     Type                Created
target-01                  xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx   us-south   cloud_logs          2020-11-18T03:52:08.603Z

API のターゲットとアクション

次の表は、ターゲットを管理するために実行できるアクションのリストです。

プライベート・エンドポイントとパブリック・エンドポイントを使用してターゲットを管理することができます。 使用可能な ENDPOINTS のリストについて詳しくは、エンドポイントを参照してください。

• https://private.REGION.logs-router.cloud.ibm.comという形式の API エンドポイントを使用して、プライベート・ネットワークからターゲットを管理できます。

• https://REGION.logs-router.cloud.ibm.comという形式の API エンドポイントを使用して、パブリック・ネットワークからターゲットを管理できます。

• アカウント設定を更新することで、パブリック・エンドポイントを無効にすることができます。 詳しくは、ターゲットとリージョンの設定の構成を参照してください。

REST API の詳細については、 IBM Cloud Logs Routing REST API v3 を参照してください。

API の前提条件

ターゲットを管理するための API 呼び出しを行うには、以下のステップを実行します。

1. IAM アクセス・トークンを取得します。 詳しくは、IAM アクセス・トークンの取得を参照してください。
2. ターゲットを構成または管理する予定のリージョン内の API エンドポイントを特定します。 詳しくは、エンドポイントを参照してください。

APIを使用した IBM Cloud Logs ターゲットの作成

ターゲットを作成して、プラットフォームログをルーティングできる宛先を設定することができます。

• すべてのリージョンからのプラットフォームログを、単一のターゲット、異なるターゲット、または複数のターゲットに送信することができます。
• アカウントごとに最大16のターゲットを定義できる。
• managed by パラメータを enterprise に設定すると、企業レベルでターゲットを管理できます。 この値は不変であり、ターゲット作成後に変更することはできない。

以下の cURL コマンドを使って、 IBM Cloud Logs ターゲットを作成することができる：

curl -X POST  <ENDPOINT>/v3/targets   -H "Authorization:  $ACCESS_TOKEN"   -H "content-type: application/json"   -d '{
    "name": "TARGET_NAME",
    "destination_crn": "CLOUD_LOGS_CRN",
    "region": "eu-gb",
    "managed_by": "account"
  }'

説明

<ENDPOINT>

Endpointは、ターゲットを設定または管理する予定の地域のAPIエンドポイントです。 詳しくは、エンドポイントを参照してください。

TARGET_NAME

ターゲットに付ける名前。

名前は1000文字以内で、(スペース)、 -、 .、 _、 : 以外の特殊文字を含めることはできません。

最大文字数は1000文字です。 最小長は1文字です。

リソース名に個人識別情報 (PII) を含めないでください。

CLOUD_LOGS_TARGET_CRN

IBM Cloud Logs インスタンスの CRN。

最大文字数は1000文字です。 最小文字数は3文字です。

REGION

リージョンの名前 (us-south や eu-gb など)。 指定しないと、ログインしたリージョン、またはターゲットのリージョンが使用されます。

接続されている地域とは別の地域にターゲットを作成したい場合は、地域を含める。

最大文字数は1000文字です。 最小文字数は3文字です。

MANAGED-BY

このターゲットの管理者を特定する。

enterprise に設定すると、ターゲットはエンタープライズ管理され、エンタープライズアクションを許可された ID によってのみ変更できるようになります。

省略または account に設定された場合、ターゲットはアカウント管理される。

この値は作成後も不変である。

有効な値は enterprise account。

例えば、次の cURL 要求を使用して、ダラスにターゲットを作成できます。

curl -X POST   https://api.us-south.logs-router.cloud.ibm.com/v3/targets   -H "Authorization: $ACCESS_TOKEN"   -H "content-type: application/json"   -d '{
    "name": "a-cloud-logs-target-us-south",
    "destination_crn": "crn:v1:bluemix:public:logs:us-south:a/0be5ad401ae913d8ff665d92680664ed:22222222-2222-2222-2222-222222222222::"
  }'

応答では、ターゲットの GUID を示す id やターゲットの CRN を示す crn など、ターゲットに関する情報が得られます。

API を使用した IBM Cloud Logs ターゲットの更新

IBM Cloud Logs ターゲットを更新する場合、リクエストのデータセクションにターゲット情報を含める必要があります。

• すべてのフィールドを渡す必要があります。
• 変更する必要があるフィールドを更新します。

以下の cURL コマンドを使用して、ターゲットを更新できます。

curl -X PATCH  <ENDPOINT>/v3/targets/TARGET_ID  -H "Authorization:  $ACCESS_TOKEN"   -H "content-type: application/json"   -d '{
    "name": "TARGET_NAME",
    "destination_crn": "CLOUD_LOGS_CRN"
  }'

説明

<ENDPOINT>

Endpointは、ターゲットを設定または管理する予定の地域のAPIエンドポイントです。 詳しくは、エンドポイントを参照してください。

TARGET_ID

ターゲットを一意に識別する v4 UUID。

TARGET_NAME

ターゲットに付ける名前。

名前は1000文字以内で、(スペース)、 -、 .、 _、 : 以外の特殊文字を含めることはできません。

最大文字数は1000文字です。 最小長は1文字です。

リソース名に個人識別情報 (PII) を含めないでください。

CLOUD_LOGS_TARGET_CRN

IBM Cloud Logs インスタンスの CRN。

最大文字数は1000文字です。 最小文字数は3文字です。

例えば、以下の cURL 要求を使用して、ダラスのターゲットを更新できます。

curl -X PATCH   https://api.us-south.logs-router.cloud.ibm.com/v3/targets/TARGET_ID   -H "Authorization: $ACCESS_TOKEN"   -H "content-type: application/json"   -d '{
    "name": "a-cloud-logs-target-modified",
    "destination_crn": "crn:v1:bluemix:public:logs:us-south:a/0be5ad401ae913d8ff665d92680664ed:33333333-3333-3333-3333-333333333333::"
  }'

API を使用したターゲットの削除

以下の cURL コマンドを使用して、ターゲットを削除できます。

curl -X DELETE <ENDPOINT>/v3/targets/<TARGET_ID> -H "Authorization:  $ACCESS_TOKEN" -H "content-type: application/json"

説明

• <ENDPOINT>は、ターゲットを構成または管理する予定の地域の API エンドポイントです。 詳しくは、エンドポイントを参照してください。
• <TARGET_ID> は、ターゲットを一意に識別する v4 UUIDである。

例えば、以下の cURL 要求を使用して、00000000-0000-0000-0000-000000000000という ID を持つ米国南部のターゲットを削除できます。

curl -X DELETE https://api.us-south.logs-router.cloud.ibm.com/v3/targets/00000000-0000-0000-0000-000000000000 -H "Authorization: Bearer <IAM_TOKEN> -H "content-type: application/json""

削除が成功した場合、応答で空の結果が返されます。

{}

APIを使用したターゲットの検証と詳細の表示

次の cURL コマンドを使用して、1 つのターゲットの構成の詳細を表示することができます。

curl -X GET <ENDPOINT>/v3/targets/<TARGET_ID> -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"

説明

• <ENDPOINT>は、ターゲットを構成または管理する予定の地域の API エンドポイントです。 詳しくは、エンドポイントを参照してください。
• <TARGET_ID> は、ターゲットを一意に識別する v4 UUIDである。

レスポンスには、 write_status レスポンスオブジェクトにターゲットのステータスに関する情報が含まれる。 このオブジェクトには以下の情報が含まれる：

• status 情報を提供する。 有効な値は success または failed。
• last_failure 最後の失敗のタイムスタンプの日時情報。
• reason_for_last_failure の情報を、故障の原因について詳しく説明する。

例えば、以下の cURL 要求を実行して、ID 00000000-0000-0000-0000-000000000000のターゲットに関する情報を取得できます。

curl -X GET https://api.us-south.logs-router.cloud.ibm.com/v3/targets/00000000-0000-0000-0000-000000000000 -H "Authorization: Bearer <IAM_TOKEN> -H "content-type: application/json""

返答は次のようになる：

{
  "name": "cloud-logs-target",
  "id": "00000000-0000-0000-0000-000000000000",
  "crn": "crn:v1:bluemix:public:logs-router:us-south:a/4329073d16d2f3663f74bfa955259139::target:00000000-0000-0000-0000-000000000000",
  "destination_crn": "crn:v1:bluemix:public:logs:us-south:a/0be5ad401ae913d8ff665d92680664ed:22222222-2222-2222-2222-222222222222::",
  "target_type": "cloud_logs",
  "write_status": {
    "status": "success"
  },
  "created_at": "2026-02-01T19:39:38.174Z",
  "updated_at": "2026-02-01T19:39:38.174Z",
  "managed_by": "enterprise"
}

API を使用したすべてのターゲットのリスト表示

次の cURL コマンドを使用して、すべてのターゲットを表示できます。

curl -X GET <ENDPOINT>/v3/targets -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"

説明

• <ENDPOINT>は、ターゲットを構成または管理する予定の地域の API エンドポイントです。 詳しくは、エンドポイントを参照してください。

例えば、以下の cURL 要求を実行して、ダラスで定義されているターゲットに関する情報を取得できます。

curl -X GET https://private.us-south.logs-router.cloud.ibm.com/v3/targets -H "Authorization:  $ACCESS_TOKEN" -H "content-type: application/json"

HTTP 応答コード

IBM Cloud Logs Routing REST API を使用すると、メソッドが正常に完了したかどうかを示す標準 HTTP 応答コードを取得できます。

• 200 応答は、どのような場合でも成功を示しています。
• 4xx 応答は、失敗を示しています。
• 5xx 応答は通常、内部システム・エラーを示しています。

いくつかの HTTP 応答コードについては、以下の表を参照してください。

UIを使用した IBM Cloud Logs ターゲットの作成

あなたのアカウントあるリソースのみがリストアップされ、選択可能です。 別のアカウントリソースを指定するには、[ Choose destination ]で [Specify CRN ]を選択します。

以下の手順でターゲットを作成する：

1. IBM Cloud アカウントログイン.

2. 「メニュー」 アイコン > **「可観測性」**をクリックします。

3. Logging > Routing を選択する。

4. Targets セクションで、 Createをクリックして作成パネルを開く。

5. Choose destination ]で、 [Search by instance] または[ Specify CRN ]を選択します。

   インスタンスで検索を選択し、 アカウント利用可能なテーブルから IBM Cloud Logs インスタンスを選択する

   別のアカウント にあ る イ ン ス タ ン ス の IBM Cloud Logs インスタンス CRN を追加するには、 Specify CRN を選択します。

   IBM Cloud Logs Routing が IBM Cloud Logs と通信するには、サービス認可が必要である。

6. ターゲットの詳細セクションで、以下のタスクを完了する：

   ターゲット名を入力する。

   IBM Cloud Logs Routing の設定で、新しいターゲットをデフォルトターゲットとして自動的に設定するには、 Not set からトグルを有効にします。

7. Create targetをクリックする。

UIを使用した IBM Cloud Logs ターゲットの更新

あなたのアカウントあるリソースのみがリストアップされ、選択可能です。 別のアカウントリソースを指定するには、[ Choose destination ]で [Specify CRN ]を選択します。

以下のステップを実行します。

1. IBM Cloud アカウントログイン.
2. 「メニュー」 アイコン > **「可観測性」**をクリックします。
3. Logging > Routing を選択する。
4. Targets セクションで、更新するターゲットを決定し、 Actionsをクリックする。
5. 編集] をクリックして更新パネルを開く。
6. Update］パネルで、［ Edit ］をクリックしてターゲットの名前を更新するか、［CRN］をクリックしてターゲットに関連付けられている IBM Cloud Logs インスタンスを変更するか、またはその両方を行います。 また、 IBM Cloud Logs Routing の設定で、 Default target（デフォルトターゲット）を切り替えて、ターゲットをデフォルトターゲットとして追加または削除することもできます。
7. Saveをクリックしてターゲットを更新します。

UIを使用したターゲットの削除

IBM Cloud Logs Routing ターゲットがルートまたはデフォルトターゲット設定として使用されている場合は、削除できません。

1. IBM Cloud アカウントログイン.
2. 「メニュー」 アイコン > **「可観測性」**をクリックします。
3. Logging > Routing を選択する。
4. Targets セクションで、更新するターゲットを決定し、 Actionsをクリックする。
5. 削除を選択し、確認パネルで削除をクリックします。

UIを使用してリージョン内のすべてのターゲットをリストする

1. IBM Cloud アカウントログイン.
2. 「メニュー」 アイコン > **「可観測性」**をクリックします。
3. Logging > Routing を選択する。

アカウント定義されているターゲットのリストを見ることができます。 目標ごとに以下の情報が含まれる：

• ターゲット名

• ターゲット・タイプ

• 宛先名

• 宛先リージョン

• Routesは、ターゲットがルートで使用されるかどうかを定義する。

• ターゲットのステータス

  • 設定した ：ターゲットは期待通りに動作している。
  • 受信しない ：ターゲットの設定が間違っており、イベントがデスティネーションにルーティングされない。 ターゲットの詳細またはデスティネーションを更新してターゲット設定を修正するか、不要になった場合はターゲットを削除してください。