This is the multi-page printable view of this section. Click here to print.
Show Backup Agent
1 - 1.3
get /v1/backup-agents/{backup_agent_id}
Description
Show the detail of Backup Agent.
State ACTIVE (CURRENT)
| Version | Not Before |
|---|---|
| 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 = en-US",
"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"
}
2 - 1.2
get /v1/backup-agents/{backup_agent_id}
Description
Show the detail of Backup Agent.
State ACTIVE (SUPPORTED)
| Version | Not Before |
|---|---|
| 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 = en-US",
"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": ""
}
3 - 1.1
get /v1/backup-agents/{backup_agent_id}
Description
Show the detail of Backup Agent.
State ACTIVE (DEPRECATED)
Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.
| Version | Not Before |
|---|---|
| 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 = en-US",
"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"
}
4 - 1.0
get /v1/backup-agents/{backup_agent_id}
Description
Show the detail of Backup Agent.
State ACTIVE (DEPRECATED)
Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.
| Version | Not Before |
|---|---|
| 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 = en-US",
"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"
}