Verwaltung der IBM Cloud Logs Ziele

Sie können IBM Cloud Logs Ziele in Ihrem Konto verwalten, indem Sie die IBM Cloud Logs Routing UI, die IBM Cloud Logs Routing CLI, die IBM Cloud Logs Routing REST API und Terraform-Skripte verwenden. Ein Ziel ist eine Ressource, in der Sie Plattformprotokolle erfassen können.

Weitere Informationen über IBM Cloud Logs Routing Ziele finden Sie unter Ziele.

IAM-Zugriff

Sie müssen Benutzern IAM-Berechtigungen für die Verwaltung von Zielen erteilen. Weitere Informationen finden Sie unter Zugriff auf Ressourcen zuweisen.

Wenn Sie eine Richtlinie definieren, können Sie den Umfang der Berechtigungen angeben. Sie können wählen, ob Sie Berechtigungen für eine bestimmte Region oder für das gesamte Konto erteilen.

Wenn Sie über die IAM-Berechtigung zum Erstellen von Richtlinien und Berechtigungen verfügen, können Sie nur die Zugriffsebene gewähren, die Sie als Benutzer des Zieldienstes haben. Wenn Sie z. B. für den Zieldienst einen Viewer-Zugang haben, können Sie für die Berechtigung nur die Viewer-Rolle zuweisen. Wenn Sie versuchen, eine höhere Berechtigung, wie z. B. Administrator, zuzuweisen, sieht es so aus, als ob die Berechtigung erteilt wird, jedoch wird nur die höchste Berechtigungsstufe, die Sie für den Zieldienst haben, d. h. Viewer, zugewiesen.

Benutzer mit regionalem Geltungsbereich können nur auf Ziele in ihrer autorisierten Region zugreifen.

IAM-Aktionen und die IAM-Rollen, die sie beinhalten.
IAM-AKTION Geltungsbereich der IAM-Richtlinie IAM-Rollen Beschreibung
logs-router.target.read Bereich Administrator
Editor
Viewer
Operator
Informationen zu einem Ziel lesen (anzeigen)
logs-router.target.create Bereich Administrator
Editor
Ziel erstellen
logs-router.target.update Bereich Administrator
Editor
Ziel aktualisieren
logs-router.target.delete Bereich Administrator
Editor
Ziel löschen
logs-router.target.list Konto Administrator
Editor
Viewer
Operator
Alle Ziele auflisten

Authentifizierung

Wenn Sie auf ein IBM Cloud Logs Ziel schreiben, müssen Sie eine Dienst-zu-Dienst ( S2S ) Berechtigung zwischen IBM Cloud Logs Routing und {{site.data.keyword. logs_full_notm}} konfigurieren.

Wählen Sie eine der folgenden Optionen aus:

CLI-Voraussetzungen

Bevor Sie die Befehlszeilenschnittstelle zum Verwalten von Zielen verwenden, führen Sie die folgenden Schritte aus:

  1. Installieren Sie die IBM Cloud-Befehlszeilenschnittstelle.

  2. Installieren Sie die IBM Cloud Logs Routing CLI.

  3. Melden Sie sich bei IBM Cloud an. Führen Sie den folgenden Befehl aus: ibmcloud login

Erstellen eines IBM Cloud Logs Ziels mit der CLI

Verwenden Sie diesen Befehl, um ein IBM Cloud Logs Ziel zu erstellen:

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

Wo

--region REGION | -r REGION

Name der Region, z. B. us-south oder eu-gb. Wenn nicht angegeben, wird die Region verwendet, die protokolliert oder als Ziel verwendet wird.

Fügen Sie dieses Feld ein, wenn Sie ein Ziel in einer anderen Region als der, mit der Sie verbunden sind, erstellen möchten.

Die maximale Länge beträgt 1000 Zeichen. Die Mindestlänge beträgt 3 Zeichen.

--name TARGET_NAME

Der Name, der für das Ziel angegeben werden soll.

Der Name darf höchstens 1000 Zeichen lang sein und darf keine anderen Sonderzeichen als (Leerzeichen), -, ., _, : enthalten.

Die maximale Länge beträgt 1000 Zeichen. Die Mindestlänge beträgt 1 Zeichen.

Schließen Sie keine personenbezogenen Daten in Ressourcennamen ein.

--destination-crn CLOUD_LOGS_TARGET_CRN

Die CRN der IBM Cloud Logs-Instanz.

