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

APIs

1: Check Backup Master Connection State

1.1: 1.3
1.2: 1.2
1.3: 1.1
1.4: 1.0

2: Check Backup Name Duplicate

2.1: 1.3
2.2: 1.2
2.3: 1.1
2.4: 1.0

3: Check Backup Restore Server Name Duplicate

3.1: 1.3
3.2: 1.2
3.3: 1.1
3.4: 1.0

4: Check Filesystem Path Duplication

4.1: 1.3
4.2: 1.2
4.3: 1.1
4.4: 1.0

5: Create Backup

5.1: 1.3
5.2: 1.2
5.3: 1.1
5.4: 1.0

6: Create Backup Agent

6.1: 1.3
6.2: 1.2
6.3: 1.1
6.4: 1.0

7: Delete Backup

7.1: 1.3
7.2: 1.2
7.3: 1.1
7.4: 1.0

8: Delete Backup Agent

8.1: 1.3
8.2: 1.2
8.3: 1.1
8.4: 1.0

9: Delete Backup Restore Target

9.1: 1.3
9.2: 1.2
9.3: 1.1
9.4: 1.0

10: List Agent Backup Restore Target Servers

10.1: 1.3
10.2: 1.2
10.3: 1.1
10.4: 1.0

11: List Backup Agents

11.1: 1.3
11.2: 1.2
11.3: 1.1
11.4: 1.0

12: List Backup Histories

12.1: 1.3
12.2: 1.2
12.3: 1.1
12.4: 1.0

13: List Backup Region Relationship

13.1: 1.3
13.2: 1.2
13.3: 1.1
13.4: 1.0

14: List Backup Restore Histories

14.1: 1.3
14.2: 1.2
14.3: 1.1
14.4: 1.0

15: List Backup Restore Subnets

15.1: 1.3
15.2: 1.2
15.3: 1.1
15.4: 1.0

16: List Backup Restore Targets

16.1: 1.3
16.2: 1.2
16.3: 1.1
16.4: 1.0

17: List Backup Schedules

17.1: 1.3
17.2: 1.2
17.3: 1.1
17.4: 1.0

18: List Backup Targets

18.1: 1.3
18.2: 1.2
18.3: 1.1
18.4: 1.0

19: List Backups

19.1: 1.3
19.2: 1.2
19.3: 1.1
19.4: 1.0

20: List Filesystem Path

20.1: 1.3
20.2: 1.2

21: List Targets of Backup Agent

21.1: 1.3
21.2: 1.2
21.3: 1.1
21.4: 1.0

22: Manual Backup

22.1: 1.3
22.2: 1.2
22.3: 1.1
22.4: 1.0

23: Restore Agent Backup

23.1: 1.3
23.2: 1.2
23.3: 1.1
23.4: 1.0

24: Restore Backup

24.1: 1.3
24.2: 1.2
24.3: 1.1
24.4: 1.0

25: Set Backup Schedule

25.1: 1.3
25.2: 1.2
25.3: 1.1
25.4: 1.0

26: Set Filesystem Path

26.1: 1.3
26.2: 1.2
26.3: 1.1
26.4: 1.0

27: Show Backup

27.1: 1.3
27.2: 1.2
27.3: 1.1
27.4: 1.0

28: Show Backup Agent

28.1: 1.3
28.2: 1.2
28.3: 1.1
28.4: 1.0

29: Show Backup Agent Install File Path

29.1: 1.3
29.2: 1.2
29.3: 1.1
29.4: 1.0

30: Update Replication Use

30.1: 1.3
30.2: 1.2
30.3: 1.1
30.4: 1.0

31: Update Retention Period

31.1: 1.3
31.2: 1.2
31.3: 1.1
31.4: 1.0

1 - Check Backup Master Connection State

1.1 - 1.3

get /v1/backup-agents/{backup_agent_id}/check-connection-state

Description

백업 마스터 연결 상태 확인

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	backup_agent_id required	Backup Agent ID Example : `BACKUP_AGENT-abcd`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	AsyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backup-agents/{backup_agent_id}/check-connection-state

Request header

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

Example HTTP response

Response 202

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

1.2 - 1.2

get /v1/backup-agents/{backup_agent_id}/check-connection-state

Description

백업 마스터 연결 상태 확인

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.2	20261231

Parameters

Type	Name	Description	Schema	Default
path	backup_agent_id required	Backup Agent ID Example : `BACKUP_AGENT-abcd`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	AsyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backup-agents/{backup_agent_id}/check-connection-state

Request header

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

Example HTTP response

Response 202

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

1.3 - 1.1

get /v1/backup-agents/{backup_agent_id}/check-connection-state

Description

백업 마스터 연결 상태 확인

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	backup_agent_id required	Backup Agent ID Example : `BACKUP_AGENT-abcd`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	AsyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backup-agents/{backup_agent_id}/check-connection-state

Request header

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

Example HTTP response

Response 202

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

1.4 - 1.0

get /v1/backup-agents/{backup_agent_id}/check-connection-state

Description

백업 마스터 연결 상태 확인

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.0	20260331

Parameters

Type	Name	Description	Schema	Default
path	backup_agent_id required	Backup Agent ID Example : `BACKUP_AGENT-abcd`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	AsyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backup-agents/{backup_agent_id}/check-connection-state

Request header

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

Example HTTP response

Response 202

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

2 - Check Backup Name Duplicate

2.1 - 1.3

get /v1/backups/check-name-duplication

Description

Backup명을 중복 체크한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
query	backup_name required	Backup명 Example : `backup-001`	string	None

Responses

HTTP Code	Description	Schema
200	OK	BackupNameDuplicateResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/check-name-duplication?backup_name={backup_name}

Request header

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

Example HTTP response

Response 200

{
    "result": true
}

2.2 - 1.2

get /v1/backups/check-name-duplication

Description

Backup명을 중복 체크한다.

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.2	20261231

Parameters

Type	Name	Description	Schema	Default
query	backup_name required	Backup명 Example : `backup-001`	string	None

Responses

HTTP Code	Description	Schema
200	OK	BackupNameDuplicateResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/check-name-duplication?backup_name={backup_name}

Request header

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

Example HTTP response

Response 200

{
    "result": true
}

2.3 - 1.1

get /v1/backups/check-name-duplication

Description

Backup명을 중복 체크한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
query	backup_name required	Backup명 Example : `backup-001`	string	None

Responses

HTTP Code	Description	Schema
200	OK	BackupNameDuplicateResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/check-name-duplication?backup_name={backup_name}

Request header

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

Example HTTP response

Response 200

{
    "result": true
}

2.4 - 1.0

get /v1/backups/check-name-duplication

Description

Backup명을 중복 체크한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.0	20260331

Parameters

Type	Name	Description	Schema	Default
query	backup_name required	Backup명 Example : `backup-001`	string	None

Responses

HTTP Code	Description	Schema
200	OK	BackupNameDuplicateResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/check-name-duplication?backup_name={backup_name}

Request header

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

Example HTTP response

Response 200

{
    "result": true
}

3 - Check Backup Restore Server Name Duplicate

3.1 - 1.3

get /v1/backups/restore/check-name-duplication

Description

복구 서버명을 중복 체크한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
query	restore_server_name required	복구 서버명 Example : `restoretest1`	string	None

Responses

HTTP Code	Description	Schema
200	OK	BackupRestoreServerNameDuplicateResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/restore/check-name-duplication?restore_server_name={restore_server_name}

Request header

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

Example HTTP response

Response 200

{
    "result": true
}

3.2 - 1.2

get /v1/backups/restore/check-name-duplication

Description

복구 서버명을 중복 체크한다.

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.2	20261231

Parameters

Type	Name	Description	Schema	Default
query	restore_server_name required	복구 서버명 Example : `restoretest1`	string	None

Responses

HTTP Code	Description	Schema
200	OK	BackupRestoreServerNameDuplicateResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/restore/check-name-duplication?restore_server_name={restore_server_name}

Request header

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

Example HTTP response

Response 200

{
    "result": true
}

3.3 - 1.1

get /v1/backups/restore/check-name-duplication

Description

복구 서버명을 중복 체크한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
query	restore_server_name required	복구 서버명 Example : `restoretest1`	string	None

Responses

HTTP Code	Description	Schema
200	OK	BackupRestoreServerNameDuplicateResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/restore/check-name-duplication?restore_server_name={restore_server_name}

Request header

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

Example HTTP response

Response 200

{
    "result": true
}

3.4 - 1.0

get /v1/backups/restore/check-name-duplication

Description

복구 서버명을 중복 체크한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.0	20260331

Parameters

Type	Name	Description	Schema	Default
query	restore_server_name required	복구 서버명 Example : `restoretest1`	string	None

Responses

HTTP Code	Description	Schema
200	OK	BackupRestoreServerNameDuplicateResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/restore/check-name-duplication?restore_server_name={restore_server_name}

Request header

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

Example HTTP response

Response 200

{
    "result": true
}

4 - Check Filesystem Path Duplication

4.1 - 1.3

get /v1/backups/check-filesystem-duplication

Description

Filesystem 경로 중복 체크

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
query	filesystem_path required	백업 대상 파일 시스템 경로 Example : `/aaa`	string	None
query	server_uuid required	Backup 서버 UUID Example : `89f5ef44-1021-4a5c-8e06-fbb289eac366`	string	None

Responses

HTTP Code	Description	Schema
200	OK	CheckFileSystemDuplicationResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/check-filesystem-duplication?filesystem_path={filesystem_path}&server_uuid={server_uuid}

Request header

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

Example HTTP response

Response 200

{
    "result": true
}

4.2 - 1.2

get /v1/backups/check-filesystem-duplication

Description

Filesystem 경로 중복 체크

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.2	20261231

Parameters

Type	Name	Description	Schema	Default
query	filesystem_path required	백업 대상 파일 시스템 경로 Example : `/aaa`	string	None
query	server_uuid required	Backup 서버 UUID Example : `89f5ef44-1021-4a5c-8e06-fbb289eac366`	string	None

Responses

HTTP Code	Description	Schema
200	OK	CheckFileSystemDuplicationResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/check-filesystem-duplication?filesystem_path={filesystem_path}&server_uuid={server_uuid}

Request header

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

Example HTTP response

Response 200

{
    "result": true
}

4.3 - 1.1

get /v1/backups/check-filesystem-duplication

Description

Filesystem 경로 중복 체크

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
query	filesystem_path required	백업 대상 파일 시스템 경로 Example : `/aaa`	string	None
query	server_uuid required	Backup 서버 UUID Example : `89f5ef44-1021-4a5c-8e06-fbb289eac366`	string	None

Responses

HTTP Code	Description	Schema
200	OK	CheckFileSystemDuplicationResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/check-filesystem-duplication?filesystem_path={filesystem_path}&server_uuid={server_uuid}

Request header

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

Example HTTP response

Response 200

{
    "result": true
}

4.4 - 1.0

get /v1/backups/check-filesystem-duplication

Description

Filesystem 경로 중복 체크

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.0	20260331

Parameters

Type	Name	Description	Schema	Default
query	filesystem_path required	백업 대상 파일 시스템 경로 Example : `/aaa`	string	None
query	server_uuid required	Backup 서버 UUID Example : `89f5ef44-1021-4a5c-8e06-fbb289eac366`	string	None

