이 섹션의 다중 페이지 출력 화면임. 여기를 클릭하여 프린트.

이 페이지의 일반 화면으로 돌아가기.

APIs

1 - CreateTrail

1.1 - 1.1

post /v1/trails

Description

create a trail

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.1-

Parameters

TypeNameDescriptionSchemaDefault
bodybody
required
TrailCreateRequestV1dot1

Responses

HTTP CodeDescriptionSchema
201CreatedTrailShowResponseV1dot1
400Bad RequestNone
401UnauthorizedNone
403ForbiddenNone
409ConflictNone

Example HTTP request

Request path

/v1/trails

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = loggingaudit 1.1"

Request body

{
    "account_id": "ACCOUNT_ID-ABCDEF1234",
    "bucket_name": "TestBucket00",
    "bucket_region": "RegionOne",
    "log_archive_account_id": "ACCOUNT_ID-ABCDEF1234",
    "log_type_total_yn": "N",
    "log_verification_yn": "N",
    "organization_trail_yn": "N",
    "region_names": [],
    "region_total_yn": "Y",
    "resource_type_total_yn": "Y",
    "tag_create_requests": [
        {
            "key": "11",
            "value": "22"
        }
    ],
    "target_log_types": [],
    "target_resource_types": [],
    "target_users": [],
    "trail_description": "This is a test trail",
    "trail_name": "TestTrail01",
    "trail_save_type": "JSON",
    "user_total_yn": "Y"
}

Example HTTP response

Response 201

{
    "trail": {
        "account_id": "ACCOUNT_ID-ABCDEF1234",
        "account_name": "Test Account",
        "bucket_name": "Bucket001",
        "bucket_region": "RegionOne",
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "created_user_id": "kim.samsung@samsung.com",
        "del_yn": "N",
        "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
        "log_archive_account_id": "ACCOUNT_ID-ABCDEF1234",
        "log_type_total_yn": "Y",
        "log_verification_yn": "N",
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "organization_trail_yn": "Y",
        "region_names": [],
        "region_total_yn": "Y",
        "resource_type_total_yn": "Y",
        "state": "ACTIVE",
        "target_log_types": [],
        "target_resource_types": [],
        "target_users": [],
        "trail_batch_end_at": "2025-11-07T09:00:00Z",
        "trail_batch_first_start_at": "2025-10-28T10:00:00Z",
        "trail_batch_last_state": "success",
        "trail_batch_start_at": "2025-11-07T09:00:00Z",
        "trail_batch_success_at": "2025-11-07T09:00:00Z",
        "trail_description": "test trail",
        "trail_name": "Trail-0001",
        "trail_save_type": "JSON",
        "user_total_yn": "Y"
    }
}

1.2 - 1.0

post /v1/trails

Description

create a trail

상태 ACTIVE (DEPRECATED)

버전최소 지원 보장일
1.020260223

Parameters

TypeNameDescriptionSchemaDefault
bodybody
required
TrailCreateRequest

Responses

HTTP CodeDescriptionSchema
201CreatedTrailShowResponse
400Bad RequestNone
401UnauthorizedNone
403ForbiddenNone
409ConflictNone

Example HTTP request

Request path

/v1/trails

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = loggingaudit 1.0"

Request body

{
    "account_id": "ACCOUNT_ID-ABCDEF1234",
    "bucket_name": "TestBucket00",
    "bucket_region": "RegionOne",
    "log_type_total_yn": "N",
    "log_verification_yn": "N",
    "region_names": [],
    "region_total_yn": "Y",
    "resource_type_total_yn": "Y",
    "tag_create_requests": [
        {
            "key": "11",
            "value": "22"
        }
    ],
    "target_log_types": [],
    "target_resource_types": [],
    "target_users": [],
    "trail_description": "This is a test trail",
    "trail_name": "TestTrail01",
    "trail_save_type": "JSON",
    "user_total_yn": "Y"
}

Example HTTP response

Response 201