Die maximale Länge beträgt 1000 Zeichen. Die Mindestlänge beträgt 3 Zeichen.

--managed-by MANAGED-BY

Gibt an, wer dieses Ziel verwaltet.

Bei der Einstellung enterprise wird das Ziel unternehmensverwaltet und kann nur von Identitäten geändert werden, die für die Unternehmensaktionen autorisiert sind.

Wird diese Option ausgelassen oder auf account gesetzt, wird das Ziel vom untergeordneten Konto verwaltet.

Dieser Wert ist nach der Erstellung unveränderlich.

Gültige Werte sind: enterprise, account.

--output FORMAT

Das derzeit unterstützte Format ist JSON. Falls angegeben, wird die Ausgabe im JSON-Format zurückgegeben. Wenn JSON nicht angegeben ist, wird die Ausgabe in einem Tabellenformat zurückgegeben.

help | --help | -h

Hiermit können Sie Optionen auflisten, die für den Befehl verfügbar sind.

Beispiel

Nachfolgend ein Beispiel für die Verwendung des Befehls ibmcloud logs-router target create --name my-target --destination-crn crn:v1:bluemix:public:logs:global:a/xxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx:: --managed-by account.

Dieses Beispiel zeigt ein Beispiel für eine erfolgreiche Zielerstellung.

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

Aktualisieren eines IBM Cloud Logs Ziels mit der CLI

Verwenden Sie diesen Befehl, um ein IBM Cloud Logs Ziel für eine IBM Cloud Logs Routing Region zu aktualisieren.

Jeder angegebene Wert, der sich von dem Zeitpunkt, zu dem das Ziel ursprünglich erstellt wurde, unterscheidet, wird auf den im Befehl angegebenen Wert aktualisiert.

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

wo

--id TARGET

Die 4 UUID, die das Ziel eindeutig identifiziert.

Die maximale Länge beträgt 1028 Zeichen. Die Mindestlänge beträgt 24 Zeichen.

--name TARGET_NAME

Der Name, der für das Ziel angegeben werden soll.

Der Name darf höchstens 1000 Zeichen lang sein und darf keine anderen Sonderzeichen als (Leerzeichen), -, ., _, :' enthalten.

Die maximale Länge beträgt 1000 Zeichen. Die Mindestlänge beträgt 1 Zeichen.

Schließen Sie keine personenbezogenen Daten in Ressourcennamen ein.

--destination-crn CLOUD_LOGS_TARGET_CRN

Die CRN der IBM Cloud Logs-Instanz.

--output FORMAT

Das derzeit unterstützte Format ist JSON. Falls angegeben, wird die Ausgabe im JSON-Format zurückgegeben. Wenn JSON nicht angegeben ist, wird die Ausgabe in einem Tabellenformat zurückgegeben.

help | --help | -h

Hiermit können Sie Optionen auflisten, die für den Befehl verfügbar sind.

Beispiel

Nachfolgend ein Beispiel für die Verwendung des Befehls ibmcloud logs-router target update --id 6f9137b3-2bb9-4724-851b-153e23c82d80 --name cl-platform-logs-sydney-113.

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

Ziel über die Befehlszeilenschnittstelle löschen

Verwenden Sie diesen Befehl, um ein Ziel zu löschen.

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

wo

--id TARGET

Die 4 UUID, die das Ziel eindeutig identifiziert.

Die maximale Länge beträgt 1028 Zeichen. Die Mindestlänge beträgt 24 Zeichen.

--force | -f

Das Ziel wird gelöscht, ohne dass dem Benutzer eine zusätzliche Eingabeaufforderung zur Verfügung gestellt wird.

help | --help | -h

Hiermit können Sie Optionen auflisten, die für den Befehl verfügbar sind.

Beispiel

Nachfolgend ein Beispiel für die Verwendung des Befehls ibmcloud logs-router target delete --id xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

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.

Nachfolgend ein Beispiel für die Verwendung des Befehls ibmcloud logs-router target delete --id xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -force.

Dieses Beispiel zeigt einen fehlgeschlagenen Befehl, bei dem das angegebene Ziel nicht gefunden werden konnte.

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.

Validierung und Anzeige von Details eines Ziels mit Hilfe der CLI

Verwenden Sie diesen Befehl, um Informationen zu einem Ziel für eine IBM Cloud Logs Routing-Region abzurufen.

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

Wo

--id TARGET