Responses

HTTP Code	Description	Schema
200	OK	CheckFileSystemDuplicationResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/check-filesystem-duplication?filesystem_path={filesystem_path}&server_uuid={server_uuid}

Request header

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

Example HTTP response

Response 200

{
    "result": true
}

5 - Create Backup

5.1 - 1.3

post /v1/backups

Description

Backup을 생성한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
body	body required		BackupCreateRequest1Dot3

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups

Request header

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

Request body

{
    "dr_enabled": false,
    "encrypt_enabled": true,
    "filesystem_paths": [
        "/aaa",
        "/bbb"
    ],
    "is_all_filesystem": false,
    "name": "backup-001",
    "policy_category": "AGENTLESS",
    "policy_type": "VM_IMAGE",
    "region": "kr-west1",
    "retention_period": "WEEK_2",
    "schedules": [
        {
            "frequency": "DAILY",
            "start_day": "MON",
            "start_time": "09:00:00",
            "start_week": "WEEK_2",
            "type": "FULL"
        }
    ],
    "server_category": "VIRTUAL_SERVER | GPU_SERVER | BAREMETAL_SERVER",
    "server_guid": "9ab33c66-3dbd-46cd-b0af-abccd3eb3170",
    "server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366",
    "tags": [
        {
            "key": "",
            "value": ""
        }
    ],
    "zone": ""
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

5.2 - 1.2

post /v1/backups

Description

Backup을 생성한다.

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.2	20261231

Parameters

Type	Name	Description	Schema	Default
body	body required		BackupCreateRequest1Dot2

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups

Request header

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

Request body

{
    "dr_enabled": false,
    "encrypt_enabled": true,
    "filesystem_paths": [
        "/aaa",
        "/bbb"
    ],
    "is_all_filesystem": false,
    "name": "backup-001",
    "policy_category": "AGENTLESS",
    "policy_type": "VM_IMAGE",
    "region": "kr-west1",
    "retention_period": "WEEK_2",
    "schedules": [
        {
            "frequency": "DAILY",
            "start_day": "MON",
            "start_time": "09:00:00",
            "start_week": "WEEK_2",
            "type": "FULL"
        }
    ],
    "server_category": "VIRTUAL_SERVER | GPU_SERVER | BAREMETAL_SERVER",
    "server_guid": "9ab33c66-3dbd-46cd-b0af-abccd3eb3170",
    "server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366",
    "tags": [
        {
            "key": "",
            "value": ""
        }
    ]
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

5.3 - 1.1

post /v1/backups

Description

Backup을 생성한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
body	body required		BackupCreateRequest1Dot1

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups

Request header

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

Request body

{
    "dr_enabled": false,
    "encrypt_enabled": true,
    "filesystem_paths": [
        "/aaa",
        "/bbb"
    ],
    "name": "backup-001",
    "policy_category": "AGENTLESS",
    "policy_type": "VM_IMAGE",
    "region": "kr-west1",
    "retention_period": "WEEK_2",
    "schedules": [
        {
            "frequency": "DAILY",
            "start_day": "MON",
            "start_time": "09:00:00",
            "start_week": "WEEK_2",
            "type": "FULL"
        }
    ],
    "server_category": "VIRTUAL_SERVER | GPU_SERVER | BAREMETAL_SERVER",
    "server_guid": "9ab33c66-3dbd-46cd-b0af-abccd3eb3170",
    "server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366",
    "tags": [
        {
            "key": "",
            "value": ""
        }
    ]
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

5.4 - 1.0

post /v1/backups

Description

Backup을 생성한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.0	20260331

Parameters

Type	Name	Description	Schema	Default
body	body required		BackupCreateRequest

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups

Request header

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

Request body

{
    "encrypt_enabled": true,
    "filesystem_paths": [
        "/aaa",
        "/bbb"
    ],
    "name": "backup-001",
    "policy_category": "AGENTLESS",
    "policy_type": "VM_IMAGE",
    "region": "kr-west1",
    "retention_period": "WEEK_2",
    "schedules": [
        {
            "frequency": "DAILY",
            "start_day": "MON",
            "start_time": "09:00:00",
            "start_week": "WEEK_2",
            "type": "FULL"
        }
    ],
    "server_category": "VIRTUAL_SERVER | GPU_SERVER | BAREMETAL_SERVER",
    "server_guid": "9ab33c66-3dbd-46cd-b0af-abccd3eb3170",
    "server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366",
    "tags": [
        {
            "key": "",
            "value": ""
        }
    ]
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

6 - Create Backup Agent

6.1 - 1.3

post /v1/backup-agents

Description

Backup Agent을 생성한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
body	body required		BackupAgentCreateRequest1Dot3

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
202	Accepted	AsyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backup-agents

Request header

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

Request body

{
    "server_backup_agent_ip": "11.22.33.44",
    "server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366",
    "subnet_id": "023c57b14f11483689338d085e061492",
    "tags": [
        {
            "key": "",
            "value": ""
        }
    ],
    "zone": "kr-west1-a"
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

6.2 - 1.2

post /v1/backup-agents

Description

Backup Agent을 생성한다.

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.2	20261231

Parameters

Type	Name	Description	Schema	Default
body	body required		BackupAgentCreateRequest1Dot2

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
202	Accepted	AsyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backup-agents

Request header

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

Request body

{
    "server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366",
    "subnet_id": "023c57b14f11483689338d085e061492",
    "tags": [
        {
            "key": "",
            "value": ""
        }
    ]
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

6.3 - 1.1

post /v1/backup-agents

Description

Backup Agent을 생성한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
body	body required		BackupAgentCreateRequest

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backup-agents

Request header

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

Request body

{
    "server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366",
    "tags": [
        {
            "key": "",
            "value": ""
        }
    ]
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

6.4 - 1.0

post /v1/backup-agents

Description

Backup Agent을 생성한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.0	20260331

Parameters

Type	Name	Description	Schema	Default
body	body required		BackupAgentCreateRequest

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backup-agents

Request header

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

Request body

{
    "server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366",
    "tags": [
        {
            "key": "",
            "value": ""
        }
    ]
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

7 - Delete Backup

7.1 - 1.3

delete /v1/backups/{backup_id}

Description

Backup을 해지한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_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 = backup 1.3"

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

7.2 - 1.2

delete /v1/backups/{backup_id}

Description

Backup을 해지한다.

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.2	20261231

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_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 = backup 1.2"

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

7.3 - 1.1

delete /v1/backups/{backup_id}

Description

Backup을 해지한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_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 = backup 1.1"

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

7.4 - 1.0

delete /v1/backups/{backup_id}

Description

Backup을 해지한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.0	20260331

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_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 = backup 1.0"

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

8 - Delete Backup Agent

8.1 - 1.3

delete /v1/backup-agents/{backup_agent_id}

Description

Backup Agent를 해지한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	backup_agent_id required	Backup Agent ID Example : `BACKUP_AGENT-abcd`	string	None

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
202	Accepted	AsyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backup-agents/{backup_agent_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 = backup 1.3"

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

8.2 - 1.2

delete /v1/backup-agents/{backup_agent_id}

Description

Backup Agent를 해지한다.

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.2	20261231

Parameters

Type	Name	Description	Schema	Default
path	backup_agent_id required	Backup Agent ID Example : `BACKUP_AGENT-abcd`	string	None

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
202	Accepted	AsyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backup-agents/{backup_agent_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 = backup 1.2"

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

8.3 - 1.1

delete /v1/backup-agents/{backup_agent_id}

Description

Backup Agent를 해지한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	backup_agent_id required	Backup Agent ID Example : `BACKUP_AGENT-abcd`	string	None

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backup-agents/{backup_agent_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 = backup 1.1"

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

8.4 - 1.0

delete /v1/backup-agents/{backup_agent_id}

Description

Backup Agent를 해지한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.0	20260331

Parameters

Type	Name	Description	Schema	Default
path	backup_agent_id required	Backup Agent ID Example : `BACKUP_AGENT-abcd`	string	None

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backup-agents/{backup_agent_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 = backup 1.0"

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

9 - Delete Backup Restore Target

9.1 - 1.3

delete /v1/backups/{backup_id}/restore-targets

Description

복구 대상을 삭제한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
body	body required		BackupRestoreTargetDeleteRequest

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/restore-targets

Request header

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

Request body

{
    "restore_target_ids": [
        "ca1a8e76-af49-40ea-93f8-a5989ffe138b"
    ]
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

9.2 - 1.2

delete /v1/backups/{backup_id}/restore-targets

Description

복구 대상을 삭제한다.

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.2	20261231

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
body	body required		BackupRestoreTargetDeleteRequest

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/restore-targets

Request header

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

Request body

{
    "restore_target_ids": [
        "ca1a8e76-af49-40ea-93f8-a5989ffe138b"
    ]
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

9.3 - 1.1

delete /v1/backups/{backup_id}/restore-targets

Description

복구 대상을 삭제한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
body	body required		BackupRestoreTargetDeleteRequest

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/restore-targets

Request header

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

Request body

{
    "restore_target_ids": [
        "ca1a8e76-af49-40ea-93f8-a5989ffe138b"
    ]
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

9.4 - 1.0

delete /v1/backups/{backup_id}/restore-targets

Description

복구 대상을 삭제한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.0	20260331

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
body	body required		BackupRestoreTargetDeleteRequest

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/restore-targets

Request header

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

Request body

{
    "restore_target_ids": [
        "ca1a8e76-af49-40ea-93f8-a5989ffe138b"
    ]
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

10 - List Agent Backup Restore Target Servers

10.1 - 1.3

get /v1/backups/{backup_id}/agent-backup-restore-targets

Description

복구 대상 목록을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
query	server_name optional	Backup 서버명 Example : `server-001`	any of [string, null]	None
query	page optional	페이지 Example : `0`	any of [integer, null]	0
query	size optional	항목 수 Example : `20`	any of [integer, null]	5

Responses

HTTP Code	Description	Schema
200	OK	AgentBackupRestoreTargetServerListResponse1Dot2
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/agent-backup-restore-targets

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "server_name": "server-001",
            "server_os_version": "UBUNTU 22.04",
            "server_type": "s1v1m2",
            "server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366"
        }
    ],
    "count": 1
}

10.2 - 1.2

get /v1/backups/{backup_id}/agent-backup-restore-targets

Description

복구 대상 목록을 조회한다.

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.2	20261231

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
query	server_name optional	Backup 서버명 Example : `server-001`	any of [string, null]	None
query	page optional	페이지 Example : `0`	any of [integer, null]	0
query	size optional	항목 수 Example : `20`	any of [integer, null]	5

Responses

HTTP Code	Description	Schema
200	OK	AgentBackupRestoreTargetServerListResponse1Dot2
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/agent-backup-restore-targets

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "server_name": "server-001",
            "server_os_version": "UBUNTU 22.04",
            "server_type": "s1v1m2",
            "server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366"
        }
    ],
    "count": 1
}

10.3 - 1.1

get /v1/backups/{backup_id}/agent-backup-restore-targets

Description

복구 대상 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
query	server_name optional	Backup 서버명 Example : `server-001`	any of [string, null]	None
query	page optional	페이지 Example : `0`	any of [integer, null]	0
query	size optional	항목 수 Example : `20`	any of [integer, null]	5

Responses

HTTP Code	Description	Schema
200	OK	AgentBackupRestoreTargetServerListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/agent-backup-restore-targets

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "server_name": "server-001",
            "server_os_version": "UBUNTU 22.04",
            "server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366"
        }
    ],
    "count": 1
}

10.4 - 1.0

get /v1/backups/{backup_id}/agent-backup-restore-targets

Description

복구 대상 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.0	20260331

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
query	server_name optional	Backup 서버명 Example : `server-001`	any of [string, null]	None
query	page optional	페이지 Example : `0`	any of [integer, null]	0
query	size optional	항목 수 Example : `20`	any of [integer, null]	5

Responses

HTTP Code	Description	Schema
200	OK	AgentBackupRestoreTargetServerListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/agent-backup-restore-targets

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "server_name": "server-001",
            "server_os_version": "UBUNTU 22.04",
            "server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366"
        }
    ],
    "count": 1
}

11 - List Backup Agents

11.1 - 1.3

get /v1/backup-agents

Description

Backup 대상 목록을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
query	size optional	size Example : `20`	any of [integer, null]	20
query	page optional	page Example : `0`	any of [integer, null]	0
query	sort optional	sort Example : `created_at:desc`	any of [string, null]	None
query	name optional	Backup Agent명 Example : `agent_abcd12`	any of [string, null]	None
query	server_backup_agent_ip optional	대상 서버 Backup Agent IP Example : `11.22.33.44`	any of [string, null]	None
query	server_name optional	Backup Agent 대상 서버명 Example : `server-001`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	BackupAgentListResponse1Dot2
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backup-agents

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "account_id": "fnsd89fus0f9ds09f90dshf9dshfds09",
            "backup_policy_count": "3",
            "connection_state": "SUCCESS",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "id": "BACKUP_AGENT-abcd",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "agent_abcd12",
            "server_backup_agent_ip": "11.22.33.44",
            "server_category": "VIRTUAL_SERVER | GPU_SERVER | BAREMETAL_SERVER",
            "server_name": "server-001",
            "state": "AVAILABLE"
        }
    ],
    "count": 1
}

11.2 - 1.2

get /v1/backup-agents

Description

Backup 대상 목록을 조회한다.

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.2	20261231

Parameters

Type	Name	Description	Schema	Default
query	size optional	size Example : `20`	any of [integer, null]	20
query	page optional	page Example : `0`	any of [integer, null]	0
query	sort optional	sort Example : `created_at:desc`	any of [string, null]	None
query	name optional	Backup Agent명 Example : `agent_abcd12`	any of [string, null]	None
query	server_backup_agent_ip optional	대상 서버 Backup Agent IP Example : `11.22.33.44`	any of [string, null]	None
query	server_name optional	Backup Agent 대상 서버명 Example : `server-001`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	BackupAgentListResponse1Dot2
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backup-agents

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "account_id": "fnsd89fus0f9ds09f90dshf9dshfds09",
            "backup_policy_count": "3",
            "connection_state": "SUCCESS",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "id": "BACKUP_AGENT-abcd",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "agent_abcd12",
            "server_backup_agent_ip": "11.22.33.44",
            "server_category": "VIRTUAL_SERVER | GPU_SERVER | BAREMETAL_SERVER",
            "server_name": "server-001",
            "state": "AVAILABLE"
        }
    ],
    "count": 1
}

