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-AKTION | Geltungsbereich der IAM-Richtlinie | IAM-Rollen | Beschreibung |
|---|---|---|---|
logs-router.target.read |
Bereich | AdministratorEditorViewerOperator |
Informationen zu einem Ziel lesen (anzeigen) |
logs-router.target.create |
Bereich | AdministratorEditor |
Ziel erstellen |
logs-router.target.update |
Bereich | AdministratorEditor |
Ziel aktualisieren |
logs-router.target.delete |
Bereich | AdministratorEditor |
Ziel löschen |
logs-router.target.list |
Konto | AdministratorEditorViewerOperator |
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:
-
Installieren Sie die IBM Cloud Logs Routing CLI.
-
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-southodereu-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
enterprisewird 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
accountgesetzt, 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
JSONnicht 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
JSONnicht 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
JSONnicht 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 StatusInformationen. Gültige Werte sind:successoderfailed.Last Failuredatums- und Zeitangabe des Zeitstempels des letzten Fehlers.Reason for last failureinformationen 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
JSONnicht 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:
| 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:
- Rufen Sie ein IAM-Zugriffstoken ab. Weitere Informationen finden Sie unter Abrufen von IAM-Zugriffstokens.
- 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 byauf 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-southodereu-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
enterprisewird 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
accountgesetzt, 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:
statusInformationen. Gültige Werte sind:successoderfailed.last_failuredatums- und Zeitangabe des Zeitstempels des letzten Fehlers.reason_for_last_failureinformationen 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:
| 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:
-
Klicken Sie auf das Menüsymbol
> Beobachtbarkeit.
-
Wählen Sie Protokollierung > Routing.
-
Klicken Sie im Abschnitt Ziele auf Erstellen, um das Erstellungsfenster zu öffnen.
-
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.
-
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.
-
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:
- Melden Sie sich bei Ihrem IBM Cloud Konto an.
- Klicken Sie auf das Menüsymbol
> Beobachtbarkeit.
- Wählen Sie Protokollierung > Routing.
- Bestimmen Sie im Abschnitt " Ziele" das zu aktualisierende Ziel und klicken Sie auf das
.
- Klicken Sie auf Bearbeiten, um das Aktualisierungsfeld zu öffnen.
- 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.
- 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.
- Melden Sie sich bei Ihrem IBM Cloud Konto an.
- Klicken Sie auf das Menüsymbol
> Beobachtbarkeit.
- Wählen Sie Protokollierung > Routing.
- Bestimmen Sie im Abschnitt " Ziele" das zu aktualisierende Ziel und klicken Sie auf das
.
- 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
- Melden Sie sich bei Ihrem IBM Cloud Konto an.
- Klicken Sie auf das Menüsymbol
> Beobachtbarkeit.
- 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.