Prerequisiti CLI

Prima di utilizzare la CLI per gestire i target, completare i seguenti passaggi:

1. Installa la CLI IBM Cloud.

2. Installa la CLI IBM Cloud Logs Routing.

3. Accedi a IBM Cloud. Esegui il seguente comando: ibmcloud login

Creare un target IBM Cloud Logs utilizzando la CLI

Usare questo comando per creare una destinazione 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]

Dove

--region REGION | -r REGION

Nome della regione, ad esempio us-south o eu-gb. Se non viene specificato, verrà utilizzata la regione in cui si è effettuato l'accesso o in cui si è puntato.

Includere questo campo se si desidera creare un target in una regione diversa da quella a cui si è collegati.

La lunghezza massima è di 1000 caratteri. La lunghezza minima è di 3 caratteri.

--name TARGET_NAME

Il nome da assegnare alla destinazione.

Il nome deve essere al massimo di 1000 caratteri e non può includere caratteri speciali diversi da (spazio), -, ., _, :.

La lunghezza massima è di 1000 caratteri. La lunghezza minima è di 1 carattere.

Non includere informazioni di identificazione personale (PII) nei nomi delle risorse.

--destination-crn CLOUD_LOGS_TARGET_CRN

Il CRN dell'istanza IBM Cloud Logs.

La lunghezza massima è di 1000 caratteri. La lunghezza minima è di 3 caratteri.

--managed-by MANAGED-BY

Identifica chi gestisce questo obiettivo.

Se impostato su enterprise, la destinazione diventa gestita dall'azienda e può essere modificata solo dalle identità autorizzate alle azioni aziendali.

Se omesso o impostato su account, la destinazione è gestita dall'account figlio.

Questo valore è immutabile dopo la creazione.

I valori validi sono: enterprise, account.

--output FORMAT

Il formato attualmente supportato è JSON. Se specificato, l'output sarà restituito in formato JSON. Se JSON non viene specificato, l'output verrà restituito in formato tabellare.

help | --help | -h

Elenca le opzioni disponibili per il comando.

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

Aggiornamento di un target IBM Cloud Logs tramite la CLI

Utilizzare questo comando per aggiornare un target IBM Cloud Logs per una regione IBM Cloud Logs Routing.

Qualsiasi valore specificato che sia diverso da quando la destinazione è stata originariamente creata verrà aggiornato al valore specificato nel comando.

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

dove

--id TARGET

Il 4 UUID che identifica in modo univoco la destinazione.

La lunghezza massima è di 1028 caratteri. La lunghezza minima è di 24 caratteri.

--name TARGET_NAME

Il nome da assegnare alla destinazione.

Il nome deve essere al massimo di 1000 caratteri e non può includere caratteri speciali diversi da (spazio), -, ., _, :'.

La lunghezza massima è di 1000 caratteri. La lunghezza minima è di 1 carattere.

Non includere informazioni di identificazione personale (PII) nei nomi delle risorse.

--destination-crn CLOUD_LOGS_TARGET_CRN

Il CRN dell'istanza IBM Cloud Logs.

--output FORMAT

Il formato attualmente supportato è JSON. Se specificato, l'output sarà restituito in formato JSON. Se JSON non viene specificato, l'output verrà restituito in formato tabellare.

help | --help | -h

Elenca le opzioni disponibili per il comando.

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

Eliminazione di un target tramite la CLI

Utilizzare questo comando per eliminare un target.

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

dove

--id TARGET

Il 4 UUID che identifica in modo univoco la destinazione.

La lunghezza massima è di 1028 caratteri. La lunghezza minima è di 24 caratteri.

--force | -f

Eliminerà la destinazione senza fornire all'utente alcuna richiesta aggiuntiva.

help | --help | -h

Elenca le opzioni disponibili per il comando.

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.

Convalida e visualizzazione dei dettagli di un target tramite la CLI

Utilizzare questo comando per ottenere informazioni su un target per una regione IBM Cloud Logs Routing.

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

Dove

--id TARGET

Il 4 UUID che identifica in modo univoco la destinazione.

