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 목록에 대한 자세한 정보는 엔드포인트를 참조하십시오.

• 다음 형식의 API 엔드포인트를 사용하여 사설 네트워크에서 대상을 관리할 수 있습니다. https://private.REGION.logs-router.cloud.ibm.com

• 다음 형식의 API 엔드포인트를 사용하여 공용 네트워크에서 대상을 관리할 수 있습니다. https://REGION.logs-router.cloud.ibm.com

• 계정 설정을 업데이트하여 공용 엔드포인트를 사용 안함으로 설정할 수 있습니다. 자세한 정보는 대상 및 지역 설정 구성을 참조하십시오.

REST API에 대한 자세한 내용은 IBM Cloud Logs Routing REST API v3 을 참조하세요.

API 전제조건

대상을 관리하는 API 호출을 수행하려면 다음 단계를 완료하십시오.

1. IAM 액세스 토큰을 가져오십시오. 자세한 정보는 IAM 액세스 토큰 검색을 참조하십시오.
2. 대상을 구성하거나 관리할 지역에서 API 엔드포인트를 식별하십시오. 자세한 정보는 엔드포인트를 참조하십시오.

API를 사용하여 IBM Cloud Logs 대상 만들기

대상을 만들어 플랫폼 로그를 라우팅할 수 있는 대상을 구성할 수 있습니다.

• 모든 지역의 플랫폼 로그를 단일 대상, 다른 대상 또는 여러 대상에 전송할 수 있습니다.
• 계정당 최대 16개의 대상을 정의할 수 있습니다.
• managed by 매개 변수를 엔터프라이즈로 설정하여 엔터프라이즈 수준에서 대상을 관리할 수 있습니다. 이 값은 변경할 수 없으며 대상을 만든 후에는 변경할 수 없습니다.

다음 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>

엔드포인트는 대상을 구성하거나 관리하려는 지역의 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>

엔드포인트는 대상을 구성하거나 관리하려는 지역의 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 요청을 사용하여 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""

응답에서, 삭제에 성공하면 비어 있는 결과를 받습니다.

{}

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 대상 만들기

계정에 있는 리소스만 나열되고 선택할 수 있습니다. 다른 계정의 리소스를 지정하려면 대상 선택에서 CRN 지 정을 선택합니다.

다음 단계를 완료하여 대상을 만듭니다:

1. IBM Cloud 계정에 로그인 합니다.

2. 메뉴 아이콘 > 관측성을 클릭하십시오.

3. 로깅 > 라우팅을 선택합니다.

4. 대상 섹션에서 만들기를 클릭하여 만들기 패널을 엽니다.

5. 대상 선택에서 인스턴스로 검색 또는 CRN 지정을 선택합니다.

   인스턴스로 검색을 선택하여 계정에서 사용할 수 있는 표에서 IBM Cloud Logs 인스턴스를 선택합니다

   다른 계정에 있는 인스턴스의 IBM Cloud Logs 인스턴스 CRN을 추가하려면 CRN 지 정을 선택합니다.

   IBM Cloud Logs Routing 이 IBM Cloud Logs 과 통신하려면 서비스 권한이 필요합니다.

6. 대상 세부 정보 섹션에서 다음 작업을 완료합니다:

   대상 이름을 입력합니다.

   설정되지 않음 토글을 활성화하여 IBM Cloud Logs Routing 설정에서 새 대상을 기본 대상으로 자동 설정합니다.

7. 대상 생성을 클릭합니다.

UI를 사용하여 IBM Cloud Logs 대상 업데이트하기

계정에 있는 리소스만 나열되고 선택할 수 있습니다. 다른 계정의 리소스를 지정하려면 대상 선택에서 CRN 지 정을 선택합니다.

다음 단계를 완료하십시오.

1. IBM Cloud 계정에 로그인 합니다.
2. 메뉴 아이콘 > 관측성을 클릭하십시오.
3. 로깅 > 라우팅을 선택합니다.
4. 대상 섹션에서 업데이트할 대상을 결정하고 클릭합니다.
5. 편집을 클릭하여 업데이트 패널을 엽니다.
6. 업데이트 패널에서 편집을 클릭하여 대상의 이름을 업데이트하거나 CRN을 클릭하여 대상과 연결된 IBM Cloud Logs 인스턴스를 변경하거나 둘 다 변경합니다. IBM Cloud Logs Routing 설정에서 기본 대상을 토글하여 대상을 기본 대상으로 추가하거나 제거할 수도 있습니다.
7. 저장을 클릭하여 대상을 업데이트합니다.

UI를 사용하여 대상 삭제하기

IBM Cloud Logs Routing 타겟이 경로에 사용되거나 기본 타겟 설정으로 사용된 경우에는 삭제할 수 없습니다.

1. IBM Cloud 계정에 로그인 합니다.
2. 메뉴 아이콘 > 관측성을 클릭하십시오.
3. 로깅 > 라우팅을 선택합니다.
4. 대상 섹션에서 업데이트할 대상을 결정하고 클릭합니다.
5. 삭제를 선택한 다음 확인 패널에서 삭제를 클릭합니다.

UI를 사용하여 지역의 모든 대상 나열하기

1. IBM Cloud 계정에 로그인 합니다.
2. 메뉴 아이콘 > 관측성을 클릭하십시오.
3. 로깅 > 라우팅을 선택합니다.

계정에 정의된 대상 목록을 볼 수 있습니다. 대상별로 포함되는 정보는 다음과 같습니다:

• 대상 이름

• 대상 유형

• 대상 이름

• 대상 지역

• 경로는 타겟이 어떤 경로에서 사용되는지 정의합니다.

• 대상 상태:

  • 구성되었습니다: 타겟이 예상대로 작동합니다.
  • 수신하지 못함: 대상이 잘못 구성되었으며 이벤트가 대상에 라우팅되지 않습니다. 대상 세부 정보 또는 대상을 업데이트하여 대상 구성을 수정하거나 더 이상 필요하지 않은 경우 대상을 삭제합니다.