11.3 - 1.1

get /v1/backup-agents

Description

Backup 대상 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
query	size optional	size Example : `20`	any of [integer, null]	20
query	page optional	page Example : `0`	any of [integer, null]	0
query	sort optional	sort Example : `created_at:desc`	any of [string, null]	None
query	name optional	Backup Agent명 Example : `agent_abcd12`	any of [string, null]	None
query	server_backup_agent_ip optional	대상 서버 Backup Agent IP Example : `11.22.33.44`	any of [string, null]	None
query	server_name optional	Backup Agent 대상 서버명 Example : `server-001`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	BackupAgentListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backup-agents

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "account_id": "fnsd89fus0f9ds09f90dshf9dshfds09",
            "backup_policy_count": "3",
            "connection_state": "SUCCESS",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "id": "BACKUP_AGENT-abcd",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "agent_abcd12",
            "server_backup_agent_ip": "11.22.33.44",
            "server_name": "server-001",
            "state": "AVAILABLE"
        }
    ],
    "count": 1
}

11.4 - 1.0

get /v1/backup-agents

Description

Backup 대상 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.0	20260331

Parameters

Type	Name	Description	Schema	Default
query	size optional	size Example : `20`	any of [integer, null]	20
query	page optional	page Example : `0`	any of [integer, null]	0
query	sort optional	sort Example : `created_at:desc`	any of [string, null]	None
query	name optional	Backup Agent명 Example : `agent_abcd12`	any of [string, null]	None
query	server_backup_agent_ip optional	대상 서버 Backup Agent IP Example : `11.22.33.44`	any of [string, null]	None
query	server_name optional	Backup Agent 대상 서버명 Example : `server-001`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	BackupAgentListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backup-agents

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "account_id": "fnsd89fus0f9ds09f90dshf9dshfds09",
            "backup_policy_count": "3",
            "connection_state": "SUCCESS",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "id": "BACKUP_AGENT-abcd",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "agent_abcd12",
            "server_backup_agent_ip": "11.22.33.44",
            "server_name": "server-001",
            "state": "AVAILABLE"
        }
    ],
    "count": 1
}

12 - List Backup Histories

12.1 - 1.3

get /v1/backups/{backup_id}/backup-histories

Description

Backup 이력을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
query	backup_start_time optional	시작 일시 Example : `2024-09-30T15:00:00Z`	any of [string (date-time), null]	None
query	backup_end_time optional	검색 종료 일시 Example : `2024-10-31T14:59:59Z`	any of [string (date-time), null]	None
query	backup_job_state optional	Backup 이력 상태 Example : `SUCCESS`	any of [enum (SUCCESS, PARTIAL_SUCCESS, FAILED, INPROGRESS, ALL), null]	None
query	page optional	페이지 Example : `0`	integer	0
query	size optional	항목 수 Example : `20`	integer	20
query	sort optional	정렬 조건 Example : `backup_start_time:desc`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	BackupHistoryListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/backup-histories

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "backup_end_time": "2024-10-31T14:59:59Z",
            "backup_job_guid": "3b1da7ba-3f38-45cb-9538-e921826f80d7",
            "backup_job_state": "SUCCESS",
            "backup_start_time": "2024-09-30T15:00:00Z",
            "schedule_id": "f5b8e22b-0d88-4698-9996-fb44217c8227",
            "schedule_name": "INCREMENTAL_DAILY_15:00:00-chg4By"
        }
    ],
    "count": 1
}

12.2 - 1.2

get /v1/backups/{backup_id}/backup-histories

Description

Backup 이력을 조회한다.

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.2	20261231

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
query	backup_start_time optional	시작 일시 Example : `2024-09-30T15:00:00Z`	any of [string (date-time), null]	None
query	backup_end_time optional	검색 종료 일시 Example : `2024-10-31T14:59:59Z`	any of [string (date-time), null]	None
query	backup_job_state optional	Backup 이력 상태 Example : `SUCCESS`	any of [enum (SUCCESS, PARTIAL_SUCCESS, FAILED, INPROGRESS, ALL), null]	None
query	page optional	페이지 Example : `0`	integer	0
query	size optional	항목 수 Example : `20`	integer	20
query	sort optional	정렬 조건 Example : `backup_start_time:desc`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	BackupHistoryListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/backup-histories

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "backup_end_time": "2024-10-31T14:59:59Z",
            "backup_job_guid": "3b1da7ba-3f38-45cb-9538-e921826f80d7",
            "backup_job_state": "SUCCESS",
            "backup_start_time": "2024-09-30T15:00:00Z",
            "schedule_id": "f5b8e22b-0d88-4698-9996-fb44217c8227",
            "schedule_name": "INCREMENTAL_DAILY_15:00:00-chg4By"
        }
    ],
    "count": 1
}

12.3 - 1.1

get /v1/backups/{backup_id}/backup-histories

Description

Backup 이력을 조회한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
query	backup_start_time optional	시작 일시 Example : `2024-09-30T15:00:00Z`	any of [string (date-time), null]	None
query	backup_end_time optional	검색 종료 일시 Example : `2024-10-31T14:59:59Z`	any of [string (date-time), null]	None
query	backup_job_state optional	Backup 이력 상태 Example : `SUCCESS`	any of [enum (SUCCESS, PARTIAL_SUCCESS, FAILED, INPROGRESS, ALL), null]	None
query	page optional	페이지 Example : `0`	integer	0
query	size optional	항목 수 Example : `20`	integer	20
query	sort optional	정렬 조건 Example : `backup_start_time:desc`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	BackupHistoryListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/backup-histories

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "backup_end_time": "2024-10-31T14:59:59Z",
            "backup_job_guid": "3b1da7ba-3f38-45cb-9538-e921826f80d7",
            "backup_job_state": "SUCCESS",
            "backup_start_time": "2024-09-30T15:00:00Z",
            "schedule_id": "f5b8e22b-0d88-4698-9996-fb44217c8227",
            "schedule_name": "INCREMENTAL_DAILY_15:00:00-chg4By"
        }
    ],
    "count": 1
}

12.4 - 1.0

get /v1/backups/{backup_id}/backup-histories

Description

Backup 이력을 조회한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.0	20260331

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
query	backup_start_time optional	시작 일시 Example : `2024-09-30T15:00:00Z`	any of [string (date-time), null]	None
query	backup_end_time optional	검색 종료 일시 Example : `2024-10-31T14:59:59Z`	any of [string (date-time), null]	None
query	backup_job_state optional	Backup 이력 상태 Example : `SUCCESS`	any of [enum (SUCCESS, PARTIAL_SUCCESS, FAILED, INPROGRESS, ALL), null]	None
query	page optional	페이지 Example : `0`	integer	0
query	size optional	항목 수 Example : `20`	integer	20
query	sort optional	정렬 조건 Example : `backup_start_time:desc`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	BackupHistoryListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/backup-histories

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "backup_end_time": "2024-10-31T14:59:59Z",
            "backup_job_guid": "3b1da7ba-3f38-45cb-9538-e921826f80d7",
            "backup_job_state": "SUCCESS",
            "backup_start_time": "2024-09-30T15:00:00Z",
            "schedule_id": "f5b8e22b-0d88-4698-9996-fb44217c8227",
            "schedule_name": "INCREMENTAL_DAILY_15:00:00-chg4By"
        }
    ],
    "count": 1
}

13 - List Backup Region Relationship

13.1 - 1.3

get /v1/backups/region-relationship

Description

List Backup Region Relationship.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
query	from_region optional	위치 Example : `kr-west1`	any of [string, null]	None
query	from_zone optional	Availability Zone명 Example : `kr-west1-a`	any of [string, null]	None
query	to_region optional	위치 Example : `kr-west1`	any of [string, null]	None
query	to_zone optional	Availability Zone명 Example : `kr-west1-a`	any of [string, null]	None
query	backup_master_type optional	Backup Master 유형 Example : `AGENTLESS`	any of [enum (AGENT, AGENT_VM, AGENT_BM, AGENTLESS, AGENT_SAP_INT, AGENT_SAP_EXT), null]	AGENTLESS