La lunghezza massima è di 1028 caratteri. La lunghezza minima è di 24 caratteri.

--output FORMAT

Il formato attualmente supportato è JSON. Se specificato, l'output sarà restituito in formato JSON. Se JSON non viene specificato, l'output verrà restituito in formato tabellare.

help | --help | -h

Elenca le opzioni disponibili per il comando.

La risposta include informazioni sullo stato dell'obiettivo nell'oggetto di risposta write_status. Questo oggetto include le seguenti informazioni:

• Write Status Informazioni. I valori validi sono: success o failed.
• Last Failure informazioni sulla data e l'ora dell'ultimo guasto.
• Reason for last failure informazioni con una descrizione dettagliata della causa del guasto.

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

Elenco di tutti i target di una regione

Usare questo comando per elencare i target configurati per una regione IBM Cloud Logs Routing.

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

Dove

--output FORMAT

Il formato attualmente supportato è JSON. Se specificato, l'output sarà restituito in formato JSON. Se JSON non viene specificato, l'output verrà restituito in formato tabellare.

help | --help | -h

Elenca le opzioni disponibili per il comando.

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

Obiettivi e azioni API

La tabella seguente elenca le azioni che si possono eseguire per gestire i target:

È possibile utilizzare endpoint privati e pubblici per gestire i target. Per ulteriori informazioni sull'elenco dei ENDPOINTS disponibili, vedere Endpoint.

• È possibile gestire i target dalla rete privata utilizzando un endpoint API con il seguente formato: https://private.REGION.logs-router.cloud.ibm.com

• È possibile gestire i target dalla rete pubblica utilizzando un endpoint API con il seguente formato: https://REGION.logs-router.cloud.ibm.com

• È possibile disattivare gli endpoint pubblici aggiornando le impostazioni dell'account. Per ulteriori informazioni, vedere Configurazione delle impostazioni di destinazione e regione.

Per ulteriori informazioni sull'API REST, vedere IBM Cloud Logs Routing API REST v3.

Prerequisiti API

Per effettuare le chiamate API per gestire i target, completare i seguenti passaggi:

1. Ottenere un token di accesso IAM. Per ulteriori informazioni, vedere Recupero dei token di accesso IAM.
2. Identificare l'endpoint API nell'area in cui si intende configurare o gestire un target. Per ulteriori informazioni, vedere Endpoint.

Creare un obiettivo IBM Cloud Logs utilizzando l'API

È possibile creare un target per configurare una destinazione dove instradare i log della piattaforma.

• È possibile inviare i log della piattaforma da tutte le regioni a un singolo target, a diversi target o a più target.
• È possibile definire fino a 16 obiettivi per account.
• È possibile gestire i target a livello aziendale impostando il parametro managed by su enterprise. Questo valore è immutabile e non può essere modificato dopo la creazione della destinazione.

È possibile utilizzare il seguente comando cURL per creare una destinazione 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"
  }'

Dove

<ENDPOINT>

Endpoint è l'endpoint API dell'area in cui si intende configurare o gestire un target. Per ulteriori informazioni, vedere Endpoint.

TARGET_NAME

Il nome da assegnare alla destinazione.

Il nome deve essere al massimo di 1000 caratteri e non può includere caratteri speciali diversi da (spazio), -, ., _, :.

La lunghezza massima è di 1000 caratteri. La lunghezza minima è di 1 carattere.

Non includere informazioni di identificazione personale (PII) nei nomi delle risorse.

CLOUD_LOGS_TARGET_CRN

Il CRN dell'istanza IBM Cloud Logs.

La lunghezza massima è di 1000 caratteri. La lunghezza minima è di 3 caratteri.

REGION

Nome della regione, ad esempio us-south o eu-gb. Se non viene specificato, verrà utilizzata la regione in cui si è effettuato l'accesso o in cui si è puntato.

Includi regione se si desidera creare un target in una regione diversa da quella a cui si è collegati.

La lunghezza massima è di 1000 caratteri. La lunghezza minima è di 3 caratteri.

