Pré-requisitos da CLI

Antes de usar a CLI para gerenciar destinos, conclua as seguintes etapas:

1. Instale a CLI da IBM Cloud.

2. Instale a CLI da IBM Cloud Logs Routing.

3. Efetue login no IBM Cloud. Execute o comando a seguir: ibmcloud login

Criação de um alvo IBM Cloud Logs usando a CLI

Use esse comando para criar um alvo 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]

em que

--region REGION | -r REGION

Nome da região, por exemplo, us-south ou eu-gb. Se não for especificado, será usada a região conectada, ou destinada.

Inclua esse campo se quiser criar um alvo em uma região diferente daquela em que está conectado.

O comprimento máximo é de 1.000 caracteres. O comprimento mínimo é de 3 caracteres.

--name TARGET_NAME

O nome a ser fornecido ao destino.

O nome deve ter 1000 caracteres ou menos e não pode incluir nenhum caractere especial além de (espaço), -, ., _, :.

O comprimento máximo é de 1.000 caracteres. O comprimento mínimo é de 1 caractere.

Não inclua nenhuma PII (Personal Identifying Information) em quaisquer nomes de recursos.

--destination-crn CLOUD_LOGS_TARGET_CRN

O CRN da instância do IBM Cloud Logs.

O comprimento máximo é de 1.000 caracteres. O comprimento mínimo é de 3 caracteres.

--managed-by MANAGED-BY

Identifica quem gerencia esse alvo.

Se definido como enterprise, o alvo passa a ser gerenciado pela empresa e só pode ser modificado por identidades autorizadas para as ações da empresa.

Se for omitido ou definido como account, o alvo será gerenciado pela conta secundária.

Esse valor é imutável após a criação.

Os valores válidos são: enterprise, account.

--output FORMAT

O formato atualmente suportado é JSON. Se especificado, a saída será retornada no formato JSON. Se o JSON não for especificado, a saída será retornada em um formato tabular.

help | --help | -h

Liste as opções disponíveis para o 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

Atualização de um alvo IBM Cloud Logs usando a CLI

Use esse comando para atualizar um alvo IBM Cloud Logs para uma região IBM Cloud Logs Routing.

Qualquer valor especificado que seja diferente do momento da criação do destino será atualizado para o valor especificado no comando.

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

em que

--id TARGET

O 4 UUID que identifica exclusivamente o alvo.

O comprimento máximo é de 1028 caracteres. O comprimento mínimo é de 24 caracteres.

--name TARGET_NAME

O nome a ser fornecido ao destino.

O nome deve ter 1000 caracteres ou menos e não pode incluir nenhum caractere especial além de (espaço), -, ., _, :'.

O comprimento máximo é de 1.000 caracteres. O comprimento mínimo é de 1 caractere.

Não inclua nenhuma PII (Personal Identifying Information) em quaisquer nomes de recursos.

--destination-crn CLOUD_LOGS_TARGET_CRN

O CRN da instância do IBM Cloud Logs.

--output FORMAT

O formato atualmente suportado é JSON. Se especificado, a saída será retornada no formato JSON. Se o JSON não for especificado, a saída será retornada em um formato tabular.

help | --help | -h

Liste as opções disponíveis para o 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

Excluindo um destino usando a CLI

Use este comando para excluir um destino.

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

em que

--id TARGET

O 4 UUID que identifica exclusivamente o alvo.

O comprimento máximo é de 1028 caracteres. O comprimento mínimo é de 24 caracteres.

--force | -f

Excluirá o destino sem fornecer ao usuário nenhum prompt adicional.

help | --help | -h

Liste as opções disponíveis para o 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.

Validação e visualização de detalhes de um alvo usando a CLI

Use esse comando para obter informações sobre um destino para uma região do IBM Cloud Logs Routing.

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

em que

--id TARGET

O 4 UUID que identifica exclusivamente o alvo.

O comprimento máximo é de 1028 caracteres. O comprimento mínimo é de 24 caracteres.

--output FORMAT

O formato atualmente suportado é JSON. Se especificado, a saída será retornada no formato JSON. Se o JSON não for especificado, a saída será retornada em um formato tabular.

help | --help | -h

Liste as opções disponíveis para o comando.

A resposta inclui informações sobre o status do alvo no objeto de resposta write_status. Esse objeto inclui as seguintes informações:

• Write Status informações. Os valores válidos são: success ou failed.
• Last Failure informações de data e hora do registro de data e hora da última falha.
• Reason for last failure com uma descrição detalhada da causa da falha.

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

Listando todos os destinos em uma região

Use esse comando para listar os destinos configurados para uma região do IBM Cloud Logs Routing.

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

em que

--output FORMAT

O formato atualmente suportado é JSON. Se especificado, a saída será retornada no formato JSON. Se o JSON não for especificado, a saída será retornada em um formato tabular.

help | --help | -h

Liste as opções disponíveis para o comando.

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

Destinos e ações da API

A tabela a seguir lista as ações que podem ser executadas para gerenciar destinos:

É possível usar terminais privados e públicos para gerenciar destinos. Para obter mais informações sobre a lista de ENDPOINTS disponíveis, consulte Terminais.