Die 4 UUID, die das Ziel eindeutig identifiziert.

Die maximale Länge beträgt 1028 Zeichen. Die Mindestlänge beträgt 24 Zeichen.

--output FORMAT

Das derzeit unterstützte Format ist JSON. Falls angegeben, wird die Ausgabe im JSON-Format zurückgegeben. Wenn JSON nicht angegeben ist, wird die Ausgabe in einem Tabellenformat zurückgegeben.

help | --help | -h

Hiermit können Sie Optionen auflisten, die für den Befehl verfügbar sind.

Die Antwort enthält Informationen über den Status des Ziels in dem Antwortobjekt write_status. Dieses Objekt enthält die folgenden Informationen:

  • Write Status Informationen. Gültige Werte sind: success oder failed.
  • Last Failure datums- und Zeitangabe des Zeitstempels des letzten Fehlers.
  • Reason for last failure informationen mit einer detaillierten Beschreibung der Fehlerursache.

Beispiel

Nachfolgend ein Beispiel mit dem Befehl ibmcloud logs-router target get --id new-target-name, das ein Ziel IBM Cloud Logs zeigt.

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

Alle Ziele in einer Region auflisten

Verwenden Sie diesen Befehl, um die konfigurierten Ziele für eine IBM Cloud Logs Routing-Region aufzulisten.

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

Wo

--output FORMAT
Das derzeit unterstützte Format ist JSON. Falls angegeben, wird die Ausgabe im JSON-Format zurückgegeben. Wenn JSON nicht angegeben ist, wird die Ausgabe in einem Tabellenformat zurückgegeben.
help | --help | -h
Hiermit können Sie Optionen auflisten, die für den Befehl verfügbar sind.

Beispiel

Im Folgenden sehen Sie ein Beispiel für die Verwendung des Befehls ibmcloud logs-router target list.

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

API-Ziele und -Aktionen

In der folgenden Tabelle sind die Aktionen aufgelistet, die Sie ausführen können, um Ziele zu verwalten:

Gezielte Aktionen über die IBM Cloud Logs Routing REST API
Aktion REST-API-Methode API_URL
Ziel erstellen POST <ENDPOINT>/v3/targets
Ziel aktualisieren PATCH <ENDPOINT>/v3/targets/<TARGET_ID>
Ziel löschen DELETE <ENDPOINT>/v3/targets/<TARGET_ID>
Ziel lesen GET <ENDPOINT>/v3/targets/<TARGET_ID>
Alle Ziele auflisten GET <ENDPOINT>/v3/targets
Ziel validieren GET <ENDPOINT>/v3/targets

Sie können private und öffentliche Endpunkte verwenden, um Ziele zu verwalten. Weitere Informationen zu der Liste der verfügbaren ENDPOINTS finden Sie unter Endpunkte.

  • Sie können Ziele aus dem privaten Netz mithilfe eines API-Endpunkts im folgenden Format verwalten: https://private.REGION.logs-router.cloud.ibm.com

  • Sie können Ziele über das öffentliche Netz mithilfe eines API-Endpunkts im folgenden Format verwalten: https://REGION.logs-router.cloud.ibm.com

  • Sie können die öffentlichen Endpunkte inaktivieren, indem Sie die Kontoeinstellungen aktualisieren. Weitere Informationen finden Sie unter Ziel- und Regionseinstellungen konfigurieren.

Weitere Informationen über die REST-API finden Sie unter IBM Cloud Logs Routing REST API v3.

API-Voraussetzungen

Führen Sie die folgenden Schritte aus, um API-Aufrufe zum Verwalten von Zielen zu erstellen:

  1. Rufen Sie ein IAM-Zugriffstoken ab. Weitere Informationen finden Sie unter Abrufen von IAM-Zugriffstokens.
  2. Ermitteln Sie den API-Endpunkt in der Region, in der Sie ein Ziel konfigurieren oder verwalten möchten. Weitere Informationen finden Sie unter Endpunkte.

Erstellen eines IBM Cloud Logs Ziels mithilfe der API

Sie können ein Ziel erstellen, um ein Ziel zu konfigurieren, an das Sie Plattformprotokolle weiterleiten können.

  • Sie können Ihre Plattformprotokolle aus allen Regionen an ein einziges Ziel, verschiedene Ziele oder mehrere Ziele senden.
  • Sie können bis zu 16 Ziele pro Konto definieren.
  • Sie können Ziele auf Unternehmensebene verwalten, indem Sie den Parameter managed by auf Unternehmen setzen. Dieser Wert ist unveränderlich und kann nach der Erstellung des Ziels nicht mehr geändert werden.