Responses

HTTP Code	Description	Schema
200	OK	BackupListRegionRelationshipResponse1Dot3
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/region-relationship

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "from_region": "kr-west1",
            "from_zone": "kr-west1-a",
            "to_region": "kr-west1",
            "to_zone": "kr-west1-a"
        }
    ],
    "count": ""
}

13.2 - 1.2

get /v1/backups/region-relationship

Description

List Backup Region Relationship.

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.2	20261231

Parameters

Type	Name	Description	Schema	Default
query	from_region optional	위치 Example : `kr-west1`	any of [string, null]	None
query	from_availability_zone optional	Availability Zone명 Example : `kr-west1-a`	any of [string, null]	None
query	to_region optional	위치 Example : `kr-west1`	any of [string, null]	None
query	to_availability_zone optional	Availability Zone명 Example : `kr-west1-a`	any of [string, null]	None
query	backup_master_type optional	Backup Master 유형 Example : `AGENTLESS`	any of [enum (AGENT, AGENT_VM, AGENT_BM, AGENTLESS, AGENT_SAP_INT, AGENT_SAP_EXT), null]	AGENTLESS

Responses

HTTP Code	Description	Schema
200	OK	BackupListRegionRelationshipResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/region-relationship

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "from_availability_zone": "kr-west1-a",
            "from_region": "kr-west1",
            "to_availability_zone": "kr-west1-a",
            "to_region": "kr-west1"
        }
    ],
    "count": ""
}

13.3 - 1.1

get /v1/backups/region-relationship

Description

List Backup Region Relationship.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
query	from_region optional	위치 Example : `kr-west1`	any of [string, null]	None
query	from_availability_zone optional	Availability Zone명 Example : `kr-west1-a`	any of [string, null]	None
query	to_region optional	위치 Example : `kr-west1`	any of [string, null]	None
query	to_availability_zone optional	Availability Zone명 Example : `kr-west1-a`	any of [string, null]	None
query	backup_master_type optional	Backup Master 유형 Example : `AGENTLESS`	any of [enum (AGENT, AGENT_VM, AGENT_BM, AGENTLESS, AGENT_SAP_INT, AGENT_SAP_EXT), null]	AGENTLESS

Responses

HTTP Code	Description	Schema
200	OK	BackupListRegionRelationshipResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/region-relationship

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "from_availability_zone": "kr-west1-a",
            "from_region": "kr-west1",
            "to_availability_zone": "kr-west1-a",
            "to_region": "kr-west1"
        }
    ],
    "count": ""
}

13.4 - 1.0

get /v1/backups/region-relationship

Description

List Backup Region Relationship.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.0	20260331

Parameters

Type	Name	Description	Schema	Default
query	from_region optional	위치 Example : `kr-west1`	any of [string, null]	None
query	from_availability_zone optional	Availability Zone명 Example : `kr-west1-a`	any of [string, null]	None
query	to_region optional	위치 Example : `kr-west1`	any of [string, null]	None
query	to_availability_zone optional	Availability Zone명 Example : `kr-west1-a`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	BackupListRegionRelationshipResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/region-relationship

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "from_availability_zone": "kr-west1-a",
            "from_region": "kr-west1",
            "to_availability_zone": "kr-west1-a",
            "to_region": "kr-west1"
        }
    ],
    "count": ""
}

14 - List Backup Restore Histories

14.1 - 1.3

get /v1/backups/{backup_id}/restore-histories

Description

복구 이력을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
query	page optional	페이지 Example : `0`	any of [integer, null]	0
query	size optional	항목 수 Example : `20`	any of [integer, null]	20
query	sort optional	정렬 조건 Example : `backup_start_time:desc`	any of [string, null]	created_at:desc
query	restore_state optional	복구 상태 Example : `COMPLETED`	any of [enum (COMPLETED, FAILED, INPROGRESS, PARTIAL_SUCCESS), null]	None
query	start_time optional	시작 일시 Example : `2024-09-30T15:00:00Z`	any of [string (date-time), null]	None
query	end_time optional	검색 종료 일시 Example : `2024-10-31T14:59:59Z`	any of [string (date-time), null]	None

Responses

HTTP Code	Description	Schema
200	OK	BackupRestoreHistoryListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/restore-histories

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "backup_id": "00cd2538fbf94d12b36aabbdd607e974",
            "backup_start_time": "2024-10-28T05:38:48",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "restore_end_time": "2024-10-28T05:52:47",
            "restore_server_id": "26895cb7-2059-49e7-b6fe-9c9c4b0d3db0",
            "restore_server_name": "restoretest1",
            "restore_start_time": "2024-10-28T05:52:47",
            "restore_state": "COMPLETED",
            "schedule_name": "INCREMENTAL_DAILY_15:00:00-chg4By"
        }
    ],
    "count": 1
}

14.2 - 1.2

get /v1/backups/{backup_id}/restore-histories

Description

복구 이력을 조회한다.

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.2	20261231

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
query	page optional	페이지 Example : `0`	any of [integer, null]	0
query	size optional	항목 수 Example : `20`	any of [integer, null]	20
query	sort optional	정렬 조건 Example : `backup_start_time:desc`	any of [string, null]	created_at:desc
query	restore_state optional	복구 상태 Example : `COMPLETED`	any of [enum (COMPLETED, FAILED, INPROGRESS, PARTIAL_SUCCESS), null]	None
query	start_time optional	시작 일시 Example : `2024-09-30T15:00:00Z`	any of [string (date-time), null]	None
query	end_time optional	검색 종료 일시 Example : `2024-10-31T14:59:59Z`	any of [string (date-time), null]	None

Responses

HTTP Code	Description	Schema
200	OK	BackupRestoreHistoryListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/restore-histories

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "backup_id": "00cd2538fbf94d12b36aabbdd607e974",
            "backup_start_time": "2024-10-28T05:38:48",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "restore_end_time": "2024-10-28T05:52:47",
            "restore_server_id": "26895cb7-2059-49e7-b6fe-9c9c4b0d3db0",
            "restore_server_name": "restoretest1",
            "restore_start_time": "2024-10-28T05:52:47",
            "restore_state": "COMPLETED",
            "schedule_name": "INCREMENTAL_DAILY_15:00:00-chg4By"
        }
    ],
    "count": 1
}

14.3 - 1.1

get /v1/backups/{backup_id}/restore-histories

Description

복구 이력을 조회한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
query	page optional	페이지 Example : `0`	any of [integer, null]	0
query	size optional	항목 수 Example : `20`	any of [integer, null]	20
query	sort optional	정렬 조건 Example : `backup_start_time:desc`	any of [string, null]	created_at:desc
query	restore_state optional	복구 상태 Example : `COMPLETED`	any of [enum (COMPLETED, FAILED, INPROGRESS, PARTIAL_SUCCESS), null]	None
query	start_time optional	시작 일시 Example : `2024-09-30T15:00:00Z`	any of [string (date-time), null]	None
query	end_time optional	검색 종료 일시 Example : `2024-10-31T14:59:59Z`	any of [string (date-time), null]	None

Responses

HTTP Code	Description	Schema
200	OK	BackupRestoreHistoryListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/restore-histories

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "backup_id": "00cd2538fbf94d12b36aabbdd607e974",
            "backup_start_time": "2024-10-28T05:38:48",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "restore_end_time": "2024-10-28T05:52:47",
            "restore_server_id": "26895cb7-2059-49e7-b6fe-9c9c4b0d3db0",
            "restore_server_name": "restoretest1",
            "restore_start_time": "2024-10-28T05:52:47",
            "restore_state": "COMPLETED",
            "schedule_name": "INCREMENTAL_DAILY_15:00:00-chg4By"
        }
    ],
    "count": 1
}

14.4 - 1.0

get /v1/backups/{backup_id}/restore-histories

Description

복구 이력을 조회한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.0	20260331

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
query	page optional	페이지 Example : `0`	any of [integer, null]	0
query	size optional	항목 수 Example : `20`	any of [integer, null]	20
query	sort optional	정렬 조건 Example : `backup_start_time:desc`	any of [string, null]	created_at:desc
query	restore_state optional	복구 상태 Example : `COMPLETED`	any of [enum (COMPLETED, FAILED, INPROGRESS, PARTIAL_SUCCESS), null]	None
query	start_time optional	시작 일시 Example : `2024-09-30T15:00:00Z`	any of [string (date-time), null]	None
query	end_time optional	검색 종료 일시 Example : `2024-10-31T14:59:59Z`	any of [string (date-time), null]	None

Responses

HTTP Code	Description	Schema
200	OK	BackupRestoreHistoryListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/restore-histories

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "backup_id": "00cd2538fbf94d12b36aabbdd607e974",
            "backup_start_time": "2024-10-28T05:38:48",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "restore_end_time": "2024-10-28T05:52:47",
            "restore_server_id": "26895cb7-2059-49e7-b6fe-9c9c4b0d3db0",
            "restore_server_name": "restoretest1",
            "restore_start_time": "2024-10-28T05:52:47",
            "restore_state": "COMPLETED",
            "schedule_name": "INCREMENTAL_DAILY_15:00:00-chg4By"
        }
    ],
    "count": 1
}

15 - List Backup Restore Subnets

15.1 - 1.3

get /v1/backups/{backup_id}/restore/restorable-subnets

Description

원본 서버와 다른 위치에 복구하기 위해 서브넷 목록을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
query	vpc_id optional	VPC ID Example : `7df8abb4912e4709b1cb237daccca7a8`	any of [string, null]	None
query	state optional	Subnet 상태 Example : `ACTIVE`	any of [string, null]	None
query	region required	서버를 복구할 리전 Example : `kr-west1`	string	None
query	zone optional	Availability Zone명 Example : `kr-west1-a`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	BackupRestoreSubnetListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/restore/restorable-subnets?region={region}

Request header

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

Example HTTP response

Response 200

{
    "count": 1,
    "subnets": [
        {
            "account_id": "fnsd89fus0f9ds09f90dshf9dshfds09",
            "cidr": "192.167.1.0/24",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "gateway_ip_address": "192.167.1.1",
            "id": "023c57b14f11483689338d085e061492",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "subnetName",
            "state": "ACTIVE",
            "type": "PUBLIC",
            "vpc_id": "7df8abb4912e4709b1cb237daccca7a8",
            "vpc_name": "vpcName"
        }
    ]
}

15.2 - 1.2

get /v1/backups/{backup_id}/restore/restorable-subnets

Description

원본 서버와 다른 위치에 복구하기 위해 서브넷 목록을 조회한다.

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.2	20261231

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
query	vpc_id optional	VPC ID Example : `7df8abb4912e4709b1cb237daccca7a8`	any of [string, null]	None
query	state optional	Subnet 상태 Example : `ACTIVE`	any of [string, null]	None
query	region required	서버를 복구할 리전 Example : `kr-west1`	string	None

Responses

HTTP Code	Description	Schema
200	OK	BackupRestoreSubnetListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/restore/restorable-subnets?region={region}

Request header

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

Example HTTP response

Response 200