MANAGED-BY

Identifica chi gestisce questo obiettivo.

Se impostato su enterprise, la destinazione diventa gestita dall'azienda e può essere modificata solo dalle identità autorizzate alle azioni aziendali.

Se omesso o impostato su account, la destinazione è gestita dall'account figlio.

Questo valore è immutabile dopo la creazione.

I valori validi sono: enterprise, account.

Ad esempio, è possibile utilizzare la seguente richiesta cURL per creare un obiettivo a Dallas:

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

Nella risposta si ottengono informazioni sul target, come id, che indica il GUID del target, e crn, che indica il CRN del target.

Aggiornamento di un target IBM Cloud Logs tramite API

Quando si aggiorna un target IBM Cloud Logs, è necessario includere le informazioni sul target nella sezione dati della richiesta.

• È necessario superare tutti i campi.
• Aggiornare i campi da modificare.

È possibile utilizzare il seguente comando cURL per aggiornare una destinazione:

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

Dove

<ENDPOINT>

Endpoint è l'endpoint API dell'area in cui si intende configurare o gestire un target. Per ulteriori informazioni, vedere Endpoint.

TARGET_ID

L'UUID di v4 che identifica in modo univoco la destinazione.

TARGET_NAME

Il nome da assegnare alla destinazione.

Il nome deve essere al massimo di 1000 caratteri e non può includere caratteri speciali diversi da (spazio), -, ., _, :.

La lunghezza massima è di 1000 caratteri. La lunghezza minima è di 1 carattere.

Non includere informazioni di identificazione personale (PII) nei nomi delle risorse.

CLOUD_LOGS_TARGET_CRN

Il CRN dell'istanza IBM Cloud Logs.

La lunghezza massima è di 1000 caratteri. La lunghezza minima è di 3 caratteri.

Ad esempio, è possibile utilizzare la seguente richiesta cURL per aggiornare un target a Dallas:

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

Eliminazione di un obiettivo tramite l'API

È possibile utilizzare il seguente comando cURL per eliminare un target:

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

Dove

• <ENDPOINT> è l'endpoint API dell'area in cui si intende configurare o gestire un target. Per ulteriori informazioni, vedere Endpoint.
• <TARGET_ID> è l'UUID di v4 che identifica in modo univoco la destinazione.

Ad esempio, è possibile utilizzare la seguente richiesta cURL per eliminare un target in US-South con l'ID 00000000-0000-0000-0000-000000000000:

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

Nella risposta, si ottiene un risultato vuoto se l'eliminazione è avvenuta con successo:

{}

Convalida e visualizzazione dei dettagli di un obiettivo utilizzando l'API

È possibile utilizzare il seguente comando cURL per visualizzare i dettagli di configurazione di 1 target:

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

Dove

• <ENDPOINT> è l'endpoint API dell'area in cui si intende configurare o gestire un target. Per ulteriori informazioni, vedere Endpoint.
• <TARGET_ID> è l'UUID di v4 che identifica in modo univoco la destinazione.

La risposta include informazioni sullo stato dell'obiettivo nell'oggetto di risposta write_status. Questo oggetto include le seguenti informazioni:

• status Informazioni. I valori validi sono: success o failed.
• last_failure informazioni sulla data e l'ora dell'ultimo guasto.
• reason_for_last_failure informazioni con una descrizione dettagliata della causa del guasto.

Ad esempio, è possibile eseguire la seguente richiesta cURL per ottenere informazioni su un target con l'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""

La risposta è la seguente:

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

Elenco di tutti i target che utilizzano l'API

È possibile utilizzare il seguente comando cURL per visualizzare tutti i target:

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

Dove

• <ENDPOINT> è l'endpoint API dell'area in cui si intende configurare o gestire un target. Per ulteriori informazioni, vedere Endpoint.

Ad esempio, è possibile eseguire la seguente richiesta cURL per ottenere informazioni sui target definiti in Dallas:

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

Codici di risposta HTTP

Quando si utilizza l'API REST di IBM Cloud Logs Routing, è possibile ottenere i codici di risposta standard di HTTP per indicare se un metodo è stato completato con successo.