• É possível gerenciar destinos a partir da rede privada usando um terminal de API com o formato a seguir: https://private.REGION.logs-router.cloud.ibm.com

• É possível gerenciar destinos a partir da rede pública usando um terminal de API com o formato a seguir: https://REGION.logs-router.cloud.ibm.com

• É possível desativar os terminais públicos atualizando as configurações da conta. Para obter informações adicionais, consulte Definindo configurações de destino e região.

Para obter mais informações sobre a API REST, consulte IBM Cloud Logs Routing API REST v3.

Pré-requisitos da API

Para fazer chamadas de API para gerenciar destinos, conclua as seguintes etapas:

1. Obtenha um token de acesso do IAM. Para obter mais informações, consulte Recuperando tokens de acesso do iAM.
2. Identifique o terminal da API na região em que você planeja configurar ou gerenciar um destino. Para obter mais informações, consulte Terminais.

Criação de um alvo IBM Cloud Logs usando a API

Você pode criar um alvo para configurar um destino para o qual possa encaminhar os logs da plataforma.

• Você pode enviar os logs da plataforma de todas as regiões para um único alvo, diferentes alvos ou vários alvos.
• Você pode definir até 16 alvos por conta.
• Você pode gerenciar alvos em nível empresarial, definindo o parâmetro managed by como enterprise. Esse valor é imutável e não pode ser alterado depois que o destino é criado.

Você pode usar o seguinte comando cURL para criar um alvo 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"
  }'

em que

<ENDPOINT>

Endpoint é o endpoint da API na região em que você planeja configurar ou gerenciar um destino. Para obter mais informações, consulte Terminais.

TARGET_NAME

O nome a ser fornecido ao destino.

O nome deve ter 1000 caracteres ou menos e não pode incluir nenhum caractere especial além de (espaço), -, ., _, :.

O comprimento máximo é de 1.000 caracteres. O comprimento mínimo é de 1 caractere.

Não inclua nenhuma PII (Personal Identifying Information) em quaisquer nomes de recursos.

CLOUD_LOGS_TARGET_CRN

O CRN da instância do IBM Cloud Logs.

O comprimento máximo é de 1.000 caracteres. O comprimento mínimo é de 3 caracteres.

REGION

Nome da região, por exemplo, us-south ou eu-gb. Se não for especificado, será usada a região conectada, ou destinada.

Incluir região se quiser criar um alvo em uma região diferente daquela em que você está conectado.

O comprimento máximo é de 1.000 caracteres. O comprimento mínimo é de 3 caracteres.

MANAGED-BY

Identifica quem gerencia esse alvo.

Se definido como enterprise, o alvo passa a ser gerenciado pela empresa e só pode ser modificado por identidades autorizadas para as ações da empresa.

Se for omitido ou definido como account, o alvo será gerenciado pela conta secundária.

Esse valor é imutável após a criação.

Os valores válidos são: enterprise, account.

Por exemplo, é possível usar a solicitação cURL a seguir para criar um destino em 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::"
  }'

Na resposta, são fornecidas informações sobre o destino como o id, que indica o GUID do destino, e o crn, que indica o CRN do destino.

Atualização de um alvo IBM Cloud Logs usando a API

Ao atualizar um alvo IBM Cloud Logs, é necessário incluir as informações do alvo na seção de dados da solicitação.

• Deve-se ter aprovação em todos os campos.
• Atualize os campos que precisam ser modificados.

É possível usar o comando cURL a seguir para atualizar um destino:

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

em que

<ENDPOINT>

Endpoint é o endpoint da API na região em que você planeja configurar ou gerenciar um destino. Para obter mais informações, consulte Terminais.

TARGET_ID

O v4 UUID que identifica exclusivamente o alvo.

TARGET_NAME

O nome a ser fornecido ao destino.

O nome deve ter 1000 caracteres ou menos e não pode incluir nenhum caractere especial além de (espaço), -, ., _, :.

O comprimento máximo é de 1.000 caracteres. O comprimento mínimo é de 1 caractere.

Não inclua nenhuma PII (Personal Identifying Information) em quaisquer nomes de recursos.

CLOUD_LOGS_TARGET_CRN

O CRN da instância do IBM Cloud Logs.

O comprimento máximo é de 1.000 caracteres. O comprimento mínimo é de 3 caracteres.

Por exemplo, pode-se usar a solicitação cURL a seguir para atualizar um destino em 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::"
  }'

Excluindo um destino que usa a CLI

É possível usar o comando cURL a seguir para excluir um destino:

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

em que

• <ENDPOINT> é o terminal de API na região em que você planeja configurar ou gerenciar um destino. Para obter mais informações, consulte Terminais.
• <TARGET_ID> é o v4 UUID que identifica exclusivamente o alvo.

Por exemplo, pode-se usar a solicitação cURL a seguir para excluir um destino na região US-South com o 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""

Na resposta, obtém-se um resultado vazio se a exclusão foi bem-sucedida:

{}

Validação e visualização de detalhes de um alvo usando a API

É possível usar o comando cURL a seguir para visualizar os detalhes de configuração de um destino:

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