{
    "count": 1,
    "subnets": [
        {
            "account_id": "fnsd89fus0f9ds09f90dshf9dshfds09",
            "cidr": "192.167.1.0/24",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "gateway_ip_address": "192.167.1.1",
            "id": "023c57b14f11483689338d085e061492",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "subnetName",
            "state": "ACTIVE",
            "type": "PUBLIC",
            "vpc_id": "7df8abb4912e4709b1cb237daccca7a8",
            "vpc_name": "vpcName"
        }
    ]
}

15.3 - 1.1

get /v1/backups/{backup_id}/restore/restorable-subnets

Description

원본 서버와 다른 위치에 복구하기 위해 서브넷 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
query	vpc_id optional	VPC ID Example : `7df8abb4912e4709b1cb237daccca7a8`	any of [string, null]	None
query	state optional	Subnet 상태 Example : `ACTIVE`	any of [string, null]	None
query	region required	서버를 복구할 리전 Example : `kr-west1`	string	None

Responses

HTTP Code	Description	Schema
200	OK	BackupRestoreSubnetListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/restore/restorable-subnets?region={region}

Request header

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

Example HTTP response

Response 200

{
    "count": 1,
    "subnets": [
        {
            "account_id": "fnsd89fus0f9ds09f90dshf9dshfds09",
            "cidr": "192.167.1.0/24",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "gateway_ip_address": "192.167.1.1",
            "id": "023c57b14f11483689338d085e061492",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "subnetName",
            "state": "ACTIVE",
            "type": "PUBLIC",
            "vpc_id": "7df8abb4912e4709b1cb237daccca7a8",
            "vpc_name": "vpcName"
        }
    ]
}

15.4 - 1.0

get /v1/backups/{backup_id}/restore/restorable-subnets

Description

원본 서버와 다른 위치에 복구하기 위해 서브넷 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.0	20260331

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
query	vpc_id optional	VPC ID Example : `7df8abb4912e4709b1cb237daccca7a8`	any of [string, null]	None
query	state optional	Subnet 상태 Example : `ACTIVE`	any of [string, null]	None
query	region required	서버를 복구할 리전 Example : `kr-west1`	string	None

Responses

HTTP Code	Description	Schema
200	OK	BackupRestoreSubnetListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/restore/restorable-subnets?region={region}

Request header

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

Example HTTP response

Response 200

{
    "count": 1,
    "subnets": [
        {
            "account_id": "fnsd89fus0f9ds09f90dshf9dshfds09",
            "cidr": "192.167.1.0/24",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "gateway_ip_address": "192.167.1.1",
            "id": "023c57b14f11483689338d085e061492",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "subnetName",
            "state": "ACTIVE",
            "type": "PUBLIC",
            "vpc_id": "7df8abb4912e4709b1cb237daccca7a8",
            "vpc_name": "vpcName"
        }
    ]
}

16 - List Backup Restore Targets

16.1 - 1.3

get /v1/backups/{backup_id}/restore-targets

Description

복구 대상 목록을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
query	backup_start_time optional	시작 일시 Example : `2024-09-30T15:00:00Z`	any of [string (date-time), null]	None
query	backup_end_time optional	검색 종료 일시 Example : `2024-10-31T14:59:59Z`	any of [string (date-time), null]	None
query	page optional	페이지 Example : `0`	integer	0
query	size optional	항목 수 Example : `20`	integer	20
query	sort optional	정렬 조건 Example : `backup_start_time:desc`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	BackupRestoreTargetListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/restore-targets

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "backup_start_time": "2024-09-30T15:00:00Z",
            "is_restore_available": "true",
            "restore_target_id": "ca1a8e76-af49-40ea-93f8-a5989ffe138b",
            "retention_period": "WEEK_2",
            "schedule_id": "f5b8e22b-0d88-4698-9996-fb44217c8227",
            "schedule_name": "INCREMENTAL_DAILY_15:00:00-chg4By",
            "usage_gb": "123.4"
        }
    ],
    "count": 1
}

16.2 - 1.2

get /v1/backups/{backup_id}/restore-targets

Description

복구 대상 목록을 조회한다.

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.2	20261231

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
query	backup_start_time optional	시작 일시 Example : `2024-09-30T15:00:00Z`	any of [string (date-time), null]	None
query	backup_end_time optional	검색 종료 일시 Example : `2024-10-31T14:59:59Z`	any of [string (date-time), null]	None
query	page optional	페이지 Example : `0`	integer	0
query	size optional	항목 수 Example : `20`	integer	20
query	sort optional	정렬 조건 Example : `backup_start_time:desc`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	BackupRestoreTargetListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/restore-targets

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "backup_start_time": "2024-09-30T15:00:00Z",
            "is_restore_available": "true",
            "restore_target_id": "ca1a8e76-af49-40ea-93f8-a5989ffe138b",
            "retention_period": "WEEK_2",
            "schedule_id": "f5b8e22b-0d88-4698-9996-fb44217c8227",
            "schedule_name": "INCREMENTAL_DAILY_15:00:00-chg4By",
            "usage_gb": "123.4"
        }
    ],
    "count": 1
}

16.3 - 1.1

get /v1/backups/{backup_id}/restore-targets

Description

복구 대상 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
query	backup_start_time optional	시작 일시 Example : `2024-09-30T15:00:00Z`	any of [string (date-time), null]	None
query	backup_end_time optional	검색 종료 일시 Example : `2024-10-31T14:59:59Z`	any of [string (date-time), null]	None
query	page optional	페이지 Example : `0`	integer	0
query	size optional	항목 수 Example : `20`	integer	20
query	sort optional	정렬 조건 Example : `backup_start_time:desc`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	BackupRestoreTargetListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/restore-targets

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "backup_start_time": "2024-09-30T15:00:00Z",
            "is_restore_available": "true",
            "restore_target_id": "ca1a8e76-af49-40ea-93f8-a5989ffe138b",
            "retention_period": "WEEK_2",
            "schedule_id": "f5b8e22b-0d88-4698-9996-fb44217c8227",
            "schedule_name": "INCREMENTAL_DAILY_15:00:00-chg4By",
            "usage_gb": "123.4"
        }
    ],
    "count": 1
}

16.4 - 1.0

get /v1/backups/{backup_id}/restore-targets

Description

복구 대상 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.0	20260331

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
query	backup_start_time optional	시작 일시 Example : `2024-09-30T15:00:00Z`	any of [string (date-time), null]	None
query	backup_end_time optional	검색 종료 일시 Example : `2024-10-31T14:59:59Z`	any of [string (date-time), null]	None
query	page optional	페이지 Example : `0`	integer	0
query	size optional	항목 수 Example : `20`	integer	20
query	sort optional	정렬 조건 Example : `backup_start_time:desc`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	BackupRestoreTargetListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/restore-targets

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "backup_start_time": "2024-09-30T15:00:00Z",
            "is_restore_available": "true",
            "restore_target_id": "ca1a8e76-af49-40ea-93f8-a5989ffe138b",
            "retention_period": "WEEK_2",
            "schedule_id": "f5b8e22b-0d88-4698-9996-fb44217c8227",
            "schedule_name": "INCREMENTAL_DAILY_15:00:00-chg4By",
            "usage_gb": "123.4"
        }
    ],
    "count": 1
}

17 - List Backup Schedules

17.1 - 1.3

get /v1/backups/{backup_id}/schedules

Description

스케줄 목록을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None

Responses

HTTP Code	Description	Schema
200	OK	BackupScheduleListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/schedules

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "backup_id": "00cd2538fbf94d12b36aabbdd607e974",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "frequency": "DAILY",
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "INCREMENTAL_DAILY_15:00:00-chg4By",
            "start_day": "MON",
            "start_time": "14:00:00",
            "start_week": "WEEK_1",
            "state": "AVAILABLE",
            "type": "FULL"
        }
    ],
    "count": 1
}

17.2 - 1.2

get /v1/backups/{backup_id}/schedules

Description

스케줄 목록을 조회한다.

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.2	20261231

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None

Responses

HTTP Code	Description	Schema
200	OK	BackupScheduleListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/schedules

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "backup_id": "00cd2538fbf94d12b36aabbdd607e974",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "frequency": "DAILY",
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "INCREMENTAL_DAILY_15:00:00-chg4By",
            "start_day": "MON",
            "start_time": "14:00:00",
            "start_week": "WEEK_1",
            "state": "AVAILABLE",
            "type": "FULL"
        }
    ],
    "count": 1
}

17.3 - 1.1

get /v1/backups/{backup_id}/schedules

Description

스케줄 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None

Responses

HTTP Code	Description	Schema
200	OK	BackupScheduleListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/schedules

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "backup_id": "00cd2538fbf94d12b36aabbdd607e974",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "frequency": "DAILY",
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "INCREMENTAL_DAILY_15:00:00-chg4By",
            "start_day": "MON",
            "start_time": "14:00:00",
            "start_week": "WEEK_1",
            "state": "AVAILABLE",
            "type": "FULL"
        }
    ],
    "count": 1
}

17.4 - 1.0

get /v1/backups/{backup_id}/schedules

Description

스케줄 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.0	20260331

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None

Responses

HTTP Code	Description	Schema
200	OK	BackupScheduleListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/schedules

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "backup_id": "00cd2538fbf94d12b36aabbdd607e974",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "frequency": "DAILY",
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "INCREMENTAL_DAILY_15:00:00-chg4By",
            "start_day": "MON",
            "start_time": "14:00:00",
            "start_week": "WEEK_1",
            "state": "AVAILABLE",
            "type": "FULL"
        }
    ],
    "count": 1
}

18 - List Backup Targets

18.1 - 1.3

get /v1/backups/backup-targets

Description

Backup 대상 목록을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
query	server_name optional	Backup 서버명 Example : `server-001`	any of [string, null]	None
query	server_category required	대상 서버 카테고리 Example : `VIRTUAL_SERVER \| GPU_SERVER \| BAREMETAL_SERVER`	enum (VIRTUAL_SERVER, GPU_SERVER, BAREMETAL_SERVER)	None
query	region optional	위치 Example : `kr-west1`	any of [string, null]	None
query	page optional	페이지 Example : `0`	any of [integer, null]	0
query	size optional	항목 수 Example : `20`	any of [integer, null]	5
query	policy_type required	Backup 정책 유형 Example : `VM_IMAGE`	enum (VM_IMAGE, FILESYSTEM, FILE_STORAGE)	None
query	zone optional	Availability Zone명 Example : `kr-west1-a`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	BackupTargetListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/backup-targets?server_category={server_category}&policy_type={policy_type}

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "server_guid": "9ab33c66-3dbd-46cd-b0af-abccd3eb3170",
            "server_name": "server-001",
            "server_os_version": "UBUNTU 22.04",
            "server_type": "s1v1m2",
            "server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366"
        }
    ],
    "count": 1
}

18.2 - 1.2

get /v1/backups/backup-targets

Description

Backup 대상 목록을 조회한다.

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.2	20261231

Parameters

Type	Name	Description	Schema	Default
query	server_name optional	Backup 서버명 Example : `server-001`	any of [string, null]	None
query	server_category required	대상 서버 카테고리 Example : `VIRTUAL_SERVER \| GPU_SERVER \| BAREMETAL_SERVER`	enum (VIRTUAL_SERVER, GPU_SERVER, BAREMETAL_SERVER)	None
query	region optional	위치 Example : `kr-west1`	any of [string, null]	None
query	page optional	페이지 Example : `0`	any of [integer, null]	0
query	size optional	항목 수 Example : `20`	any of [integer, null]	5
query	policy_type required	Backup 정책 유형 Example : `VM_IMAGE`	enum (VM_IMAGE, FILESYSTEM, FILE_STORAGE)	None