Sie können den folgenden cURL Befehl verwenden, um ein IBM Cloud Logs Ziel zu erstellen:

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"
  }'

Wo

<ENDPOINT>

Endpunkt ist der API-Endpunkt in der Region, in der Sie ein Ziel konfigurieren oder verwalten möchten. Weitere Informationen finden Sie unter Endpunkte.

TARGET_NAME

Der Name, der für das Ziel angegeben werden soll.

Der Name darf höchstens 1000 Zeichen lang sein und darf keine anderen Sonderzeichen als (Leerzeichen), -, ., _, : enthalten.

Die maximale Länge beträgt 1000 Zeichen. Die Mindestlänge beträgt 1 Zeichen.

Schließen Sie keine personenbezogenen Daten in Ressourcennamen ein.

CLOUD_LOGS_TARGET_CRN

Die CRN der IBM Cloud Logs-Instanz.

Die maximale Länge beträgt 1000 Zeichen. Die Mindestlänge beträgt 3 Zeichen.

REGION

Name der Region, z. B. us-south oder eu-gb. Wenn nicht angegeben, wird die Region verwendet, die protokolliert oder als Ziel verwendet wird.

Region einbeziehen, wenn Sie ein Ziel in einer anderen Region als der, mit der Sie verbunden sind, erstellen möchten.

Die maximale Länge beträgt 1000 Zeichen. Die Mindestlänge beträgt 3 Zeichen.

MANAGED-BY

Gibt an, wer dieses Ziel verwaltet.

Bei der Einstellung enterprise wird das Ziel unternehmensverwaltet und kann nur von Identitäten geändert werden, die für die Unternehmensaktionen autorisiert sind.

Wird diese Option ausgelassen oder auf account gesetzt, wird das Ziel vom untergeordneten Konto verwaltet.

Dieser Wert ist nach der Erstellung unveränderlich.

Gültige Werte sind: enterprise, account.

Sie können zum Beispiel die folgende cURL-Anforderung verwenden, um ein Ziel in Dallas zu erstellen:

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::"
  }'

In der Antwort erhalten Sie Informationen zu dem Ziel, wie z. B. id, das die GUID des Ziels angibt, und crn, das die CRN des Ziels angibt.

Aktualisieren eines IBM Cloud Logs Ziels mit der API

Wenn Sie ein IBM Cloud Logs Ziel aktualisieren, müssen Sie die Zielinformationen in den Datenteil der Anfrage aufnehmen.

  • Sie müssen alle Felder übergeben.
  • Aktualisieren Sie die Felder, die geändert werden müssen.

Mit dem folgenden cURL-Befehl können Sie ein Ziel aktualisieren:

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"
  }'

Wo

<ENDPOINT>

Endpunkt ist der API-Endpunkt in der Region, in der Sie ein Ziel konfigurieren oder verwalten möchten. Weitere Informationen finden Sie unter Endpunkte.

TARGET_ID

Die v4 UUID, die das Ziel eindeutig identifiziert.

TARGET_NAME

Der Name, der für das Ziel angegeben werden soll.

Der Name darf höchstens 1000 Zeichen lang sein und darf keine anderen Sonderzeichen als (Leerzeichen), -, ., _, : enthalten.

Die maximale Länge beträgt 1000 Zeichen. Die Mindestlänge beträgt 1 Zeichen.

Schließen Sie keine personenbezogenen Daten in Ressourcennamen ein.

CLOUD_LOGS_TARGET_CRN

Die CRN der IBM Cloud Logs-Instanz.

Die maximale Länge beträgt 1000 Zeichen. Die Mindestlänge beträgt 3 Zeichen.

Sie können beispielsweise die folgende cURL-Anforderung verwenden, um ein Ziel in der Region 'Dallas' zu aktualisieren:

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::"
  }'

Ziel mit der API löschen

Mit dem folgenden cURL-Befehl können Sie ein Ziel löschen:

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

Wo

  • <ENDPOINT> ist der API-Endpunkt in der Region, in der Sie ein Ziel konfigurieren oder verwalten wollen. Weitere Informationen finden Sie unter Endpunkte.
  • <TARGET_ID> ist die v4 UUID, die das Ziel eindeutig identifiziert.