em que

• <ENDPOINT> é o terminal de API na região em que você planeja configurar ou gerenciar um destino. Para obter mais informações, consulte Terminais.
• <TARGET_ID> é o v4 UUID que identifica exclusivamente o alvo.

A resposta inclui informações sobre o status do alvo no objeto de resposta write_status. Esse objeto inclui as seguintes informações:

• status informações. Os valores válidos são: success ou failed.
• last_failure informações de data e hora do registro de data e hora da última falha.
• reason_for_last_failure com uma descrição detalhada da causa da falha.

Por exemplo, pode-se executar a solicitação cURL a seguir para obter informações sobre um destino com o 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""

A resposta é a seguinte:

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

Listando todos os destinos usando a API

É possível usar o comando cURL a seguir para visualizar todos os destinos:

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

em que

• <ENDPOINT> é o terminal de API na região em que você planeja configurar ou gerenciar um destino. Para obter mais informações, consulte Terminais.

Por exemplo, pode-se executar a solicitação cURL a seguir para obter informações sobre os destinos que são definidos em Dallas:

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

Códigos de resposta HTTP

Quando você usa a API de REST do IBM Cloud Logs Routing, pode obter códigos de resposta HTTP padrão para indicar se um método foi concluído com sucesso.

• A resposta 200 sempre indica sucesso.
• A resposta 4xx indica uma falha.
• A resposta 5xx geralmente indica um erro no sistema interno.

Consulte a tabela a seguir para obter alguns códigos de resposta HTTP:

Criação de um alvo IBM Cloud Logs usando a interface do usuário

Somente os recursos em sua conta são listados e podem ser selecionados. Para especificar um recurso em uma conta diferente, selecione Specify CRN (Especificar CRN ) em Choose destination (Escolher destino ).

Conclua as etapas a seguir para criar um alvo:

1. Faça login em sua conta IBM Cloud.

2. Clique no ícone Menu > Observabilidade.

3. Selecione Registro > Roteamento.

4. Na seção Targets (Alvos ), clique em Create (Criar ) para abrir o painel de criação.

5. Em Choose destination (Escolher destino ), selecione Search by instance (Pesquisar por instância ) ou Specify CRN (Especificar CRN ).

   Selecione Search by instance (Pesquisar por instância ) para escolher uma instância do IBM Cloud Logs na tabela que está disponível na conta

   Selecione Specify CRN (Especificar CRN ) para adicionar o CRN da instância IBM Cloud Logs de uma instância localizada em uma conta diferente.

   É necessária uma autorização de serviço para que o IBM Cloud Logs Routing possa se comunicar com o IBM Cloud Logs.

6. Na seção de detalhes do alvo, conclua as seguintes tarefas:

   Digite o nome do destino.

   Ative a alternância de Não definido para definir automaticamente o novo alvo como um alvo padrão nas configurações do site IBM Cloud Logs Routing.

7. Clique em Criar destino.

Atualização de um alvo IBM Cloud Logs usando a interface do usuário

Somente os recursos em sua conta são listados e podem ser selecionados. Para especificar um recurso em uma conta diferente, selecione Specify CRN (Especificar CRN ) em Choose destination (Escolher destino ).

Conclua as etapas a seguir:

1. Faça login em sua conta IBM Cloud.
2. Clique no ícone Menu > Observabilidade.
3. Selecione Registro > Roteamento.
4. Na seção Targets (Alvos ), determine o alvo a ser atualizado e clique no ).
5. Clique em Editar para abrir o painel de atualização.
6. No painel Update (Atualizar), clique em Edit (Editar ) para atualizar o nome do destino, CRN para alterar a instância IBM Cloud Logs associada ao destino, ou ambos. Você também pode alternar entre Default target (Alvo padrão ) para adicionar ou remover seu alvo como alvo padrão nas configurações do site IBM Cloud Logs Routing.
7. Clique em Save (Salvar ) para atualizar seu alvo.

Exclusão de um alvo usando a interface do usuário

Não é possível excluir um alvo IBM Cloud Logs Routing se ele for usado em uma rota ou como uma configuração de alvo padrão.

1. Faça login em sua conta IBM Cloud.
2. Clique no ícone Menu > Observabilidade.
3. Selecione Registro > Roteamento.
4. Na seção Targets (Alvos ), determine o alvo a ser atualizado e clique no ).
5. Selecione Excluir e clique em Excluir no painel de confirmação.

Listagem de todos os alvos em uma região usando a interface do usuário

1. Faça login em sua conta IBM Cloud.
2. Clique no ícone Menu > Observabilidade.
3. Selecione Registro > Roteamento.

Você pode ver a lista de alvos que estão definidos na conta. As informações a seguir estão incluídas por alvo:

• Nome de destino

• Tipo de destino

• Nome do destino

• Região de destino

• Rotas definem se o destino é usado em alguma rota.

• Status do alvo:

  • Configurado: O alvo está funcionando como esperado.
  • Não está recebendo: O destino está mal configurado e os eventos não serão roteados para o destino. Atualize os detalhes do destino ou o destino para corrigir a configuração do destino ou exclua o destino se ele não for mais necessário.