Responses

HTTP Code	Description	Schema
200	OK	BackupTargetListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/backup-targets?server_category={server_category}&policy_type={policy_type}

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "server_guid": "9ab33c66-3dbd-46cd-b0af-abccd3eb3170",
            "server_name": "server-001",
            "server_os_version": "UBUNTU 22.04",
            "server_type": "s1v1m2",
            "server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366"
        }
    ],
    "count": 1
}

18.3 - 1.1

get /v1/backups/backup-targets

Description

Backup 대상 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
query	server_name optional	Backup 서버명 Example : `server-001`	any of [string, null]	None
query	server_category required	대상 서버 카테고리 Example : `VIRTUAL_SERVER \| GPU_SERVER \| BAREMETAL_SERVER`	enum (VIRTUAL_SERVER, GPU_SERVER, BAREMETAL_SERVER)	None
query	region optional	위치 Example : `kr-west1`	any of [string, null]	None
query	page optional	페이지 Example : `0`	any of [integer, null]	0
query	size optional	항목 수 Example : `20`	any of [integer, null]	5

Responses

HTTP Code	Description	Schema
200	OK	BackupTargetListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/backup-targets?server_category={server_category}

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "server_guid": "9ab33c66-3dbd-46cd-b0af-abccd3eb3170",
            "server_name": "server-001",
            "server_os_version": "UBUNTU 22.04",
            "server_type": "s1v1m2",
            "server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366"
        }
    ],
    "count": 1
}

18.4 - 1.0

get /v1/backups/backup-targets

Description

Backup 대상 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.0	20260331

Parameters

Type	Name	Description	Schema	Default
query	server_name optional	Backup 서버명 Example : `server-001`	any of [string, null]	None
query	server_category required	대상 서버 카테고리 Example : `VIRTUAL_SERVER \| GPU_SERVER \| BAREMETAL_SERVER`	enum (VIRTUAL_SERVER, GPU_SERVER, BAREMETAL_SERVER)	None
query	region optional	위치 Example : `kr-west1`	any of [string, null]	None
query	page optional	페이지 Example : `0`	any of [integer, null]	0
query	size optional	항목 수 Example : `20`	any of [integer, null]	5

Responses

HTTP Code	Description	Schema
200	OK	BackupTargetListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/backup-targets?server_category={server_category}

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "server_guid": "9ab33c66-3dbd-46cd-b0af-abccd3eb3170",
            "server_name": "server-001",
            "server_os_version": "UBUNTU 22.04",
            "server_type": "s1v1m2",
            "server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366"
        }
    ],
    "count": 1
}

19 - List Backups

19.1 - 1.3

get /v1/backups

Description

Backup 목록을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
query	size optional	size Example : `20`	any of [integer, null]	20
query	page optional	page Example : `0`	any of [integer, null]	0
query	sort optional	sort Example : `created_at:desc`	any of [string, null]	None
query	name optional	Backup명 Example : `backup-001`	any of [string, null]	None
query	server_name optional	Backup 서버명 Example : `server-001`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	BackupListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "backup-001",
            "policy_type": "VM_IMAGE",
            "retention_period": "WEEK_2",
            "role_type": "ORIGINAL",
            "server_name": "server-001",
            "state": "AVAILABLE"
        }
    ],
    "count": 1
}

19.2 - 1.2

get /v1/backups

Description

Backup 목록을 조회한다.

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.2	20261231

Parameters

Type	Name	Description	Schema	Default
query	size optional	size Example : `20`	any of [integer, null]	20
query	page optional	page Example : `0`	any of [integer, null]	0
query	sort optional	sort Example : `created_at:desc`	any of [string, null]	None
query	name optional	Backup명 Example : `backup-001`	any of [string, null]	None
query	server_name optional	Backup 서버명 Example : `server-001`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	BackupListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "backup-001",
            "policy_type": "VM_IMAGE",
            "retention_period": "WEEK_2",
            "role_type": "ORIGINAL",
            "server_name": "server-001",
            "state": "AVAILABLE"
        }
    ],
    "count": 1
}

19.3 - 1.1

get /v1/backups

Description

Backup 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
query	size optional	size Example : `20`	any of [integer, null]	20
query	page optional	page Example : `0`	any of [integer, null]	0
query	sort optional	sort Example : `created_at:desc`	any of [string, null]	None
query	name optional	Backup명 Example : `backup-001`	any of [string, null]	None
query	server_name optional	Backup 서버명 Example : `server-001`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	BackupListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "backup-001",
            "policy_type": "VM_IMAGE",
            "retention_period": "WEEK_2",
            "role_type": "ORIGINAL",
            "server_name": "server-001",
            "state": "AVAILABLE"
        }
    ],
    "count": 1
}

19.4 - 1.0

get /v1/backups

Description

Backup 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.0	20260331

Parameters

Type	Name	Description	Schema	Default
query	size optional	size Example : `20`	any of [integer, null]	20
query	page optional	page Example : `0`	any of [integer, null]	0
query	sort optional	sort Example : `created_at:desc`	any of [string, null]	None
query	name optional	Backup명 Example : `backup-001`	any of [string, null]	None
query	server_name optional	Backup 서버명 Example : `server-001`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	BackupListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "backup-001",
            "policy_type": "VM_IMAGE",
            "retention_period": "WEEK_2",
            "role_type": "ORIGINAL",
            "server_name": "server-001",
            "state": "AVAILABLE"
        }
    ],
    "count": 1
}

20 - List Filesystem Path

20.1 - 1.3

get /v1/backups/{backup_id}/filesystem-path

Description

파일 시스템 목록 조회

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
query	restore_target_id required	복구 대상 목록 Example : `ca1a8e76-af49-40ea-93f8-a5989ffe138b`	string	None
query	path required	백업 대상 파일 시스템 경로 Example : `/`	string	None

Responses

HTTP Code	Description	Schema
200	OK	FileSystemPathListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/filesystem-path?restore_target_id={restore_target_id}&path={path}

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "id": "/data/_1768885200",
            "item_type": "DIR | FILE",
            "name": "data/",
            "path": "/"
        }
    ],
    "count": 1
}

20.2 - 1.2

get /v1/backups/{backup_id}/filesystem-path

Description

파일 시스템 목록 조회

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.2	20261231

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
query	restore_target_id required	복구 대상 목록 Example : `ca1a8e76-af49-40ea-93f8-a5989ffe138b`	string	None
query	path required	백업 대상 파일 시스템 경로 Example : `/`	string	None

Responses

HTTP Code	Description	Schema
200	OK	FileSystemPathListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/filesystem-path?restore_target_id={restore_target_id}&path={path}

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "id": "/data/_1768885200",
            "item_type": "DIR | FILE",
            "name": "data/",
            "path": "/"
        }
    ],
    "count": 1
}

21 - List Targets of Backup Agent

21.1 - 1.3

get /v1/backup-agents/targets

Description

Backup Agent 대상 서버 목록

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
query	size optional	size Example : `20`	any of [integer, null]	20
query	page optional	page Example : `0`	any of [integer, null]	0
query	sort optional	정렬 조건 Example : `server_name:asc`	any of [string, null]	server_name:asc
query	server_category required	대상 서버 카테고리 Example : `BAREMETAL_SERVER`	string	None
query	server_name optional	Backup 서버명 Example : `server-001`	any of [string, null]	None
query	zone optional	Availability Zone명 Example : `kr-west1-a`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	BackupAgentTargetListResponse1Dot2
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backup-agents/targets?server_category={server_category}

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "server_backup_agent_ip": "11.22.33.44",
            "server_name": "server-001",
            "server_state": "RUNNING",
            "server_type": "s1v1m2",
            "server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366",
            "vpc_id": "7df8abb4912e4709b1cb237daccca7a8"
        }
    ],
    "count": 1
}

21.2 - 1.2

get /v1/backup-agents/targets

Description

Backup Agent 대상 서버 목록

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.2	20261231

Parameters

Type	Name	Description	Schema	Default
query	size optional	size Example : `20`	any of [integer, null]	20
query	page optional	page Example : `0`	any of [integer, null]	0
query	sort optional	정렬 조건 Example : `server_name:asc`	any of [string, null]	server_name:asc
query	server_category required	대상 서버 카테고리 Example : `BAREMETAL_SERVER`	string	None
query	server_name optional	Backup 서버명 Example : `server-001`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	BackupAgentTargetListResponse1Dot2
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backup-agents/targets?server_category={server_category}

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "server_backup_agent_ip": "11.22.33.44",
            "server_name": "server-001",
            "server_state": "RUNNING",
            "server_type": "s1v1m2",
            "server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366",
            "vpc_id": "7df8abb4912e4709b1cb237daccca7a8"
        }
    ],
    "count": 1
}

21.3 - 1.1

get /v1/backup-agents/targets

Description

Backup Agent 대상 서버 목록

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
query	size optional	size Example : `20`	any of [integer, null]	20
query	page optional	page Example : `0`	any of [integer, null]	0
query	sort optional	정렬 조건 Example : `server_name:asc`	any of [string, null]	server_name:asc
query	server_category required	대상 서버 카테고리 Example : `BAREMETAL_SERVER`	string	None
query	server_name optional	Backup 서버명 Example : `server-001`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	BackupAgentTargetListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backup-agents/targets?server_category={server_category}

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "server_backup_agent_ip": "11.22.33.44",
            "server_name": "server-001",
            "server_state": "RUNNING",
            "server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366"
        }
    ],
    "count": 1
}

21.4 - 1.0

get /v1/backup-agents/targets

Description

Backup Agent 대상 서버 목록

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.0	20260331

Parameters

Type	Name	Description	Schema	Default
query	size optional	size Example : `20`	any of [integer, null]	20
query	page optional	page Example : `0`	any of [integer, null]	0
query	sort optional	정렬 조건 Example : `server_name:asc`	any of [string, null]	server_name:asc
query	server_category required	대상 서버 카테고리 Example : `BAREMETAL_SERVER`	string	None
query	server_name optional	Backup 서버명 Example : `server-001`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	BackupAgentTargetListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backup-agents/targets?server_category={server_category}

Request header

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

Example HTTP response

Response 200

{
    "contents": [
        {
            "server_backup_agent_ip": "11.22.33.44",
            "server_name": "server-001",
            "server_state": "RUNNING",
            "server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366"
        }
    ],
    "count": 1
}

22 - Manual Backup

22.1 - 1.3

post /v1/backups/{backup_id}/manual-backup

Description

즉시 Backup을 수행한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/manual-backup

Request header

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

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

22.2 - 1.2

post /v1/backups/{backup_id}/manual-backup

Description

즉시 Backup을 수행한다.

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.2	20261231

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/manual-backup

Request header

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

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

22.3 - 1.1

post /v1/backups/{backup_id}/manual-backup

Description

즉시 Backup을 수행한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/manual-backup

Request header

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

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

22.4 - 1.0

post /v1/backups/{backup_id}/manual-backup

Description

즉시 Backup을 수행한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.0	20260331

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/manual-backup

Request header

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

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

23 - Restore Agent Backup

23.1 - 1.3