• Una risposta 200 indica sempre il successo.
• Una risposta 4xx indica un fallimento.
• Una risposta a 5xx indica solitamente un errore interno del sistema.

Vedere la tabella seguente per alcuni codici di risposta di HTTP:

Creare un obiettivo IBM Cloud Logs utilizzando l'interfaccia utente

Solo le risorse del vostro account sono elencate e selezionabili. Per specificare una risorsa in un account diverso, selezionare Specifica CRN in Scegliere la destinazione.

Completare i seguenti passaggi per creare un target:

1. Accedere al proprio account IBM Cloud.

2. Fare clic sull'icona Menu > Osservabilità.

3. Selezionare Registrazione > Instradamento.

4. Nella sezione Obiettivi, fare clic su Crea per aprire il pannello di creazione.

5. In Scegliere la destinazione, selezionare Cerca per istanza o Specifica CRN.

   Selezionare Cerca per istanza per scegliere un'istanza di IBM Cloud Logs dalla tabella disponibile nell'account

   Selezionare Specifica CRN per aggiungere il CRN dell'istanza IBM Cloud Logs di un'istanza che si trova in un account diverso.

   Per consentire a IBM Cloud Logs Routing di comunicare con IBM Cloud Logs è necessaria un'autorizzazione al servizio.

6. Nella sezione Dettagli del target, completare le seguenti operazioni:

   Immettere il nome della destinazione.

   Attivare la levetta da Non impostato per impostare automaticamente il nuovo obiettivo come obiettivo predefinito nelle impostazioni di IBM Cloud Logs Routing.

7. Fare clic su Crea destinazione.

Aggiornamento di un target IBM Cloud Logs tramite l'interfaccia utente

Solo le risorse del vostro account sono elencate e selezionabili. Per specificare una risorsa in un account diverso, selezionare Specifica CRN in Scegliere la destinazione.

Completa i seguenti passi:

1. Accedere al proprio account IBM Cloud.
2. Fare clic sull'icona Menu > Osservabilità.
3. Selezionare Registrazione > Instradamento.
4. Nella sezione Target, determinare il target da aggiornare e fare clic sull' Azioni.
5. Fare clic su Modifica per aprire il pannello di aggiornamento.
6. Nel pannello Aggiornamento, fare clic su Modifica per aggiornare il nome del target, su CRN per modificare l'istanza IBM Cloud Logs associata al target o su entrambi. È inoltre possibile attivare la voce Destinazione predefinita per aggiungere o rimuovere la destinazione come destinazione predefinita nelle impostazioni di IBM Cloud Logs Routing.
7. Fare clic su Salva per aggiornare il target.

Eliminazione di un target tramite l'interfaccia utente

Non è possibile eliminare un target IBM Cloud Logs Routing se è utilizzato in una rotta o come impostazione di target predefinita.

1. Accedere al proprio account IBM Cloud.
2. Fare clic sull'icona Menu > Osservabilità.
3. Selezionare Registrazione > Instradamento.
4. Nella sezione Target, determinare il target da aggiornare e fare clic sull' Azioni.
5. Selezionare Elimina e fare clic su Elimina nel pannello di conferma.

Elencare tutti i target di una regione utilizzando l'interfaccia utente

1. Accedere al proprio account IBM Cloud.
2. Fare clic sull'icona Menu > Osservabilità.
3. Selezionare Registrazione > Instradamento.

È possibile visualizzare l'elenco dei target definiti nell'account. Le seguenti informazioni sono incluse per ogni obiettivo:

• Nome di destinazione

• Tipo di destinazione

• Nome destinazione

• Regione di destinazione

• Le rotte definiscono se il target è usato in qualche rotta.

• Stato dell'obiettivo:

  • Configurato: Il target funziona come previsto.
  • Non riceve: La destinazione è configurata in modo errato e gli eventi non vengono instradati alla destinazione. Aggiornare i dettagli del target o la destinazione per correggere la configurazione del target o eliminare il target se non è più necessario.