Sie können beispielsweise die folgende cURL-Anforderung verwenden, um ein Ziel in der Region 'USA (Süden)' mit der ID 00000000-0000-0000-0000-000000000000 zu löschen:

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""

Wenn der Löschvorgang erfolgreich war, wird als Antwort ein leeres Ergebnis zurückgegeben:

{}

Validierung und Anzeige von Details eines Ziels mit Hilfe der API

Sie können den folgenden cURL-Befehl verwenden, um die Konfigurationsdetails von 1 Ziel anzuzeigen:

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

Wo

  • <ENDPOINT> ist der API-Endpunkt in der Region, in der Sie ein Ziel konfigurieren oder verwalten wollen. Weitere Informationen finden Sie unter Endpunkte.
  • <TARGET_ID> ist die v4 UUID, die das Ziel eindeutig identifiziert.

Die Antwort enthält Informationen über den Status des Ziels in dem Antwortobjekt write_status. Dieses Objekt enthält die folgenden Informationen:

  • status Informationen. Gültige Werte sind: success oder failed.
  • last_failure datums- und Zeitangabe des Zeitstempels des letzten Fehlers.
  • reason_for_last_failure informationen mit einer detaillierten Beschreibung der Fehlerursache.

Sie können beispielsweise die folgende cURL-Anfrage ausführen, um Informationen über ein Ziel mit der ID 00000000-0000-0000-0000-000000000000 abzurufen:

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""

Die Antwort sieht wie folgt aus:

{
  "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"
}

Alle Ziele über die API auflisten

Sie können den folgenden cURL-Befehl verwenden, um alle Ziele anzuzeigen:

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

Wo

  • <ENDPOINT> ist der API-Endpunkt in der Region, in der Sie ein Ziel konfigurieren oder verwalten wollen. Weitere Informationen finden Sie unter Endpunkte.

Sie können beispielsweise die folgende cURL-Anforderung ausführen, um Informationen zu den in der Region 'Dallas' definierten Zielen abzurufen:

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

HTTP-Antwortcodes

Wenn Sie die IBM Cloud Logs Routing REST-API verwenden, können Sie Standard-HTTP-Antwortcodes abrufen, um anzugeben, ob eine Methode erfolgreich abgeschlossen wurde.

  • Eine Antwort von 200 zeigt immer Erfolg an.
  • Eine 4xx-Antwort weist auf einen Fehler hin.
  • Eine 5xx-Antwort weist normalerweise auf einen internen Systemfehler hin.

In der folgenden Tabelle finden Sie einige HTTP-Antwortcodes:

Liste der Antwortcodes HTTP
Statuscode Status Beschreibung
200 OK Eine Liste von Zielen wurde erfolgreich abgerufen.
201 OK Die Anforderung war erfolgreich. Eine Ressource wird erstellt.
400 Ungültige Anforderung Die Anforderung war nicht erfolgreich. Möglicherweise fehlt ein Parameter, der erforderlich ist.
401 Nicht berechtigt Das IAM-Token, das in der API-Anforderung verwendet wird, ist ungültig oder abgelaufen.
403 Nicht zulässig Die Operation ist aufgrund unzureichender Berechtigungen nicht zulässig.
404 Nicht gefunden Die angeforderte Ressource ist nicht vorhanden oder wurde bereits gelöscht.
409 Konflikt Es besteht ein Konflikt mit den Anfragedaten und dem Zustand der Ressourcen im System.
429 Zu viele Anforderungen Zu viele Anforderungen haben die API zu schnell getroffen.
500 Interner Serverfehler Ein Fehler ist aufgetreten. Ihre Anforderung konnte nicht verarbeitet werden. Versuchen Sie es zu einem späteren Zeitpunkt erneut. Wenn das Problem weiterhin besteht, notieren Sie die Transaktions-ID in der Kopfzeile der Antwort und wenden Sie sich an den Support von IBM Cloud.

Erstellen eines IBM Cloud Logs Ziels über die Benutzeroberfläche

Nur die Ressourcen in Ihrem Konto werden aufgelistet und können ausgewählt werden. Um eine Ressource in einem anderen Konto anzugeben, wählen Sie CRN angeben unter Ziel wählen.