{
    "trail": {
        "account_id": "ACCOUNT_ID-ABCDEF1234",
        "account_name": "Test Account",
        "bucket_name": "Bucket001",
        "bucket_region": "RegionOne",
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "created_user_id": "kim.samsung@samsung.com",
        "del_yn": "N",
        "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
        "log_type_total_yn": "Y",
        "log_verification_yn": "N",
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "region_names": [],
        "region_total_yn": "Y",
        "resource_type_total_yn": "Y",
        "state": "ACTIVE",
        "target_log_types": [],
        "target_resource_types": [],
        "target_users": [],
        "trail_batch_end_at": "2025-11-07T09:00:00Z",
        "trail_batch_first_start_at": "2025-10-28T10:00:00Z",
        "trail_batch_last_state": "success",
        "trail_batch_start_at": "2025-11-07T09:00:00Z",
        "trail_batch_success_at": "2025-11-07T09:00:00Z",
        "trail_description": "test trail",
        "trail_name": "Trail-0001",
        "trail_save_type": "JSON",
        "user_total_yn": "Y"
    }
}

2 - DeleteTrail

2.1 - 1.1

delete /v1/trails/{trail_id}

Description

delete a specific trail

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.1-

Parameters

TypeNameDescriptionSchemaDefault
pathtrail_id
required		Trail ID
Example :
any of [string, null]None

Responses

HTTP CodeDescriptionSchema
202AcceptedNone
204No ContentNone
401UnauthorizedNone
403ForbiddenNone

Example HTTP request

Request path