post /v1/backups/{backup_id}/restore-agent-backup

Description

백업을 복구한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
body	body required		AgentBackupRestoreRequest

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/restore-agent-backup

Request header

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

Request body

{
    "filesystem_paths": [
        {
            "destination": "/",
            "source": "/"
        }
    ],
    "overwrite": true,
    "restore_server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366",
    "restore_target_id": "ca1a8e76-af49-40ea-93f8-a5989ffe138b"
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

23.2 - 1.2

post /v1/backups/{backup_id}/restore-agent-backup

Description

백업을 복구한다.

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.2	20261231

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
body	body required		AgentBackupRestoreRequest

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/restore-agent-backup

Request header

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

Request body

{
    "filesystem_paths": [
        {
            "destination": "/",
            "source": "/"
        }
    ],
    "overwrite": true,
    "restore_server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366",
    "restore_target_id": "ca1a8e76-af49-40ea-93f8-a5989ffe138b"
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

23.3 - 1.1

post /v1/backups/{backup_id}/restore-agent-backup

Description

백업을 복구한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
body	body required		AgentBackupRestoreRequest

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/restore-agent-backup

Request header

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

Request body

{
    "filesystem_paths": [
        {
            "destination": "/",
            "source": "/"
        }
    ],
    "overwrite": true,
    "restore_server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366",
    "restore_target_id": "ca1a8e76-af49-40ea-93f8-a5989ffe138b"
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

23.4 - 1.0

post /v1/backups/{backup_id}/restore-agent-backup

Description

백업을 복구한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.0	20260331

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
body	body required		AgentBackupRestoreRequest

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/restore-agent-backup

Request header

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

Request body

{
    "filesystem_paths": [
        {
            "destination": "/",
            "source": "/"
        }
    ],
    "overwrite": true,
    "restore_server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366",
    "restore_target_id": "ca1a8e76-af49-40ea-93f8-a5989ffe138b"
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

24 - Restore Backup

24.1 - 1.3

post /v1/backups/{backup_id}/restore

Description

백업을 복구한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
body	body required		BackupRestoreRequest1Dot3

Responses

HTTP Code	Description	Schema
202	Accepted	AsyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/backups/{backup_id}/restore

Request header

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

Request body

{
    "networks": [
        {
            "subnet_id": "023c57b14f11483689338d085e061492"
        }
    ],
    "restore_region": "kr-west1",
    "restore_server_name": "restoretest1",
    "restore_target_id": "ca1a8e76-af49-40ea-93f8-a5989ffe138b",
    "restore_zone": "kr-west1-a",
    "security_groups": [
        "023c57b14f11483689338d085e061492"
    ],
    "server_type_id": "s1v1m2"
}

Example HTTP response

Response 202

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

24.2 - 1.2

post /v1/backups/{backup_id}/restore

Description

백업을 복구한다.

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.2	20261231

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
body	body required		BackupRestoreRequest

Responses

HTTP Code	Description	Schema
202	Accepted	AsyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/backups/{backup_id}/restore

Request header

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

Request body

{
    "networks": [
        {
            "subnet_id": "023c57b14f11483689338d085e061492"
        }
    ],
    "restore_region": "kr-west1",
    "restore_server_name": "restoretest1",
    "restore_target_id": "ca1a8e76-af49-40ea-93f8-a5989ffe138b",
    "security_groups": [
        "023c57b14f11483689338d085e061492"
    ],
    "server_type_id": "s1v1m2"
}

Example HTTP response

Response 202

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

24.3 - 1.1

post /v1/backups/{backup_id}/restore

Description

백업을 복구한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
body	body required		BackupRestoreRequest

Responses

HTTP Code	Description	Schema
202	Accepted	AsyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/backups/{backup_id}/restore

Request header

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

Request body

{
    "networks": [
        {
            "subnet_id": "023c57b14f11483689338d085e061492"
        }
    ],
    "restore_region": "kr-west1",
    "restore_server_name": "restoretest1",
    "restore_target_id": "ca1a8e76-af49-40ea-93f8-a5989ffe138b",
    "security_groups": [
        "023c57b14f11483689338d085e061492"
    ],
    "server_type_id": "s1v1m2"
}

Example HTTP response

Response 202

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

24.4 - 1.0

post /v1/backups/{backup_id}/restore

Description

백업을 복구한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.0	20260331

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
body	body required		BackupRestoreRequest

Responses

HTTP Code	Description	Schema
202	Accepted	AsyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/backups/{backup_id}/restore

Request header

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

Request body

{
    "networks": [
        {
            "subnet_id": "023c57b14f11483689338d085e061492"
        }
    ],
    "restore_region": "kr-west1",
    "restore_server_name": "restoretest1",
    "restore_target_id": "ca1a8e76-af49-40ea-93f8-a5989ffe138b",
    "security_groups": [
        "023c57b14f11483689338d085e061492"
    ],
    "server_type_id": "s1v1m2"
}

Example HTTP response

Response 202

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

25 - Set Backup Schedule

25.1 - 1.3

put /v1/backups/{backup_id}/schedules

Description

스케줄 목록을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
body	body required		ModifyBackupSchedulesRequest

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/schedules

Request header

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

Request body

{
    "schedules": [
        {
            "frequency": "DAILY",
            "start_day": "MON",
            "start_time": "09:00:00",
            "start_week": "WEEK_2",
            "type": "FULL"
        }
    ]
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

25.2 - 1.2

put /v1/backups/{backup_id}/schedules

Description

스케줄 목록을 조회한다.

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.2	20261231

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
body	body required		ModifyBackupSchedulesRequest

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/schedules

Request header

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

Request body

{
    "schedules": [
        {
            "frequency": "DAILY",
            "start_day": "MON",
            "start_time": "09:00:00",
            "start_week": "WEEK_2",
            "type": "FULL"
        }
    ]
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

25.3 - 1.1

put /v1/backups/{backup_id}/schedules

Description

스케줄 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
body	body required		ModifyBackupSchedulesRequest

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/schedules

Request header

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

Request body

{
    "schedules": [
        {
            "frequency": "DAILY",
            "start_day": "MON",
            "start_time": "09:00:00",
            "start_week": "WEEK_2",
            "type": "FULL"
        }
    ]
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

25.4 - 1.0

put /v1/backups/{backup_id}/schedules

Description

스케줄 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.0	20260331

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
body	body required		ModifyBackupSchedulesRequest

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/schedules

Request header

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

Request body

{
    "schedules": [
        {
            "frequency": "DAILY",
            "start_day": "MON",
            "start_time": "09:00:00",
            "start_week": "WEEK_2",
            "type": "FULL"
        }
    ]
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

26 - Set Filesystem Path

26.1 - 1.3

put /v1/backups/{backup_id}/filesystem-path

Description

파일 시스템 경로 설정

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
body	body required		FileSystemPathUpdateRequest1Dot2

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/filesystem-path

Request header

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

Request body

{
    "backup_filesystem_paths": [
        "/aaa",
        "/bbb"
    ],
    "is_all_filesystem": false
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

26.2 - 1.2

put /v1/backups/{backup_id}/filesystem-path

Description

파일 시스템 경로 설정

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.2	20261231

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
body	body required		FileSystemPathUpdateRequest1Dot2

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/filesystem-path

Request header

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

Request body

{
    "backup_filesystem_paths": [
        "/aaa",
        "/bbb"
    ],
    "is_all_filesystem": false
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

26.3 - 1.1

put /v1/backups/{backup_id}/filesystem-path

Description

파일 시스템 경로 설정

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
body	body required		FileSystemPathUpdateRequest

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/filesystem-path

Request header

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

Request body

{
    "backup_filesystem_paths": [
        "/aaa",
        "/bbb"
    ]
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

26.4 - 1.0

put /v1/backups/{backup_id}/filesystem-path

Description

파일 시스템 경로 설정

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.0	20260331

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
body	body required		FileSystemPathUpdateRequest

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/filesystem-path

Request header

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

Request body

{
    "backup_filesystem_paths": [
        "/aaa",
        "/bbb"
    ]
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

27 - Show Backup

27.1 - 1.3

get /v1/backups/{backup_id}

Description

Backup을 상세 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None

Responses

HTTP Code	Description	Schema
200	OK	BackupDetailResponse1Dot3
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_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 = backup 1.3"

Example HTTP response

Response 200

{
    "backup_agent_id": "BACKUP_AGENT-abcd",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "dr_enabled": false,
    "dr_region": "kr-west1",
    "dr_zone": "kr-west1-a",
    "encrypt_enabled": false,
    "filesystem_paths": [
        "/aaa",
        "/bbb"
    ],
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "is_all_filesystem": false,
    "is_server_deleted": false,
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "backup-001",
    "origin_backup_id": "00cd2538fbf94d12b36aabbdd607e974",
    "policy_category": "AGENTLESS",
    "policy_type": "VM_IMAGE",
    "region": "kr-west1",
    "replica_backup_id": "00cd2538fbf94d12b36aabbdd607e974",
    "retention_period": "WEEK_2",
    "role_type": "ORIGINAL",
    "server_category": "VIRTUAL_SERVER | GPU_SERVER | BAREMETAL_SERVER",
    "server_name": "server-001",
    "server_os_type": "WINDOWS",
    "server_region": "kr-west1",
    "server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366",
    "server_zone": "kr-west1-a",
    "state": "AVAILABLE",
    "zone": "kr-west1-a"
}

27.2 - 1.2

get /v1/backups/{backup_id}

Description

Backup을 상세 조회한다.

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.2	20261231

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None

Responses

HTTP Code	Description	Schema
200	OK	BackupDetailResponse1Dot2
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_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 = backup 1.2"

Example HTTP response

Response 200

{
    "backup_agent_id": "BACKUP_AGENT-abcd",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "dr_enabled": false,
    "dr_region": "kr-west1",
    "encrypt_enabled": false,
    "filesystem_paths": [
        "/aaa",
        "/bbb"
    ],
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "is_all_filesystem": false,
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "backup-001",
    "origin_backup_id": "00cd2538fbf94d12b36aabbdd607e974",
    "policy_category": "AGENTLESS",
    "policy_type": "VM_IMAGE",
    "region": "kr-west1",
    "replica_backup_id": "00cd2538fbf94d12b36aabbdd607e974",
    "retention_period": "WEEK_2",
    "role_type": "ORIGINAL",
    "server_category": "VIRTUAL_SERVER | GPU_SERVER | BAREMETAL_SERVER",
    "server_name": "server-001",
    "server_os_type": "WINDOWS",
    "server_region": "kr-west1",
    "server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366",
    "state": "AVAILABLE"
}

27.3 - 1.1

get /v1/backups/{backup_id}

Description

Backup을 상세 조회한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None

Responses

HTTP Code	Description	Schema
200	OK	BackupDetailResponse1Dot1
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_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 = backup 1.1"

Example HTTP response

Response 200

{
    "backup_agent_id": "BACKUP_AGENT-abcd",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "dr_enabled": false,
    "dr_region": "kr-west1",
    "encrypt_enabled": false,
    "filesystem_paths": [
        "/aaa",
        "/bbb"
    ],
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "backup-001",
    "origin_backup_id": "00cd2538fbf94d12b36aabbdd607e974",
    "policy_category": "AGENTLESS",
    "policy_type": "VM_IMAGE",
    "region": "kr-west1",
    "replica_backup_id": "00cd2538fbf94d12b36aabbdd607e974",
    "retention_period": "WEEK_2",
    "role_type": "ORIGINAL",
    "server_category": "VIRTUAL_SERVER | GPU_SERVER | BAREMETAL_SERVER",
    "server_name": "server-001",
    "server_os_type": "WINDOWS",
    "server_region": "kr-west1",
    "server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366",
    "state": "AVAILABLE"
}

27.4 - 1.0

get /v1/backups/{backup_id}

Description

Backup을 상세 조회한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.0	20260331

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None

Responses

HTTP Code	Description	Schema
200	OK	BackupDetailResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_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 = backup 1.0"

Example HTTP response

Response 200

{
    "backup_agent_id": "BACKUP_AGENT-abcd",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "encrypt_enabled": false,
    "filesystem_paths": [
        "/aaa",
        "/bbb"
    ],
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "backup-001",
    "policy_category": "AGENTLESS",
    "policy_type": "VM_IMAGE",
    "region": "kr-west1",
    "retention_period": "WEEK_2",
    "role_type": "ORIGINAL",
    "server_category": "VIRTUAL_SERVER | GPU_SERVER | BAREMETAL_SERVER",
    "server_name": "server-001",
    "server_os_type": "WINDOWS",
    "server_region": "kr-west1",
    "server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366",
    "state": "AVAILABLE"
}

28 - Show Backup Agent

28.1 - 1.3

get /v1/backup-agents/{backup_agent_id}

Description

Backup Agent를 상세 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	backup_agent_id required	Backup Agent ID Example : `BACKUP_AGENT-abcd`	string	None

Responses

HTTP Code	Description	Schema
200	OK	BackupAgentDetailResponse1Dot3
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backup-agents/{backup_agent_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 = backup 1.3"

Example HTTP response

Response 200

{
    "account_id": "fnsd89fus0f9ds09f90dshf9dshfds09",
    "backup_master_ip": "33.44.55.66",
    "backup_master_name": "backupmastertest",
    "backup_policy_count": "3",
    "connection_check_time": "2024-11-11T09:13:48Z",
    "connection_state": "SUCCESS",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "id": "BACKUP_AGENT-abcd",
    "install_file_path": "http://linux-agent",
    "is_server_deleted": false,
    "media_servers": [
        {
            "ip_address": "",
            "name": ""
        }
    ],
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "agent_abcd12",
    "region": "kr-west1",
    "server_backup_agent_ip": "11.22.33.44",
    "server_category": "VIRTUAL_SERVER | GPU_SERVER | BAREMETAL_SERVER",
    "server_gateway_ip": "22.33.44.55",
    "server_name": "server-001",
    "server_os_type": "WINDOWS",
    "server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366",
    "state": "AVAILABLE",
    "subnet_id": "",
    "subnet_name": "",
    "zone": "kr-west1-a"
}

28.2 - 1.2

get /v1/backup-agents/{backup_agent_id}

Description

Backup Agent를 상세 조회한다.

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.2	20261231

Parameters

Type	Name	Description	Schema	Default
path	backup_agent_id required	Backup Agent ID Example : `BACKUP_AGENT-abcd`	string	None

Responses

HTTP Code	Description	Schema
200	OK	BackupAgentDetailResponse1Dot2
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backup-agents/{backup_agent_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 = backup 1.2"

Example HTTP response

Response 200

{
    "account_id": "fnsd89fus0f9ds09f90dshf9dshfds09",
    "backup_master_ip": "33.44.55.66",
    "backup_master_name": "backupmastertest",
    "backup_policy_count": "3",
    "connection_check_time": "2024-11-11T09:13:48Z",
    "connection_state": "SUCCESS",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "id": "BACKUP_AGENT-abcd",
    "install_file_path": "http://linux-agent",
    "media_servers": [
        {
            "ip_address": "",
            "name": ""
        }
    ],
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "agent_abcd12",
    "server_backup_agent_ip": "11.22.33.44",
    "server_category": "VIRTUAL_SERVER | GPU_SERVER | BAREMETAL_SERVER",
    "server_gateway_ip": "22.33.44.55",
    "server_name": "server-001",
    "server_os_type": "WINDOWS",
    "server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366",
    "state": "AVAILABLE",
    "subnet_id": "",
    "subnet_name": ""
}

28.3 - 1.1

get /v1/backup-agents/{backup_agent_id}

Description

Backup Agent를 상세 조회한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	backup_agent_id required	Backup Agent ID Example : `BACKUP_AGENT-abcd`	string	None

Responses

HTTP Code	Description	Schema
200	OK	BackupAgentDetailResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backup-agents/{backup_agent_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 = backup 1.1"

Example HTTP response

Response 200

{
    "account_id": "fnsd89fus0f9ds09f90dshf9dshfds09",
    "backup_master_ip": "33.44.55.66",
    "backup_master_name": "backupmastertest",
    "backup_policy_count": "3",
    "connection_check_time": "2024-11-11T09:13:48Z",
    "connection_state": "SUCCESS",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "id": "BACKUP_AGENT-abcd",
    "install_file_path": "http://linux-agent",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "agent_abcd12",
    "server_backup_agent_ip": "11.22.33.44",
    "server_category": "VIRTUAL_SERVER | GPU_SERVER | BAREMETAL_SERVER",
    "server_gateway_ip": "22.33.44.55",
    "server_name": "server-001",
    "server_os_type": "WINDOWS",
    "server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366",
    "state": "AVAILABLE"
}

28.4 - 1.0

get /v1/backup-agents/{backup_agent_id}

Description

Backup Agent를 상세 조회한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.0	20260331

Parameters

Type	Name	Description	Schema	Default
path	backup_agent_id required	Backup Agent ID Example : `BACKUP_AGENT-abcd`	string	None

Responses

HTTP Code	Description	Schema
200	OK	BackupAgentDetailResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backup-agents/{backup_agent_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 = backup 1.0"

Example HTTP response

Response 200

{
    "account_id": "fnsd89fus0f9ds09f90dshf9dshfds09",
    "backup_master_ip": "33.44.55.66",
    "backup_master_name": "backupmastertest",
    "backup_policy_count": "3",
    "connection_check_time": "2024-11-11T09:13:48Z",
    "connection_state": "SUCCESS",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "id": "BACKUP_AGENT-abcd",
    "install_file_path": "http://linux-agent",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "agent_abcd12",
    "server_backup_agent_ip": "11.22.33.44",
    "server_category": "VIRTUAL_SERVER | GPU_SERVER | BAREMETAL_SERVER",
    "server_gateway_ip": "22.33.44.55",
    "server_name": "server-001",
    "server_os_type": "WINDOWS",
    "server_uuid": "89f5ef44-1021-4a5c-8e06-fbb289eac366",
    "state": "AVAILABLE"
}

29 - Show Backup Agent Install File Path

29.1 - 1.3

get /v1/backup-agents/agent-install-file-path

Description

Backup Agent 설치 파일 경로 조회

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
query	os_type required	OS 유형 Example :	string	None

Responses

HTTP Code	Description	Schema
200	OK	InstallFilePathResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backup-agents/agent-install-file-path?os_type={os_type}

Request header

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

Example HTTP response

Response 200

{
    "install_file_path": "http://linux-agent"
}

29.2 - 1.2

get /v1/backup-agents/agent-install-file-path

Description

Backup Agent 설치 파일 경로 조회

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.2	20261231

Parameters

Type	Name	Description	Schema	Default
query	os_type required	OS 유형 Example :	string	None

Responses

HTTP Code	Description	Schema
200	OK	InstallFilePathResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backup-agents/agent-install-file-path?os_type={os_type}

Request header

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

Example HTTP response

Response 200

{
    "install_file_path": "http://linux-agent"
}

29.3 - 1.1

get /v1/backup-agents/agent-install-file-path

Description

Backup Agent 설치 파일 경로 조회

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
query	os_type required	OS 유형 Example :	string	None

Responses

HTTP Code	Description	Schema
200	OK	InstallFilePathResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backup-agents/agent-install-file-path?os_type={os_type}

Request header

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

Example HTTP response

Response 200

{
    "install_file_path": "http://linux-agent"
}

29.4 - 1.0

get /v1/backup-agents/agent-install-file-path

Description

Backup Agent 설치 파일 경로 조회

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.0	20260331

Parameters

Type	Name	Description	Schema	Default
query	os_type required	OS 유형 Example :	string	None

Responses

HTTP Code	Description	Schema
200	OK	InstallFilePathResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backup-agents/agent-install-file-path?os_type={os_type}

Request header

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

Example HTTP response

Response 200

{
    "install_file_path": "http://linux-agent"
}

30 - Update Replication Use

30.1 - 1.3

put /v1/backups/{backup_id}/replication

Description

복제 사용 여부를 수정한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
body	body required		BackupReplicationUseUpdateBody

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/replication

Request header

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

Request body

{
    "dr_enabled": false
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

30.2 - 1.2

put /v1/backups/{backup_id}/replication

Description

복제 사용 여부를 수정한다.

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.2	20261231

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
body	body required		BackupReplicationUseUpdateBody

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/replication

Request header

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

Request body

{
    "dr_enabled": false
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

30.3 - 1.1

put /v1/backups/{backup_id}/replication

Description

복제 사용 여부를 수정한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
body	body required		BackupReplicationUseUpdateBody

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/replication

Request header

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

Request body

{
    "dr_enabled": false
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

30.4 - 1.0

put /v1/backups/{backup_id}/replication

Description

복제 사용 여부를 수정한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.0	20260331

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
body	body required		BackupReplicationUseUpdateBody

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/replication

Request header

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

Request body

{
    "dr_enabled": false
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

31 - Update Retention Period

31.1 - 1.3

put /v1/backups/{backup_id}/retention-period

Description

보관 기간을 수정한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
body	body required		RetentionPeriodUpdateBody

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/retention-period

Request header

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

Request body

{
    "retention_period": "WEEK_2"
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

31.2 - 1.2

put /v1/backups/{backup_id}/retention-period

Description

보관 기간을 수정한다.

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.2	20261231

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
body	body required		RetentionPeriodUpdateBody

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/retention-period

Request header

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

Request body

{
    "retention_period": "WEEK_2"
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

31.3 - 1.1

put /v1/backups/{backup_id}/retention-period

Description

보관 기간을 수정한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
body	body required		RetentionPeriodUpdateBody

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/retention-period

Request header

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

Request body

{
    "retention_period": "WEEK_2"
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}

31.4 - 1.0

put /v1/backups/{backup_id}/retention-period

Description

보관 기간을 수정한다.

상태 ACTIVE (DEPRECATED)

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

버전	최소 지원 보장일
1.0	20260331

Parameters

Type	Name	Description	Schema	Default
path	backup_id required	Backup ID Example : `00cd2538fbf94d12b36aabbdd607e974`	string	None
body	body required		RetentionPeriodUpdateBody

Responses

HTTP Code	Description	Schema
200	OK	SyncResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/backups/{backup_id}/retention-period

Request header

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

Request body

{
    "retention_period": "WEEK_2"
}

Example HTTP response

Response 200

{
    "request_id": "",
    "resource": {
        "id": "",
        "links": [
            ""
        ]
    }
}