Führen Sie die folgenden Schritte aus, um ein Ziel zu erstellen:

  1. Melden Sie sich bei Ihrem IBM Cloud Konto an.

  2. Klicken Sie auf das Menüsymbol Menüsymbol > Beobachtbarkeit.

  3. Wählen Sie Protokollierung > Routing.

  4. Klicken Sie im Abschnitt Ziele auf Erstellen, um das Erstellungsfenster zu öffnen.

  5. Wählen Sie im Feld Ziel auswählen die Option Nach Instanz suchen oder CRN angeben.

    Wählen Sie Suche nach Instanz, um eine IBM Cloud Logs Instanz aus der Tabelle auszuwählen, die im Konto verfügbar ist

    Wählen Sie CRN angeben, um die IBM Cloud Logs Instanz-CRN einer Instanz hinzuzufügen, die sich in einem anderen Konto befindet.

    Eine Dienstberechtigung ist erforderlich, damit IBM Cloud Logs Routing mit IBM Cloud Logs kommunizieren kann.

  6. Führen Sie im Abschnitt Zieldetails die folgenden Aufgaben aus:

    Geben Sie den Zielnamen ein.

    Aktivieren Sie die Umschaltfunktion von Nicht festgelegt, um Ihr neues Ziel automatisch als Standardziel in Ihren IBM Cloud Logs Routing Einstellungen festzulegen.

  7. Klicken Sie auf Ziel erstellen.

Aktualisieren eines IBM Cloud Logs Ziels mit der Benutzeroberfläche

Nur die Ressourcen in Ihrem Konto werden aufgelistet und können ausgewählt werden. Um eine Ressource in einem anderen Konto anzugeben, wählen Sie CRN angeben unter Ziel wählen.

Führen Sie die folgenden Schritte aus:

  1. Melden Sie sich bei Ihrem IBM Cloud Konto an.
  2. Klicken Sie auf das Menüsymbol Menüsymbol > Beobachtbarkeit.
  3. Wählen Sie Protokollierung > Routing.
  4. Bestimmen Sie im Abschnitt " Ziele" das zu aktualisierende Ziel und klicken Sie auf das Symbol "Aktionen".
  5. Klicken Sie auf Bearbeiten, um das Aktualisierungsfeld zu öffnen.
  6. Klicken Sie im Bereich "Aktualisieren" auf " Bearbeiten", um den Namen Ihres Ziels zu aktualisieren, auf "CRN", um die mit Ihrem Ziel verbundene Instanz IBM Cloud Logs zu ändern, oder auf beides. Sie können auch die Option Standardziel aktivieren, um Ihr Ziel als Standardziel in den Einstellungen von IBM Cloud Logs Routing hinzuzufügen oder zu entfernen.
  7. Klicken Sie auf Speichern, um Ihr Ziel zu aktualisieren.

Löschen eines Ziels über die Benutzeroberfläche

Sie können ein IBM Cloud Logs Routing-Ziel nicht löschen, wenn es in einer Route oder als Standardziel verwendet wird.

  1. Melden Sie sich bei Ihrem IBM Cloud Konto an.
  2. Klicken Sie auf das Menüsymbol Menüsymbol > Beobachtbarkeit.
  3. Wählen Sie Protokollierung > Routing.
  4. Bestimmen Sie im Abschnitt " Ziele" das zu aktualisierende Ziel und klicken Sie auf das Symbol "Aktionen".
  5. Wählen Sie Löschen und klicken Sie dann im Bestätigungsfenster auf Löschen.

Auflistung aller Ziele in einer Region über die Benutzeroberfläche

  1. Melden Sie sich bei Ihrem IBM Cloud Konto an.
  2. Klicken Sie auf das Menüsymbol Menüsymbol > Beobachtbarkeit.
  3. Wählen Sie Protokollierung > Routing.

Sie können die Liste der im Konto definierten Ziele sehen. Die folgenden Informationen sind pro Ziel enthalten:

  • Zielname

  • Zieltyp

  • Zielname

  • Zielregion

  • Routen legen fest, ob das Ziel in irgendwelchen Routen verwendet wird.

  • Zielstatus:

    • Konfiguriert: Das Ziel funktioniert wie erwartet.
    • Nicht empfangen: Das Ziel ist falsch konfiguriert und die Ereignisse werden nicht an das Ziel weitergeleitet. Aktualisieren Sie Ihre Zieldetails oder Ihr Ziel, um die Zielkonfiguration zu korrigieren, oder löschen Sie das Ziel, wenn es nicht mehr benötigt wird.