/v1/trails/{trail_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = loggingaudit 1.1"

Example HTTP response

Response 202

2.2 - 1.0

delete /v1/trails/{trail_id}

Description

delete a specific trail

상태 ACTIVE (DEPRECATED)

버전최소 지원 보장일
1.020260223

Parameters

TypeNameDescriptionSchemaDefault
pathtrail_id
required		Trail ID
Example :
any of [string, null]None

Responses

HTTP CodeDescriptionSchema
202AcceptedNone
204No ContentNone
401UnauthorizedNone
403ForbiddenNone

Example HTTP request

Request path

/v1/trails/{trail_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = loggingaudit 1.0"

Example HTTP response

Response 202

3 - DownloadLogs

3.1 - 1.1

post /v1/logs/download

Description

download log file

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.1-

Parameters

TypeNameDescriptionSchemaDefault
bodybody
required
LogDownloadRequest

Responses

HTTP CodeDescriptionSchema
200OKLogDownloadResponse
400Bad RequestNone
401UnauthorizedNone
403ForbiddenNone

Example HTTP request

Request path

/v1/logs/download

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = loggingaudit 1.1"

Request body

{
    "end_at": "2025-11-07T10:00:00Z",
    "file_type": "JSON",
    "product_name": "",
    "region": "",
    "resource_name": "",
    "resource_type": "",
    "root_resource_id": "",
    "start_at": "2025-08-09T10:00:00Z",
    "status": "",
    "time_zone_info": "Asia/Seoul",
    "user_name": ""
}

Example HTTP response

Response 200

{
    "file": [
        {
            "EventTopic": "",
            "RegionName": "",
            "ResourceId": "",
            "ResourceName": "",
            "ResourceType": "",
            "WorkInfo": "",
            "WorkResult": "",
            "WorkTime": "",
            "WorkerEmail": "",
            "WorkerID": "",
            "WorkerName": ""
        }
    ]
}

3.2 - 1.0

post /v1/logs/download

Description

download log file

상태 ACTIVE (DEPRECATED)

버전최소 지원 보장일
1.020260223

Parameters

TypeNameDescriptionSchemaDefault
bodybody
required
LogDownloadRequest

Responses

HTTP CodeDescriptionSchema
200OKLogDownloadResponse
400Bad RequestNone
401UnauthorizedNone
403ForbiddenNone

Example HTTP request

Request path

/v1/logs/download

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = loggingaudit 1.0"

Request body

{
    "end_at": "2025-11-07T10:00:00Z",
    "file_type": "JSON",
    "product_name": "",
    "region": "",
    "resource_name": "",
    "resource_type": "",
    "root_resource_id": "",
    "start_at": "2025-08-09T10:00:00Z",
    "status": "",
    "time_zone_info": "Asia/Seoul",
    "user_name": ""
}

Example HTTP response

Response 200

{
    "file": [
        {
            "EventTopic": "",
            "RegionName": "",
            "ResourceId": "",
            "ResourceName": "",
            "ResourceType": "",
            "WorkInfo": "",
            "WorkResult": "",
            "WorkTime": "",
            "WorkerEmail": "",
            "WorkerID": "",
            "WorkerName": ""
        }
    ]
}

4 - ListLogs

4.1 - 1.1

get /v1/logs

Description

get log list

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.1-

Parameters

TypeNameDescriptionSchemaDefault
querysize
optional		size
Example : 20
any of [integer, null]20
querypage
optional		page
Example : 0
any of [integer, null]0
querysort
optional		sort
Example : created_at:desc
any of [string, null]None
querystart_at
required		Query start date
Example : 2025-08-09T10:00:00Z
any of [string, null]None
queryend_at
required		Query finish date
Example : 2025-11-07T10:00:00Z
any of [string, null]None
queryresource_id
optional		Resource ID
Example :
any of [string, null]None
queryresource_name
optional		Resource name
Example :
any of [string, null]None
queryresource_type
optional		Resource type
Example :
any of [string, null]None
queryproduct_name
optional		Product name
Example :
any of [string, null]None
queryproduct_type
optional		Product type
Example :
any of [string, null]None
querystatus
optional		Task result
Example :
any of [string, null]None
queryevent_type
optional		Event type
Example :
any of [string, null]None
queryuser_id
optional		User ID
Example :
any of [string, null]None
queryuser_name
optional		Username
Example :
any of [string, null]None
queryregion
optional		Region name
Example :
any of [string, null]None
queryroot_resource_id
optional		Root resource ID
Example :
any of [string, null]None
queryservice_type
optional		Service type
Example :
any of [string, null]None

Responses

HTTP CodeDescriptionSchema
200OKLogListResponse
400Bad RequestNone
401UnauthorizedNone
403ForbiddenNone

Example HTTP request

Request path

/v1/logs?start_at={start_at}&end_at={end_at}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = loggingaudit 1.1"

Example HTTP response

Response 200

{
    "count": 20,
    "logs": [
        {
            "account_id": "ACCOUNT_ID-ABCDEF1234",
            "event_name": "scp-extension.event.create",
            "event_type": "scp-extension.event.create",
            "id": "ID-A1B2C3D4E5F6G7H8I9J0",
            "product_name": "scp-extension",
            "product_type": "scp-extension",
            "region": "RegionOne",
            "request_user_name": "Hong Gildong",
            "resource_id": "RESOURCE_ID-ABCDEF1234",
            "resource_name": "RESOURCE_NAME-ABCDEF1234",
            "resource_type": "scp-extension",
            "role_name": "Tester",
            "status": "Success",
            "timestamp": "2025-11-07T10:00:00Z",
            "type": "ROLE",
            "user_id": "USER_ID-ABCDEF1234"
        }
    ],
    "page": 0,
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

4.2 - 1.0

get /v1/logs

Description

get log list

상태 ACTIVE (DEPRECATED)

버전최소 지원 보장일
1.020260223

Parameters

TypeNameDescriptionSchemaDefault
querysize
optional		size
Example : 20
any of [integer, null]20
querypage
optional		page
Example : 0
any of [integer, null]0
querysort
optional		sort
Example : created_at:desc
any of [string, null]None
querystart_at
required		Query start date
Example : 2025-08-09T10:00:00Z
any of [string, null]None
queryend_at
required		Query finish date
Example : 2025-11-07T10:00:00Z
any of [string, null]None
queryresource_id
optional		Resource ID
Example :
any of [string, null]None
queryresource_name
optional		Resource name
Example :
any of [string, null]None
queryresource_type
optional		Resource type
Example :
any of [string, null]None
queryproduct_name
optional		Product name
Example :
any of [string, null]None
queryproduct_type
optional		Product type
Example :
any of [string, null]None
querystatus
optional		Task result
Example :
any of [string, null]None
queryevent_type
optional		Event type
Example :
any of [string, null]None
queryuser_id
optional		User ID
Example :
any of [string, null]None
queryuser_name
optional		Username
Example :
any of [string, null]None
queryregion
optional		Region name
Example :
any of [string, null]None
queryroot_resource_id
optional		Root resource ID
Example :
any of [string, null]None
queryservice_type
optional		Service type
Example :
any of [string, null]None

Responses

HTTP CodeDescriptionSchema
200OKLogListResponse
400Bad RequestNone
401UnauthorizedNone
403ForbiddenNone

Example HTTP request

Request path

/v1/logs?start_at={start_at}&end_at={end_at}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = loggingaudit 1.0"

Example HTTP response

Response 200

{
    "count": 20,
    "logs": [
        {
            "account_id": "ACCOUNT_ID-ABCDEF1234",
            "event_name": "scp-extension.event.create",
            "event_type": "scp-extension.event.create",
            "id": "ID-A1B2C3D4E5F6G7H8I9J0",
            "product_name": "scp-extension",
            "product_type": "scp-extension",
            "region": "RegionOne",
            "request_user_name": "Hong Gildong",
            "resource_id": "RESOURCE_ID-ABCDEF1234",
            "resource_name": "RESOURCE_NAME-ABCDEF1234",
            "resource_type": "scp-extension",
            "role_name": "Tester",
            "status": "Success",
            "timestamp": "2025-11-07T10:00:00Z",
            "type": "ROLE",
            "user_id": "USER_ID-ABCDEF1234"
        }
    ],
    "page": 0,
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

5 - ListTrails

5.1 - 1.1

get /v1/trails

Description

get trails list

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.1-

Parameters

TypeNameDescriptionSchemaDefault
querysize
optional		size
Example : 20
any of [integer, null]20
querypage
optional		page
Example : 0
any of [integer, null]0
querysort
optional		sort
Example : created_at:desc
any of [string, null]None
querytrail_name
optional		Trail name
Example :
any of [string, null]None
querybucket_name
optional		Bucket name
Example :
any of [string, null]None
querystate
optional		Trail state
Example :
any of [string, null]None
queryresource_type
optional		Resource type
Example :
any of [string, null]None

Responses

HTTP CodeDescriptionSchema
200OKTrailListResponseV1dot1
400Bad RequestNone
401UnauthorizedNone
403ForbiddenNone

Example HTTP request

Request path

/v1/trails

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = loggingaudit 1.1"

Example HTTP response

Response 200

{
    "count": 20,
    "page": 0,
    "size": 20,
    "sort": [
        "created_at:asc"
    ],
    "trails": [
        {
            "account_id": "ACCOUNT_ID-ABCDEF1234",
            "account_name": "Test Account",
            "bucket_name": "Bucket001",
            "bucket_region": "RegionOne",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "created_user_id": "kim.samsung@samsung.com",
            "del_yn": "N",
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "log_archive_account_id": "ACCOUNT_ID-ABCDEF1234",
            "log_type_total_yn": "Y",
            "log_verification_yn": "N",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "organization_trail_yn": "Y",
            "region_names": [],
            "region_total_yn": "Y",
            "resource_type_total_yn": "Y",
            "state": "ACTIVE",
            "target_log_types": [],
            "target_resource_types": [],
            "target_users": [],
            "trail_batch_end_at": "2025-11-07T09:00:00Z",
            "trail_batch_first_start_at": "2025-10-28T10:00:00Z",
            "trail_batch_last_state": "success",
            "trail_batch_start_at": "2025-11-07T09:00:00Z",
            "trail_batch_success_at": "2025-11-07T09:00:00Z",
            "trail_description": "test trail",
            "trail_name": "Trail-0001",
            "trail_save_type": "JSON",
            "user_total_yn": "Y"
        }
    ]
}

5.2 - 1.0

get /v1/trails

Description

get trails list

상태 ACTIVE (DEPRECATED)

버전최소 지원 보장일
1.020260223

Parameters

TypeNameDescriptionSchemaDefault
querysize
optional		size
Example : 20
any of [integer, null]20
querypage
optional		page
Example : 0
any of [integer, null]0
querysort
optional		sort
Example : created_at:desc
any of [string, null]None
querytrail_name
optional		Trail name
Example :
any of [string, null]None
querybucket_name
optional		Bucket name
Example :
any of [string, null]None
querystate
optional		Trail state
Example :
any of [string, null]None
queryresource_type
optional		Resource type
Example :
any of [string, null]None

Responses

HTTP CodeDescriptionSchema
200OKTrailListResponse
400Bad RequestNone
401UnauthorizedNone
403ForbiddenNone

Example HTTP request

Request path

/v1/trails

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = loggingaudit 1.0"

Example HTTP response

Response 200

{
    "count": 20,
    "page": 0,
    "size": 20,
    "sort": [
        "created_at:asc"
    ],
    "trails": [
        {
            "account_id": "ACCOUNT_ID-ABCDEF1234",
            "account_name": "Test Account",
            "bucket_name": "Bucket001",
            "bucket_region": "RegionOne",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "created_user_id": "kim.samsung@samsung.com",
            "del_yn": "N",
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "log_type_total_yn": "Y",
            "log_verification_yn": "N",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "region_names": [],
            "region_total_yn": "Y",
            "resource_type_total_yn": "Y",
            "state": "ACTIVE",
            "target_log_types": [],
            "target_resource_types": [],
            "target_users": [],
            "trail_batch_end_at": "2025-11-07T09:00:00Z",
            "trail_batch_first_start_at": "2025-10-28T10:00:00Z",
            "trail_batch_last_state": "success",
            "trail_batch_start_at": "2025-11-07T09:00:00Z",
            "trail_batch_success_at": "2025-11-07T09:00:00Z",
            "trail_description": "test trail",
            "trail_name": "Trail-0001",
            "trail_save_type": "JSON",
            "user_total_yn": "Y"
        }
    ]
}

6 - SetTrail

6.1 - 1.1

put /v1/trails/{trail_id}

Description

set a specific trail

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.1-

Parameters

TypeNameDescriptionSchemaDefault
pathtrail_id
required		Trail ID
Example :
any of [string, null]None
bodybody
required
TrailSetRequestV1dot1

Responses

HTTP CodeDescriptionSchema
202AcceptedTrailShowResponseV1dot1
400Bad RequestNone
401UnauthorizedNone
403ForbiddenNone

Example HTTP request

Request path

/v1/trails/{trail_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = loggingaudit 1.1"

Request body

{
    "log_type_total_yn": "N",
    "log_verification_yn": "N",
    "organization_trail_yn": "Y",
    "region_names": [],
    "region_total_yn": "Y",
    "resource_type_total_yn": "Y",
    "target_log_types": [],
    "target_resource_types": [],
    "target_users": [],
    "trail_description": "This is a test trail",
    "trail_save_type": "JSON",
    "user_total_yn": "Y"
}

Example HTTP response

Response 202

{
    "trail": {
        "account_id": "ACCOUNT_ID-ABCDEF1234",
        "account_name": "Test Account",
        "bucket_name": "Bucket001",
        "bucket_region": "RegionOne",
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "created_user_id": "kim.samsung@samsung.com",
        "del_yn": "N",
        "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
        "log_archive_account_id": "ACCOUNT_ID-ABCDEF1234",
        "log_type_total_yn": "Y",
        "log_verification_yn": "N",
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "organization_trail_yn": "Y",
        "region_names": [],
        "region_total_yn": "Y",
        "resource_type_total_yn": "Y",
        "state": "ACTIVE",
        "target_log_types": [],
        "target_resource_types": [],
        "target_users": [],
        "trail_batch_end_at": "2025-11-07T09:00:00Z",
        "trail_batch_first_start_at": "2025-10-28T10:00:00Z",
        "trail_batch_last_state": "success",
        "trail_batch_start_at": "2025-11-07T09:00:00Z",
        "trail_batch_success_at": "2025-11-07T09:00:00Z",
        "trail_description": "test trail",
        "trail_name": "Trail-0001",
        "trail_save_type": "JSON",
        "user_total_yn": "Y"
    }
}

6.2 - 1.0

put /v1/trails/{trail_id}

Description

set a specific trail

상태 ACTIVE (DEPRECATED)

버전최소 지원 보장일
1.020260223

Parameters

TypeNameDescriptionSchemaDefault
pathtrail_id
required		Trail ID
Example :
any of [string, null]None
bodybody
required
TrailSetRequest

Responses

HTTP CodeDescriptionSchema
202AcceptedTrailShowResponse
400Bad RequestNone
401UnauthorizedNone
403ForbiddenNone

Example HTTP request

Request path

/v1/trails/{trail_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = loggingaudit 1.0"

Request body

{
    "log_type_total_yn": "N",
    "log_verification_yn": "N",
    "region_names": [],
    "region_total_yn": "Y",
    "resource_type_total_yn": "Y",
    "target_log_types": [],
    "target_resource_types": [],
    "target_users": [],
    "trail_description": "This is a test trail",
    "trail_save_type": "JSON",
    "user_total_yn": "Y"
}

Example HTTP response

Response 202

{
    "trail": {
        "account_id": "ACCOUNT_ID-ABCDEF1234",
        "account_name": "Test Account",
        "bucket_name": "Bucket001",
        "bucket_region": "RegionOne",
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "created_user_id": "kim.samsung@samsung.com",
        "del_yn": "N",
        "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
        "log_type_total_yn": "Y",
        "log_verification_yn": "N",
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "region_names": [],
        "region_total_yn": "Y",
        "resource_type_total_yn": "Y",
        "state": "ACTIVE",
        "target_log_types": [],
        "target_resource_types": [],
        "target_users": [],
        "trail_batch_end_at": "2025-11-07T09:00:00Z",
        "trail_batch_first_start_at": "2025-10-28T10:00:00Z",
        "trail_batch_last_state": "success",
        "trail_batch_start_at": "2025-11-07T09:00:00Z",
        "trail_batch_success_at": "2025-11-07T09:00:00Z",
        "trail_description": "test trail",
        "trail_name": "Trail-0001",
        "trail_save_type": "JSON",
        "user_total_yn": "Y"
    }
}

7 - ShowLog

7.1 - 1.1

get /v1/logs/{logging_id}

Description

show a specific log

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.1-

Parameters

TypeNameDescriptionSchemaDefault
pathlogging_id
required		Log ID
Example :
stringNone

Responses

HTTP CodeDescriptionSchema
200OKLogShowResponse
400Bad RequestNone
401UnauthorizedNone
403ForbiddenNone

Example HTTP request

Request path

/v1/logs/{logging_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = loggingaudit 1.1"

Example HTTP response

Response 200

{
    "log": {
        "account_id": "ACCOUNT_ID-ABCDEF1234",
        "details": "",
        "event_name": "scp-extension.event.create",
        "event_type": "scp-extension.event.create",
        "id": "ID-A1B2C3D4E5F6G7H8I9J0",
        "product_name": "scp-extension",
        "product_type": "scp-extension",
        "region": "RegionOne",
        "request_user_name": "Hong Gildong",
        "resource_id": "RESOURCE_ID-ABCDEF1234",
        "resource_name": "RESOURCE_NAME-ABCDEF1234",
        "resource_type": "scp-extension",
        "role_name": "Tester",
        "status": "Success",
        "timestamp": "2025-11-07T10:00:00Z",
        "type": "ROLE",
        "user_id": "USER_ID-ABCDEF1234"
    }
}

7.2 - 1.0

get /v1/logs/{logging_id}

Description

show a specific log

상태 ACTIVE (DEPRECATED)

버전최소 지원 보장일
1.020260223

Parameters

TypeNameDescriptionSchemaDefault
pathlogging_id
required		Log ID
Example :
stringNone

Responses

HTTP CodeDescriptionSchema
200OKLogShowResponse
400Bad RequestNone
401UnauthorizedNone
403ForbiddenNone

Example HTTP request

Request path

/v1/logs/{logging_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = loggingaudit 1.0"

Example HTTP response

Response 200

{
    "log": {
        "account_id": "ACCOUNT_ID-ABCDEF1234",
        "details": "",
        "event_name": "scp-extension.event.create",
        "event_type": "scp-extension.event.create",
        "id": "ID-A1B2C3D4E5F6G7H8I9J0",
        "product_name": "scp-extension",
        "product_type": "scp-extension",
        "region": "RegionOne",
        "request_user_name": "Hong Gildong",
        "resource_id": "RESOURCE_ID-ABCDEF1234",
        "resource_name": "RESOURCE_NAME-ABCDEF1234",
        "resource_type": "scp-extension",
        "role_name": "Tester",
        "status": "Success",
        "timestamp": "2025-11-07T10:00:00Z",
        "type": "ROLE",
        "user_id": "USER_ID-ABCDEF1234"
    }
}

8 - ShowTrail

8.1 - 1.1

get /v1/trails/{trail_id}

Description

show a specific trail

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.1-

Parameters

TypeNameDescriptionSchemaDefault
pathtrail_id
required		Trail ID
Example :
any of [string, null]None

Responses

HTTP CodeDescriptionSchema
200OKTrailShowResponseV1dot1
400Bad RequestNone
401UnauthorizedNone
403ForbiddenNone

Example HTTP request

Request path

/v1/trails/{trail_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = loggingaudit 1.1"

Example HTTP response

Response 200

{
    "trail": {
        "account_id": "ACCOUNT_ID-ABCDEF1234",
        "account_name": "Test Account",
        "bucket_name": "Bucket001",
        "bucket_region": "RegionOne",
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "created_user_id": "kim.samsung@samsung.com",
        "del_yn": "N",
        "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
        "log_archive_account_id": "ACCOUNT_ID-ABCDEF1234",
        "log_type_total_yn": "Y",
        "log_verification_yn": "N",
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "organization_trail_yn": "Y",
        "region_names": [],
        "region_total_yn": "Y",
        "resource_type_total_yn": "Y",
        "state": "ACTIVE",
        "target_log_types": [],
        "target_resource_types": [],
        "target_users": [],
        "trail_batch_end_at": "2025-11-07T09:00:00Z",
        "trail_batch_first_start_at": "2025-10-28T10:00:00Z",
        "trail_batch_last_state": "success",
        "trail_batch_start_at": "2025-11-07T09:00:00Z",
        "trail_batch_success_at": "2025-11-07T09:00:00Z",
        "trail_description": "test trail",
        "trail_name": "Trail-0001",
        "trail_save_type": "JSON",
        "user_total_yn": "Y"
    }
}

8.2 - 1.0

get /v1/trails/{trail_id}

Description

show a specific trail

상태 ACTIVE (DEPRECATED)

버전최소 지원 보장일
1.020260223

Parameters

TypeNameDescriptionSchemaDefault
pathtrail_id
required		Trail ID
Example :
any of [string, null]None

Responses

HTTP CodeDescriptionSchema
200OKTrailShowResponse
400Bad RequestNone
401UnauthorizedNone
403ForbiddenNone

Example HTTP request

Request path

/v1/trails/{trail_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = loggingaudit 1.0"

Example HTTP response

Response 200

{
    "trail": {
        "account_id": "ACCOUNT_ID-ABCDEF1234",
        "account_name": "Test Account",
        "bucket_name": "Bucket001",
        "bucket_region": "RegionOne",
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "created_user_id": "kim.samsung@samsung.com",
        "del_yn": "N",
        "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
        "log_type_total_yn": "Y",
        "log_verification_yn": "N",
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "region_names": [],
        "region_total_yn": "Y",
        "resource_type_total_yn": "Y",
        "state": "ACTIVE",
        "target_log_types": [],
        "target_resource_types": [],
        "target_users": [],
        "trail_batch_end_at": "2025-11-07T09:00:00Z",
        "trail_batch_first_start_at": "2025-10-28T10:00:00Z",
        "trail_batch_last_state": "success",
        "trail_batch_start_at": "2025-11-07T09:00:00Z",
        "trail_batch_success_at": "2025-11-07T09:00:00Z",
        "trail_description": "test trail",
        "trail_name": "Trail-0001",
        "trail_save_type": "JSON",
        "user_total_yn": "Y"
    }
}

9 - StartTrail

9.1 - 1.1

post /v1/trails/{trail_id}/start

Description

start a specific trail

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.1-

Parameters

TypeNameDescriptionSchemaDefault
pathtrail_id
required		Trail ID
Example :
any of [string, null]None

Responses

HTTP CodeDescriptionSchema
200OKTrailShowResponseV1dot1
401UnauthorizedNone
403ForbiddenNone

Example HTTP request

Request path

/v1/trails/{trail_id}/start

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = loggingaudit 1.1"

Example HTTP response

Response 200

{
    "trail": {
        "account_id": "ACCOUNT_ID-ABCDEF1234",
        "account_name": "Test Account",
        "bucket_name": "Bucket001",
        "bucket_region": "RegionOne",
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "created_user_id": "kim.samsung@samsung.com",
        "del_yn": "N",
        "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
        "log_archive_account_id": "ACCOUNT_ID-ABCDEF1234",
        "log_type_total_yn": "Y",
        "log_verification_yn": "N",
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "organization_trail_yn": "Y",
        "region_names": [],
        "region_total_yn": "Y",
        "resource_type_total_yn": "Y",
        "state": "ACTIVE",
        "target_log_types": [],
        "target_resource_types": [],
        "target_users": [],
        "trail_batch_end_at": "2025-11-07T09:00:00Z",
        "trail_batch_first_start_at": "2025-10-28T10:00:00Z",
        "trail_batch_last_state": "success",
        "trail_batch_start_at": "2025-11-07T09:00:00Z",
        "trail_batch_success_at": "2025-11-07T09:00:00Z",
        "trail_description": "test trail",
        "trail_name": "Trail-0001",
        "trail_save_type": "JSON",
        "user_total_yn": "Y"
    }
}

9.2 - 1.0

post /v1/trails/{trail_id}/start

Description

start a specific trail

상태 ACTIVE (DEPRECATED)

버전최소 지원 보장일
1.020260223

Parameters

TypeNameDescriptionSchemaDefault
pathtrail_id
required		Trail ID
Example :
any of [string, null]None

Responses

HTTP CodeDescriptionSchema
200OKTrailShowResponse
401UnauthorizedNone
403ForbiddenNone

Example HTTP request

Request path

/v1/trails/{trail_id}/start

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = loggingaudit 1.0"

Example HTTP response

Response 200

{
    "trail": {
        "account_id": "ACCOUNT_ID-ABCDEF1234",
        "account_name": "Test Account",
        "bucket_name": "Bucket001",
        "bucket_region": "RegionOne",
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "created_user_id": "kim.samsung@samsung.com",
        "del_yn": "N",
        "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
        "log_type_total_yn": "Y",
        "log_verification_yn": "N",
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "region_names": [],
        "region_total_yn": "Y",
        "resource_type_total_yn": "Y",
        "state": "ACTIVE",
        "target_log_types": [],
        "target_resource_types": [],
        "target_users": [],
        "trail_batch_end_at": "2025-11-07T09:00:00Z",
        "trail_batch_first_start_at": "2025-10-28T10:00:00Z",
        "trail_batch_last_state": "success",
        "trail_batch_start_at": "2025-11-07T09:00:00Z",
        "trail_batch_success_at": "2025-11-07T09:00:00Z",
        "trail_description": "test trail",
        "trail_name": "Trail-0001",
        "trail_save_type": "JSON",
        "user_total_yn": "Y"
    }
}

10 - StopTrail

10.1 - 1.1

post /v1/trails/{trail_id}/stop

Description

stop a specific trail

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.1-

Parameters

TypeNameDescriptionSchemaDefault
pathtrail_id
required		Trail ID
Example :
any of [string, null]None

Responses

HTTP CodeDescriptionSchema
200OKTrailShowResponseV1dot1
401UnauthorizedNone
403ForbiddenNone

Example HTTP request

Request path

/v1/trails/{trail_id}/stop

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = loggingaudit 1.1"

Example HTTP response

Response 200

{
    "trail": {
        "account_id": "ACCOUNT_ID-ABCDEF1234",
        "account_name": "Test Account",
        "bucket_name": "Bucket001",
        "bucket_region": "RegionOne",
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "created_user_id": "kim.samsung@samsung.com",
        "del_yn": "N",
        "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
        "log_archive_account_id": "ACCOUNT_ID-ABCDEF1234",
        "log_type_total_yn": "Y",
        "log_verification_yn": "N",
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "organization_trail_yn": "Y",
        "region_names": [],
        "region_total_yn": "Y",
        "resource_type_total_yn": "Y",
        "state": "ACTIVE",
        "target_log_types": [],
        "target_resource_types": [],
        "target_users": [],
        "trail_batch_end_at": "2025-11-07T09:00:00Z",
        "trail_batch_first_start_at": "2025-10-28T10:00:00Z",
        "trail_batch_last_state": "success",
        "trail_batch_start_at": "2025-11-07T09:00:00Z",
        "trail_batch_success_at": "2025-11-07T09:00:00Z",
        "trail_description": "test trail",
        "trail_name": "Trail-0001",
        "trail_save_type": "JSON",
        "user_total_yn": "Y"
    }
}

10.2 - 1.0

post /v1/trails/{trail_id}/stop

Description

stop a specific trail

상태 ACTIVE (DEPRECATED)

버전최소 지원 보장일
1.020260223

Parameters

TypeNameDescriptionSchemaDefault
pathtrail_id
required		Trail ID
Example :
any of [string, null]None

Responses

HTTP CodeDescriptionSchema
200OKTrailShowResponse
401UnauthorizedNone
403ForbiddenNone

Example HTTP request

Request path

/v1/trails/{trail_id}/stop

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = loggingaudit 1.0"

Example HTTP response

Response 200

{
    "trail": {
        "account_id": "ACCOUNT_ID-ABCDEF1234",
        "account_name": "Test Account",
        "bucket_name": "Bucket001",
        "bucket_region": "RegionOne",
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "created_user_id": "kim.samsung@samsung.com",
        "del_yn": "N",
        "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
        "log_type_total_yn": "Y",
        "log_verification_yn": "N",
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "region_names": [],
        "region_total_yn": "Y",
        "resource_type_total_yn": "Y",
        "state": "ACTIVE",
        "target_log_types": [],
        "target_resource_types": [],
        "target_users": [],
        "trail_batch_end_at": "2025-11-07T09:00:00Z",
        "trail_batch_first_start_at": "2025-10-28T10:00:00Z",
        "trail_batch_last_state": "success",
        "trail_batch_start_at": "2025-11-07T09:00:00Z",
        "trail_batch_success_at": "2025-11-07T09:00:00Z",
        "trail_description": "test trail",
        "trail_name": "Trail-0001",
        "trail_save_type": "JSON",
        "user_total_yn": "Y"
    }
}