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

Compute

1: Bare Metal Server

1.1: APIs

1.1.1: Assign Baremetal Private NAT IP

1.1.1.1: 1.1

1.1.2: Assign Baremetal Public NAT IP

1.1.2.1: 1.1
1.1.2.2: 1.0

1.1.3: Attach Baremetal Local Subnet

1.1.3.1: 1.1
1.1.3.2: 1.0

1.1.4: Create Baremetals

1.1.4.1: 1.1
1.1.4.2: 1.0

1.1.5: Delete Baremetal Private NAT IP

1.1.5.1: 1.1

1.1.6: Delete Baremetal Public NAT IP

1.1.6.1: 1.1
1.1.6.2: 1.0

1.1.7: Delete Baremetals

1.1.7.1: 1.1
1.1.7.2: 1.0

1.1.8: Detach Baremetal Local Subnet

1.1.8.1: 1.1
1.1.8.2: 1.0

1.1.9: List Baremetal Images

1.1.9.1: 1.1
1.1.9.2: 1.0

1.1.10: List Baremetal Products

1.1.10.1: 1.1
1.1.10.2: 1.0

1.1.11: List Baremetals

1.1.11.1: 1.1
1.1.11.2: 1.0

1.1.12: Lock Baremetal

1.1.12.1: 1.1
1.1.12.2: 1.0

1.1.13: Show Baremetal

1.1.13.1: 1.1
1.1.13.2: 1.0

1.1.14: Start Baremetals

1.1.14.1: 1.1
1.1.14.2: 1.0

1.1.15: Stop Baremetals

1.1.15.1: 1.1
1.1.15.2: 1.0

1.1.16: Unlock Baremetal

1.1.16.1: 1.1
1.1.16.2: 1.0

1.2: Models

1.2.1: AsyncResponse
1.2.2: BaremetalActionResponse
1.2.3: BaremetalCreateRequest
1.2.4: BaremetalListResponse
1.2.5: BaremetalListResponseV1Dot1
1.2.6: BaremetalListV1Dot1
1.2.7: BaremetalServerAssignPrivateNatIpRequest
1.2.8: BaremetalServerAssignPublicNatIpRequest
1.2.9: BaremetalServerIdResponse
1.2.10: BaremetalShowResponse
1.2.11: BaremetalShowResponseV1Dot1
1.2.12: BaremetalsOperationRequest
1.2.13: BaremetalStaticNatResponseV1Dot1
1.2.14: BaremetalTerminateRequest
1.2.15: ImageListResponse
1.2.16: ImageShowResponse
1.2.17: LocalDiskPartitionsRequest
1.2.18: LocalSubnetAttachRequest
1.2.19: LocalSubnetDetachRequest
1.2.20: LocalSubnetInfoResponse
1.2.21: LocalSubnetResponse
1.2.22: ProductListResponse
1.2.23: ProductListResponseV1Dot1
1.2.24: ProductShowResponse
1.2.25: ProductShowResponseV1Dot1
1.2.26: ServerDetailsRequest
1.2.27: TagRequest

2: Cloud Functions

2.1: APIs

2.1.1: Approve PrivateLink Endpoint

2.1.1.1: 1.3
2.1.1.2: 1.2

2.1.2: Check Function Name Duplication

2.1.2.1: 1.3
2.1.2.2: 1.2
2.1.2.3: 1.1
2.1.2.4: 1.0

2.1.3: Connect PrivateLink Endpoint

2.1.3.1: 1.3
2.1.3.2: 1.2

2.1.4: Create Cloud Function

2.1.4.1: 1.3
2.1.4.2: 1.2
2.1.4.3: 1.1
2.1.4.4: 1.0

2.1.5: Create Cloud Function Apigateway Trigger

2.1.5.1: 1.3
2.1.5.2: 1.2
2.1.5.3: 1.1
2.1.5.4: 1.0

2.1.6: Create Cloud Function Cronjob Trigger

2.1.6.1: 1.3
2.1.6.2: 1.2
2.1.6.3: 1.1
2.1.6.4: 1.0

2.1.7: Create PrivateLink Endpoint

2.1.7.1: 1.3
2.1.7.2: 1.2

2.1.8: Delete Cloud Function

2.1.8.1: 1.3
2.1.8.2: 1.2
2.1.8.3: 1.1
2.1.8.4: 1.0

2.1.9: Delete Cloud Function Trigger

2.1.9.1: 1.3
2.1.9.2: 1.2
2.1.9.3: 1.1
2.1.9.4: 1.0

2.1.10: Delete PrivateLink Endpoint

2.1.10.1: 1.3
2.1.10.2: 1.2

2.1.11: Delete Resource Policy

2.1.11.1: 1.3

2.1.12: List Cloud Function Triggers

2.1.12.1: 1.3
2.1.12.2: 1.2
2.1.12.3: 1.1
2.1.12.4: 1.0

2.1.13: List Cloud Functions

2.1.13.1: 1.3
2.1.13.2: 1.2
2.1.13.3: 1.1
2.1.13.4: 1.0

2.1.14: List Environment Variables

2.1.14.1: 1.3

2.1.15: List PrivateLink Endpoint

2.1.15.1: 1.3

2.1.16: List Runtimes

2.1.16.1: 1.3
2.1.16.2: 1.2
2.1.16.3: 1.1
2.1.16.4: 1.0

2.1.17: List Sample Codes

2.1.17.1: 1.3
2.1.17.2: 1.2
2.1.17.3: 1.1
2.1.17.4: 1.0

2.1.18: Request PrivateLink Endpoint

2.1.18.1: 1.3
2.1.18.2: 1.2

2.1.19: Set Resource Policy

2.1.19.1: 1.3

2.1.20: Show Cloud Function

2.1.20.1: 1.3
2.1.20.2: 1.2
2.1.20.3: 1.1
2.1.20.4: 1.0

2.1.21: Show Cloud Function Code

2.1.21.1: 1.3
2.1.21.2: 1.2
2.1.21.3: 1.1
2.1.21.4: 1.0

2.1.22: Show Cloud Function Configuration

2.1.22.1: 1.3
2.1.22.2: 1.2
2.1.22.3: 1.1
2.1.22.4: 1.0

2.1.23: Show Cloud Function Logs

2.1.23.1: 1.3
2.1.23.2: 1.2
2.1.23.3: 1.1
2.1.23.4: 1.0

2.1.24: Show Cloud Function Metrics

2.1.24.1: 1.3
2.1.24.2: 1.2
2.1.24.3: 1.1
2.1.24.4: 1.0

2.1.25: Show Cloud Function Trigger

2.1.25.1: 1.3
2.1.25.2: 1.2
2.1.25.3: 1.1
2.1.25.4: 1.0

2.1.26: Show General Config

2.1.26.1: 1.3

2.1.27: Show PrivateLink Service

2.1.27.1: 1.3

2.1.28: Show Resource Policy

2.1.28.1: 1.3

2.1.29: Show Url Config

2.1.29.1: 1.3

2.1.30: Update Cloud Function Code

2.1.30.1: 1.3
2.1.30.2: 1.2
2.1.30.3: 1.1
2.1.30.4: 1.0

2.1.31: Update Cloud Function Code File

2.1.31.1: 1.3
2.1.31.2: 1.2
2.1.31.3: 1.1

2.1.32: Update Cloud Function Config

2.1.32.1: 1.3
2.1.32.2: 1.2
2.1.32.3: 1.1
2.1.32.4: 1.0

2.1.33: Update Cloud Function Cronjob Trigger

2.1.33.1: 1.3
2.1.33.2: 1.2
2.1.33.3: 1.1
2.1.33.4: 1.0

2.1.34: Update Cloud Function Url

2.1.34.1: 1.3
2.1.34.2: 1.2
2.1.34.3: 1.1
2.1.34.4: 1.0

2.1.35: Update Cloud Function Variables

2.1.35.1: 1.3
2.1.35.2: 1.2
2.1.35.3: 1.1
2.1.35.4: 1.0

2.1.36: Update PrivateLink Service

2.1.36.1: 1.3
2.1.36.2: 1.2

2.2: Models

2.2.1: ApigatewayTriggerCreateRequest
2.2.2: CloudFunction
2.2.3: CloudFunctionCreateRequest
2.2.4: CloudFunctionCreateResponse
2.2.5: CloudFunctionForList
2.2.6: CloudFunctionListResponse
2.2.7: CloudFunctionShowResponse
2.2.8: Code
2.2.9: CodeFile
2.2.10: CodeSetRequest
2.2.11: Configuration
2.2.12: ConfigurationV1Dot2
2.2.13: CronjobTriggerCreateRequest
2.2.14: CronjobTriggerSetRequest
2.2.15: DuplicationShowResponse
2.2.16: Endpoint
2.2.17: EndpointCreateRequest
2.2.18: FunctionConfig
2.2.19: FunctionUrl
2.2.20: FunctionUrlRequest
2.2.21: FunctionUrlV1Dot3
2.2.22: FunctionVariable
2.2.23: FunctionVariables
2.2.24: Log
2.2.25: LogShowResponse
2.2.26: Metric
2.2.27: MetricShowResponse
2.2.28: PolicyDocument
2.2.29: PrivateLinkEndpoint
2.2.30: PrivateLinkEndpointApproval
2.2.31: PrivateLinkEndpointConnection
2.2.32: PrivateLinkEndpointCreateRequest
2.2.33: PrivateLinkEndpointList
2.2.34: PrivateLinkEndpointRequest
2.2.35: PrivateLinkService
2.2.36: PrivateLinkServicePutRequest
2.2.37: PrivateLinkServiceV1Dot3
2.2.38: ResourcePolicySetRequest
2.2.39: ResourcePolicyShowResponse
2.2.40: Runtime
2.2.41: RuntimeListResponse
2.2.42: SampleCode
2.2.43: SampleCodesListResponse
2.2.44: Statement
2.2.45: Tag
2.2.46: Trigger
2.2.47: TriggerCreateResponse
2.2.48: TriggerDeleteRequest
2.2.49: TriggerForList
2.2.50: TriggersResponse
2.2.51: TriggerUpdateResponse

3: Multi-node GPU Cluster

3.1: APIs

3.1.1: Assign GpuNode Public NAT IP

3.1.1.1: 1.2

3.1.2: Create GPU Nodes

3.1.2.1: 1.2

3.1.3: Delete GPU Nodes

3.1.3.1: 1.2

3.1.4: List Cluster Fabrics

3.1.4.1: 1.2

3.1.5: List GPU Node Images

3.1.5.1: 1.2

3.1.6: List GPU Node Products

3.1.6.1: 1.2

3.1.7: List GPU Nodes

3.1.7.1: 1.2

3.1.8: List Node Pools

3.1.8.1: 1.2

3.1.9: Lock GPU Node

3.1.9.1: 1.2

3.1.10: Modify Cluster Fabric Members

3.1.10.1: 1.2

3.1.11: Release GPU Node Public NAT IP

3.1.11.1: 1.2

3.1.12: Show Cluster Fabric

3.1.12.1: 1.2

3.1.13: Show GPU Node

3.1.13.1: 1.2

3.1.14: Start GPU Nodes

3.1.14.1: 1.2

3.1.15: Stop GPU Nodes

3.1.15.1: 1.2

3.1.16: Unlock GPU Node

3.1.16.1: 1.2

3.2: Models

3.2.1: AsyncResponse
3.2.2: ClusterFabricDetailsRequest
3.2.3: ClusterFabricDetailsResponse
3.2.4: ClusterFabricListResponse
3.2.5: ClusterFabricMemberModifyRequestBody
3.2.6: ClusterFabricShowResponse
3.2.7: GpuNodeActionResponse
3.2.8: GpuNodeAssignPublicNatIpRequest
3.2.9: GpuNodeCreateRequest
3.2.10: GpuNodeDetailsRequest
3.2.11: GpuNodeDetailsResponse
3.2.12: GpuNodeImageListResponse
3.2.13: GpuNodeImageShowResponse
3.2.14: GpuNodeListResponse
3.2.15: GpuNodeOperationRequest
3.2.16: GpuNodeProductAttr
3.2.17: GpuNodeProductListResponse
3.2.18: GpuNodeProductShowResponse
3.2.19: GpuNodeShowResponse
3.2.20: GpuNodeTerminateRequest
3.2.21: NodePoolListResponse
3.2.22: NodePoolShowResponse
3.2.23: Tag

4: Virtual Server

4.1: APIs

4.1.1: Accept a volume transfer

4.1.1.1: 1.2
4.1.1.2: 1.1
4.1.1.3: 1.0

4.1.2: Attach Virtual Server Security Group

4.1.2.1: 1.0

4.1.3: Attach Volume to Virtual Server

4.1.3.1: 1.2
4.1.3.2: 1.1
4.1.3.3: 1.0

4.1.4: Create a snapshot

4.1.4.1: 1.2
4.1.4.2: 1.1
4.1.4.3: 1.0

4.1.5: Create a volume transfer

4.1.5.1: 1.2
4.1.5.2: 1.1
4.1.5.3: 1.0

4.1.6: Create Auto-Scaling Group

4.1.6.1: 1.2
4.1.6.2: 1.1
4.1.6.3: 1.0

4.1.7: Create Auto-Scaling Group Notification

4.1.7.1: 1.2
4.1.7.2: 1.1
4.1.7.3: 1.0

4.1.8: Create Auto-Scaling Group Policy

4.1.8.1: 1.2
4.1.8.2: 1.1
4.1.8.3: 1.0

4.1.9: Create Auto-Scaling Group Schedule

4.1.9.1: 1.2
4.1.9.2: 1.1
4.1.9.3: 1.0

4.1.10: Create Image

4.1.10.1: 1.2
4.1.10.2: 1.1
4.1.10.3: 1.0

4.1.11: Create Image member

4.1.11.1: 1.2
4.1.11.2: 1.1
4.1.11.3: 1.0

4.1.12: Create Keypair

4.1.12.1: 1.2
4.1.12.2: 1.1
4.1.12.3: 1.0

4.1.13: Create Launch Configuration

4.1.13.1: 1.2
4.1.13.2: 1.1
4.1.13.3: 1.0

4.1.14: Create Server Group

4.1.14.1: 1.2
4.1.14.2: 1.1
4.1.14.3: 1.0

4.1.15: Create Server Interface

4.1.15.1: 1.2
4.1.15.2: 1.1
4.1.15.3: 1.0

4.1.16: Create Server Interface Nat

4.1.16.1: 1.2
4.1.16.2: 1.1
4.1.16.3: 1.0

4.1.17: Create Server Interface Private Nat

4.1.17.1: 1.2
4.1.17.2: 1.1
4.1.17.3: 1.0

4.1.18: Create Server Volume

4.1.18.1: 1.2
4.1.18.2: 1.1
4.1.18.3: 1.0

4.1.19: Create Sharing Image

4.1.19.1: 1.2
4.1.19.2: 1.1
4.1.19.3: 1.0

4.1.20: Create Virtual Server

4.1.20.1: 1.2
4.1.20.2: 1.1
4.1.20.3: 1.0

4.1.21: Create Virtual Server Custom Image

4.1.21.1: 1.2
4.1.21.2: 1.1
4.1.21.3: 1.0

4.1.22: Create Virtual Server Dump

4.1.22.1: 1.2
4.1.22.2: 1.1
4.1.22.3: 1.0

4.1.23: Create Volume

4.1.23.1: 1.2
4.1.23.2: 1.1
4.1.23.3: 1.0

4.1.24: Delete a snapshot

4.1.24.1: 1.2
4.1.24.2: 1.1
4.1.24.3: 1.0

4.1.25: Delete a volume transfer

4.1.25.1: 1.2
4.1.25.2: 1.1
4.1.25.3: 1.0

4.1.26: Delete Auto-Scaling Group

4.1.26.1: 1.2
4.1.26.2: 1.1
4.1.26.3: 1.0

4.1.27: Delete Auto-Scaling Group Notification

4.1.27.1: 1.2
4.1.27.2: 1.1
4.1.27.3: 1.0

4.1.28: Delete Auto-Scaling Group Policy

4.1.28.1: 1.2
4.1.28.2: 1.1
4.1.28.3: 1.0

4.1.29: Delete Auto-Scaling Group Schedule

4.1.29.1: 1.2
4.1.29.2: 1.1
4.1.29.3: 1.0

4.1.30: Delete Image

4.1.30.1: 1.2
4.1.30.2: 1.1
4.1.30.3: 1.0

4.1.31: Delete Image member

4.1.31.1: 1.2
4.1.31.2: 1.1
4.1.31.3: 1.0

4.1.32: Delete Keypair

4.1.32.1: 1.2
4.1.32.2: 1.1
4.1.32.3: 1.0

4.1.33: Delete Launch Configuration

4.1.33.1: 1.2
4.1.33.2: 1.1
4.1.33.3: 1.0

4.1.34: Delete Server Group

4.1.34.1: 1.2
4.1.34.2: 1.1
4.1.34.3: 1.0

4.1.35: Delete Server Interface

4.1.35.1: 1.2
4.1.35.2: 1.1
4.1.35.3: 1.0

4.1.36: Delete Server Interface Nat

4.1.36.1: 1.2
4.1.36.2: 1.1
4.1.36.3: 1.0

4.1.37: Delete Server Interface Private Nat

4.1.37.1: 1.2
4.1.37.2: 1.1
4.1.37.3: 1.0

4.1.38: Delete Server Volume

4.1.38.1: 1.2
4.1.38.2: 1.1
4.1.38.3: 1.0

4.1.39: Delete Virtual Server

4.1.39.1: 1.2
4.1.39.2: 1.1
4.1.39.3: 1.0

4.1.40: Delete Volume

4.1.40.1: 1.2
4.1.40.2: 1.1
4.1.40.3: 1.0

4.1.41: Detach Virtual Server Security Group

4.1.41.1: 1.0

4.1.42: Detach Volume from Virtual Server

4.1.42.1: 1.2
4.1.42.2: 1.1
4.1.42.3: 1.0

4.1.43: Extend Volume

4.1.43.1: 1.2
4.1.43.2: 1.1
4.1.43.3: 1.0

4.1.44: Get region's maximum partition size.

4.1.44.1: 1.2
4.1.44.2: 1.1
4.1.44.3: 1.0

4.1.45: Import Image

4.1.45.1: 1.2
4.1.45.2: 1.1
4.1.45.3: 1.0

4.1.46: List Auto-Scaling Group LB Server Groups

4.1.46.1: 1.2
4.1.46.2: 1.1
4.1.46.3: 1.0

4.1.47: List Auto-Scaling Group Notifications

4.1.47.1: 1.2
4.1.47.2: 1.1
4.1.47.3: 1.0

4.1.48: List Auto-Scaling Group Policies

4.1.48.1: 1.2
4.1.48.2: 1.1
4.1.48.3: 1.0

4.1.49: List Auto-Scaling Group Schedules

4.1.49.1: 1.2
4.1.49.2: 1.1
4.1.49.3: 1.0

4.1.50: List Auto-Scaling Group Virtual Servers

4.1.50.1: 1.2
4.1.50.2: 1.1
4.1.50.3: 1.0

4.1.51: List Auto-Scaling Groups

4.1.51.1: 1.2
4.1.51.2: 1.1
4.1.51.3: 1.0

4.1.52: List Default Configs

4.1.52.1: 1.2
4.1.52.2: 1.1
4.1.52.3: 1.0

4.1.53: List Image members

4.1.53.1: 1.2
4.1.53.2: 1.1
4.1.53.3: 1.0

4.1.54: List Images

4.1.54.1: 1.2
4.1.54.2: 1.1
4.1.54.3: 1.0

4.1.55: List Keypairs

4.1.55.1: 1.2
4.1.55.2: 1.1
4.1.55.3: 1.0

4.1.56: List Launch Configurations

4.1.56.1: 1.2
4.1.56.2: 1.1
4.1.56.3: 1.0

4.1.57: List pending Images

4.1.57.1: 1.2
4.1.57.2: 1.1
4.1.57.3: 1.0

4.1.58: List Server Groups

4.1.58.1: 1.2
4.1.58.2: 1.1
4.1.58.3: 1.0

4.1.59: List Server Interfaces

4.1.59.1: 1.2
4.1.59.2: 1.1
4.1.59.3: 1.0

4.1.60: List Server Ips

4.1.60.1: 1.2
4.1.60.2: 1.1
4.1.60.3: 1.0

4.1.61: List Server Types

4.1.61.1: 1.2
4.1.61.2: 1.1
4.1.61.3: 1.0

4.1.62: List Server Volumes

4.1.62.1: 1.2
4.1.62.2: 1.1
4.1.62.3: 1.0

4.1.63: List snapshots

4.1.63.1: 1.2
4.1.63.2: 1.1
4.1.63.3: 1.0

4.1.64: List Virtual Server Security Group

4.1.64.1: 1.2
4.1.64.2: 1.1
4.1.64.3: 1.0

4.1.65: List Virtual Servers

4.1.65.1: 1.2
4.1.65.2: 1.1
4.1.65.3: 1.0

4.1.66: List volume transfers

4.1.66.1: 1.2
4.1.66.2: 1.1
4.1.66.3: 1.0

4.1.67: List volume types

4.1.67.1: 1.2
4.1.67.2: 1.1
4.1.67.3: 1.0

4.1.68: List volumes

4.1.68.1: 1.2
4.1.68.2: 1.1
4.1.68.3: 1.0

4.1.69: Lock Virtual Server

4.1.69.1: 1.2
4.1.69.2: 1.1
4.1.69.3: 1.0

4.1.70: Reboot Virtual Server

4.1.70.1: 1.2
4.1.70.2: 1.1
4.1.70.3: 1.0

4.1.71: Rebuild Virtual Server

4.1.71.1: 1.2
4.1.71.2: 1.1
4.1.71.3: 1.0

4.1.72: Revert Volume to snapshot

4.1.72.1: 1.2
4.1.72.2: 1.1
4.1.72.3: 1.0

4.1.73: Set Volume Qos

4.1.73.1: 1.2

4.1.74: Show a snapshot’s details

4.1.74.1: 1.2
4.1.74.2: 1.1
4.1.74.3: 1.0

4.1.75: Show Auto-Scaling Group

4.1.75.1: 1.2
4.1.75.2: 1.1
4.1.75.3: 1.0

4.1.76: Show Auto-Scaling Group Notification

4.1.76.1: 1.2
4.1.76.2: 1.1
4.1.76.3: 1.0

4.1.77: Show Auto-Scaling Group Policy

4.1.77.1: 1.2
4.1.77.2: 1.1
4.1.77.3: 1.0

4.1.78: Show Auto-Scaling Group Schedule

4.1.78.1: 1.2
4.1.78.2: 1.1
4.1.78.3: 1.0

4.1.79: Show default Volume type’s details

4.1.79.1: 1.2
4.1.79.2: 1.1
4.1.79.3: 1.0

4.1.80: Show Image

4.1.80.1: 1.2
4.1.80.2: 1.1
4.1.80.3: 1.0

4.1.81: Show Image member

4.1.81.1: 1.2
4.1.81.2: 1.1
4.1.81.3: 1.0

4.1.82: Show Keypair

4.1.82.1: 1.2
4.1.82.2: 1.1
4.1.82.3: 1.0

4.1.83: Show Launch Configuration

4.1.83.1: 1.2
4.1.83.2: 1.1
4.1.83.3: 1.0

4.1.84: Show Server Group

4.1.84.1: 1.2
4.1.84.2: 1.1
4.1.84.3: 1.0

4.1.85: Show Server Interface

4.1.85.1: 1.2
4.1.85.2: 1.1
4.1.85.3: 1.0

4.1.86: Show Server Ip

4.1.86.1: 1.2
4.1.86.2: 1.1
4.1.86.3: 1.0

4.1.87: Show Server Quota Set

4.1.87.1: 1.2
4.1.87.2: 1.1
4.1.87.3: 1.0

4.1.88: Show Server Type

4.1.88.1: 1.2
4.1.88.2: 1.1
4.1.88.3: 1.0

4.1.89: Show Server Volume

4.1.89.1: 1.2
4.1.89.2: 1.1
4.1.89.3: 1.0

4.1.90: Show Virtual Server

4.1.90.1: 1.2
4.1.90.2: 1.1
4.1.90.3: 1.0

4.1.91: Show Virtual Server Console Log

4.1.91.1: 1.2
4.1.91.2: 1.1
4.1.91.3: 1.0

4.1.92: Show Virtual Server Password

4.1.92.1: 1.2
4.1.92.2: 1.1
4.1.92.3: 1.0

4.1.93: Show Volume Quota Set

4.1.93.1: 1.2
4.1.93.2: 1.1
4.1.93.3: 1.0

4.1.94: Show volume transfer detail

4.1.94.1: 1.2
4.1.94.2: 1.1
4.1.94.3: 1.0

4.1.95: Show Volume type’s details

4.1.95.1: 1.2
4.1.95.2: 1.1
4.1.95.3: 1.0

4.1.96: Show Volume's details

4.1.96.1: 1.2
4.1.96.2: 1.1
4.1.96.3: 1.0

4.1.97: Start Virtual Server

4.1.97.1: 1.2
4.1.97.2: 1.1
4.1.97.3: 1.0

4.1.98: Stop Virtual Server

4.1.98.1: 1.2
4.1.98.2: 1.1
4.1.98.3: 1.0

4.1.99: Unlock Virtual Server

4.1.99.1: 1.2
4.1.99.2: 1.1
4.1.99.3: 1.0

4.1.100: Update a snapshot

4.1.100.1: 1.2
4.1.100.2: 1.1
4.1.100.3: 1.0

4.1.101: Update Auto-Scaling Group

4.1.101.1: 1.2
4.1.101.2: 1.1
4.1.101.3: 1.0

4.1.102: Update Auto-Scaling Group LB Server Groups

4.1.102.1: 1.2
4.1.102.2: 1.1
4.1.102.3: 1.0

4.1.103: Update Auto-Scaling Group Notification

4.1.103.1: 1.2
4.1.103.2: 1.1
4.1.103.3: 1.0

4.1.104: Update Auto-Scaling Group Policy

4.1.104.1: 1.2
4.1.104.2: 1.1
4.1.104.3: 1.0

4.1.105: Update Auto-Scaling Group Schedule

4.1.105.1: 1.2
4.1.105.2: 1.1
4.1.105.3: 1.0

4.1.106: Update Auto-Scaling Group server count

4.1.106.1: 1.2
4.1.106.2: 1.1
4.1.106.3: 1.0

4.1.107: Update Image

4.1.107.1: 1.2
4.1.107.2: 1.1
4.1.107.3: 1.0

4.1.108: Update Image member

4.1.108.1: 1.2
4.1.108.2: 1.1
4.1.108.3: 1.0

4.1.109: Update Server Interface

4.1.109.1: 1.2
4.1.109.2: 1.1
4.1.109.3: 1.0

4.1.110: Update Server Volume

4.1.110.1: 1.2
4.1.110.2: 1.1
4.1.110.3: 1.0

4.1.111: Update Virtual Server

4.1.111.1: 1.2
4.1.111.2: 1.1
4.1.111.3: 1.0

4.1.112: Update Virtual Server type

4.1.112.1: 1.2
4.1.112.2: 1.1
4.1.112.3: 1.0

4.1.113: Update Volume

4.1.113.1: 1.2
4.1.113.2: 1.1
4.1.113.3: 1.0

4.2: Models

4.2.1: AutoScalingGroup
4.2.2: AutoScalingGroupCreateRequest
4.2.3: AutoScalingGroupCreateRequestV1Dot2
4.2.4: AutoScalingGroupLbServerGroup
4.2.5: AutoScalingGroupLbServerGroupListResponse
4.2.6: AutoScalingGroupLbServerGroupSetRequest
4.2.7: AutoScalingGroupLbServerGroupShowResponse
4.2.8: AutoScalingGroupListResponse
4.2.9: AutoScalingGroupListResponseV1Dot2
4.2.10: AutoScalingGroupNotificationCreateRequest
4.2.11: AutoScalingGroupNotificationListResponse
4.2.12: AutoScalingGroupNotificationShowResponse
4.2.13: AutoScalingGroupNotificationUpdateRequest
4.2.14: AutoScalingGroupPolicyCreateRequest
4.2.15: AutoScalingGroupPolicyListResponse
4.2.16: AutoScalingGroupPolicyShowResponse
4.2.17: AutoScalingGroupPolicyUpdateRequest
4.2.18: AutoScalingGroupPolicyUpdateRequestV1Dot2
4.2.19: AutoScalingGroupScheduleCreateRequest
4.2.20: AutoScalingGroupScheduleListResponse
4.2.21: AutoScalingGroupScheduleShowResponse
4.2.22: AutoScalingGroupScheduleUpdateRequest
4.2.23: AutoScalingGroupSetRequest
4.2.24: AutoScalingGroupSetRequestV1Dot2
4.2.25: AutoScalingGroupSetServerCountRequest
4.2.26: AutoScalingGroupShowResponse
4.2.27: AutoScalingGroupShowResponseV1Dot2
4.2.28: AutoScalingGroupV1Dot2
4.2.29: AutoScalingGroupVirtualServerListResponse
4.2.30: AutoScalingGroupVirtualServerListResponseV1Dot2
4.2.31: AutoScalingGroupVirtualServerShowResponse
4.2.32: AutoScalingGroupVirtualServerShowResponseV1Dot2
4.2.33: DefaultConfigListResponse
4.2.34: ImageCreateRequest
4.2.35: ImageImportRequest
4.2.36: ImageListResponse
4.2.37: ImageListResponseV1Dot2
4.2.38: ImageMemberCreateRequest
4.2.39: ImageMemberListResponse
4.2.40: ImageMemberSetRequest
4.2.41: ImageMemberShowResponse
4.2.42: ImageSetRequest
4.2.43: ImageShowResponse
4.2.44: ImageShowResponseV1Dot2
4.2.45: InterfaceAttachmentFixedIp
4.2.46: InterfaceResponse
4.2.47: InterfaceResponseV1Dot2
4.2.48: Keypair
4.2.49: KeypairCreateRequest
4.2.50: KeypairCreateResponse
4.2.51: KeypairListResponse
4.2.52: KeypairShowResponse
4.2.53: LaunchConfigurationCreateRequest
4.2.54: LaunchConfigurationDetailShowResponse
4.2.55: LaunchConfigurationDetailShowResponseV1Dot2
4.2.56: LaunchConfigurationListResponse
4.2.57: LaunchConfigurationListResponseV1Dot2
4.2.58: LaunchConfigurationShowResponse
4.2.59: LaunchConfigurationShowResponseV1Dot2
4.2.60: LaunchConfigurationVolume
4.2.61: LaunchConfigurationVolumeV1Dot2
4.2.62: Network
4.2.63: PrivateStaticNat
4.2.64: PublicStaticNat
4.2.65: SecurityGroupResponse
4.2.66: SecurityGroupResponseRule
4.2.67: SecurityGroupResponseRuleIpRange
4.2.68: ServerConsoleLogResponse
4.2.69: ServerCreateImageRequestBody
4.2.70: ServerCreateImageResponse
4.2.71: ServerCreateRequest
4.2.72: ServerCreateRequestV1Dot2
4.2.73: ServerCreateResponse
4.2.74: ServerCreateResponseParam
4.2.75: ServerGroup
4.2.76: ServerGroupCreateRequest
4.2.77: ServerGroupListResponse
4.2.78: ServerGroupPartitionSizeResponse
4.2.79: ServerInterfaceCreateRequest
4.2.80: ServerInterfaceListResponse
4.2.81: ServerInterfaceListResponseV1Dot2
4.2.82: ServerInterfaceUpdateRequest
4.2.83: ServerIpsResponse
4.2.84: ServerListResponse
4.2.85: ServerPasswordRequest
4.2.86: ServerPasswordResponse
4.2.87: ServerPrivateStaticNatCreateRequest
4.2.88: ServerQuotaSet
4.2.89: ServerQuotaSetObject
4.2.90: ServerRebootRequestBody
4.2.91: ServerSecurityGroupActionRequestBody
4.2.92: ServerSecurityGroupListResponse
4.2.93: ServerSetServerTypeRequestBody
4.2.94: ServerShowResponse
4.2.95: ServerShowResponseAddress
4.2.96: ServerShowResponseAddressIpAddress
4.2.97: ServerShowResponseSecurityGroup
4.2.98: ServerShowResponseServerType
4.2.99: ServerShowResponseVolume
4.2.100: ServerStaticNatCreateRequest
4.2.101: ServersVolumeResponse
4.2.102: ServerType
4.2.103: ServerTypeListResponse
4.2.104: ServerUpdateRequest
4.2.105: ServerVolumesCreateRequest
4.2.106: ServerVolumesResponse
4.2.107: ServerVolumesUpdateRequest
4.2.108: SnapshotCreateRequest
4.2.109: SnapshotDetailResponse
4.2.110: SnapshotListResponse
4.2.111: SnapshotUpdateRequest
4.2.112: Tag
4.2.113: Volume
4.2.114: VolumeCreateRequest
4.2.115: VolumeCreateRequestV1Dot2
4.2.116: VolumeExtendRequest
4.2.117: VolumeImageMetadataResponse
4.2.118: VolumeListResponse
4.2.119: VolumeListResponseV1Dot2
4.2.120: VolumeQuotaSet
4.2.121: VolumeQuotaSetObject
4.2.122: VolumeRevertRequest
4.2.123: VolumeServer
4.2.124: VolumeServerAttachRequest
4.2.125: VolumeServerAttachResponse
4.2.126: VolumeSetQosRequest
4.2.127: VolumeShowResponse
4.2.128: VolumeShowResponseV1Dot2
4.2.129: VolumeTransferAcceptRequest
4.2.130: VolumeTransferAcceptResponse
4.2.131: VolumeTransferCreateResponse
4.2.132: VolumeTransferListResponse
4.2.133: VolumeTransferRequest
4.2.134: VolumeTransferShowResponse
4.2.135: VolumeTypeDetailResponse
4.2.136: VolumeTypeExtraSpecs
4.2.137: VolumeTypeListResponse
4.2.138: VolumeUpdateRequest
4.2.139: VolumeV1Dot2

1 - Bare Metal Server

Overview

SCP에서 제공하는 IaaS/PaaS 상품을 프로그램적으로 이용할 수 있도록 지원하는 응용 프로그램 인터페이스(Application Programming Interface, API)를 제공합니다.

본 가이드는 Bare Metal Server 서비스에 대한 간략한 설명 및 API를 호출하는 방법을 제공합니다. API는 RESTful API 방식으로 제공되며, JSON 형식으로 응답합니다.

Version

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

Version	Status	Not Before
1.1	CURRENT	-
1.0	DEPRECATED	20251231

OpenAPI URL

https://baremetal.{region}.{environment}.samsungsdscloud.com

Environment and Region List

environment	region
s	kr-west1
s	kr-east1
g	kr-south1
g	kr-south2
g	kr-south3
e	kr-west1
e	kr-east1

1.1 - APIs

1.1.1 - Assign Baremetal Private NAT IP

1.1.1.1 - 1.1

post /v1/baremetals/{baremetal_id}/private-nat-ips

Description

Bare Metal Server Private NAT IP 연결 기능

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	baremetal_id required	Bare Metal Server ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string	None
body	body required		BaremetalServerAssignPrivateNatIpRequest

Responses

HTTP Code	Description	Schema
202	Accepted	BaremetalStaticNatResponseV1Dot1
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/baremetals/{baremetal_id}/private-nat-ips

Request header

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

Request body

{
    "private_nat_id": "a4fd0216cd32442a82733bbb8be0e82b",
    "private_nat_ip_id": "03cd065d8acc4e47b11a11dc1411323e"
}

Example HTTP response

Response 202

{
    "nat_id": "a4fd0216cd32442a82733bbb8be0e82b",
    "nat_ip": "192.170.2.10",
    "nat_ip_id": "20c507a036c447cdb3b19468d8ea62ac",
    "state": "ACTIVE",
    "static_nat_id": "a1b97ae4695b40b0866e86a19cb191d3"
}

1.1.2 - Assign Baremetal Public NAT IP

1.1.2.1 - 1.1

post /v1/baremetals/{baremetal_id}/public-nat-ips

Description

Bare Metal Server NAT IP 연결 기능

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	baremetal_id required	Bare Metal Server ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string	None
body	body required		BaremetalServerAssignPublicNatIpRequest

Responses

HTTP Code	Description	Schema
202	Accepted	BaremetalServerIdResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/baremetals/{baremetal_id}/public-nat-ips

Request header

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

Request body

{
    "public_ip_address_id": "20c507a036c447cdb3b19468d8ea62ac"
}

Example HTTP response

Response 202

{
    "baremetal_id": "20c507a036c447cdb3b19468d8ea62ac"
}

1.1.2.2 - 1.0

post /v1/baremetals/{baremetal_id}/public-nat-ips

Description

Bare Metal Server NAT IP 연결 기능

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	baremetal_id required	Bare Metal Server ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string	None
body	body required		BaremetalServerAssignPublicNatIpRequest

Responses

HTTP Code	Description	Schema
202	Accepted	BaremetalServerIdResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/baremetals/{baremetal_id}/public-nat-ips

Request header

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

Request body

{
    "public_ip_address_id": "20c507a036c447cdb3b19468d8ea62ac"
}

Example HTTP response

Response 202

{
    "baremetal_id": "20c507a036c447cdb3b19468d8ea62ac"
}

1.1.3 - Attach Baremetal Local Subnet

1.1.3.1 - 1.1

put /v1/baremetals/local-subnet/{baremetal_id}/attach

Description

Bare Metal Server 로컬 서브넷 연결 기능

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	baremetal_id required	Bare Metal Server ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string	None
body	body required		LocalSubnetAttachRequest

Responses

HTTP Code	Description	Schema
202	Accepted	LocalSubnetResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/baremetals/local-subnet/{baremetal_id}/attach

Request header

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

Request body

{
    "local_subnet_id": "ab313c43291e4b678f4bacffe10768ae",
    "local_subnet_ip": "192.168.0.1"
}

Example HTTP response

Response 202

{
    "baremetal_id": "20c507a036c447cdb3b19468d8ea62ac",
    "is_success": true
}

1.1.3.2 - 1.0

put /v1/baremetals/local-subnet/{baremetal_id}/attach

Description

Bare Metal Server 로컬 서브넷 연결 기능

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	baremetal_id required	Bare Metal Server ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string	None
body	body required		LocalSubnetAttachRequest

Responses

HTTP Code	Description	Schema
202	Accepted	LocalSubnetResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/baremetals/local-subnet/{baremetal_id}/attach

Request header

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

Request body

{
    "local_subnet_id": "ab313c43291e4b678f4bacffe10768ae",
    "local_subnet_ip": "192.168.0.1"
}

Example HTTP response

Response 202

{
    "baremetal_id": "20c507a036c447cdb3b19468d8ea62ac",
    "is_success": true
}

1.1.4 - Create Baremetals

1.1.4.1 - 1.1

post /v1/baremetals

Description

Bare Metal Server 생성 요청 기능

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
body	body required		BaremetalCreateRequest

Responses

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

Example HTTP request

Request path

/v1/baremetals

Request header

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

Request body

{
    "image_id": "IMAGE-7XFMaJpLsapKvskFMjCtmm",
    "init_script": "init script",
    "lock_enabled": true,
    "os_user_id": "user001",
    "os_user_password": "password",
    "placement_group_name": "pgtest",
    "region_id": "kr-west1",
    "server_details": [
        {
            "bare_metal_local_subnet_id": "ab313c43291e4b678f4bacffe10768ae",
            "bare_metal_local_subnet_ip_address": "192.168.0.1",
            "bare_metal_server_name": "bmserver-001",
            "ip_address": "192.168.0.1",
            "local_disk_partitions": [
                {
                    "mount_point": "/mountpoint",
                    "partition_name": "partitionname",
                    "partition_size": 20,
                    "partition_type": "ext4"
                }
            ],
            "local_disk_type": "flat",
            "nat_enabled": true,
            "public_ip_address_id": "20c507a036c447cdb3b19468d8ea62ac",
            "server_type_id": "PRODUCT-0iT9dNiLr4lVoYmjlY2Vgg",
            "use_hyper_threading": true
        }
    ],
    "subnet_id": "ab313c43291e4b678f4bacffe10768ae",
    "tags": [
        {
            "key": "key",
            "value": "value"
        }
    ],
    "use_placement_group": false,
    "vpc_id": "e58348b1bc9148e5af86500fd4ef99ca"
}

Example HTTP response

Response 202

{
    "account_id": "f5c8e56a4d9b49a8bd89e14758a32d53",
    "request_id": "req-002daa83-52d9-41e8-9b0f-d31d35610f65",
    "resource_id": "20c507a036c447cdb3b19468d8ea62ac"
}

1.1.4.2 - 1.0

post /v1/baremetals

Description

Bare Metal Server 생성 요청 기능

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		BaremetalCreateRequest

Responses

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

Example HTTP request

Request path

/v1/baremetals

Request header

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

Request body

{
    "image_id": "IMAGE-7XFMaJpLsapKvskFMjCtmm",
    "init_script": "init script",
    "lock_enabled": true,
    "os_user_id": "user001",
    "os_user_password": "password",
    "placement_group_name": "pgtest",
    "region_id": "kr-west1",
    "server_details": [
        {
            "bare_metal_local_subnet_id": "ab313c43291e4b678f4bacffe10768ae",
            "bare_metal_local_subnet_ip_address": "192.168.0.1",
            "bare_metal_server_name": "bmserver-001",
            "ip_address": "192.168.0.1",
            "local_disk_partitions": [
                {
                    "mount_point": "/mountpoint",
                    "partition_name": "partitionname",
                    "partition_size": 20,
                    "partition_type": "ext4"
                }
            ],
            "local_disk_type": "flat",
            "nat_enabled": true,
            "public_ip_address_id": "20c507a036c447cdb3b19468d8ea62ac",
            "server_type_id": "PRODUCT-0iT9dNiLr4lVoYmjlY2Vgg",
            "use_hyper_threading": true
        }
    ],
    "subnet_id": "ab313c43291e4b678f4bacffe10768ae",
    "tags": [
        {
            "key": "key",
            "value": "value"
        }
    ],
    "use_placement_group": false,
    "vpc_id": "e58348b1bc9148e5af86500fd4ef99ca"
}

Example HTTP response

Response 202

{
    "account_id": "f5c8e56a4d9b49a8bd89e14758a32d53",
    "request_id": "req-002daa83-52d9-41e8-9b0f-d31d35610f65",
    "resource_id": "20c507a036c447cdb3b19468d8ea62ac"
}

1.1.5 - Delete Baremetal Private NAT IP

1.1.5.1 - 1.1

delete /v1/baremetals/{baremetal_id}/private-nat-ips

Description

Bare Metal Server Private NAT IP 해지 기능

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	baremetal_id required	Bare Metal Server ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	BaremetalStaticNatResponseV1Dot1
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/baremetals/{baremetal_id}/private-nat-ips

Request header

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

Example HTTP response

Response 202

{
    "nat_id": "a4fd0216cd32442a82733bbb8be0e82b",
    "nat_ip": "192.170.2.10",
    "nat_ip_id": "20c507a036c447cdb3b19468d8ea62ac",
    "state": "ACTIVE",
    "static_nat_id": "a1b97ae4695b40b0866e86a19cb191d3"
}

1.1.6 - Delete Baremetal Public NAT IP

1.1.6.1 - 1.1

delete /v1/baremetals/{baremetal_id}/public-nat-ips

Description

Bare Metal Server NAT IP 해지 기능

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	baremetal_id required	Bare Metal Server ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	BaremetalServerIdResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/baremetals/{baremetal_id}/public-nat-ips

Request header

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

Example HTTP response

Response 202

{
    "baremetal_id": "20c507a036c447cdb3b19468d8ea62ac"
}

1.1.6.2 - 1.0

delete /v1/baremetals/{baremetal_id}/public-nat-ips

Description

Bare Metal Server NAT IP 해지 기능

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	baremetal_id required	Bare Metal Server ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	BaremetalServerIdResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/baremetals/{baremetal_id}/public-nat-ips

Request header

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

Example HTTP response

Response 202

{
    "baremetal_id": "20c507a036c447cdb3b19468d8ea62ac"
}

1.1.7 - Delete Baremetals

1.1.7.1 - 1.1

delete /v1/baremetals

Description

Bare Metal Server 해지 요청 기능

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
body	body required		BaremetalTerminateRequest

Responses

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

Example HTTP request

Request path

/v1/baremetals

Request header

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

Request body

{
    "baremetal_id_list": [
        "20c507a036c447cdb3b19468d8ea62ac"
    ]
}

Example HTTP response

Response 202

{
    "account_id": "f5c8e56a4d9b49a8bd89e14758a32d53",
    "request_id": "req-002daa83-52d9-41e8-9b0f-d31d35610f65",
    "resource_id": "20c507a036c447cdb3b19468d8ea62ac"
}

1.1.7.2 - 1.0

delete /v1/baremetals

Description

Bare Metal Server 해지 요청 기능

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		BaremetalTerminateRequest

Responses

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

Example HTTP request

Request path

/v1/baremetals

Request header

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

Request body

{
    "baremetal_id_list": [
        "20c507a036c447cdb3b19468d8ea62ac"
    ]
}

Example HTTP response

Response 202

{
    "account_id": "f5c8e56a4d9b49a8bd89e14758a32d53",
    "request_id": "req-002daa83-52d9-41e8-9b0f-d31d35610f65",
    "resource_id": "20c507a036c447cdb3b19468d8ea62ac"
}

1.1.8 - Detach Baremetal Local Subnet

1.1.8.1 - 1.1

put /v1/baremetals/local-subnet/{baremetal_id}/detach

Description

Bare Metal Server 로컬 서브넷 해지 기능

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	baremetal_id required	Bare Metal Server ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string	None
body	body required		LocalSubnetDetachRequest

Responses

HTTP Code	Description	Schema
202	Accepted	LocalSubnetResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/baremetals/local-subnet/{baremetal_id}/detach

Request header

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

Request body

{
    "local_subnet_id": "ab313c43291e4b678f4bacffe10768ae",
    "local_subnet_ip": "192.168.0.1"
}

Example HTTP response

Response 202

{
    "baremetal_id": "20c507a036c447cdb3b19468d8ea62ac",
    "is_success": true
}

1.1.8.2 - 1.0

put /v1/baremetals/local-subnet/{baremetal_id}/detach

Description

Bare Metal Server 로컬 서브넷 해지 기능

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	baremetal_id required	Bare Metal Server ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string	None
body	body required		LocalSubnetDetachRequest

Responses

HTTP Code	Description	Schema
202	Accepted	LocalSubnetResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/baremetals/local-subnet/{baremetal_id}/detach

Request header

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

Request body

{
    "local_subnet_id": "ab313c43291e4b678f4bacffe10768ae",
    "local_subnet_ip": "192.168.0.1"
}

Example HTTP response

Response 202

{
    "baremetal_id": "20c507a036c447cdb3b19468d8ea62ac",
    "is_success": true
}

1.1.9 - List Baremetal Images

1.1.9.1 - 1.1

get /v1/images

Description

Bare Metal Server 이미지 조회 기능

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
query	region_id required	리전 ID Example : `kr-west1`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ImageListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/images?region_id={region_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 = baremetal 1.1"

Example HTTP response

Response 200

{
    "images": [
        {
            "created_at": "2024-07-11 08:56:59",
            "id": "IMAGE-7XFMaJpLsapKvskFMjCtmm",
            "name": "RHEL 8.8 for BM",
            "os_distro": "RHEL",
            "scp_image_type": "STANDARD",
            "scp_os_version": "8.7"
        }
    ]
}

1.1.9.2 - 1.0

get /v1/images

Description

Bare Metal Server 이미지 조회 기능

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
query	region_id required	리전 ID Example : `kr-west1`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ImageListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/images?region_id={region_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 = baremetal 1.0"

Example HTTP response

Response 200

{
    "images": [
        {
            "created_at": "2024-07-11 08:56:59",
            "id": "IMAGE-7XFMaJpLsapKvskFMjCtmm",
            "name": "RHEL 8.8 for BM",
            "os_distro": "RHEL",
            "scp_image_type": "STANDARD",
            "scp_os_version": "8.7"
        }
    ]
}

1.1.10 - List Baremetal Products

1.1.10.1 - 1.1

get /v1/bm_products

Description

Bare Metal Server Scale type 조회 기능

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
query	image_id optional	이미지 ID Example : `IMAGE-7XFMaJpLsapKvskFMjCtmm`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ProductListResponseV1Dot1
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/bm_products

Request header

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

Example HTTP response

Response 200

{
    "products": [
        {
            "compute_class_type_name": "StandardMetal-2",
            "compute_class_type_value": "s2_metal",
            "cpu_name": "cpu 16 vCore",
            "cpu_unit": "vCPU",
            "cpu_value": "64",
            "created_at": "2024-05-17T00:23:17Z",
            "description": "vCPU 16 │ Memory 128G │ Disk 480G",
            "disk_unit": "GB",
            "disk_value": "480",
            "id": "PRODUCT-0iT9dNiLr4lVoYmjlY2Vgg",
            "memory_name": "server memory 128GB",
            "memory_unit": "GB",
            "memory_value": "128",
            "modified_at": "2024-05-17T00:23:17Z",
            "name": "s2v16m128_metal",
            "name_with_generation": "s2v16m128_metal",
            "os_disk_gb": "480",
            "state": "AVAILABLE",
            "type": "SCALE"
        }
    ]
}

1.1.10.2 - 1.0

get /v1/bm_products

Description

Bare Metal Server Scale type 조회 기능

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
query	image_id optional	이미지 ID Example : `IMAGE-7XFMaJpLsapKvskFMjCtmm`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ProductListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/bm_products

Request header

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

Example HTTP response

Response 200

{
    "products": [
        {
            "attri_name": "attri name",
            "attri_value": "attri value",
            "compute_class_type_name": "StandardMetal-2",
            "compute_class_type_unit": "compute_class_type_unit",
            "compute_class_type_value": "s2_metal",
            "cpu_generation": "cpu generation",
            "cpu_name": "cpu 16 vCore",
            "cpu_unit": "vCPU",
            "cpu_value": "64",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "description": "vCPU 16 │ Memory 128G │ Disk 480G",
            "disk_name": "disk_name",
            "disk_unit": "GB",
            "disk_value": "480",
            "id": "PRODUCT-0iT9dNiLr4lVoYmjlY2Vgg",
            "infiniband_name": "infiniband_name",
            "infiniband_unit": "infiniband_unit",
            "infiniband_value": "infiniband_value",
            "memory_name": "server memory 128GB",
            "memory_unit": "GB",
            "memory_value": "128",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "s2v16m128_metal",
            "name_with_generation": "s2v16m128_metal",
            "socket_name": "socket_name",
            "socket_unit": "socket_unit",
            "socket_value": "socket_value",
            "state": "AVAILABLE",
            "type": "SCALE"
        }
    ]
}

1.1.11 - List Baremetals

1.1.11.1 - 1.1

get /v1/baremetals

Description

Bare Metal Server 목록 조회 기능

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

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	server_name optional	Bare Metal Server 이름 Example : `bmserver-001`	any of [string, null]	None
query	state optional	Bare Metal Server 상태 Example : `RUNNING`	any of [string, null]	None
query	ip optional	Bare Metal Server IP 주소 Example : `192.168.0.1`	any of [string, null]	None
query	vpc_id optional	VPC ID Example : `e58348b1bc9148e5af86500fd4ef99ca`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	BaremetalListResponseV1Dot1
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/baremetals

Request header

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

Example HTTP response

Response 200

{
    "baremetals": [
        {
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "image_id": "IMAGE-7XFMaJpLsapKvskFMjCtmm",
            "image_version": "RHEL 8.7 for BM",
            "lock_enabled": true,
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "network_id": "ab313c43291e4b678f4bacffe10768ae",
            "os_type": "WINDOWS",
            "placement_group_name": "pgtest",
            "policy_ip": "192.168.0.1",
            "product_type_id": "PRODUCT-0iT9dNiLr4lVoYmjlY2Vgg",
            "region_id": "kr-west1",
            "server_name": "bmserver-001",
            "server_type": "s1v8m32_metal",
            "state": "RUNNING",
            "vpc_id": "e58348b1bc9148e5af86500fd4ef99ca"
        }
    ],
    "count": 20
}

1.1.11.2 - 1.0

get /v1/baremetals

Description

Bare Metal Server 목록 조회 기능

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

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	server_name optional	Bare Metal Server 이름 Example : `bmserver-001`	any of [string, null]	None
query	state optional	Bare Metal Server 상태 Example : `RUNNING`	any of [string, null]	None
query	ip optional	Bare Metal Server IP 주소 Example : `192.168.0.1`	any of [string, null]	None
query	vpc_id optional	VPC ID Example : `e58348b1bc9148e5af86500fd4ef99ca`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	BaremetalListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/baremetals

Request header

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

Example HTTP response

Response 200

{
    "baremetals": [
        {
            "account_id": "f5c8e56a4d9b49a8bd89e14758a32d53",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "ef716e80-1fac-4faa-892d-0132fc7f5583",
            "hyper_threading_use": true,
            "id": "20c507a036c447cdb3b19468d8ea62ac",
            "image_id": "IMAGE-7XFMaJpLsapKvskFMjCtmm",
            "image_version": "RHEL 8.7 for BM",
            "init_script": "init script",
            "local_subnet_info": [
                {
                    "interface_name": "ens8f1,bond_serv.2",
                    "local_subnet_id": "ab313c43291e4b678f4bacffe10768ae",
                    "policy_local_subnet_ip": "192.168.0.1",
                    "state": "CREATING",
                    "vlan_id": 500,
                    "vni_role_name": "mgmtJ4dzQBo"
                }
            ],
            "lock_enabled": true,
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "ef716e80-1fac-4faa-892d-0132fc7f5583",
            "network_id": "ab313c43291e4b678f4bacffe10768ae",
            "os_type": "WINDOWS",
            "placement_group_name": "pgtest",
            "policy_ip": "192.168.0.1",
            "policy_nat": "192.168.0.1",
            "policy_use_nat": true,
            "product_type_id": "PRODUCT-0iT9dNiLr4lVoYmjlY2Vgg",
            "public_nat_status": "ACTIVE",
            "region_id": "kr-west1",
            "root_account": "rootaccount",
            "server_name": "bmserver-001",
            "server_type": "s1v8m32_metal",
            "state": "RUNNING",
            "time_zone": "Asia/Seoul",
            "use_local_subnet": true,
            "vpc_id": "e58348b1bc9148e5af86500fd4ef99ca"
        }
    ],
    "count": 20
}

1.1.12 - Lock Baremetal

1.1.12.1 - 1.1

put /v1/baremetals/{baremetal_id}/lock

Description

Bare Metal Server Lock 활성화 기능

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	baremetal_id required	Bare Metal Server ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string	None

Responses

HTTP Code	Description	Schema
200	OK	BaremetalActionResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/baremetals/{baremetal_id}/lock

Request header

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

Example HTTP response

Response 200

{
    "baremetal_id": "20c507a036c447cdb3b19468d8ea62ac"
}

1.1.12.2 - 1.0

put /v1/baremetals/{baremetal_id}/lock

Description

Bare Metal Server Lock 활성화 기능

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	baremetal_id required	Bare Metal Server ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string	None

Responses

HTTP Code	Description	Schema
200	OK	BaremetalActionResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/baremetals/{baremetal_id}/lock

Request header

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

Example HTTP response

Response 200

{
    "baremetal_id": "20c507a036c447cdb3b19468d8ea62ac"
}

1.1.13 - Show Baremetal

1.1.13.1 - 1.1

get /v1/baremetals/{baremetal_id}

Description

Bare Metal Server 상세 조회 기능

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	baremetal_id required	Bare Metal Server ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string	None

Responses

HTTP Code	Description	Schema
200	OK	BaremetalShowResponseV1Dot1
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/baremetals/{baremetal_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 = baremetal 1.1"

Example HTTP response

Response 200

{
    "account_id": "f5c8e56a4d9b49a8bd89e14758a32d53",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "ef716e80-1fac-4faa-892d-0132fc7f5583",
    "hyper_threading_use": true,
    "id": "20c507a036c447cdb3b19468d8ea62ac",
    "image_id": "IMAGE-7XFMaJpLsapKvskFMjCtmm",
    "image_version": "RHEL 8.7 for BM",
    "init_script": "init script",
    "local_subnet_info": [
        {
            "interface_name": "ens8f1,bond_serv.2",
            "local_subnet_id": "ab313c43291e4b678f4bacffe10768ae",
            "policy_local_subnet_ip": "192.168.0.1",
            "state": "CREATING",
            "vlan_id": 500,
            "vni_role_name": "mgmtJ4dzQBo"
        }
    ],
    "lock_enabled": true,
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "ef716e80-1fac-4faa-892d-0132fc7f5583",
    "network_id": "ab313c43291e4b678f4bacffe10768ae",
    "os_type": "WINDOWS",
    "placement_group_name": "pgtest",
    "policy_ip": "192.168.0.1",
    "private_nat_info": {
        "nat_id": "a4fd0216cd32442a82733bbb8be0e82b",
        "nat_ip": "192.170.2.10",
        "nat_ip_id": "20c507a036c447cdb3b19468d8ea62ac",
        "state": "ACTIVE",
        "static_nat_id": "a1b97ae4695b40b0866e86a19cb191d3"
    },
    "product_type_id": "PRODUCT-0iT9dNiLr4lVoYmjlY2Vgg",
    "public_nat_info": {
        "nat_id": "a4fd0216cd32442a82733bbb8be0e82b",
        "nat_ip": "192.170.2.10",
        "nat_ip_id": "20c507a036c447cdb3b19468d8ea62ac",
        "state": "ACTIVE",
        "static_nat_id": "a1b97ae4695b40b0866e86a19cb191d3"
    },
    "region_id": "kr-west1",
    "root_account": "rootaccount",
    "server_name": "bmserver-001",
    "server_type": "s1v8m32_metal",
    "state": "RUNNING",
    "time_zone": "Asia/Seoul",
    "use_local_subnet": true,
    "vpc_id": "e58348b1bc9148e5af86500fd4ef99ca"
}

1.1.13.2 - 1.0

get /v1/baremetals/{baremetal_id}

Description

Bare Metal Server 상세 조회 기능

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	baremetal_id required	Bare Metal Server ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string	None

Responses

HTTP Code	Description	Schema
200	OK	BaremetalShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/baremetals/{baremetal_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 = baremetal 1.0"

Example HTTP response

Response 200

{
    "account_id": "f5c8e56a4d9b49a8bd89e14758a32d53",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "ef716e80-1fac-4faa-892d-0132fc7f5583",
    "hyper_threading_use": true,
    "id": "20c507a036c447cdb3b19468d8ea62ac",
    "image_id": "IMAGE-7XFMaJpLsapKvskFMjCtmm",
    "image_version": "RHEL 8.7 for BM",
    "init_script": "init script",
    "local_subnet_info": [
        {
            "interface_name": "ens8f1,bond_serv.2",
            "local_subnet_id": "ab313c43291e4b678f4bacffe10768ae",
            "policy_local_subnet_ip": "192.168.0.1",
            "state": "CREATING",
            "vlan_id": 500,
            "vni_role_name": "mgmtJ4dzQBo"
        }
    ],
    "lock_enabled": true,
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "ef716e80-1fac-4faa-892d-0132fc7f5583",
    "network_id": "ab313c43291e4b678f4bacffe10768ae",
    "os_type": "WINDOWS",
    "placement_group_name": "pgtest",
    "policy_ip": "192.168.0.1",
    "policy_nat": "192.168.0.1",
    "policy_use_nat": true,
    "product_type_id": "PRODUCT-0iT9dNiLr4lVoYmjlY2Vgg",
    "public_nat_status": "ACTIVE",
    "region_id": "kr-west1",
    "root_account": "rootaccount",
    "server_name": "bmserver-001",
    "server_type": "s1v8m32_metal",
    "state": "RUNNING",
    "time_zone": "Asia/Seoul",
    "use_local_subnet": true,
    "vpc_id": "e58348b1bc9148e5af86500fd4ef99ca"
}

1.1.14 - Start Baremetals

1.1.14.1 - 1.1

post /v1/baremetals/start

Description

Bare Metal Server 시작(부팅) 요청 기능

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
body	body required		BaremetalsOperationRequest

Responses

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

Example HTTP request

Request path

/v1/baremetals/start

Request header

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

Request body

{
    "bare_metal_server_ids": [
        "20c507a036c447cdb3b19468d8ea62ac"
    ]
}

Example HTTP response

Response 202

{
    "account_id": "f5c8e56a4d9b49a8bd89e14758a32d53",
    "request_id": "req-002daa83-52d9-41e8-9b0f-d31d35610f65",
    "resource_id": "20c507a036c447cdb3b19468d8ea62ac"
}

1.1.14.2 - 1.0

post /v1/baremetals/start

Description

Bare Metal Server 시작(부팅) 요청 기능

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		BaremetalsOperationRequest

Responses

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

Example HTTP request

Request path

/v1/baremetals/start

Request header

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

Request body

{
    "bare_metal_server_ids": [
        "20c507a036c447cdb3b19468d8ea62ac"
    ]
}

Example HTTP response

Response 202

{
    "account_id": "f5c8e56a4d9b49a8bd89e14758a32d53",
    "request_id": "req-002daa83-52d9-41e8-9b0f-d31d35610f65",
    "resource_id": "20c507a036c447cdb3b19468d8ea62ac"
}

1.1.15 - Stop Baremetals

1.1.15.1 - 1.1

post /v1/baremetals/stop

Description

Bare Metal Server 중지 요청 기능

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
body	body required		BaremetalsOperationRequest

Responses

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

Example HTTP request

Request path

/v1/baremetals/stop

Request header

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

Request body

{
    "bare_metal_server_ids": [
        "20c507a036c447cdb3b19468d8ea62ac"
    ]
}

Example HTTP response

Response 202

{
    "account_id": "f5c8e56a4d9b49a8bd89e14758a32d53",
    "request_id": "req-002daa83-52d9-41e8-9b0f-d31d35610f65",
    "resource_id": "20c507a036c447cdb3b19468d8ea62ac"
}

1.1.15.2 - 1.0

post /v1/baremetals/stop

Description

Bare Metal Server 중지 요청 기능

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		BaremetalsOperationRequest

Responses

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

Example HTTP request

Request path

/v1/baremetals/stop

Request header

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

Request body

{
    "bare_metal_server_ids": [
        "20c507a036c447cdb3b19468d8ea62ac"
    ]
}

Example HTTP response

Response 202

{
    "account_id": "f5c8e56a4d9b49a8bd89e14758a32d53",
    "request_id": "req-002daa83-52d9-41e8-9b0f-d31d35610f65",
    "resource_id": "20c507a036c447cdb3b19468d8ea62ac"
}

1.1.16 - Unlock Baremetal

1.1.16.1 - 1.1

put /v1/baremetals/{baremetal_id}/unlock

Description

Bare Metal Server Lock 해지 기능

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	baremetal_id required	Bare Metal Server ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string	None

Responses

HTTP Code	Description	Schema
200	OK	BaremetalActionResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/baremetals/{baremetal_id}/unlock

Request header

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

Example HTTP response

Response 200

{
    "baremetal_id": "20c507a036c447cdb3b19468d8ea62ac"
}

1.1.16.2 - 1.0

put /v1/baremetals/{baremetal_id}/unlock

Description

Bare Metal Server Lock 해지 기능

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	baremetal_id required	Bare Metal Server ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string	None

Responses

HTTP Code	Description	Schema
200	OK	BaremetalActionResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/baremetals/{baremetal_id}/unlock

Request header

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

Example HTTP response

Response 200

{
    "baremetal_id": "20c507a036c447cdb3b19468d8ea62ac"
}

1.2 - Models

1.2.1 - AsyncResponse

Name	Description	Schema
account_id required	Account ID Example : `f5c8e56a4d9b49a8bd89e14758a32d53`	string
request_id required	Request ID Example : `req-002daa83-52d9-41e8-9b0f-d31d35610f65`	string
resource_id required	자원 ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string

1.2.2 - BaremetalActionResponse

Name	Description	Schema	Default
baremetal_id required	Bare Metal Server ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string

1.2.3 - BaremetalCreateRequest

Name	Description	Schema
image_id required	이미지 ID Example : `IMAGE-7XFMaJpLsapKvskFMjCtmm`	string
init_script optional	Init script Example : `init script`	any of [string, null]
lock_enabled optional	Lock 사용 여부 Example : `True`	boolean
os_user_id required	OS 유저 ID Example : `user001`	string
os_user_password required	OS 유저 패스워드 Example : `password`	string
placement_group_name optional	Placement Group 이름 Example : `pgtest`	any of [string, null]
region_id required	리전 ID Example : `kr-west1`	string
server_details required	서버별 세부 설정	array[ServerDetailsRequest]
subnet_id required	Subnet ID Example : `ab313c43291e4b678f4bacffe10768ae`	string
tags optional	태그	any of [array[TagRequest], null]
use_placement_group optional	placement group 사용 여부 Example : `False`	boolean
vpc_id required	VPC ID Example : `e58348b1bc9148e5af86500fd4ef99ca`	string

1.2.4 - BaremetalListResponse

Name	Description	Schema	Default
baremetals required		array[BaremetalShowResponse]
count required	대수 Example : `20`	any of [integer, null]

1.2.5 - BaremetalListResponseV1Dot1

Name	Description	Schema	Default
baremetals required		array[BaremetalListV1Dot1]
count required	대수 Example : `20`	integer

1.2.6 - BaremetalListV1Dot1

Name	Description	Schema
created_at required	생성 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	생성자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
id required	ID Example : `0fdd87aab8cb46f59b7c1f81ed03fb3e`	string
image_id required	이미지 ID Example : `IMAGE-7XFMaJpLsapKvskFMjCtmm`	string
image_version required	이미지 버전 Example : `RHEL 8.7 for BM`	string
lock_enabled optional	Lock 사용 여부 Example : `True`	boolean
modified_at required	수정 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	수정자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
network_id required	Subnet ID Example : `ab313c43291e4b678f4bacffe10768ae`	string
os_type required	OS type Example : `WINDOWS`	string
placement_group_name optional	Placement Group 이름 Example : `pgtest`	any of [string, null]
policy_ip required	정책 IP Example : `192.168.0.1`	string
product_type_id required	Bare Metal Server 스케일 ID Example : `PRODUCT-0iT9dNiLr4lVoYmjlY2Vgg`	string
region_id required	리전 ID Example : `kr-west1`	string
server_name required	Bare Metal Server 이름 Example : `bmserver-001`	string
server_type required	Bare Metal Server 스케일 타입 Example : `s1v8m32_metal`	string
state required	Bare Metal Server 상태 Example : `RUNNING`	string
vpc_id required	VPC ID Example : `e58348b1bc9148e5af86500fd4ef99ca`	string

1.2.7 - BaremetalServerAssignPrivateNatIpRequest

Name	Description	Schema	Default
private_nat_id required	Private NAT ID Example : `a4fd0216cd32442a82733bbb8be0e82b`	string
private_nat_ip_id required	Private NAT IP ID Example : `03cd065d8acc4e47b11a11dc1411323e`	string

1.2.8 - BaremetalServerAssignPublicNatIpRequest

Name	Description	Schema	Default
public_ip_address_id required	Public NAT ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string

1.2.9 - BaremetalServerIdResponse

Name	Description	Schema	Default
baremetal_id required	Bare Metal Server ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string

1.2.10 - BaremetalShowResponse

Name	Description	Schema
account_id required	Account ID Example : `f5c8e56a4d9b49a8bd89e14758a32d53`	string
created_at required	생성 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	생성자 Example : `ef716e80-1fac-4faa-892d-0132fc7f5583`	string
hyper_threading_use required	Hyper threading 사용 여부 Example : `True`	boolean
id required	Bare Metal Server ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string
image_id required	이미지 ID Example : `IMAGE-7XFMaJpLsapKvskFMjCtmm`	string
image_version required	이미지 버전 Example : `RHEL 8.7 for BM`	string
init_script required	Init script Example : `init script`	string
local_subnet_info optional	Local Subnet 정보	any of [array[LocalSubnetInfoResponse], null]
lock_enabled optional	Lock 사용 여부 Example : `True`	boolean
modified_at required	수정 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	수정자 Example : `ef716e80-1fac-4faa-892d-0132fc7f5583`	string
network_id required	Subnet ID Example : `ab313c43291e4b678f4bacffe10768ae`	string
os_type required	OS type Example : `WINDOWS`	string
placement_group_name optional	Placement Group 이름 Example : `pgtest`	any of [string, null]
policy_ip required	정책 IP Example : `192.168.0.1`	string
policy_nat optional	Public NAT IP Example : `192.168.0.1`	any of [string, null]
policy_use_nat optional	Public NAT 사용 여부 Example : `True`	boolean
product_type_id required	Bare Metal Server 스케일 ID Example : `PRODUCT-0iT9dNiLr4lVoYmjlY2Vgg`	string
public_nat_status optional	Public NAT 상태 Example : `ACTIVE`	any of [string, null]
region_id required	리전 ID Example : `kr-west1`	string
root_account required	루트 계정 Example : `rootaccount`	string
server_name required	Bare Metal Server 이름 Example : `bmserver-001`	string
server_type required	Bare Metal Server 스케일 타입 Example : `s1v8m32_metal`	string
state required	Bare Metal Server 상태 Example : `RUNNING`	string
time_zone required	타임존 Example : `Asia/Seoul`	string
use_local_subnet optional	로컬 서브넷 사용 여부 Example : `True`	boolean
vpc_id required	VPC ID Example : `e58348b1bc9148e5af86500fd4ef99ca`	string

1.2.11 - BaremetalShowResponseV1Dot1

Name	Description	Schema
account_id required	Account ID Example : `f5c8e56a4d9b49a8bd89e14758a32d53`	string
created_at required	생성 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	생성자 Example : `ef716e80-1fac-4faa-892d-0132fc7f5583`	string
hyper_threading_use required	Hyper threading 사용 여부 Example : `True`	boolean
id required	Bare Metal Server ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string
image_id required	이미지 ID Example : `IMAGE-7XFMaJpLsapKvskFMjCtmm`	string
image_version required	이미지 버전 Example : `RHEL 8.7 for BM`	string
init_script required	Init script Example : `init script`	string
local_subnet_info optional	Local Subnet 정보	any of [array[LocalSubnetInfoResponse], null]
lock_enabled optional	Lock 사용 여부 Example : `True`	boolean
modified_at required	수정 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	수정자 Example : `ef716e80-1fac-4faa-892d-0132fc7f5583`	string
network_id required	Subnet ID Example : `ab313c43291e4b678f4bacffe10768ae`	string
os_type required	OS type Example : `WINDOWS`	string
placement_group_name optional	Placement Group 이름 Example : `pgtest`	any of [string, null]
policy_ip required	정책 IP Example : `192.168.0.1`	string
private_nat_info optional	Private NAT 정보	any of [BaremetalStaticNatResponseV1Dot1, null]
product_type_id required	Bare Metal Server 스케일 ID Example : `PRODUCT-0iT9dNiLr4lVoYmjlY2Vgg`	string
public_nat_info optional	Public NAT 정보	any of [BaremetalStaticNatResponseV1Dot1, null]
region_id required	리전 ID Example : `kr-west1`	string
root_account required	루트 계정 Example : `rootaccount`	string
server_name required	Bare Metal Server 이름 Example : `bmserver-001`	string
server_type required	Bare Metal Server 스케일 타입 Example : `s1v8m32_metal`	string
state required	Bare Metal Server 상태 Example : `RUNNING`	string
time_zone required	타임존 Example : `Asia/Seoul`	string
use_local_subnet optional	로컬 서브넷 사용 여부 Example : `True`	boolean
vpc_id required	VPC ID Example : `e58348b1bc9148e5af86500fd4ef99ca`	string

1.2.12 - BaremetalsOperationRequest

Name	Description	Schema	Default
bare_metal_server_ids required	Bare Metal Server ID 리스트 Example : `['20c507a036c447cdb3b19468d8ea62ac']`	array[object]

1.2.13 - BaremetalStaticNatResponseV1Dot1

Name	Description	Schema
nat_id optional	NAT ID Example : `a4fd0216cd32442a82733bbb8be0e82b`	any of [string, null]
nat_ip required	NAT IP Example : `192.170.2.10`	string
nat_ip_id required	NAT IP ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string
state required	Static NAT 상태 Example : `ACTIVE`	string
static_nat_id optional	Static NAT ID Example : `a1b97ae4695b40b0866e86a19cb191d3`	any of [string, null]

1.2.14 - BaremetalTerminateRequest

Name	Description	Schema	Default
baremetal_id_list required	Bare Metal Server ID 리스트 Example : `['20c507a036c447cdb3b19468d8ea62ac']`	array[object]

1.2.15 - ImageListResponse

Name	Description	Schema	Default
images required		array[ImageShowResponse]

1.2.16 - ImageShowResponse

Name	Description	Schema
created_at required	생성 시간 Example : `2024-07-11 08:56:59`	string
id required	이미지 ID Example : `IMAGE-7XFMaJpLsapKvskFMjCtmm`	string
name required	이미지명 Example : `RHEL 8.8 for BM`	string
os_distro required	OS type Example : `RHEL`	string
scp_image_type required	이미지 타입 Example : `STANDARD`	string
scp_os_version required	OS 버전 Example : `8.7`	string

1.2.17 - LocalDiskPartitionsRequest

Name	Description	Schema
mount_point required	마운트 포인트 Example : `/mountpoint`	string
partition_name optional	파티션명 Example : `partitionname`	any of [string, null]
partition_size required	파티션 크기 Example : `20`	integer
partition_type required	파티션 타입 Example : `ext4`	string

1.2.18 - LocalSubnetAttachRequest

Name	Description	Schema	Default
local_subnet_id required	로컬 Subnet ID Example : `ab313c43291e4b678f4bacffe10768ae`	string
local_subnet_ip optional	로컬 Subnet IP Example : `192.168.0.1`	any of [string, null]

1.2.19 - LocalSubnetDetachRequest

Name	Description	Schema	Default
local_subnet_id required	로컬 Subnet ID Example : `ab313c43291e4b678f4bacffe10768ae`	string
local_subnet_ip required	로컬 Subnet IP Example : `192.168.0.1`	string

1.2.20 - LocalSubnetInfoResponse

Name	Description	Schema
interface_name required	Interface명 Example : `ens8f1,bond_serv.2`	string
local_subnet_id required	로컬 Subnet ID Example : `ab313c43291e4b678f4bacffe10768ae`	string
policy_local_subnet_ip required	로컬 Subnet IP Example : `192.168.0.1`	string
state required	Local subnet IP의 상태 Example : `CREATING`	string
vlan_id required	Vlan ID Example : `500`	string
vni_role_name required	VNI Role Name Example : `mgmtJ4dzQBo`	string

1.2.21 - LocalSubnetResponse

Name	Description	Schema	Default
baremetal_id required	Bare Metal Server ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string
is_success optional	success flag Example : `True`	boolean

1.2.22 - ProductListResponse

Name	Description	Schema	Default
products required	Product List	array[ProductShowResponse]

1.2.23 - ProductListResponseV1Dot1

Name	Description	Schema	Default
products required	Product List	array[ProductShowResponseV1Dot1]

1.2.24 - ProductShowResponse

Name	Description	Schema
attri_name required	Attribute 이름 Example : `attri name`	string
attri_value required	Attribute value Example : `attri value`	string
compute_class_type_name required	Compute class type 이름 Example : `StandardMetal-2`	string
compute_class_type_unit required	Compute class type unit Example : `compute_class_type_unit`	string
compute_class_type_value required	Compute class type value Example : `s2_metal`	string
cpu_generation required	CPU generation Example : `cpu generation`	string
cpu_name required	CPU 이름 Example : `cpu 16 vCore`	string
cpu_unit required	CPU unit Example : `vCPU`	string
cpu_value required	CPU value Example : `64`	string
created_at required	생성 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	생성자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
description required	설명 Example : `vCPU 16 │ Memory 128G │ Disk 480G`	string
disk_name required	Disk명 Example : `disk_name`	string
disk_unit required	Disk unit Example : `GB`	string
disk_value required	Disk value Example : `480`	string
id required	ID Example : `PRODUCT-0iT9dNiLr4lVoYmjlY2Vgg`	string
infiniband_name required	InfiniBand 이름 Example : `infiniband_name`	string
infiniband_unit required	InfiniBand unit Example : `infiniband_unit`	string
infiniband_value required	Infiniband value Example : `infiniband_value`	string
memory_name required	Memroy 이름 Example : `server memory 128GB`	string
memory_unit required	Memory unit Example : `GB`	string
memory_value required	Memory value Example : `128`	string
modified_at required	수정 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	수정자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
name required	이름 Example : `s2v16m128_metal`	string
name_with_generation required	세대 Example : `s2v16m128_metal`	string
socket_name required	Socket 이름 Example : `socket_name`	string
socket_unit required	Socket unit Example : `socket_unit`	string
socket_value required	Socket value Example : `socket_value`	string
state required	State Example : `AVAILABLE`	string
type required	유형 Example : `SCALE`	string

1.2.25 - ProductShowResponseV1Dot1

Name	Description	Schema
compute_class_type_name required	Compute class type 이름 Example : `StandardMetal-2`	string
compute_class_type_value required	Compute class type value Example : `s2_metal`	string
cpu_name required	CPU 이름 Example : `cpu 16 vCore`	any of [string, null]
cpu_unit required	CPU unit Example : `vCPU`	string
cpu_value required	CPU value Example : `64`	string
created_at required	생성 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
description required	설명 Example : `vCPU 16 │ Memory 128G │ Disk 480G`	any of [string, null]
disk_unit required	Disk unit Example : `GB`	any of [string, null]
disk_value required	Disk value Example : `480`	string
id required	ID Example : `PRODUCT-0iT9dNiLr4lVoYmjlY2Vgg`	string
memory_name required	Memroy 이름 Example : `server memory 128GB`	any of [string, null]
memory_unit required	Memory unit Example : `GB`	any of [string, null]
memory_value required	Memory value Example : `128`	string
modified_at required	수정 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
name required	이름 Example : `s2v16m128_metal`	string
name_with_generation required	세대 Example : `s2v16m128_metal`	string
os_disk_gb required	OS Disk 값 Example : `480`	string
state required	State Example : `AVAILABLE`	string
type required	유형 Example : `SCALE`	string

1.2.26 - ServerDetailsRequest

Name	Description	Schema
bare_metal_local_subnet_id optional	로컬 Subnet ID Example : `ab313c43291e4b678f4bacffe10768ae`	any of [string, null]
bare_metal_local_subnet_ip_address optional	로컬 Subnet IP Example : `192.168.0.1`	any of [string, null]
bare_metal_server_name required	Bare Metal Server 이름 Example : `bmserver-001`	string
ip_address optional	Private IP Example : `192.168.0.1`	any of [string, null]
local_disk_partitions optional	로컬 디스크 파티션	any of [array[LocalDiskPartitionsRequest], null]
local_disk_type optional	로컬 디스크 타입 Example : `flat`	any of [string, null]
nat_enabled required	Public NAT 사용 여부 Example : `True`	boolean
public_ip_address_id optional	Public NAT ID Example : `20c507a036c447cdb3b19468d8ea62ac`	any of [string, null]
server_type_id required	Server Type ID Example : `PRODUCT-0iT9dNiLr4lVoYmjlY2Vgg`	string
use_hyper_threading optional	Hyper threading 사용 여부 Example : `True`	boolean

1.2.27 - TagRequest

Name	Description	Schema	Default
key required	key Example : `key`	string
value optional	value Example : `value`	any of [string, null]

2 - Cloud Functions

Overview

SCP에서 제공하는 IaaS/PaaS 상품을 프로그램적으로 이용할 수 있도록 지원하는 응용 프로그램 인터페이스(Application Programming Interface, API)를 제공합니다.

본 가이드는 Cloud Function 서비스에 대한 간략한 설명 및 API를 호출하는 방법을 제공합니다. API는 RESTful API 방식으로 제공되며, JSON 형식으로 응답합니다.

Version

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

Version	Status	Not Before
1.3	CURRENT	-
1.2	DEPRECATED	20260630
1.1	DEPRECATED	20260430
1.0	DEPRECATED	20251231

OpenAPI URL

https://scf.{region}.{environment}.samsungsdscloud.com

Environment and Region List

environment	region
s	kr-west1
s	kr-east1
g	kr-south1
g	kr-south2
g	kr-south3
e	kr-west1
e	kr-east1

2.1 - APIs

2.1.1 - Approve PrivateLink Endpoint

2.1.1.1 - 1.3

put /v1/cloud-functions/{cloud_function_id}/configurations/privatelink-endpoints/{endpoint_id}/approval

Description

PrivateLink Endpoint 승인

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
path	endpoint_id required	Endpoint Id Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
body	body required		PrivateLinkEndpointApproval

Responses

HTTP Code	Description	Schema
200	OK	PrivateLinkEndpoint
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/privatelink-endpoints/{endpoint_id}/approval

Request header

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

Request body

{
    "type": "APPROVE"
}

Example HTTP response

Response 200

{
    "endpoint": {
        "endpoint_alias": "sample",
        "endpoint_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
        "service_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
        "state": "Active"
    }
}

2.1.1.2 - 1.2

put /v1/cloud-functions/{cloud_function_id}/configurations/privatelink-endpoints/{endpoint_id}/approval

Description

PrivateLink Endpoint 승인

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.2	20260630

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
path	endpoint_id required	Endpoint Id Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
body	body required		PrivateLinkEndpointApproval

Responses

HTTP Code	Description	Schema
200	OK	PrivateLinkEndpoint
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/privatelink-endpoints/{endpoint_id}/approval

Request header

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

Request body

{
    "type": "APPROVE"
}

Example HTTP response

Response 200

{
    "endpoint": {
        "endpoint_alias": "sample",
        "endpoint_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
        "service_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
        "state": "Active"
    }
}

2.1.2 - Check Function Name Duplication

2.1.2.1 - 1.3

get /v1/cloud-functions/check-duplication

Description

Cloud Function 이름 중복 조회

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
query	name required	이름 Example : `sample-function-name`	string	None

Responses

HTTP Code	Description	Schema
200	OK	DuplicationShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/check-duplication?name={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 = scf 1.3"

Example HTTP response

Response 200

{
    "result": true
}

2.1.2.2 - 1.2

get /v1/cloud-functions/check-duplication

Description

Cloud Function 이름 중복 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.2	20260630

Parameters

Type	Name	Description	Schema	Default
query	name required	이름 Example : `sample-function-name`	string	None

Responses

HTTP Code	Description	Schema
200	OK	DuplicationShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/check-duplication?name={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 = scf 1.2"

Example HTTP response

Response 200

{
    "result": true
}

2.1.2.3 - 1.1

get /v1/cloud-functions/check-duplication

Description

Cloud Function 이름 중복 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260430

Parameters

Type	Name	Description	Schema	Default
query	name required	이름 Example : `sample-function-name`	string	None

Responses

HTTP Code	Description	Schema
200	OK	DuplicationShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/check-duplication?name={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 = scf 1.1"

Example HTTP response

Response 200

{
    "result": true
}

2.1.2.4 - 1.0

get /v1/cloud-functions/check-duplication

Description

Cloud Function 이름 중복 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
query	name required	이름 Example : `sample-function-name`	string	None

Responses

HTTP Code	Description	Schema
200	OK	DuplicationShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/check-duplication?name={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 = scf 1.0"

Example HTTP response

Response 200

{
    "result": true
}

2.1.3 - Connect PrivateLink Endpoint

2.1.3.1 - 1.3

put /v1/cloud-functions/{cloud_function_id}/configurations/privatelink-endpoints/{endpoint_id}/connection

Description

PrivateLink Endpoint 연결

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
path	endpoint_id required	Endpoint Id Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
body	body required		PrivateLinkEndpointConnection

Responses

HTTP Code	Description	Schema
200	OK	PrivateLinkEndpoint
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/privatelink-endpoints/{endpoint_id}/connection

Request header

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

Request body

{
    "type": "RECONNECT"
}

Example HTTP response

Response 200

{
    "endpoint": {
        "endpoint_alias": "sample",
        "endpoint_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
        "service_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
        "state": "Active"
    }
}

2.1.3.2 - 1.2

put /v1/cloud-functions/{cloud_function_id}/configurations/privatelink-endpoints/{endpoint_id}/connection

Description

PrivateLink Endpoint 연결

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.2	20260630

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
path	endpoint_id required	Endpoint Id Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
body	body required		PrivateLinkEndpointConnection

Responses

HTTP Code	Description	Schema
200	OK	PrivateLinkEndpoint
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/privatelink-endpoints/{endpoint_id}/connection

Request header

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

Request body

{
    "type": "RECONNECT"
}

Example HTTP response

Response 200

{
    "endpoint": {
        "endpoint_alias": "sample",
        "endpoint_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
        "service_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
        "state": "Active"
    }
}

2.1.4 - Create Cloud Function

2.1.4.1 - 1.3

post /v1/cloud-functions

Description

함수 생성

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
body	body required		CloudFunctionCreateRequest

Responses

HTTP Code	Description	Schema
202	Accepted	CloudFunctionCreateResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions

Request header

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

Request body

{
    "content": "sample",
    "name": "sample-function-name",
    "runtime": "Node.js:20",
    "tags": [
        {
            "key": "",
            "value": ""
        }
    ]
}

Example HTTP response

Response 202

{
    "id": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "message": "Description",
    "state": "READY"
}

2.1.4.2 - 1.2

post /v1/cloud-functions

Description

함수 생성

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.2	20260630

Parameters

Type	Name	Description	Schema	Default
body	body required		CloudFunctionCreateRequest

Responses

HTTP Code	Description	Schema
202	Accepted	CloudFunctionCreateResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions

Request header

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

Request body

{
    "content": "sample",
    "name": "sample-function-name",
    "runtime": "Node.js:20",
    "tags": [
        {
            "key": "",
            "value": ""
        }
    ]
}

Example HTTP response

Response 202

{
    "id": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "message": "Description",
    "state": "READY"
}

2.1.4.3 - 1.1

post /v1/cloud-functions

Description

함수 생성

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260430

Parameters

Type	Name	Description	Schema	Default
body	body required		CloudFunctionCreateRequest

Responses

HTTP Code	Description	Schema
202	Accepted	CloudFunctionCreateResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions

Request header

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

Request body

{
    "content": "sample",
    "name": "sample-function-name",
    "runtime": "Node.js:20",
    "tags": [
        {
            "key": "",
            "value": ""
        }
    ]
}

Example HTTP response

Response 202

{
    "id": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "message": "Description",
    "state": "READY"
}

2.1.4.4 - 1.0

post /v1/cloud-functions

Description

함수 생성

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		CloudFunctionCreateRequest

Responses

HTTP Code	Description	Schema
202	Accepted	CloudFunctionCreateResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions

Request header

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

Request body

{
    "content": "sample",
    "name": "sample-function-name",
    "runtime": "Node.js:20",
    "tags": [
        {
            "key": "",
            "value": ""
        }
    ]
}

Example HTTP response

Response 202

{
    "id": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "message": "Description",
    "state": "READY"
}

2.1.5 - Create Cloud Function Apigateway Trigger

2.1.5.1 - 1.3

post /v1/triggers/apigateway

Description

Cloud Function 트리거 생성

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
body	body required		ApigatewayTriggerCreateRequest

Responses

HTTP Code	Description	Schema
200	OK	TriggerCreateResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/triggers/apigateway

Request header

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

Request body

{
    "apigateway_api_id": "31e749b7b260868f441e862b",
    "apigateway_stage_name": "sample",
    "cloud_function_id": "8c9f6c1c928a45b4bbd1e4da5531d656"
}

Example HTTP response

Response 200

{
    "alias": "$LATEST",
    "cloud_function_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "triggers": [
        {
            "schedule": "* * * * 0",
            "timezone": "Asia/Tokyo",
            "trigger_id": 1,
            "trigger_name": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_target_account_id": "617b3d0e90c24a5fa1f65a3824861354",
            "trigger_target_srn": "srn:dev2::f32265726b694b32920aa3b111f4c715:::iam:user/9abd88ba08434777a8ca168e799eebbe",
            "trigger_target_uuid": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_type": "apigateway"
        }
    ]
}

2.1.5.2 - 1.2

post /v1/triggers/apigateway

Description

Cloud Function 트리거 생성

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.2	20260630

Parameters

Type	Name	Description	Schema	Default
body	body required		ApigatewayTriggerCreateRequest

Responses

HTTP Code	Description	Schema
200	OK	TriggerCreateResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/triggers/apigateway

Request header

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

Request body

{
    "apigateway_api_id": "31e749b7b260868f441e862b",
    "apigateway_stage_name": "sample",
    "cloud_function_id": "8c9f6c1c928a45b4bbd1e4da5531d656"
}

Example HTTP response

Response 200

{
    "alias": "$LATEST",
    "cloud_function_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "triggers": [
        {
            "schedule": "* * * * 0",
            "timezone": "Asia/Tokyo",
            "trigger_id": 1,
            "trigger_name": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_target_account_id": "617b3d0e90c24a5fa1f65a3824861354",
            "trigger_target_srn": "srn:dev2::f32265726b694b32920aa3b111f4c715:::iam:user/9abd88ba08434777a8ca168e799eebbe",
            "trigger_target_uuid": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_type": "apigateway"
        }
    ]
}

2.1.5.3 - 1.1

post /v1/triggers/apigateway

Description

Cloud Function 트리거 생성

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260430

Parameters

Type	Name	Description	Schema	Default
body	body required		ApigatewayTriggerCreateRequest

Responses

HTTP Code	Description	Schema
200	OK	TriggerCreateResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/triggers/apigateway

Request header

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

Request body

{
    "apigateway_api_id": "31e749b7b260868f441e862b",
    "apigateway_stage_name": "sample",
    "cloud_function_id": "8c9f6c1c928a45b4bbd1e4da5531d656"
}

Example HTTP response

Response 200

{
    "alias": "$LATEST",
    "cloud_function_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "triggers": [
        {
            "schedule": "* * * * 0",
            "timezone": "Asia/Tokyo",
            "trigger_id": 1,
            "trigger_name": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_target_account_id": "617b3d0e90c24a5fa1f65a3824861354",
            "trigger_target_srn": "srn:dev2::f32265726b694b32920aa3b111f4c715:::iam:user/9abd88ba08434777a8ca168e799eebbe",
            "trigger_target_uuid": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_type": "apigateway"
        }
    ]
}

2.1.5.4 - 1.0

post /v1/triggers/apigateway

Description

Cloud Function 트리거 생성

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		ApigatewayTriggerCreateRequest

Responses

HTTP Code	Description	Schema
200	OK	TriggerCreateResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/triggers/apigateway

Request header

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

Request body

{
    "apigateway_api_id": "31e749b7b260868f441e862b",
    "apigateway_stage_name": "sample",
    "cloud_function_id": "8c9f6c1c928a45b4bbd1e4da5531d656"
}

Example HTTP response

Response 200

{
    "alias": "$LATEST",
    "cloud_function_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "triggers": [
        {
            "schedule": "* * * * 0",
            "timezone": "Asia/Tokyo",
            "trigger_id": 1,
            "trigger_name": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_target_account_id": "617b3d0e90c24a5fa1f65a3824861354",
            "trigger_target_srn": "srn:dev2::f32265726b694b32920aa3b111f4c715:::iam:user/9abd88ba08434777a8ca168e799eebbe",
            "trigger_target_uuid": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_type": "apigateway"
        }
    ]
}

2.1.6 - Create Cloud Function Cronjob Trigger

2.1.6.1 - 1.3

post /v1/triggers/cronjob

Description

Cloud Function 트리거 생성

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
body	body required		CronjobTriggerCreateRequest

Responses

HTTP Code	Description	Schema
200	OK	TriggerCreateResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/triggers/cronjob

Request header

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

Request body

{
    "cloud_function_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "schedule": "* * * * 0",
    "timezone": "Asia/Tokyo"
}

Example HTTP response

Response 200

{
    "alias": "$LATEST",
    "cloud_function_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "triggers": [
        {
            "schedule": "* * * * 0",
            "timezone": "Asia/Tokyo",
            "trigger_id": 1,
            "trigger_name": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_target_account_id": "617b3d0e90c24a5fa1f65a3824861354",
            "trigger_target_srn": "srn:dev2::f32265726b694b32920aa3b111f4c715:::iam:user/9abd88ba08434777a8ca168e799eebbe",
            "trigger_target_uuid": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_type": "apigateway"
        }
    ]
}

2.1.6.2 - 1.2

post /v1/triggers/cronjob

Description

Cloud Function 트리거 생성

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.2	20260630

Parameters

Type	Name	Description	Schema	Default
body	body required		CronjobTriggerCreateRequest

Responses

HTTP Code	Description	Schema
200	OK	TriggerCreateResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/triggers/cronjob

Request header

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

Request body

{
    "cloud_function_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "schedule": "* * * * 0",
    "timezone": "Asia/Tokyo"
}

Example HTTP response

Response 200

{
    "alias": "$LATEST",
    "cloud_function_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "triggers": [
        {
            "schedule": "* * * * 0",
            "timezone": "Asia/Tokyo",
            "trigger_id": 1,
            "trigger_name": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_target_account_id": "617b3d0e90c24a5fa1f65a3824861354",
            "trigger_target_srn": "srn:dev2::f32265726b694b32920aa3b111f4c715:::iam:user/9abd88ba08434777a8ca168e799eebbe",
            "trigger_target_uuid": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_type": "apigateway"
        }
    ]
}

2.1.6.3 - 1.1

post /v1/triggers/cronjob

Description

Cloud Function 트리거 생성

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260430

Parameters

Type	Name	Description	Schema	Default
body	body required		CronjobTriggerCreateRequest

Responses

HTTP Code	Description	Schema
200	OK	TriggerCreateResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/triggers/cronjob

Request header

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

Request body

{
    "cloud_function_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "schedule": "* * * * 0",
    "timezone": "Asia/Tokyo"
}

Example HTTP response

Response 200

{
    "alias": "$LATEST",
    "cloud_function_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "triggers": [
        {
            "schedule": "* * * * 0",
            "timezone": "Asia/Tokyo",
            "trigger_id": 1,
            "trigger_name": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_target_account_id": "617b3d0e90c24a5fa1f65a3824861354",
            "trigger_target_srn": "srn:dev2::f32265726b694b32920aa3b111f4c715:::iam:user/9abd88ba08434777a8ca168e799eebbe",
            "trigger_target_uuid": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_type": "apigateway"
        }
    ]
}

2.1.6.4 - 1.0

post /v1/triggers/cronjob

Description

Cloud Function 트리거 생성

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		CronjobTriggerCreateRequest

Responses

HTTP Code	Description	Schema
200	OK	TriggerCreateResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/triggers/cronjob

Request header

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

Request body

{
    "cloud_function_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "schedule": "* * * * 0",
    "timezone": "Asia/Tokyo"
}

Example HTTP response

Response 200

{
    "alias": "$LATEST",
    "cloud_function_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "triggers": [
        {
            "schedule": "* * * * 0",
            "timezone": "Asia/Tokyo",
            "trigger_id": 1,
            "trigger_name": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_target_account_id": "617b3d0e90c24a5fa1f65a3824861354",
            "trigger_target_srn": "srn:dev2::f32265726b694b32920aa3b111f4c715:::iam:user/9abd88ba08434777a8ca168e799eebbe",
            "trigger_target_uuid": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_type": "apigateway"
        }
    ]
}

2.1.7 - Create PrivateLink Endpoint

2.1.7.1 - 1.3

post /v1/cloud-functions/{cloud_function_id}/configurations/privatelink-endpoints

Description

PrivateLink Endpoint 생성

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
body	body required		PrivateLinkEndpointCreateRequest

Responses

HTTP Code	Description	Schema
200	OK	PrivateLinkEndpoint
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/privatelink-endpoints

Request header

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

Request body

{
    "endpoint": {
        "alias": "sample",
        "service_id": "8c9f6c1c928a45b4bbd1e4da5531d656"
    }
}

Example HTTP response

Response 200

{
    "endpoint": {
        "endpoint_alias": "sample",
        "endpoint_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
        "service_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
        "state": "Active"
    }
}

2.1.7.2 - 1.2

post /v1/cloud-functions/{cloud_function_id}/configurations/privatelink-endpoints

Description

PrivateLink Endpoint 생성

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.2	20260630

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
body	body required		PrivateLinkEndpointCreateRequest

Responses

HTTP Code	Description	Schema
200	OK	PrivateLinkEndpoint
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/privatelink-endpoints

Request header

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

Request body

{
    "endpoint": {
        "alias": "sample",
        "service_id": "8c9f6c1c928a45b4bbd1e4da5531d656"
    }
}

Example HTTP response

Response 200

{
    "endpoint": {
        "endpoint_alias": "sample",
        "endpoint_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
        "service_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
        "state": "Active"
    }
}

2.1.8 - Delete Cloud Function

2.1.8.1 - 1.3

delete /v1/cloud-functions/{cloud_function_id}

Description

함수 삭제

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_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 = scf 1.3"

Example HTTP response

Response 204

2.1.8.2 - 1.2

delete /v1/cloud-functions/{cloud_function_id}

Description

함수 삭제

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.2	20260630

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_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 = scf 1.2"

Example HTTP response

Response 204

2.1.8.3 - 1.1

delete /v1/cloud-functions/{cloud_function_id}

Description

함수 삭제

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260430

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_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 = scf 1.1"

Example HTTP response

Response 204

2.1.8.4 - 1.0

delete /v1/cloud-functions/{cloud_function_id}

Description

함수 삭제

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_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 = scf 1.0"

Example HTTP response

Response 204

2.1.9 - Delete Cloud Function Trigger

2.1.9.1 - 1.3

delete /v1/triggers/{trigger_id}

Description

Cloud Function 트리거 삭제

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	trigger_id required	트리거 ID Example : `1`	integer	None
body	body required		TriggerDeleteRequest

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/triggers/{trigger_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 = scf 1.3"

Request body

{
    "cloud_function_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "trigger_type": "apigateway"
}

Example HTTP response

Response 204

2.1.9.2 - 1.2

delete /v1/triggers/{trigger_id}

Description

Cloud Function 트리거 삭제

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.2	20260630

Parameters

Type	Name	Description	Schema	Default
path	trigger_id required	트리거 ID Example : `1`	integer	None
body	body required		TriggerDeleteRequest

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/triggers/{trigger_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 = scf 1.2"

Request body

{
    "cloud_function_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "trigger_type": "apigateway"
}

Example HTTP response

Response 204

2.1.9.3 - 1.1

delete /v1/triggers/{trigger_id}

Description

Cloud Function 트리거 삭제

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260430

Parameters

Type	Name	Description	Schema	Default
path	trigger_id required	트리거 ID Example : `1`	integer	None
body	body required		TriggerDeleteRequest

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/triggers/{trigger_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 = scf 1.1"

Request body

{
    "cloud_function_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "trigger_type": "apigateway"
}

Example HTTP response

Response 204

2.1.9.4 - 1.0

delete /v1/triggers/{trigger_id}

Description

Cloud Function 트리거 삭제

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	trigger_id required	트리거 ID Example : `1`	integer	None
body	body required		TriggerDeleteRequest

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/triggers/{trigger_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 = scf 1.0"

Request body

{
    "cloud_function_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "trigger_type": "apigateway"
}

Example HTTP response

Response 204

2.1.10 - Delete PrivateLink Endpoint

2.1.10.1 - 1.3

delete /v1/cloud-functions/{cloud_function_id}/configurations/privatelink-endpoints/{endpoint_id}

Description

PrivateLink Endpoint 삭제

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
path	endpoint_id required	Endpoint Id Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/privatelink-endpoints/{endpoint_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 = scf 1.3"

Example HTTP response

Response 204

2.1.10.2 - 1.2

delete /v1/cloud-functions/{cloud_function_id}/configurations/privatelink-endpoints/{endpoint_id}

Description

PrivateLink Endpoint 삭제

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.2	20260630

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
path	endpoint_id required	Endpoint Id Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/privatelink-endpoints/{endpoint_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 = scf 1.2"

Example HTTP response

Response 204

2.1.11 - Delete Resource Policy

2.1.11.1 - 1.3

delete /v1/cloud-functions/{cloud_function_id}/configurations/resource-policies

Description

리소스 정책 삭제

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/resource-policies

Request header

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

Example HTTP response

Response 204

2.1.12 - List Cloud Function Triggers

2.1.12.1 - 1.3

get /v1/triggers

Description

Cloud Function 트리거 목록 조회

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
query	sort optional	sort Example : `name:asc`	any of [string, null]	None
query	page optional	page Example : `0`	any of [integer, null]	None
query	size optional	size Example : `20`	any of [integer, null]	None
query	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
query	trigger_name optional	트리거 타입 Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	any of [string, null]	None
query	trigger_type optional	트리거 타입 Example : `apigateway`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	TriggersResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/triggers?cloud_function_id={cloud_function_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 = scf 1.3"

Example HTTP response

Response 200

{
    "alias": "$LATEST",
    "count": 20,
    "triggers": [
        {
            "schedule": "* * * * 0",
            "timezone": "Asia/Tokyo",
            "trigger_id": 1,
            "trigger_name": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_target_account_id": "617b3d0e90c24a5fa1f65a3824861354",
            "trigger_target_srn": "srn:dev2::f32265726b694b32920aa3b111f4c715:::iam:user/9abd88ba08434777a8ca168e799eebbe",
            "trigger_target_uuid": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_type": "apigateway"
        }
    ]
}

2.1.12.2 - 1.2

get /v1/triggers

Description

Cloud Function 트리거 목록 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.2	20260630

Parameters

Type	Name	Description	Schema	Default
query	sort optional	sort Example : `name:asc`	any of [string, null]	None
query	page optional	page Example : `0`	any of [integer, null]	None
query	size optional	size Example : `20`	any of [integer, null]	None
query	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
query	trigger_name optional	트리거 타입 Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	any of [string, null]	None
query	trigger_type optional	트리거 타입 Example : `apigateway`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	TriggersResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/triggers?cloud_function_id={cloud_function_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 = scf 1.2"

Example HTTP response

Response 200

{
    "alias": "$LATEST",
    "count": 20,
    "triggers": [
        {
            "schedule": "* * * * 0",
            "timezone": "Asia/Tokyo",
            "trigger_id": 1,
            "trigger_name": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_target_account_id": "617b3d0e90c24a5fa1f65a3824861354",
            "trigger_target_srn": "srn:dev2::f32265726b694b32920aa3b111f4c715:::iam:user/9abd88ba08434777a8ca168e799eebbe",
            "trigger_target_uuid": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_type": "apigateway"
        }
    ]
}

2.1.12.3 - 1.1

get /v1/triggers

Description

Cloud Function 트리거 목록 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260430

Parameters

Type	Name	Description	Schema	Default
query	sort optional	sort Example : `name:asc`	any of [string, null]	None
query	page optional	page Example : `0`	any of [integer, null]	None
query	size optional	size Example : `20`	any of [integer, null]	None
query	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
query	trigger_name optional	트리거 타입 Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	any of [string, null]	None
query	trigger_type optional	트리거 타입 Example : `apigateway`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	TriggersResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/triggers?cloud_function_id={cloud_function_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 = scf 1.1"

Example HTTP response

Response 200

{
    "alias": "$LATEST",
    "count": 20,
    "triggers": [
        {
            "schedule": "* * * * 0",
            "timezone": "Asia/Tokyo",
            "trigger_id": 1,
            "trigger_name": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_target_account_id": "617b3d0e90c24a5fa1f65a3824861354",
            "trigger_target_srn": "srn:dev2::f32265726b694b32920aa3b111f4c715:::iam:user/9abd88ba08434777a8ca168e799eebbe",
            "trigger_target_uuid": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_type": "apigateway"
        }
    ]
}

2.1.12.4 - 1.0

get /v1/triggers

Description

Cloud Function 트리거 목록 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
query	sort optional	sort Example : `name:asc`	any of [string, null]	None
query	page optional	page Example : `0`	any of [integer, null]	None
query	size optional	size Example : `20`	any of [integer, null]	None
query	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
query	trigger_name optional	트리거 타입 Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	any of [string, null]	None
query	trigger_type optional	트리거 타입 Example : `apigateway`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	TriggersResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/triggers?cloud_function_id={cloud_function_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 = scf 1.0"

Example HTTP response

Response 200

{
    "alias": "$LATEST",
    "count": 20,
    "triggers": [
        {
            "schedule": "* * * * 0",
            "timezone": "Asia/Tokyo",
            "trigger_id": 1,
            "trigger_name": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_target_account_id": "617b3d0e90c24a5fa1f65a3824861354",
            "trigger_target_srn": "srn:dev2::f32265726b694b32920aa3b111f4c715:::iam:user/9abd88ba08434777a8ca168e799eebbe",
            "trigger_target_uuid": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_type": "apigateway"
        }
    ]
}

2.1.13 - List Cloud Functions

2.1.13.1 - 1.3

get /v1/cloud-functions

Description

함수 목록 조회

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
query	sort optional	sort Example : `name:asc`	any of [string, null]	None
query	page optional	page Example : `0`	any of [integer, null]	None
query	size optional	size Example : `20`	any of [integer, null]	None
query	name optional	이름 Example : `sample-function-name`	any of [string, null]	None
query	state optional	함수 상태 Example : `READY`	any of [array[string], string, null]	None
query	runtime optional	런타임 Example : `Node.js:20`	any of [array[string], string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	CloudFunctionListResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions

Request header

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

Example HTTP response

Response 200

{
    "cloud_functions": [
        {
            "account_id": "617b3d0e90c24a5fa1f65a3824861354",
            "created_at": "2025-05-22T06:21:17.580522",
            "function_url": "https://33b532c466824bcf9324101a3c6f3015.kr-west1.dev2.samsungsdscloud.com/cloudfunctions-hello",
            "id": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "name": "sample",
            "runtime": "Node.js:20",
            "state": "READY",
            "user_id": "617b3d0e90c24a5fa1f65a3824861354"
        }
    ],
    "count": 20
}

2.1.13.2 - 1.2

get /v1/cloud-functions

Description

함수 목록 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.2	20260630

Parameters

Type	Name	Description	Schema	Default
query	sort optional	sort Example : `name:asc`	any of [string, null]	None
query	page optional	page Example : `0`	any of [integer, null]	None
query	size optional	size Example : `20`	any of [integer, null]	None
query	name optional	이름 Example : `sample-function-name`	any of [string, null]	None
query	state optional	함수 상태 Example : `READY`	any of [array[string], string, null]	None
query	runtime optional	런타임 Example : `Node.js:20`	any of [array[string], string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	CloudFunctionListResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions

Request header

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

Example HTTP response

Response 200

{
    "cloud_functions": [
        {
            "account_id": "617b3d0e90c24a5fa1f65a3824861354",
            "created_at": "2025-05-22T06:21:17.580522",
            "function_url": "https://33b532c466824bcf9324101a3c6f3015.kr-west1.dev2.samsungsdscloud.com/cloudfunctions-hello",
            "id": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "name": "sample",
            "runtime": "Node.js:20",
            "state": "READY",
            "user_id": "617b3d0e90c24a5fa1f65a3824861354"
        }
    ],
    "count": 20
}

2.1.13.3 - 1.1

get /v1/cloud-functions

Description

함수 목록 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260430

Parameters

Type	Name	Description	Schema	Default
query	sort optional	sort Example : `name:asc`	any of [string, null]	None
query	page optional	page Example : `0`	any of [integer, null]	None
query	size optional	size Example : `20`	any of [integer, null]	None
query	name optional	이름 Example : `sample-function-name`	any of [string, null]	None
query	state optional	함수 상태 Example : `READY`	any of [array[string], string, null]	None
query	runtime optional	런타임 Example : `Node.js:20`	any of [array[string], string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	CloudFunctionListResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions

Request header

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

Example HTTP response

Response 200

{
    "cloud_functions": [
        {
            "account_id": "617b3d0e90c24a5fa1f65a3824861354",
            "created_at": "2025-05-22T06:21:17.580522",
            "function_url": "https://33b532c466824bcf9324101a3c6f3015.kr-west1.dev2.samsungsdscloud.com/cloudfunctions-hello",
            "id": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "name": "sample",
            "runtime": "Node.js:20",
            "state": "READY",
            "user_id": "617b3d0e90c24a5fa1f65a3824861354"
        }
    ],
    "count": 20
}

2.1.13.4 - 1.0

get /v1/cloud-functions

Description

함수 목록 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
query	sort optional	sort Example : `name:asc`	any of [string, null]	None
query	page optional	page Example : `0`	any of [integer, null]	None
query	size optional	size Example : `20`	any of [integer, null]	None
query	name optional	이름 Example : `sample-function-name`	any of [string, null]	None
query	state optional	함수 상태 Example : `READY`	any of [array[string], string, null]	None
query	runtime optional	런타임 Example : `Node.js:20`	any of [array[string], string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	CloudFunctionListResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions

Request header

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

Example HTTP response

Response 200

{
    "cloud_functions": [
        {
            "account_id": "617b3d0e90c24a5fa1f65a3824861354",
            "created_at": "2025-05-22T06:21:17.580522",
            "function_url": "https://33b532c466824bcf9324101a3c6f3015.kr-west1.dev2.samsungsdscloud.com/cloudfunctions-hello",
            "id": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "name": "sample",
            "runtime": "Node.js:20",
            "state": "READY",
            "user_id": "617b3d0e90c24a5fa1f65a3824861354"
        }
    ],
    "count": 20
}

2.1.14 - List Environment Variables

2.1.14.1 - 1.3

get /v1/cloud-functions/{cloud_function_id}/configurations/environment-variables

Description

환경 변수 조회

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
query	sort optional	정렬 Example : `key:asc`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	FunctionVariables
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/environment-variables

Request header

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

Example HTTP response

Response 200

{
    "variables": [
        {
            "key": "sample",
            "value": "sample"
        }
    ]
}

2.1.15 - List PrivateLink Endpoint

2.1.15.1 - 1.3

get /v1/cloud-functions/{cloud_function_id}/configurations/privatelink-endpoints

Description

PrivateLink Endpoint 조회

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
query	sort optional	정렬 Example : `endpoint_alias:asc`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	PrivateLinkEndpointList
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/privatelink-endpoints

Request header

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

Example HTTP response

Response 200

{
    "privatelink_endpoints": [
        {
            "endpoint_alias": "sample",
            "endpoint_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "service_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "state": "Active"
        }
    ]
}

2.1.16 - List Runtimes

2.1.16.1 - 1.3

get /v1/cloud-functions/runtimes

Description

Runtime 목록 조회

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Responses

HTTP Code	Description	Schema
200	OK	RuntimeListResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/runtimes

Request header

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

Example HTTP response

Response 200

{
    "count": "3",
    "runtimes": [
        {
            "base_image_seq": "3",
            "name": "sample",
            "version": "1.0.0"
        }
    ]
}

2.1.16.2 - 1.2

get /v1/cloud-functions/runtimes

Description

Runtime 목록 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.2	20260630

Responses

HTTP Code	Description	Schema
200	OK	RuntimeListResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/runtimes

Request header

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

Example HTTP response

Response 200

{
    "count": "3",
    "runtimes": [
        {
            "base_image_seq": "3",
            "name": "sample",
            "version": "1.0.0"
        }
    ]
}

2.1.16.3 - 1.1

get /v1/cloud-functions/runtimes

Description

Runtime 목록 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260430

Responses

HTTP Code	Description	Schema
200	OK	RuntimeListResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/runtimes

Request header

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

Example HTTP response

Response 200

{
    "count": "3",
    "runtimes": [
        {
            "base_image_seq": "3",
            "name": "sample",
            "version": "1.0.0"
        }
    ]
}

2.1.16.4 - 1.0

get /v1/cloud-functions/runtimes

Description

Runtime 목록 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Responses

HTTP Code	Description	Schema
200	OK	RuntimeListResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/runtimes

Request header

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

Example HTTP response

Response 200

{
    "count": "3",
    "runtimes": [
        {
            "base_image_seq": "3",
            "name": "sample",
            "version": "1.0.0"
        }
    ]
}

2.1.17 - List Sample Codes

2.1.17.1 - 1.3

get /v1/cloud-functions/sample-codes

Description

Sample 코드 목록 조회

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Responses

HTTP Code	Description	Schema
200	OK	SampleCodesListResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/sample-codes

Request header

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

Example HTTP response

Response 200

{
    "count": "3",
    "sample_codes": [
        {
            "content": "sample",
            "default": false,
            "description": "sample",
            "name": "sample",
            "runtime": "Node.js:20",
            "seq": "3",
            "version": "sample"
        }
    ]
}

2.1.17.2 - 1.2

get /v1/cloud-functions/sample-codes

Description

Sample 코드 목록 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.2	20260630

Responses

HTTP Code	Description	Schema
200	OK	SampleCodesListResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/sample-codes

Request header

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

Example HTTP response

Response 200

{
    "count": "3",
    "sample_codes": [
        {
            "content": "sample",
            "default": false,
            "description": "sample",
            "name": "sample",
            "runtime": "Node.js:20",
            "seq": "3",
            "version": "sample"
        }
    ]
}

2.1.17.3 - 1.1

get /v1/cloud-functions/sample-codes

Description

Sample 코드 목록 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260430

Responses

HTTP Code	Description	Schema
200	OK	SampleCodesListResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/sample-codes

Request header

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

Example HTTP response

Response 200

{
    "count": "3",
    "sample_codes": [
        {
            "content": "sample",
            "default": false,
            "description": "sample",
            "name": "sample",
            "runtime": "Node.js:20",
            "seq": "3",
            "version": "sample"
        }
    ]
}

2.1.17.4 - 1.0

get /v1/cloud-functions/sample-codes

Description

Sample 코드 목록 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Responses

HTTP Code	Description	Schema
200	OK	SampleCodesListResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/sample-codes

Request header

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

Example HTTP response

Response 200

{
    "count": "3",
    "sample_codes": [
        {
            "content": "sample",
            "default": false,
            "description": "sample",
            "name": "sample",
            "runtime": "Node.js:20",
            "seq": "3",
            "version": "sample"
        }
    ]
}

2.1.18 - Request PrivateLink Endpoint

2.1.18.1 - 1.3

put /v1/cloud-functions/{cloud_function_id}/configurations/privatelink-endpoints/{endpoint_id}/request

Description

PrivateLink Endpoint 요청

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
path	endpoint_id required	Endpoint Id Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
body	body required		PrivateLinkEndpointRequest

Responses

HTTP Code	Description	Schema
200	OK	PrivateLinkEndpoint
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/privatelink-endpoints/{endpoint_id}/request

Request header

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

Request body

{
    "type": "CANCEL"
}

Example HTTP response

Response 200

{
    "endpoint": {
        "endpoint_alias": "sample",
        "endpoint_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
        "service_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
        "state": "Active"
    }
}

2.1.18.2 - 1.2

put /v1/cloud-functions/{cloud_function_id}/configurations/privatelink-endpoints/{endpoint_id}/request

Description

PrivateLink Endpoint 요청

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.2	20260630

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
path	endpoint_id required	Endpoint Id Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
body	body required		PrivateLinkEndpointRequest

Responses

HTTP Code	Description	Schema
200	OK	PrivateLinkEndpoint
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/privatelink-endpoints/{endpoint_id}/request

Request header

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

Request body

{
    "type": "CANCEL"
}

Example HTTP response

Response 200

{
    "endpoint": {
        "endpoint_alias": "sample",
        "endpoint_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
        "service_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
        "state": "Active"
    }
}

2.1.19 - Set Resource Policy

2.1.19.1 - 1.3

put /v1/cloud-functions/{cloud_function_id}/configurations/resource-policies

Description

리소스 정책 수정

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
body	body required		ResourcePolicySetRequest

Responses

HTTP Code	Description	Schema
200	OK	ResourcePolicyShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/resource-policies

Request header

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

Request body

{
    "policy_document": {
        "Statement": [
            {
                "Action": [
                    "scf:InvokeFunction"
                ],
                "Condition": {
                    "StringEquals": {
                        "scf:CloudFunctionAuthType": [
                            "SCP_IAM"
                        ]
                    }
                },
                "Effect": "Allow",
                "Principal": "*",
                "Resource": [
                    "srn:e::27bb070b564349f8a31cc60734cc36a5:kr-west1::scf:cloud-function/1a2afa4bfb854a828602c93009cf4447"
                ],
                "Sid": "Statement1"
            }
        ],
        "Version": "2024-07-01"
    }
}

Example HTTP response

Response 200

{
    "policy_document": {
        "Statement": [
            {
                "Action": [
                    "scf:InvokeFunction"
                ],
                "Condition": {
                    "StringEquals": {
                        "scf:CloudFunctionAuthType": [
                            "SCP_IAM"
                        ]
                    }
                },
                "Effect": "Allow",
                "Principal": "*",
                "Resource": [
                    "srn:e::27bb070b564349f8a31cc60734cc36a5:kr-west1::scf:cloud-function/1a2afa4bfb854a828602c93009cf4447"
                ],
                "Sid": "Statement1"
            }
        ],
        "Version": "2024-07-01"
    }
}

2.1.20 - Show Cloud Function

2.1.20.1 - 1.3

get /v1/cloud-functions/{cloud_function_id}

Description

함수 조회

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None

Responses

HTTP Code	Description	Schema
200	OK	CloudFunctionShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_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 = scf 1.3"

Example HTTP response

Response 200

{
    "cloud_function": {
        "account_id": "617b3d0e90c24a5fa1f65a3824861354",
        "function_url": "https://33b532c466824bcf9324101a3c6f3015.kr-west1.dev2.samsungsdscloud.com/cloudfunctions-hello",
        "id": "8c9f6c1c928a45b4bbd1e4da5531d656",
        "name": "sample",
        "runtime": "Node.js:20",
        "state": "READY",
        "user_id": "617b3d0e90c24a5fa1f65a3824861354"
    }
}

2.1.20.2 - 1.2

get /v1/cloud-functions/{cloud_function_id}

Description

함수 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.2	20260630

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None

Responses

HTTP Code	Description	Schema
200	OK	CloudFunctionShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_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 = scf 1.2"

Example HTTP response

Response 200

{
    "cloud_function": {
        "account_id": "617b3d0e90c24a5fa1f65a3824861354",
        "function_url": "https://33b532c466824bcf9324101a3c6f3015.kr-west1.dev2.samsungsdscloud.com/cloudfunctions-hello",
        "id": "8c9f6c1c928a45b4bbd1e4da5531d656",
        "name": "sample",
        "runtime": "Node.js:20",
        "state": "READY",
        "user_id": "617b3d0e90c24a5fa1f65a3824861354"
    }
}

2.1.20.3 - 1.1

get /v1/cloud-functions/{cloud_function_id}

Description

함수 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260430

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None

Responses

HTTP Code	Description	Schema
200	OK	CloudFunctionShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_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 = scf 1.1"

Example HTTP response

Response 200

{
    "cloud_function": {
        "account_id": "617b3d0e90c24a5fa1f65a3824861354",
        "function_url": "https://33b532c466824bcf9324101a3c6f3015.kr-west1.dev2.samsungsdscloud.com/cloudfunctions-hello",
        "id": "8c9f6c1c928a45b4bbd1e4da5531d656",
        "name": "sample",
        "runtime": "Node.js:20",
        "state": "READY",
        "user_id": "617b3d0e90c24a5fa1f65a3824861354"
    }
}

2.1.20.4 - 1.0

get /v1/cloud-functions/{cloud_function_id}

Description

함수 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None

Responses

HTTP Code	Description	Schema
200	OK	CloudFunctionShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_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 = scf 1.0"

Example HTTP response

Response 200

{
    "cloud_function": {
        "account_id": "617b3d0e90c24a5fa1f65a3824861354",
        "function_url": "https://33b532c466824bcf9324101a3c6f3015.kr-west1.dev2.samsungsdscloud.com/cloudfunctions-hello",
        "id": "8c9f6c1c928a45b4bbd1e4da5531d656",
        "name": "sample",
        "runtime": "Node.js:20",
        "state": "READY",
        "user_id": "617b3d0e90c24a5fa1f65a3824861354"
    }
}

2.1.21 - Show Cloud Function Code

2.1.21.1 - 1.3

get /v1/cloud-functions/{cloud_function_id}/codes

Description

Cloud Function 코드 조회

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None

Responses

HTTP Code	Description	Schema
200	OK	Code
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/codes

Request header

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

Example HTTP response

Response 200

{
    "class_name": "com.example.Handler",
    "code_text": "ZXhwb3J0cy5oYW5kbGVSZXF1ZXN0ID0gYXN5bmM==",
    "code_type": "text",
    "file_name": "sample",
    "file_transfer_status": "sample",
    "file_upload_at": "2025-05-17 00:23:17",
    "method_name": "handleRequest",
    "runtime": "Node.js:20"
}

2.1.21.2 - 1.2

get /v1/cloud-functions/{cloud_function_id}/codes

Description

Cloud Function 코드 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.2	20260630

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None

Responses

HTTP Code	Description	Schema
200	OK	Code
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/codes

Request header

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

Example HTTP response

Response 200

{
    "class_name": "com.example.Handler",
    "code_text": "ZXhwb3J0cy5oYW5kbGVSZXF1ZXN0ID0gYXN5bmM==",
    "code_type": "text",
    "file_name": "sample",
    "file_transfer_status": "sample",
    "file_upload_at": "2025-05-17 00:23:17",
    "method_name": "handleRequest",
    "runtime": "Node.js:20"
}

2.1.21.3 - 1.1

get /v1/cloud-functions/{cloud_function_id}/codes

Description

Cloud Function 코드 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260430

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None

Responses

HTTP Code	Description	Schema
200	OK	Code
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/codes

Request header

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

Example HTTP response

Response 200

{
    "class_name": "com.example.Handler",
    "code_text": "ZXhwb3J0cy5oYW5kbGVSZXF1ZXN0ID0gYXN5bmM==",
    "code_type": "text",
    "file_name": "sample",
    "file_transfer_status": "sample",
    "file_upload_at": "2025-05-17 00:23:17",
    "method_name": "handleRequest",
    "runtime": "Node.js:20"
}

2.1.21.4 - 1.0

get /v1/cloud-functions/{cloud_function_id}/codes

Description

Cloud Function 코드 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None

Responses

HTTP Code	Description	Schema
200	OK	Code
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/codes

Request header

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

Example HTTP response

Response 200

{
    "class_name": "com.example.Handler",
    "code_text": "ZXhwb3J0cy5oYW5kbGVSZXF1ZXN0ID0gYXN5bmM==",
    "code_type": "text",
    "file_name": "sample",
    "file_transfer_status": "sample",
    "file_upload_at": "2025-05-17 00:23:17",
    "method_name": "handleRequest",
    "runtime": "Node.js:20"
}

2.1.22 - Show Cloud Function Configuration

2.1.22.1 - 1.3

get /v1/cloud-functions/{cloud_function_id}/configurations

Description

Cloud Function 구성 조회

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ConfigurationV1Dot2
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations

Request header

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

Example HTTP response

Response 200

{
    "config": {
        "max_scale": "5",
        "memory": "256",
        "min_scale": "1",
        "timeout": "100"
    },
    "privatelink_endpoints": [],
    "privatelink_service": {
        "private_url": "https://sample.scf.private.kr-west1.e.samsungsdscloud.com",
        "privatelink_service_enabled": true,
        "privatelink_service_id": "ba30549f550141ef9af6546543s",
        "privatelink_service_name": "68216f8f56",
        "requested_endpoints": []
    },
    "url": {
        "allow_ips": [
            ""
        ],
        "auth_type": "NONE",
        "public_endpoint_url": "https://scf.33b532c466824bcf9324101a3c6f3015.kr-west1.dev2.samsungsdscloud.com/sample-function",
        "public_ip_acl_enabled": true,
        "url_enabled": true
    },
    "variables": [
        {
            "key": "sample",
            "value": "sample"
        }
    ]
}

2.1.22.2 - 1.2

get /v1/cloud-functions/{cloud_function_id}/configurations

Description

Cloud Function 구성 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.2	20260630

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ConfigurationV1Dot2
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations

Request header

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

Example HTTP response

Response 200

{
    "config": {
        "max_scale": "5",
        "memory": "256",
        "min_scale": "1",
        "timeout": "100"
    },
    "privatelink_endpoints": [],
    "privatelink_service": {
        "private_url": "https://sample.scf.private.kr-west1.e.samsungsdscloud.com",
        "privatelink_service_enabled": true,
        "privatelink_service_id": "ba30549f550141ef9af6546543s",
        "privatelink_service_name": "68216f8f56",
        "requested_endpoints": []
    },
    "url": {
        "allow_ips": [
            ""
        ],
        "auth_type": "NONE",
        "public_endpoint_url": "https://scf.33b532c466824bcf9324101a3c6f3015.kr-west1.dev2.samsungsdscloud.com/sample-function",
        "public_ip_acl_enabled": true,
        "url_enabled": true
    },
    "variables": [
        {
            "key": "sample",
            "value": "sample"
        }
    ]
}

2.1.22.3 - 1.1

get /v1/cloud-functions/{cloud_function_id}/configurations

Description

Cloud Function 구성 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260430

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None

Responses

HTTP Code	Description	Schema
200	OK	Configuration
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations

Request header

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

Example HTTP response

Response 200

{
    "config": {
        "max_scale": "5",
        "memory": "256",
        "min_scale": "1",
        "timeout": "100"
    },
    "url": {
        "allow_ips": [
            ""
        ],
        "auth_type": "NONE",
        "public_endpoint_url": "https://scf.33b532c466824bcf9324101a3c6f3015.kr-west1.dev2.samsungsdscloud.com/sample-function",
        "public_ip_acl_enabled": true,
        "url_enabled": true
    },
    "variables": [
        {
            "key": "sample",
            "value": "sample"
        }
    ]
}

2.1.22.4 - 1.0

get /v1/cloud-functions/{cloud_function_id}/configurations

Description

Cloud Function 구성 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None

Responses

HTTP Code	Description	Schema
200	OK	Configuration
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations

Request header

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

Example HTTP response

Response 200

{
    "config": {
        "max_scale": "5",
        "memory": "256",
        "min_scale": "1",
        "timeout": "100"
    },
    "url": {
        "allow_ips": [
            ""
        ],
        "auth_type": "NONE",
        "public_endpoint_url": "https://scf.33b532c466824bcf9324101a3c6f3015.kr-west1.dev2.samsungsdscloud.com/sample-function",
        "public_ip_acl_enabled": true,
        "url_enabled": true
    },
    "variables": [
        {
            "key": "sample",
            "value": "sample"
        }
    ]
}

2.1.23 - Show Cloud Function Logs

2.1.23.1 - 1.3

get /v1/cloud-functions/{cloud_function_id}/logs

Description

Cloud Function Log 조회

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
query	time optional	시간 Example : `3`	any of [integer, null]	None
query	start optional	시작 일자 Example : `20250517`	any of [string, null]	None
query	end optional	종료 일자 Example : `20250517`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	LogShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/logs

Request header

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

Example HTTP response

Response 200

{
    "count": "3",
    "logs": [
        {
            "log": "[2025-05-12 11:04:12] START RequestId : 04680bac - ad76-4e0a-997e-e35b6275cb67 Version : $LATEST",
            "time": "2025-05-17 00:23:17"
        }
    ]
}

2.1.23.2 - 1.2

get /v1/cloud-functions/{cloud_function_id}/logs

Description

Cloud Function Log 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.2	20260630

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
query	time optional	시간 Example : `3`	any of [integer, null]	None
query	start optional	시작 일자 Example : `20250517`	any of [string, null]	None
query	end optional	종료 일자 Example : `20250517`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	LogShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/logs

Request header

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

Example HTTP response

Response 200

{
    "count": "3",
    "logs": [
        {
            "log": "[2025-05-12 11:04:12] START RequestId : 04680bac - ad76-4e0a-997e-e35b6275cb67 Version : $LATEST",
            "time": "2025-05-17 00:23:17"
        }
    ]
}

2.1.23.3 - 1.1

get /v1/cloud-functions/{cloud_function_id}/logs

Description

Cloud Function Log 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260430

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
query	time optional	시간 Example : `3`	any of [integer, null]	None
query	start optional	시작 일자 Example : `20250517`	any of [string, null]	None
query	end optional	종료 일자 Example : `20250517`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	LogShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/logs

Request header

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

Example HTTP response

Response 200

{
    "count": "3",
    "logs": [
        {
            "log": "[2025-05-12 11:04:12] START RequestId : 04680bac - ad76-4e0a-997e-e35b6275cb67 Version : $LATEST",
            "time": "2025-05-17 00:23:17"
        }
    ]
}

2.1.23.4 - 1.0

get /v1/cloud-functions/{cloud_function_id}/logs

Description

Cloud Function Log 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
query	time optional	시간 Example : `3`	any of [integer, null]	None
query	start optional	시작 일자 Example : `20250517`	any of [string, null]	None
query	end optional	종료 일자 Example : `20250517`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	LogShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/logs

Request header

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

Example HTTP response

Response 200

{
    "count": "3",
    "logs": [
        {
            "log": "[2025-05-12 11:04:12] START RequestId : 04680bac - ad76-4e0a-997e-e35b6275cb67 Version : $LATEST",
            "time": "2025-05-17 00:23:17"
        }
    ]
}

2.1.24 - Show Cloud Function Metrics

2.1.24.1 - 1.3

get /v1/cloud-functions/{cloud_function_id}/metrics

Description

Cloud Function Metric 조회

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
query	time optional	시간 Example : `3`	any of [integer, null]	None
query	start optional	시작 일자 Example : `20250517`	any of [string, null]	None
query	end optional	종료 일자 Example : `20250517`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	MetricShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/metrics

Request header

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

Example HTTP response

Response 200

{
    "actual_pods": [
        {
            "metric_data": "1.0033444816053512",
            "time": "16:37"
        }
    ],
    "fail_count": [
        {
            "metric_data": "1.0033444816053512",
            "time": "16:37"
        }
    ],
    "function_memory": [
        {
            "metric_data": "1.0033444816053512",
            "time": "16:37"
        }
    ],
    "request_count": [
        {
            "metric_data": "1.0033444816053512",
            "time": "16:37"
        }
    ],
    "request_latency": [
        {
            "metric_data": "1.0033444816053512",
            "time": "16:37"
        }
    ],
    "success_count": [
        {
            "metric_data": "1.0033444816053512",
            "time": "16:37"
        }
    ]
}

2.1.24.2 - 1.2

get /v1/cloud-functions/{cloud_function_id}/metrics

Description

Cloud Function Metric 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.2	20260630

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
query	time optional	시간 Example : `3`	any of [integer, null]	None
query	start optional	시작 일자 Example : `20250517`	any of [string, null]	None
query	end optional	종료 일자 Example : `20250517`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	MetricShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/metrics

Request header

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

Example HTTP response

Response 200

{
    "actual_pods": [
        {
            "metric_data": "1.0033444816053512",
            "time": "16:37"
        }
    ],
    "fail_count": [
        {
            "metric_data": "1.0033444816053512",
            "time": "16:37"
        }
    ],
    "function_memory": [
        {
            "metric_data": "1.0033444816053512",
            "time": "16:37"
        }
    ],
    "request_count": [
        {
            "metric_data": "1.0033444816053512",
            "time": "16:37"
        }
    ],
    "request_latency": [
        {
            "metric_data": "1.0033444816053512",
            "time": "16:37"
        }
    ],
    "success_count": [
        {
            "metric_data": "1.0033444816053512",
            "time": "16:37"
        }
    ]
}

2.1.24.3 - 1.1

get /v1/cloud-functions/{cloud_function_id}/metrics

Description

Cloud Function Metric 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260430

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
query	time optional	시간 Example : `3`	any of [integer, null]	None
query	start optional	시작 일자 Example : `20250517`	any of [string, null]	None
query	end optional	종료 일자 Example : `20250517`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	MetricShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/metrics

Request header

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

Example HTTP response

Response 200

{
    "actual_pods": [
        {
            "metric_data": "1.0033444816053512",
            "time": "16:37"
        }
    ],
    "fail_count": [
        {
            "metric_data": "1.0033444816053512",
            "time": "16:37"
        }
    ],
    "function_memory": [
        {
            "metric_data": "1.0033444816053512",
            "time": "16:37"
        }
    ],
    "request_count": [
        {
            "metric_data": "1.0033444816053512",
            "time": "16:37"
        }
    ],
    "request_latency": [
        {
            "metric_data": "1.0033444816053512",
            "time": "16:37"
        }
    ],
    "success_count": [
        {
            "metric_data": "1.0033444816053512",
            "time": "16:37"
        }
    ]
}

2.1.24.4 - 1.0

get /v1/cloud-functions/{cloud_function_id}/metrics

Description

Cloud Function Metric 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
query	time optional	시간 Example : `3`	any of [integer, null]	None
query	start optional	시작 일자 Example : `20250517`	any of [string, null]	None
query	end optional	종료 일자 Example : `20250517`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	MetricShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/metrics

Request header

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

Example HTTP response

Response 200

{
    "actual_pods": [
        {
            "metric_data": "1.0033444816053512",
            "time": "16:37"
        }
    ],
    "fail_count": [
        {
            "metric_data": "1.0033444816053512",
            "time": "16:37"
        }
    ],
    "function_memory": [
        {
            "metric_data": "1.0033444816053512",
            "time": "16:37"
        }
    ],
    "request_count": [
        {
            "metric_data": "1.0033444816053512",
            "time": "16:37"
        }
    ],
    "request_latency": [
        {
            "metric_data": "1.0033444816053512",
            "time": "16:37"
        }
    ],
    "success_count": [
        {
            "metric_data": "1.0033444816053512",
            "time": "16:37"
        }
    ]
}

2.1.25 - Show Cloud Function Trigger

2.1.25.1 - 1.3

get /v1/triggers/{trigger_id}

Description

Cloud Function 트리거 상세 조회

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	trigger_id required	트리거 ID Example : `1`	integer	None

Responses

HTTP Code	Description	Schema
200	OK	Trigger
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/triggers/{trigger_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 = scf 1.3"

Example HTTP response

Response 200

{
    "alias": "$LATEST",
    "schedule": "* * * * 0",
    "timezone": "Asia/Tokyo",
    "trigger_id": 1,
    "trigger_name": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "trigger_sid": "617b3d0e90c24a5fa1f65a3824861354",
    "trigger_target_account_id": "617b3d0e90c24a5fa1f65a3824861354",
    "trigger_target_srn": "srn:dev2::f32265726b694b32920aa3b111f4c715:::iam:user/9abd88ba08434777a8ca168e799eebbe",
    "trigger_target_uuid": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "trigger_type": "apigateway"
}

2.1.25.2 - 1.2

get /v1/triggers/{trigger_id}

Description

Cloud Function 트리거 상세 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.2	20260630

Parameters

Type	Name	Description	Schema	Default
path	trigger_id required	트리거 ID Example : `1`	integer	None

Responses

HTTP Code	Description	Schema
200	OK	Trigger
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/triggers/{trigger_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 = scf 1.2"

Example HTTP response

Response 200

{
    "alias": "$LATEST",
    "schedule": "* * * * 0",
    "timezone": "Asia/Tokyo",
    "trigger_id": 1,
    "trigger_name": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "trigger_sid": "617b3d0e90c24a5fa1f65a3824861354",
    "trigger_target_account_id": "617b3d0e90c24a5fa1f65a3824861354",
    "trigger_target_srn": "srn:dev2::f32265726b694b32920aa3b111f4c715:::iam:user/9abd88ba08434777a8ca168e799eebbe",
    "trigger_target_uuid": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "trigger_type": "apigateway"
}

2.1.25.3 - 1.1

get /v1/triggers/{trigger_id}

Description

Cloud Function 트리거 상세 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260430

Parameters

Type	Name	Description	Schema	Default
path	trigger_id required	트리거 ID Example : `1`	integer	None

Responses

HTTP Code	Description	Schema
200	OK	Trigger
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/triggers/{trigger_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 = scf 1.1"

Example HTTP response

Response 200

{
    "alias": "$LATEST",
    "schedule": "* * * * 0",
    "timezone": "Asia/Tokyo",
    "trigger_id": 1,
    "trigger_name": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "trigger_sid": "617b3d0e90c24a5fa1f65a3824861354",
    "trigger_target_account_id": "617b3d0e90c24a5fa1f65a3824861354",
    "trigger_target_srn": "srn:dev2::f32265726b694b32920aa3b111f4c715:::iam:user/9abd88ba08434777a8ca168e799eebbe",
    "trigger_target_uuid": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "trigger_type": "apigateway"
}

2.1.25.4 - 1.0

get /v1/triggers/{trigger_id}

Description

Cloud Function 트리거 상세 조회

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	trigger_id required	트리거 ID Example : `1`	integer	None

Responses

HTTP Code	Description	Schema
200	OK	Trigger
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/triggers/{trigger_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 = scf 1.0"

Example HTTP response

Response 200

{
    "alias": "$LATEST",
    "schedule": "* * * * 0",
    "timezone": "Asia/Tokyo",
    "trigger_id": 1,
    "trigger_name": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "trigger_sid": "617b3d0e90c24a5fa1f65a3824861354",
    "trigger_target_account_id": "617b3d0e90c24a5fa1f65a3824861354",
    "trigger_target_srn": "srn:dev2::f32265726b694b32920aa3b111f4c715:::iam:user/9abd88ba08434777a8ca168e799eebbe",
    "trigger_target_uuid": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "trigger_type": "apigateway"
}

2.1.26 - Show General Config

2.1.26.1 - 1.3

get /v1/cloud-functions/{cloud_function_id}/configurations/config

Description

일반 구성 조회

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None

Responses

HTTP Code	Description	Schema
200	OK	FunctionConfig
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/config

Request header

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

Example HTTP response

Response 200

{
    "max_scale": "5",
    "memory": "256",
    "min_scale": "1",
    "timeout": "100"
}

2.1.27 - Show PrivateLink Service

2.1.27.1 - 1.3

get /v1/cloud-functions/{cloud_function_id}/configurations/privatelink-services

Description

PrivateLink Service 조회

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
query	sort optional	정렬 Example : `endpoint_id:asc`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	PrivateLinkServiceV1Dot3
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/privatelink-services

Request header

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

Example HTTP response

Response 200

{
    "private_url": "https://sample.scf.private.kr-west1.e.samsungsdscloud.com",
    "privatelink_service_auth_type": "SCP_IAM",
    "privatelink_service_enabled": true,
    "privatelink_service_id": "ba30549f550141ef9af6546543s",
    "privatelink_service_name": "68216f8f56",
    "privatelink_service_state": "Active",
    "requested_endpoints": []
}

2.1.28 - Show Resource Policy

2.1.28.1 - 1.3

get /v1/cloud-functions/{cloud_function_id}/configurations/resource-policies

Description

리소스 정책 조회

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ResourcePolicyShowResponse
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/resource-policies

Request header

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

Example HTTP response

Response 200

{
    "policy_document": {
        "Statement": [
            {
                "Action": [
                    "scf:InvokeFunction"
                ],
                "Condition": {
                    "StringEquals": {
                        "scf:CloudFunctionAuthType": [
                            "SCP_IAM"
                        ]
                    }
                },
                "Effect": "Allow",
                "Principal": "*",
                "Resource": [
                    "srn:e::27bb070b564349f8a31cc60734cc36a5:kr-west1::scf:cloud-function/1a2afa4bfb854a828602c93009cf4447"
                ],
                "Sid": "Statement1"
            }
        ],
        "Version": "2024-07-01"
    }
}

2.1.29 - Show Url Config

2.1.29.1 - 1.3

get /v1/cloud-functions/{cloud_function_id}/configurations/url

Description

URL Config 조회

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None

Responses

HTTP Code	Description	Schema
200	OK	FunctionUrlV1Dot3
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/url

Request header

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

Example HTTP response

Response 200

{
    "allow_ips": [
        ""
    ],
    "auth_type": "NONE",
    "public_endpoint_url": "https://scf.33b532c466824bcf9324101a3c6f3015.kr-west1.dev2.samsungsdscloud.com/sample-function",
    "public_ip_acl_enabled": true,
    "state": "CREATING",
    "url_enabled": true
}

2.1.30 - Update Cloud Function Code

2.1.30.1 - 1.3

put /v1/cloud-functions/{cloud_function_id}/codes

Description

Cloud Function 코드 수정

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
body	body required		CodeSetRequest

Responses

HTTP Code	Description	Schema
202	Accepted	Code
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/codes

Request header

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

Request body

{
    "content": "print(\"Hello World\")"
}

Example HTTP response

Response 202

{
    "class_name": "com.example.Handler",
    "code_text": "ZXhwb3J0cy5oYW5kbGVSZXF1ZXN0ID0gYXN5bmM==",
    "code_type": "text",
    "file_name": "sample",
    "file_transfer_status": "sample",
    "file_upload_at": "2025-05-17 00:23:17",
    "method_name": "handleRequest",
    "runtime": "Node.js:20"
}

2.1.30.2 - 1.2

put /v1/cloud-functions/{cloud_function_id}/codes

Description

Cloud Function 코드 수정

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.2	20260630

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
body	body required		CodeSetRequest

Responses

HTTP Code	Description	Schema
202	Accepted	Code
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/codes

Request header

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

Request body

{
    "content": "print(\"Hello World\")"
}

Example HTTP response

Response 202

{
    "class_name": "com.example.Handler",
    "code_text": "ZXhwb3J0cy5oYW5kbGVSZXF1ZXN0ID0gYXN5bmM==",
    "code_type": "text",
    "file_name": "sample",
    "file_transfer_status": "sample",
    "file_upload_at": "2025-05-17 00:23:17",
    "method_name": "handleRequest",
    "runtime": "Node.js:20"
}

2.1.30.3 - 1.1

put /v1/cloud-functions/{cloud_function_id}/codes

Description

Cloud Function 코드 수정

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260430

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
body	body required		CodeSetRequest

Responses

HTTP Code	Description	Schema
202	Accepted	Code
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/codes

Request header

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

Request body

{
    "content": "print(\"Hello World\")"
}

Example HTTP response

Response 202

{
    "class_name": "com.example.Handler",
    "code_text": "ZXhwb3J0cy5oYW5kbGVSZXF1ZXN0ID0gYXN5bmM==",
    "code_type": "text",
    "file_name": "sample",
    "file_transfer_status": "sample",
    "file_upload_at": "2025-05-17 00:23:17",
    "method_name": "handleRequest",
    "runtime": "Node.js:20"
}

2.1.30.4 - 1.0

put /v1/cloud-functions/{cloud_function_id}/codes

Description

Cloud Function 코드 수정

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
body	body required		CodeSetRequest

Responses

HTTP Code	Description	Schema
202	Accepted	Code
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/codes

Request header

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

Request body

{
    "content": "print(\"Hello World\")"
}

Example HTTP response

Response 202

{
    "class_name": "com.example.Handler",
    "code_text": "ZXhwb3J0cy5oYW5kbGVSZXF1ZXN0ID0gYXN5bmM==",
    "code_type": "text",
    "file_name": "sample",
    "file_transfer_status": "sample",
    "file_upload_at": "2025-05-17 00:23:17",
    "method_name": "handleRequest",
    "runtime": "Node.js:20"
}

2.1.31 - Update Cloud Function Code File

2.1.31.1 - 1.3

put /v1/cloud-functions/{cloud_function_id}/codes/file

Description

Cloud Function 코드 파일 수정

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
body	body required		CodeFile

Responses

HTTP Code	Description	Schema
202	Accepted	Code
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/codes/file

Request header

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

Request body

{
    "class_name": "com.example.Handler",
    "method_name": "handleRequest",
    "obs_url": "https://obs.kr-east1.scp-in.com:8443/sample/java-sample-1.0-SNAPSHOT.jar"
}

Example HTTP response

Response 202

{
    "class_name": "com.example.Handler",
    "code_text": "ZXhwb3J0cy5oYW5kbGVSZXF1ZXN0ID0gYXN5bmM==",
    "code_type": "text",
    "file_name": "sample",
    "file_transfer_status": "sample",
    "file_upload_at": "2025-05-17 00:23:17",
    "method_name": "handleRequest",
    "runtime": "Node.js:20"
}

2.1.31.2 - 1.2

put /v1/cloud-functions/{cloud_function_id}/codes/file

Description

Cloud Function 코드 파일 수정

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.2	20260630

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
body	body required		CodeFile

Responses

HTTP Code	Description	Schema
202	Accepted	Code
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/codes/file

Request header

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

Request body

{
    "class_name": "com.example.Handler",
    "method_name": "handleRequest",
    "obs_url": "https://obs.kr-east1.scp-in.com:8443/sample/java-sample-1.0-SNAPSHOT.jar"
}

Example HTTP response

Response 202

{
    "class_name": "com.example.Handler",
    "code_text": "ZXhwb3J0cy5oYW5kbGVSZXF1ZXN0ID0gYXN5bmM==",
    "code_type": "text",
    "file_name": "sample",
    "file_transfer_status": "sample",
    "file_upload_at": "2025-05-17 00:23:17",
    "method_name": "handleRequest",
    "runtime": "Node.js:20"
}

2.1.31.3 - 1.1

put /v1/cloud-functions/{cloud_function_id}/codes/file

Description

Cloud Function 코드 파일 수정

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260430

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
body	body required		CodeFile

Responses

HTTP Code	Description	Schema
202	Accepted	Code
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/codes/file

Request header

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

Request body

{
    "class_name": "com.example.Handler",
    "method_name": "handleRequest",
    "obs_url": "https://obs.kr-east1.scp-in.com:8443/sample/java-sample-1.0-SNAPSHOT.jar"
}

Example HTTP response

Response 202

{
    "class_name": "com.example.Handler",
    "code_text": "ZXhwb3J0cy5oYW5kbGVSZXF1ZXN0ID0gYXN5bmM==",
    "code_type": "text",
    "file_name": "sample",
    "file_transfer_status": "sample",
    "file_upload_at": "2025-05-17 00:23:17",
    "method_name": "handleRequest",
    "runtime": "Node.js:20"
}

2.1.32 - Update Cloud Function Config

2.1.32.1 - 1.3

put /v1/cloud-functions/{cloud_function_id}/configurations/config

Description

Cloud Function 일반 구성 수정

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
body	body required		FunctionConfig

Responses

HTTP Code	Description	Schema
200	OK	FunctionConfig
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/config

Request header

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

Request body

{
    "max_scale": "5",
    "memory": "256",
    "min_scale": "1",
    "timeout": "100"
}

Example HTTP response

Response 200

{
    "max_scale": "5",
    "memory": "256",
    "min_scale": "1",
    "timeout": "100"
}

2.1.32.2 - 1.2

put /v1/cloud-functions/{cloud_function_id}/configurations/config

Description

Cloud Function 일반 구성 수정

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.2	20260630

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
body	body required		FunctionConfig

Responses

HTTP Code	Description	Schema
200	OK	FunctionConfig
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/config

Request header

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

Request body

{
    "max_scale": "5",
    "memory": "256",
    "min_scale": "1",
    "timeout": "100"
}

Example HTTP response

Response 200

{
    "max_scale": "5",
    "memory": "256",
    "min_scale": "1",
    "timeout": "100"
}

2.1.32.3 - 1.1

put /v1/cloud-functions/{cloud_function_id}/configurations/config

Description

Cloud Function 일반 구성 수정

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260430

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
body	body required		FunctionConfig

Responses

HTTP Code	Description	Schema
200	OK	FunctionConfig
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/config

Request header

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

Request body

{
    "max_scale": "5",
    "memory": "256",
    "min_scale": "1",
    "timeout": "100"
}

Example HTTP response

Response 200

{
    "max_scale": "5",
    "memory": "256",
    "min_scale": "1",
    "timeout": "100"
}

2.1.32.4 - 1.0

put /v1/cloud-functions/{cloud_function_id}/configurations/config

Description

Cloud Function 일반 구성 수정

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
body	body required		FunctionConfig

Responses

HTTP Code	Description	Schema
200	OK	FunctionConfig
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/config

Request header

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

Request body

{
    "max_scale": "5",
    "memory": "256",
    "min_scale": "1",
    "timeout": "100"
}

Example HTTP response

Response 200

{
    "max_scale": "5",
    "memory": "256",
    "min_scale": "1",
    "timeout": "100"
}

2.1.33 - Update Cloud Function Cronjob Trigger

2.1.33.1 - 1.3

put /v1/triggers/cronjob/{trigger_id}

Description

Cloud Function 트리거 수정

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	trigger_id required	트리거 ID Example : `1`	integer	None
body	body required		CronjobTriggerSetRequest

Responses

HTTP Code	Description	Schema
200	OK	TriggerUpdateResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/triggers/cronjob/{trigger_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 = scf 1.3"

Request body

{
    "cloud_function_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "schedule": "* * * * 0",
    "timezone": "Asia/Tokyo"
}

Example HTTP response

Response 200

{
    "alias": "$LATEST",
    "cloud_function_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "triggers": [
        {
            "schedule": "* * * * 0",
            "timezone": "Asia/Tokyo",
            "trigger_id": 1,
            "trigger_name": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_target_account_id": "617b3d0e90c24a5fa1f65a3824861354",
            "trigger_target_srn": "srn:dev2::f32265726b694b32920aa3b111f4c715:::iam:user/9abd88ba08434777a8ca168e799eebbe",
            "trigger_target_uuid": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_type": "apigateway"
        }
    ]
}

2.1.33.2 - 1.2

put /v1/triggers/cronjob/{trigger_id}

Description

Cloud Function 트리거 수정

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.2	20260630

Parameters

Type	Name	Description	Schema	Default
path	trigger_id required	트리거 ID Example : `1`	integer	None
body	body required		CronjobTriggerSetRequest

Responses

HTTP Code	Description	Schema
200	OK	TriggerUpdateResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/triggers/cronjob/{trigger_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 = scf 1.2"

Request body

{
    "cloud_function_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "schedule": "* * * * 0",
    "timezone": "Asia/Tokyo"
}

Example HTTP response

Response 200

{
    "alias": "$LATEST",
    "cloud_function_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "triggers": [
        {
            "schedule": "* * * * 0",
            "timezone": "Asia/Tokyo",
            "trigger_id": 1,
            "trigger_name": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_target_account_id": "617b3d0e90c24a5fa1f65a3824861354",
            "trigger_target_srn": "srn:dev2::f32265726b694b32920aa3b111f4c715:::iam:user/9abd88ba08434777a8ca168e799eebbe",
            "trigger_target_uuid": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_type": "apigateway"
        }
    ]
}

2.1.33.3 - 1.1

put /v1/triggers/cronjob/{trigger_id}

Description

Cloud Function 트리거 수정

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260430

Parameters

Type	Name	Description	Schema	Default
path	trigger_id required	트리거 ID Example : `1`	integer	None
body	body required		CronjobTriggerSetRequest

Responses

HTTP Code	Description	Schema
200	OK	TriggerUpdateResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/triggers/cronjob/{trigger_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 = scf 1.1"

Request body

{
    "cloud_function_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "schedule": "* * * * 0",
    "timezone": "Asia/Tokyo"
}

Example HTTP response

Response 200

{
    "alias": "$LATEST",
    "cloud_function_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "triggers": [
        {
            "schedule": "* * * * 0",
            "timezone": "Asia/Tokyo",
            "trigger_id": 1,
            "trigger_name": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_target_account_id": "617b3d0e90c24a5fa1f65a3824861354",
            "trigger_target_srn": "srn:dev2::f32265726b694b32920aa3b111f4c715:::iam:user/9abd88ba08434777a8ca168e799eebbe",
            "trigger_target_uuid": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_type": "apigateway"
        }
    ]
}

2.1.33.4 - 1.0

put /v1/triggers/cronjob/{trigger_id}

Description

Cloud Function 트리거 수정

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	trigger_id required	트리거 ID Example : `1`	integer	None
body	body required		CronjobTriggerSetRequest

Responses

HTTP Code	Description	Schema
200	OK	TriggerUpdateResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/triggers/cronjob/{trigger_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 = scf 1.0"

Request body

{
    "cloud_function_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "schedule": "* * * * 0",
    "timezone": "Asia/Tokyo"
}

Example HTTP response

Response 200

{
    "alias": "$LATEST",
    "cloud_function_id": "8c9f6c1c928a45b4bbd1e4da5531d656",
    "triggers": [
        {
            "schedule": "* * * * 0",
            "timezone": "Asia/Tokyo",
            "trigger_id": 1,
            "trigger_name": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_target_account_id": "617b3d0e90c24a5fa1f65a3824861354",
            "trigger_target_srn": "srn:dev2::f32265726b694b32920aa3b111f4c715:::iam:user/9abd88ba08434777a8ca168e799eebbe",
            "trigger_target_uuid": "8c9f6c1c928a45b4bbd1e4da5531d656",
            "trigger_type": "apigateway"
        }
    ]
}

2.1.34 - Update Cloud Function Url

2.1.34.1 - 1.3

put /v1/cloud-functions/{cloud_function_id}/configurations/url

Description

Cloud Function 함수 URL 수정

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
body	body required		FunctionUrlRequest

Responses

HTTP Code	Description	Schema
200	OK	FunctionUrlV1Dot3
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/url

Request header

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

Request body

{
    "allow_ips": [],
    "auth_type": "NONE",
    "public_ip_acl_enabled": true,
    "url_enabled": true
}

Example HTTP response

Response 200

{
    "allow_ips": [
        ""
    ],
    "auth_type": "NONE",
    "public_endpoint_url": "https://scf.33b532c466824bcf9324101a3c6f3015.kr-west1.dev2.samsungsdscloud.com/sample-function",
    "public_ip_acl_enabled": true,
    "state": "CREATING",
    "url_enabled": true
}

2.1.34.2 - 1.2

put /v1/cloud-functions/{cloud_function_id}/configurations/url

Description

Cloud Function 함수 URL 수정

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.2	20260630

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
body	body required		FunctionUrlRequest

Responses

HTTP Code	Description	Schema
200	OK	FunctionUrl
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/url

Request header

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

Request body

{
    "allow_ips": [],
    "auth_type": "NONE",
    "public_ip_acl_enabled": true,
    "url_enabled": true
}

Example HTTP response

Response 200

{
    "allow_ips": [
        ""
    ],
    "auth_type": "NONE",
    "public_endpoint_url": "https://scf.33b532c466824bcf9324101a3c6f3015.kr-west1.dev2.samsungsdscloud.com/sample-function",
    "public_ip_acl_enabled": true,
    "url_enabled": true
}

2.1.34.3 - 1.1

put /v1/cloud-functions/{cloud_function_id}/configurations/url

Description

Cloud Function 함수 URL 수정

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260430

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
body	body required		FunctionUrlRequest

Responses

HTTP Code	Description	Schema
200	OK	FunctionUrl
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/url

Request header

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

Request body

{
    "allow_ips": [],
    "auth_type": "NONE",
    "public_ip_acl_enabled": true,
    "url_enabled": true
}

Example HTTP response

Response 200

{
    "allow_ips": [
        ""
    ],
    "auth_type": "NONE",
    "public_endpoint_url": "https://scf.33b532c466824bcf9324101a3c6f3015.kr-west1.dev2.samsungsdscloud.com/sample-function",
    "public_ip_acl_enabled": true,
    "url_enabled": true
}

2.1.34.4 - 1.0

put /v1/cloud-functions/{cloud_function_id}/configurations/url

Description

Cloud Function 함수 URL 수정

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
body	body required		FunctionUrlRequest

Responses

HTTP Code	Description	Schema
200	OK	FunctionUrl
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/url

Request header

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

Request body

{
    "allow_ips": [],
    "auth_type": "NONE",
    "public_ip_acl_enabled": true,
    "url_enabled": true
}

Example HTTP response

Response 200

{
    "allow_ips": [
        ""
    ],
    "auth_type": "NONE",
    "public_endpoint_url": "https://scf.33b532c466824bcf9324101a3c6f3015.kr-west1.dev2.samsungsdscloud.com/sample-function",
    "public_ip_acl_enabled": true,
    "url_enabled": true
}

2.1.35 - Update Cloud Function Variables

2.1.35.1 - 1.3

put /v1/cloud-functions/{cloud_function_id}/configurations/environment-variables

Description

Cloud Function 환경 변수 수정

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
body	body required		FunctionVariables

Responses

HTTP Code	Description	Schema
200	OK	FunctionVariables
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/environment-variables

Request header

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

Request body

{
    "variables": [
        {
            "key": "sample",
            "value": "sample"
        }
    ]
}

Example HTTP response

Response 200

{
    "variables": [
        {
            "key": "sample",
            "value": "sample"
        }
    ]
}

2.1.35.2 - 1.2

put /v1/cloud-functions/{cloud_function_id}/configurations/environment-variables

Description

Cloud Function 환경 변수 수정

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.2	20260630

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
body	body required		FunctionVariables

Responses

HTTP Code	Description	Schema
200	OK	FunctionVariables
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/environment-variables

Request header

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

Request body

{
    "variables": [
        {
            "key": "sample",
            "value": "sample"
        }
    ]
}

Example HTTP response

Response 200

{
    "variables": [
        {
            "key": "sample",
            "value": "sample"
        }
    ]
}

2.1.35.3 - 1.1

put /v1/cloud-functions/{cloud_function_id}/configurations/environment-variables

Description

Cloud Function 환경 변수 수정

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260430

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
body	body required		FunctionVariables

Responses

HTTP Code	Description	Schema
200	OK	FunctionVariables
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/environment-variables

Request header

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

Request body

{
    "variables": [
        {
            "key": "sample",
            "value": "sample"
        }
    ]
}

Example HTTP response

Response 200

{
    "variables": [
        {
            "key": "sample",
            "value": "sample"
        }
    ]
}

2.1.35.4 - 1.0

put /v1/cloud-functions/{cloud_function_id}/configurations/environment-variables

Description

Cloud Function 환경 변수 수정

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
body	body required		FunctionVariables

Responses

HTTP Code	Description	Schema
200	OK	FunctionVariables
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/environment-variables

Request header

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

Request body

{
    "variables": [
        {
            "key": "sample",
            "value": "sample"
        }
    ]
}

Example HTTP response

Response 200

{
    "variables": [
        {
            "key": "sample",
            "value": "sample"
        }
    ]
}

2.1.36 - Update PrivateLink Service

2.1.36.1 - 1.3

put /v1/cloud-functions/{cloud_function_id}/configurations/privatelink-services

Description

PrivateLink Service 수정

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
body	body required		PrivateLinkServicePutRequest

Responses

HTTP Code	Description	Schema
202	Accepted	PrivateLinkServiceV1Dot3
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/privatelink-services

Request header

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

Request body

{
    "privatelink_service_enabled": true
}

Example HTTP response

Response 202

{
    "private_url": "https://sample.scf.private.kr-west1.e.samsungsdscloud.com",
    "privatelink_service_auth_type": "SCP_IAM",
    "privatelink_service_enabled": true,
    "privatelink_service_id": "ba30549f550141ef9af6546543s",
    "privatelink_service_name": "68216f8f56",
    "privatelink_service_state": "Active",
    "requested_endpoints": []
}

2.1.36.2 - 1.2

put /v1/cloud-functions/{cloud_function_id}/configurations/privatelink-services

Description

PrivateLink Service 수정

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.2	20260630

Parameters

Type	Name	Description	Schema	Default
path	cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string	None
body	body required		PrivateLinkServicePutRequest

Responses

HTTP Code	Description	Schema
202	Accepted	PrivateLinkService
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cloud-functions/{cloud_function_id}/configurations/privatelink-services

Request header

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

Request body

{
    "privatelink_service_enabled": true
}

Example HTTP response

Response 202

{
    "private_url": "https://sample.scf.private.kr-west1.e.samsungsdscloud.com",
    "privatelink_service_enabled": true,
    "privatelink_service_id": "ba30549f550141ef9af6546543s",
    "privatelink_service_name": "68216f8f56",
    "requested_endpoints": []
}

2.2 - Models

2.2.1 - ApigatewayTriggerCreateRequest

Name	Description	Schema
apigateway_api_id required	Apigateway API ID Example : `31e749b7b260868f441e862b` Pattern : `^[0-9a-f]{24}$`	string
apigateway_stage_name required	Apigateway 스테이지 이름 Example : `sample` Pattern : `^[a-z0-9\-]+$`	string
cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656` Pattern : `^[0-9a-f]{32}$`	string

2.2.2 - CloudFunction

Name	Description	Schema
account_id required	어카운트 ID Example : `617b3d0e90c24a5fa1f65a3824861354`	string
function_url required	함수 URL Example : `https://33b532c466824bcf9324101a3c6f3015.kr-west1.dev2.samsungsdscloud.com/cloudfunctions-hello`	any of [string, null]
id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string
name required	Cloud Functions 이름 Example : `sample`	string
runtime required	런타임 Example : `Node.js:20`	string
state required	함수 상태 Example : `READY`	string
user_id required	사용자 ID Example : `617b3d0e90c24a5fa1f65a3824861354`	string

2.2.3 - CloudFunctionCreateRequest

Name	Description	Schema
content required	코드 내용 Example : `sample`	string
name required	이름 Example : `sample-function-name` Pattern : `^[a-z][a-z0-9-]$` Minimum length* : `3` Maximum length : `64`	string
runtime required	런타임 Example : `Node.js:20`	string
tags optional	태그 목록	any of [array[Tag], null]

2.2.4 - CloudFunctionCreateResponse

Name	Description	Schema
id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string
message required	설명 Example : `Description`	string
state required	함수 상태 Example : `READY`	string

2.2.5 - CloudFunctionForList

Name	Description	Schema
account_id required	어카운트 ID Example : `617b3d0e90c24a5fa1f65a3824861354`	string
created_at required	생성 시간 Example : `2025-05-22T06:21:17.580522`	string (date-time)
function_url required	함수 URL Example : `https://33b532c466824bcf9324101a3c6f3015.kr-west1.dev2.samsungsdscloud.com/cloudfunctions-hello`	any of [string, null]
id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string
name required	Cloud Functions 이름 Example : `sample`	string
runtime required	런타임 Example : `Node.js:20`	string
state required	함수 상태 Example : `READY`	string
user_id required	사용자 ID Example : `617b3d0e90c24a5fa1f65a3824861354`	string

2.2.6 - CloudFunctionListResponse

Name	Description	Schema	Default
cloud_functions required	내용	array[CloudFunctionForList]
count required	합계 Example : `20`	integer

2.2.7 - CloudFunctionShowResponse

Name	Description	Schema	Default
cloud_function required		CloudFunction

2.2.8 - Code

Name	Description	Schema
class_name optional	클래스명 Example : `com.example.Handler`	any of [string, null]
code_text optional	코드 내용 Example : `ZXhwb3J0cy5oYW5kbGVSZXF1ZXN0ID0gYXN5bmM==`	any of [string, null]
code_type required	코드 유형 Example : `text`	string
file_name optional	파일명 Example : `sample`	any of [string, null]
file_transfer_status optional	파일 전송 상태 Example : `sample`	any of [string, null]
file_upload_at optional	파일 업로드 시간 Example : `2025-05-17 00:23:17`	any of [string, null]
method_name optional	메소드명 Example : `handleRequest`	any of [string, null]
runtime required	런타임 Example : `Node.js:20`	string

2.2.9 - CodeFile

Name	Description	Schema
class_name required	클래스명 Example : `com.example.Handler`	string
method_name required	메소드명 Example : `handleRequest`	string
obs_url optional	Object Storage URL Example : `https://obs.kr-east1.scp-in.com:8443/sample/java-sample-1.0-SNAPSHOT.jar`	any of [string, null]

2.2.10 - CodeSetRequest

Name	Description	Schema	Default
content required	코드 내용 Example : `print("Hello World")`	string

2.2.11 - Configuration

Name	Description	Schema
config required	일반 구성	FunctionConfig
url required	함수 URL	FunctionUrl
variables optional	환경 변수	any of [array[FunctionVariable], null]

2.2.12 - ConfigurationV1Dot2

Name	Description	Schema
config required	일반 구성	FunctionConfig
privatelink_endpoints optional	Endpoints	any of [array[Endpoint], null]
privatelink_service optional	PrivateLink Service	any of [PrivateLinkService, null]
url required	함수 URL	FunctionUrl
variables optional	환경 변수	any of [array[FunctionVariable], null]

2.2.13 - CronjobTriggerCreateRequest

Name	Description	Schema
cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656` Pattern : `^[0-9a-f]{32}$`	string
schedule required	스케쥴 Example : `* * * * 0`	string
timezone required	타임존 Example : `Asia/Tokyo`	string

2.2.14 - CronjobTriggerSetRequest

Name	Description	Schema
cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656` Pattern : `^[0-9a-f]{32}$`	string
schedule required	스케쥴 Example : `* * * * 0`	string
timezone required	타임존 Example : `Asia/Tokyo`	string

2.2.15 - DuplicationShowResponse

Name	Description	Schema	Default
result required	결과 Example : `True`	boolean

2.2.16 - Endpoint

Name	Description	Schema
endpoint_alias optional	Alias Example : `sample`	any of [string, null]
endpoint_id required	Endpoint Id Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string
service_id optional	Service Id Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	any of [string, null]
state required	상태 Example : `Active`	string

2.2.17 - EndpointCreateRequest

Name	Description	Schema	Default
alias required	Alias Example : `sample`	string
service_id required	Service Id Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string

2.2.18 - FunctionConfig

Name	Description	Schema
max_scale required	최대 작업 수 Example : `5`	integer
memory required	메모리 Example : `256`	integer
min_scale required	최소 작업 수 Example : `1`	integer
timeout required	제한 시간 Example : `100`	integer

2.2.19 - FunctionUrl

Name	Description	Schema
allow_ips optional	허용 IP Example :	any of [array[string], null]
auth_type optional	인증 유형 Example : `NONE`	any of [string, null]
public_endpoint_url optional	Public 엔드포인트 URL Example : `https://scf.33b532c466824bcf9324101a3c6f3015.kr-west1.dev2.samsungsdscloud.com/sample-function`	any of [string, null]
public_ip_acl_enabled optional	Public IP 접근 제어 사용 Example : `True`	any of [boolean, null]
url_enabled required	URL 사용 Example : `True`	boolean

2.2.20 - FunctionUrlRequest

Name	Description	Schema
allow_ips optional	허용 IP Example :	any of [array[string], null]
auth_type optional	인증 유형 Example : `NONE`	any of [string, null]
public_ip_acl_enabled required	Public IP 접근 제어 사용 Example : `True`	boolean
url_enabled required	URL 사용 Example : `True`	boolean

2.2.21 - FunctionUrlV1Dot3

Name	Description	Schema
allow_ips optional	허용 IP Example :	any of [array[string], null]
auth_type optional	인증 유형 Example : `NONE`	any of [string, null]
public_endpoint_url optional	Public 엔드포인트 URL Example : `https://scf.33b532c466824bcf9324101a3c6f3015.kr-west1.dev2.samsungsdscloud.com/sample-function`	any of [string, null]
public_ip_acl_enabled optional	Public IP 접근 제어 사용 Example : `True`	any of [boolean, null]
state optional	함수 URL 상태 Example : `CREATING`	any of [string, null]
url_enabled required	URL 사용 Example : `True`	boolean

2.2.22 - FunctionVariable

Name	Description	Schema	Default
key required	키 Example : `sample`	string
value required	값 Example : `sample`	string

2.2.23 - FunctionVariables

Name	Description	Schema	Default
variables required	환경 변수	array[FunctionVariable]

2.2.24 - Log

Name	Description	Schema	Default
log required	로그 Example : `[2025-05-12 11:04:12] START RequestId : 04680bac - ad76-4e0a-997e-e35b6275cb67 Version : $LATEST`	string
time required	시간 Example : `2025-05-17 00:23:17`	string

2.2.25 - LogShowResponse

Name	Description	Schema	Default
count required	합계 Example : `3`	integer
logs required	로그	array[Log]

2.2.26 - Metric

Name	Description	Schema	Default
metric_data required	Metric 데이터 Example : `1.0033444816053512`	object
time required	시간 Example : `16:37`	string

2.2.27 - MetricShowResponse

Name	Description	Schema
actual_pods required	실제 파드	array[Metric]
fail_count required	실패 카운트	array[Metric]
function_memory required	함수 메모리	array[Metric]
request_count required	요청 카운트	array[Metric]
request_latency required	요청 레이턴시	array[Metric]
success_count required	성공 카운트	array[Metric]

2.2.28 - PolicyDocument

Name	Description	Schema	Default
Statement required	Statement Example : `{'Statement': [{'Action': ['scf:InvokeFunction'], 'Condition': {'StringEquals': {'scf:CloudFunctionAuthType': ['SCP_IAM']}}, 'Effect': 'Allow', 'Principal': '*', 'Resource': ['srn:e::27bb070b564349f8a31cc60734cc36a5:kr-west1::scf:cloud-function/1a2afa4bfb854a828602c93009cf4447'], 'Sid': 'Statement1'}], 'Version': '2024-07-01'}`	array[Statement]
Version required	버전 Example : `2024-07-01`	string

2.2.29 - PrivateLinkEndpoint

Name	Description	Schema	Default
endpoint required	Endpoint	Endpoint

2.2.30 - PrivateLinkEndpointApproval

Name	Description	Schema	Default
type required	타입 Example : `APPROVE`	enum (APPROVE, REJECT)

2.2.31 - PrivateLinkEndpointConnection

Name	Description	Schema	Default
type required	타입 Example : `RECONNECT`	enum (DISCONNECT, RECONNECT)

2.2.32 - PrivateLinkEndpointCreateRequest

Name	Description	Schema	Default
endpoint required	Endpoint	EndpointCreateRequest

2.2.33 - PrivateLinkEndpointList

Name	Description	Schema	Default
privatelink_endpoints required	Endpoints	any of [array[Endpoint], null]

2.2.34 - PrivateLinkEndpointRequest

Name	Description	Schema	Default
type required	타입 Example : `CANCEL`	enum (CANCEL, RE_REQUEST)

2.2.35 - PrivateLinkService

Name	Description	Schema
private_url optional	Private Url Example : `https://sample.scf.private.kr-west1.e.samsungsdscloud.com`	any of [string, null]
privatelink_service_enabled required	PrivateLink Service 활성화 Example : `True`	boolean
privatelink_service_id optional	PrivateLink Service ID Example : `ba30549f550141ef9af6546543s`	any of [string, null]
privatelink_service_name optional	PrivateLink Service Example : `68216f8f56`	any of [string, null]
requested_endpoints optional	Endpoint	any of [array[Endpoint], null]

2.2.36 - PrivateLinkServicePutRequest

Name	Description	Schema	Default
privatelink_service_enabled required	PrivateLink Service 활성화 Example : `True`	boolean

2.2.37 - PrivateLinkServiceV1Dot3

Name	Description	Schema
private_url optional	Private Url Example : `https://sample.scf.private.kr-west1.e.samsungsdscloud.com`	any of [string, null]
privatelink_service_auth_type optional	PrivateLink Service 인증 타입 Example : `SCP_IAM`	any of [string, null]
privatelink_service_enabled required	PrivateLink Service 활성화 Example : `True`	boolean
privatelink_service_id optional	PrivateLink Service ID Example : `ba30549f550141ef9af6546543s`	any of [string, null]
privatelink_service_name optional	PrivateLink Service Example : `68216f8f56`	any of [string, null]
privatelink_service_state optional	상태 Example : `Active`	any of [string, null]
requested_endpoints optional	Endpoint	any of [array[Endpoint], null]

2.2.38 - ResourcePolicySetRequest

Name	Description	Schema	Default
policy_document required	Policy Document Example : `{'Statement': [{'Action': ['scf:InvokeFunction'], 'Condition': {'StringEquals': {'scf:CloudFunctionAuthType': ['SCP_IAM']}}, 'Effect': 'Allow', 'Principal': '*', 'Resource': ['srn:e::27bb070b564349f8a31cc60734cc36a5:kr-west1::scf:cloud-function/1a2afa4bfb854a828602c93009cf4447'], 'Sid': 'Statement1'}], 'Version': '2024-07-01'}`	PolicyDocument

2.2.39 - ResourcePolicyShowResponse

Name	Description	Schema	Default
policy_document optional	Policy Document Example : `{'Statement': [{'Action': ['scf:InvokeFunction'], 'Condition': {'StringEquals': {'scf:CloudFunctionAuthType': ['SCP_IAM']}}, 'Effect': 'Allow', 'Principal': '*', 'Resource': ['srn:e::27bb070b564349f8a31cc60734cc36a5:kr-west1::scf:cloud-function/1a2afa4bfb854a828602c93009cf4447'], 'Sid': 'Statement1'}], 'Version': '2024-07-01'}`	any of [PolicyDocument, null]

2.2.40 - Runtime

Name	Description	Schema
base_image_seq required	기본 이미지 번호 Example : `3`	integer
name required	이름 Example : `sample`	string
version required	버전 Example : `1.0.0`	string

2.2.41 - RuntimeListResponse

Name	Description	Schema	Default
count required	합계 Example : `3`	integer
runtimes required	Runtimes List	array[Runtime]

2.2.42 - SampleCode

Name	Description	Schema
content required	코드 내용 Example : `sample`	string
default required	기본값 Example : `False`	boolean
description required	설명 Example : `sample`	string
name required	이름 Example : `sample`	string
runtime required	런타임 Example : `Node.js:20`	string
seq required	번호 Example : `3`	integer
version required	버전 Example : `sample`	string

2.2.43 - SampleCodesListResponse

Name	Description	Schema	Default
count required	합계 Example : `3`	integer
sample_codes required	Sample Codes List	array[SampleCode]

2.2.44 - Statement

Name	Description	Schema	Default
Action optional	Action Example : `['iam:*']`	any of [array[string], null]
Condition optional	Condition Example : `{'StringEquals': {'scp:RequestedRegion': ['kr-west1']}}`	any of [object[object[array[object]]], null]
Effect required	Effect Example : `Allow`	enum (Allow, Deny)
NotAction optional	Not Action Example :	any of [array[string], null]
Principal optional	Principal Example :	any of [string, object[array[string]], null]
Resource optional	Resource Example : `['*']`	array[string]
Sid optional	Sid Example : `Statement1`	string	statement1

2.2.45 - Tag

Name	Description	Schema	Default
key required	태그 키 Example :	string
value required	태그 값 Example :	any of [string, null]

2.2.46 - Trigger

Name	Description	Schema
alias required	Alias Example : `$LATEST`	string
schedule optional	스케쥴 Example : `* * * * 0`	any of [string, null]
timezone optional	타임존 Example : `Asia/Tokyo`	any of [string, null]
trigger_id required	트리거 ID Example : `1`	integer
trigger_name required	트리거 타입 Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string
trigger_sid required	트리거 타겟 어카운트 ID Example : `617b3d0e90c24a5fa1f65a3824861354`	any of [string, null]
trigger_target_account_id required	트리거 타겟 어카운트 ID Example : `617b3d0e90c24a5fa1f65a3824861354`	any of [string, null]
trigger_target_srn required	트리거 타겟 SRN Example : `srn:dev2::f32265726b694b32920aa3b111f4c715:::iam:user/9abd88ba08434777a8ca168e799eebbe`	any of [string, null]
trigger_target_uuid required	트리거 타겟 UUID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	any of [string, null]
trigger_type required	트리거 타입 Example : `apigateway`	string

2.2.47 - TriggerCreateResponse

Name	Description	Schema
alias optional	Alias Example : `$LATEST`	any of [string, null]
cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string
triggers required	트리거	array[TriggerForList]

2.2.48 - TriggerDeleteRequest

Name	Description	Schema	Default
cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656` Pattern : `^[0-9a-f]{32}$`	string
trigger_type required	트리거 타입 Example : `apigateway`	string

2.2.49 - TriggerForList

Name	Description	Schema
schedule optional	스케쥴 Example : `* * * * 0`	any of [string, null]
timezone optional	타임존 Example : `Asia/Tokyo`	any of [string, null]
trigger_id optional	트리거 ID Example : `1`	any of [integer, null]
trigger_name required	트리거 타입 Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string
trigger_target_account_id required	트리거 타겟 어카운트 ID Example : `617b3d0e90c24a5fa1f65a3824861354`	any of [string, null]
trigger_target_srn required	트리거 타겟 SRN Example : `srn:dev2::f32265726b694b32920aa3b111f4c715:::iam:user/9abd88ba08434777a8ca168e799eebbe`	any of [string, null]
trigger_target_uuid required	트리거 타겟 UUID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	any of [string, null]
trigger_type required	트리거 타입 Example : `apigateway`	string

2.2.50 - TriggersResponse

Name	Description	Schema
alias required	Alias Example : `$LATEST`	string
count required	합계 Example : `20`	integer
triggers required	트리거	array[TriggerForList]

2.2.51 - TriggerUpdateResponse

Name	Description	Schema
alias optional	Alias Example : `$LATEST`	any of [string, null]
cloud_function_id required	Cloud Functions ID Example : `8c9f6c1c928a45b4bbd1e4da5531d656`	string
triggers required	트리거	array[TriggerForList]

3 - Multi-node GPU Cluster

Overview

SCP에서 제공하는 IaaS/PaaS 상품을 프로그램적으로 이용할 수 있도록 지원하는 응용 프로그램 인터페이스(Application Programming Interface, API)를 제공합니다.

본 가이드는 Multi-node GPU Cluster 서비스에 대한 간략한 설명 및 API를 호출하는 방법을 제공합니다. API는 RESTful API 방식으로 제공되며, JSON 형식으로 응답합니다.

Version

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

Version	Status	Not Before
1.2	CURRENT	-
1.1	DEPRECATED	20260331
1.0	DEPRECATED	20251231

OpenAPI URL

https://multinodegpucluster.{region}.{environment}.samsungsdscloud.com

Environment and Region List

environment	region
s	kr-west1
s	kr-east1
g	kr-south1
g	kr-south2
g	kr-south3
e	kr-west1
e	kr-east1

3.1 - APIs

3.1.1 - Assign GpuNode Public NAT IP

3.1.1.1 - 1.2

post /v1/gpu-nodes/{gpu_node_id}/public-nat-ip

Description

Assign public NAT IP to GPU Node.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	gpu_node_id required	GPU Node ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string	None
body	body required		GpuNodeAssignPublicNatIpRequest

Responses

HTTP Code	Description	Schema
202	Accepted	GpuNodeActionResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/gpu-nodes/{gpu_node_id}/public-nat-ip

Request header

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

Request body

{
    "public_ip_address_id": ""
}

Example HTTP response

Response 202

{
    "gpu_node_id": "20c507a036c447cdb3b19468d8ea62ac"
}

3.1.2 - Create GPU Nodes

3.1.2.1 - 1.2

post /v1/gpu-nodes

Description

Create GPU Nodes.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
body	body required		GpuNodeCreateRequest

Responses

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

Example HTTP request

Request path

/v1/gpu-nodes

Request header

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

Request body

{
    "cluster_fabric_details": {
        "cluster_fabric_id": "20c507a036c447cdb3b19468d8ea62ac",
        "cluster_fabric_name": "cluster001",
        "node_pool_id": "POOL001-krw1a"
    },
    "image_id": "IMAGE-7XFMaJpLsapKvskFMjCtmm",
    "init_script": "init script",
    "lock_enabled": true,
    "os_user_id": "user001",
    "os_user_password": "password",
    "region_id": "kr-west1",
    "server_details": [
        {
            "gpu_node_name": "gpu-node-001",
            "ip_address": "192.168.0.1",
            "nat_enabled": true,
            "public_ip_address_id": "20c507a036c447cdb3b19468d8ea62ac",
            "server_type_id": "f90e8ef54cc2451b825608e9f95f7bcb"
        }
    ],
    "subnet_id": "ab313c43291e4b678f4bacffe10768ae",
    "tags": [
        {
            "key": "",
            "value": ""
        }
    ],
    "vpc_id": "e58348b1bc9148e5af86500fd4ef99ca"
}

Example HTTP response

Response 202

{
    "account_id": "f5c8e56a4d9b49a8bd89e14758a32d53",
    "request_id": "req-002daa83-52d9-41e8-9b0f-d31d35610f65",
    "resource_id": "20c507a036c447cdb3b19468d8ea62ac"
}

3.1.3 - Delete GPU Nodes

3.1.3.1 - 1.2

delete /v1/gpu-nodes

Description

Delete GPU Nodes.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
body	body required		GpuNodeTerminateRequest

Responses

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

Example HTTP request

Request path

/v1/gpu-nodes

Request header

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

Request body

{
    "gpu_node_ids": [
        "20c507a036c447cdb3b19468d8ea62ac"
    ]
}

Example HTTP response

Response 202

{
    "account_id": "f5c8e56a4d9b49a8bd89e14758a32d53",
    "request_id": "req-002daa83-52d9-41e8-9b0f-d31d35610f65",
    "resource_id": "20c507a036c447cdb3b19468d8ea62ac"
}

3.1.4 - List Cluster Fabrics

3.1.4.1 - 1.2

get /v1/cluster-fabrics

Description

List Cluster Fabrics.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

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	cluster_fabric_name optional	Cluster Fabric 이름 Example : `cluster001`	any of [string, null]	None
query	state optional	State Example : `RUNNING`	any of [string, null]	None
query	node_pool_id optional	Node Pool ID Example : `POOL001-krw1a`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ClusterFabricListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cluster-fabrics

Request header

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

Example HTTP response

Response 200

{
    "cluster_fabrics": [
        {
            "account_id": "f5c8e56a4d9b49a8bd89e14758a32d53",
            "cluster_name": "cluster001",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "description": "description",
            "gpu_node_details": [
                {
                    "gpu_node_id": "20c507a036c447cdb3b19468d8ea62ac",
                    "gpu_node_name": "gpu-node-001",
                    "policy_ip": "192.168.0.1",
                    "product_type_id": "f90e8ef54cc2451b825608e9f95f7bcb",
                    "server_type": "s1v8m32_metal",
                    "state": "RUNNING"
                }
            ],
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "node_pool_id": "POOL001-krw1a",
            "pirp_id": "20",
            "product_id": "f90e8ef54cc2451b825608e9f95f7bcb",
            "region_id": "kr-west1",
            "server_type": "s1v8m32_metal",
            "state": "RUNNING",
            "used_server_count": 20
        }
    ],
    "count": 20
}

3.1.5 - List GPU Node Images

3.1.5.1 - 1.2

get /v1/gpu-nodes/images

Description

List GPU Node images.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
query	region_id required	리전 ID Example : `kr-west1`	string	None

Responses

HTTP Code	Description	Schema
200	OK	GpuNodeImageListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/gpu-nodes/images?region_id={region_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 = multinodegpucluster 1.2"

Example HTTP response

Response 200

{
    "images": [
        {
            "created_at": "2024-07-11 08:56:59",
            "id": "IMAGE-7XFMaJpLsapKvskFMjCtmm",
            "name": "RHEL 8.8 for BM",
            "os_distro": "RHEL",
            "priority": 20,
            "scp_image_type": "STANDARD",
            "scp_os_version": "8.7"
        }
    ]
}

3.1.6 - List GPU Node Products

3.1.6.1 - 1.2

get /v1/gpu-nodes/products

Description

List GPU Node products.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
query	type optional	Product 타입 Example : `SCALE`	any of [string, null]	None
query	image_id optional	이미지 ID Example : `IMAGE-7XFMaJpLsapKvskFMjCtmm`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	GpuNodeProductListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/gpu-nodes/products

Request header

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

Example HTTP response

Response 200

{
    "products": [
        {
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "description": "vCPU 16 │ Memory 128G │ Disk 480G",
            "id": "SCALE",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "s2v16m128_metal",
            "product_attrs": {
                "compute_class_type_name": "GPU H100 Metal-2",
                "compute_class_type_value": "g2_mteal",
                "cpu_value": "64",
                "disk_unit": "GB",
                "disk_value": "480",
                "gpu_model": "H100",
                "memory_value": "128"
            },
            "state": "AVAILABLE",
            "type": "SCALE"
        }
    ]
}

3.1.7 - List GPU Nodes

3.1.7.1 - 1.2

get /v1/gpu-nodes

Description

List GPU Nodes.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

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	gpu_node_name optional	GPU Node 이름 Example : `gpu-node-001`	any of [string, null]	None
query	state optional	GPU Node State Example : `RUNNING`	any of [string, null]	None
query	ip optional	Gpu Node ip Example : `192.168.0.1`	any of [string, null]	None
query	vpc_id optional	VPC ID Example : `e58348b1bc9148e5af86500fd4ef99ca`	any of [string, null]	None
query	cluster_fabric_name optional	Cluster Fabric 이름 Example : `cluster001`	any of [string, null]	None
query	cluster_fabric_id optional	Cluster Fabric ID Example : `20c507a036c447cdb3b19468d8ea62ac`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	GpuNodeListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/gpu-nodes

Request header

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

Example HTTP response

Response 200

{
    "count": 20,
    "gpu_nodes": [
        {
            "account_id": "f5c8e56a4d9b49a8bd89e14758a32d53",
            "cluster_fabric_id": "20c507a036c447cdb3b19468d8ea62ac",
            "cluster_fabric_name": "cluster001",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "gpu_node_name": "gpu-node-001",
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "image_id": "IMAGE-7XFMaJpLsapKvskFMjCtmm",
            "image_version": "RHEL 8.7 for BM",
            "init_script": "init script",
            "lock_enabled": true,
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "network_id": "ab313c43291e4b678f4bacffe10768ae",
            "node_pool_id": "POOL001-krw1a",
            "os_type": "WINDOWS",
            "pfs_ip": [
                "10.252.128.2",
                "10.252.128.3"
            ],
            "policy_ip": "192.168.0.1",
            "policy_nat": "192.168.0.1",
            "policy_use_nat": true,
            "product_type_id": "f90e8ef54cc2451b825608e9f95f7bcb",
            "region_id": "kr-west1",
            "root_account": "rootaccount",
            "server_type": "s1v8m32_metal",
            "state": "RUNNING",
            "time_zone": "Asia/Seoul",
            "vpc_id": "e58348b1bc9148e5af86500fd4ef99ca"
        }
    ]
}

3.1.8 - List Node Pools

3.1.8.1 - 1.2

get /v1/cluster-fabrics/node-pools

Description

List node pools.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
query	subnet_id optional	Subnet ID Example : `ab313c43291e4b678f4bacffe10768ae`	any of [string, null]	None
query	cluster_fabric_id optional	Cluster Fabric ID Example : `20c507a036c447cdb3b19468d8ea62ac`	any of [string, null]	None
query	node_pool_id optional	Node Pool ID Example : `POOL001-krw1a`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	NodePoolListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cluster-fabrics/node-pools

Request header

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

Example HTTP response

Response 200

{
    "count": 20,
    "node_pools": [
        {
            "cluster_fabric_details": [],
            "node_pool_id": "POOL001-krw1a"
        }
    ]
}

3.1.9 - Lock GPU Node

3.1.9.1 - 1.2

put /v1/gpu-nodes/{gpu_node_id}/lock

Description

Lock GPU Node.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	gpu_node_id required	GPU Node ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string	None

Responses

HTTP Code	Description	Schema
200	OK	GpuNodeActionResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/gpu-nodes/{gpu_node_id}/lock

Request header

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

Example HTTP response

Response 200

{
    "gpu_node_id": "20c507a036c447cdb3b19468d8ea62ac"
}

3.1.10 - Modify Cluster Fabric Members

3.1.10.1 - 1.2

post /v1/cluster-fabrics/modify-members

Description

Modify Cluster Fabric Members.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
body	body required		ClusterFabricMemberModifyRequestBody

Responses

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

Example HTTP request

Request path

/v1/cluster-fabrics/modify-members

Request header

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

Request body

{
    "after_cluster_fabric_id": "20c507a036c447cdb3b19468d8ea62ac",
    "before_cluster_fabric_id": "20c507a036c447cdb3b19468d8ea62ac",
    "gpu_node_id_list": [
        "20c507a036c447cdb3b19468d8ea62ac"
    ]
}

Example HTTP response

Response 202

{
    "account_id": "f5c8e56a4d9b49a8bd89e14758a32d53",
    "request_id": "req-002daa83-52d9-41e8-9b0f-d31d35610f65",
    "resource_id": "20c507a036c447cdb3b19468d8ea62ac"
}

3.1.11 - Release GPU Node Public NAT IP

3.1.11.1 - 1.2

delete /v1/gpu-nodes/{gpu_node_id}/public-nat-ip

Description

Release public NAT IP from GPU Node.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	gpu_node_id required	GPU Node ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	GpuNodeActionResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/gpu-nodes/{gpu_node_id}/public-nat-ip

Request header

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

Example HTTP response

Response 202

{
    "gpu_node_id": "20c507a036c447cdb3b19468d8ea62ac"
}

3.1.12 - Show Cluster Fabric

3.1.12.1 - 1.2

get /v1/cluster-fabrics/{cluster_fabric_id}

Description

Show Cluster Fabric.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	cluster_fabric_id required	Cluster Fabric ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ClusterFabricShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/cluster-fabrics/{cluster_fabric_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 = multinodegpucluster 1.2"

Example HTTP response

Response 200

{
    "account_id": "f5c8e56a4d9b49a8bd89e14758a32d53",
    "cluster_name": "cluster001",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "description": "description",
    "gpu_node_details": [
        {
            "gpu_node_id": "20c507a036c447cdb3b19468d8ea62ac",
            "gpu_node_name": "gpu-node-001",
            "policy_ip": "192.168.0.1",
            "product_type_id": "f90e8ef54cc2451b825608e9f95f7bcb",
            "server_type": "s1v8m32_metal",
            "state": "RUNNING"
        }
    ],
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "node_pool_id": "POOL001-krw1a",
    "pirp_id": "20",
    "product_id": "f90e8ef54cc2451b825608e9f95f7bcb",
    "region_id": "kr-west1",
    "server_type": "s1v8m32_metal",
    "state": "RUNNING",
    "used_server_count": 20
}

3.1.13 - Show GPU Node

3.1.13.1 - 1.2

get /v1/gpu-nodes/{gpu_node_id}

Description

Show GPU Node.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	gpu_node_id required	ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string	None

Responses

HTTP Code	Description	Schema
200	OK	GpuNodeShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/gpu-nodes/{gpu_node_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 = multinodegpucluster 1.2"

Example HTTP response

Response 200

{
    "account_id": "f5c8e56a4d9b49a8bd89e14758a32d53",
    "cluster_fabric_id": "20c507a036c447cdb3b19468d8ea62ac",
    "cluster_fabric_name": "cluster001",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "gpu_node_name": "gpu-node-001",
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "image_id": "IMAGE-7XFMaJpLsapKvskFMjCtmm",
    "image_version": "RHEL 8.7 for BM",
    "init_script": "init script",
    "lock_enabled": true,
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "network_id": "ab313c43291e4b678f4bacffe10768ae",
    "node_pool_id": "POOL001-krw1a",
    "os_type": "WINDOWS",
    "pfs_ip": [
        "10.252.128.2",
        "10.252.128.3"
    ],
    "policy_ip": "192.168.0.1",
    "policy_nat": "192.168.0.1",
    "policy_use_nat": true,
    "product_type_id": "f90e8ef54cc2451b825608e9f95f7bcb",
    "region_id": "kr-west1",
    "root_account": "rootaccount",
    "server_type": "s1v8m32_metal",
    "state": "RUNNING",
    "time_zone": "Asia/Seoul",
    "vpc_id": "e58348b1bc9148e5af86500fd4ef99ca"
}

3.1.14 - Start GPU Nodes

3.1.14.1 - 1.2

post /v1/gpu-nodes/start

Description

Start GPU Nodes.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
body	body required		GpuNodeOperationRequest

Responses

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

Example HTTP request

Request path

/v1/gpu-nodes/start

Request header

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

Request body

{
    "gpu_node_ids": [
        "20c507a036c447cdb3b19468d8ea62ac"
    ]
}

Example HTTP response

Response 202

{
    "account_id": "f5c8e56a4d9b49a8bd89e14758a32d53",
    "request_id": "req-002daa83-52d9-41e8-9b0f-d31d35610f65",
    "resource_id": "20c507a036c447cdb3b19468d8ea62ac"
}

3.1.15 - Stop GPU Nodes

3.1.15.1 - 1.2

post /v1/gpu-nodes/stop

Description

Stop GPU Nodes.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
body	body required		GpuNodeOperationRequest

Responses

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

Example HTTP request

Request path

/v1/gpu-nodes/stop

Request header

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

Request body

{
    "gpu_node_ids": [
        "20c507a036c447cdb3b19468d8ea62ac"
    ]
}

Example HTTP response

Response 202

{
    "account_id": "f5c8e56a4d9b49a8bd89e14758a32d53",
    "request_id": "req-002daa83-52d9-41e8-9b0f-d31d35610f65",
    "resource_id": "20c507a036c447cdb3b19468d8ea62ac"
}

3.1.16 - Unlock GPU Node

3.1.16.1 - 1.2

put /v1/gpu-nodes/{gpu_node_id}/unlock

Description

Unlock GPU Node.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	gpu_node_id required	GPU Node ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string	None

Responses

HTTP Code	Description	Schema
200	OK	GpuNodeActionResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/gpu-nodes/{gpu_node_id}/unlock

Request header

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

Example HTTP response

Response 200

{
    "gpu_node_id": "20c507a036c447cdb3b19468d8ea62ac"
}

3.2 - Models

3.2.1 - AsyncResponse

Name	Description	Schema
account_id required	Account ID Example : `f5c8e56a4d9b49a8bd89e14758a32d53`	string
request_id required	Request ID Example : `req-002daa83-52d9-41e8-9b0f-d31d35610f65`	string
resource_id required	자원 ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string

3.2.2 - ClusterFabricDetailsRequest

Name	Description	Schema
cluster_fabric_id required	Cluster Fabric ID Example : `20c507a036c447cdb3b19468d8ea62ac`	any of [string, null]
cluster_fabric_name required	Cluster Fabric 이름 Example : `cluster001`	string
node_pool_id required	Node Pool ID Example : `POOL001-krw1a`	string

3.2.3 - ClusterFabricDetailsResponse

Name	Description	Schema
cluster_fabric_id required	Cluster Fabric ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string
cluster_fabric_name required	Cluster Fabric 이름 Example : `cluster001`	string
product_id required	Product ID Example : `f90e8ef54cc2451b825608e9f95f7bcb`	any of [string, null]

3.2.4 - ClusterFabricListResponse

Name	Description	Schema	Default
cluster_fabrics required		array[ClusterFabricShowResponse]
count required	대수 Example : `20`	any of [integer, null]

3.2.5 - ClusterFabricMemberModifyRequestBody

Name	Description	Schema
after_cluster_fabric_id required	Cluster Fabric ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string
before_cluster_fabric_id required	Cluster Fabric ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string
gpu_node_id_list required	GPU Node ID List Example : `['20c507a036c447cdb3b19468d8ea62ac']`	array[string]

3.2.6 - ClusterFabricShowResponse

Name	Description	Schema
account_id required	Account ID Example : `f5c8e56a4d9b49a8bd89e14758a32d53`	string
cluster_name required	Cluster Fabric 이름 Example : `cluster001`	string
created_at required	생성 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	생성자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
description required	설명 Example : `description`	string
gpu_node_details optional	GPU Node 상세	any of [array[GpuNodeDetailsResponse], null]
id required	ID Example : `0fdd87aab8cb46f59b7c1f81ed03fb3e`	string
modified_at required	수정 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	수정자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
node_pool_id required	Node Pool ID Example : `POOL001-krw1a`	string
pirp_id optional	pirpId Example : `20`	any of [string, null]
product_id required	Product Type ID Example : `f90e8ef54cc2451b825608e9f95f7bcb`	string
region_id required	리전 ID Example : `kr-west1`	string
server_type optional	Server Type Example : `s1v8m32_metal`	any of [string, null]
state required	State Example : `RUNNING`	string
used_server_count optional	GPU Node Count Example : `20`	any of [integer, null]

3.2.7 - GpuNodeActionResponse

Name	Description	Schema	Default
gpu_node_id required	GPU Node ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string

3.2.8 - GpuNodeAssignPublicNatIpRequest

Name	Description	Schema	Default
public_ip_address_id required	Public NAT IP Address ID Example :	string

3.2.9 - GpuNodeCreateRequest

Name	Description	Schema
cluster_fabric_details required	Cluster Fabric 상세	ClusterFabricDetailsRequest
image_id required	이미지 ID Example : `IMAGE-7XFMaJpLsapKvskFMjCtmm`	string
init_script optional	Init Script Example : `init script`	any of [string, null]
lock_enabled optional	삭제 방지 여부 Example : `True`	boolean
os_user_id required	OS 사용자 계정 Example : `user001`	string
os_user_password required	OS 사용자 패스워드 Example : `password`	string
region_id required	리전 ID Example : `kr-west1`	string
server_details required	서버 상세	array[GpuNodeDetailsRequest]
subnet_id required	Subnet ID Example : `ab313c43291e4b678f4bacffe10768ae`	string
tags required	Tags	any of [array[Tag], null]
vpc_id required	VPC ID Example : `e58348b1bc9148e5af86500fd4ef99ca`	string

3.2.10 - GpuNodeDetailsRequest

Name	Description	Schema
gpu_node_name required	GPU Node 이름 Example : `gpu-node-001`	string
ip_address optional	Private IP Example : `192.168.0.1`	any of [string, null]
nat_enabled required	NAT 활성화 Example : `True`	boolean
public_ip_address_id optional	NAT IP ID Example : `20c507a036c447cdb3b19468d8ea62ac`	any of [string, null]
server_type_id required	Server Type ID Example : `f90e8ef54cc2451b825608e9f95f7bcb`	string

3.2.11 - GpuNodeDetailsResponse

Name	Description	Schema
gpu_node_id required	ID Example : `20c507a036c447cdb3b19468d8ea62ac`	string
gpu_node_name required	GPU Node 이름 Example : `gpu-node-001`	string
policy_ip required	정책 IP Example : `192.168.0.1`	string
product_type_id required	Product Type ID Example : `f90e8ef54cc2451b825608e9f95f7bcb`	string
server_type optional	Server Type Example : `s1v8m32_metal`	any of [string, null]
state required	State Example : `RUNNING`	string

3.2.12 - GpuNodeImageListResponse

Name	Description	Schema	Default
images required		array[GpuNodeImageShowResponse]

3.2.13 - GpuNodeImageShowResponse

Name	Description	Schema
created_at required	생성 시간 Example : `2024-07-11 08:56:59`	string
id required	이미지 ID Example : `IMAGE-7XFMaJpLsapKvskFMjCtmm`	string
name required	이름 Example : `RHEL 8.8 for BM`	string
os_distro required	OS Distro Example : `RHEL`	string
priority required	Gpu Node Image 우선순위 Example : `20`	string
scp_image_type required	SCP image type Example : `STANDARD`	string
scp_os_version required	SCP OS version Example : `8.7`	string

3.2.14 - GpuNodeListResponse

Name	Description	Schema	Default
count required	GPU Node Count Example : `20`	any of [integer, null]
gpu_nodes required		array[GpuNodeShowResponse]

3.2.15 - GpuNodeOperationRequest

Name	Description	Schema	Default
gpu_node_ids required	GPU Node ID List Example : `['20c507a036c447cdb3b19468d8ea62ac']`	array[object]

3.2.16 - GpuNodeProductAttr

Name	Description	Schema
compute_class_type_name required	Compute class type 이름 Example : `GPU H100 Metal-2`	string
compute_class_type_value required	Compute class type unit Example : `g2_mteal`	string
cpu_value required	CPU value Example : `64`	string
disk_unit required	Disk unit Example : `GB`	string
disk_value required	Disk value Example : `480`	string
gpu_model required	GPU Model Example : `H100`	string
memory_value required	Memory value Example : `128`	string

3.2.17 - GpuNodeProductListResponse

Name	Description	Schema	Default
products required	Product List	array[GpuNodeProductShowResponse]

3.2.18 - GpuNodeProductShowResponse

Name	Description	Schema
created_at required	생성 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	생성자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
description required	설명 Example : `vCPU 16 │ Memory 128G │ Disk 480G`	string
id required	ID Example : `SCALE`	string
modified_at required	수정 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	수정자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
name required	이름 Example : `s2v16m128_metal`	string
product_attrs required	Product type	GpuNodeProductAttr
state required	State Example : `AVAILABLE`	string
type required	유형 Example : `SCALE`	string

3.2.19 - GpuNodeShowResponse

Name	Description	Schema
account_id required	Account ID Example : `f5c8e56a4d9b49a8bd89e14758a32d53`	string
cluster_fabric_id optional	Cluster Fabric ID Example : `20c507a036c447cdb3b19468d8ea62ac`	any of [string, null]
cluster_fabric_name required	Cluster Fabric 이름 Example : `cluster001`	string
created_at required	생성 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	생성자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
gpu_node_name required	GPU Node 이름 Example : `gpu-node-001`	string
id required	ID Example : `0fdd87aab8cb46f59b7c1f81ed03fb3e`	string
image_id required	이미지 ID Example : `IMAGE-7XFMaJpLsapKvskFMjCtmm`	string
image_version required	Image Version Example : `RHEL 8.7 for BM`	string
init_script required	Init script Example : `init script`	string
lock_enabled optional	Lock 활성화 Example : `True`	boolean
modified_at required	수정 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	수정자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
network_id required	Network ID Example : `ab313c43291e4b678f4bacffe10768ae`	string
node_pool_id required	Node Pool ID Example : `POOL001-krw1a`	string
os_type required	OS type Example : `WINDOWS`	string
pfs_ip optional	PFS IP 목록 Example : `['10.252.128.2', '10.252.128.3']`	any of [array[string], null]
policy_ip required	정책 IP Example : `192.168.0.1`	string
policy_nat optional	Policy NAT Example : `192.168.0.1`	any of [string, null]
policy_use_nat optional	Policy use NAT Example : `True`	boolean
product_type_id required	Product type ID Example : `f90e8ef54cc2451b825608e9f95f7bcb`	string
region_id required	리전 ID Example : `kr-west1`	string
root_account required	Root account Example : `rootaccount`	string
server_type required	Server type Example : `s1v8m32_metal`	string
state required	GPU Node State Example : `RUNNING`	string
time_zone required	타임존 Example : `Asia/Seoul`	string
vpc_id required	VPC ID Example : `e58348b1bc9148e5af86500fd4ef99ca`	string

3.2.20 - GpuNodeTerminateRequest

Name	Description	Schema	Default
gpu_node_ids required	GPU Node ID List Example : `['20c507a036c447cdb3b19468d8ea62ac']`	array[object]

3.2.21 - NodePoolListResponse

Name	Description	Schema	Default
count required	대수 Example : `20`	any of [integer, null]
node_pools required		array[NodePoolShowResponse]

3.2.22 - NodePoolShowResponse

Name	Description	Schema	Default
cluster_fabric_details optional	Cluster Fabric 상세	array[ClusterFabricDetailsResponse]
node_pool_id required	Node Pool ID Example : `POOL001-krw1a`	string

3.2.23 - Tag

Name	Description	Schema	Default
key optional	tag key Example :	any of [string, null]
value optional	tag value Example :	any of [string, null]

4 - Virtual Server

Overview

SCP에서 제공하는 IaaS/PaaS 상품을 프로그램적으로 이용할 수 있도록 지원하는 응용 프로그램 인터페이스(Application Programming Interface, API)를 제공합니다.

본 가이드는 Virtual Server 서비스에 대한 간략한 설명 및 API를 호출하는 방법을 제공합니다. API는 RESTful API 방식으로 제공되며, JSON 형식으로 응답합니다.

Version

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

Version	Status	Not Before
1.2	CURRENT	-
1.1	DEPRECATED	20260531
1.0	DEPRECATED	20251231

OpenAPI URL

https://virtualserver.{region}.{environment}.samsungsdscloud.com

Environment and Region List

environment	region
s	kr-west1
s	kr-east1
g	kr-south1
g	kr-south2
g	kr-south3
e	kr-west1
e	kr-east1

4.1 - APIs

4.1.1 - Accept a volume transfer

4.1.1.1 - 1.2

post /v1/volume-transfer/{transfer_id}/accept

Description

볼륨 이전 받기를 수락합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	transfer_id required	볼륨 이전 ID Example : `1ac231be-823b-4a4d-8ff0-aac503a7118a`	string	None
body	body required		VolumeTransferAcceptRequest

Responses

HTTP Code	Description	Schema
202	Accepted	VolumeTransferAcceptResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/volume-transfer/{transfer_id}/accept

Request header

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

Request body

{
    "auth_key": "f5972fdb456897eb"
}

Example HTTP response

Response 202

{
    "id": "1ac231be-823b-4a4d-8ff0-aac503a7118a",
    "name": "volume01",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

4.1.1.2 - 1.1

post /v1/volume-transfer/{transfer_id}/accept

Description

볼륨 이전 받기를 수락합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	transfer_id required	볼륨 이전 ID Example : `1ac231be-823b-4a4d-8ff0-aac503a7118a`	string	None
body	body required		VolumeTransferAcceptRequest

Responses

HTTP Code	Description	Schema
202	Accepted	VolumeTransferAcceptResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/volume-transfer/{transfer_id}/accept

Request header

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

Request body

{
    "auth_key": "f5972fdb456897eb"
}

Example HTTP response

Response 202

{
    "id": "1ac231be-823b-4a4d-8ff0-aac503a7118a",
    "name": "volume01",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

4.1.1.3 - 1.0

post /v1/volume-transfer/{transfer_id}/accept

Description

볼륨 이전 받기를 수락합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	transfer_id required	볼륨 이전 ID Example : `1ac231be-823b-4a4d-8ff0-aac503a7118a`	string	None
body	body required		VolumeTransferAcceptRequest

Responses

HTTP Code	Description	Schema
202	Accepted	VolumeTransferAcceptResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/volume-transfer/{transfer_id}/accept

Request header

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

Request body

{
    "auth_key": "f5972fdb456897eb"
}

Example HTTP response

Response 202

{
    "id": "1ac231be-823b-4a4d-8ff0-aac503a7118a",
    "name": "volume01",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

4.1.2 - Attach Virtual Server Security Group

4.1.2.1 - 1.0

post /v1/servers/{server_id}/security-groups

Description

서버에 Security Group을 추가합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
body	body required		ServerSecurityGroupActionRequestBody

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/security-groups

Request header

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

Request body

{
    "security_group_id": "c09c3f05-03d9-443f-b27a-40e0f973c75f"
}

Example HTTP response

Response 202

4.1.3 - Attach Volume to Virtual Server

4.1.3.1 - 1.2

post /v1/volumes/{volume_id}/servers

Description

볼륨을 서버에 연결합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string	None
body	body required		VolumeServerAttachRequest

Responses

HTTP Code	Description	Schema
202	Accepted	VolumeServerAttachResponse
400	Bad Request	None
401	Unauthorized	None
409	Conflict	None

Example HTTP request

Request path

/v1/volumes/{volume_id}/servers

Request header

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

Request body

{
    "delete_on_termination": false,
    "server_id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f"
}

Example HTTP response

Response 202

{
    "delete_on_termination": false,
    "device": "/dev/vda",
    "server_id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

4.1.3.2 - 1.1

post /v1/volumes/{volume_id}/servers

Description

볼륨을 서버에 연결합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string	None
body	body required		VolumeServerAttachRequest

Responses

HTTP Code	Description	Schema
202	Accepted	VolumeServerAttachResponse
400	Bad Request	None
401	Unauthorized	None
409	Conflict	None

Example HTTP request

Request path

/v1/volumes/{volume_id}/servers

Request header

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

Request body

{
    "delete_on_termination": false,
    "server_id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f"
}

Example HTTP response

Response 202

{
    "delete_on_termination": false,
    "device": "/dev/vda",
    "server_id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

4.1.3.3 - 1.0

post /v1/volumes/{volume_id}/servers

Description

볼륨을 서버에 연결합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string	None
body	body required		VolumeServerAttachRequest

Responses

HTTP Code	Description	Schema
202	Accepted	VolumeServerAttachResponse
400	Bad Request	None
401	Unauthorized	None
409	Conflict	None

Example HTTP request

Request path

/v1/volumes/{volume_id}/servers

Request header

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

Request body

{
    "delete_on_termination": false,
    "server_id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f"
}

Example HTTP response

Response 202

{
    "delete_on_termination": false,
    "device": "/dev/vda",
    "server_id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

4.1.4 - Create a snapshot

4.1.4.1 - 1.2

post /v1/snapshots

Description

볼륨 스냅샷을 생성합니다. 이 스냅샷은 볼륨의 전체 복사본입니다. 생성된 스냅샷에서 볼륨을 생성할 수 있습니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
body	body required		SnapshotCreateRequest

Responses

HTTP Code	Description	Schema
202	Accepted	SnapshotDetailResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/snapshots

Request header

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

Request body

{
    "description": "description",
    "force": true,
    "metadata": "",
    "name": "snapshot-1",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

Example HTTP response

Response 202

{
    "created_at": "2025-07-22T09:00:00Z",
    "description": "description",
    "id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790",
    "metadata": "Metadata",
    "name": "snapshot-1",
    "size": 104,
    "status": "available",
    "updated_at": "2025-07-26T12:00:00Z",
    "user_id": "570907805e5447be84b618450ef52o0t",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

4.1.4.2 - 1.1

post /v1/snapshots

Description

볼륨 스냅샷을 생성합니다. 이 스냅샷은 볼륨의 전체 복사본입니다. 생성된 스냅샷에서 볼륨을 생성할 수 있습니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
body	body required		SnapshotCreateRequest

Responses

HTTP Code	Description	Schema
202	Accepted	SnapshotDetailResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/snapshots

Request header

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

Request body

{
    "description": "description",
    "force": true,
    "metadata": "",
    "name": "snapshot-1",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

Example HTTP response

Response 202

{
    "created_at": "2025-07-22T09:00:00Z",
    "description": "description",
    "id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790",
    "metadata": "Metadata",
    "name": "snapshot-1",
    "size": 104,
    "status": "available",
    "updated_at": "2025-07-26T12:00:00Z",
    "user_id": "570907805e5447be84b618450ef52o0t",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

4.1.4.3 - 1.0

post /v1/snapshots

Description

볼륨 스냅샷을 생성합니다. 이 스냅샷은 볼륨의 전체 복사본입니다. 생성된 스냅샷에서 볼륨을 생성할 수 있습니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		SnapshotCreateRequest

Responses

HTTP Code	Description	Schema
202	Accepted	SnapshotDetailResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/snapshots

Request header

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

Request body

{
    "description": "description",
    "force": true,
    "metadata": "",
    "name": "snapshot-1",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

Example HTTP response

Response 202

{
    "created_at": "2025-07-22T09:00:00Z",
    "description": "description",
    "id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790",
    "metadata": "Metadata",
    "name": "snapshot-1",
    "size": 104,
    "status": "available",
    "updated_at": "2025-07-26T12:00:00Z",
    "user_id": "570907805e5447be84b618450ef52o0t",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

4.1.5 - Create a volume transfer

4.1.5.1 - 1.2

post /v1/volume-transfer

Description

볼륨 이전을 신청합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
body	body required		VolumeTransferRequest

Responses

HTTP Code	Description	Schema
202	Accepted	VolumeTransferCreateResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/volume-transfer

Request header

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

Request body

{
    "name": "volume01",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

Example HTTP response

Response 202

{
    "auth_key": "f5972fdb456897eb",
    "created_at": "",
    "id": "1ac231be-823b-4a4d-8ff0-aac503a7118a",
    "name": "volume01",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

4.1.5.2 - 1.1

post /v1/volume-transfer

Description

볼륨 이전을 신청합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
body	body required		VolumeTransferRequest

Responses

HTTP Code	Description	Schema
202	Accepted	VolumeTransferCreateResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/volume-transfer

Request header

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

Request body

{
    "name": "volume01",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

Example HTTP response

Response 202

{
    "auth_key": "f5972fdb456897eb",
    "created_at": "",
    "id": "1ac231be-823b-4a4d-8ff0-aac503a7118a",
    "name": "volume01",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

4.1.5.3 - 1.0

post /v1/volume-transfer

Description

볼륨 이전을 신청합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		VolumeTransferRequest

Responses

HTTP Code	Description	Schema
202	Accepted	VolumeTransferCreateResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/volume-transfer

Request header

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

Request body

{
    "name": "volume01",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

Example HTTP response

Response 202

{
    "auth_key": "f5972fdb456897eb",
    "created_at": "",
    "id": "1ac231be-823b-4a4d-8ff0-aac503a7118a",
    "name": "volume01",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

4.1.6 - Create Auto-Scaling Group

4.1.6.1 - 1.2

post /v1/auto-scaling-groups

Description

Auto-Scaling Group을 생성합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
body	body required		AutoScalingGroupCreateRequestV1Dot2

Responses

HTTP Code	Description	Schema
201	Created	AutoScalingGroupShowResponseV1Dot2
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/auto-scaling-groups

Request header

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

Request body

{
    "desired_server_count": 1,
    "desired_server_count_editable": true,
    "drain_enabled": true,
    "drain_timeout": 300,
    "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
    "lb_server_groups": [],
    "max_server_count": 2,
    "min_server_count": 1,
    "name": "auto-scaling-group-name",
    "notifications": [],
    "scaling_policies": [],
    "security_group_ids": [
        "c09c3f05-03d9-443f-b27a-40e0f973c75f"
    ],
    "server_name_prefix": "server-name-prefix",
    "state_check_delay_time": 300,
    "subnet_ids": [
        ""
    ],
    "tags": [
        {
            "key": "key",
            "value": "value"
        }
    ],
    "use_lb_state_check": true
}

Example HTTP response

Response 201

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "desired_server_count": 1,
    "desired_server_count_editable": true,
    "drain_enabled": true,
    "drain_timeout": 300,
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
    "launch_configuration_name": "launch-configuration-name",
    "lb_server_groups": [],
    "max_server_count": 2,
    "min_server_count": 1,
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "auto-scaling-group-name",
    "security_group_ids": [
        "c09c3f05-03d9-443f-b27a-40e0f973c75f"
    ],
    "server_name_prefix": "server-name-prefix",
    "state": "IN_SERVICE",
    "state_check_delay_time": 300,
    "subnet_ids": [],
    "total_server_count": 1,
    "use_lb_state_check": true,
    "vpc_id": "cc976b621087484ea5fd527f4b78708b"
}

4.1.6.2 - 1.1

post /v1/auto-scaling-groups

Description

Auto-Scaling Group을 생성합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
body	body required		AutoScalingGroupCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	AutoScalingGroupShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/auto-scaling-groups

Request header

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

Request body

{
    "desired_server_count": 1,
    "desired_server_count_editable": true,
    "drain_enabled": true,
    "drain_timeout": 300,
    "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
    "lb_server_groups": [],
    "max_server_count": 2,
    "min_server_count": 1,
    "name": "auto-scaling-group-name",
    "notifications": [],
    "scaling_policies": [],
    "security_group_ids": [
        "c09c3f05-03d9-443f-b27a-40e0f973c75f"
    ],
    "server_name_prefix": "server-name-prefix",
    "subnet_ids": [
        ""
    ],
    "tags": [
        {
            "key": "key",
            "value": "value"
        }
    ]
}

Example HTTP response

Response 201

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "desired_server_count": 1,
    "desired_server_count_editable": true,
    "drain_enabled": true,
    "drain_timeout": 300,
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
    "launch_configuration_name": "launch-configuration-name",
    "lb_server_groups": [],
    "max_server_count": 2,
    "min_server_count": 1,
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "auto-scaling-group-name",
    "security_group_ids": [
        "c09c3f05-03d9-443f-b27a-40e0f973c75f"
    ],
    "server_name_prefix": "server-name-prefix",
    "state": "IN_SERVICE",
    "subnet_ids": [],
    "total_server_count": 1,
    "vpc_id": "cc976b621087484ea5fd527f4b78708b"
}

4.1.6.3 - 1.0

post /v1/auto-scaling-groups

Description

Auto-Scaling Group을 생성합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		AutoScalingGroupCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	AutoScalingGroupShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/auto-scaling-groups

Request header

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

Request body

{
    "desired_server_count": 1,
    "desired_server_count_editable": true,
    "drain_enabled": true,
    "drain_timeout": 300,
    "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
    "lb_server_groups": [],
    "max_server_count": 2,
    "min_server_count": 1,
    "name": "auto-scaling-group-name",
    "notifications": [],
    "scaling_policies": [],
    "security_group_ids": [
        "c09c3f05-03d9-443f-b27a-40e0f973c75f"
    ],
    "server_name_prefix": "server-name-prefix",
    "subnet_ids": [
        ""
    ],
    "tags": [
        {
            "key": "key",
            "value": "value"
        }
    ]
}

Example HTTP response

Response 201

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "desired_server_count": 1,
    "desired_server_count_editable": true,
    "drain_enabled": true,
    "drain_timeout": 300,
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
    "launch_configuration_name": "launch-configuration-name",
    "lb_server_groups": [],
    "max_server_count": 2,
    "min_server_count": 1,
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "auto-scaling-group-name",
    "security_group_ids": [
        "c09c3f05-03d9-443f-b27a-40e0f973c75f"
    ],
    "server_name_prefix": "server-name-prefix",
    "state": "IN_SERVICE",
    "subnet_ids": [],
    "total_server_count": 1,
    "vpc_id": "cc976b621087484ea5fd527f4b78708b"
}

4.1.7 - Create Auto-Scaling Group Notification

4.1.7.1 - 1.2

post /v1/auto-scaling-groups/{auto_scaling_group_id}/notifications

Description

Auto-Scaling Group 알림을 생성합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
body	body required		AutoScalingGroupNotificationCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	AutoScalingGroupNotificationListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/notifications

Request header

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

Request body

{
    "notification_events": [
        "SCALE_OUT",
        "SCALE_OUT_FAIL"
    ],
    "user_ids": [
        "570907805e5447be84b618450ef52o0t"
    ]
}

Example HTTP response

Response 201

{
    "count": 20,
    "notifications": [
        {
            "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
            "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "notification_events": [
                "SCALE_OUT",
                "SCALE_OUT_FAIL"
            ],
            "notification_state": "ACTIVE",
            "user_email": "scpuser@samsung.com",
            "user_id": "570907805e5447be84b618450ef52o0t",
            "user_name": "scpuser"
        }
    ]
}

4.1.7.2 - 1.1

post /v1/auto-scaling-groups/{auto_scaling_group_id}/notifications

Description

Auto-Scaling Group 알림을 생성합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
body	body required		AutoScalingGroupNotificationCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	AutoScalingGroupNotificationListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/notifications

Request header

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

Request body

{
    "notification_events": [
        "SCALE_OUT",
        "SCALE_OUT_FAIL"
    ],
    "user_ids": [
        "570907805e5447be84b618450ef52o0t"
    ]
}

Example HTTP response

Response 201

{
    "count": 20,
    "notifications": [
        {
            "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
            "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "notification_events": [
                "SCALE_OUT",
                "SCALE_OUT_FAIL"
            ],
            "notification_state": "ACTIVE",
            "user_email": "scpuser@samsung.com",
            "user_id": "570907805e5447be84b618450ef52o0t",
            "user_name": "scpuser"
        }
    ]
}

4.1.7.3 - 1.0

post /v1/auto-scaling-groups/{auto_scaling_group_id}/notifications

Description

Auto-Scaling Group 알림을 생성합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
body	body required		AutoScalingGroupNotificationCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	AutoScalingGroupNotificationListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/notifications

Request header

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

Request body

{
    "notification_events": [
        "SCALE_OUT",
        "SCALE_OUT_FAIL"
    ],
    "user_ids": [
        "570907805e5447be84b618450ef52o0t"
    ]
}

Example HTTP response

Response 201

{
    "count": 20,
    "notifications": [
        {
            "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
            "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "notification_events": [
                "SCALE_OUT",
                "SCALE_OUT_FAIL"
            ],
            "notification_state": "ACTIVE",
            "user_email": "scpuser@samsung.com",
            "user_id": "570907805e5447be84b618450ef52o0t",
            "user_name": "scpuser"
        }
    ]
}

4.1.8 - Create Auto-Scaling Group Policy

4.1.8.1 - 1.2

post /v1/auto-scaling-groups/{auto_scaling_group_id}/policies

Description

Auto-Scaling Group 정책을 생성합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
body	body required		AutoScalingGroupPolicyCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	AutoScalingGroupPolicyShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/policies

Request header

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

Request body

{
    "comparison_operator": "ge",
    "cooldown_seconds": 300,
    "evaluation_minutes": 5,
    "metric_method": "AVG",
    "metric_type": "CPU",
    "name": "policy-name",
    "scale_method": "AMOUNT",
    "scale_type": "SCALE_OUT",
    "scale_value": 10,
    "threshold": 60
}

Example HTTP response

Response 201

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
    "comparison_operator": "ge",
    "cooldown_seconds": 300,
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "evaluation_minutes": 5,
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "metric_method": "AVG",
    "metric_type": "CPU",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "policy-name",
    "scale_method": "AMOUNT",
    "scale_type": "SCALE_OUT",
    "scale_value": 10,
    "state": "ACTIVE",
    "threshold": 60,
    "threshold_unit": "%"
}

4.1.8.2 - 1.1

post /v1/auto-scaling-groups/{auto_scaling_group_id}/policies

Description

Auto-Scaling Group 정책을 생성합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
body	body required		AutoScalingGroupPolicyCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	AutoScalingGroupPolicyShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/policies

Request header

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

Request body

{
    "comparison_operator": "ge",
    "cooldown_seconds": 300,
    "evaluation_minutes": 5,
    "metric_method": "AVG",
    "metric_type": "CPU",
    "name": "policy-name",
    "scale_method": "AMOUNT",
    "scale_type": "SCALE_OUT",
    "scale_value": 10,
    "threshold": 60
}

Example HTTP response

Response 201

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
    "comparison_operator": "ge",
    "cooldown_seconds": 300,
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "evaluation_minutes": 5,
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "metric_method": "AVG",
    "metric_type": "CPU",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "policy-name",
    "scale_method": "AMOUNT",
    "scale_type": "SCALE_OUT",
    "scale_value": 10,
    "state": "ACTIVE",
    "threshold": 60,
    "threshold_unit": "%"
}

4.1.8.3 - 1.0

post /v1/auto-scaling-groups/{auto_scaling_group_id}/policies

Description

Auto-Scaling Group 정책을 생성합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
body	body required		AutoScalingGroupPolicyCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	AutoScalingGroupPolicyShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/policies

Request header

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

Request body

{
    "comparison_operator": "ge",
    "cooldown_seconds": 300,
    "evaluation_minutes": 5,
    "metric_method": "AVG",
    "metric_type": "CPU",
    "name": "policy-name",
    "scale_method": "AMOUNT",
    "scale_type": "SCALE_OUT",
    "scale_value": 10,
    "threshold": 60
}

Example HTTP response

Response 201

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
    "comparison_operator": "ge",
    "cooldown_seconds": 300,
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "evaluation_minutes": 5,
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "metric_method": "AVG",
    "metric_type": "CPU",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "policy-name",
    "scale_method": "AMOUNT",
    "scale_type": "SCALE_OUT",
    "scale_value": 10,
    "state": "ACTIVE",
    "threshold": 60,
    "threshold_unit": "%"
}

4.1.9 - Create Auto-Scaling Group Schedule

4.1.9.1 - 1.2

post /v1/auto-scaling-groups/{auto_scaling_group_id}/schedules

Description

Auto-Scaling Group 스케줄을 생성합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
body	body required		AutoScalingGroupScheduleCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	AutoScalingGroupScheduleShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_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 = virtualserver 1.2"

Request body

{
    "day_of_month": "-1,1",
    "day_of_week": "SU,SA",
    "description": "description",
    "desired_server_count": 1,
    "end_date": "2025-01-01",
    "frequency": "WEEKLY",
    "hour": 9,
    "max_server_count": 2,
    "min_server_count": 1,
    "minute": 0,
    "name": "schedulename",
    "start_date": "2024-01-01",
    "state": "ACTIVE",
    "timezone": "Asia/Seoul"
}

Example HTTP response

Response 201

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "day_of_month": "-1,1",
    "day_of_week": "SU,SA",
    "description": "description",
    "desired_server_count": 1,
    "end_date": "2025-01-01",
    "frequency": "WEEKLY",
    "hour": 9,
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "max_server_count": 2,
    "min_server_count": 1,
    "minute": 0,
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "schedulename",
    "start_date": "2024-01-01",
    "state": "ACTIVE",
    "timezone": "Asia/Seoul"
}

4.1.9.2 - 1.1

post /v1/auto-scaling-groups/{auto_scaling_group_id}/schedules

Description

Auto-Scaling Group 스케줄을 생성합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
body	body required		AutoScalingGroupScheduleCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	AutoScalingGroupScheduleShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_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 = virtualserver 1.1"

Request body

{
    "day_of_month": "-1,1",
    "day_of_week": "SU,SA",
    "description": "description",
    "desired_server_count": 1,
    "end_date": "2025-01-01",
    "frequency": "WEEKLY",
    "hour": 9,
    "max_server_count": 2,
    "min_server_count": 1,
    "minute": 0,
    "name": "schedulename",
    "start_date": "2024-01-01",
    "state": "ACTIVE",
    "timezone": "Asia/Seoul"
}

Example HTTP response

Response 201

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "day_of_month": "-1,1",
    "day_of_week": "SU,SA",
    "description": "description",
    "desired_server_count": 1,
    "end_date": "2025-01-01",
    "frequency": "WEEKLY",
    "hour": 9,
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "max_server_count": 2,
    "min_server_count": 1,
    "minute": 0,
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "schedulename",
    "start_date": "2024-01-01",
    "state": "ACTIVE",
    "timezone": "Asia/Seoul"
}

4.1.9.3 - 1.0

post /v1/auto-scaling-groups/{auto_scaling_group_id}/schedules

Description

Auto-Scaling Group 스케줄을 생성합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
body	body required		AutoScalingGroupScheduleCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	AutoScalingGroupScheduleShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_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 = virtualserver 1.0"

Request body

{
    "day_of_month": "-1,1",
    "day_of_week": "SU,SA",
    "description": "description",
    "desired_server_count": 1,
    "end_date": "2025-01-01",
    "frequency": "WEEKLY",
    "hour": 9,
    "max_server_count": 2,
    "min_server_count": 1,
    "minute": 0,
    "name": "schedulename",
    "start_date": "2024-01-01",
    "state": "ACTIVE",
    "timezone": "Asia/Seoul"
}

Example HTTP response

Response 201

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "day_of_month": "-1,1",
    "day_of_week": "SU,SA",
    "description": "description",
    "desired_server_count": 1,
    "end_date": "2025-01-01",
    "frequency": "WEEKLY",
    "hour": 9,
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "max_server_count": 2,
    "min_server_count": 1,
    "minute": 0,
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "schedulename",
    "start_date": "2024-01-01",
    "state": "ACTIVE",
    "timezone": "Asia/Seoul"
}

4.1.10 - Create Image

4.1.10.1 - 1.2

post /v1/images

Description

이미지를 생성합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
body	body required		ImageCreateRequest

Responses

HTTP Code	Description	Schema
200	OK	ImageShowResponseV1Dot2
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/images

Request header

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

Request body

{
    "container_format": "bare",
    "disk_format": "qcow2",
    "min_disk": 100,
    "min_ram": 0,
    "name": "imagename",
    "os_distro": "alma",
    "protected": false,
    "tags": [
        {
            "key": "key",
            "value": "value"
        }
    ],
    "url": "https://object-store.kr-west1.s.samsungsdscloud.com/8989447062e04a818baf9e073fd04fa7/bucket/object.qcow2",
    "visibility": "private"
}

Example HTTP response

Response 200

{
    "checksum": "7538e0fcb56e0e272cfd89eb384d6613",
    "container_format": "bare",
    "created_at": "2025-07-22T09:00:00Z",
    "disk_format": "qcow2",
    "file": "/v2/images/e08a37c1-2162-416e-b7fa-19902419170b/file",
    "id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "min_disk": 100,
    "min_ram": 0,
    "name": "imagename",
    "os_distro": "alma",
    "os_hash_algo": "sha512",
    "os_hash_value": "c6a32fc3b7c909b8900b46f5e6066c028a1d799c0a263cf064a600c430a714627c21f98ac248e2f2bf29870a1a2773c7908244745016878e1a5f31dc2c405b99",
    "os_hidden": false,
    "owner": "a8f10467abfc4b87b64614ab36eb9ae4",
    "owner_account_name": "AccountName",
    "owner_user_name": "user@samsung.com",
    "protected": false,
    "root_device_name": "/dev/vda",
    "scp_gpu_driver": "535.183.06",
    "scp_image_type": "custom",
    "scp_k8s_version": "v1.28.7",
    "scp_original_image_type": "standard",
    "scp_os_build_version": "20250101",
    "scp_os_version": "8.8",
    "size": 2429747200,
    "status": "active",
    "updated_at": "2025-07-26T12:00:00Z",
    "url": "https://object-store.kr-west1.s.samsungsdscloud.com/8989447062e04a818baf9e073fd04fa7/bucket/object.qcow2",
    "virtual_size": 17179869184,
    "visibility": "private",
    "volumes": "[{\"tag\": null, \"volume_id\": null, \"encryption_options\": null, \"encryption_secret_uuid\": null, \"encryption_format\": null, \"device_name\": \"/dev/vda\", \"disk_bus\": \"virtio\", \"volume_type\": null, \"encrypted\": null, \"image_id\": null, \"device_type\": \"disk\", \"source_type\": \"snapshot\", \"delete_on_termination\": false, \"volume_size\": 104, \"guest_format\": null, \"boot_index\": 0, \"destination_type\": \"volume\", \"snapshot_id\": \"abde9e38-2ed5-4ecd-b23c-b0120e30690e\", \"no_device\": null}]"
}

4.1.10.2 - 1.1

post /v1/images

Description

이미지를 생성합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
body	body required		ImageCreateRequest

Responses

HTTP Code	Description	Schema
200	OK	ImageShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/images

Request header

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

Request body

{
    "container_format": "bare",
    "disk_format": "qcow2",
    "min_disk": 100,
    "min_ram": 0,
    "name": "imagename",
    "os_distro": "alma",
    "protected": false,
    "tags": [
        {
            "key": "key",
            "value": "value"
        }
    ],
    "url": "https://object-store.kr-west1.s.samsungsdscloud.com/8989447062e04a818baf9e073fd04fa7/bucket/object.qcow2",
    "visibility": "private"
}

Example HTTP response

Response 200

{
    "checksum": "7538e0fcb56e0e272cfd89eb384d6613",
    "container_format": "bare",
    "created_at": "2025-07-22T09:00:00Z",
    "disk_format": "qcow2",
    "file": "/v2/images/e08a37c1-2162-416e-b7fa-19902419170b/file",
    "id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "min_disk": 100,
    "min_ram": 0,
    "name": "imagename",
    "os_distro": "alma",
    "os_hash_algo": "sha512",
    "os_hash_value": "c6a32fc3b7c909b8900b46f5e6066c028a1d799c0a263cf064a600c430a714627c21f98ac248e2f2bf29870a1a2773c7908244745016878e1a5f31dc2c405b99",
    "os_hidden": false,
    "owner": "a8f10467abfc4b87b64614ab36eb9ae4",
    "owner_account_name": "AccountName",
    "owner_user_name": "user@samsung.com",
    "protected": false,
    "root_device_name": "/dev/vda",
    "scp_image_type": "custom",
    "scp_k8s_version": "v1.28.7",
    "scp_original_image_type": "standard",
    "scp_os_build_version": "20250101",
    "scp_os_version": "8.8",
    "size": 2429747200,
    "status": "active",
    "updated_at": "2025-07-26T12:00:00Z",
    "url": "https://object-store.kr-west1.s.samsungsdscloud.com/8989447062e04a818baf9e073fd04fa7/bucket/object.qcow2",
    "virtual_size": 17179869184,
    "visibility": "private",
    "volumes": "[{\"tag\": null, \"volume_id\": null, \"encryption_options\": null, \"encryption_secret_uuid\": null, \"encryption_format\": null, \"device_name\": \"/dev/vda\", \"disk_bus\": \"virtio\", \"volume_type\": null, \"encrypted\": null, \"image_id\": null, \"device_type\": \"disk\", \"source_type\": \"snapshot\", \"delete_on_termination\": false, \"volume_size\": 104, \"guest_format\": null, \"boot_index\": 0, \"destination_type\": \"volume\", \"snapshot_id\": \"abde9e38-2ed5-4ecd-b23c-b0120e30690e\", \"no_device\": null}]"
}

4.1.10.3 - 1.0

post /v1/images

Description

이미지를 생성합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		ImageCreateRequest

Responses

HTTP Code	Description	Schema
200	OK	ImageShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/images

Request header

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

Request body

{
    "container_format": "bare",
    "disk_format": "qcow2",
    "min_disk": 100,
    "min_ram": 0,
    "name": "imagename",
    "os_distro": "alma",
    "protected": false,
    "tags": [
        {
            "key": "key",
            "value": "value"
        }
    ],
    "url": "https://object-store.kr-west1.s.samsungsdscloud.com/8989447062e04a818baf9e073fd04fa7/bucket/object.qcow2",
    "visibility": "private"
}

Example HTTP response

Response 200

{
    "checksum": "7538e0fcb56e0e272cfd89eb384d6613",
    "container_format": "bare",
    "created_at": "2025-07-22T09:00:00Z",
    "disk_format": "qcow2",
    "file": "/v2/images/e08a37c1-2162-416e-b7fa-19902419170b/file",
    "id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "min_disk": 100,
    "min_ram": 0,
    "name": "imagename",
    "os_distro": "alma",
    "os_hash_algo": "sha512",
    "os_hash_value": "c6a32fc3b7c909b8900b46f5e6066c028a1d799c0a263cf064a600c430a714627c21f98ac248e2f2bf29870a1a2773c7908244745016878e1a5f31dc2c405b99",
    "os_hidden": false,
    "owner": "a8f10467abfc4b87b64614ab36eb9ae4",
    "owner_account_name": "AccountName",
    "owner_user_name": "user@samsung.com",
    "protected": false,
    "root_device_name": "/dev/vda",
    "scp_image_type": "custom",
    "scp_k8s_version": "v1.28.7",
    "scp_original_image_type": "standard",
    "scp_os_build_version": "20250101",
    "scp_os_version": "8.8",
    "size": 2429747200,
    "status": "active",
    "updated_at": "2025-07-26T12:00:00Z",
    "url": "https://object-store.kr-west1.s.samsungsdscloud.com/8989447062e04a818baf9e073fd04fa7/bucket/object.qcow2",
    "virtual_size": 17179869184,
    "visibility": "private",
    "volumes": "[{\"tag\": null, \"volume_id\": null, \"encryption_options\": null, \"encryption_secret_uuid\": null, \"encryption_format\": null, \"device_name\": \"/dev/vda\", \"disk_bus\": \"virtio\", \"volume_type\": null, \"encrypted\": null, \"image_id\": null, \"device_type\": \"disk\", \"source_type\": \"snapshot\", \"delete_on_termination\": false, \"volume_size\": 104, \"guest_format\": null, \"boot_index\": 0, \"destination_type\": \"volume\", \"snapshot_id\": \"abde9e38-2ed5-4ecd-b23c-b0120e30690e\", \"no_device\": null}]"
}

4.1.11 - Create Image member

4.1.11.1 - 1.2

post /v1/images/{image_id}/members

Description

Account ID를 공유 이미지 멤버로 추가합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string	None
body	body required		ImageMemberCreateRequest

Responses

HTTP Code	Description	Schema
200	OK	ImageMemberShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/images/{image_id}/members

Request header

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

Request body

{
    "member_id": "a8f10467abfc4b87b64614ab36eb9ae4"
}

Example HTTP response

Response 200

{
    "created_at": "2025-07-22T09:00:00Z",
    "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "member_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "status": "pending",
    "updated_at": "2025-07-26T12:00:00Z"
}

4.1.11.2 - 1.1

post /v1/images/{image_id}/members

Description

Account ID를 공유 이미지 멤버로 추가합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string	None
body	body required		ImageMemberCreateRequest

Responses

HTTP Code	Description	Schema
200	OK	ImageMemberShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/images/{image_id}/members

Request header

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

Request body

{
    "member_id": "a8f10467abfc4b87b64614ab36eb9ae4"
}

Example HTTP response

Response 200

{
    "created_at": "2025-07-22T09:00:00Z",
    "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "member_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "status": "pending",
    "updated_at": "2025-07-26T12:00:00Z"
}

4.1.11.3 - 1.0

post /v1/images/{image_id}/members

Description

Account ID를 공유 이미지 멤버로 추가합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string	None
body	body required		ImageMemberCreateRequest

Responses

HTTP Code	Description	Schema
200	OK	ImageMemberShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/images/{image_id}/members

Request header

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

Request body

{
    "member_id": "a8f10467abfc4b87b64614ab36eb9ae4"
}

Example HTTP response

Response 200

{
    "created_at": "2025-07-22T09:00:00Z",
    "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "member_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "status": "pending",
    "updated_at": "2025-07-26T12:00:00Z"
}

4.1.12 - Create Keypair

4.1.12.1 - 1.2

post /v1/keypairs

Description

새 키페어를 만들거나 공개 키를 가져옵니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
body	body required		KeypairCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	KeypairCreateResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
409	Conflict	None

Example HTTP request

Request path

/v1/keypairs

Request header

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

Request body

{
    "name": "keypairname",
    "public_key": "ssh-rsa fakeKey Generated-by-SCP",
    "tags": [
        {
            "key": "key",
            "value": "value"
        }
    ]
}

Example HTTP response

Response 201

{
    "fingerprint": "7e:eb:ab:24:ba:d1:e1:88:ae:9a:fb:66:53:df:d3:bd",
    "name": "keypairname",
    "private_key": "-----BEGIN RSA PRIVATE KEY-----\nfakeKey\n-----END RSA PRIVATE KEY-----",
    "public_key": "ssh-rsa fakeKey Generated-by-SCP",
    "type": "ssh"
}

4.1.12.2 - 1.1

post /v1/keypairs

Description

새 키페어를 만들거나 공개 키를 가져옵니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
body	body required		KeypairCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	KeypairCreateResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
409	Conflict	None

Example HTTP request

Request path

/v1/keypairs

Request header

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

Request body

{
    "name": "keypairname",
    "public_key": "ssh-rsa fakeKey Generated-by-SCP",
    "tags": [
        {
            "key": "key",
            "value": "value"
        }
    ]
}

Example HTTP response

Response 201

{
    "fingerprint": "7e:eb:ab:24:ba:d1:e1:88:ae:9a:fb:66:53:df:d3:bd",
    "name": "keypairname",
    "private_key": "-----BEGIN RSA PRIVATE KEY-----\nfakeKey\n-----END RSA PRIVATE KEY-----",
    "public_key": "ssh-rsa fakeKey Generated-by-SCP",
    "type": "ssh"
}

4.1.12.3 - 1.0

post /v1/keypairs

Description

새 키페어를 만들거나 공개 키를 가져옵니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		KeypairCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	KeypairCreateResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
409	Conflict	None

Example HTTP request

Request path

/v1/keypairs

Request header

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

Request body

{
    "name": "keypairname",
    "public_key": "ssh-rsa fakeKey Generated-by-SCP",
    "tags": [
        {
            "key": "key",
            "value": "value"
        }
    ]
}

Example HTTP response

Response 201

{
    "fingerprint": "7e:eb:ab:24:ba:d1:e1:88:ae:9a:fb:66:53:df:d3:bd",
    "name": "keypairname",
    "private_key": "-----BEGIN RSA PRIVATE KEY-----\nfakeKey\n-----END RSA PRIVATE KEY-----",
    "public_key": "ssh-rsa fakeKey Generated-by-SCP",
    "type": "ssh"
}

4.1.13 - Create Launch Configuration

4.1.13.1 - 1.2

post /v1/launch-configurations

Description

Launch Configuration을 생성합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
body	body required		LaunchConfigurationCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	LaunchConfigurationDetailShowResponseV1Dot2
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/launch-configurations

Request header

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

Request body

{
    "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "keypair_name": "keypairname",
    "name": "launch-configuration-name",
    "server_type_id": "s1v1m2",
    "tags": [
        {
            "key": "key",
            "value": "value"
        }
    ],
    "user_data": "IyEvYmluL2Jhc2gKL2Jpbi9zdQplY2hvICJJIGFtIGluIHlvdSEiCg==",
    "volumes": [
        {
            "boot_index": 0,
            "size": 104,
            "type": "SSD"
        }
    ]
}

Example HTTP response

Response 201

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "auto_scaling_group_count": 1,
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "file_storage_ids": [
        ""
    ],
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "image_name": "imagename",
    "keypair_name": "keypairname",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "launch-configuration-name",
    "public_key": "ssh-rsa fakeKey Generated-by-SCP",
    "server_type_id": "s1v1m2",
    "state": "ACTIVE",
    "user_data": "IyEvYmluL2Jhc2gKL2Jpbi9zdQplY2hvICJJIGFtIGluIHlvdSEiCg==",
    "volumes": [
        {
            "boot_index": 0,
            "max_iops": 10000,
            "max_throughput": 500,
            "size": 104,
            "type": "SSD"
        }
    ]
}

4.1.13.2 - 1.1

post /v1/launch-configurations

Description

Launch Configuration을 생성합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
body	body required		LaunchConfigurationCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	LaunchConfigurationDetailShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/launch-configurations

Request header

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

Request body

{
    "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "keypair_name": "keypairname",
    "name": "launch-configuration-name",
    "server_type_id": "s1v1m2",
    "tags": [
        {
            "key": "key",
            "value": "value"
        }
    ],
    "user_data": "IyEvYmluL2Jhc2gKL2Jpbi9zdQplY2hvICJJIGFtIGluIHlvdSEiCg==",
    "volumes": [
        {
            "boot_index": 0,
            "size": 104,
            "type": "SSD"
        }
    ]
}

Example HTTP response

Response 201

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "auto_scaling_group_count": 1,
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "image_name": "imagename",
    "keypair_name": "keypairname",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "launch-configuration-name",
    "public_key": "ssh-rsa fakeKey Generated-by-SCP",
    "server_type_id": "s1v1m2",
    "state": "ACTIVE",
    "user_data": "IyEvYmluL2Jhc2gKL2Jpbi9zdQplY2hvICJJIGFtIGluIHlvdSEiCg==",
    "volumes": [
        {
            "boot_index": 0,
            "size": 104,
            "type": "SSD"
        }
    ]
}

4.1.13.3 - 1.0

post /v1/launch-configurations

Description

Launch Configuration을 생성합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		LaunchConfigurationCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	LaunchConfigurationDetailShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/launch-configurations

Request header

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

Request body

{
    "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "keypair_name": "keypairname",
    "name": "launch-configuration-name",
    "server_type_id": "s1v1m2",
    "tags": [
        {
            "key": "key",
            "value": "value"
        }
    ],
    "user_data": "IyEvYmluL2Jhc2gKL2Jpbi9zdQplY2hvICJJIGFtIGluIHlvdSEiCg==",
    "volumes": [
        {
            "boot_index": 0,
            "size": 104,
            "type": "SSD"
        }
    ]
}

Example HTTP response

Response 201

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "auto_scaling_group_count": 1,
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "image_name": "imagename",
    "keypair_name": "keypairname",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "launch-configuration-name",
    "public_key": "ssh-rsa fakeKey Generated-by-SCP",
    "server_type_id": "s1v1m2",
    "state": "ACTIVE",
    "user_data": "IyEvYmluL2Jhc2gKL2Jpbi9zdQplY2hvICJJIGFtIGluIHlvdSEiCg==",
    "volumes": [
        {
            "boot_index": 0,
            "size": 104,
            "type": "SSD"
        }
    ]
}

4.1.14 - Create Server Group

4.1.14.1 - 1.2

post /v1/server-groups

Description

서버 그룹을 생성합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
body	body required		ServerGroupCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	ServerGroup
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
409	Conflict	None

Example HTTP request

Request path

/v1/server-groups

Request header

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

Request body

{
    "name": "server-group",
    "policy": "anti-affinity",
    "tags": [
        {
            "key": "key",
            "value": "value"
        }
    ]
}

Example HTTP response

Response 201

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
    "members": [
        "2a9be312-5d4b-4bc8-b2ae-35100fa9241f"
    ],
    "name": "server-group",
    "partition_size": 3,
    "policy": "anti-affinity",
    "user_id": "570907805e5447be84b618450ef52o0t"
}

4.1.14.2 - 1.1

post /v1/server-groups

Description

서버 그룹을 생성합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
body	body required		ServerGroupCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	ServerGroup
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
409	Conflict	None

Example HTTP request

Request path

/v1/server-groups

Request header

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

Request body

{
    "name": "server-group",
    "policy": "anti-affinity",
    "tags": [
        {
            "key": "key",
            "value": "value"
        }
    ]
}

Example HTTP response

Response 201

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
    "members": [
        "2a9be312-5d4b-4bc8-b2ae-35100fa9241f"
    ],
    "name": "server-group",
    "partition_size": 3,
    "policy": "anti-affinity",
    "user_id": "570907805e5447be84b618450ef52o0t"
}

4.1.14.3 - 1.0

post /v1/server-groups

Description

서버 그룹을 생성합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		ServerGroupCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	ServerGroup
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
409	Conflict	None

Example HTTP request

Request path

/v1/server-groups

Request header

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

Request body

{
    "name": "server-group",
    "policy": "anti-affinity",
    "tags": [
        {
            "key": "key",
            "value": "value"
        }
    ]
}

Example HTTP response

Response 201

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
    "members": [
        "2a9be312-5d4b-4bc8-b2ae-35100fa9241f"
    ],
    "name": "server-group",
    "partition_size": 3,
    "policy": "anti-affinity",
    "user_id": "570907805e5447be84b618450ef52o0t"
}

4.1.15 - Create Server Interface

4.1.15.1 - 1.2

post /v1/servers/{server_id}/interfaces

Description

서버에 새 네트워크 포트를 생성하거나 기존 네트워크 포트를 추가합니다. 새 네트워크 포트를 생성할 때 서브넷 ID를 입력해주세요. IP는 자동 생성 또는 사용자 입력 고정 IP로 설정할 수 있습니다. 기존 네트워크 포트를 추가하려면 포트 ID를 입력해주세요.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
body	body required		ServerInterfaceCreateRequest

Responses

HTTP Code	Description	Schema
200	OK	InterfaceResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/servers/{server_id}/interfaces

Request header

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

Request body

{
    "fixed_ips": [
        {
            "ip_address": "192.169.3.2"
        }
    ],
    "port_id": "91424c08-0b26-49fb-9808-ed042292ceef",
    "subnet_id": "78b2ee3f074145c580ab6abac4821f97"
}

Example HTTP response

Response 200

{
    "fixed_ips": [
        {
            "ip_address": "192.169.3.2"
        }
    ],
    "mac_addr": "fa:16:3e:c0:71:2b",
    "port_id": "f2b02fc5-a5fd-4b5f-b1a9-987f4c0d66cc",
    "port_state": "ACTIVE",
    "private_static_nat": {
        "external_ip_address": "182.197.61.81",
        "id": "224b80106e6f41b38efe98ac9ddbf280",
        "private_nat_ip_id": "1f0cb5390c40483592ddc5a282f53496",
        "state": "ACTIVE"
    },
    "static_nat": {
        "external_ip_address": "182.197.61.81",
        "id": "224b80106e6f41b38efe98ac9ddbf280",
        "publicip_id": "615fa9cd5cff486c9de679b3ce63e601",
        "state": "ACTIVE"
    },
    "subnet_id": "183c6c30df0c4fcbb16422aa2d64aa21"
}

4.1.15.2 - 1.1

post /v1/servers/{server_id}/interfaces

Description

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
body	body required		ServerInterfaceCreateRequest

Responses

HTTP Code	Description	Schema
200	OK	InterfaceResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/servers/{server_id}/interfaces

Request header

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

Request body

{
    "fixed_ips": [
        {
            "ip_address": "192.169.3.2"
        }
    ],
    "port_id": "91424c08-0b26-49fb-9808-ed042292ceef",
    "subnet_id": "78b2ee3f074145c580ab6abac4821f97"
}

Example HTTP response

Response 200

{
    "fixed_ips": [
        {
            "ip_address": "192.169.3.2"
        }
    ],
    "mac_addr": "fa:16:3e:c0:71:2b",
    "port_id": "f2b02fc5-a5fd-4b5f-b1a9-987f4c0d66cc",
    "port_state": "ACTIVE",
    "private_static_nat": {
        "external_ip_address": "182.197.61.81",
        "id": "224b80106e6f41b38efe98ac9ddbf280",
        "private_nat_ip_id": "1f0cb5390c40483592ddc5a282f53496",
        "state": "ACTIVE"
    },
    "static_nat": {
        "external_ip_address": "182.197.61.81",
        "id": "224b80106e6f41b38efe98ac9ddbf280",
        "publicip_id": "615fa9cd5cff486c9de679b3ce63e601",
        "state": "ACTIVE"
    },
    "subnet_id": "183c6c30df0c4fcbb16422aa2d64aa21"
}

4.1.15.3 - 1.0

post /v1/servers/{server_id}/interfaces

Description

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
body	body required		ServerInterfaceCreateRequest

Responses

HTTP Code	Description	Schema
200	OK	InterfaceResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/servers/{server_id}/interfaces

Request header

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

Request body

{
    "fixed_ips": [
        {
            "ip_address": "192.169.3.2"
        }
    ],
    "port_id": "91424c08-0b26-49fb-9808-ed042292ceef",
    "subnet_id": "78b2ee3f074145c580ab6abac4821f97"
}

Example HTTP response

Response 200

{
    "fixed_ips": [
        {
            "ip_address": "192.169.3.2"
        }
    ],
    "mac_addr": "fa:16:3e:c0:71:2b",
    "port_id": "f2b02fc5-a5fd-4b5f-b1a9-987f4c0d66cc",
    "port_state": "ACTIVE",
    "private_static_nat": {
        "external_ip_address": "182.197.61.81",
        "id": "224b80106e6f41b38efe98ac9ddbf280",
        "private_nat_ip_id": "1f0cb5390c40483592ddc5a282f53496",
        "state": "ACTIVE"
    },
    "static_nat": {
        "external_ip_address": "182.197.61.81",
        "id": "224b80106e6f41b38efe98ac9ddbf280",
        "publicip_id": "615fa9cd5cff486c9de679b3ce63e601",
        "state": "ACTIVE"
    },
    "subnet_id": "183c6c30df0c4fcbb16422aa2d64aa21"
}

4.1.16 - Create Server Interface Nat

4.1.16.1 - 1.2

post /v1/servers/{server_id}/interfaces/{port_id}/static-nats

Description

Create Server Interface Public Nat.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	port_id required	포트 ID Example : `91424c08-0b26-49fb-9808-ed042292ceef`	string	None
body	body required		ServerStaticNatCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/servers/{server_id}/interfaces/{port_id}/static-nats

Request header

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

Request body

{
    "publicip_id": "615fa9cd5cff486c9de679b3ce63e601"
}

Example HTTP response

Response 201

4.1.16.2 - 1.1

post /v1/servers/{server_id}/interfaces/{port_id}/static-nats

Description

Create Server Interface Public Nat.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	port_id required	포트 ID Example : `91424c08-0b26-49fb-9808-ed042292ceef`	string	None
body	body required		ServerStaticNatCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/servers/{server_id}/interfaces/{port_id}/static-nats

Request header

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

Request body

{
    "publicip_id": "615fa9cd5cff486c9de679b3ce63e601"
}

Example HTTP response

Response 201

4.1.16.3 - 1.0

post /v1/servers/{server_id}/interfaces/{port_id}/static-nats

Description

Create Server Interface Public Nat.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	port_id required	포트 ID Example : `91424c08-0b26-49fb-9808-ed042292ceef`	string	None
body	body required		ServerStaticNatCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/servers/{server_id}/interfaces/{port_id}/static-nats

Request header

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

Request body

{
    "publicip_id": "615fa9cd5cff486c9de679b3ce63e601"
}

Example HTTP response

Response 201

4.1.17 - Create Server Interface Private Nat

4.1.17.1 - 1.2

post /v1/servers/{server_id}/interfaces/{port_id}/private-static-nats

Description

Create Server Interface Private Nat.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	port_id required	포트 ID Example : `91424c08-0b26-49fb-9808-ed042292ceef`	string	None
body	body required		ServerPrivateStaticNatCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/servers/{server_id}/interfaces/{port_id}/private-static-nats

Request header

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

Request body

{
    "private_nat_id": "3a6c1dc6b1b24e02a444d672c2798a1c",
    "private_nat_ip_id": "1f0cb5390c40483592ddc5a282f53496"
}

Example HTTP response

Response 201

4.1.17.2 - 1.1

post /v1/servers/{server_id}/interfaces/{port_id}/private-static-nats

Description

Create Server Interface Private Nat.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	port_id required	포트 ID Example : `91424c08-0b26-49fb-9808-ed042292ceef`	string	None
body	body required		ServerPrivateStaticNatCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/servers/{server_id}/interfaces/{port_id}/private-static-nats

Request header

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

Request body

{
    "private_nat_id": "3a6c1dc6b1b24e02a444d672c2798a1c",
    "private_nat_ip_id": "1f0cb5390c40483592ddc5a282f53496"
}

Example HTTP response

Response 201

4.1.17.3 - 1.0

post /v1/servers/{server_id}/interfaces/{port_id}/private-static-nats

Description

Create Server Interface Private Nat.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	port_id required	포트 ID Example : `91424c08-0b26-49fb-9808-ed042292ceef`	string	None
body	body required		ServerPrivateStaticNatCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/servers/{server_id}/interfaces/{port_id}/private-static-nats

Request header

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

Request body

{
    "private_nat_id": "3a6c1dc6b1b24e02a444d672c2798a1c",
    "private_nat_ip_id": "1f0cb5390c40483592ddc5a282f53496"
}

Example HTTP response

Response 201

4.1.18 - Create Server Volume

4.1.18.1 - 1.2

post /v1/servers/{server_id}/volumes

Description

생성된 볼륨을 서버에 연결합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
body	body required		ServerVolumesCreateRequest

Responses

HTTP Code	Description	Schema
200	OK	ServersVolumeResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/servers/{server_id}/volumes

Request header

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

Request body

{
    "delete_on_termination": false,
    "device": "/dev/vda",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

Example HTTP response

Response 200

{
    "delete_on_termination": false,
    "device": "/dev/vda",
    "id": "3ad1cc18-1b09-4f51-9b1d-4ce4243f6a4c",
    "server_id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

4.1.18.2 - 1.1

post /v1/servers/{server_id}/volumes

Description

생성된 볼륨을 서버에 연결합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
body	body required		ServerVolumesCreateRequest

Responses

HTTP Code	Description	Schema
200	OK	ServersVolumeResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/servers/{server_id}/volumes

Request header

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

Request body

{
    "delete_on_termination": false,
    "device": "/dev/vda",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

Example HTTP response

Response 200

{
    "delete_on_termination": false,
    "device": "/dev/vda",
    "id": "3ad1cc18-1b09-4f51-9b1d-4ce4243f6a4c",
    "server_id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

4.1.18.3 - 1.0

post /v1/servers/{server_id}/volumes

Description

생성된 볼륨을 서버에 연결합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
body	body required		ServerVolumesCreateRequest

Responses

HTTP Code	Description	Schema
200	OK	ServersVolumeResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/servers/{server_id}/volumes

Request header

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

Request body

{
    "delete_on_termination": false,
    "device": "/dev/vda",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

Example HTTP response

Response 200

{
    "delete_on_termination": false,
    "device": "/dev/vda",
    "id": "3ad1cc18-1b09-4f51-9b1d-4ce4243f6a4c",
    "server_id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

4.1.19 - Create Sharing Image

4.1.19.1 - 1.2

post /v1/images/{image_id}/share

Description

공유용 이미지를 생성합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string	None

Responses

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

Example HTTP request

Request path

/v1/images/{image_id}/share

Request header

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

Example HTTP response

Response 202

4.1.19.2 - 1.1

post /v1/images/{image_id}/share

Description

공유용 이미지를 생성합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string	None

Responses

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

Example HTTP request

Request path

/v1/images/{image_id}/share

Request header

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

Example HTTP response

Response 202

4.1.19.3 - 1.0

post /v1/images/{image_id}/share

Description

공유용 이미지를 생성합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string	None

Responses

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

Example HTTP request

Request path

/v1/images/{image_id}/share

Request header

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

Example HTTP response

Response 202

4.1.20 - Create Virtual Server

4.1.20.1 - 1.2

post /v1/servers

Description

서버를 생성합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
body	body required		ServerCreateRequestV1Dot2

Responses

HTTP Code	Description	Schema
202	Accepted	ServerCreateResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/servers

Request header

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

Request body

{
    "file_storage_ids": [
        "96d258ea-dd5d-4cca-bb3a-b6909b7e2065",
        "949bd9c7-2098-4284-9685-13268d193117"
    ],
    "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "keypair_name": "keypairname",
    "lock": false,
    "max_count": 2,
    "metadata": "",
    "name": "servername",
    "networks": [
        {
            "fixed_ip": "192.169.3.2",
            "port_id": "91424c08-0b26-49fb-9808-ed042292ceef",
            "public_ip_id": "615fa9cd5cff486c9de679b3ce63e601",
            "subnet_id": "78b2ee3f074145c580ab6abac4821f97"
        }
    ],
    "partition_number": 1,
    "product_category": "compute",
    "product_offering": "virtual_server",
    "security_groups": [
        "c09c3f05-03d9-443f-b27a-40e0f973c75f"
    ],
    "server_group_id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
    "server_type_id": "s1v1m2",
    "tags": [
        {
            "key": "key",
            "value": "value"
        }
    ],
    "user_data": "IyEvYmluL2Jhc2gKL2Jpbi9zdQplY2hvICJJIGFtIGluIHlvdSEiCg==",
    "volumes": [
        {
            "boot_index": 0,
            "delete_on_termination": false,
            "max_iops": 10000,
            "max_throughput": 500,
            "size": 104,
            "source_type": "image",
            "type": "SSD"
        }
    ]
}

Example HTTP response

Response 202

{
    "servers": [
        {
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f"
        }
    ]
}

4.1.20.2 - 1.1

post /v1/servers

Description

서버를 생성합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
body	body required		ServerCreateRequest

Responses

HTTP Code	Description	Schema
202	Accepted	ServerCreateResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/servers

Request header

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

Request body

{
    "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "keypair_name": "keypairname",
    "lock": false,
    "max_count": 2,
    "metadata": "",
    "name": "servername",
    "networks": [
        {
            "fixed_ip": "192.169.3.2",
            "port_id": "91424c08-0b26-49fb-9808-ed042292ceef",
            "public_ip_id": "615fa9cd5cff486c9de679b3ce63e601",
            "subnet_id": "78b2ee3f074145c580ab6abac4821f97"
        }
    ],
    "partition_number": 1,
    "product_category": "compute",
    "product_offering": "virtual_server",
    "security_groups": [
        "c09c3f05-03d9-443f-b27a-40e0f973c75f"
    ],
    "server_group_id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
    "server_type_id": "s1v1m2",
    "tags": [
        {
            "key": "key",
            "value": "value"
        }
    ],
    "user_data": "IyEvYmluL2Jhc2gKL2Jpbi9zdQplY2hvICJJIGFtIGluIHlvdSEiCg==",
    "volumes": []
}

Example HTTP response

Response 202

{
    "servers": [
        {
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f"
        }
    ]
}

4.1.20.3 - 1.0

post /v1/servers

Description

서버를 생성합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		ServerCreateRequest

Responses

HTTP Code	Description	Schema
202	Accepted	ServerCreateResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/servers

Request header

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

Request body

{
    "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "keypair_name": "keypairname",
    "lock": false,
    "max_count": 2,
    "metadata": "",
    "name": "servername",
    "networks": [
        {
            "fixed_ip": "192.169.3.2",
            "port_id": "91424c08-0b26-49fb-9808-ed042292ceef",
            "public_ip_id": "615fa9cd5cff486c9de679b3ce63e601",
            "subnet_id": "78b2ee3f074145c580ab6abac4821f97"
        }
    ],
    "partition_number": 1,
    "product_category": "compute",
    "product_offering": "virtual_server",
    "security_groups": [
        "c09c3f05-03d9-443f-b27a-40e0f973c75f"
    ],
    "server_group_id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
    "server_type_id": "s1v1m2",
    "tags": [
        {
            "key": "key",
            "value": "value"
        }
    ],
    "user_data": "IyEvYmluL2Jhc2gKL2Jpbi9zdQplY2hvICJJIGFtIGluIHlvdSEiCg==",
    "volumes": []
}

Example HTTP response

Response 202

{
    "servers": [
        {
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f"
        }
    ]
}

4.1.21 - Create Virtual Server Custom Image

4.1.21.1 - 1.2

post /v1/servers/{server_id}/images

Description

서버 커스텀 이미지를 생성합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
body	body required		ServerCreateImageRequestBody

Responses

HTTP Code	Description	Schema
202	Accepted	ServerCreateImageResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/servers/{server_id}/images

Request header

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

Request body

{
    "image_name": "imagename"
}

Example HTTP response

Response 202

{
    "image_id": "70a599e0-31e7-49b7-b260-868f441e862b"
}

4.1.21.2 - 1.1

post /v1/servers/{server_id}/images

Description

서버 커스텀 이미지를 생성합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
body	body required		ServerCreateImageRequestBody

Responses

HTTP Code	Description	Schema
202	Accepted	ServerCreateImageResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/servers/{server_id}/images

Request header

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

Request body

{
    "image_name": "imagename"
}

Example HTTP response

Response 202

{
    "image_id": "70a599e0-31e7-49b7-b260-868f441e862b"
}

4.1.21.3 - 1.0

post /v1/servers/{server_id}/images

Description

서버 커스텀 이미지를 생성합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
body	body required		ServerCreateImageRequestBody

Responses

HTTP Code	Description	Schema
202	Accepted	ServerCreateImageResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/servers/{server_id}/images

Request header

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

Request body

{
    "image_name": "imagename"
}

Example HTTP response

Response 202

{
    "image_id": "70a599e0-31e7-49b7-b260-868f441e862b"
}

4.1.22 - Create Virtual Server Dump

4.1.22.1 - 1.2

post /v1/servers/{server_id}/dump

Description

서버 Dump를 생성합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/dump

Request header

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

Example HTTP response

Response 202

4.1.22.2 - 1.1

post /v1/servers/{server_id}/dump

Description

서버 Dump를 생성합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/dump

Request header

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

Example HTTP response

Response 202

4.1.22.3 - 1.0

post /v1/servers/{server_id}/dump

Description

서버 Dump를 생성합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/dump

Request header

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

Example HTTP response

Response 202

4.1.23 - Create Volume

4.1.23.1 - 1.2

post /v1/volumes

Description

볼륨을 생성합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
body	body required		VolumeCreateRequestV1Dot2

Responses

HTTP Code	Description	Schema
202	Accepted	VolumeShowResponseV1Dot2
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/volumes

Request header

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

Request body

{
    "max_iops": 10000,
    "max_throughput": 500,
    "name": "volume01",
    "size": 104,
    "snapshot_id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790",
    "tags": [
        {
            "key": "key",
            "value": "value"
        }
    ],
    "volume_type": "SSD"
}

Example HTTP response

Response 202

{
    "bootable": false,
    "created_at": "2026-04-14T15:06:31.797Z",
    "encrypted": true,
    "id": "3f500f00-ed80-4566-a057-e31760226f9a",
    "max_iops": 10000,
    "max_throughput": 500,
    "modified_at": "2025-07-26T12:00:00Z",
    "multiattach": false,
    "name": "volume01",
    "servers": [
        {
            "attached_at": "2026-04-14T15:06:30.712Z",
            "device": "/dev/vda",
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f"
        }
    ],
    "size": 104,
    "snapshot_id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790",
    "state": "available",
    "user_id": "570907805e5447be84b618450ef52o0t",
    "volume_image_metadata": {
        "checksum": "7538e0fcb56e0e272cfd89eb384d6613",
        "container_format": "bare",
        "disk_format": "qcow2",
        "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
        "image_name": "imagename",
        "min_disk": 100,
        "min_ram": 0,
        "os_distro": "alma",
        "scp_image_type": "custom",
        "scp_k8s_version": "v1.28.7",
        "scp_original_image_type": "standard",
        "signature_verified": false,
        "size": 2429747200
    },
    "volume_type": "SSD",
    "volume_type_id": "c643ac35-3aec-43e6-b97a-3d6f666c5207"
}

4.1.23.2 - 1.1

post /v1/volumes

Description

볼륨을 생성합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
body	body required		VolumeCreateRequest

Responses

HTTP Code	Description	Schema
202	Accepted	VolumeShowResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/volumes

Request header

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

Request body

{
    "name": "volume01",
    "size": 104,
    "snapshot_id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790",
    "tags": [
        {
            "key": "key",
            "value": "value"
        }
    ],
    "volume_type": "SSD"
}

Example HTTP response

Response 202

{
    "bootable": false,
    "created_at": "2026-04-14T15:06:30.677Z",
    "encrypted": true,
    "id": "3f500f00-ed80-4566-a057-e31760226f9a",
    "modified_at": "2025-07-26T12:00:00Z",
    "multiattach": false,
    "name": "volume01",
    "servers": [
        {
            "attached_at": "2026-04-14T15:06:30.712Z",
            "device": "/dev/vda",
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f"
        }
    ],
    "size": 104,
    "snapshot_id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790",
    "state": "available",
    "user_id": "570907805e5447be84b618450ef52o0t",
    "volume_image_metadata": {
        "checksum": "7538e0fcb56e0e272cfd89eb384d6613",
        "container_format": "bare",
        "disk_format": "qcow2",
        "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
        "image_name": "imagename",
        "min_disk": 100,
        "min_ram": 0,
        "os_distro": "alma",
        "scp_image_type": "custom",
        "scp_k8s_version": "v1.28.7",
        "scp_original_image_type": "standard",
        "signature_verified": false,
        "size": 2429747200
    },
    "volume_type": "SSD",
    "volume_type_id": "c643ac35-3aec-43e6-b97a-3d6f666c5207"
}

4.1.23.3 - 1.0

post /v1/volumes

Description

볼륨을 생성합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		VolumeCreateRequest

Responses

HTTP Code	Description	Schema
202	Accepted	VolumeShowResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/volumes

Request header

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

Request body

{
    "name": "volume01",
    "size": 104,
    "snapshot_id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790",
    "tags": [
        {
            "key": "key",
            "value": "value"
        }
    ],
    "volume_type": "SSD"
}

Example HTTP response

Response 202

{
    "bootable": false,
    "created_at": "2026-04-14T15:06:30.677Z",
    "encrypted": true,
    "id": "3f500f00-ed80-4566-a057-e31760226f9a",
    "modified_at": "2025-07-26T12:00:00Z",
    "multiattach": false,
    "name": "volume01",
    "servers": [
        {
            "attached_at": "2026-04-14T15:06:30.712Z",
            "device": "/dev/vda",
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f"
        }
    ],
    "size": 104,
    "snapshot_id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790",
    "state": "available",
    "user_id": "570907805e5447be84b618450ef52o0t",
    "volume_image_metadata": {
        "checksum": "7538e0fcb56e0e272cfd89eb384d6613",
        "container_format": "bare",
        "disk_format": "qcow2",
        "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
        "image_name": "imagename",
        "min_disk": 100,
        "min_ram": 0,
        "os_distro": "alma",
        "scp_image_type": "custom",
        "scp_k8s_version": "v1.28.7",
        "scp_original_image_type": "standard",
        "signature_verified": false,
        "size": 2429747200
    },
    "volume_type": "SSD",
    "volume_type_id": "c643ac35-3aec-43e6-b97a-3d6f666c5207"
}

4.1.24 - Delete a snapshot

4.1.24.1 - 1.2

delete /v1/snapshots/{snapshot_id}

Description

Snapshot 삭제를 요청합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	snapshot_id required	스냅샷 ID Example : `cceed636-1f1e-4bb0-b85c-4e5b9e0bf790`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/snapshots/{snapshot_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 = virtualserver 1.2"

Example HTTP response

Response 202

4.1.24.2 - 1.1

delete /v1/snapshots/{snapshot_id}

Description

Snapshot 삭제를 요청합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	snapshot_id required	스냅샷 ID Example : `cceed636-1f1e-4bb0-b85c-4e5b9e0bf790`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/snapshots/{snapshot_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 = virtualserver 1.1"

Example HTTP response

Response 202

4.1.24.3 - 1.0

delete /v1/snapshots/{snapshot_id}

Description

Snapshot 삭제를 요청합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	snapshot_id required	스냅샷 ID Example : `cceed636-1f1e-4bb0-b85c-4e5b9e0bf790`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/snapshots/{snapshot_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 = virtualserver 1.0"

Example HTTP response

Response 202

4.1.25 - Delete a volume transfer

4.1.25.1 - 1.2

delete /v1/volume-transfer/{transfer_id}

Description

볼륨 이전 취소를 요청합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	transfer_id required	볼륨 이전 ID Example : `1ac231be-823b-4a4d-8ff0-aac503a7118a`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/volume-transfer/{transfer_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 = virtualserver 1.2"

Example HTTP response

Response 202

4.1.25.2 - 1.1

delete /v1/volume-transfer/{transfer_id}

Description

볼륨 이전 취소를 요청합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	transfer_id required	볼륨 이전 ID Example : `1ac231be-823b-4a4d-8ff0-aac503a7118a`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/volume-transfer/{transfer_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 = virtualserver 1.1"

Example HTTP response

Response 202

4.1.25.3 - 1.0

delete /v1/volume-transfer/{transfer_id}

Description

볼륨 이전 취소를 요청합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	transfer_id required	볼륨 이전 ID Example : `1ac231be-823b-4a4d-8ff0-aac503a7118a`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/volume-transfer/{transfer_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 = virtualserver 1.0"

Example HTTP response

Response 202

4.1.26 - Delete Auto-Scaling Group

4.1.26.1 - 1.2

delete /v1/auto-scaling-groups/{auto_scaling_group_id}

Description

Auto-Scaling Group을 삭제합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_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 = virtualserver 1.2"

Example HTTP response

Response 204

4.1.26.2 - 1.1

delete /v1/auto-scaling-groups/{auto_scaling_group_id}

Description

Auto-Scaling Group을 삭제합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_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 = virtualserver 1.1"

Example HTTP response

Response 204

4.1.26.3 - 1.0

delete /v1/auto-scaling-groups/{auto_scaling_group_id}

Description

Auto-Scaling Group을 삭제합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_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 = virtualserver 1.0"

Example HTTP response

Response 204

4.1.27 - Delete Auto-Scaling Group Notification

4.1.27.1 - 1.2

delete /v1/auto-scaling-groups/{auto_scaling_group_id}/notifications/{notification_id}

Description

Auto-Scaling Group 알림을 삭제합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
path	notification_id required	Auto-Scaling Grou 알림 ID Example : `fa7fd191410744cd810a290c0b4d22b9`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/notifications/{notification_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 = virtualserver 1.2"

Example HTTP response

Response 204

4.1.27.2 - 1.1

delete /v1/auto-scaling-groups/{auto_scaling_group_id}/notifications/{notification_id}

Description

Auto-Scaling Group 알림을 삭제합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
path	notification_id required	Auto-Scaling Grou 알림 ID Example : `fa7fd191410744cd810a290c0b4d22b9`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/notifications/{notification_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 = virtualserver 1.1"

Example HTTP response

Response 204

4.1.27.3 - 1.0

delete /v1/auto-scaling-groups/{auto_scaling_group_id}/notifications/{notification_id}

Description

Auto-Scaling Group 알림을 삭제합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
path	notification_id required	Auto-Scaling Grou 알림 ID Example : `fa7fd191410744cd810a290c0b4d22b9`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/notifications/{notification_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 = virtualserver 1.0"

Example HTTP response

Response 204

4.1.28 - Delete Auto-Scaling Group Policy

4.1.28.1 - 1.2

delete /v1/auto-scaling-groups/{auto_scaling_group_id}/policies/{policy_id}

Description

Auto-Scaling Group 정책을 삭제합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
path	policy_id required	정책 ID Example : `0761d76085f54363bab07909baf69841`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/policies/{policy_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 = virtualserver 1.2"

Example HTTP response

Response 204

4.1.28.2 - 1.1

delete /v1/auto-scaling-groups/{auto_scaling_group_id}/policies/{policy_id}

Description

Auto-Scaling Group 정책을 삭제합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
path	policy_id required	정책 ID Example : `0761d76085f54363bab07909baf69841`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/policies/{policy_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 = virtualserver 1.1"

Example HTTP response

Response 204

4.1.28.3 - 1.0

delete /v1/auto-scaling-groups/{auto_scaling_group_id}/policies/{policy_id}

Description

Auto-Scaling Group 정책을 삭제합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
path	policy_id required	정책 ID Example : `0761d76085f54363bab07909baf69841`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/policies/{policy_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 = virtualserver 1.0"

Example HTTP response

Response 204

4.1.29 - Delete Auto-Scaling Group Schedule

4.1.29.1 - 1.2

delete /v1/auto-scaling-groups/{auto_scaling_group_id}/schedules/{schedule_id}

Description

Auto-Scaling Group 스케줄을 삭제합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
path	schedule_id required	스케줄 ID Example : `43d4841abd404220af5f0904037aba71`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/schedules/{schedule_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 = virtualserver 1.2"

Example HTTP response

Response 204

4.1.29.2 - 1.1

delete /v1/auto-scaling-groups/{auto_scaling_group_id}/schedules/{schedule_id}

Description

Auto-Scaling Group 스케줄을 삭제합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
path	schedule_id required	스케줄 ID Example : `43d4841abd404220af5f0904037aba71`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/schedules/{schedule_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 = virtualserver 1.1"

Example HTTP response

Response 204

4.1.29.3 - 1.0

delete /v1/auto-scaling-groups/{auto_scaling_group_id}/schedules/{schedule_id}

Description

Auto-Scaling Group 스케줄을 삭제합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
path	schedule_id required	스케줄 ID Example : `43d4841abd404220af5f0904037aba71`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/schedules/{schedule_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 = virtualserver 1.0"

Example HTTP response

Response 204

4.1.30 - Delete Image

4.1.30.1 - 1.2

delete /v1/images/{image_id}

Description

이미지를 삭제합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/images/{image_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 = virtualserver 1.2"

Example HTTP response

Response 204

4.1.30.2 - 1.1

delete /v1/images/{image_id}

Description

이미지를 삭제합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/images/{image_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 = virtualserver 1.1"

Example HTTP response

Response 204

4.1.30.3 - 1.0

delete /v1/images/{image_id}

Description

이미지를 삭제합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/images/{image_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 = virtualserver 1.0"

Example HTTP response

Response 204

4.1.31 - Delete Image member

4.1.31.1 - 1.2

delete /v1/images/{image_id}/members/{member_id}

Description

이미지 멤버를 삭제합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string	None
path	member_id required	공유용 이미지 멤버 ID Example : `a8f10467abfc4b87b64614ab36eb9ae4`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/images/{image_id}/members/{member_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 = virtualserver 1.2"

Example HTTP response

Response 204

4.1.31.2 - 1.1

delete /v1/images/{image_id}/members/{member_id}

Description

이미지 멤버를 삭제합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string	None
path	member_id required	공유용 이미지 멤버 ID Example : `a8f10467abfc4b87b64614ab36eb9ae4`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/images/{image_id}/members/{member_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 = virtualserver 1.1"

Example HTTP response

Response 204

4.1.31.3 - 1.0

delete /v1/images/{image_id}/members/{member_id}

Description

이미지 멤버를 삭제합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string	None
path	member_id required	공유용 이미지 멤버 ID Example : `a8f10467abfc4b87b64614ab36eb9ae4`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/images/{image_id}/members/{member_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 = virtualserver 1.0"

Example HTTP response

Response 204

4.1.32 - Delete Keypair

4.1.32.1 - 1.2

delete /v1/keypairs/{keypair_name}

Description

키페어를 삭제합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	keypair_name required	키페어 이름 Example : `keypairname`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/keypairs/{keypair_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 = virtualserver 1.2"

Example HTTP response

Response 204

4.1.32.2 - 1.1

delete /v1/keypairs/{keypair_name}

Description

키페어를 삭제합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	keypair_name required	키페어 이름 Example : `keypairname`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/keypairs/{keypair_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 = virtualserver 1.1"

Example HTTP response

Response 204

4.1.32.3 - 1.0

delete /v1/keypairs/{keypair_name}

Description

키페어를 삭제합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	keypair_name required	키페어 이름 Example : `keypairname`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/keypairs/{keypair_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 = virtualserver 1.0"

Example HTTP response

Response 204

4.1.33 - Delete Launch Configuration

4.1.33.1 - 1.2

delete /v1/launch-configurations/{launch_configuration_id}

Description

Launch Configuration을 삭제합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	launch_configuration_id required	Launch Configuration ID Example : `b5aea5a675fc4f6b9e0fcd1288354c5f`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/launch-configurations/{launch_configuration_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 = virtualserver 1.2"

Example HTTP response

Response 204

4.1.33.2 - 1.1

delete /v1/launch-configurations/{launch_configuration_id}

Description

Launch Configuration을 삭제합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	launch_configuration_id required	Launch Configuration ID Example : `b5aea5a675fc4f6b9e0fcd1288354c5f`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/launch-configurations/{launch_configuration_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 = virtualserver 1.1"

Example HTTP response

Response 204

4.1.33.3 - 1.0

delete /v1/launch-configurations/{launch_configuration_id}

Description

Launch Configuration을 삭제합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	launch_configuration_id required	Launch Configuration ID Example : `b5aea5a675fc4f6b9e0fcd1288354c5f`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/launch-configurations/{launch_configuration_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 = virtualserver 1.0"

Example HTTP response

Response 204

4.1.34 - Delete Server Group

4.1.34.1 - 1.2

delete /v1/server-groups/{server_group_id}

Description

서버 그룹을 삭제합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_group_id required	서버 그룹 ID Example : `616fb98f-46ca-475e-917e-2563e5a8cd19`	string	None

Responses

HTTP Code	Description	Schema
200	OK	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/server-groups/{server_group_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 = virtualserver 1.2"

Example HTTP response

Response 200

4.1.34.2 - 1.1

delete /v1/server-groups/{server_group_id}

Description

서버 그룹을 삭제합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_group_id required	서버 그룹 ID Example : `616fb98f-46ca-475e-917e-2563e5a8cd19`	string	None

Responses

HTTP Code	Description	Schema
200	OK	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/server-groups/{server_group_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 = virtualserver 1.1"

Example HTTP response

Response 200

4.1.34.3 - 1.0

delete /v1/server-groups/{server_group_id}

Description

서버 그룹을 삭제합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_group_id required	서버 그룹 ID Example : `616fb98f-46ca-475e-917e-2563e5a8cd19`	string	None

Responses

HTTP Code	Description	Schema
200	OK	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/server-groups/{server_group_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 = virtualserver 1.0"

Example HTTP response

Response 200

4.1.35 - Delete Server Interface

4.1.35.1 - 1.2

delete /v1/servers/{server_id}/interfaces/{port_id}

Description

서버 인터페이스를 삭제합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	port_id required	포트 ID Example : `91424c08-0b26-49fb-9808-ed042292ceef`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/interfaces/{port_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 = virtualserver 1.2"

Example HTTP response

Response 200

4.1.35.2 - 1.1

delete /v1/servers/{server_id}/interfaces/{port_id}

Description

서버 인터페이스를 삭제합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	port_id required	포트 ID Example : `91424c08-0b26-49fb-9808-ed042292ceef`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/interfaces/{port_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 = virtualserver 1.1"

Example HTTP response

Response 200

4.1.35.3 - 1.0

delete /v1/servers/{server_id}/interfaces/{port_id}

Description

서버 인터페이스를 삭제합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	port_id required	포트 ID Example : `91424c08-0b26-49fb-9808-ed042292ceef`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/interfaces/{port_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 = virtualserver 1.0"

Example HTTP response

Response 200

4.1.36 - Delete Server Interface Nat

4.1.36.1 - 1.2

delete /v1/servers/{server_id}/interfaces/{port_id}/static-nats/{nat_id}

Description

서버 인터페이스 Public NAT를 삭제합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	port_id required	포트 ID Example : `91424c08-0b26-49fb-9808-ed042292ceef`	string	None
path	nat_id required	NAT ID Example : `224b80106e6f41b38efe98ac9ddbf280`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/servers/{server_id}/interfaces/{port_id}/static-nats/{nat_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 = virtualserver 1.2"

Example HTTP response

Response 202

4.1.36.2 - 1.1

delete /v1/servers/{server_id}/interfaces/{port_id}/static-nats/{nat_id}

Description

서버 인터페이스 Public NAT를 삭제합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	port_id required	포트 ID Example : `91424c08-0b26-49fb-9808-ed042292ceef`	string	None
path	nat_id required	NAT ID Example : `224b80106e6f41b38efe98ac9ddbf280`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/servers/{server_id}/interfaces/{port_id}/static-nats/{nat_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 = virtualserver 1.1"

Example HTTP response

Response 202

4.1.36.3 - 1.0

delete /v1/servers/{server_id}/interfaces/{port_id}/static-nats/{nat_id}

Description

서버 인터페이스 Public NAT를 삭제합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	port_id required	포트 ID Example : `91424c08-0b26-49fb-9808-ed042292ceef`	string	None
path	nat_id required	NAT ID Example : `224b80106e6f41b38efe98ac9ddbf280`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/servers/{server_id}/interfaces/{port_id}/static-nats/{nat_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 = virtualserver 1.0"

Example HTTP response

Response 202

4.1.37 - Delete Server Interface Private Nat

4.1.37.1 - 1.2

delete /v1/servers/{server_id}/interfaces/{port_id}/private-static-nats/{nat_id}

Description

서버 인터페이스 Private NAT를 삭제합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	port_id required	포트 ID Example : `91424c08-0b26-49fb-9808-ed042292ceef`	string	None
path	nat_id required	NAT ID Example : `224b80106e6f41b38efe98ac9ddbf280`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/servers/{server_id}/interfaces/{port_id}/private-static-nats/{nat_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 = virtualserver 1.2"

Example HTTP response

Response 202

4.1.37.2 - 1.1

delete /v1/servers/{server_id}/interfaces/{port_id}/private-static-nats/{nat_id}

Description

서버 인터페이스 Private NAT를 삭제합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	port_id required	포트 ID Example : `91424c08-0b26-49fb-9808-ed042292ceef`	string	None
path	nat_id required	NAT ID Example : `224b80106e6f41b38efe98ac9ddbf280`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/servers/{server_id}/interfaces/{port_id}/private-static-nats/{nat_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 = virtualserver 1.1"

Example HTTP response

Response 202

4.1.37.3 - 1.0

delete /v1/servers/{server_id}/interfaces/{port_id}/private-static-nats/{nat_id}

Description

서버 인터페이스 Private NAT를 삭제합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	port_id required	포트 ID Example : `91424c08-0b26-49fb-9808-ed042292ceef`	string	None
path	nat_id required	NAT ID Example : `224b80106e6f41b38efe98ac9ddbf280`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/servers/{server_id}/interfaces/{port_id}/private-static-nats/{nat_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 = virtualserver 1.0"

Example HTTP response

Response 202

4.1.38 - Delete Server Volume

4.1.38.1 - 1.2

delete /v1/servers/{server_id}/volumes/{volume_id}

Description

서버 볼륨을 삭제합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/volumes/{volume_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 = virtualserver 1.2"

Example HTTP response

Response 202

4.1.38.2 - 1.1

delete /v1/servers/{server_id}/volumes/{volume_id}

Description

서버 볼륨을 삭제합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/volumes/{volume_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 = virtualserver 1.1"

Example HTTP response

Response 202

4.1.38.3 - 1.0

delete /v1/servers/{server_id}/volumes/{volume_id}

Description

서버 볼륨을 삭제합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/volumes/{volume_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 = virtualserver 1.0"

Example HTTP response

Response 202

4.1.39 - Delete Virtual Server

4.1.39.1 - 1.2

delete /v1/servers/{server_id}

Description

서버를 삭제합니다.

삭제가 완료된 서버는 복구할 수 없으며, 서버 목록에서 조회되지 않습니다
연결된 스토리지의 해지는 delete on termination 설정에 따라 다르오니 필요시 Block Storage에서 해지해주세요. 삭제에 실패하는 경우
File Storage 연결됨
LB서버그룹 연결됨
Lock 설정됨
Backup 연결됨

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_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 = virtualserver 1.2"

Example HTTP response

Response 202

4.1.39.2 - 1.1

delete /v1/servers/{server_id}

Description

서버를 삭제합니다.

삭제가 완료된 서버는 복구할 수 없으며, 서버 목록에서 조회되지 않습니다
연결된 스토리지의 해지는 delete on termination 설정에 따라 다르오니 필요시 Block Storage에서 해지해주세요. 삭제에 실패하는 경우
File Storage 연결됨
LB서버그룹 연결됨
Lock 설정됨
Backup 연결됨

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_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 = virtualserver 1.1"

Example HTTP response

Response 202

4.1.39.3 - 1.0

delete /v1/servers/{server_id}

Description

서버를 삭제합니다.

삭제가 완료된 서버는 복구할 수 없으며, 서버 목록에서 조회되지 않습니다
연결된 스토리지의 해지는 delete on termination 설정에 따라 다르오니 필요시 Block Storage에서 해지해주세요. 삭제에 실패하는 경우
File Storage 연결됨
LB서버그룹 연결됨
Lock 설정됨
Backup 연결됨

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_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 = virtualserver 1.0"

Example HTTP response

Response 202

4.1.40 - Delete Volume

4.1.40.1 - 1.2

delete /v1/volumes/{volume_id}

Description

볼륨을 삭제합니다.

볼륨 삭제 시, 저장된 데이터가 모두 삭제됩니다. 데이터 삭제 후에는 복구할 수 없으므로 주의하세요. 삭제할 수 없는 경우
서버 연결 중
OS 기본 볼륨
Virtual Server의 Custom 이미지와 연결
볼륨이 Available, Error, Error Extending, Error Restoring, Error Managing 외 다른 상태인 경우

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string	None
query	cascade optional	스냅샷 삭제 여부 Example : `True`	any of [boolean, null]	True

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
401	Unauthorized	None
409	Conflict	None

Example HTTP request

Request path

/v1/volumes/{volume_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 = virtualserver 1.2"

Example HTTP response

Response 202

4.1.40.2 - 1.1

delete /v1/volumes/{volume_id}

Description

볼륨을 삭제합니다.

볼륨 삭제 시, 저장된 데이터가 모두 삭제됩니다. 데이터 삭제 후에는 복구할 수 없으므로 주의하세요. 삭제할 수 없는 경우
서버 연결 중
OS 기본 볼륨
Virtual Server의 Custom 이미지와 연결
볼륨이 Available, Error, Error Extending, Error Restoring, Error Managing 외 다른 상태인 경우

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string	None
query	cascade optional	스냅샷 삭제 여부 Example : `True`	any of [boolean, null]	True

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
401	Unauthorized	None
409	Conflict	None

Example HTTP request

Request path

/v1/volumes/{volume_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 = virtualserver 1.1"

Example HTTP response

Response 202

4.1.40.3 - 1.0

delete /v1/volumes/{volume_id}

Description

볼륨을 삭제합니다.

볼륨 삭제 시, 저장된 데이터가 모두 삭제됩니다. 데이터 삭제 후에는 복구할 수 없으므로 주의하세요. 삭제할 수 없는 경우
서버 연결 중
OS 기본 볼륨
Virtual Server의 Custom 이미지와 연결
볼륨이 Available, Error, Error Extending, Error Restoring, Error Managing 외 다른 상태인 경우

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string	None
query	cascade optional	스냅샷 삭제 여부 Example : `True`	any of [boolean, null]	True

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
401	Unauthorized	None
409	Conflict	None

Example HTTP request

Request path

/v1/volumes/{volume_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 = virtualserver 1.0"

Example HTTP response

Response 202

4.1.41 - Detach Virtual Server Security Group

4.1.41.1 - 1.0

delete /v1/servers/{server_id}/security-groups/{security_group_id}

Description

서버에 적용된 Security Group을 해제합니다.

서버에 하나 이상의 네트워크가 연결되어 있고, 각 네트워크에 현재 해제하려는 Security Group이 모두 적용되어 있다면, 모든 네트워크에서 Security Group 적용이 해제됩니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	security_group_id required	Security Group ID Example : `c09c3f05-03d9-443f-b27a-40e0f973c75f`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/security-groups/{security_group_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 = virtualserver 1.0"

Example HTTP response

Response 202

4.1.42 - Detach Volume from Virtual Server

4.1.42.1 - 1.2

delete /v1/volumes/{volume_id}/servers/{server_id}

Description

서버에 적용된 Security Group을 해제합니다.

서버에 하나 이상의 네트워크가 연결되어 있고, 각 네트워크에 현재 해제하려는 Security Group이 모두 적용되어 있다면, 모든 네트워크에서 Security Group 적용이 해제됩니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string	None
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
401	Unauthorized	None
409	Conflict	None

Example HTTP request

Request path

/v1/volumes/{volume_id}/servers/{server_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 = virtualserver 1.2"

Example HTTP response

Response 202

4.1.42.2 - 1.1

delete /v1/volumes/{volume_id}/servers/{server_id}

Description

서버에 적용된 Security Group을 해제합니다.

서버에 하나 이상의 네트워크가 연결되어 있고, 각 네트워크에 현재 해제하려는 Security Group이 모두 적용되어 있다면, 모든 네트워크에서 Security Group 적용이 해제됩니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string	None
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
401	Unauthorized	None
409	Conflict	None

Example HTTP request

Request path

/v1/volumes/{volume_id}/servers/{server_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 = virtualserver 1.1"

Example HTTP response

Response 202

4.1.42.3 - 1.0

delete /v1/volumes/{volume_id}/servers/{server_id}

Description

서버에 적용된 Security Group을 해제합니다.

서버에 하나 이상의 네트워크가 연결되어 있고, 각 네트워크에 현재 해제하려는 Security Group이 모두 적용되어 있다면, 모든 네트워크에서 Security Group 적용이 해제됩니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string	None
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
401	Unauthorized	None
409	Conflict	None

Example HTTP request

Request path

/v1/volumes/{volume_id}/servers/{server_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 = virtualserver 1.0"

Example HTTP response

Response 202

4.1.43 - Extend Volume

4.1.43.1 - 1.2

put /v1/volumes/{volume_id}/size

Description

볼륨 용량을 증설합니다.

볼륨 용량은 축소가 불가능하며 증설만 요청 가능합니다.
용량 증설 시, 이전에 생성한 스냅샷으로는 신규 볼륨 생성 방식의 복구만 가능합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string	None
body	body required		VolumeExtendRequest

Responses

HTTP Code	Description	Schema
202	Accepted	VolumeShowResponseV1Dot2
400	Bad Request	None
401	Unauthorized	None
409	Conflict	None

Example HTTP request

Request path

/v1/volumes/{volume_id}/size

Request header

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

Request body

{
    "size": 104
}

Example HTTP response

Response 202

{
    "bootable": false,
    "created_at": "2026-04-14T15:06:31.797Z",
    "encrypted": true,
    "id": "3f500f00-ed80-4566-a057-e31760226f9a",
    "max_iops": 10000,
    "max_throughput": 500,
    "modified_at": "2025-07-26T12:00:00Z",
    "multiattach": false,
    "name": "volume01",
    "servers": [
        {
            "attached_at": "2026-04-14T15:06:30.712Z",
            "device": "/dev/vda",
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f"
        }
    ],
    "size": 104,
    "snapshot_id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790",
    "state": "available",
    "user_id": "570907805e5447be84b618450ef52o0t",
    "volume_image_metadata": {
        "checksum": "7538e0fcb56e0e272cfd89eb384d6613",
        "container_format": "bare",
        "disk_format": "qcow2",
        "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
        "image_name": "imagename",
        "min_disk": 100,
        "min_ram": 0,
        "os_distro": "alma",
        "scp_image_type": "custom",
        "scp_k8s_version": "v1.28.7",
        "scp_original_image_type": "standard",
        "signature_verified": false,
        "size": 2429747200
    },
    "volume_type": "SSD",
    "volume_type_id": "c643ac35-3aec-43e6-b97a-3d6f666c5207"
}

4.1.43.2 - 1.1

put /v1/volumes/{volume_id}/size

Description

볼륨 용량을 증설합니다.

볼륨 용량은 축소가 불가능하며 증설만 요청 가능합니다.
용량 증설 시, 이전에 생성한 스냅샷으로는 신규 볼륨 생성 방식의 복구만 가능합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string	None
body	body required		VolumeExtendRequest

Responses

HTTP Code	Description	Schema
202	Accepted	VolumeShowResponse
400	Bad Request	None
401	Unauthorized	None
409	Conflict	None

Example HTTP request

Request path

/v1/volumes/{volume_id}/size

Request header

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

Request body

{
    "size": 104
}

Example HTTP response

Response 202

{
    "bootable": false,
    "created_at": "2026-04-14T15:06:30.677Z",
    "encrypted": true,
    "id": "3f500f00-ed80-4566-a057-e31760226f9a",
    "modified_at": "2025-07-26T12:00:00Z",
    "multiattach": false,
    "name": "volume01",
    "servers": [
        {
            "attached_at": "2026-04-14T15:06:30.712Z",
            "device": "/dev/vda",
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f"
        }
    ],
    "size": 104,
    "snapshot_id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790",
    "state": "available",
    "user_id": "570907805e5447be84b618450ef52o0t",
    "volume_image_metadata": {
        "checksum": "7538e0fcb56e0e272cfd89eb384d6613",
        "container_format": "bare",
        "disk_format": "qcow2",
        "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
        "image_name": "imagename",
        "min_disk": 100,
        "min_ram": 0,
        "os_distro": "alma",
        "scp_image_type": "custom",
        "scp_k8s_version": "v1.28.7",
        "scp_original_image_type": "standard",
        "signature_verified": false,
        "size": 2429747200
    },
    "volume_type": "SSD",
    "volume_type_id": "c643ac35-3aec-43e6-b97a-3d6f666c5207"
}

4.1.43.3 - 1.0

put /v1/volumes/{volume_id}/size

Description

볼륨 용량을 증설합니다.

볼륨 용량은 축소가 불가능하며 증설만 요청 가능합니다.
용량 증설 시, 이전에 생성한 스냅샷으로는 신규 볼륨 생성 방식의 복구만 가능합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string	None
body	body required		VolumeExtendRequest

Responses

HTTP Code	Description	Schema
202	Accepted	VolumeShowResponse
400	Bad Request	None
401	Unauthorized	None
409	Conflict	None

Example HTTP request

Request path

/v1/volumes/{volume_id}/size

Request header

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

Request body

{
    "size": 104
}

Example HTTP response

Response 202

{
    "bootable": false,
    "created_at": "2026-04-14T15:06:30.677Z",
    "encrypted": true,
    "id": "3f500f00-ed80-4566-a057-e31760226f9a",
    "modified_at": "2025-07-26T12:00:00Z",
    "multiattach": false,
    "name": "volume01",
    "servers": [
        {
            "attached_at": "2026-04-14T15:06:30.712Z",
            "device": "/dev/vda",
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f"
        }
    ],
    "size": 104,
    "snapshot_id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790",
    "state": "available",
    "user_id": "570907805e5447be84b618450ef52o0t",
    "volume_image_metadata": {
        "checksum": "7538e0fcb56e0e272cfd89eb384d6613",
        "container_format": "bare",
        "disk_format": "qcow2",
        "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
        "image_name": "imagename",
        "min_disk": 100,
        "min_ram": 0,
        "os_distro": "alma",
        "scp_image_type": "custom",
        "scp_k8s_version": "v1.28.7",
        "scp_original_image_type": "standard",
        "signature_verified": false,
        "size": 2429747200
    },
    "volume_type": "SSD",
    "volume_type_id": "c643ac35-3aec-43e6-b97a-3d6f666c5207"
}

4.1.44 - Get region's maximum partition size.

4.1.44.1 - 1.2

get /v1/server-groups/partition-size

Description

해당 리전의 최대 파티션 사이즈를 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Responses

HTTP Code	Description	Schema
200	OK	ServerGroupPartitionSizeResponse
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/server-groups/partition-size

Request header

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

Example HTTP response

Response 200

{
    "partition_size": ""
}

4.1.44.2 - 1.1

get /v1/server-groups/partition-size

Description

해당 리전의 최대 파티션 사이즈를 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Responses

HTTP Code	Description	Schema
200	OK	ServerGroupPartitionSizeResponse
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/server-groups/partition-size

Request header

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

Example HTTP response

Response 200

{
    "partition_size": ""
}

4.1.44.3 - 1.0

get /v1/server-groups/partition-size

Description

해당 리전의 최대 파티션 사이즈를 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Responses

HTTP Code	Description	Schema
200	OK	ServerGroupPartitionSizeResponse
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/server-groups/partition-size

Request header

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

Example HTTP response

Response 200

{
    "partition_size": ""
}

4.1.45 - Import Image

4.1.45.1 - 1.2

post /v1/images/{image_id}/import

Description

외부 이미지 파일을 연결해 이미지 자원으로 사용합니다.

Object Storage에 업로드된 이미지 파일의 URL이 필요
Image 파일을 업로드한 Object Storage의 Bucket은 생성할 서버와 동일한 존(Zone) 존재
Image 파일은 .qcow2 확장자만 가능

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string	None
body	body required		ImageImportRequest

Responses

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

Example HTTP request

Request path

/v1/images/{image_id}/import

Request header

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

Request body

{
    "url": "https://object-store.kr-west1.s.samsungsdscloud.com/8989447062e04a818baf9e073fd04fa7/bucket/object.qcow2"
}

Example HTTP response

Response 202

4.1.45.2 - 1.1

post /v1/images/{image_id}/import

Description

외부 이미지 파일을 연결해 이미지 자원으로 사용합니다.

Object Storage에 업로드된 이미지 파일의 URL이 필요
Image 파일을 업로드한 Object Storage의 Bucket은 생성할 서버와 동일한 존(Zone) 존재
Image 파일은 .qcow2 확장자만 가능

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string	None
body	body required		ImageImportRequest

Responses

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

Example HTTP request

Request path

/v1/images/{image_id}/import

Request header

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

Request body

{
    "url": "https://object-store.kr-west1.s.samsungsdscloud.com/8989447062e04a818baf9e073fd04fa7/bucket/object.qcow2"
}

Example HTTP response

Response 202

4.1.45.3 - 1.0

post /v1/images/{image_id}/import

Description

외부 이미지 파일을 연결해 이미지 자원으로 사용합니다.

Object Storage에 업로드된 이미지 파일의 URL이 필요
Image 파일을 업로드한 Object Storage의 Bucket은 생성할 서버와 동일한 존(Zone) 존재
Image 파일은 .qcow2 확장자만 가능

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string	None
body	body required		ImageImportRequest

Responses

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

Example HTTP request

Request path

/v1/images/{image_id}/import

Request header

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

Request body

{
    "url": "https://object-store.kr-west1.s.samsungsdscloud.com/8989447062e04a818baf9e073fd04fa7/bucket/object.qcow2"
}

Example HTTP response

Response 202

4.1.46 - List Auto-Scaling Group LB Server Groups

4.1.46.1 - 1.2

get /v1/auto-scaling-groups/{auto_scaling_group_id}/lb-server-groups

Description

Auto-Scaling Group LB 서버 그룹 목록을 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
query	offset optional	목록에서 시작할 지점의 인덱스 Example : `0`	any of [integer, null]	0
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	20
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:desc`	any of [string, null]	created_at:desc,id:desc

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupLbServerGroupListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/lb-server-groups

Request header

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

Example HTTP response

Response 200

{
    "count": 20,
    "lb_server_groups": [
        {
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "lb-server-group-name",
            "port": 8080
        }
    ]
}

4.1.46.2 - 1.1

get /v1/auto-scaling-groups/{auto_scaling_group_id}/lb-server-groups

Description

Auto-Scaling Group LB 서버 그룹 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
query	offset optional	목록에서 시작할 지점의 인덱스 Example : `0`	any of [integer, null]	0
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	20
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:desc`	any of [string, null]	created_at:desc,id:desc

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupLbServerGroupListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/lb-server-groups

Request header

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

Example HTTP response

Response 200

{
    "count": 20,
    "lb_server_groups": [
        {
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "lb-server-group-name",
            "port": 8080
        }
    ]
}

4.1.46.3 - 1.0

get /v1/auto-scaling-groups/{auto_scaling_group_id}/lb-server-groups

Description

Auto-Scaling Group LB 서버 그룹 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
query	offset optional	목록에서 시작할 지점의 인덱스 Example : `0`	any of [integer, null]	0
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	20
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:desc`	any of [string, null]	created_at:desc,id:desc

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupLbServerGroupListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/lb-server-groups

Request header

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

Example HTTP response

Response 200

{
    "count": 20,
    "lb_server_groups": [
        {
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "lb-server-group-name",
            "port": 8080
        }
    ]
}

4.1.47 - List Auto-Scaling Group Notifications

4.1.47.1 - 1.2

get /v1/auto-scaling-groups/{auto_scaling_group_id}/notifications

Description

Auto-Scaling Group 알림 목록을 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
query	user_ids optional	사용자 ID 목록 Example : `['570907805e5447be84b618450ef52o0t']`	any of [array[string], null]	[]
query	notification_state optional	Auto-Scaling Group 알림 상태 Example : `ACTIVE`	any of [string, null]	[]
query	notification_event optional	Auto-Scaling Group 알림 이벤트 Example : `SCALE_OUT`	any of [string, null]	[]
query	offset optional	목록에서 시작할 지점의 인덱스 Example : `0`	any of [integer, null]	0
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	20
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:desc`	any of [string, null]	created_at:desc

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupNotificationListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/notifications

Request header

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

Example HTTP response

Response 200

{
    "count": 20,
    "notifications": [
        {
            "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
            "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "notification_events": [
                "SCALE_OUT",
                "SCALE_OUT_FAIL"
            ],
            "notification_state": "ACTIVE",
            "user_email": "scpuser@samsung.com",
            "user_id": "570907805e5447be84b618450ef52o0t",
            "user_name": "scpuser"
        }
    ]
}

4.1.47.2 - 1.1

get /v1/auto-scaling-groups/{auto_scaling_group_id}/notifications

Description

Auto-Scaling Group 알림 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
query	user_ids optional	사용자 ID 목록 Example : `['570907805e5447be84b618450ef52o0t']`	any of [array[string], null]	[]
query	notification_state optional	Auto-Scaling Group 알림 상태 Example : `ACTIVE`	any of [string, null]	[]
query	notification_event optional	Auto-Scaling Group 알림 이벤트 Example : `SCALE_OUT`	any of [string, null]	[]
query	offset optional	목록에서 시작할 지점의 인덱스 Example : `0`	any of [integer, null]	0
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	20
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:desc`	any of [string, null]	created_at:desc

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupNotificationListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/notifications

Request header

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

Example HTTP response

Response 200

{
    "count": 20,
    "notifications": [
        {
            "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
            "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "notification_events": [
                "SCALE_OUT",
                "SCALE_OUT_FAIL"
            ],
            "notification_state": "ACTIVE",
            "user_email": "scpuser@samsung.com",
            "user_id": "570907805e5447be84b618450ef52o0t",
            "user_name": "scpuser"
        }
    ]
}

4.1.47.3 - 1.0

get /v1/auto-scaling-groups/{auto_scaling_group_id}/notifications

Description

Auto-Scaling Group 알림 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
query	user_ids optional	사용자 ID 목록 Example : `['570907805e5447be84b618450ef52o0t']`	any of [array[string], null]	[]
query	notification_state optional	Auto-Scaling Group 알림 상태 Example : `ACTIVE`	any of [string, null]	[]
query	notification_event optional	Auto-Scaling Group 알림 이벤트 Example : `SCALE_OUT`	any of [string, null]	[]
query	offset optional	목록에서 시작할 지점의 인덱스 Example : `0`	any of [integer, null]	0
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	20
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:desc`	any of [string, null]	created_at:desc

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupNotificationListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/notifications

Request header

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

Example HTTP response

Response 200

{
    "count": 20,
    "notifications": [
        {
            "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
            "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "notification_events": [
                "SCALE_OUT",
                "SCALE_OUT_FAIL"
            ],
            "notification_state": "ACTIVE",
            "user_email": "scpuser@samsung.com",
            "user_id": "570907805e5447be84b618450ef52o0t",
            "user_name": "scpuser"
        }
    ]
}

4.1.48 - List Auto-Scaling Group Policies

4.1.48.1 - 1.2

get /v1/auto-scaling-groups/{auto_scaling_group_id}/policies

Description

Auto-Scaling Group 정책 목록을 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
query	name optional	정책 이름 Example : `policy-name`	any of [string, null]	None
query	metric_method optional	메트릭 방법 Example : `AVG`	any of [enum (AVG, MIN, MAX), null]	None
query	metric_type optional	메트릭 유형 Example : `CPU`	any of [string, null]	None
query	scale_type optional	스케일 유형 Example : `SCALE_OUT`	any of [enum (SCALE_OUT, SCALE_IN), null]	None
query	offset optional	목록에서 시작할 지점의 인덱스 Example : `0`	any of [integer, null]	0
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	20
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:desc`	any of [string, null]	created_at:desc,id:desc

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupPolicyListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/policies

Request header

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

Example HTTP response

Response 200

{
    "count": 20,
    "policies": [
        {
            "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
            "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
            "comparison_operator": "ge",
            "cooldown_seconds": 300,
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "evaluation_minutes": 5,
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "metric_method": "AVG",
            "metric_type": "CPU",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "policy-name",
            "scale_method": "AMOUNT",
            "scale_type": "SCALE_OUT",
            "scale_value": 10,
            "state": "ACTIVE",
            "threshold": 60,
            "threshold_unit": "%"
        }
    ]
}

4.1.48.2 - 1.1

get /v1/auto-scaling-groups/{auto_scaling_group_id}/policies

Description

Auto-Scaling Group 정책 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
query	name optional	정책 이름 Example : `policy-name`	any of [string, null]	None
query	metric_method optional	메트릭 방법 Example : `AVG`	any of [enum (AVG, MIN, MAX), null]	None
query	metric_type optional	메트릭 유형 Example : `CPU`	any of [string, null]	None
query	scale_type optional	스케일 유형 Example : `SCALE_OUT`	any of [enum (SCALE_OUT, SCALE_IN), null]	None
query	offset optional	목록에서 시작할 지점의 인덱스 Example : `0`	any of [integer, null]	0
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	20
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:desc`	any of [string, null]	created_at:desc,id:desc

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupPolicyListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/policies

Request header

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

Example HTTP response

Response 200

{
    "count": 20,
    "policies": [
        {
            "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
            "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
            "comparison_operator": "ge",
            "cooldown_seconds": 300,
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "evaluation_minutes": 5,
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "metric_method": "AVG",
            "metric_type": "CPU",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "policy-name",
            "scale_method": "AMOUNT",
            "scale_type": "SCALE_OUT",
            "scale_value": 10,
            "state": "ACTIVE",
            "threshold": 60,
            "threshold_unit": "%"
        }
    ]
}

4.1.48.3 - 1.0

get /v1/auto-scaling-groups/{auto_scaling_group_id}/policies

Description

Auto-Scaling Group 정책 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
query	name optional	정책 이름 Example : `policy-name`	any of [string, null]	None
query	metric_method optional	메트릭 방법 Example : `AVG`	any of [enum (AVG, MIN, MAX), null]	None
query	metric_type optional	메트릭 유형 Example : `CPU`	any of [string, null]	None
query	scale_type optional	스케일 유형 Example : `SCALE_OUT`	any of [enum (SCALE_OUT, SCALE_IN), null]	None
query	offset optional	목록에서 시작할 지점의 인덱스 Example : `0`	any of [integer, null]	0
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	20
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:desc`	any of [string, null]	created_at:desc,id:desc

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupPolicyListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/policies

Request header

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

Example HTTP response

Response 200

{
    "count": 20,
    "policies": [
        {
            "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
            "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
            "comparison_operator": "ge",
            "cooldown_seconds": 300,
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "evaluation_minutes": 5,
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "metric_method": "AVG",
            "metric_type": "CPU",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "policy-name",
            "scale_method": "AMOUNT",
            "scale_type": "SCALE_OUT",
            "scale_value": 10,
            "state": "ACTIVE",
            "threshold": 60,
            "threshold_unit": "%"
        }
    ]
}

4.1.49 - List Auto-Scaling Group Schedules

4.1.49.1 - 1.2

get /v1/auto-scaling-groups/{auto_scaling_group_id}/schedules

Description

Auto-Scaling Group 스케줄 목록을 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
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	frequency optional	빈도 Example : `WEEKLY`	any of [enum (ONCE, DAILY, WEEKLY, MONTHLY), null]	None

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupScheduleListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_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 = virtualserver 1.2"

Example HTTP response

Response 200

{
    "count": 20,
    "page": 0,
    "schedules": [
        {
            "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "day_of_month": "-1,1",
            "day_of_week": "SU,SA",
            "description": "description",
            "desired_server_count": 1,
            "end_date": "2025-01-01",
            "frequency": "WEEKLY",
            "hour": 9,
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "max_server_count": 2,
            "min_server_count": 1,
            "minute": 0,
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "schedulename",
            "start_date": "2024-01-01",
            "state": "ACTIVE",
            "timezone": "Asia/Seoul"
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

4.1.49.2 - 1.1

get /v1/auto-scaling-groups/{auto_scaling_group_id}/schedules

Description

Auto-Scaling Group 스케줄 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
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	frequency optional	빈도 Example : `WEEKLY`	any of [enum (ONCE, DAILY, WEEKLY, MONTHLY), null]	None

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupScheduleListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_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 = virtualserver 1.1"

Example HTTP response

Response 200

{
    "count": 20,
    "page": 0,
    "schedules": [
        {
            "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "day_of_month": "-1,1",
            "day_of_week": "SU,SA",
            "description": "description",
            "desired_server_count": 1,
            "end_date": "2025-01-01",
            "frequency": "WEEKLY",
            "hour": 9,
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "max_server_count": 2,
            "min_server_count": 1,
            "minute": 0,
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "schedulename",
            "start_date": "2024-01-01",
            "state": "ACTIVE",
            "timezone": "Asia/Seoul"
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

4.1.49.3 - 1.0

get /v1/auto-scaling-groups/{auto_scaling_group_id}/schedules

Description

Auto-Scaling Group 스케줄 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
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	frequency optional	빈도 Example : `WEEKLY`	any of [enum (ONCE, DAILY, WEEKLY, MONTHLY), null]	None

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupScheduleListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_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 = virtualserver 1.0"

Example HTTP response

Response 200

{
    "count": 20,
    "page": 0,
    "schedules": [
        {
            "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "day_of_month": "-1,1",
            "day_of_week": "SU,SA",
            "description": "description",
            "desired_server_count": 1,
            "end_date": "2025-01-01",
            "frequency": "WEEKLY",
            "hour": 9,
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "max_server_count": 2,
            "min_server_count": 1,
            "minute": 0,
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "schedulename",
            "start_date": "2024-01-01",
            "state": "ACTIVE",
            "timezone": "Asia/Seoul"
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

4.1.50 - List Auto-Scaling Group Virtual Servers

4.1.50.1 - 1.2

get /v1/auto-scaling-groups/{auto_scaling_group_id}/virtual-servers

Description

Auto-Scaling Group Virtual Server 목록을 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
query	marker optional	이전 요청에서 마지막으로 반환된 항목 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	any of [string, null]	None
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	20
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:desc`	any of [string, null]	created_at:desc

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupVirtualServerListResponseV1Dot2
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/virtual-servers

Request header

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

Example HTTP response

Response 200

{
    "servers": [
        {
            "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
            "addresses": [
                {
                    "ip_addresses": [
                        {
                            "ip_address": "192.169.3.2",
                            "version": 4
                        }
                    ],
                    "subnet_name": "subnetname"
                }
            ],
            "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
            "created_at": "2026-04-14T15:06:31.249Z",
            "created_by": "97e6b22c9a4143789ca522df7457a32f",
            "disk_config": "MANUAL",
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
            "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
            "is_asg_virtual_server_healthy": true,
            "is_lb_healthy": true,
            "is_marketplace": false,
            "keypair_name": "keypairname",
            "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
            "lb_linked_state": "ATTACHED",
            "locked": false,
            "metadata": "",
            "modified_at": "2026-04-14T15:06:31.279Z",
            "name": "servername",
            "partition_number": 1,
            "planned_compute_os_type": "windows",
            "product_category": "compute",
            "product_offering": "virtual_server",
            "security_groups": [
                {
                    "name": "securitygroup"
                }
            ],
            "server_group_id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
            "server_type": {
                "disk": 100,
                "ephemeral": 0,
                "extra_specs": "",
                "id": "s1v1m2",
                "name": "s1v1m2",
                "ram": 2,
                "swap": 0,
                "vcpus": 1
            },
            "state": "ACTIVE",
            "volumes": [
                {
                    "delete_on_termination": false,
                    "id": "3f500f00-ed80-4566-a057-e31760226f9a"
                }
            ],
            "vpc_id": "cc976b621087484ea5fd527f4b78708b"
        }
    ]
}

4.1.50.2 - 1.1

get /v1/auto-scaling-groups/{auto_scaling_group_id}/virtual-servers

Description

Auto-Scaling Group Virtual Server 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
query	marker optional	이전 요청에서 마지막으로 반환된 항목 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	any of [string, null]	None
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	20
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:desc`	any of [string, null]	created_at:desc

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupVirtualServerListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/virtual-servers

Request header

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

Example HTTP response

Response 200

{
    "servers": [
        {
            "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
            "addresses": [
                {
                    "ip_addresses": [
                        {
                            "ip_address": "192.169.3.2",
                            "version": 4
                        }
                    ],
                    "subnet_name": "subnetname"
                }
            ],
            "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
            "created_at": "2026-04-14T15:06:28.891Z",
            "created_by": "97e6b22c9a4143789ca522df7457a32f",
            "disk_config": "MANUAL",
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
            "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
            "is_marketplace": false,
            "keypair_name": "keypairname",
            "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
            "lb_linked_state": "ATTACHED",
            "locked": false,
            "metadata": "",
            "modified_at": "2026-04-14T15:06:28.919Z",
            "name": "servername",
            "partition_number": 1,
            "planned_compute_os_type": "windows",
            "product_category": "compute",
            "product_offering": "virtual_server",
            "security_groups": [
                {
                    "name": "securitygroup"
                }
            ],
            "server_group_id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
            "server_type": {
                "disk": 100,
                "ephemeral": 0,
                "extra_specs": "",
                "id": "s1v1m2",
                "name": "s1v1m2",
                "ram": 2,
                "swap": 0,
                "vcpus": 1
            },
            "state": "ACTIVE",
            "volumes": [
                {
                    "delete_on_termination": false,
                    "id": "3f500f00-ed80-4566-a057-e31760226f9a"
                }
            ],
            "vpc_id": "cc976b621087484ea5fd527f4b78708b"
        }
    ]
}

4.1.50.3 - 1.0

get /v1/auto-scaling-groups/{auto_scaling_group_id}/virtual-servers

Description

Auto-Scaling Group Virtual Server 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
query	marker optional	이전 요청에서 마지막으로 반환된 항목 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	any of [string, null]	None
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	20
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:desc`	any of [string, null]	created_at:desc

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupVirtualServerListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/virtual-servers

Request header

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

Example HTTP response

Response 200

{
    "servers": [
        {
            "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
            "addresses": [
                {
                    "ip_addresses": [
                        {
                            "ip_address": "192.169.3.2",
                            "version": 4
                        }
                    ],
                    "subnet_name": "subnetname"
                }
            ],
            "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
            "created_at": "2026-04-14T15:06:28.891Z",
            "created_by": "97e6b22c9a4143789ca522df7457a32f",
            "disk_config": "MANUAL",
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
            "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
            "is_marketplace": false,
            "keypair_name": "keypairname",
            "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
            "lb_linked_state": "ATTACHED",
            "locked": false,
            "metadata": "",
            "modified_at": "2026-04-14T15:06:28.919Z",
            "name": "servername",
            "partition_number": 1,
            "planned_compute_os_type": "windows",
            "product_category": "compute",
            "product_offering": "virtual_server",
            "security_groups": [
                {
                    "name": "securitygroup"
                }
            ],
            "server_group_id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
            "server_type": {
                "disk": 100,
                "ephemeral": 0,
                "extra_specs": "",
                "id": "s1v1m2",
                "name": "s1v1m2",
                "ram": 2,
                "swap": 0,
                "vcpus": 1
            },
            "state": "ACTIVE",
            "volumes": [
                {
                    "delete_on_termination": false,
                    "id": "3f500f00-ed80-4566-a057-e31760226f9a"
                }
            ],
            "vpc_id": "cc976b621087484ea5fd527f4b78708b"
        }
    ]
}

4.1.51 - List Auto-Scaling Groups

4.1.51.1 - 1.2

get /v1/auto-scaling-groups

Description

Auto-Scaling Group 목록을 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
query	name optional	Auto-Scaling Group 이름 Example : `auto-scaling-group-name`	any of [string, null]	None
query	state optional	Auto-Scaling Group 상태 Example : `IN_SERVICE`	any of [string, null]	None
query	launch_configuration_id optional	Launch Configuration ID Example : `b5aea5a675fc4f6b9e0fcd1288354c5f`	any of [string, null]	None
query	launch_configuration_name optional	Launch Configuration 이름 Example : `launch-configuration-name`	any of [string, null]	None
query	lb_server_group_id optional	LB 서버 그룹 ID Example : `d06e87d3-ca9a-461b-8e88-077a542a7335`	any of [string, null]	None
query	security_group_id optional	Security Group ID Example : `c09c3f05-03d9-443f-b27a-40e0f973c75f`	any of [string, null]	None
query	subnet_id optional	서브넷 ID Example : `78b2ee3f074145c580ab6abac4821f97`	any of [string, null]	None
query	vpc_id optional	VPC ID Example : `cc976b621087484ea5fd527f4b78708b`	any of [string, null]	None
query	created_by optional	생성자 ID Example : `97e6b22c9a4143789ca522df7457a32f`	any of [string, null]	None
query	offset optional	목록에서 시작할 지점의 인덱스 Example : `0`	any of [integer, null]	0
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	20
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:desc`	any of [string, null]	created_at:desc,id:desc

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupListResponseV1Dot2
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/auto-scaling-groups

Request header

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

Example HTTP response

Response 200

{
    "auto_scaling_groups": [
        {
            "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "desired_server_count": 1,
            "desired_server_count_editable": true,
            "drain_enabled": true,
            "drain_timeout": 300,
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
            "launch_configuration_name": "launch-configuration-name",
            "lb_server_groups": [],
            "max_server_count": 2,
            "min_server_count": 1,
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "auto-scaling-group-name",
            "security_group_ids": [
                "c09c3f05-03d9-443f-b27a-40e0f973c75f"
            ],
            "server_name_prefix": "server-name-prefix",
            "state": "IN_SERVICE",
            "state_check_delay_time": 300,
            "subnet_ids": [],
            "use_lb_state_check": true,
            "vpc_id": "cc976b621087484ea5fd527f4b78708b"
        }
    ],
    "count": 20
}

4.1.51.2 - 1.1

get /v1/auto-scaling-groups

Description

Auto-Scaling Group 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
query	name optional	Auto-Scaling Group 이름 Example : `auto-scaling-group-name`	any of [string, null]	None
query	state optional	Auto-Scaling Group 상태 Example : `IN_SERVICE`	any of [string, null]	None
query	launch_configuration_id optional	Launch Configuration ID Example : `b5aea5a675fc4f6b9e0fcd1288354c5f`	any of [string, null]	None
query	launch_configuration_name optional	Launch Configuration 이름 Example : `launch-configuration-name`	any of [string, null]	None
query	lb_server_group_id optional	LB 서버 그룹 ID Example : `d06e87d3-ca9a-461b-8e88-077a542a7335`	any of [string, null]	None
query	security_group_id optional	Security Group ID Example : `c09c3f05-03d9-443f-b27a-40e0f973c75f`	any of [string, null]	None
query	subnet_id optional	서브넷 ID Example : `78b2ee3f074145c580ab6abac4821f97`	any of [string, null]	None
query	vpc_id optional	VPC ID Example : `cc976b621087484ea5fd527f4b78708b`	any of [string, null]	None
query	created_by optional	생성자 ID Example : `97e6b22c9a4143789ca522df7457a32f`	any of [string, null]	None
query	offset optional	목록에서 시작할 지점의 인덱스 Example : `0`	any of [integer, null]	0
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	20
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:desc`	any of [string, null]	created_at:desc,id:desc

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/auto-scaling-groups

Request header

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

Example HTTP response

Response 200

{
    "auto_scaling_groups": [
        {
            "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "desired_server_count": 1,
            "desired_server_count_editable": true,
            "drain_enabled": true,
            "drain_timeout": 300,
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
            "launch_configuration_name": "launch-configuration-name",
            "lb_server_groups": [],
            "max_server_count": 2,
            "min_server_count": 1,
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "auto-scaling-group-name",
            "security_group_ids": [
                "c09c3f05-03d9-443f-b27a-40e0f973c75f"
            ],
            "server_name_prefix": "server-name-prefix",
            "state": "IN_SERVICE",
            "subnet_ids": [],
            "vpc_id": "cc976b621087484ea5fd527f4b78708b"
        }
    ],
    "count": 20
}

4.1.51.3 - 1.0

get /v1/auto-scaling-groups

Description

Auto-Scaling Group 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
query	name optional	Auto-Scaling Group 이름 Example : `auto-scaling-group-name`	any of [string, null]	None
query	state optional	Auto-Scaling Group 상태 Example : `IN_SERVICE`	any of [string, null]	None
query	launch_configuration_id optional	Launch Configuration ID Example : `b5aea5a675fc4f6b9e0fcd1288354c5f`	any of [string, null]	None
query	launch_configuration_name optional	Launch Configuration 이름 Example : `launch-configuration-name`	any of [string, null]	None
query	lb_server_group_id optional	LB 서버 그룹 ID Example : `d06e87d3-ca9a-461b-8e88-077a542a7335`	any of [string, null]	None
query	security_group_id optional	Security Group ID Example : `c09c3f05-03d9-443f-b27a-40e0f973c75f`	any of [string, null]	None
query	subnet_id optional	서브넷 ID Example : `78b2ee3f074145c580ab6abac4821f97`	any of [string, null]	None
query	vpc_id optional	VPC ID Example : `cc976b621087484ea5fd527f4b78708b`	any of [string, null]	None
query	created_by optional	생성자 ID Example : `97e6b22c9a4143789ca522df7457a32f`	any of [string, null]	None
query	offset optional	목록에서 시작할 지점의 인덱스 Example : `0`	any of [integer, null]	0
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	20
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:desc`	any of [string, null]	created_at:desc,id:desc

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/auto-scaling-groups

Request header

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

Example HTTP response

Response 200

{
    "auto_scaling_groups": [
        {
            "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "desired_server_count": 1,
            "desired_server_count_editable": true,
            "drain_enabled": true,
            "drain_timeout": 300,
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
            "launch_configuration_name": "launch-configuration-name",
            "lb_server_groups": [],
            "max_server_count": 2,
            "min_server_count": 1,
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "auto-scaling-group-name",
            "security_group_ids": [
                "c09c3f05-03d9-443f-b27a-40e0f973c75f"
            ],
            "server_name_prefix": "server-name-prefix",
            "state": "IN_SERVICE",
            "subnet_ids": [],
            "vpc_id": "cc976b621087484ea5fd527f4b78708b"
        }
    ],
    "count": 20
}

4.1.52 - List Default Configs

4.1.52.1 - 1.2

get /v1/default-configs

Description

자원 사용량에 대한 제한, 임계치 등 기본 설정값 목록을 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
query	name optional	이름 Example : `key`	any of [string, null]	None
query	category optional	분류 Example : `AUTO_SCALING_GROUP`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	DefaultConfigListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/default-configs

Request header

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

Example HTTP response

Response 200

{
    "configs": "('key': 'value'}",
    "count": 20
}

4.1.52.2 - 1.1

get /v1/default-configs

Description

자원 사용량에 대한 제한, 임계치 등 기본 설정값 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
query	name optional	이름 Example : `key`	any of [string, null]	None
query	category optional	분류 Example : `AUTO_SCALING_GROUP`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	DefaultConfigListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/default-configs

Request header

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

Example HTTP response

Response 200

{
    "configs": "('key': 'value'}",
    "count": 20
}

4.1.52.3 - 1.0

get /v1/default-configs

Description

자원 사용량에 대한 제한, 임계치 등 기본 설정값 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
query	name optional	이름 Example : `key`	any of [string, null]	None
query	category optional	분류 Example : `AUTO_SCALING_GROUP`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	DefaultConfigListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/default-configs

Request header

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

Example HTTP response

Response 200

{
    "configs": "('key': 'value'}",
    "count": 20
}

4.1.53 - List Image members

4.1.53.1 - 1.2

get /v1/images/{image_id}/members

Description

이미지 원본 Owner가 공유하고 있는 어카운트 멤버들의 목록을 조회합니다.

어카운트 간에 이미지 공유를 요청할 수 있습니다.
이미지 멤버는 이미지에 대한 읽기 전용 권한을 가집니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ImageMemberListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/images/{image_id}/members

Request header

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

Example HTTP response

Response 200

{
    "members": [
        {
            "created_at": "2025-07-22T09:00:00Z",
            "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
            "member_id": "a8f10467abfc4b87b64614ab36eb9ae4",
            "status": "pending",
            "updated_at": "2025-07-26T12:00:00Z"
        }
    ]
}

4.1.53.2 - 1.1

get /v1/images/{image_id}/members

Description

이미지 원본 Owner가 공유하고 있는 어카운트 멤버들의 목록을 조회합니다.

어카운트 간에 이미지 공유를 요청할 수 있습니다.
이미지 멤버는 이미지에 대한 읽기 전용 권한을 가집니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ImageMemberListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/images/{image_id}/members

Request header

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

Example HTTP response

Response 200

{
    "members": [
        {
            "created_at": "2025-07-22T09:00:00Z",
            "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
            "member_id": "a8f10467abfc4b87b64614ab36eb9ae4",
            "status": "pending",
            "updated_at": "2025-07-26T12:00:00Z"
        }
    ]
}

4.1.53.3 - 1.0

get /v1/images/{image_id}/members

Description

이미지 원본 Owner가 공유하고 있는 어카운트 멤버들의 목록을 조회합니다.

어카운트 간에 이미지 공유를 요청할 수 있습니다.
이미지 멤버는 이미지에 대한 읽기 전용 권한을 가집니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ImageMemberListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/images/{image_id}/members

Request header

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

Example HTTP response

Response 200

{
    "members": [
        {
            "created_at": "2025-07-22T09:00:00Z",
            "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
            "member_id": "a8f10467abfc4b87b64614ab36eb9ae4",
            "status": "pending",
            "updated_at": "2025-07-26T12:00:00Z"
        }
    ]
}

4.1.54 - List Images

4.1.54.1 - 1.2

get /v1/images

Description

이미지 목록을 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	20
query	marker optional	이전 요청에서 마지막으로 반환된 항목 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	any of [string, null]	None
query	scp_image_type optional	이미지 타입 Example : `custom`	any of [string, null]	None
query	scp_original_image_type optional	원본 이미지 타입 Example : `standard`	any of [string, null]	None
query	name optional	이미지 이름 Example : `imagename`	any of [string, null]	None
query	os_distro optional	업로드할 이미지의 OS 배포판 Example : `alma`	any of [string, null]	None
query	status optional	이미지 상태 Example : `active`	any of [string, null]	None
query	visibility optional	이미지에 대한 권한을 나타냅니다. 비공개: 계정 내에서만 사용 가능, 공유: 계정 간에 공유 가능 Example : `private`	any of [enum (public, community, shared, private), null]	None
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:desc`	any of [string, null]	created_at:desc

Responses

HTTP Code	Description	Schema
200	OK	ImageListResponseV1Dot2
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/images

Request header

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

Example HTTP response

Response 200

{
    "images": [
        {
            "checksum": "7538e0fcb56e0e272cfd89eb384d6613",
            "container_format": "bare",
            "created_at": "2025-07-22T09:00:00Z",
            "disk_format": "qcow2",
            "file": "/v2/images/e08a37c1-2162-416e-b7fa-19902419170b/file",
            "id": "70a599e0-31e7-49b7-b260-868f441e862b",
            "min_disk": 100,
            "min_ram": 0,
            "name": "imagename",
            "os_distro": "alma",
            "os_hash_algo": "sha512",
            "os_hash_value": "c6a32fc3b7c909b8900b46f5e6066c028a1d799c0a263cf064a600c430a714627c21f98ac248e2f2bf29870a1a2773c7908244745016878e1a5f31dc2c405b99",
            "os_hidden": false,
            "owner": "a8f10467abfc4b87b64614ab36eb9ae4",
            "owner_account_name": "AccountName",
            "owner_user_name": "user@samsung.com",
            "protected": false,
            "root_device_name": "/dev/vda",
            "scp_gpu_driver": "535.183.06",
            "scp_image_type": "custom",
            "scp_k8s_version": "v1.28.7",
            "scp_original_image_type": "standard",
            "scp_os_build_version": "20250101",
            "scp_os_version": "8.8",
            "size": 2429747200,
            "status": "active",
            "updated_at": "2025-07-26T12:00:00Z",
            "url": "https://object-store.kr-west1.s.samsungsdscloud.com/8989447062e04a818baf9e073fd04fa7/bucket/object.qcow2",
            "virtual_size": 17179869184,
            "visibility": "private",
            "volumes": "[{\"tag\": null, \"volume_id\": null, \"encryption_options\": null, \"encryption_secret_uuid\": null, \"encryption_format\": null, \"device_name\": \"/dev/vda\", \"disk_bus\": \"virtio\", \"volume_type\": null, \"encrypted\": null, \"image_id\": null, \"device_type\": \"disk\", \"source_type\": \"snapshot\", \"delete_on_termination\": false, \"volume_size\": 104, \"guest_format\": null, \"boot_index\": 0, \"destination_type\": \"volume\", \"snapshot_id\": \"abde9e38-2ed5-4ecd-b23c-b0120e30690e\", \"no_device\": null}]"
        }
    ]
}

4.1.54.2 - 1.1

get /v1/images

Description

이미지 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	20
query	marker optional	이전 요청에서 마지막으로 반환된 항목 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	any of [string, null]	None
query	scp_image_type optional	이미지 타입 Example : `custom`	any of [string, null]	None
query	scp_original_image_type optional	원본 이미지 타입 Example : `standard`	any of [string, null]	None
query	name optional	이미지 이름 Example : `imagename`	any of [string, null]	None
query	os_distro optional	업로드할 이미지의 OS 배포판 Example : `alma`	any of [string, null]	None
query	status optional	이미지 상태 Example : `active`	any of [string, null]	None
query	visibility optional	이미지에 대한 권한을 나타냅니다. 비공개: 계정 내에서만 사용 가능, 공유: 계정 간에 공유 가능 Example : `private`	any of [enum (public, community, shared, private), null]	None
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:desc`	any of [string, null]	created_at:desc

Responses

HTTP Code	Description	Schema
200	OK	ImageListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/images

Request header

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

Example HTTP response

Response 200

{
    "images": [
        {
            "checksum": "7538e0fcb56e0e272cfd89eb384d6613",
            "container_format": "bare",
            "created_at": "2025-07-22T09:00:00Z",
            "disk_format": "qcow2",
            "file": "/v2/images/e08a37c1-2162-416e-b7fa-19902419170b/file",
            "id": "70a599e0-31e7-49b7-b260-868f441e862b",
            "min_disk": 100,
            "min_ram": 0,
            "name": "imagename",
            "os_distro": "alma",
            "os_hash_algo": "sha512",
            "os_hash_value": "c6a32fc3b7c909b8900b46f5e6066c028a1d799c0a263cf064a600c430a714627c21f98ac248e2f2bf29870a1a2773c7908244745016878e1a5f31dc2c405b99",
            "os_hidden": false,
            "owner": "a8f10467abfc4b87b64614ab36eb9ae4",
            "owner_account_name": "AccountName",
            "owner_user_name": "user@samsung.com",
            "protected": false,
            "root_device_name": "/dev/vda",
            "scp_image_type": "custom",
            "scp_k8s_version": "v1.28.7",
            "scp_original_image_type": "standard",
            "scp_os_build_version": "20250101",
            "scp_os_version": "8.8",
            "size": 2429747200,
            "status": "active",
            "updated_at": "2025-07-26T12:00:00Z",
            "url": "https://object-store.kr-west1.s.samsungsdscloud.com/8989447062e04a818baf9e073fd04fa7/bucket/object.qcow2",
            "virtual_size": 17179869184,
            "visibility": "private",
            "volumes": "[{\"tag\": null, \"volume_id\": null, \"encryption_options\": null, \"encryption_secret_uuid\": null, \"encryption_format\": null, \"device_name\": \"/dev/vda\", \"disk_bus\": \"virtio\", \"volume_type\": null, \"encrypted\": null, \"image_id\": null, \"device_type\": \"disk\", \"source_type\": \"snapshot\", \"delete_on_termination\": false, \"volume_size\": 104, \"guest_format\": null, \"boot_index\": 0, \"destination_type\": \"volume\", \"snapshot_id\": \"abde9e38-2ed5-4ecd-b23c-b0120e30690e\", \"no_device\": null}]"
        }
    ]
}

4.1.54.3 - 1.0

get /v1/images

Description

이미지 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	20
query	marker optional	이전 요청에서 마지막으로 반환된 항목 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	any of [string, null]	None
query	scp_image_type optional	이미지 타입 Example : `custom`	any of [string, null]	None
query	scp_original_image_type optional	원본 이미지 타입 Example : `standard`	any of [string, null]	None
query	name optional	이미지 이름 Example : `imagename`	any of [string, null]	None
query	os_distro optional	업로드할 이미지의 OS 배포판 Example : `alma`	any of [string, null]	None
query	status optional	이미지 상태 Example : `active`	any of [string, null]	None
query	visibility optional	이미지에 대한 권한을 나타냅니다. 비공개: 계정 내에서만 사용 가능, 공유: 계정 간에 공유 가능 Example : `private`	any of [enum (public, community, shared, private), null]	None
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:desc`	any of [string, null]	created_at:desc

Responses

HTTP Code	Description	Schema
200	OK	ImageListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/images

Request header

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

Example HTTP response

Response 200

{
    "images": [
        {
            "checksum": "7538e0fcb56e0e272cfd89eb384d6613",
            "container_format": "bare",
            "created_at": "2025-07-22T09:00:00Z",
            "disk_format": "qcow2",
            "file": "/v2/images/e08a37c1-2162-416e-b7fa-19902419170b/file",
            "id": "70a599e0-31e7-49b7-b260-868f441e862b",
            "min_disk": 100,
            "min_ram": 0,
            "name": "imagename",
            "os_distro": "alma",
            "os_hash_algo": "sha512",
            "os_hash_value": "c6a32fc3b7c909b8900b46f5e6066c028a1d799c0a263cf064a600c430a714627c21f98ac248e2f2bf29870a1a2773c7908244745016878e1a5f31dc2c405b99",
            "os_hidden": false,
            "owner": "a8f10467abfc4b87b64614ab36eb9ae4",
            "owner_account_name": "AccountName",
            "owner_user_name": "user@samsung.com",
            "protected": false,
            "root_device_name": "/dev/vda",
            "scp_image_type": "custom",
            "scp_k8s_version": "v1.28.7",
            "scp_original_image_type": "standard",
            "scp_os_build_version": "20250101",
            "scp_os_version": "8.8",
            "size": 2429747200,
            "status": "active",
            "updated_at": "2025-07-26T12:00:00Z",
            "url": "https://object-store.kr-west1.s.samsungsdscloud.com/8989447062e04a818baf9e073fd04fa7/bucket/object.qcow2",
            "virtual_size": 17179869184,
            "visibility": "private",
            "volumes": "[{\"tag\": null, \"volume_id\": null, \"encryption_options\": null, \"encryption_secret_uuid\": null, \"encryption_format\": null, \"device_name\": \"/dev/vda\", \"disk_bus\": \"virtio\", \"volume_type\": null, \"encrypted\": null, \"image_id\": null, \"device_type\": \"disk\", \"source_type\": \"snapshot\", \"delete_on_termination\": false, \"volume_size\": 104, \"guest_format\": null, \"boot_index\": 0, \"destination_type\": \"volume\", \"snapshot_id\": \"abde9e38-2ed5-4ecd-b23c-b0120e30690e\", \"no_device\": null}]"
        }
    ]
}

4.1.55 - List Keypairs

4.1.55.1 - 1.2

get /v1/keypairs

Description

키페어 목록을 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	None
query	marker optional	이전 요청에서 마지막으로 반환된 항목 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	KeypairListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/keypairs

Request header

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

Example HTTP response

Response 200

{
    "keypairs": [
        {
            "fingerprint": "7e:eb:ab:24:ba:d1:e1:88:ae:9a:fb:66:53:df:d3:bd",
            "name": "keypairname",
            "public_key": "ssh-rsa fakeKey Generated-by-SCP",
            "type": "ssh"
        }
    ]
}

4.1.55.2 - 1.1

get /v1/keypairs

Description

키페어 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	None
query	marker optional	이전 요청에서 마지막으로 반환된 항목 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	KeypairListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/keypairs

Request header

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

Example HTTP response

Response 200

{
    "keypairs": [
        {
            "fingerprint": "7e:eb:ab:24:ba:d1:e1:88:ae:9a:fb:66:53:df:d3:bd",
            "name": "keypairname",
            "public_key": "ssh-rsa fakeKey Generated-by-SCP",
            "type": "ssh"
        }
    ]
}

4.1.55.3 - 1.0

get /v1/keypairs

Description

키페어 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	None
query	marker optional	이전 요청에서 마지막으로 반환된 항목 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	KeypairListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/keypairs

Request header

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

Example HTTP response

Response 200

{
    "keypairs": [
        {
            "fingerprint": "7e:eb:ab:24:ba:d1:e1:88:ae:9a:fb:66:53:df:d3:bd",
            "name": "keypairname",
            "public_key": "ssh-rsa fakeKey Generated-by-SCP",
            "type": "ssh"
        }
    ]
}

4.1.56 - List Launch Configurations

4.1.56.1 - 1.2

get /v1/launch-configurations

Description

Launch Configuration 목록을 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
query	name optional	Launch Configuration 이름 Example : `launch-configuration-name`	any of [string, null]
query	image_id optional	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	any of [string, null]	None
query	offset optional	목록에서 시작할 지점의 인덱스 Example : `0`	any of [integer, null]	0
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	20
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:asc`	any of [string, null]	created_at:asc

Responses

HTTP Code	Description	Schema
200	OK	LaunchConfigurationListResponseV1Dot2
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/launch-configurations

Request header

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

Example HTTP response

Response 200

{
    "count": 20,
    "launch_configurations": [
        {
            "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
            "auto_scaling_group_count": 1,
            "boot_disk_size": 104,
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "extra_disk_size": 104,
            "file_storage_ids": [
                ""
            ],
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
            "image_name": "imagename",
            "keypair_name": "keypairname",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "launch-configuration-name",
            "public_key": "ssh-rsa fakeKey Generated-by-SCP",
            "server_type_id": "s1v1m2",
            "state": "ACTIVE",
            "user_data": "IyEvYmluL2Jhc2gKL2Jpbi9zdQplY2hvICJJIGFtIGluIHlvdSEiCg==",
            "volumes": [
                {
                    "boot_index": 0,
                    "size": 104,
                    "type": "SSD"
                }
            ]
        }
    ]
}

4.1.56.2 - 1.1

get /v1/launch-configurations

Description

Launch Configuration 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
query	name optional	Launch Configuration 이름 Example : `launch-configuration-name`	any of [string, null]
query	image_id optional	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	any of [string, null]	None
query	offset optional	목록에서 시작할 지점의 인덱스 Example : `0`	any of [integer, null]	0
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	20
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:asc`	any of [string, null]	created_at:asc

Responses

HTTP Code	Description	Schema
200	OK	LaunchConfigurationListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/launch-configurations

Request header

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

Example HTTP response

Response 200

{
    "count": 20,
    "launch_configurations": [
        {
            "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
            "auto_scaling_group_count": 1,
            "boot_disk_size": 104,
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "extra_disk_size": 104,
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
            "image_name": "imagename",
            "keypair_name": "keypairname",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "launch-configuration-name",
            "public_key": "ssh-rsa fakeKey Generated-by-SCP",
            "server_type_id": "s1v1m2",
            "state": "ACTIVE",
            "user_data": "IyEvYmluL2Jhc2gKL2Jpbi9zdQplY2hvICJJIGFtIGluIHlvdSEiCg==",
            "volumes": [
                {
                    "boot_index": 0,
                    "size": 104,
                    "type": "SSD"
                }
            ]
        }
    ]
}

4.1.56.3 - 1.0

get /v1/launch-configurations

Description

Launch Configuration 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
query	name optional	Launch Configuration 이름 Example : `launch-configuration-name`	any of [string, null]
query	image_id optional	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	any of [string, null]	None
query	offset optional	목록에서 시작할 지점의 인덱스 Example : `0`	any of [integer, null]	0
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	20
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:asc`	any of [string, null]	created_at:asc

Responses

HTTP Code	Description	Schema
200	OK	LaunchConfigurationListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/launch-configurations

Request header

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

Example HTTP response

Response 200

{
    "count": 20,
    "launch_configurations": [
        {
            "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
            "auto_scaling_group_count": 1,
            "boot_disk_size": 104,
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "extra_disk_size": 104,
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
            "image_name": "imagename",
            "keypair_name": "keypairname",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "launch-configuration-name",
            "public_key": "ssh-rsa fakeKey Generated-by-SCP",
            "server_type_id": "s1v1m2",
            "state": "ACTIVE",
            "user_data": "IyEvYmluL2Jhc2gKL2Jpbi9zdQplY2hvICJJIGFtIGluIHlvdSEiCg==",
            "volumes": [
                {
                    "boot_index": 0,
                    "size": 104,
                    "type": "SSD"
                }
            ]
        }
    ]
}

4.1.57 - List pending Images

4.1.57.1 - 1.2

get /v1/pending-images

Description

공유 대기 중인 이미지 목록을 조회합니다.

어카운트 간에 이미지 공유를 요청할 수 있습니다.
이미지를 공유받은 멤버 어카운트는 공유 대기 목록을 확인하여, 수락 혹은 거절을 결정할 수 있습니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
query	scp_image_type optional	이미지 타입 Example : `custom`	any of [string, null]	None
query	scp_original_image_type optional	원본 이미지 타입 Example : `standard`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ImageListResponseV1Dot2
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/pending-images

Request header

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

Example HTTP response

Response 200

{
    "images": [
        {
            "checksum": "7538e0fcb56e0e272cfd89eb384d6613",
            "container_format": "bare",
            "created_at": "2025-07-22T09:00:00Z",
            "disk_format": "qcow2",
            "file": "/v2/images/e08a37c1-2162-416e-b7fa-19902419170b/file",
            "id": "70a599e0-31e7-49b7-b260-868f441e862b",
            "min_disk": 100,
            "min_ram": 0,
            "name": "imagename",
            "os_distro": "alma",
            "os_hash_algo": "sha512",
            "os_hash_value": "c6a32fc3b7c909b8900b46f5e6066c028a1d799c0a263cf064a600c430a714627c21f98ac248e2f2bf29870a1a2773c7908244745016878e1a5f31dc2c405b99",
            "os_hidden": false,
            "owner": "a8f10467abfc4b87b64614ab36eb9ae4",
            "owner_account_name": "AccountName",
            "owner_user_name": "user@samsung.com",
            "protected": false,
            "root_device_name": "/dev/vda",
            "scp_gpu_driver": "535.183.06",
            "scp_image_type": "custom",
            "scp_k8s_version": "v1.28.7",
            "scp_original_image_type": "standard",
            "scp_os_build_version": "20250101",
            "scp_os_version": "8.8",
            "size": 2429747200,
            "status": "active",
            "updated_at": "2025-07-26T12:00:00Z",
            "url": "https://object-store.kr-west1.s.samsungsdscloud.com/8989447062e04a818baf9e073fd04fa7/bucket/object.qcow2",
            "virtual_size": 17179869184,
            "visibility": "private",
            "volumes": "[{\"tag\": null, \"volume_id\": null, \"encryption_options\": null, \"encryption_secret_uuid\": null, \"encryption_format\": null, \"device_name\": \"/dev/vda\", \"disk_bus\": \"virtio\", \"volume_type\": null, \"encrypted\": null, \"image_id\": null, \"device_type\": \"disk\", \"source_type\": \"snapshot\", \"delete_on_termination\": false, \"volume_size\": 104, \"guest_format\": null, \"boot_index\": 0, \"destination_type\": \"volume\", \"snapshot_id\": \"abde9e38-2ed5-4ecd-b23c-b0120e30690e\", \"no_device\": null}]"
        }
    ]
}

4.1.57.2 - 1.1

get /v1/pending-images

Description

공유 대기 중인 이미지 목록을 조회합니다.

어카운트 간에 이미지 공유를 요청할 수 있습니다.
이미지를 공유받은 멤버 어카운트는 공유 대기 목록을 확인하여, 수락 혹은 거절을 결정할 수 있습니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
query	scp_image_type optional	이미지 타입 Example : `custom`	any of [string, null]	None
query	scp_original_image_type optional	원본 이미지 타입 Example : `standard`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ImageListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/pending-images

Request header

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

Example HTTP response

Response 200

{
    "images": [
        {
            "checksum": "7538e0fcb56e0e272cfd89eb384d6613",
            "container_format": "bare",
            "created_at": "2025-07-22T09:00:00Z",
            "disk_format": "qcow2",
            "file": "/v2/images/e08a37c1-2162-416e-b7fa-19902419170b/file",
            "id": "70a599e0-31e7-49b7-b260-868f441e862b",
            "min_disk": 100,
            "min_ram": 0,
            "name": "imagename",
            "os_distro": "alma",
            "os_hash_algo": "sha512",
            "os_hash_value": "c6a32fc3b7c909b8900b46f5e6066c028a1d799c0a263cf064a600c430a714627c21f98ac248e2f2bf29870a1a2773c7908244745016878e1a5f31dc2c405b99",
            "os_hidden": false,
            "owner": "a8f10467abfc4b87b64614ab36eb9ae4",
            "owner_account_name": "AccountName",
            "owner_user_name": "user@samsung.com",
            "protected": false,
            "root_device_name": "/dev/vda",
            "scp_image_type": "custom",
            "scp_k8s_version": "v1.28.7",
            "scp_original_image_type": "standard",
            "scp_os_build_version": "20250101",
            "scp_os_version": "8.8",
            "size": 2429747200,
            "status": "active",
            "updated_at": "2025-07-26T12:00:00Z",
            "url": "https://object-store.kr-west1.s.samsungsdscloud.com/8989447062e04a818baf9e073fd04fa7/bucket/object.qcow2",
            "virtual_size": 17179869184,
            "visibility": "private",
            "volumes": "[{\"tag\": null, \"volume_id\": null, \"encryption_options\": null, \"encryption_secret_uuid\": null, \"encryption_format\": null, \"device_name\": \"/dev/vda\", \"disk_bus\": \"virtio\", \"volume_type\": null, \"encrypted\": null, \"image_id\": null, \"device_type\": \"disk\", \"source_type\": \"snapshot\", \"delete_on_termination\": false, \"volume_size\": 104, \"guest_format\": null, \"boot_index\": 0, \"destination_type\": \"volume\", \"snapshot_id\": \"abde9e38-2ed5-4ecd-b23c-b0120e30690e\", \"no_device\": null}]"
        }
    ]
}

4.1.57.3 - 1.0

get /v1/pending-images

Description

공유 대기 중인 이미지 목록을 조회합니다.

어카운트 간에 이미지 공유를 요청할 수 있습니다.
이미지를 공유받은 멤버 어카운트는 공유 대기 목록을 확인하여, 수락 혹은 거절을 결정할 수 있습니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
query	scp_image_type optional	이미지 타입 Example : `custom`	any of [string, null]	None
query	scp_original_image_type optional	원본 이미지 타입 Example : `standard`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ImageListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/pending-images

Request header

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

Example HTTP response

Response 200

{
    "images": [
        {
            "checksum": "7538e0fcb56e0e272cfd89eb384d6613",
            "container_format": "bare",
            "created_at": "2025-07-22T09:00:00Z",
            "disk_format": "qcow2",
            "file": "/v2/images/e08a37c1-2162-416e-b7fa-19902419170b/file",
            "id": "70a599e0-31e7-49b7-b260-868f441e862b",
            "min_disk": 100,
            "min_ram": 0,
            "name": "imagename",
            "os_distro": "alma",
            "os_hash_algo": "sha512",
            "os_hash_value": "c6a32fc3b7c909b8900b46f5e6066c028a1d799c0a263cf064a600c430a714627c21f98ac248e2f2bf29870a1a2773c7908244745016878e1a5f31dc2c405b99",
            "os_hidden": false,
            "owner": "a8f10467abfc4b87b64614ab36eb9ae4",
            "owner_account_name": "AccountName",
            "owner_user_name": "user@samsung.com",
            "protected": false,
            "root_device_name": "/dev/vda",
            "scp_image_type": "custom",
            "scp_k8s_version": "v1.28.7",
            "scp_original_image_type": "standard",
            "scp_os_build_version": "20250101",
            "scp_os_version": "8.8",
            "size": 2429747200,
            "status": "active",
            "updated_at": "2025-07-26T12:00:00Z",
            "url": "https://object-store.kr-west1.s.samsungsdscloud.com/8989447062e04a818baf9e073fd04fa7/bucket/object.qcow2",
            "virtual_size": 17179869184,
            "visibility": "private",
            "volumes": "[{\"tag\": null, \"volume_id\": null, \"encryption_options\": null, \"encryption_secret_uuid\": null, \"encryption_format\": null, \"device_name\": \"/dev/vda\", \"disk_bus\": \"virtio\", \"volume_type\": null, \"encrypted\": null, \"image_id\": null, \"device_type\": \"disk\", \"source_type\": \"snapshot\", \"delete_on_termination\": false, \"volume_size\": 104, \"guest_format\": null, \"boot_index\": 0, \"destination_type\": \"volume\", \"snapshot_id\": \"abde9e38-2ed5-4ecd-b23c-b0120e30690e\", \"no_device\": null}]"
        }
    ]
}

4.1.58 - List Server Groups

4.1.58.1 - 1.2

get /v1/server-groups

Description

서버 그룹 목록을 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	None
query	offset optional	목록에서 시작할 지점의 인덱스 Example : `0`	any of [integer, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ServerGroupListResponse
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/server-groups

Request header

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

Example HTTP response

Response 200

{
    "server_groups": [
        {
            "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
            "id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
            "members": [
                "2a9be312-5d4b-4bc8-b2ae-35100fa9241f"
            ],
            "name": "server-group",
            "partition_size": 3,
            "policy": "anti-affinity",
            "user_id": "570907805e5447be84b618450ef52o0t"
        }
    ]
}

4.1.58.2 - 1.1

get /v1/server-groups

Description

서버 그룹 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	None
query	offset optional	목록에서 시작할 지점의 인덱스 Example : `0`	any of [integer, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ServerGroupListResponse
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/server-groups

Request header

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

Example HTTP response

Response 200

{
    "server_groups": [
        {
            "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
            "id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
            "members": [
                "2a9be312-5d4b-4bc8-b2ae-35100fa9241f"
            ],
            "name": "server-group",
            "partition_size": 3,
            "policy": "anti-affinity",
            "user_id": "570907805e5447be84b618450ef52o0t"
        }
    ]
}

4.1.58.3 - 1.0

get /v1/server-groups

Description

서버 그룹 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	None
query	offset optional	목록에서 시작할 지점의 인덱스 Example : `0`	any of [integer, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ServerGroupListResponse
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/server-groups

Request header

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

Example HTTP response

Response 200

{
    "server_groups": [
        {
            "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
            "id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
            "members": [
                "2a9be312-5d4b-4bc8-b2ae-35100fa9241f"
            ],
            "name": "server-group",
            "partition_size": 3,
            "policy": "anti-affinity",
            "user_id": "570907805e5447be84b618450ef52o0t"
        }
    ]
}

4.1.59 - List Server Interfaces

4.1.59.1 - 1.2

get /v1/servers/{server_id}/interfaces

Description

서버 인터페이스 목록을 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/interfaces

Request header

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

Example HTTP response

Response 200

{
    "interfaces": [
        {
            "fixed_ips": [
                {
                    "ip_address": "192.169.3.2"
                }
            ],
            "is_default": true,
            "mac_addr": "fa:16:3e:c0:71:2b",
            "port_id": "f2b02fc5-a5fd-4b5f-b1a9-987f4c0d66cc",
            "port_state": "ACTIVE",
            "private_static_nat": {
                "external_ip_address": "182.197.61.81",
                "id": "224b80106e6f41b38efe98ac9ddbf280",
                "private_nat_ip_id": "1f0cb5390c40483592ddc5a282f53496",
                "state": "ACTIVE"
            },
            "static_nat": {
                "external_ip_address": "182.197.61.81",
                "id": "224b80106e6f41b38efe98ac9ddbf280",
                "publicip_id": "615fa9cd5cff486c9de679b3ce63e601",
                "state": "ACTIVE"
            },
            "subnet_id": "183c6c30df0c4fcbb16422aa2d64aa21"
        }
    ]
}

4.1.59.2 - 1.1

get /v1/servers/{server_id}/interfaces

Description

서버 인터페이스 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/interfaces

Request header

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

Example HTTP response

Response 200

{
    "interfaces": [
        {
            "fixed_ips": [
                {
                    "ip_address": "192.169.3.2"
                }
            ],
            "mac_addr": "fa:16:3e:c0:71:2b",
            "port_id": "f2b02fc5-a5fd-4b5f-b1a9-987f4c0d66cc",
            "port_state": "ACTIVE",
            "private_static_nat": {
                "external_ip_address": "182.197.61.81",
                "id": "224b80106e6f41b38efe98ac9ddbf280",
                "private_nat_ip_id": "1f0cb5390c40483592ddc5a282f53496",
                "state": "ACTIVE"
            },
            "static_nat": {
                "external_ip_address": "182.197.61.81",
                "id": "224b80106e6f41b38efe98ac9ddbf280",
                "publicip_id": "615fa9cd5cff486c9de679b3ce63e601",
                "state": "ACTIVE"
            },
            "subnet_id": "183c6c30df0c4fcbb16422aa2d64aa21"
        }
    ]
}

4.1.59.3 - 1.0

get /v1/servers/{server_id}/interfaces

Description

서버 인터페이스 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/interfaces

Request header

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

Example HTTP response

Response 200

{
    "interfaces": [
        {
            "fixed_ips": [
                {
                    "ip_address": "192.169.3.2"
                }
            ],
            "mac_addr": "fa:16:3e:c0:71:2b",
            "port_id": "f2b02fc5-a5fd-4b5f-b1a9-987f4c0d66cc",
            "port_state": "ACTIVE",
            "private_static_nat": {
                "external_ip_address": "182.197.61.81",
                "id": "224b80106e6f41b38efe98ac9ddbf280",
                "private_nat_ip_id": "1f0cb5390c40483592ddc5a282f53496",
                "state": "ACTIVE"
            },
            "static_nat": {
                "external_ip_address": "182.197.61.81",
                "id": "224b80106e6f41b38efe98ac9ddbf280",
                "publicip_id": "615fa9cd5cff486c9de679b3ce63e601",
                "state": "ACTIVE"
            },
            "subnet_id": "183c6c30df0c4fcbb16422aa2d64aa21"
        }
    ]
}

4.1.60 - List Server Ips

4.1.60.1 - 1.2

get /v1/servers/{server_id}/ips

Description

서버 IP 목록을 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ServerIpsResponse
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/servers/{server_id}/ips

Request header

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

Example HTTP response

Response 200

{
    "addresses": [
        {
            "ip_addresses": [
                {
                    "ip_address": "192.169.3.2",
                    "version": 4
                }
            ],
            "subnet_name": "subnetname"
        }
    ]
}

4.1.60.2 - 1.1

get /v1/servers/{server_id}/ips

Description

서버 IP 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ServerIpsResponse
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/servers/{server_id}/ips

Request header

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

Example HTTP response

Response 200

{
    "addresses": [
        {
            "ip_addresses": [
                {
                    "ip_address": "192.169.3.2",
                    "version": 4
                }
            ],
            "subnet_name": "subnetname"
        }
    ]
}

4.1.60.3 - 1.0

get /v1/servers/{server_id}/ips

Description

서버 IP 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ServerIpsResponse
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/servers/{server_id}/ips

Request header

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

Example HTTP response

Response 200

{
    "addresses": [
        {
            "ip_addresses": [
                {
                    "ip_address": "192.169.3.2",
                    "version": 4
                }
            ],
            "subnet_name": "subnetname"
        }
    ]
}

4.1.61 - List Server Types

4.1.61.1 - 1.2

get /v1/server-types

Description

서버 타입 목록을 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
query	limit optional	페이지 항목 개수 Example : `20`	integer	None
query	marker optional	이전 요청에서 마지막으로 반환된 항목 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
query	min_disk optional	최소 디스크 크기 Example : `0`	integer	None
query	min_ram optional	최소 램 크기 Example : `2048`	integer	None
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:desc`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ServerTypeListResponse
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/server-types

Request header

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

Example HTTP response

Response 200

{
    "server_types": [
        {
            "description": "description",
            "disk": 100,
            "ephemeral": 0,
            "extra_specs": "",
            "id": "s1v1m2",
            "name": "s1v1m2",
            "ram": 2,
            "swap": 0,
            "vcpus": 1
        }
    ]
}

4.1.61.2 - 1.1

get /v1/server-types

Description

서버 타입 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
query	limit optional	페이지 항목 개수 Example : `20`	integer	None
query	marker optional	이전 요청에서 마지막으로 반환된 항목 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
query	min_disk optional	최소 디스크 크기 Example : `0`	integer	None
query	min_ram optional	최소 램 크기 Example : `2048`	integer	None
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:desc`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ServerTypeListResponse
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/server-types

Request header

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

Example HTTP response

Response 200

{
    "server_types": [
        {
            "description": "description",
            "disk": 100,
            "ephemeral": 0,
            "extra_specs": "",
            "id": "s1v1m2",
            "name": "s1v1m2",
            "ram": 2,
            "swap": 0,
            "vcpus": 1
        }
    ]
}

4.1.61.3 - 1.0

get /v1/server-types

Description

서버 타입 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
query	limit optional	페이지 항목 개수 Example : `20`	integer	None
query	marker optional	이전 요청에서 마지막으로 반환된 항목 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
query	min_disk optional	최소 디스크 크기 Example : `0`	integer	None
query	min_ram optional	최소 램 크기 Example : `2048`	integer	None
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:desc`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ServerTypeListResponse
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/server-types

Request header

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

Example HTTP response

Response 200

{
    "server_types": [
        {
            "description": "description",
            "disk": 100,
            "ephemeral": 0,
            "extra_specs": "",
            "id": "s1v1m2",
            "name": "s1v1m2",
            "ram": 2,
            "swap": 0,
            "vcpus": 1
        }
    ]
}

4.1.62 - List Server Volumes

4.1.62.1 - 1.2

get /v1/servers/{server_id}/volumes

Description

서버 볼륨 목록을 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/volumes

Request header

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

Example HTTP response

Response 200

{
    "volumes": [
        {
            "delete_on_termination": false,
            "device": "/dev/vda",
            "id": "3ad1cc18-1b09-4f51-9b1d-4ce4243f6a4c",
            "server_id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
            "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
        }
    ]
}

4.1.62.2 - 1.1

get /v1/servers/{server_id}/volumes

Description

서버 볼륨 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/volumes

Request header

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

Example HTTP response

Response 200

{
    "volumes": [
        {
            "delete_on_termination": false,
            "device": "/dev/vda",
            "id": "3ad1cc18-1b09-4f51-9b1d-4ce4243f6a4c",
            "server_id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
            "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
        }
    ]
}

4.1.62.3 - 1.0

get /v1/servers/{server_id}/volumes

Description

서버 볼륨 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/volumes

Request header

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

Example HTTP response

Response 200

{
    "volumes": [
        {
            "delete_on_termination": false,
            "device": "/dev/vda",
            "id": "3ad1cc18-1b09-4f51-9b1d-4ce4243f6a4c",
            "server_id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
            "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
        }
    ]
}

4.1.63 - List snapshots

4.1.63.1 - 1.2

get /v1/snapshots

Description

Snapshot 목록을 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
query	volume_id optional	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	any of [string, null]	None
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	None
query	offset optional	목록에서 시작할 지점의 인덱스 Example : `0`	any of [integer, null]	None
query	marker optional	이전 요청에서 마지막으로 반환된 항목 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	any of [string, null]	None
query	with_count optional	총 개수 여부 Example : `True`	any of [boolean, null]	True
query	name optional	스냅샷명 Example : `snapshot-1`	any of [string, null]	None
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:desc`	any of [string, null]	created_at:desc

Responses

HTTP Code	Description	Schema
200	OK	SnapshotListResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/snapshots

Request header

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

Example HTTP response

Response 200

{
    "count": 100,
    "snapshots": [
        {
            "created_at": "2025-07-22T09:00:00Z",
            "description": "description",
            "id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790",
            "metadata": "Metadata",
            "name": "snapshot-1",
            "size": 104,
            "status": "available",
            "updated_at": "2025-07-26T12:00:00Z",
            "user_id": "570907805e5447be84b618450ef52o0t",
            "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
        }
    ]
}

4.1.63.2 - 1.1

get /v1/snapshots

Description

Snapshot 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
query	volume_id optional	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	any of [string, null]	None
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	None
query	offset optional	목록에서 시작할 지점의 인덱스 Example : `0`	any of [integer, null]	None
query	marker optional	이전 요청에서 마지막으로 반환된 항목 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	any of [string, null]	None
query	with_count optional	총 개수 여부 Example : `True`	any of [boolean, null]	True
query	name optional	스냅샷명 Example : `snapshot-1`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	SnapshotListResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/snapshots

Request header

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

Example HTTP response

Response 200

{
    "count": 100,
    "snapshots": [
        {
            "created_at": "2025-07-22T09:00:00Z",
            "description": "description",
            "id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790",
            "metadata": "Metadata",
            "name": "snapshot-1",
            "size": 104,
            "status": "available",
            "updated_at": "2025-07-26T12:00:00Z",
            "user_id": "570907805e5447be84b618450ef52o0t",
            "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
        }
    ]
}

4.1.63.3 - 1.0

get /v1/snapshots

Description

Snapshot 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
query	volume_id optional	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	any of [string, null]	None
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	None
query	offset optional	목록에서 시작할 지점의 인덱스 Example : `0`	any of [integer, null]	None
query	marker optional	이전 요청에서 마지막으로 반환된 항목 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	any of [string, null]	None
query	with_count optional	총 개수 여부 Example : `True`	any of [boolean, null]	True
query	name optional	스냅샷명 Example : `snapshot-1`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	SnapshotListResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/snapshots

Request header

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

Example HTTP response

Response 200

{
    "count": 100,
    "snapshots": [
        {
            "created_at": "2025-07-22T09:00:00Z",
            "description": "description",
            "id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790",
            "metadata": "Metadata",
            "name": "snapshot-1",
            "size": 104,
            "status": "available",
            "updated_at": "2025-07-26T12:00:00Z",
            "user_id": "570907805e5447be84b618450ef52o0t",
            "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
        }
    ]
}

4.1.64 - List Virtual Server Security Group

4.1.64.1 - 1.2

get /v1/servers/{server_id}/security-groups

Description

서버 Security Group 목록을 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ServerSecurityGroupListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/servers/{server_id}/security-groups

Request header

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

Example HTTP response

Response 200

{
    "security_groups": [
        {
            "account_id": "6f70656e737461636b20342065766572",
            "description": "Security group description",
            "id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
            "name": "securitygroup",
            "rules": [
                {
                    "from_port": 1,
                    "id": "ca5cb96b-9df6-4af7-9682-4d60a58d38a5",
                    "ip_protocol": "tcp",
                    "ip_range": {
                        "cidr": "0.0.0.0/0"
                    },
                    "to_port": 65535
                }
            ]
        }
    ]
}

4.1.64.2 - 1.1

get /v1/servers/{server_id}/security-groups

Description

서버 Security Group 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ServerSecurityGroupListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/servers/{server_id}/security-groups

Request header

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

Example HTTP response

Response 200

{
    "security_groups": [
        {
            "account_id": "6f70656e737461636b20342065766572",
            "description": "Security group description",
            "id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
            "name": "securitygroup",
            "rules": [
                {
                    "from_port": 1,
                    "id": "ca5cb96b-9df6-4af7-9682-4d60a58d38a5",
                    "ip_protocol": "tcp",
                    "ip_range": {
                        "cidr": "0.0.0.0/0"
                    },
                    "to_port": 65535
                }
            ]
        }
    ]
}

4.1.64.3 - 1.0

get /v1/servers/{server_id}/security-groups

Description

서버 Security Group 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ServerSecurityGroupListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/servers/{server_id}/security-groups

Request header

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

Example HTTP response

Response 200

{
    "security_groups": [
        {
            "account_id": "6f70656e737461636b20342065766572",
            "description": "Security group description",
            "id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
            "name": "securitygroup",
            "rules": [
                {
                    "from_port": 1,
                    "id": "ca5cb96b-9df6-4af7-9682-4d60a58d38a5",
                    "ip_protocol": "tcp",
                    "ip_range": {
                        "cidr": "0.0.0.0/0"
                    },
                    "to_port": 65535
                }
            ]
        }
    ]
}

4.1.65 - List Virtual Servers

4.1.65.1 - 1.2

get /v1/servers

Description

서버 목록을 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
query	name optional	서버 이름 Example : `servername`	any of [string, null]	None
query	ip optional	IP 주소 Example : `192.169.3.2`	any of [string, null]	None
query	state optional	서버 상태 Example : `ACTIVE`	any of [string, null]	None
query	product_category optional	상품군 Example : `compute`	any of [enum (compute, container), null]	None
query	product_offering optional	상품 Example : `virtual_server`	any of [array[enum (virtual_server, gpu_server, k8s_vm, k8s_gpu_vm)], enum (virtual_server, gpu_server, k8s_vm, k8s_gpu_vm), null]	None
query	vpc_id optional	VPC ID Example : `cc976b621087484ea5fd527f4b78708b`	any of [string, null]	None
query	server_type_id optional	서버 타입 ID Example : `s1v1m2`	any of [string, null]	None
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	None
query	marker optional	이전 요청에서 마지막으로 반환된 항목 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	any of [string, null]	None
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:desc`	any of [string, null]	created_at:desc
query	auto_scaling_group_id optional	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ServerListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/servers

Request header

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

Example HTTP response

Response 200

{
    "servers": [
        {
            "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
            "addresses": [
                {
                    "ip_addresses": [
                        {
                            "ip_address": "192.169.3.2",
                            "version": 4
                        }
                    ],
                    "subnet_name": "subnetname"
                }
            ],
            "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
            "created_at": "2026-04-14T15:06:29.755Z",
            "created_by": "97e6b22c9a4143789ca522df7457a32f",
            "disk_config": "MANUAL",
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
            "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
            "is_marketplace": false,
            "keypair_name": "keypairname",
            "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
            "locked": false,
            "metadata": "",
            "modified_at": "2026-04-14T15:06:29.778Z",
            "name": "servername",
            "partition_number": 1,
            "planned_compute_os_type": "windows",
            "product_category": "compute",
            "product_offering": "virtual_server",
            "security_groups": [
                {
                    "name": "securitygroup"
                }
            ],
            "server_group_id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
            "server_type": {
                "disk": 100,
                "ephemeral": 0,
                "extra_specs": "",
                "id": "s1v1m2",
                "name": "s1v1m2",
                "ram": 2,
                "swap": 0,
                "vcpus": 1
            },
            "state": "ACTIVE",
            "volumes": [
                {
                    "delete_on_termination": false,
                    "id": "3f500f00-ed80-4566-a057-e31760226f9a"
                }
            ],
            "vpc_id": "cc976b621087484ea5fd527f4b78708b"
        }
    ]
}

4.1.65.2 - 1.1

get /v1/servers

Description

서버 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
query	name optional	서버 이름 Example : `servername`	any of [string, null]	None
query	ip optional	IP 주소 Example : `192.169.3.2`	any of [string, null]	None
query	state optional	서버 상태 Example : `ACTIVE`	any of [string, null]	None
query	product_category optional	상품군 Example : `compute`	any of [enum (compute, container), null]	None
query	product_offering optional	상품 Example : `virtual_server`	any of [array[enum (virtual_server, gpu_server, k8s_vm, k8s_gpu_vm)], enum (virtual_server, gpu_server, k8s_vm, k8s_gpu_vm), null]	None
query	vpc_id optional	VPC ID Example : `cc976b621087484ea5fd527f4b78708b`	any of [string, null]	None
query	server_type_id optional	서버 타입 ID Example : `s1v1m2`	any of [string, null]	None
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	None
query	marker optional	이전 요청에서 마지막으로 반환된 항목 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	any of [string, null]	None
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:desc`	any of [string, null]	created_at:desc
query	auto_scaling_group_id optional	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ServerListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/servers

Request header

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

Example HTTP response

Response 200

{
    "servers": [
        {
            "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
            "addresses": [
                {
                    "ip_addresses": [
                        {
                            "ip_address": "192.169.3.2",
                            "version": 4
                        }
                    ],
                    "subnet_name": "subnetname"
                }
            ],
            "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
            "created_at": "2026-04-14T15:06:29.755Z",
            "created_by": "97e6b22c9a4143789ca522df7457a32f",
            "disk_config": "MANUAL",
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
            "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
            "is_marketplace": false,
            "keypair_name": "keypairname",
            "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
            "locked": false,
            "metadata": "",
            "modified_at": "2026-04-14T15:06:29.778Z",
            "name": "servername",
            "partition_number": 1,
            "planned_compute_os_type": "windows",
            "product_category": "compute",
            "product_offering": "virtual_server",
            "security_groups": [
                {
                    "name": "securitygroup"
                }
            ],
            "server_group_id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
            "server_type": {
                "disk": 100,
                "ephemeral": 0,
                "extra_specs": "",
                "id": "s1v1m2",
                "name": "s1v1m2",
                "ram": 2,
                "swap": 0,
                "vcpus": 1
            },
            "state": "ACTIVE",
            "volumes": [
                {
                    "delete_on_termination": false,
                    "id": "3f500f00-ed80-4566-a057-e31760226f9a"
                }
            ],
            "vpc_id": "cc976b621087484ea5fd527f4b78708b"
        }
    ]
}

4.1.65.3 - 1.0

get /v1/servers

Description

서버 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
query	name optional	서버 이름 Example : `servername`	any of [string, null]	None
query	ip optional	IP 주소 Example : `192.169.3.2`	any of [string, null]	None
query	state optional	서버 상태 Example : `ACTIVE`	any of [string, null]	None
query	product_category optional	상품군 Example : `compute`	any of [enum (compute, container), null]	None
query	product_offering optional	상품 Example : `virtual_server`	any of [array[enum (virtual_server, gpu_server, k8s_vm, k8s_gpu_vm)], enum (virtual_server, gpu_server, k8s_vm, k8s_gpu_vm), null]	None
query	vpc_id optional	VPC ID Example : `cc976b621087484ea5fd527f4b78708b`	any of [string, null]	None
query	server_type_id optional	서버 타입 ID Example : `s1v1m2`	any of [string, null]	None
query	limit optional	페이지 항목 개수 Example : `20`	any of [integer, null]	None
query	marker optional	이전 요청에서 마지막으로 반환된 항목 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	any of [string, null]	None
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:desc`	any of [string, null]	created_at:desc
query	auto_scaling_group_id optional	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ServerListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/servers

Request header

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

Example HTTP response

Response 200

{
    "servers": [
        {
            "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
            "addresses": [
                {
                    "ip_addresses": [
                        {
                            "ip_address": "192.169.3.2",
                            "version": 4
                        }
                    ],
                    "subnet_name": "subnetname"
                }
            ],
            "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
            "created_at": "2026-04-14T15:06:29.755Z",
            "created_by": "97e6b22c9a4143789ca522df7457a32f",
            "disk_config": "MANUAL",
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
            "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
            "is_marketplace": false,
            "keypair_name": "keypairname",
            "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
            "locked": false,
            "metadata": "",
            "modified_at": "2026-04-14T15:06:29.778Z",
            "name": "servername",
            "partition_number": 1,
            "planned_compute_os_type": "windows",
            "product_category": "compute",
            "product_offering": "virtual_server",
            "security_groups": [
                {
                    "name": "securitygroup"
                }
            ],
            "server_group_id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
            "server_type": {
                "disk": 100,
                "ephemeral": 0,
                "extra_specs": "",
                "id": "s1v1m2",
                "name": "s1v1m2",
                "ram": 2,
                "swap": 0,
                "vcpus": 1
            },
            "state": "ACTIVE",
            "volumes": [
                {
                    "delete_on_termination": false,
                    "id": "3f500f00-ed80-4566-a057-e31760226f9a"
                }
            ],
            "vpc_id": "cc976b621087484ea5fd527f4b78708b"
        }
    ]
}

4.1.66 - List volume transfers

4.1.66.1 - 1.2

get /v1/volume-transfer

Description

볼륨 이전 목록을 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Responses

HTTP Code	Description	Schema
200	OK	VolumeTransferListResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/volume-transfer

Request header

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

Example HTTP response

Response 200

{
    "transfers": [
        {
            "id": "1ac231be-823b-4a4d-8ff0-aac503a7118a",
            "name": "volume01",
            "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
        }
    ]
}

4.1.66.2 - 1.1

get /v1/volume-transfer

Description

볼륨 이전 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Responses

HTTP Code	Description	Schema
200	OK	VolumeTransferListResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/volume-transfer

Request header

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

Example HTTP response

Response 200

{
    "transfers": [
        {
            "id": "1ac231be-823b-4a4d-8ff0-aac503a7118a",
            "name": "volume01",
            "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
        }
    ]
}

4.1.66.3 - 1.0

get /v1/volume-transfer

Description

볼륨 이전 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Responses

HTTP Code	Description	Schema
200	OK	VolumeTransferListResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/volume-transfer

Request header

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

Example HTTP response

Response 200

{
    "transfers": [
        {
            "id": "1ac231be-823b-4a4d-8ff0-aac503a7118a",
            "name": "volume01",
            "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
        }
    ]
}

4.1.67 - List volume types

4.1.67.1 - 1.2

get /v1/volume-types

Description

볼륨 유형 목록을 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
query	limit optional	페이지 항목 개수. 최대값은 1000입니다. Example : `20`	any of [integer, null]	20
query	offset optional	목록에서 시작할 지점의 인덱스 Example : `0`	any of [integer, null]	None
query	marker optional	이전 요청에서 마지막으로 반환된 항목 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	any of [string, null]	None
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:desc`	any of [string, null]	name:asc

Responses

HTTP Code	Description	Schema
200	OK	VolumeTypeListResponse
400	Bad Request	None
401	Unauthorized	None
500	Internal Server Error	None

Example HTTP request

Request path

/v1/volume-types

Request header

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

Example HTTP response

Response 200

{
    "volume_types": [
        {
            "description": "Volume type description",
            "extra_specs": {
                "multiattach": "<is> True"
            },
            "id": "c643ac35-3aec-43e6-b97a-3d6f666c5207",
            "name": "SSD"
        }
    ]
}

4.1.67.2 - 1.1

get /v1/volume-types

Description

볼륨 유형 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
query	limit optional	페이지 항목 개수. 최대값은 1000입니다. Example : `20`	any of [integer, null]	20
query	offset optional	목록에서 시작할 지점의 인덱스 Example : `0`	any of [integer, null]	None
query	marker optional	이전 요청에서 마지막으로 반환된 항목 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	any of [string, null]	None
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:desc`	any of [string, null]	name:asc

Responses

HTTP Code	Description	Schema
200	OK	VolumeTypeListResponse
400	Bad Request	None
401	Unauthorized	None
500	Internal Server Error	None

Example HTTP request

Request path

/v1/volume-types

Request header

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

Example HTTP response

Response 200

{
    "volume_types": [
        {
            "description": "Volume type description",
            "extra_specs": {
                "multiattach": "<is> True"
            },
            "id": "c643ac35-3aec-43e6-b97a-3d6f666c5207",
            "name": "SSD"
        }
    ]
}

4.1.67.3 - 1.0

get /v1/volume-types

Description

볼륨 유형 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
query	limit optional	페이지 항목 개수. 최대값은 1000입니다. Example : `20`	any of [integer, null]	20
query	offset optional	목록에서 시작할 지점의 인덱스 Example : `0`	any of [integer, null]	None
query	marker optional	이전 요청에서 마지막으로 반환된 항목 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	any of [string, null]	None
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:desc`	any of [string, null]	name:asc

Responses

HTTP Code	Description	Schema
200	OK	VolumeTypeListResponse
400	Bad Request	None
401	Unauthorized	None
500	Internal Server Error	None

Example HTTP request

Request path

/v1/volume-types

Request header

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

Example HTTP response

Response 200

{
    "volume_types": [
        {
            "description": "Volume type description",
            "extra_specs": {
                "multiattach": "<is> True"
            },
            "id": "c643ac35-3aec-43e6-b97a-3d6f666c5207",
            "name": "SSD"
        }
    ]
}

4.1.68 - List volumes

4.1.68.1 - 1.2

get /v1/volumes

Description

볼륨 목록을 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
query	with_count optional	총 개수 여부 Example : `True`	any of [boolean, null]	True
query	limit optional	페이지 항목 개수. 최대값은 1000입니다. Example : `20`	any of [integer, null]	20
query	marker optional	이전 요청에서 마지막으로 반환된 항목 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	any of [string, null]	None
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:desc`	any of [string, null]	None
query	offset optional	목록에서 시작할 지점의 인덱스 Example : `0`	any of [integer, null]	None
query	name optional	볼륨명 Example : `volume01`	any of [string, null]	None
query	state optional	볼륨 상태 Example : `available`	any of [string, null]	None
query	bootable optional	부트 디스크 여부 Example : `False`	any of [boolean, null]	None

Responses

HTTP Code	Description	Schema
200	OK	VolumeListResponseV1Dot2
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/volumes

Request header

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

Example HTTP response

Response 200

{
    "count": 100,
    "volumes": [
        {
            "bootable": false,
            "created_at": "2026-04-14T15:06:31.797Z",
            "encrypted": true,
            "id": "3f500f00-ed80-4566-a057-e31760226f9a",
            "max_iops": 10000,
            "max_throughput": 500,
            "modified_at": "2025-07-26T12:00:00Z",
            "multiattach": false,
            "name": "volume01",
            "servers": [
                {
                    "attached_at": "2026-04-14T15:06:30.712Z",
                    "device": "/dev/vda",
                    "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f"
                }
            ],
            "size": 104,
            "snapshot_id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790",
            "state": "available",
            "user_id": "570907805e5447be84b618450ef52o0t",
            "volume_image_metadata": {
                "checksum": "7538e0fcb56e0e272cfd89eb384d6613",
                "container_format": "bare",
                "disk_format": "qcow2",
                "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
                "image_name": "imagename",
                "min_disk": 100,
                "min_ram": 0,
                "os_distro": "alma",
                "scp_image_type": "custom",
                "scp_k8s_version": "v1.28.7",
                "scp_original_image_type": "standard",
                "signature_verified": false,
                "size": 2429747200
            },
            "volume_type": "SSD",
            "volume_type_id": "c643ac35-3aec-43e6-b97a-3d6f666c5207"
        }
    ]
}

4.1.68.2 - 1.1

get /v1/volumes

Description

볼륨 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
query	with_count optional	총 개수 여부 Example : `True`	any of [boolean, null]	True
query	limit optional	페이지 항목 개수. 최대값은 1000입니다. Example : `20`	any of [integer, null]	20
query	marker optional	이전 요청에서 마지막으로 반환된 항목 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	any of [string, null]	None
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:desc`	any of [string, null]	None
query	offset optional	목록에서 시작할 지점의 인덱스 Example : `0`	any of [integer, null]	None
query	name optional	볼륨명 Example : `volume01`	any of [string, null]	None
query	state optional	볼륨 상태 Example : `available`	any of [string, null]	None
query	bootable optional	부트 디스크 여부 Example : `False`	any of [boolean, null]	None

Responses

HTTP Code	Description	Schema
200	OK	VolumeListResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/volumes

Request header

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

Example HTTP response

Response 200

{
    "count": 100,
    "volumes": [
        {
            "bootable": false,
            "created_at": "2026-04-14T15:06:30.677Z",
            "encrypted": true,
            "id": "3f500f00-ed80-4566-a057-e31760226f9a",
            "modified_at": "2025-07-26T12:00:00Z",
            "multiattach": false,
            "name": "volume01",
            "servers": [
                {
                    "attached_at": "2026-04-14T15:06:30.712Z",
                    "device": "/dev/vda",
                    "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f"
                }
            ],
            "size": 104,
            "snapshot_id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790",
            "state": "available",
            "user_id": "570907805e5447be84b618450ef52o0t",
            "volume_image_metadata": {
                "checksum": "7538e0fcb56e0e272cfd89eb384d6613",
                "container_format": "bare",
                "disk_format": "qcow2",
                "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
                "image_name": "imagename",
                "min_disk": 100,
                "min_ram": 0,
                "os_distro": "alma",
                "scp_image_type": "custom",
                "scp_k8s_version": "v1.28.7",
                "scp_original_image_type": "standard",
                "signature_verified": false,
                "size": 2429747200
            },
            "volume_type": "SSD",
            "volume_type_id": "c643ac35-3aec-43e6-b97a-3d6f666c5207"
        }
    ]
}

4.1.68.3 - 1.0

get /v1/volumes

Description

볼륨 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
query	with_count optional	총 개수 여부 Example : `True`	any of [boolean, null]	True
query	limit optional	페이지 항목 개수. 최대값은 1000입니다. Example : `20`	any of [integer, null]	20
query	marker optional	이전 요청에서 마지막으로 반환된 항목 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	any of [string, null]	None
query	sort optional	쉼표로 구분된 정렬 목록이며 <키>[:<방향>] 형식으로 지정 Example : `created_at:desc`	any of [string, null]	None
query	offset optional	목록에서 시작할 지점의 인덱스 Example : `0`	any of [integer, null]	None
query	name optional	볼륨명 Example : `volume01`	any of [string, null]	None
query	state optional	볼륨 상태 Example : `available`	any of [string, null]	None
query	bootable optional	부트 디스크 여부 Example : `False`	any of [boolean, null]	None

Responses

HTTP Code	Description	Schema
200	OK	VolumeListResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/volumes

Request header

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

Example HTTP response

Response 200

{
    "count": 100,
    "volumes": [
        {
            "bootable": false,
            "created_at": "2026-04-14T15:06:30.677Z",
            "encrypted": true,
            "id": "3f500f00-ed80-4566-a057-e31760226f9a",
            "modified_at": "2025-07-26T12:00:00Z",
            "multiattach": false,
            "name": "volume01",
            "servers": [
                {
                    "attached_at": "2026-04-14T15:06:30.712Z",
                    "device": "/dev/vda",
                    "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f"
                }
            ],
            "size": 104,
            "snapshot_id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790",
            "state": "available",
            "user_id": "570907805e5447be84b618450ef52o0t",
            "volume_image_metadata": {
                "checksum": "7538e0fcb56e0e272cfd89eb384d6613",
                "container_format": "bare",
                "disk_format": "qcow2",
                "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
                "image_name": "imagename",
                "min_disk": 100,
                "min_ram": 0,
                "os_distro": "alma",
                "scp_image_type": "custom",
                "scp_k8s_version": "v1.28.7",
                "scp_original_image_type": "standard",
                "signature_verified": false,
                "size": 2429747200
            },
            "volume_type": "SSD",
            "volume_type_id": "c643ac35-3aec-43e6-b97a-3d6f666c5207"
        }
    ]
}

4.1.69 - Lock Virtual Server

4.1.69.1 - 1.2

post /v1/servers/{server_id}/lock

Description

서버에 Lock을 설정합니다.

Lock을 사용하면 서버 해지/시작/중지 등의 동작을 실행할 수 없도록 하며 실수로 인한 동작을 방지합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/lock

Request header

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

Example HTTP response

Response 202

4.1.69.2 - 1.1

post /v1/servers/{server_id}/lock

Description

서버에 Lock을 설정합니다.

Lock을 사용하면 서버 해지/시작/중지 등의 동작을 실행할 수 없도록 하며 실수로 인한 동작을 방지합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/lock

Request header

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

Example HTTP response

Response 202

4.1.69.3 - 1.0

post /v1/servers/{server_id}/lock

Description

서버에 Lock을 설정합니다.

Lock을 사용하면 서버 해지/시작/중지 등의 동작을 실행할 수 없도록 하며 실수로 인한 동작을 방지합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/lock

Request header

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

Example HTTP response

Response 202

4.1.70 - Reboot Virtual Server

4.1.70.1 - 1.2

post /v1/servers/{server_id}/reboot

Description

서버를 재시작합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
body	body required		ServerRebootRequestBody

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/reboot

Request header

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

Request body

{
    "reboot_type": "SOFT"
}

Example HTTP response

Response 202

4.1.70.2 - 1.1

post /v1/servers/{server_id}/reboot

Description

서버를 재시작합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
body	body required		ServerRebootRequestBody

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/reboot

Request header

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

Request body

{
    "reboot_type": "SOFT"
}

Example HTTP response

Response 202

4.1.70.3 - 1.0

post /v1/servers/{server_id}/reboot

Description

서버를 재시작합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
body	body required		ServerRebootRequestBody

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/reboot

Request header

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

Request body

{
    "reboot_type": "SOFT"
}

Example HTTP response

Response 202

4.1.71 - Rebuild Virtual Server

4.1.71.1 - 1.2

post /v1/servers/{server_id}/rebuild

Description

서버를 재빌드합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/rebuild

Request header

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

Example HTTP response

Response 202

4.1.71.2 - 1.1

post /v1/servers/{server_id}/rebuild

Description

서버를 재빌드합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/rebuild

Request header

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

Example HTTP response

Response 202

4.1.71.3 - 1.0

post /v1/servers/{server_id}/rebuild

Description

서버를 재빌드합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/rebuild

Request header

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

Example HTTP response

Response 202

4.1.72 - Revert Volume to snapshot

4.1.72.1 - 1.2

post /v1/volumes/{volume_id}/revert

Description

볼륨을 최신 스냅샷으로 복구합니다. 이 API는 분리된 볼륨만 복구를 지원하며, 볼륨 상태는 available이어야 합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string	None
body	body required		VolumeRevertRequest

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
401	Unauthorized	None
409	Conflict	None

Example HTTP request

Request path

/v1/volumes/{volume_id}/revert

Request header

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

Request body

{
    "snapshot_id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790"
}

Example HTTP response

Response 202

4.1.72.2 - 1.1

post /v1/volumes/{volume_id}/revert

Description

볼륨을 최신 스냅샷으로 복구합니다. 이 API는 분리된 볼륨만 복구를 지원하며, 볼륨 상태는 available이어야 합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string	None
body	body required		VolumeRevertRequest

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
401	Unauthorized	None
409	Conflict	None

Example HTTP request

Request path

/v1/volumes/{volume_id}/revert

Request header

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

Request body

{
    "snapshot_id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790"
}

Example HTTP response

Response 202

4.1.72.3 - 1.0

post /v1/volumes/{volume_id}/revert

Description

볼륨을 최신 스냅샷으로 복구합니다. 이 API는 분리된 볼륨만 복구를 지원하며, 볼륨 상태는 available이어야 합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string	None
body	body required		VolumeRevertRequest

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
401	Unauthorized	None
409	Conflict	None

Example HTTP request

Request path

/v1/volumes/{volume_id}/revert

Request header

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

Request body

{
    "snapshot_id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790"
}

Example HTTP response

Response 202

4.1.73 - Set Volume Qos

4.1.73.1 - 1.2

put /v1/volumes/{volume_id}/qos

Description

Set Volume Qos

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string	None
body	body required		VolumeSetQosRequest

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
401	Unauthorized	None
409	Conflict	None

Example HTTP request

Request path

/v1/volumes/{volume_id}/qos

Request header

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

Request body

{
    "max_iops": 10000,
    "max_throughput": 500
}

Example HTTP response

Response 202

4.1.74 - Show a snapshot’s details

4.1.74.1 - 1.2

get /v1/snapshots/{snapshot_id}

Description

Snapshot을 상세 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	snapshot_id required	스냅샷 ID Example : `cceed636-1f1e-4bb0-b85c-4e5b9e0bf790`	string	None

Responses

HTTP Code	Description	Schema
200	OK	SnapshotDetailResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/snapshots/{snapshot_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 = virtualserver 1.2"

Example HTTP response

Response 200

{
    "created_at": "2025-07-22T09:00:00Z",
    "description": "description",
    "id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790",
    "metadata": "Metadata",
    "name": "snapshot-1",
    "size": 104,
    "status": "available",
    "updated_at": "2025-07-26T12:00:00Z",
    "user_id": "570907805e5447be84b618450ef52o0t",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

4.1.74.2 - 1.1

get /v1/snapshots/{snapshot_id}

Description

Snapshot을 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	snapshot_id required	스냅샷 ID Example : `cceed636-1f1e-4bb0-b85c-4e5b9e0bf790`	string	None

Responses

HTTP Code	Description	Schema
200	OK	SnapshotDetailResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/snapshots/{snapshot_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 = virtualserver 1.1"

Example HTTP response

Response 200

{
    "created_at": "2025-07-22T09:00:00Z",
    "description": "description",
    "id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790",
    "metadata": "Metadata",
    "name": "snapshot-1",
    "size": 104,
    "status": "available",
    "updated_at": "2025-07-26T12:00:00Z",
    "user_id": "570907805e5447be84b618450ef52o0t",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

4.1.74.3 - 1.0

get /v1/snapshots/{snapshot_id}

Description

Snapshot을 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	snapshot_id required	스냅샷 ID Example : `cceed636-1f1e-4bb0-b85c-4e5b9e0bf790`	string	None

Responses

HTTP Code	Description	Schema
200	OK	SnapshotDetailResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/snapshots/{snapshot_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 = virtualserver 1.0"

Example HTTP response

Response 200

{
    "created_at": "2025-07-22T09:00:00Z",
    "description": "description",
    "id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790",
    "metadata": "Metadata",
    "name": "snapshot-1",
    "size": 104,
    "status": "available",
    "updated_at": "2025-07-26T12:00:00Z",
    "user_id": "570907805e5447be84b618450ef52o0t",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

4.1.75 - Show Auto-Scaling Group

4.1.75.1 - 1.2

get /v1/auto-scaling-groups/{auto_scaling_group_id}

Description

Auto-Scaling Group을 상세 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None

Responses

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

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_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 = virtualserver 1.2"

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "desired_server_count": 1,
    "desired_server_count_editable": true,
    "drain_enabled": true,
    "drain_timeout": 300,
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
    "launch_configuration_name": "launch-configuration-name",
    "lb_server_groups": [],
    "max_server_count": 2,
    "min_server_count": 1,
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "auto-scaling-group-name",
    "security_group_ids": [
        "c09c3f05-03d9-443f-b27a-40e0f973c75f"
    ],
    "server_name_prefix": "server-name-prefix",
    "state": "IN_SERVICE",
    "state_check_delay_time": 300,
    "subnet_ids": [],
    "total_server_count": 1,
    "use_lb_state_check": true,
    "vpc_id": "cc976b621087484ea5fd527f4b78708b"
}

4.1.75.2 - 1.1

get /v1/auto-scaling-groups/{auto_scaling_group_id}

Description

Auto-Scaling Group을 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None

Responses

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

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_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 = virtualserver 1.1"

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "desired_server_count": 1,
    "desired_server_count_editable": true,
    "drain_enabled": true,
    "drain_timeout": 300,
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
    "launch_configuration_name": "launch-configuration-name",
    "lb_server_groups": [],
    "max_server_count": 2,
    "min_server_count": 1,
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "auto-scaling-group-name",
    "security_group_ids": [
        "c09c3f05-03d9-443f-b27a-40e0f973c75f"
    ],
    "server_name_prefix": "server-name-prefix",
    "state": "IN_SERVICE",
    "subnet_ids": [],
    "total_server_count": 1,
    "vpc_id": "cc976b621087484ea5fd527f4b78708b"
}

4.1.75.3 - 1.0

get /v1/auto-scaling-groups/{auto_scaling_group_id}

Description

Auto-Scaling Group을 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None

Responses

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

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_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 = virtualserver 1.0"

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "desired_server_count": 1,
    "desired_server_count_editable": true,
    "drain_enabled": true,
    "drain_timeout": 300,
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
    "launch_configuration_name": "launch-configuration-name",
    "lb_server_groups": [],
    "max_server_count": 2,
    "min_server_count": 1,
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "auto-scaling-group-name",
    "security_group_ids": [
        "c09c3f05-03d9-443f-b27a-40e0f973c75f"
    ],
    "server_name_prefix": "server-name-prefix",
    "state": "IN_SERVICE",
    "subnet_ids": [],
    "total_server_count": 1,
    "vpc_id": "cc976b621087484ea5fd527f4b78708b"
}

4.1.76 - Show Auto-Scaling Group Notification

4.1.76.1 - 1.2

get /v1/auto-scaling-groups/{auto_scaling_group_id}/notifications/{notification_id}

Description

Auto-Scaling Group 알림을 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
path	notification_id required	Auto-Scaling Grou 알림 ID Example : `fa7fd191410744cd810a290c0b4d22b9`	string	None

Responses

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

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/notifications/{notification_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 = virtualserver 1.2"

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "notification_events": [
        "SCALE_OUT",
        "SCALE_OUT_FAIL"
    ],
    "notification_state": "ACTIVE",
    "user_email": "scpuser@samsung.com",
    "user_id": "570907805e5447be84b618450ef52o0t",
    "user_name": "scpuser"
}

4.1.76.2 - 1.1

get /v1/auto-scaling-groups/{auto_scaling_group_id}/notifications/{notification_id}

Description

Auto-Scaling Group 알림을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
path	notification_id required	Auto-Scaling Grou 알림 ID Example : `fa7fd191410744cd810a290c0b4d22b9`	string	None

Responses

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

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/notifications/{notification_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 = virtualserver 1.1"

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "notification_events": [
        "SCALE_OUT",
        "SCALE_OUT_FAIL"
    ],
    "notification_state": "ACTIVE",
    "user_email": "scpuser@samsung.com",
    "user_id": "570907805e5447be84b618450ef52o0t",
    "user_name": "scpuser"
}

4.1.76.3 - 1.0

get /v1/auto-scaling-groups/{auto_scaling_group_id}/notifications/{notification_id}

Description

Auto-Scaling Group 알림을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
path	notification_id required	Auto-Scaling Grou 알림 ID Example : `fa7fd191410744cd810a290c0b4d22b9`	string	None

Responses

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

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/notifications/{notification_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 = virtualserver 1.0"

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "notification_events": [
        "SCALE_OUT",
        "SCALE_OUT_FAIL"
    ],
    "notification_state": "ACTIVE",
    "user_email": "scpuser@samsung.com",
    "user_id": "570907805e5447be84b618450ef52o0t",
    "user_name": "scpuser"
}

4.1.77 - Show Auto-Scaling Group Policy

4.1.77.1 - 1.2

get /v1/auto-scaling-groups/{auto_scaling_group_id}/policies/{policy_id}

Description

Auto-Scaling Group 정책을 상세 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
path	policy_id required	정책 ID Example : `0761d76085f54363bab07909baf69841`	string	None

Responses

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

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/policies/{policy_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 = virtualserver 1.2"

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
    "comparison_operator": "ge",
    "cooldown_seconds": 300,
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "evaluation_minutes": 5,
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "metric_method": "AVG",
    "metric_type": "CPU",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "policy-name",
    "scale_method": "AMOUNT",
    "scale_type": "SCALE_OUT",
    "scale_value": 10,
    "state": "ACTIVE",
    "threshold": 60,
    "threshold_unit": "%"
}

4.1.77.2 - 1.1

get /v1/auto-scaling-groups/{auto_scaling_group_id}/policies/{policy_id}

Description

Auto-Scaling Group 정책을 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
path	policy_id required	정책 ID Example : `0761d76085f54363bab07909baf69841`	string	None

Responses

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

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/policies/{policy_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 = virtualserver 1.1"

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
    "comparison_operator": "ge",
    "cooldown_seconds": 300,
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "evaluation_minutes": 5,
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "metric_method": "AVG",
    "metric_type": "CPU",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "policy-name",
    "scale_method": "AMOUNT",
    "scale_type": "SCALE_OUT",
    "scale_value": 10,
    "state": "ACTIVE",
    "threshold": 60,
    "threshold_unit": "%"
}

4.1.77.3 - 1.0

get /v1/auto-scaling-groups/{auto_scaling_group_id}/policies/{policy_id}

Description

Auto-Scaling Group 정책을 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
path	policy_id required	정책 ID Example : `0761d76085f54363bab07909baf69841`	string	None

Responses

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

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/policies/{policy_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 = virtualserver 1.0"

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
    "comparison_operator": "ge",
    "cooldown_seconds": 300,
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "evaluation_minutes": 5,
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "metric_method": "AVG",
    "metric_type": "CPU",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "policy-name",
    "scale_method": "AMOUNT",
    "scale_type": "SCALE_OUT",
    "scale_value": 10,
    "state": "ACTIVE",
    "threshold": 60,
    "threshold_unit": "%"
}

4.1.78 - Show Auto-Scaling Group Schedule

4.1.78.1 - 1.2

get /v1/auto-scaling-groups/{auto_scaling_group_id}/schedules/{schedule_id}

Description

Auto-Scaling Group을 상세 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
path	schedule_id required	스케줄 ID Example : `43d4841abd404220af5f0904037aba71`	string	None

Responses

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

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/schedules/{schedule_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 = virtualserver 1.2"

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "day_of_month": "-1,1",
    "day_of_week": "SU,SA",
    "description": "description",
    "desired_server_count": 1,
    "end_date": "2025-01-01",
    "frequency": "WEEKLY",
    "hour": 9,
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "max_server_count": 2,
    "min_server_count": 1,
    "minute": 0,
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "schedulename",
    "start_date": "2024-01-01",
    "state": "ACTIVE",
    "timezone": "Asia/Seoul"
}

4.1.78.2 - 1.1

get /v1/auto-scaling-groups/{auto_scaling_group_id}/schedules/{schedule_id}

Description

Auto-Scaling Group을 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
path	schedule_id required	스케줄 ID Example : `43d4841abd404220af5f0904037aba71`	string	None

Responses

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

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/schedules/{schedule_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 = virtualserver 1.1"

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "day_of_month": "-1,1",
    "day_of_week": "SU,SA",
    "description": "description",
    "desired_server_count": 1,
    "end_date": "2025-01-01",
    "frequency": "WEEKLY",
    "hour": 9,
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "max_server_count": 2,
    "min_server_count": 1,
    "minute": 0,
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "schedulename",
    "start_date": "2024-01-01",
    "state": "ACTIVE",
    "timezone": "Asia/Seoul"
}

4.1.78.3 - 1.0

get /v1/auto-scaling-groups/{auto_scaling_group_id}/schedules/{schedule_id}

Description

Auto-Scaling Group을 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
path	schedule_id required	스케줄 ID Example : `43d4841abd404220af5f0904037aba71`	string	None

Responses

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

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/schedules/{schedule_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 = virtualserver 1.0"

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "day_of_month": "-1,1",
    "day_of_week": "SU,SA",
    "description": "description",
    "desired_server_count": 1,
    "end_date": "2025-01-01",
    "frequency": "WEEKLY",
    "hour": 9,
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "max_server_count": 2,
    "min_server_count": 1,
    "minute": 0,
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "schedulename",
    "start_date": "2024-01-01",
    "state": "ACTIVE",
    "timezone": "Asia/Seoul"
}

4.1.79 - Show default Volume type’s details

4.1.79.1 - 1.2

get /v1/volume-types/default

Description

기본 볼륨 유형을 상세 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Responses

HTTP Code	Description	Schema
200	OK	VolumeTypeDetailResponse
401	Unauthorized	None
500	Internal Server Error	None

Example HTTP request

Request path

/v1/volume-types/default

Request header

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

Example HTTP response

Response 200

{
    "description": "Volume type description",
    "extra_specs": {
        "multiattach": "<is> True"
    },
    "id": "c643ac35-3aec-43e6-b97a-3d6f666c5207",
    "name": "SSD"
}

4.1.79.2 - 1.1

get /v1/volume-types/default

Description

기본 볼륨 유형을 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Responses

HTTP Code	Description	Schema
200	OK	VolumeTypeDetailResponse
401	Unauthorized	None
500	Internal Server Error	None

Example HTTP request

Request path

/v1/volume-types/default

Request header

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

Example HTTP response

Response 200

{
    "description": "Volume type description",
    "extra_specs": {
        "multiattach": "<is> True"
    },
    "id": "c643ac35-3aec-43e6-b97a-3d6f666c5207",
    "name": "SSD"
}

4.1.79.3 - 1.0

get /v1/volume-types/default

Description

기본 볼륨 유형을 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Responses

HTTP Code	Description	Schema
200	OK	VolumeTypeDetailResponse
401	Unauthorized	None
500	Internal Server Error	None

Example HTTP request

Request path

/v1/volume-types/default

Request header

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

Example HTTP response

Response 200

{
    "description": "Volume type description",
    "extra_specs": {
        "multiattach": "<is> True"
    },
    "id": "c643ac35-3aec-43e6-b97a-3d6f666c5207",
    "name": "SSD"
}

4.1.80 - Show Image

4.1.80.1 - 1.2

get /v1/images/{image_id}

Description

이미지를 상세 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ImageShowResponseV1Dot2
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/images/{image_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 = virtualserver 1.2"

Example HTTP response

Response 200

{
    "checksum": "7538e0fcb56e0e272cfd89eb384d6613",
    "container_format": "bare",
    "created_at": "2025-07-22T09:00:00Z",
    "disk_format": "qcow2",
    "file": "/v2/images/e08a37c1-2162-416e-b7fa-19902419170b/file",
    "id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "min_disk": 100,
    "min_ram": 0,
    "name": "imagename",
    "os_distro": "alma",
    "os_hash_algo": "sha512",
    "os_hash_value": "c6a32fc3b7c909b8900b46f5e6066c028a1d799c0a263cf064a600c430a714627c21f98ac248e2f2bf29870a1a2773c7908244745016878e1a5f31dc2c405b99",
    "os_hidden": false,
    "owner": "a8f10467abfc4b87b64614ab36eb9ae4",
    "owner_account_name": "AccountName",
    "owner_user_name": "user@samsung.com",
    "protected": false,
    "root_device_name": "/dev/vda",
    "scp_gpu_driver": "535.183.06",
    "scp_image_type": "custom",
    "scp_k8s_version": "v1.28.7",
    "scp_original_image_type": "standard",
    "scp_os_build_version": "20250101",
    "scp_os_version": "8.8",
    "size": 2429747200,
    "status": "active",
    "updated_at": "2025-07-26T12:00:00Z",
    "url": "https://object-store.kr-west1.s.samsungsdscloud.com/8989447062e04a818baf9e073fd04fa7/bucket/object.qcow2",
    "virtual_size": 17179869184,
    "visibility": "private",
    "volumes": "[{\"tag\": null, \"volume_id\": null, \"encryption_options\": null, \"encryption_secret_uuid\": null, \"encryption_format\": null, \"device_name\": \"/dev/vda\", \"disk_bus\": \"virtio\", \"volume_type\": null, \"encrypted\": null, \"image_id\": null, \"device_type\": \"disk\", \"source_type\": \"snapshot\", \"delete_on_termination\": false, \"volume_size\": 104, \"guest_format\": null, \"boot_index\": 0, \"destination_type\": \"volume\", \"snapshot_id\": \"abde9e38-2ed5-4ecd-b23c-b0120e30690e\", \"no_device\": null}]"
}

4.1.80.2 - 1.1

get /v1/images/{image_id}

Description

이미지를 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ImageShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/images/{image_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 = virtualserver 1.1"

Example HTTP response

Response 200

{
    "checksum": "7538e0fcb56e0e272cfd89eb384d6613",
    "container_format": "bare",
    "created_at": "2025-07-22T09:00:00Z",
    "disk_format": "qcow2",
    "file": "/v2/images/e08a37c1-2162-416e-b7fa-19902419170b/file",
    "id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "min_disk": 100,
    "min_ram": 0,
    "name": "imagename",
    "os_distro": "alma",
    "os_hash_algo": "sha512",
    "os_hash_value": "c6a32fc3b7c909b8900b46f5e6066c028a1d799c0a263cf064a600c430a714627c21f98ac248e2f2bf29870a1a2773c7908244745016878e1a5f31dc2c405b99",
    "os_hidden": false,
    "owner": "a8f10467abfc4b87b64614ab36eb9ae4",
    "owner_account_name": "AccountName",
    "owner_user_name": "user@samsung.com",
    "protected": false,
    "root_device_name": "/dev/vda",
    "scp_image_type": "custom",
    "scp_k8s_version": "v1.28.7",
    "scp_original_image_type": "standard",
    "scp_os_build_version": "20250101",
    "scp_os_version": "8.8",
    "size": 2429747200,
    "status": "active",
    "updated_at": "2025-07-26T12:00:00Z",
    "url": "https://object-store.kr-west1.s.samsungsdscloud.com/8989447062e04a818baf9e073fd04fa7/bucket/object.qcow2",
    "virtual_size": 17179869184,
    "visibility": "private",
    "volumes": "[{\"tag\": null, \"volume_id\": null, \"encryption_options\": null, \"encryption_secret_uuid\": null, \"encryption_format\": null, \"device_name\": \"/dev/vda\", \"disk_bus\": \"virtio\", \"volume_type\": null, \"encrypted\": null, \"image_id\": null, \"device_type\": \"disk\", \"source_type\": \"snapshot\", \"delete_on_termination\": false, \"volume_size\": 104, \"guest_format\": null, \"boot_index\": 0, \"destination_type\": \"volume\", \"snapshot_id\": \"abde9e38-2ed5-4ecd-b23c-b0120e30690e\", \"no_device\": null}]"
}

4.1.80.3 - 1.0

get /v1/images/{image_id}

Description

이미지를 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ImageShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/images/{image_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 = virtualserver 1.0"

Example HTTP response

Response 200

{
    "checksum": "7538e0fcb56e0e272cfd89eb384d6613",
    "container_format": "bare",
    "created_at": "2025-07-22T09:00:00Z",
    "disk_format": "qcow2",
    "file": "/v2/images/e08a37c1-2162-416e-b7fa-19902419170b/file",
    "id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "min_disk": 100,
    "min_ram": 0,
    "name": "imagename",
    "os_distro": "alma",
    "os_hash_algo": "sha512",
    "os_hash_value": "c6a32fc3b7c909b8900b46f5e6066c028a1d799c0a263cf064a600c430a714627c21f98ac248e2f2bf29870a1a2773c7908244745016878e1a5f31dc2c405b99",
    "os_hidden": false,
    "owner": "a8f10467abfc4b87b64614ab36eb9ae4",
    "owner_account_name": "AccountName",
    "owner_user_name": "user@samsung.com",
    "protected": false,
    "root_device_name": "/dev/vda",
    "scp_image_type": "custom",
    "scp_k8s_version": "v1.28.7",
    "scp_original_image_type": "standard",
    "scp_os_build_version": "20250101",
    "scp_os_version": "8.8",
    "size": 2429747200,
    "status": "active",
    "updated_at": "2025-07-26T12:00:00Z",
    "url": "https://object-store.kr-west1.s.samsungsdscloud.com/8989447062e04a818baf9e073fd04fa7/bucket/object.qcow2",
    "virtual_size": 17179869184,
    "visibility": "private",
    "volumes": "[{\"tag\": null, \"volume_id\": null, \"encryption_options\": null, \"encryption_secret_uuid\": null, \"encryption_format\": null, \"device_name\": \"/dev/vda\", \"disk_bus\": \"virtio\", \"volume_type\": null, \"encrypted\": null, \"image_id\": null, \"device_type\": \"disk\", \"source_type\": \"snapshot\", \"delete_on_termination\": false, \"volume_size\": 104, \"guest_format\": null, \"boot_index\": 0, \"destination_type\": \"volume\", \"snapshot_id\": \"abde9e38-2ed5-4ecd-b23c-b0120e30690e\", \"no_device\": null}]"
}

4.1.81 - Show Image member

4.1.81.1 - 1.2

get /v1/images/{image_id}/members/{member_id}

Description

이미지 멤버를 상세 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string	None
path	member_id required	공유용 이미지 멤버 ID Example : `a8f10467abfc4b87b64614ab36eb9ae4`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ImageMemberShowResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/images/{image_id}/members/{member_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 = virtualserver 1.2"

Example HTTP response

Response 200

{
    "created_at": "2025-07-22T09:00:00Z",
    "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "member_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "status": "pending",
    "updated_at": "2025-07-26T12:00:00Z"
}

4.1.81.2 - 1.1

get /v1/images/{image_id}/members/{member_id}

Description

이미지 멤버를 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string	None
path	member_id required	공유용 이미지 멤버 ID Example : `a8f10467abfc4b87b64614ab36eb9ae4`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ImageMemberShowResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/images/{image_id}/members/{member_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 = virtualserver 1.1"

Example HTTP response

Response 200

{
    "created_at": "2025-07-22T09:00:00Z",
    "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "member_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "status": "pending",
    "updated_at": "2025-07-26T12:00:00Z"
}

4.1.81.3 - 1.0

get /v1/images/{image_id}/members/{member_id}

Description

이미지 멤버를 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string	None
path	member_id required	공유용 이미지 멤버 ID Example : `a8f10467abfc4b87b64614ab36eb9ae4`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ImageMemberShowResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/images/{image_id}/members/{member_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 = virtualserver 1.0"

Example HTTP response

Response 200

{
    "created_at": "2025-07-22T09:00:00Z",
    "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "member_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "status": "pending",
    "updated_at": "2025-07-26T12:00:00Z"
}

4.1.82 - Show Keypair

4.1.82.1 - 1.2

get /v1/keypairs/{keypair_name}

Description

키페어를 상세 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	keypair_name required	키페어 이름 Example : `keypairname`	string	None

Responses

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

Example HTTP request

Request path

/v1/keypairs/{keypair_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 = virtualserver 1.2"

Example HTTP response

Response 200

{
    "created_at": "2025-07-22T09:00:00Z",
    "fingerprint": "7e:eb:ab:24:ba:d1:e1:88:ae:9a:fb:66:53:df:d3:bd",
    "id": 1,
    "name": "keypairname",
    "public_key": "ssh-rsa fakeKey Generated-by-SCP",
    "type": "ssh",
    "user_id": "570907805e5447be84b618450ef52o0t"
}

4.1.82.2 - 1.1

get /v1/keypairs/{keypair_name}

Description

키페어를 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	keypair_name required	키페어 이름 Example : `keypairname`	string	None

Responses

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

Example HTTP request

Request path

/v1/keypairs/{keypair_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 = virtualserver 1.1"

Example HTTP response

Response 200

{
    "created_at": "2025-07-22T09:00:00Z",
    "fingerprint": "7e:eb:ab:24:ba:d1:e1:88:ae:9a:fb:66:53:df:d3:bd",
    "id": 1,
    "name": "keypairname",
    "public_key": "ssh-rsa fakeKey Generated-by-SCP",
    "type": "ssh",
    "user_id": "570907805e5447be84b618450ef52o0t"
}

4.1.82.3 - 1.0

get /v1/keypairs/{keypair_name}

Description

키페어를 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	keypair_name required	키페어 이름 Example : `keypairname`	string	None

Responses

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

Example HTTP request

Request path

/v1/keypairs/{keypair_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 = virtualserver 1.0"

Example HTTP response

Response 200

{
    "created_at": "2025-07-22T09:00:00Z",
    "fingerprint": "7e:eb:ab:24:ba:d1:e1:88:ae:9a:fb:66:53:df:d3:bd",
    "id": 1,
    "name": "keypairname",
    "public_key": "ssh-rsa fakeKey Generated-by-SCP",
    "type": "ssh",
    "user_id": "570907805e5447be84b618450ef52o0t"
}

4.1.83 - Show Launch Configuration

4.1.83.1 - 1.2

get /v1/launch-configurations/{launch_configuration_id}

Description

Launch Configuration을 상세 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	launch_configuration_id required	Launch Configuration ID Example : `b5aea5a675fc4f6b9e0fcd1288354c5f`	string	None

Responses

HTTP Code	Description	Schema
200	OK	LaunchConfigurationDetailShowResponseV1Dot2
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/launch-configurations/{launch_configuration_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 = virtualserver 1.2"

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "auto_scaling_group_count": 1,
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "file_storage_ids": [
        ""
    ],
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "image_name": "imagename",
    "keypair_name": "keypairname",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "launch-configuration-name",
    "public_key": "ssh-rsa fakeKey Generated-by-SCP",
    "server_type_id": "s1v1m2",
    "state": "ACTIVE",
    "user_data": "IyEvYmluL2Jhc2gKL2Jpbi9zdQplY2hvICJJIGFtIGluIHlvdSEiCg==",
    "volumes": [
        {
            "boot_index": 0,
            "max_iops": 10000,
            "max_throughput": 500,
            "size": 104,
            "type": "SSD"
        }
    ]
}

4.1.83.2 - 1.1

get /v1/launch-configurations/{launch_configuration_id}

Description

Launch Configuration을 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	launch_configuration_id required	Launch Configuration ID Example : `b5aea5a675fc4f6b9e0fcd1288354c5f`	string	None

Responses

HTTP Code	Description	Schema
200	OK	LaunchConfigurationDetailShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/launch-configurations/{launch_configuration_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 = virtualserver 1.1"

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "auto_scaling_group_count": 1,
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "image_name": "imagename",
    "keypair_name": "keypairname",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "launch-configuration-name",
    "public_key": "ssh-rsa fakeKey Generated-by-SCP",
    "server_type_id": "s1v1m2",
    "state": "ACTIVE",
    "user_data": "IyEvYmluL2Jhc2gKL2Jpbi9zdQplY2hvICJJIGFtIGluIHlvdSEiCg==",
    "volumes": [
        {
            "boot_index": 0,
            "size": 104,
            "type": "SSD"
        }
    ]
}

4.1.83.3 - 1.0

get /v1/launch-configurations/{launch_configuration_id}

Description

Launch Configuration을 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	launch_configuration_id required	Launch Configuration ID Example : `b5aea5a675fc4f6b9e0fcd1288354c5f`	string	None

Responses

HTTP Code	Description	Schema
200	OK	LaunchConfigurationDetailShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/launch-configurations/{launch_configuration_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 = virtualserver 1.0"

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "auto_scaling_group_count": 1,
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "image_name": "imagename",
    "keypair_name": "keypairname",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "launch-configuration-name",
    "public_key": "ssh-rsa fakeKey Generated-by-SCP",
    "server_type_id": "s1v1m2",
    "state": "ACTIVE",
    "user_data": "IyEvYmluL2Jhc2gKL2Jpbi9zdQplY2hvICJJIGFtIGluIHlvdSEiCg==",
    "volumes": [
        {
            "boot_index": 0,
            "size": 104,
            "type": "SSD"
        }
    ]
}

4.1.84 - Show Server Group

4.1.84.1 - 1.2

get /v1/server-groups/{server_group_id}

Description

서버 그룹을 상세 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_group_id required	서버 그룹 ID Example : `616fb98f-46ca-475e-917e-2563e5a8cd19`	string	None

Responses

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

Example HTTP request

Request path

/v1/server-groups/{server_group_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 = virtualserver 1.2"

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
    "members": [
        "2a9be312-5d4b-4bc8-b2ae-35100fa9241f"
    ],
    "name": "server-group",
    "partition_size": 3,
    "policy": "anti-affinity",
    "user_id": "570907805e5447be84b618450ef52o0t"
}

4.1.84.2 - 1.1

get /v1/server-groups/{server_group_id}

Description

서버 그룹을 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_group_id required	서버 그룹 ID Example : `616fb98f-46ca-475e-917e-2563e5a8cd19`	string	None

Responses

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

Example HTTP request

Request path

/v1/server-groups/{server_group_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 = virtualserver 1.1"

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
    "members": [
        "2a9be312-5d4b-4bc8-b2ae-35100fa9241f"
    ],
    "name": "server-group",
    "partition_size": 3,
    "policy": "anti-affinity",
    "user_id": "570907805e5447be84b618450ef52o0t"
}

4.1.84.3 - 1.0

get /v1/server-groups/{server_group_id}

Description

서버 그룹을 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_group_id required	서버 그룹 ID Example : `616fb98f-46ca-475e-917e-2563e5a8cd19`	string	None

Responses

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

Example HTTP request

Request path

/v1/server-groups/{server_group_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 = virtualserver 1.0"

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
    "members": [
        "2a9be312-5d4b-4bc8-b2ae-35100fa9241f"
    ],
    "name": "server-group",
    "partition_size": 3,
    "policy": "anti-affinity",
    "user_id": "570907805e5447be84b618450ef52o0t"
}

4.1.85 - Show Server Interface

4.1.85.1 - 1.2

get /v1/servers/{server_id}/interfaces/{port_id}

Description

서버 인터페이스를 상세 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	port_id required	포트 ID Example : `91424c08-0b26-49fb-9808-ed042292ceef`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/interfaces/{port_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 = virtualserver 1.2"

Example HTTP response

Response 200

{
    "interfaces": [
        {
            "fixed_ips": [
                {
                    "ip_address": "192.169.3.2"
                }
            ],
            "is_default": true,
            "mac_addr": "fa:16:3e:c0:71:2b",
            "port_id": "f2b02fc5-a5fd-4b5f-b1a9-987f4c0d66cc",
            "port_state": "ACTIVE",
            "private_static_nat": {
                "external_ip_address": "182.197.61.81",
                "id": "224b80106e6f41b38efe98ac9ddbf280",
                "private_nat_ip_id": "1f0cb5390c40483592ddc5a282f53496",
                "state": "ACTIVE"
            },
            "static_nat": {
                "external_ip_address": "182.197.61.81",
                "id": "224b80106e6f41b38efe98ac9ddbf280",
                "publicip_id": "615fa9cd5cff486c9de679b3ce63e601",
                "state": "ACTIVE"
            },
            "subnet_id": "183c6c30df0c4fcbb16422aa2d64aa21"
        }
    ]
}

4.1.85.2 - 1.1

get /v1/servers/{server_id}/interfaces/{port_id}

Description

서버 인터페이스를 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	port_id required	포트 ID Example : `91424c08-0b26-49fb-9808-ed042292ceef`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/interfaces/{port_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 = virtualserver 1.1"

Example HTTP response

Response 200

{
    "interfaces": [
        {
            "fixed_ips": [
                {
                    "ip_address": "192.169.3.2"
                }
            ],
            "mac_addr": "fa:16:3e:c0:71:2b",
            "port_id": "f2b02fc5-a5fd-4b5f-b1a9-987f4c0d66cc",
            "port_state": "ACTIVE",
            "private_static_nat": {
                "external_ip_address": "182.197.61.81",
                "id": "224b80106e6f41b38efe98ac9ddbf280",
                "private_nat_ip_id": "1f0cb5390c40483592ddc5a282f53496",
                "state": "ACTIVE"
            },
            "static_nat": {
                "external_ip_address": "182.197.61.81",
                "id": "224b80106e6f41b38efe98ac9ddbf280",
                "publicip_id": "615fa9cd5cff486c9de679b3ce63e601",
                "state": "ACTIVE"
            },
            "subnet_id": "183c6c30df0c4fcbb16422aa2d64aa21"
        }
    ]
}

4.1.85.3 - 1.0

get /v1/servers/{server_id}/interfaces/{port_id}

Description

서버 인터페이스를 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	port_id required	포트 ID Example : `91424c08-0b26-49fb-9808-ed042292ceef`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/interfaces/{port_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 = virtualserver 1.0"

Example HTTP response

Response 200

{
    "interfaces": [
        {
            "fixed_ips": [
                {
                    "ip_address": "192.169.3.2"
                }
            ],
            "mac_addr": "fa:16:3e:c0:71:2b",
            "port_id": "f2b02fc5-a5fd-4b5f-b1a9-987f4c0d66cc",
            "port_state": "ACTIVE",
            "private_static_nat": {
                "external_ip_address": "182.197.61.81",
                "id": "224b80106e6f41b38efe98ac9ddbf280",
                "private_nat_ip_id": "1f0cb5390c40483592ddc5a282f53496",
                "state": "ACTIVE"
            },
            "static_nat": {
                "external_ip_address": "182.197.61.81",
                "id": "224b80106e6f41b38efe98ac9ddbf280",
                "publicip_id": "615fa9cd5cff486c9de679b3ce63e601",
                "state": "ACTIVE"
            },
            "subnet_id": "183c6c30df0c4fcbb16422aa2d64aa21"
        }
    ]
}

4.1.86 - Show Server Ip

4.1.86.1 - 1.2

get /v1/servers/{server_id}/ips/{subnet_id}

Description

서버 IP를 상세 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	subnet_id required	서브넷 ID Example : `78b2ee3f074145c580ab6abac4821f97`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/ips/{subnet_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 = virtualserver 1.2"

Example HTTP response

Response 200

{
    "ip_addresses": [
        {
            "ip_address": "192.169.3.2",
            "version": 4
        }
    ],
    "subnet_name": "subnetname"
}

4.1.86.2 - 1.1

get /v1/servers/{server_id}/ips/{subnet_id}

Description

서버 IP를 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	subnet_id required	서브넷 ID Example : `78b2ee3f074145c580ab6abac4821f97`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/ips/{subnet_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 = virtualserver 1.1"

Example HTTP response

Response 200

{
    "ip_addresses": [
        {
            "ip_address": "192.169.3.2",
            "version": 4
        }
    ],
    "subnet_name": "subnetname"
}

4.1.86.3 - 1.0

get /v1/servers/{server_id}/ips/{subnet_id}

Description

서버 IP를 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	subnet_id required	서브넷 ID Example : `78b2ee3f074145c580ab6abac4821f97`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/ips/{subnet_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 = virtualserver 1.0"

Example HTTP response

Response 200

{
    "ip_addresses": [
        {
            "ip_address": "192.169.3.2",
            "version": 4
        }
    ],
    "subnet_name": "subnetname"
}

4.1.87 - Show Server Quota Set

4.1.87.1 - 1.2

get /v1/quota-sets

Description

서버 쿼터 셋을 상세 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Responses

HTTP Code	Description	Schema
200	OK	ServerQuotaSet
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/quota-sets

Request header

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

Example HTTP response

Response 200

{
    "cores": {
        "in_use": 10,
        "limit": 20,
        "reserved": 0
    },
    "id": "fc7283354c6143a58629b59f4c3e16b2",
    "instances": {
        "in_use": 10,
        "limit": 20,
        "reserved": 0
    },
    "keypairs": {
        "in_use": 10,
        "limit": 20,
        "reserved": 0
    },
    "metadata_items": {
        "in_use": 10,
        "limit": 20,
        "reserved": 0
    },
    "ram": {
        "in_use": 10,
        "limit": 20,
        "reserved": 0
    },
    "server_group_members": {
        "in_use": 10,
        "limit": 20,
        "reserved": 0
    },
    "server_groups": {
        "in_use": 10,
        "limit": 20,
        "reserved": 0
    }
}

4.1.87.2 - 1.1

get /v1/quota-sets

Description

서버 쿼터 셋을 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Responses

HTTP Code	Description	Schema
200	OK	ServerQuotaSet
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/quota-sets

Request header

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

Example HTTP response

Response 200

{
    "cores": {
        "in_use": 10,
        "limit": 20,
        "reserved": 0
    },
    "id": "fc7283354c6143a58629b59f4c3e16b2",
    "instances": {
        "in_use": 10,
        "limit": 20,
        "reserved": 0
    },
    "keypairs": {
        "in_use": 10,
        "limit": 20,
        "reserved": 0
    },
    "metadata_items": {
        "in_use": 10,
        "limit": 20,
        "reserved": 0
    },
    "ram": {
        "in_use": 10,
        "limit": 20,
        "reserved": 0
    },
    "server_group_members": {
        "in_use": 10,
        "limit": 20,
        "reserved": 0
    },
    "server_groups": {
        "in_use": 10,
        "limit": 20,
        "reserved": 0
    }
}

4.1.87.3 - 1.0

get /v1/quota-sets

Description

서버 쿼터 셋을 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Responses

HTTP Code	Description	Schema
200	OK	ServerQuotaSet
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/quota-sets

Request header

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

Example HTTP response

Response 200

{
    "cores": {
        "in_use": 10,
        "limit": 20,
        "reserved": 0
    },
    "id": "fc7283354c6143a58629b59f4c3e16b2",
    "instances": {
        "in_use": 10,
        "limit": 20,
        "reserved": 0
    },
    "keypairs": {
        "in_use": 10,
        "limit": 20,
        "reserved": 0
    },
    "metadata_items": {
        "in_use": 10,
        "limit": 20,
        "reserved": 0
    },
    "ram": {
        "in_use": 10,
        "limit": 20,
        "reserved": 0
    },
    "server_group_members": {
        "in_use": 10,
        "limit": 20,
        "reserved": 0
    },
    "server_groups": {
        "in_use": 10,
        "limit": 20,
        "reserved": 0
    }
}

4.1.88 - Show Server Type

4.1.88.1 - 1.2

get /v1/server-types/{server_type_id}

Description

서버 타입을 상세 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_type_id required	서버 타입 ID Example : `s1v1m2`	string	None

Responses

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

Example HTTP request

Request path

/v1/server-types/{server_type_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 = virtualserver 1.2"

Example HTTP response

Response 200

{
    "description": "description",
    "disk": 100,
    "ephemeral": 0,
    "extra_specs": "",
    "id": "s1v1m2",
    "name": "s1v1m2",
    "ram": 2,
    "swap": 0,
    "vcpus": 1
}

4.1.88.2 - 1.1

get /v1/server-types/{server_type_id}

Description

서버 타입을 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_type_id required	서버 타입 ID Example : `s1v1m2`	string	None

Responses

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

Example HTTP request

Request path

/v1/server-types/{server_type_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 = virtualserver 1.1"

Example HTTP response

Response 200

{
    "description": "description",
    "disk": 100,
    "ephemeral": 0,
    "extra_specs": "",
    "id": "s1v1m2",
    "name": "s1v1m2",
    "ram": 2,
    "swap": 0,
    "vcpus": 1
}

4.1.88.3 - 1.0

get /v1/server-types/{server_type_id}

Description

서버 타입을 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_type_id required	서버 타입 ID Example : `s1v1m2`	string	None

Responses

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

Example HTTP request

Request path

/v1/server-types/{server_type_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 = virtualserver 1.0"

Example HTTP response

Response 200

{
    "description": "description",
    "disk": 100,
    "ephemeral": 0,
    "extra_specs": "",
    "id": "s1v1m2",
    "name": "s1v1m2",
    "ram": 2,
    "swap": 0,
    "vcpus": 1
}

4.1.89 - Show Server Volume

4.1.89.1 - 1.2

get /v1/servers/{server_id}/volumes/{volume_id}

Description

서버 볼륨을 상세 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/volumes/{volume_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 = virtualserver 1.2"

Example HTTP response

Response 200

{
    "delete_on_termination": false,
    "device": "/dev/vda",
    "id": "3ad1cc18-1b09-4f51-9b1d-4ce4243f6a4c",
    "server_id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

4.1.89.2 - 1.1

get /v1/servers/{server_id}/volumes/{volume_id}

Description

서버 볼륨을 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/volumes/{volume_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 = virtualserver 1.1"

Example HTTP response

Response 200

{
    "delete_on_termination": false,
    "device": "/dev/vda",
    "id": "3ad1cc18-1b09-4f51-9b1d-4ce4243f6a4c",
    "server_id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

4.1.89.3 - 1.0

get /v1/servers/{server_id}/volumes/{volume_id}

Description

서버 볼륨을 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/volumes/{volume_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 = virtualserver 1.0"

Example HTTP response

Response 200

{
    "delete_on_termination": false,
    "device": "/dev/vda",
    "id": "3ad1cc18-1b09-4f51-9b1d-4ce4243f6a4c",
    "server_id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

4.1.90 - Show Virtual Server

4.1.90.1 - 1.2

get /v1/servers/{server_id}

Description

서버를 상세 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_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 = virtualserver 1.2"

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "addresses": [
        {
            "ip_addresses": [
                {
                    "ip_address": "192.169.3.2",
                    "version": 4
                }
            ],
            "subnet_name": "subnetname"
        }
    ],
    "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
    "created_at": "2026-04-14T15:06:29.755Z",
    "created_by": "97e6b22c9a4143789ca522df7457a32f",
    "disk_config": "MANUAL",
    "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
    "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "is_marketplace": false,
    "keypair_name": "keypairname",
    "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
    "locked": false,
    "metadata": "",
    "modified_at": "2026-04-14T15:06:29.778Z",
    "name": "servername",
    "partition_number": 1,
    "planned_compute_os_type": "windows",
    "product_category": "compute",
    "product_offering": "virtual_server",
    "security_groups": [
        {
            "name": "securitygroup"
        }
    ],
    "server_group_id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
    "server_type": {
        "disk": 100,
        "ephemeral": 0,
        "extra_specs": "",
        "id": "s1v1m2",
        "name": "s1v1m2",
        "ram": 2,
        "swap": 0,
        "vcpus": 1
    },
    "state": "ACTIVE",
    "volumes": [
        {
            "delete_on_termination": false,
            "id": "3f500f00-ed80-4566-a057-e31760226f9a"
        }
    ],
    "vpc_id": "cc976b621087484ea5fd527f4b78708b"
}

4.1.90.2 - 1.1

get /v1/servers/{server_id}

Description

서버를 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_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 = virtualserver 1.1"

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "addresses": [
        {
            "ip_addresses": [
                {
                    "ip_address": "192.169.3.2",
                    "version": 4
                }
            ],
            "subnet_name": "subnetname"
        }
    ],
    "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
    "created_at": "2026-04-14T15:06:29.755Z",
    "created_by": "97e6b22c9a4143789ca522df7457a32f",
    "disk_config": "MANUAL",
    "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
    "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "is_marketplace": false,
    "keypair_name": "keypairname",
    "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
    "locked": false,
    "metadata": "",
    "modified_at": "2026-04-14T15:06:29.778Z",
    "name": "servername",
    "partition_number": 1,
    "planned_compute_os_type": "windows",
    "product_category": "compute",
    "product_offering": "virtual_server",
    "security_groups": [
        {
            "name": "securitygroup"
        }
    ],
    "server_group_id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
    "server_type": {
        "disk": 100,
        "ephemeral": 0,
        "extra_specs": "",
        "id": "s1v1m2",
        "name": "s1v1m2",
        "ram": 2,
        "swap": 0,
        "vcpus": 1
    },
    "state": "ACTIVE",
    "volumes": [
        {
            "delete_on_termination": false,
            "id": "3f500f00-ed80-4566-a057-e31760226f9a"
        }
    ],
    "vpc_id": "cc976b621087484ea5fd527f4b78708b"
}

4.1.90.3 - 1.0

get /v1/servers/{server_id}

Description

서버를 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_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 = virtualserver 1.0"

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "addresses": [
        {
            "ip_addresses": [
                {
                    "ip_address": "192.169.3.2",
                    "version": 4
                }
            ],
            "subnet_name": "subnetname"
        }
    ],
    "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
    "created_at": "2026-04-14T15:06:29.755Z",
    "created_by": "97e6b22c9a4143789ca522df7457a32f",
    "disk_config": "MANUAL",
    "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
    "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "is_marketplace": false,
    "keypair_name": "keypairname",
    "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
    "locked": false,
    "metadata": "",
    "modified_at": "2026-04-14T15:06:29.778Z",
    "name": "servername",
    "partition_number": 1,
    "planned_compute_os_type": "windows",
    "product_category": "compute",
    "product_offering": "virtual_server",
    "security_groups": [
        {
            "name": "securitygroup"
        }
    ],
    "server_group_id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
    "server_type": {
        "disk": 100,
        "ephemeral": 0,
        "extra_specs": "",
        "id": "s1v1m2",
        "name": "s1v1m2",
        "ram": 2,
        "swap": 0,
        "vcpus": 1
    },
    "state": "ACTIVE",
    "volumes": [
        {
            "delete_on_termination": false,
            "id": "3f500f00-ed80-4566-a057-e31760226f9a"
        }
    ],
    "vpc_id": "cc976b621087484ea5fd527f4b78708b"
}

4.1.91 - Show Virtual Server Console Log

4.1.91.1 - 1.2

get /v1/servers/{server_id}/console-log

Description

서버 콘솔 로그를 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
query	line_size optional	Number of log lines to get Example : `1`	any of [integer, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ServerConsoleLogResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/servers/{server_id}/console-log

Request header

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

Example HTTP response

Response 200

{
    "output": "FAKE CONSOLE OUTPUT"
}

4.1.91.2 - 1.1

get /v1/servers/{server_id}/console-log

Description

서버 콘솔 로그를 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
query	line_size optional	Number of log lines to get Example : `1`	any of [integer, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ServerConsoleLogResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/servers/{server_id}/console-log

Request header

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

Example HTTP response

Response 200

{
    "output": "FAKE CONSOLE OUTPUT"
}

4.1.91.3 - 1.0

get /v1/servers/{server_id}/console-log

Description

서버 콘솔 로그를 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
query	line_size optional	Number of log lines to get Example : `1`	any of [integer, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ServerConsoleLogResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/servers/{server_id}/console-log

Request header

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

Example HTTP response

Response 200

{
    "output": "FAKE CONSOLE OUTPUT"
}

4.1.92 - Show Virtual Server Password

4.1.92.1 - 1.2

post /v1/servers/{server_id}/password

Description

서버 비밀번호를 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
body	body required		ServerPasswordRequest

Responses

HTTP Code	Description	Schema
200	OK	ServerPasswordResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/servers/{server_id}/password

Request header

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

Request body

{
    "private_key": "-----BEGIN RSA PRIVATE KEY-----\nfakeKey\n-----END RSA PRIVATE KEY-----"
}

Example HTTP response

Response 200

{
    "password": "password"
}

4.1.92.2 - 1.1

post /v1/servers/{server_id}/password

Description

서버 비밀번호를 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
body	body required		ServerPasswordRequest

Responses

HTTP Code	Description	Schema
200	OK	ServerPasswordResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/servers/{server_id}/password

Request header

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

Request body

{
    "private_key": "-----BEGIN RSA PRIVATE KEY-----\nfakeKey\n-----END RSA PRIVATE KEY-----"
}

Example HTTP response

Response 200

{
    "password": "password"
}

4.1.92.3 - 1.0

post /v1/servers/{server_id}/password

Description

서버 비밀번호를 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
body	body required		ServerPasswordRequest

Responses

HTTP Code	Description	Schema
200	OK	ServerPasswordResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/servers/{server_id}/password

Request header

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

Request body

{
    "private_key": "-----BEGIN RSA PRIVATE KEY-----\nfakeKey\n-----END RSA PRIVATE KEY-----"
}

Example HTTP response

Response 200

{
    "password": "password"
}

4.1.93 - Show Volume Quota Set

4.1.93.1 - 1.2

get /v1/volumes/quota-sets

Description

볼륨 쿼터 셋을 상세 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Responses

HTTP Code	Description	Schema
200	OK	VolumeQuotaSet
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/volumes/quota-sets

Request header

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

Example HTTP response

Response 200

{
    "id": "fc7283354c6143a58629b59f4c3e16b2",
    "per_volume_size": {
        "in_use": 10,
        "limit": "",
        "reserved": 0
    },
    "snapshots": {
        "in_use": 10,
        "limit": "",
        "reserved": 0
    },
    "usages": {
        "in_use": 10,
        "limit": "",
        "reserved": 0
    },
    "volumes": {
        "in_use": 10,
        "limit": "",
        "reserved": 0
    }
}

4.1.93.2 - 1.1

get /v1/volumes/quota-sets

Description

볼륨 쿼터 셋을 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Responses

HTTP Code	Description	Schema
200	OK	VolumeQuotaSet
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/volumes/quota-sets

Request header

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

Example HTTP response

Response 200

{
    "id": "fc7283354c6143a58629b59f4c3e16b2",
    "per_volume_size": {
        "in_use": 10,
        "limit": "",
        "reserved": 0
    },
    "snapshots": {
        "in_use": 10,
        "limit": "",
        "reserved": 0
    },
    "usages": {
        "in_use": 10,
        "limit": "",
        "reserved": 0
    },
    "volumes": {
        "in_use": 10,
        "limit": "",
        "reserved": 0
    }
}

4.1.93.3 - 1.0

get /v1/volumes/quota-sets

Description

볼륨 쿼터 셋을 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Responses

HTTP Code	Description	Schema
200	OK	VolumeQuotaSet
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/volumes/quota-sets

Request header

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

Example HTTP response

Response 200

{
    "id": "fc7283354c6143a58629b59f4c3e16b2",
    "per_volume_size": {
        "in_use": 10,
        "limit": "",
        "reserved": 0
    },
    "snapshots": {
        "in_use": 10,
        "limit": "",
        "reserved": 0
    },
    "usages": {
        "in_use": 10,
        "limit": "",
        "reserved": 0
    },
    "volumes": {
        "in_use": 10,
        "limit": "",
        "reserved": 0
    }
}

4.1.94 - Show volume transfer detail

4.1.94.1 - 1.2

get /v1/volume-transfer/{transfer_id}

Description

볼륨 이전에 대해 상세 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	transfer_id required	볼륨 이전 ID Example : `1ac231be-823b-4a4d-8ff0-aac503a7118a`	string	None

Responses

HTTP Code	Description	Schema
200	OK	VolumeTransferShowResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/volume-transfer/{transfer_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 = virtualserver 1.2"

Example HTTP response

Response 200

{
    "created_at": "2025-07-22T09:00:00Z",
    "id": "1ac231be-823b-4a4d-8ff0-aac503a7118a",
    "name": "volume01",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

4.1.94.2 - 1.1

get /v1/volume-transfer/{transfer_id}

Description

볼륨 이전에 대해 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	transfer_id required	볼륨 이전 ID Example : `1ac231be-823b-4a4d-8ff0-aac503a7118a`	string	None

Responses

HTTP Code	Description	Schema
200	OK	VolumeTransferShowResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/volume-transfer/{transfer_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 = virtualserver 1.1"

Example HTTP response

Response 200

{
    "created_at": "2025-07-22T09:00:00Z",
    "id": "1ac231be-823b-4a4d-8ff0-aac503a7118a",
    "name": "volume01",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

4.1.94.3 - 1.0

get /v1/volume-transfer/{transfer_id}

Description

볼륨 이전에 대해 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	transfer_id required	볼륨 이전 ID Example : `1ac231be-823b-4a4d-8ff0-aac503a7118a`	string	None

Responses

HTTP Code	Description	Schema
200	OK	VolumeTransferShowResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/volume-transfer/{transfer_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 = virtualserver 1.0"

Example HTTP response

Response 200

{
    "created_at": "2025-07-22T09:00:00Z",
    "id": "1ac231be-823b-4a4d-8ff0-aac503a7118a",
    "name": "volume01",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

4.1.95 - Show Volume type’s details

4.1.95.1 - 1.2

get /v1/volume-types/{volume_type_id}

Description

볼륨 유형을 상세 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	volume_type_id required	볼륨 유형 ID Example : `c643ac35-3aec-43e6-b97a-3d6f666c5207`	string	None

Responses

HTTP Code	Description	Schema
200	OK	VolumeTypeDetailResponse
400	Bad Request	None
401	Unauthorized	None
500	Internal Server Error	None

Example HTTP request

Request path

/v1/volume-types/{volume_type_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 = virtualserver 1.2"

Example HTTP response

Response 200

{
    "description": "Volume type description",
    "extra_specs": {
        "multiattach": "<is> True"
    },
    "id": "c643ac35-3aec-43e6-b97a-3d6f666c5207",
    "name": "SSD"
}

4.1.95.2 - 1.1

get /v1/volume-types/{volume_type_id}

Description

볼륨 유형을 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	volume_type_id required	볼륨 유형 ID Example : `c643ac35-3aec-43e6-b97a-3d6f666c5207`	string	None

Responses

HTTP Code	Description	Schema
200	OK	VolumeTypeDetailResponse
400	Bad Request	None
401	Unauthorized	None
500	Internal Server Error	None

Example HTTP request

Request path

/v1/volume-types/{volume_type_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 = virtualserver 1.1"

Example HTTP response

Response 200

{
    "description": "Volume type description",
    "extra_specs": {
        "multiattach": "<is> True"
    },
    "id": "c643ac35-3aec-43e6-b97a-3d6f666c5207",
    "name": "SSD"
}

4.1.95.3 - 1.0

get /v1/volume-types/{volume_type_id}

Description

볼륨 유형을 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	volume_type_id required	볼륨 유형 ID Example : `c643ac35-3aec-43e6-b97a-3d6f666c5207`	string	None

Responses

HTTP Code	Description	Schema
200	OK	VolumeTypeDetailResponse
400	Bad Request	None
401	Unauthorized	None
500	Internal Server Error	None

Example HTTP request

Request path

/v1/volume-types/{volume_type_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 = virtualserver 1.0"

Example HTTP response

Response 200

{
    "description": "Volume type description",
    "extra_specs": {
        "multiattach": "<is> True"
    },
    "id": "c643ac35-3aec-43e6-b97a-3d6f666c5207",
    "name": "SSD"
}

4.1.96 - Show Volume's details

4.1.96.1 - 1.2

get /v1/volumes/{volume_id}

Description

볼륨을 상세 조회합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string	None

Responses

HTTP Code	Description	Schema
200	OK	VolumeShowResponseV1Dot2
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/volumes/{volume_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 = virtualserver 1.2"

Example HTTP response

Response 200

{
    "bootable": false,
    "created_at": "2026-04-14T15:06:31.797Z",
    "encrypted": true,
    "id": "3f500f00-ed80-4566-a057-e31760226f9a",
    "max_iops": 10000,
    "max_throughput": 500,
    "modified_at": "2025-07-26T12:00:00Z",
    "multiattach": false,
    "name": "volume01",
    "servers": [
        {
            "attached_at": "2026-04-14T15:06:30.712Z",
            "device": "/dev/vda",
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f"
        }
    ],
    "size": 104,
    "snapshot_id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790",
    "state": "available",
    "user_id": "570907805e5447be84b618450ef52o0t",
    "volume_image_metadata": {
        "checksum": "7538e0fcb56e0e272cfd89eb384d6613",
        "container_format": "bare",
        "disk_format": "qcow2",
        "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
        "image_name": "imagename",
        "min_disk": 100,
        "min_ram": 0,
        "os_distro": "alma",
        "scp_image_type": "custom",
        "scp_k8s_version": "v1.28.7",
        "scp_original_image_type": "standard",
        "signature_verified": false,
        "size": 2429747200
    },
    "volume_type": "SSD",
    "volume_type_id": "c643ac35-3aec-43e6-b97a-3d6f666c5207"
}

4.1.96.2 - 1.1

get /v1/volumes/{volume_id}

Description

볼륨을 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string	None

Responses

HTTP Code	Description	Schema
200	OK	VolumeShowResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/volumes/{volume_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 = virtualserver 1.1"

Example HTTP response

Response 200

{
    "bootable": false,
    "created_at": "2026-04-14T15:06:30.677Z",
    "encrypted": true,
    "id": "3f500f00-ed80-4566-a057-e31760226f9a",
    "modified_at": "2025-07-26T12:00:00Z",
    "multiattach": false,
    "name": "volume01",
    "servers": [
        {
            "attached_at": "2026-04-14T15:06:30.712Z",
            "device": "/dev/vda",
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f"
        }
    ],
    "size": 104,
    "snapshot_id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790",
    "state": "available",
    "user_id": "570907805e5447be84b618450ef52o0t",
    "volume_image_metadata": {
        "checksum": "7538e0fcb56e0e272cfd89eb384d6613",
        "container_format": "bare",
        "disk_format": "qcow2",
        "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
        "image_name": "imagename",
        "min_disk": 100,
        "min_ram": 0,
        "os_distro": "alma",
        "scp_image_type": "custom",
        "scp_k8s_version": "v1.28.7",
        "scp_original_image_type": "standard",
        "signature_verified": false,
        "size": 2429747200
    },
    "volume_type": "SSD",
    "volume_type_id": "c643ac35-3aec-43e6-b97a-3d6f666c5207"
}

4.1.96.3 - 1.0

get /v1/volumes/{volume_id}

Description

볼륨을 상세 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string	None

Responses

HTTP Code	Description	Schema
200	OK	VolumeShowResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/volumes/{volume_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 = virtualserver 1.0"

Example HTTP response

Response 200

{
    "bootable": false,
    "created_at": "2026-04-14T15:06:30.677Z",
    "encrypted": true,
    "id": "3f500f00-ed80-4566-a057-e31760226f9a",
    "modified_at": "2025-07-26T12:00:00Z",
    "multiattach": false,
    "name": "volume01",
    "servers": [
        {
            "attached_at": "2026-04-14T15:06:30.712Z",
            "device": "/dev/vda",
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f"
        }
    ],
    "size": 104,
    "snapshot_id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790",
    "state": "available",
    "user_id": "570907805e5447be84b618450ef52o0t",
    "volume_image_metadata": {
        "checksum": "7538e0fcb56e0e272cfd89eb384d6613",
        "container_format": "bare",
        "disk_format": "qcow2",
        "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
        "image_name": "imagename",
        "min_disk": 100,
        "min_ram": 0,
        "os_distro": "alma",
        "scp_image_type": "custom",
        "scp_k8s_version": "v1.28.7",
        "scp_original_image_type": "standard",
        "signature_verified": false,
        "size": 2429747200
    },
    "volume_type": "SSD",
    "volume_type_id": "c643ac35-3aec-43e6-b97a-3d6f666c5207"
}

4.1.97 - Start Virtual Server

4.1.97.1 - 1.2

post /v1/servers/{server_id}/start

Description

서버를 시작합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/start

Request header

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

Example HTTP response

Response 202

4.1.97.2 - 1.1

post /v1/servers/{server_id}/start

Description

서버를 시작합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/start

Request header

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

Example HTTP response

Response 202

4.1.97.3 - 1.0

post /v1/servers/{server_id}/start

Description

서버를 시작합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/start

Request header

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

Example HTTP response

Response 202

4.1.98 - Stop Virtual Server

4.1.98.1 - 1.2

post /v1/servers/{server_id}/stop

Description

서버를 중지합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/stop

Request header

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

Example HTTP response

Response 202

4.1.98.2 - 1.1

post /v1/servers/{server_id}/stop

Description

서버를 중지합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/stop

Request header

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

Example HTTP response

Response 202

4.1.98.3 - 1.0

post /v1/servers/{server_id}/stop

Description

서버를 중지합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/stop

Request header

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

Example HTTP response

Response 202

4.1.99 - Unlock Virtual Server

4.1.99.1 - 1.2

post /v1/servers/{server_id}/unlock

Description

서버 잠금을 해제합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/servers/{server_id}/unlock

Request header

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

Example HTTP response

Response 202

4.1.99.2 - 1.1

post /v1/servers/{server_id}/unlock

Description

서버 잠금을 해제합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/servers/{server_id}/unlock

Request header

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

Example HTTP response

Response 202

4.1.99.3 - 1.0

post /v1/servers/{server_id}/unlock

Description

서버 잠금을 해제합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/servers/{server_id}/unlock

Request header

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

Example HTTP response

Response 202

4.1.100 - Update a snapshot

4.1.100.1 - 1.2

put /v1/snapshots/{snapshot_id}

Description

Snapshot을 수정합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	snapshot_id required	스냅샷 ID Example : `cceed636-1f1e-4bb0-b85c-4e5b9e0bf790`	string	None
body	body required		SnapshotUpdateRequest

Responses

HTTP Code	Description	Schema
200	OK	SnapshotDetailResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/snapshots/{snapshot_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 = virtualserver 1.2"

Request body

{
    "description": "description",
    "name": "snapshot-1"
}

Example HTTP response

Response 200

{
    "created_at": "2025-07-22T09:00:00Z",
    "description": "description",
    "id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790",
    "metadata": "Metadata",
    "name": "snapshot-1",
    "size": 104,
    "status": "available",
    "updated_at": "2025-07-26T12:00:00Z",
    "user_id": "570907805e5447be84b618450ef52o0t",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

4.1.100.2 - 1.1

put /v1/snapshots/{snapshot_id}

Description

Snapshot을 수정합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	snapshot_id required	스냅샷 ID Example : `cceed636-1f1e-4bb0-b85c-4e5b9e0bf790`	string	None
body	body required		SnapshotUpdateRequest

Responses

HTTP Code	Description	Schema
200	OK	SnapshotDetailResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/snapshots/{snapshot_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 = virtualserver 1.1"

Request body

{
    "description": "description",
    "name": "snapshot-1"
}

Example HTTP response

Response 200

{
    "created_at": "2025-07-22T09:00:00Z",
    "description": "description",
    "id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790",
    "metadata": "Metadata",
    "name": "snapshot-1",
    "size": 104,
    "status": "available",
    "updated_at": "2025-07-26T12:00:00Z",
    "user_id": "570907805e5447be84b618450ef52o0t",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

4.1.100.3 - 1.0

put /v1/snapshots/{snapshot_id}

Description

Snapshot을 수정합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	snapshot_id required	스냅샷 ID Example : `cceed636-1f1e-4bb0-b85c-4e5b9e0bf790`	string	None
body	body required		SnapshotUpdateRequest

Responses

HTTP Code	Description	Schema
200	OK	SnapshotDetailResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/snapshots/{snapshot_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 = virtualserver 1.0"

Request body

{
    "description": "description",
    "name": "snapshot-1"
}

Example HTTP response

Response 200

{
    "created_at": "2025-07-22T09:00:00Z",
    "description": "description",
    "id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790",
    "metadata": "Metadata",
    "name": "snapshot-1",
    "size": 104,
    "status": "available",
    "updated_at": "2025-07-26T12:00:00Z",
    "user_id": "570907805e5447be84b618450ef52o0t",
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

4.1.101 - Update Auto-Scaling Group

4.1.101.1 - 1.2

put /v1/auto-scaling-groups/{auto_scaling_group_id}

Description

Auto-Scaling Group을 수정합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
body	body required		AutoScalingGroupSetRequestV1Dot2

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupShowResponseV1Dot2
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_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 = virtualserver 1.2"

Request body

{
    "desired_server_count_editable": true,
    "drain_enabled": true,
    "drain_timeout": 300,
    "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
    "security_group_ids": [
        "c09c3f05-03d9-443f-b27a-40e0f973c75f"
    ],
    "state_check_delay_time": 300,
    "use_lb_state_check": true
}

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "desired_server_count": 1,
    "desired_server_count_editable": true,
    "drain_enabled": true,
    "drain_timeout": 300,
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
    "launch_configuration_name": "launch-configuration-name",
    "lb_server_groups": [],
    "max_server_count": 2,
    "min_server_count": 1,
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "auto-scaling-group-name",
    "security_group_ids": [
        "c09c3f05-03d9-443f-b27a-40e0f973c75f"
    ],
    "server_name_prefix": "server-name-prefix",
    "state": "IN_SERVICE",
    "state_check_delay_time": 300,
    "subnet_ids": [],
    "total_server_count": 1,
    "use_lb_state_check": true,
    "vpc_id": "cc976b621087484ea5fd527f4b78708b"
}

4.1.101.2 - 1.1

put /v1/auto-scaling-groups/{auto_scaling_group_id}

Description

Auto-Scaling Group을 수정합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
body	body required		AutoScalingGroupSetRequest

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_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 = virtualserver 1.1"

Request body

{
    "desired_server_count_editable": true,
    "drain_enabled": true,
    "drain_timeout": 300,
    "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
    "security_group_ids": [
        "c09c3f05-03d9-443f-b27a-40e0f973c75f"
    ]
}

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "desired_server_count": 1,
    "desired_server_count_editable": true,
    "drain_enabled": true,
    "drain_timeout": 300,
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
    "launch_configuration_name": "launch-configuration-name",
    "lb_server_groups": [],
    "max_server_count": 2,
    "min_server_count": 1,
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "auto-scaling-group-name",
    "security_group_ids": [
        "c09c3f05-03d9-443f-b27a-40e0f973c75f"
    ],
    "server_name_prefix": "server-name-prefix",
    "state": "IN_SERVICE",
    "subnet_ids": [],
    "total_server_count": 1,
    "vpc_id": "cc976b621087484ea5fd527f4b78708b"
}

4.1.101.3 - 1.0

put /v1/auto-scaling-groups/{auto_scaling_group_id}

Description

Auto-Scaling Group을 수정합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
body	body required		AutoScalingGroupSetRequest

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_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 = virtualserver 1.0"

Request body

{
    "desired_server_count_editable": true,
    "drain_enabled": true,
    "drain_timeout": 300,
    "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
    "security_group_ids": [
        "c09c3f05-03d9-443f-b27a-40e0f973c75f"
    ]
}

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "desired_server_count": 1,
    "desired_server_count_editable": true,
    "drain_enabled": true,
    "drain_timeout": 300,
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
    "launch_configuration_name": "launch-configuration-name",
    "lb_server_groups": [],
    "max_server_count": 2,
    "min_server_count": 1,
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "auto-scaling-group-name",
    "security_group_ids": [
        "c09c3f05-03d9-443f-b27a-40e0f973c75f"
    ],
    "server_name_prefix": "server-name-prefix",
    "state": "IN_SERVICE",
    "subnet_ids": [],
    "total_server_count": 1,
    "vpc_id": "cc976b621087484ea5fd527f4b78708b"
}

4.1.102 - Update Auto-Scaling Group LB Server Groups

4.1.102.1 - 1.2

put /v1/auto-scaling-groups/{auto_scaling_group_id}/lb-server-groups

Description

Auto-Scaling Group LB 서버 그룹을 수정합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
body	body required		AutoScalingGroupLbServerGroupSetRequest

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/lb-server-groups

Request header

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

Request body

{
    "lb_server_groups": [
        {
            "id": "d06e87d3-ca9a-461b-8e88-077a542a7335",
            "port": 8080
        }
    ]
}

Example HTTP response

Response 202

4.1.102.2 - 1.1

put /v1/auto-scaling-groups/{auto_scaling_group_id}/lb-server-groups

Description

Auto-Scaling Group LB 서버 그룹을 수정합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
body	body required		AutoScalingGroupLbServerGroupSetRequest

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/lb-server-groups

Request header

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

Request body

{
    "lb_server_groups": [
        {
            "id": "d06e87d3-ca9a-461b-8e88-077a542a7335",
            "port": 8080
        }
    ]
}

Example HTTP response

Response 202

4.1.102.3 - 1.0

put /v1/auto-scaling-groups/{auto_scaling_group_id}/lb-server-groups

Description

Auto-Scaling Group LB 서버 그룹을 수정합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
body	body required		AutoScalingGroupLbServerGroupSetRequest

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/lb-server-groups

Request header

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

Request body

{
    "lb_server_groups": [
        {
            "id": "d06e87d3-ca9a-461b-8e88-077a542a7335",
            "port": 8080
        }
    ]
}

Example HTTP response

Response 202

4.1.103 - Update Auto-Scaling Group Notification

4.1.103.1 - 1.2

put /v1/auto-scaling-groups/{auto_scaling_group_id}/notifications/{notification_id}

Description

Auto-Scaling Group 알림을 수정합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
path	notification_id required	Auto-Scaling Grou 알림 ID Example : `fa7fd191410744cd810a290c0b4d22b9`	string	None
body	body required		AutoScalingGroupNotificationUpdateRequest

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupNotificationShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/notifications/{notification_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 = virtualserver 1.2"

Request body

{
    "notification_events": [
        "SCALE_OUT",
        "SCALE_OUT_FAIL"
    ],
    "notification_state": "ACTIVE"
}

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "notification_events": [
        "SCALE_OUT",
        "SCALE_OUT_FAIL"
    ],
    "notification_state": "ACTIVE",
    "user_email": "scpuser@samsung.com",
    "user_id": "570907805e5447be84b618450ef52o0t",
    "user_name": "scpuser"
}

4.1.103.2 - 1.1

put /v1/auto-scaling-groups/{auto_scaling_group_id}/notifications/{notification_id}

Description

Auto-Scaling Group 알림을 수정합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
path	notification_id required	Auto-Scaling Grou 알림 ID Example : `fa7fd191410744cd810a290c0b4d22b9`	string	None
body	body required		AutoScalingGroupNotificationUpdateRequest

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupNotificationShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/notifications/{notification_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 = virtualserver 1.1"

Request body

{
    "notification_events": [
        "SCALE_OUT",
        "SCALE_OUT_FAIL"
    ],
    "notification_state": "ACTIVE"
}

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "notification_events": [
        "SCALE_OUT",
        "SCALE_OUT_FAIL"
    ],
    "notification_state": "ACTIVE",
    "user_email": "scpuser@samsung.com",
    "user_id": "570907805e5447be84b618450ef52o0t",
    "user_name": "scpuser"
}

4.1.103.3 - 1.0

put /v1/auto-scaling-groups/{auto_scaling_group_id}/notifications/{notification_id}

Description

Auto-Scaling Group 알림을 수정합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
path	notification_id required	Auto-Scaling Grou 알림 ID Example : `fa7fd191410744cd810a290c0b4d22b9`	string	None
body	body required		AutoScalingGroupNotificationUpdateRequest

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupNotificationShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/notifications/{notification_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 = virtualserver 1.0"

Request body

{
    "notification_events": [
        "SCALE_OUT",
        "SCALE_OUT_FAIL"
    ],
    "notification_state": "ACTIVE"
}

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "notification_events": [
        "SCALE_OUT",
        "SCALE_OUT_FAIL"
    ],
    "notification_state": "ACTIVE",
    "user_email": "scpuser@samsung.com",
    "user_id": "570907805e5447be84b618450ef52o0t",
    "user_name": "scpuser"
}

4.1.104 - Update Auto-Scaling Group Policy

4.1.104.1 - 1.2

put /v1/auto-scaling-groups/{auto_scaling_group_id}/policies/{policy_id}

Description

Auto-Scaling Group 정책을 수정합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
path	policy_id required	정책 ID Example : `0761d76085f54363bab07909baf69841`	string	None
body	body required		AutoScalingGroupPolicyUpdateRequestV1Dot2

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupPolicyShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/policies/{policy_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 = virtualserver 1.2"

Request body

{
    "comparison_operator": "ge",
    "cooldown_seconds": 300,
    "evaluation_minutes": 5,
    "metric_method": "AVG",
    "metric_type": "CPU",
    "scale_method": "AMOUNT",
    "scale_type": "SCALE_OUT",
    "scale_value": 10,
    "state": "ACTIVE",
    "threshold": 60
}

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
    "comparison_operator": "ge",
    "cooldown_seconds": 300,
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "evaluation_minutes": 5,
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "metric_method": "AVG",
    "metric_type": "CPU",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "policy-name",
    "scale_method": "AMOUNT",
    "scale_type": "SCALE_OUT",
    "scale_value": 10,
    "state": "ACTIVE",
    "threshold": 60,
    "threshold_unit": "%"
}

4.1.104.2 - 1.1

put /v1/auto-scaling-groups/{auto_scaling_group_id}/policies/{policy_id}

Description

Auto-Scaling Group 정책을 수정합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
path	policy_id required	정책 ID Example : `0761d76085f54363bab07909baf69841`	string	None
body	body required		AutoScalingGroupPolicyUpdateRequest

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupPolicyShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/policies/{policy_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 = virtualserver 1.1"

Request body

{
    "comparison_operator": "ge",
    "cooldown_seconds": 300,
    "evaluation_minutes": 5,
    "metric_method": "AVG",
    "metric_type": "CPU",
    "name": "policy-name",
    "scale_method": "AMOUNT",
    "scale_type": "SCALE_OUT",
    "scale_value": 10,
    "state": "ACTIVE",
    "threshold": 60
}

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
    "comparison_operator": "ge",
    "cooldown_seconds": 300,
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "evaluation_minutes": 5,
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "metric_method": "AVG",
    "metric_type": "CPU",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "policy-name",
    "scale_method": "AMOUNT",
    "scale_type": "SCALE_OUT",
    "scale_value": 10,
    "state": "ACTIVE",
    "threshold": 60,
    "threshold_unit": "%"
}

4.1.104.3 - 1.0

put /v1/auto-scaling-groups/{auto_scaling_group_id}/policies/{policy_id}

Description

Auto-Scaling Group 정책을 수정합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
path	policy_id required	정책 ID Example : `0761d76085f54363bab07909baf69841`	string	None
body	body required		AutoScalingGroupPolicyUpdateRequest

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupPolicyShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/policies/{policy_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 = virtualserver 1.0"

Request body

{
    "comparison_operator": "ge",
    "cooldown_seconds": 300,
    "evaluation_minutes": 5,
    "metric_method": "AVG",
    "metric_type": "CPU",
    "name": "policy-name",
    "scale_method": "AMOUNT",
    "scale_type": "SCALE_OUT",
    "scale_value": 10,
    "state": "ACTIVE",
    "threshold": 60
}

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
    "comparison_operator": "ge",
    "cooldown_seconds": 300,
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "evaluation_minutes": 5,
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "metric_method": "AVG",
    "metric_type": "CPU",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "policy-name",
    "scale_method": "AMOUNT",
    "scale_type": "SCALE_OUT",
    "scale_value": 10,
    "state": "ACTIVE",
    "threshold": 60,
    "threshold_unit": "%"
}

4.1.105 - Update Auto-Scaling Group Schedule

4.1.105.1 - 1.2

put /v1/auto-scaling-groups/{auto_scaling_group_id}/schedules/{schedule_id}

Description

Auto-Scaling Group 스케줄을 수정합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
path	schedule_id required	스케줄 ID Example : `43d4841abd404220af5f0904037aba71`	string	None
body	body required		AutoScalingGroupScheduleUpdateRequest

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupScheduleShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/schedules/{schedule_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 = virtualserver 1.2"

Request body

{
    "day_of_month": "-1,1",
    "day_of_week": "SU,SA",
    "description": "description",
    "desired_server_count": 1,
    "end_date": "2025-01-01",
    "frequency": "WEEKLY",
    "hour": 9,
    "max_server_count": 2,
    "min_server_count": 1,
    "minute": 0,
    "name": "schedulename",
    "start_date": "2024-01-01",
    "state": "ACTIVE",
    "timezone": "Asia/Seoul"
}

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "day_of_month": "-1,1",
    "day_of_week": "SU,SA",
    "description": "description",
    "desired_server_count": 1,
    "end_date": "2025-01-01",
    "frequency": "WEEKLY",
    "hour": 9,
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "max_server_count": 2,
    "min_server_count": 1,
    "minute": 0,
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "schedulename",
    "start_date": "2024-01-01",
    "state": "ACTIVE",
    "timezone": "Asia/Seoul"
}

4.1.105.2 - 1.1

put /v1/auto-scaling-groups/{auto_scaling_group_id}/schedules/{schedule_id}

Description

Auto-Scaling Group 스케줄을 수정합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
path	schedule_id required	스케줄 ID Example : `43d4841abd404220af5f0904037aba71`	string	None
body	body required		AutoScalingGroupScheduleUpdateRequest

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupScheduleShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/schedules/{schedule_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 = virtualserver 1.1"

Request body

{
    "day_of_month": "-1,1",
    "day_of_week": "SU,SA",
    "description": "description",
    "desired_server_count": 1,
    "end_date": "2025-01-01",
    "frequency": "WEEKLY",
    "hour": 9,
    "max_server_count": 2,
    "min_server_count": 1,
    "minute": 0,
    "name": "schedulename",
    "start_date": "2024-01-01",
    "state": "ACTIVE",
    "timezone": "Asia/Seoul"
}

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "day_of_month": "-1,1",
    "day_of_week": "SU,SA",
    "description": "description",
    "desired_server_count": 1,
    "end_date": "2025-01-01",
    "frequency": "WEEKLY",
    "hour": 9,
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "max_server_count": 2,
    "min_server_count": 1,
    "minute": 0,
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "schedulename",
    "start_date": "2024-01-01",
    "state": "ACTIVE",
    "timezone": "Asia/Seoul"
}

4.1.105.3 - 1.0

put /v1/auto-scaling-groups/{auto_scaling_group_id}/schedules/{schedule_id}

Description

Auto-Scaling Group 스케줄을 수정합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
path	schedule_id required	스케줄 ID Example : `43d4841abd404220af5f0904037aba71`	string	None
body	body required		AutoScalingGroupScheduleUpdateRequest

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupScheduleShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/schedules/{schedule_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 = virtualserver 1.0"

Request body

{
    "day_of_month": "-1,1",
    "day_of_week": "SU,SA",
    "description": "description",
    "desired_server_count": 1,
    "end_date": "2025-01-01",
    "frequency": "WEEKLY",
    "hour": 9,
    "max_server_count": 2,
    "min_server_count": 1,
    "minute": 0,
    "name": "schedulename",
    "start_date": "2024-01-01",
    "state": "ACTIVE",
    "timezone": "Asia/Seoul"
}

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "day_of_month": "-1,1",
    "day_of_week": "SU,SA",
    "description": "description",
    "desired_server_count": 1,
    "end_date": "2025-01-01",
    "frequency": "WEEKLY",
    "hour": 9,
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "max_server_count": 2,
    "min_server_count": 1,
    "minute": 0,
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "schedulename",
    "start_date": "2024-01-01",
    "state": "ACTIVE",
    "timezone": "Asia/Seoul"
}

4.1.106 - Update Auto-Scaling Group server count

4.1.106.1 - 1.2

put /v1/auto-scaling-groups/{auto_scaling_group_id}/server-count

Description

Auto-Scaling Group 서버 수를 수정합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
body	body required		AutoScalingGroupSetServerCountRequest

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupShowResponseV1Dot2
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/server-count

Request header

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

Request body

{
    "desired_server_count": 1,
    "max_server_count": 2,
    "min_server_count": 1
}

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "desired_server_count": 1,
    "desired_server_count_editable": true,
    "drain_enabled": true,
    "drain_timeout": 300,
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
    "launch_configuration_name": "launch-configuration-name",
    "lb_server_groups": [],
    "max_server_count": 2,
    "min_server_count": 1,
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "auto-scaling-group-name",
    "security_group_ids": [
        "c09c3f05-03d9-443f-b27a-40e0f973c75f"
    ],
    "server_name_prefix": "server-name-prefix",
    "state": "IN_SERVICE",
    "state_check_delay_time": 300,
    "subnet_ids": [],
    "total_server_count": 1,
    "use_lb_state_check": true,
    "vpc_id": "cc976b621087484ea5fd527f4b78708b"
}

4.1.106.2 - 1.1

put /v1/auto-scaling-groups/{auto_scaling_group_id}/server-count

Description

Auto-Scaling Group 서버 수를 수정합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
body	body required		AutoScalingGroupSetServerCountRequest

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/server-count

Request header

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

Request body

{
    "desired_server_count": 1,
    "max_server_count": 2,
    "min_server_count": 1
}

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "desired_server_count": 1,
    "desired_server_count_editable": true,
    "drain_enabled": true,
    "drain_timeout": 300,
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
    "launch_configuration_name": "launch-configuration-name",
    "lb_server_groups": [],
    "max_server_count": 2,
    "min_server_count": 1,
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "auto-scaling-group-name",
    "security_group_ids": [
        "c09c3f05-03d9-443f-b27a-40e0f973c75f"
    ],
    "server_name_prefix": "server-name-prefix",
    "state": "IN_SERVICE",
    "subnet_ids": [],
    "total_server_count": 1,
    "vpc_id": "cc976b621087484ea5fd527f4b78708b"
}

4.1.106.3 - 1.0

put /v1/auto-scaling-groups/{auto_scaling_group_id}/server-count

Description

Auto-Scaling Group 서버 수를 수정합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string	None
body	body required		AutoScalingGroupSetServerCountRequest

Responses

HTTP Code	Description	Schema
200	OK	AutoScalingGroupShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/auto-scaling-groups/{auto_scaling_group_id}/server-count

Request header

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

Request body

{
    "desired_server_count": 1,
    "max_server_count": 2,
    "min_server_count": 1
}

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "desired_server_count": 1,
    "desired_server_count_editable": true,
    "drain_enabled": true,
    "drain_timeout": 300,
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
    "launch_configuration_name": "launch-configuration-name",
    "lb_server_groups": [],
    "max_server_count": 2,
    "min_server_count": 1,
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "auto-scaling-group-name",
    "security_group_ids": [
        "c09c3f05-03d9-443f-b27a-40e0f973c75f"
    ],
    "server_name_prefix": "server-name-prefix",
    "state": "IN_SERVICE",
    "subnet_ids": [],
    "total_server_count": 1,
    "vpc_id": "cc976b621087484ea5fd527f4b78708b"
}

4.1.107 - Update Image

4.1.107.1 - 1.2

put /v1/images/{image_id}

Description

이미지를 수정합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string	None
body	body required		ImageSetRequest

Responses

HTTP Code	Description	Schema
200	OK	ImageShowResponseV1Dot2
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/images/{image_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 = virtualserver 1.2"

Request body

{
    "min_disk": 100,
    "min_ram": 0,
    "protected": false,
    "visibility": "private"
}

Example HTTP response

Response 200

{
    "checksum": "7538e0fcb56e0e272cfd89eb384d6613",
    "container_format": "bare",
    "created_at": "2025-07-22T09:00:00Z",
    "disk_format": "qcow2",
    "file": "/v2/images/e08a37c1-2162-416e-b7fa-19902419170b/file",
    "id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "min_disk": 100,
    "min_ram": 0,
    "name": "imagename",
    "os_distro": "alma",
    "os_hash_algo": "sha512",
    "os_hash_value": "c6a32fc3b7c909b8900b46f5e6066c028a1d799c0a263cf064a600c430a714627c21f98ac248e2f2bf29870a1a2773c7908244745016878e1a5f31dc2c405b99",
    "os_hidden": false,
    "owner": "a8f10467abfc4b87b64614ab36eb9ae4",
    "owner_account_name": "AccountName",
    "owner_user_name": "user@samsung.com",
    "protected": false,
    "root_device_name": "/dev/vda",
    "scp_gpu_driver": "535.183.06",
    "scp_image_type": "custom",
    "scp_k8s_version": "v1.28.7",
    "scp_original_image_type": "standard",
    "scp_os_build_version": "20250101",
    "scp_os_version": "8.8",
    "size": 2429747200,
    "status": "active",
    "updated_at": "2025-07-26T12:00:00Z",
    "url": "https://object-store.kr-west1.s.samsungsdscloud.com/8989447062e04a818baf9e073fd04fa7/bucket/object.qcow2",
    "virtual_size": 17179869184,
    "visibility": "private",
    "volumes": "[{\"tag\": null, \"volume_id\": null, \"encryption_options\": null, \"encryption_secret_uuid\": null, \"encryption_format\": null, \"device_name\": \"/dev/vda\", \"disk_bus\": \"virtio\", \"volume_type\": null, \"encrypted\": null, \"image_id\": null, \"device_type\": \"disk\", \"source_type\": \"snapshot\", \"delete_on_termination\": false, \"volume_size\": 104, \"guest_format\": null, \"boot_index\": 0, \"destination_type\": \"volume\", \"snapshot_id\": \"abde9e38-2ed5-4ecd-b23c-b0120e30690e\", \"no_device\": null}]"
}

4.1.107.2 - 1.1

put /v1/images/{image_id}

Description

이미지를 수정합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string	None
body	body required		ImageSetRequest

Responses

HTTP Code	Description	Schema
200	OK	ImageShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/images/{image_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 = virtualserver 1.1"

Request body

{
    "min_disk": 100,
    "min_ram": 0,
    "protected": false,
    "visibility": "private"
}

Example HTTP response

Response 200

{
    "checksum": "7538e0fcb56e0e272cfd89eb384d6613",
    "container_format": "bare",
    "created_at": "2025-07-22T09:00:00Z",
    "disk_format": "qcow2",
    "file": "/v2/images/e08a37c1-2162-416e-b7fa-19902419170b/file",
    "id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "min_disk": 100,
    "min_ram": 0,
    "name": "imagename",
    "os_distro": "alma",
    "os_hash_algo": "sha512",
    "os_hash_value": "c6a32fc3b7c909b8900b46f5e6066c028a1d799c0a263cf064a600c430a714627c21f98ac248e2f2bf29870a1a2773c7908244745016878e1a5f31dc2c405b99",
    "os_hidden": false,
    "owner": "a8f10467abfc4b87b64614ab36eb9ae4",
    "owner_account_name": "AccountName",
    "owner_user_name": "user@samsung.com",
    "protected": false,
    "root_device_name": "/dev/vda",
    "scp_image_type": "custom",
    "scp_k8s_version": "v1.28.7",
    "scp_original_image_type": "standard",
    "scp_os_build_version": "20250101",
    "scp_os_version": "8.8",
    "size": 2429747200,
    "status": "active",
    "updated_at": "2025-07-26T12:00:00Z",
    "url": "https://object-store.kr-west1.s.samsungsdscloud.com/8989447062e04a818baf9e073fd04fa7/bucket/object.qcow2",
    "virtual_size": 17179869184,
    "visibility": "private",
    "volumes": "[{\"tag\": null, \"volume_id\": null, \"encryption_options\": null, \"encryption_secret_uuid\": null, \"encryption_format\": null, \"device_name\": \"/dev/vda\", \"disk_bus\": \"virtio\", \"volume_type\": null, \"encrypted\": null, \"image_id\": null, \"device_type\": \"disk\", \"source_type\": \"snapshot\", \"delete_on_termination\": false, \"volume_size\": 104, \"guest_format\": null, \"boot_index\": 0, \"destination_type\": \"volume\", \"snapshot_id\": \"abde9e38-2ed5-4ecd-b23c-b0120e30690e\", \"no_device\": null}]"
}

4.1.107.3 - 1.0

put /v1/images/{image_id}

Description

이미지를 수정합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string	None
body	body required		ImageSetRequest

Responses

HTTP Code	Description	Schema
200	OK	ImageShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/images/{image_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 = virtualserver 1.0"

Request body

{
    "min_disk": 100,
    "min_ram": 0,
    "protected": false,
    "visibility": "private"
}

Example HTTP response

Response 200

{
    "checksum": "7538e0fcb56e0e272cfd89eb384d6613",
    "container_format": "bare",
    "created_at": "2025-07-22T09:00:00Z",
    "disk_format": "qcow2",
    "file": "/v2/images/e08a37c1-2162-416e-b7fa-19902419170b/file",
    "id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "min_disk": 100,
    "min_ram": 0,
    "name": "imagename",
    "os_distro": "alma",
    "os_hash_algo": "sha512",
    "os_hash_value": "c6a32fc3b7c909b8900b46f5e6066c028a1d799c0a263cf064a600c430a714627c21f98ac248e2f2bf29870a1a2773c7908244745016878e1a5f31dc2c405b99",
    "os_hidden": false,
    "owner": "a8f10467abfc4b87b64614ab36eb9ae4",
    "owner_account_name": "AccountName",
    "owner_user_name": "user@samsung.com",
    "protected": false,
    "root_device_name": "/dev/vda",
    "scp_image_type": "custom",
    "scp_k8s_version": "v1.28.7",
    "scp_original_image_type": "standard",
    "scp_os_build_version": "20250101",
    "scp_os_version": "8.8",
    "size": 2429747200,
    "status": "active",
    "updated_at": "2025-07-26T12:00:00Z",
    "url": "https://object-store.kr-west1.s.samsungsdscloud.com/8989447062e04a818baf9e073fd04fa7/bucket/object.qcow2",
    "virtual_size": 17179869184,
    "visibility": "private",
    "volumes": "[{\"tag\": null, \"volume_id\": null, \"encryption_options\": null, \"encryption_secret_uuid\": null, \"encryption_format\": null, \"device_name\": \"/dev/vda\", \"disk_bus\": \"virtio\", \"volume_type\": null, \"encrypted\": null, \"image_id\": null, \"device_type\": \"disk\", \"source_type\": \"snapshot\", \"delete_on_termination\": false, \"volume_size\": 104, \"guest_format\": null, \"boot_index\": 0, \"destination_type\": \"volume\", \"snapshot_id\": \"abde9e38-2ed5-4ecd-b23c-b0120e30690e\", \"no_device\": null}]"
}

4.1.108 - Update Image member

4.1.108.1 - 1.2

put /v1/images/{image_id}/members/{member_id}

Description

이미지 멤버를 수정합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string	None
path	member_id required	공유용 이미지 멤버 ID Example : `a8f10467abfc4b87b64614ab36eb9ae4`	string	None
body	body required		ImageMemberSetRequest

Responses

HTTP Code	Description	Schema
200	OK	ImageMemberShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/images/{image_id}/members/{member_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 = virtualserver 1.2"

Request body

{
    "status": "pending"
}

Example HTTP response

Response 200

{
    "created_at": "2025-07-22T09:00:00Z",
    "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "member_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "status": "pending",
    "updated_at": "2025-07-26T12:00:00Z"
}

4.1.108.2 - 1.1

put /v1/images/{image_id}/members/{member_id}

Description

이미지 멤버를 수정합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string	None
path	member_id required	공유용 이미지 멤버 ID Example : `a8f10467abfc4b87b64614ab36eb9ae4`	string	None
body	body required		ImageMemberSetRequest

Responses

HTTP Code	Description	Schema
200	OK	ImageMemberShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/images/{image_id}/members/{member_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 = virtualserver 1.1"

Request body

{
    "status": "pending"
}

Example HTTP response

Response 200

{
    "created_at": "2025-07-22T09:00:00Z",
    "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "member_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "status": "pending",
    "updated_at": "2025-07-26T12:00:00Z"
}

4.1.108.3 - 1.0

put /v1/images/{image_id}/members/{member_id}

Description

이미지 멤버를 수정합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string	None
path	member_id required	공유용 이미지 멤버 ID Example : `a8f10467abfc4b87b64614ab36eb9ae4`	string	None
body	body required		ImageMemberSetRequest

Responses

HTTP Code	Description	Schema
200	OK	ImageMemberShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/images/{image_id}/members/{member_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 = virtualserver 1.0"

Request body

{
    "status": "pending"
}

Example HTTP response

Response 200

{
    "created_at": "2025-07-22T09:00:00Z",
    "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "member_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "status": "pending",
    "updated_at": "2025-07-26T12:00:00Z"
}

4.1.109 - Update Server Interface

4.1.109.1 - 1.2

put /v1/servers/{server_id}/interfaces/{port_id}

Description

서버 인터페이스를 수정합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	port_id required	포트 ID Example : `91424c08-0b26-49fb-9808-ed042292ceef`	string	None
body	body required		ServerInterfaceUpdateRequest

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/interfaces/{port_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 = virtualserver 1.2"

Request body

{
    "fixed_ip_address": "192.169.3.2",
    "subnet_id": ""
}

Example HTTP response

Response 202

4.1.109.2 - 1.1

put /v1/servers/{server_id}/interfaces/{port_id}

Description

서버 인터페이스를 수정합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	port_id required	포트 ID Example : `91424c08-0b26-49fb-9808-ed042292ceef`	string	None
body	body required		ServerInterfaceUpdateRequest

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/interfaces/{port_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 = virtualserver 1.1"

Request body

{
    "fixed_ip_address": "192.169.3.2",
    "subnet_id": ""
}

Example HTTP response

Response 202

4.1.109.3 - 1.0

put /v1/servers/{server_id}/interfaces/{port_id}

Description

서버 인터페이스를 수정합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	port_id required	포트 ID Example : `91424c08-0b26-49fb-9808-ed042292ceef`	string	None
body	body required		ServerInterfaceUpdateRequest

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/interfaces/{port_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 = virtualserver 1.0"

Request body

{
    "fixed_ip_address": "192.169.3.2",
    "subnet_id": ""
}

Example HTTP response

Response 202

4.1.110 - Update Server Volume

4.1.110.1 - 1.2

put /v1/servers/{server_id}/volumes/{volume_id}

Description

서버 볼륨을 수정합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string	None
body	body required		ServerVolumesUpdateRequest

Responses

HTTP Code	Description	Schema
200	OK	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/servers/{server_id}/volumes/{volume_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 = virtualserver 1.2"

Request body

{
    "delete_on_termination": false,
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

Example HTTP response

Response 200

4.1.110.2 - 1.1

put /v1/servers/{server_id}/volumes/{volume_id}

Description

서버 볼륨을 수정합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string	None
body	body required		ServerVolumesUpdateRequest

Responses

HTTP Code	Description	Schema
200	OK	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/servers/{server_id}/volumes/{volume_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 = virtualserver 1.1"

Request body

{
    "delete_on_termination": false,
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

Example HTTP response

Response 200

4.1.110.3 - 1.0

put /v1/servers/{server_id}/volumes/{volume_id}

Description

서버 볼륨을 수정합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
path	volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string	None
body	body required		ServerVolumesUpdateRequest

Responses

HTTP Code	Description	Schema
200	OK	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/servers/{server_id}/volumes/{volume_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 = virtualserver 1.0"

Request body

{
    "delete_on_termination": false,
    "volume_id": "3f500f00-ed80-4566-a057-e31760226f9a"
}

Example HTTP response

Response 200

4.1.111 - Update Virtual Server

4.1.111.1 - 1.2

put /v1/servers/{server_id}

Description

서버를 수정합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
body	body required		ServerUpdateRequest

Responses

HTTP Code	Description	Schema
200	OK	ServerShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/servers/{server_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 = virtualserver 1.2"

Request body

{
    "name": "servername"
}

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "addresses": [
        {
            "ip_addresses": [
                {
                    "ip_address": "192.169.3.2",
                    "version": 4
                }
            ],
            "subnet_name": "subnetname"
        }
    ],
    "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
    "created_at": "2026-04-14T15:06:29.755Z",
    "created_by": "97e6b22c9a4143789ca522df7457a32f",
    "disk_config": "MANUAL",
    "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
    "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "is_marketplace": false,
    "keypair_name": "keypairname",
    "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
    "locked": false,
    "metadata": "",
    "modified_at": "2026-04-14T15:06:29.778Z",
    "name": "servername",
    "partition_number": 1,
    "planned_compute_os_type": "windows",
    "product_category": "compute",
    "product_offering": "virtual_server",
    "security_groups": [
        {
            "name": "securitygroup"
        }
    ],
    "server_group_id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
    "server_type": {
        "disk": 100,
        "ephemeral": 0,
        "extra_specs": "",
        "id": "s1v1m2",
        "name": "s1v1m2",
        "ram": 2,
        "swap": 0,
        "vcpus": 1
    },
    "state": "ACTIVE",
    "volumes": [
        {
            "delete_on_termination": false,
            "id": "3f500f00-ed80-4566-a057-e31760226f9a"
        }
    ],
    "vpc_id": "cc976b621087484ea5fd527f4b78708b"
}

4.1.111.2 - 1.1

put /v1/servers/{server_id}

Description

서버를 수정합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
body	body required		ServerUpdateRequest

Responses

HTTP Code	Description	Schema
200	OK	ServerShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/servers/{server_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 = virtualserver 1.1"

Request body

{
    "name": "servername"
}

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "addresses": [
        {
            "ip_addresses": [
                {
                    "ip_address": "192.169.3.2",
                    "version": 4
                }
            ],
            "subnet_name": "subnetname"
        }
    ],
    "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
    "created_at": "2026-04-14T15:06:29.755Z",
    "created_by": "97e6b22c9a4143789ca522df7457a32f",
    "disk_config": "MANUAL",
    "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
    "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "is_marketplace": false,
    "keypair_name": "keypairname",
    "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
    "locked": false,
    "metadata": "",
    "modified_at": "2026-04-14T15:06:29.778Z",
    "name": "servername",
    "partition_number": 1,
    "planned_compute_os_type": "windows",
    "product_category": "compute",
    "product_offering": "virtual_server",
    "security_groups": [
        {
            "name": "securitygroup"
        }
    ],
    "server_group_id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
    "server_type": {
        "disk": 100,
        "ephemeral": 0,
        "extra_specs": "",
        "id": "s1v1m2",
        "name": "s1v1m2",
        "ram": 2,
        "swap": 0,
        "vcpus": 1
    },
    "state": "ACTIVE",
    "volumes": [
        {
            "delete_on_termination": false,
            "id": "3f500f00-ed80-4566-a057-e31760226f9a"
        }
    ],
    "vpc_id": "cc976b621087484ea5fd527f4b78708b"
}

4.1.111.3 - 1.0

put /v1/servers/{server_id}

Description

서버를 수정합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
body	body required		ServerUpdateRequest

Responses

HTTP Code	Description	Schema
200	OK	ServerShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/servers/{server_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 = virtualserver 1.0"

Request body

{
    "name": "servername"
}

Example HTTP response

Response 200

{
    "account_id": "a8f10467abfc4b87b64614ab36eb9ae4",
    "addresses": [
        {
            "ip_addresses": [
                {
                    "ip_address": "192.169.3.2",
                    "version": 4
                }
            ],
            "subnet_name": "subnetname"
        }
    ],
    "auto_scaling_group_id": "52613bd852b04b39adcb15a8364d856d",
    "created_at": "2026-04-14T15:06:29.755Z",
    "created_by": "97e6b22c9a4143789ca522df7457a32f",
    "disk_config": "MANUAL",
    "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
    "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
    "is_marketplace": false,
    "keypair_name": "keypairname",
    "launch_configuration_id": "b5aea5a675fc4f6b9e0fcd1288354c5f",
    "locked": false,
    "metadata": "",
    "modified_at": "2026-04-14T15:06:29.778Z",
    "name": "servername",
    "partition_number": 1,
    "planned_compute_os_type": "windows",
    "product_category": "compute",
    "product_offering": "virtual_server",
    "security_groups": [
        {
            "name": "securitygroup"
        }
    ],
    "server_group_id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
    "server_type": {
        "disk": 100,
        "ephemeral": 0,
        "extra_specs": "",
        "id": "s1v1m2",
        "name": "s1v1m2",
        "ram": 2,
        "swap": 0,
        "vcpus": 1
    },
    "state": "ACTIVE",
    "volumes": [
        {
            "delete_on_termination": false,
            "id": "3f500f00-ed80-4566-a057-e31760226f9a"
        }
    ],
    "vpc_id": "cc976b621087484ea5fd527f4b78708b"
}

4.1.112 - Update Virtual Server type

4.1.112.1 - 1.2

post /v1/servers/{server_id}/server-type

Description

서버 타입을 수정합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
body	body required		ServerSetServerTypeRequestBody

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/server-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 = virtualserver 1.2"

Request body

{
    "server_type": "s1v1m2"
}

Example HTTP response

Response 202

4.1.112.2 - 1.1

post /v1/servers/{server_id}/server-type

Description

서버 타입을 수정합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
body	body required		ServerSetServerTypeRequestBody

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/server-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 = virtualserver 1.1"

Request body

{
    "server_type": "s1v1m2"
}

Example HTTP response

Response 202

4.1.112.3 - 1.0

post /v1/servers/{server_id}/server-type

Description

서버 타입을 수정합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string	None
body	body required		ServerSetServerTypeRequestBody

Responses

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

Example HTTP request

Request path

/v1/servers/{server_id}/server-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 = virtualserver 1.0"

Request body

{
    "server_type": "s1v1m2"
}

Example HTTP response

Response 202

4.1.113 - Update Volume

4.1.113.1 - 1.2

put /v1/volumes/{volume_id}

Description

볼륨을 수정합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string	None
body	body required		VolumeUpdateRequest

Responses

HTTP Code	Description	Schema
200	OK	VolumeShowResponseV1Dot2
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/volumes/{volume_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 = virtualserver 1.2"

Request body

{
    "name": "volume01"
}

Example HTTP response

Response 200

{
    "bootable": false,
    "created_at": "2026-04-14T15:06:31.797Z",
    "encrypted": true,
    "id": "3f500f00-ed80-4566-a057-e31760226f9a",
    "max_iops": 10000,
    "max_throughput": 500,
    "modified_at": "2025-07-26T12:00:00Z",
    "multiattach": false,
    "name": "volume01",
    "servers": [
        {
            "attached_at": "2026-04-14T15:06:30.712Z",
            "device": "/dev/vda",
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f"
        }
    ],
    "size": 104,
    "snapshot_id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790",
    "state": "available",
    "user_id": "570907805e5447be84b618450ef52o0t",
    "volume_image_metadata": {
        "checksum": "7538e0fcb56e0e272cfd89eb384d6613",
        "container_format": "bare",
        "disk_format": "qcow2",
        "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
        "image_name": "imagename",
        "min_disk": 100,
        "min_ram": 0,
        "os_distro": "alma",
        "scp_image_type": "custom",
        "scp_k8s_version": "v1.28.7",
        "scp_original_image_type": "standard",
        "signature_verified": false,
        "size": 2429747200
    },
    "volume_type": "SSD",
    "volume_type_id": "c643ac35-3aec-43e6-b97a-3d6f666c5207"
}

4.1.113.2 - 1.1

put /v1/volumes/{volume_id}

Description

볼륨을 수정합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string	None
body	body required		VolumeUpdateRequest

Responses

HTTP Code	Description	Schema
200	OK	VolumeShowResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/volumes/{volume_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 = virtualserver 1.1"

Request body

{
    "name": "volume01"
}

Example HTTP response

Response 200

{
    "bootable": false,
    "created_at": "2026-04-14T15:06:30.677Z",
    "encrypted": true,
    "id": "3f500f00-ed80-4566-a057-e31760226f9a",
    "modified_at": "2025-07-26T12:00:00Z",
    "multiattach": false,
    "name": "volume01",
    "servers": [
        {
            "attached_at": "2026-04-14T15:06:30.712Z",
            "device": "/dev/vda",
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f"
        }
    ],
    "size": 104,
    "snapshot_id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790",
    "state": "available",
    "user_id": "570907805e5447be84b618450ef52o0t",
    "volume_image_metadata": {
        "checksum": "7538e0fcb56e0e272cfd89eb384d6613",
        "container_format": "bare",
        "disk_format": "qcow2",
        "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
        "image_name": "imagename",
        "min_disk": 100,
        "min_ram": 0,
        "os_distro": "alma",
        "scp_image_type": "custom",
        "scp_k8s_version": "v1.28.7",
        "scp_original_image_type": "standard",
        "signature_verified": false,
        "size": 2429747200
    },
    "volume_type": "SSD",
    "volume_type_id": "c643ac35-3aec-43e6-b97a-3d6f666c5207"
}

4.1.113.3 - 1.0

put /v1/volumes/{volume_id}

Description

볼륨을 수정합니다.

상태 ACTIVE (DEPRECATED)

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

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string	None
body	body required		VolumeUpdateRequest

Responses

HTTP Code	Description	Schema
200	OK	VolumeShowResponse
400	Bad Request	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/volumes/{volume_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 = virtualserver 1.0"

Request body

{
    "name": "volume01"
}

Example HTTP response

Response 200

{
    "bootable": false,
    "created_at": "2026-04-14T15:06:30.677Z",
    "encrypted": true,
    "id": "3f500f00-ed80-4566-a057-e31760226f9a",
    "modified_at": "2025-07-26T12:00:00Z",
    "multiattach": false,
    "name": "volume01",
    "servers": [
        {
            "attached_at": "2026-04-14T15:06:30.712Z",
            "device": "/dev/vda",
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f"
        }
    ],
    "size": 104,
    "snapshot_id": "cceed636-1f1e-4bb0-b85c-4e5b9e0bf790",
    "state": "available",
    "user_id": "570907805e5447be84b618450ef52o0t",
    "volume_image_metadata": {
        "checksum": "7538e0fcb56e0e272cfd89eb384d6613",
        "container_format": "bare",
        "disk_format": "qcow2",
        "image_id": "70a599e0-31e7-49b7-b260-868f441e862b",
        "image_name": "imagename",
        "min_disk": 100,
        "min_ram": 0,
        "os_distro": "alma",
        "scp_image_type": "custom",
        "scp_k8s_version": "v1.28.7",
        "scp_original_image_type": "standard",
        "signature_verified": false,
        "size": 2429747200
    },
    "volume_type": "SSD",
    "volume_type_id": "c643ac35-3aec-43e6-b97a-3d6f666c5207"
}

4.2 - Models

4.2.1 - AutoScalingGroup

Name	Description	Schema
account_id required	계정 ID Example : `a8f10467abfc4b87b64614ab36eb9ae4`	string
created_at required	생성 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	생성자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
desired_server_count required	목표 서버 수 Example : `1`	integer
desired_server_count_editable required	목표 서버 수 수정 가능 여부 Example : `True`	boolean
drain_enabled required	Drain 사용 여부 Example : `True`	boolean
drain_timeout optional	Drain timeout 값 Example : `300`	any of [integer, null]
id required	ID Example : `0fdd87aab8cb46f59b7c1f81ed03fb3e`	string
launch_configuration_id required	Launch Configuration ID Example : `b5aea5a675fc4f6b9e0fcd1288354c5f`	string
launch_configuration_name required	Launch Configuration 이름 Example : `launch-configuration-name`	string
lb_server_groups optional	LB 서버 그룹 목록	any of [array[AutoScalingGroupLbServerGroup], null]
max_server_count required	최대 서버 수 Example : `2`	integer
min_server_count required	최소 서버 수 Example : `1`	integer
modified_at required	수정 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	수정자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
name required	Auto-Scaling Group 이름 Example : `auto-scaling-group-name`	string
security_group_ids optional	Security Group ID 목록 Example : `['c09c3f05-03d9-443f-b27a-40e0f973c75f']`	any of [array[string], null]
server_name_prefix required	서버 이름 접두사 Example : `server-name-prefix`	string
state required	Auto-Scaling Group 상태 Example : `IN_SERVICE`	string
subnet_ids optional	Subnet ID 목록	array[string]
vpc_id required	VPC ID Example : `cc976b621087484ea5fd527f4b78708b`	string

4.2.2 - AutoScalingGroupCreateRequest

Name	Description	Schema
desired_server_count required	목표 서버 수 Example : `1`	integer
desired_server_count_editable required	목표 서버 수 수정 가능 여부 Example : `True`	boolean
drain_enabled optional	Drain 사용 여부 Example : `True`	any of [boolean, null]
drain_timeout optional	Drain timeout 값 Example : `300`	any of [integer, null]
launch_configuration_id required	Launch Configuration ID Example : `b5aea5a675fc4f6b9e0fcd1288354c5f`	string
lb_server_groups optional	LB 서버 그룹 목록	any of [array[AutoScalingGroupLbServerGroup], null]
max_server_count required	최대 서버 수 Example : `2`	integer
min_server_count required	최소 서버 수 Example : `1`	integer
name required	Auto-Scaling Group 이름 Example : `auto-scaling-group-name` Pattern : `^[a-zA-Z0-9-_]$` Minimum length* : `1` Maximum length : `63`	string
notifications optional	Auto-Scaling Group 알림	any of [array[AutoScalingGroupNotificationCreateRequest], null]
scaling_policies optional	Auto-Scaling Group 정책 목록	any of [array[AutoScalingGroupPolicyCreateRequest], null]
security_group_ids optional	Security Group ID 목록 Example : `['c09c3f05-03d9-443f-b27a-40e0f973c75f']`	any of [array[string], null]
server_name_prefix required	서버 이름 접두사 Example : `server-name-prefix` Pattern : `^[a-zA-Z0-9-_]$` Minimum length* : `1` Maximum length : `61`	string
subnet_ids required	Subnet ID 목록	array[string]
tags optional	Tags Example : `[{'key': 'key', 'value': 'value'}]`	any of [array[Tag], null]

4.2.3 - AutoScalingGroupCreateRequestV1Dot2

Name	Description	Schema
desired_server_count required	목표 서버 수 Example : `1`	integer
desired_server_count_editable required	목표 서버 수 수정 가능 여부 Example : `True`	boolean
drain_enabled optional	Drain 사용 여부 Example : `True`	any of [boolean, null]
drain_timeout optional	Drain timeout 값 Example : `300`	any of [integer, null]
launch_configuration_id required	Launch Configuration ID Example : `b5aea5a675fc4f6b9e0fcd1288354c5f`	string
lb_server_groups optional	LB 서버 그룹 목록	any of [array[AutoScalingGroupLbServerGroup], null]
max_server_count required	최대 서버 수 Example : `2`	integer
min_server_count required	최소 서버 수 Example : `1`	integer
name required	Auto-Scaling Group 이름 Example : `auto-scaling-group-name` Pattern : `^[a-zA-Z0-9-_]$` Minimum length* : `1` Maximum length : `63`	string
notifications optional	Auto-Scaling Group 알림	any of [array[AutoScalingGroupNotificationCreateRequest], null]
scaling_policies optional	Auto-Scaling Group 정책 목록	any of [array[AutoScalingGroupPolicyCreateRequest], null]
security_group_ids optional	Security Group ID 목록 Example : `['c09c3f05-03d9-443f-b27a-40e0f973c75f']`	any of [array[string], null]
server_name_prefix required	서버 이름 접두사 Example : `server-name-prefix` Pattern : `^[a-zA-Z0-9-_]$` Minimum length* : `1` Maximum length : `61`	string
state_check_delay_time required	ASG VM 생성 이후 상태체크까지의 유예기간 Example : `300` Maximum : `2147483647`	integer
subnet_ids required	Subnet ID 목록	array[string]
tags optional	Tags Example : `[{'key': 'key', 'value': 'value'}]`	any of [array[Tag], null]
use_lb_state_check required	LB 상태체크 사용 여부 Example : `True`	boolean

4.2.4 - AutoScalingGroupLbServerGroup

Name	Description	Schema	Default
id required	LB 서버 그룹 ID Example : `d06e87d3-ca9a-461b-8e88-077a542a7335`	string
port required	LB 서버 그룹 포트 Example : `8080` Minimum : `1` Maximum : `65534`	integer

4.2.5 - AutoScalingGroupLbServerGroupListResponse

Name	Description	Schema	Default
count required	총 개수 Example : `20`	integer
lb_server_groups required	LB 서버 그룹 목록	array[AutoScalingGroupLbServerGroupShowResponse]

4.2.6 - AutoScalingGroupLbServerGroupSetRequest

Name	Description	Schema	Default
lb_server_groups required	LB 서버 그룹 목록	array[AutoScalingGroupLbServerGroup]

4.2.7 - AutoScalingGroupLbServerGroupShowResponse

Name	Description	Schema
created_at required	생성 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	생성자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
id required	ID Example : `0fdd87aab8cb46f59b7c1f81ed03fb3e`	string
modified_at required	수정 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	수정자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
name required	LB 서버 그룹 이름 Example : `lb-server-group-name`	string
port required	LB 서버 그룹 포트 Example : `8080`	integer

4.2.8 - AutoScalingGroupListResponse

Name	Description	Schema	Default
auto_scaling_groups required	Auto-Scaling Group 목록	array[AutoScalingGroup]
count required	총 개수 Example : `20`	integer

4.2.9 - AutoScalingGroupListResponseV1Dot2

Name	Description	Schema	Default
auto_scaling_groups required	Auto-Scaling Group 목록	array[AutoScalingGroupV1Dot2]
count required	총 개수 Example : `20`	integer

4.2.10 - AutoScalingGroupNotificationCreateRequest

Name	Description	Schema	Default
notification_events required	Auto-Scaling Group 알림 이벤트 목록 Example : `['SCALE_OUT', 'SCALE_OUT_FAIL']`	array[enum (SCALE_OUT, SCALE_OUT_FAIL, SCALE_IN, SCALE_IN_FAIL, SATISFIED_POLICY_CONDITIONS)]
user_ids required	사용자 ID 목록 Example : `['570907805e5447be84b618450ef52o0t']`	array[string]

4.2.11 - AutoScalingGroupNotificationListResponse

Name	Description	Schema	Default
count required	총 개수 Example : `20`	integer
notifications required	Auto-Scaling Group 알림 목록	array[AutoScalingGroupNotificationShowResponse]

4.2.12 - AutoScalingGroupNotificationShowResponse

Name	Description	Schema
account_id required	계정 ID Example : `a8f10467abfc4b87b64614ab36eb9ae4`	string
auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string
created_at required	생성 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	생성자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
id required	ID Example : `0fdd87aab8cb46f59b7c1f81ed03fb3e`	string
modified_at required	수정 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	수정자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
notification_events required	Auto-Scaling Group 알림 이벤트 목록 Example : `['SCALE_OUT', 'SCALE_OUT_FAIL']`	array[enum (SCALE_OUT, SCALE_OUT_FAIL, SCALE_IN, SCALE_IN_FAIL, SATISFIED_POLICY_CONDITIONS)]
notification_state required	Auto-Scaling Group 알림 상태 Example : `ACTIVE`	string
user_email required	User email Example : `scpuser@samsung.com`	string
user_id required	사용자 ID Example : `570907805e5447be84b618450ef52o0t`	string
user_name required	사용자명 Example : `scpuser`	string

4.2.13 - AutoScalingGroupNotificationUpdateRequest

Name	Description	Schema	Default
notification_events optional	Auto-Scaling Group 알림 이벤트 목록 Example : `['SCALE_OUT', 'SCALE_OUT_FAIL']`	any of [array[enum (SCALE_OUT, SCALE_OUT_FAIL, SCALE_IN, SCALE_IN_FAIL, SATISFIED_POLICY_CONDITIONS)], null]
notification_state optional	Auto-Scaling Group 알림 상태 Example : `ACTIVE`	any of [string, null]

4.2.14 - AutoScalingGroupPolicyCreateRequest

Name	Description	Schema
comparison_operator required	비교 연산자 Example : `ge` Pattern : `^(ge\|gt\|le\|lt)$`	string
cooldown_seconds required	쿨다운 시간(초 단위) Example : `300`	integer
evaluation_minutes required	평가 시간(분 단위) Example : `5`	integer
metric_method required	메트릭 방법 Example : `AVG` Pattern : `^(AVG\|MIN\|MAX)$`	string
metric_type required	메트릭 유형 Example : `CPU` Pattern : `^(CPU\|NETWORK_IN_BYTES\|NETWORK_OUT_BYTES\|NETWORK_IN_PACKETS\|NETWORK_OUT_PACKETS)$`	string
name required	정책 이름 Example : `policy-name` Pattern : `^[a-zA-Z0-9-_]$` Minimum length* : `1` Maximum length : `63`	string
scale_method required	스케일 방법 Example : `AMOUNT` Pattern : `^(AMOUNT\|PERCENTAGE\|FIXED)$`	string
scale_type required	스케일 유형 Example : `SCALE_OUT` Pattern : `^(SCALE_IN\|SCALE_OUT)$`	string
scale_value required	스케일 값 Example : `10`	integer
threshold required	임계값 Example : `60`	integer

4.2.15 - AutoScalingGroupPolicyListResponse

Name	Description	Schema	Default
count required	총 개수 Example : `20`	integer
policies required		array[AutoScalingGroupPolicyShowResponse]

4.2.16 - AutoScalingGroupPolicyShowResponse

Name	Description	Schema
account_id required	계정 ID Example : `a8f10467abfc4b87b64614ab36eb9ae4`	string
auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string
comparison_operator required	비교 연산자 Example : `ge`	string
cooldown_seconds required	쿨다운 시간(초 단위) Example : `300`	integer
created_at required	생성 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	생성자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
evaluation_minutes required	평가 시간(분 단위) Example : `5`	integer
id required	ID Example : `0fdd87aab8cb46f59b7c1f81ed03fb3e`	string
metric_method required	메트릭 방법 Example : `AVG`	string
metric_type required	메트릭 유형 Example : `CPU`	string
modified_at required	수정 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	수정자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
name required	정책 이름 Example : `policy-name`	string
scale_method required	스케일 방법 Example : `AMOUNT`	string
scale_type required	스케일 유형 Example : `SCALE_OUT`	string
scale_value required	스케일 값 Example : `10`	integer
state required	정책 상태 Example : `ACTIVE`	string
threshold required	임계값 Example : `60`	integer
threshold_unit required	임계값 단위 Example : `%`	string

4.2.17 - AutoScalingGroupPolicyUpdateRequest

Name	Description	Schema
comparison_operator optional	비교 연산자 Example : `ge` Pattern : `^(ge\|gt\|le\|lt)$`	any of [string, null]
cooldown_seconds optional	쿨다운 시간(초 단위) Example : `300`	any of [integer, null]
evaluation_minutes optional	평가 시간(분 단위) Example : `5`	any of [integer, null]
metric_method optional	메트릭 방법 Example : `AVG` Pattern : `^(AVG\|MIN\|MAX)$`	any of [string, null]
metric_type optional	메트릭 유형 Example : `CPU` Pattern : `^(CPU\|NETWORK_IN_BYTES\|NETWORK_OUT_BYTES\|NETWORK_IN_PACKETS\|NETWORK_OUT_PACKETS)$`	any of [string, null]
name optional	정책 이름 Example : `policy-name` Pattern : `^[a-zA-Z0-9-_]*$`	any of [string, null]
scale_method optional	스케일 방법 Example : `AMOUNT` Pattern : `^(AMOUNT\|PERCENTAGE\|FIXED)$`	any of [string, null]
scale_type optional	스케일 유형 Example : `SCALE_OUT` Pattern : `^(SCALE_IN\|SCALE_OUT)$`	any of [string, null]
scale_value optional	스케일 값 Example : `10`	any of [integer, null]
state optional	정책 상태 Example : `ACTIVE` Pattern : `^(ACTIVE\|INACTIVE)$`	any of [string, null]
threshold optional	임계값 Example : `60`	any of [integer, null]

4.2.18 - AutoScalingGroupPolicyUpdateRequestV1Dot2

Name	Description	Schema
comparison_operator optional	비교 연산자 Example : `ge` Pattern : `^(ge\|gt\|le\|lt)$`	any of [string, null]
cooldown_seconds optional	쿨다운 시간(초 단위) Example : `300`	any of [integer, null]
evaluation_minutes optional	평가 시간(분 단위) Example : `5`	any of [integer, null]
metric_method optional	메트릭 방법 Example : `AVG` Pattern : `^(AVG\|MIN\|MAX)$`	any of [string, null]
metric_type optional	메트릭 유형 Example : `CPU` Pattern : `^(CPU\|NETWORK_IN_BYTES\|NETWORK_OUT_BYTES\|NETWORK_IN_PACKETS\|NETWORK_OUT_PACKETS)$`	any of [string, null]
scale_method optional	스케일 방법 Example : `AMOUNT` Pattern : `^(AMOUNT\|PERCENTAGE\|FIXED)$`	any of [string, null]
scale_type optional	스케일 유형 Example : `SCALE_OUT` Pattern : `^(SCALE_IN\|SCALE_OUT)$`	any of [string, null]
scale_value optional	스케일 값 Example : `10`	any of [integer, null]
state optional	정책 상태 Example : `ACTIVE` Pattern : `^(ACTIVE\|INACTIVE)$`	any of [string, null]
threshold optional	임계값 Example : `60`	any of [integer, null]

4.2.19 - AutoScalingGroupScheduleCreateRequest

Name	Description	Schema
day_of_month optional	일 Example : `-1,1`	any of [string, null]
day_of_week optional	요일 Example : `SU,SA`	any of [string, null]
description optional	설명 Example : `description`	any of [string, null]
desired_server_count optional	목표 서버 수 Example : `1`	any of [integer, null]
end_date optional	종료 날짜 Example : `2025-01-01`	any of [string, null]
frequency required	빈도 Example : `WEEKLY`	enum (ONCE, DAILY, WEEKLY, MONTHLY)
hour required	시간 Example : `9` Maximum : `23`	integer
max_server_count optional	최대 서버 수 Example : `2`	any of [integer, null]
min_server_count optional	최소 서버 수 Example : `1`	any of [integer, null]
minute required	분 Example : `0`	integer
name required	스케쥴 이름 Example : `schedulename` Pattern : `^[a-zA-Z0-9-_]$` Minimum length* : `1` Maximum length : `63`	string
start_date required	시작 날짜 Example : `2024-01-01`	string
state optional	스케쥴 상태 Example : `ACTIVE`	enum (ACTIVE, INACTIVE, DELETED)
timezone required	시간대 Example : `Asia/Seoul`	string

4.2.20 - AutoScalingGroupScheduleListResponse

Name	Description	Schema
count required	총 개수 Example : `20`	integer
page required	page Example : `0`	integer
schedules required		array[AutoScalingGroupScheduleShowResponse]
size required	size Example : `20`	integer
sort optional	sort Example : `['created_at:asc']`	any of [array[string], null]

4.2.21 - AutoScalingGroupScheduleShowResponse

Name	Description	Schema
account_id required	계정 ID Example : `a8f10467abfc4b87b64614ab36eb9ae4`	string
created_at required	생성 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	생성자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
day_of_month required	일 Example : `-1,1`	any of [string, null]
day_of_week required	요일 Example : `SU,SA`	any of [string, null]
description required	설명 Example : `description`	any of [string, null]
desired_server_count required	목표 서버 수 Example : `1`	any of [integer, null]
end_date required	종료 날짜 Example : `2025-01-01`	any of [string, null]
frequency required	빈도 Example : `WEEKLY`	enum (ONCE, DAILY, WEEKLY, MONTHLY)
hour required	시간 Example : `9`	integer
id required	ID Example : `0fdd87aab8cb46f59b7c1f81ed03fb3e`	string
max_server_count required	최대 서버 수 Example : `2`	any of [integer, null]
min_server_count required	최소 서버 수 Example : `1`	any of [integer, null]
minute required	분 Example : `0`	integer
modified_at required	수정 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	수정자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
name required	스케쥴 이름 Example : `schedulename`	string
start_date required	시작 날짜 Example : `2024-01-01`	string
state required	스케쥴 상태 Example : `ACTIVE`	string
timezone required	시간대 Example : `Asia/Seoul`	string

4.2.22 - AutoScalingGroupScheduleUpdateRequest

Name	Description	Schema
day_of_month optional	일 Example : `-1,1`	any of [string, null]
day_of_week optional	요일 Example : `SU,SA`	any of [string, null]
description optional	설명 Example : `description`	any of [string, null]
desired_server_count optional	목표 서버 수 Example : `1`	any of [integer, null]
end_date optional	종료 날짜 Example : `2025-01-01`	any of [string, null]
frequency optional	빈도 Example : `WEEKLY`	any of [enum (ONCE, DAILY, WEEKLY, MONTHLY), null]
hour optional	시간 Example : `9`	any of [integer, null]
max_server_count optional	최대 서버 수 Example : `2`	any of [integer, null]
min_server_count optional	최소 서버 수 Example : `1`	any of [integer, null]
minute optional	분 Example : `0`	any of [integer, null]
name optional	스케쥴 이름 Example : `schedulename` Pattern : `^[a-zA-Z0-9-_]*$`	any of [string, null]
start_date optional	시작 날짜 Example : `2024-01-01`	any of [string, null]
state optional	스케쥴 상태 Example : `ACTIVE`	enum (ACTIVE, INACTIVE, DELETED)
timezone optional	시간대 Example : `Asia/Seoul`	any of [string, null]

4.2.23 - AutoScalingGroupSetRequest

Name	Description	Schema
desired_server_count_editable optional	목표 서버 수 수정 가능 여부 Example : `True`	any of [boolean, null]
drain_enabled optional	Drain 사용 여부 Example : `True`	any of [boolean, null]
drain_timeout optional	Drain timeout 값 Example : `300`	any of [integer, null]
launch_configuration_id optional	Launch Configuration ID Example : `b5aea5a675fc4f6b9e0fcd1288354c5f`	any of [string, null]
security_group_ids optional	Security Group ID 목록 Example : `['c09c3f05-03d9-443f-b27a-40e0f973c75f']`	any of [array[string], null]

4.2.24 - AutoScalingGroupSetRequestV1Dot2

Name	Description	Schema
desired_server_count_editable optional	목표 서버 수 수정 가능 여부 Example : `True`	any of [boolean, null]
drain_enabled optional	Drain 사용 여부 Example : `True`	any of [boolean, null]
drain_timeout optional	Drain timeout 값 Example : `300`	any of [integer, null]
launch_configuration_id optional	Launch Configuration ID Example : `b5aea5a675fc4f6b9e0fcd1288354c5f`	any of [string, null]
security_group_ids optional	Security Group ID 목록 Example : `['c09c3f05-03d9-443f-b27a-40e0f973c75f']`	any of [array[string], null]
state_check_delay_time optional	ASG VM 생성 이후 상태체크까지의 유예기간 Example : `300`	any of [integer, null]
use_lb_state_check optional	LB 상태체크 사용 여부 Example : `True`	any of [boolean, null]

4.2.25 - AutoScalingGroupSetServerCountRequest

Name	Description	Schema
desired_server_count optional	목표 서버 수 Example : `1`	any of [integer, null]
max_server_count optional	최대 서버 수 Example : `2`	any of [integer, null]
min_server_count optional	최소 서버 수 Example : `1`	any of [integer, null]

4.2.26 - AutoScalingGroupShowResponse

Name	Description	Schema
account_id required	계정 ID Example : `a8f10467abfc4b87b64614ab36eb9ae4`	string
created_at required	생성 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	생성자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
desired_server_count required	목표 서버 수 Example : `1`	integer
desired_server_count_editable required	목표 서버 수 수정 가능 여부 Example : `True`	boolean
drain_enabled required	Drain 사용 여부 Example : `True`	boolean
drain_timeout optional	Drain timeout 값 Example : `300`	any of [integer, null]
id required	ID Example : `0fdd87aab8cb46f59b7c1f81ed03fb3e`	string
launch_configuration_id required	Launch Configuration ID Example : `b5aea5a675fc4f6b9e0fcd1288354c5f`	string
launch_configuration_name required	Launch Configuration 이름 Example : `launch-configuration-name`	string
lb_server_groups optional	LB 서버 그룹 목록	any of [array[AutoScalingGroupLbServerGroup], null]
max_server_count required	최대 서버 수 Example : `2`	integer
min_server_count required	최소 서버 수 Example : `1`	integer
modified_at required	수정 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	수정자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
name required	Auto-Scaling Group 이름 Example : `auto-scaling-group-name`	string
security_group_ids optional	Security Group ID 목록 Example : `['c09c3f05-03d9-443f-b27a-40e0f973c75f']`	any of [array[string], null]
server_name_prefix required	서버 이름 접두사 Example : `server-name-prefix`	string
state required	Auto-Scaling Group 상태 Example : `IN_SERVICE`	string
subnet_ids optional	Subnet ID 목록	array[string]
total_server_count required	총 서버 수 Example : `1`	integer
vpc_id required	VPC ID Example : `cc976b621087484ea5fd527f4b78708b`	string

4.2.27 - AutoScalingGroupShowResponseV1Dot2

Name	Description	Schema
account_id required	계정 ID Example : `a8f10467abfc4b87b64614ab36eb9ae4`	string
created_at required	생성 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	생성자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
desired_server_count required	목표 서버 수 Example : `1`	integer
desired_server_count_editable required	목표 서버 수 수정 가능 여부 Example : `True`	boolean
drain_enabled required	Drain 사용 여부 Example : `True`	boolean
drain_timeout optional	Drain timeout 값 Example : `300`	any of [integer, null]
id required	ID Example : `0fdd87aab8cb46f59b7c1f81ed03fb3e`	string
launch_configuration_id required	Launch Configuration ID Example : `b5aea5a675fc4f6b9e0fcd1288354c5f`	string
launch_configuration_name required	Launch Configuration 이름 Example : `launch-configuration-name`	string
lb_server_groups optional	LB 서버 그룹 목록	any of [array[AutoScalingGroupLbServerGroup], null]
max_server_count required	최대 서버 수 Example : `2`	integer
min_server_count required	최소 서버 수 Example : `1`	integer
modified_at required	수정 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	수정자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
name required	Auto-Scaling Group 이름 Example : `auto-scaling-group-name`	string
security_group_ids optional	Security Group ID 목록 Example : `['c09c3f05-03d9-443f-b27a-40e0f973c75f']`	any of [array[string], null]
server_name_prefix required	서버 이름 접두사 Example : `server-name-prefix`	string
state required	Auto-Scaling Group 상태 Example : `IN_SERVICE`	string
state_check_delay_time required	ASG VM 생성 이후 상태체크까지의 유예기간 Example : `300`	integer
subnet_ids optional	Subnet ID 목록	array[string]
total_server_count required	총 서버 수 Example : `1`	integer
use_lb_state_check required	LB 상태체크 사용 여부 Example : `True`	boolean
vpc_id required	VPC ID Example : `cc976b621087484ea5fd527f4b78708b`	string

4.2.28 - AutoScalingGroupV1Dot2

Name	Description	Schema
account_id required	계정 ID Example : `a8f10467abfc4b87b64614ab36eb9ae4`	string
created_at required	생성 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	생성자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
desired_server_count required	목표 서버 수 Example : `1`	integer
desired_server_count_editable required	목표 서버 수 수정 가능 여부 Example : `True`	boolean
drain_enabled required	Drain 사용 여부 Example : `True`	boolean
drain_timeout optional	Drain timeout 값 Example : `300`	any of [integer, null]
id required	ID Example : `0fdd87aab8cb46f59b7c1f81ed03fb3e`	string
launch_configuration_id required	Launch Configuration ID Example : `b5aea5a675fc4f6b9e0fcd1288354c5f`	string
launch_configuration_name required	Launch Configuration 이름 Example : `launch-configuration-name`	string
lb_server_groups optional	LB 서버 그룹 목록	any of [array[AutoScalingGroupLbServerGroup], null]
max_server_count required	최대 서버 수 Example : `2`	integer
min_server_count required	최소 서버 수 Example : `1`	integer
modified_at required	수정 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	수정자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
name required	Auto-Scaling Group 이름 Example : `auto-scaling-group-name`	string
security_group_ids optional	Security Group ID 목록 Example : `['c09c3f05-03d9-443f-b27a-40e0f973c75f']`	any of [array[string], null]
server_name_prefix required	서버 이름 접두사 Example : `server-name-prefix`	string
state required	Auto-Scaling Group 상태 Example : `IN_SERVICE`	string
state_check_delay_time required	ASG VM 생성 이후 상태체크까지의 유예기간 Example : `300`	integer
subnet_ids optional	Subnet ID 목록	array[string]
use_lb_state_check required	LB 상태체크 사용 여부 Example : `True`	boolean
vpc_id required	VPC ID Example : `cc976b621087484ea5fd527f4b78708b`	string

4.2.29 - AutoScalingGroupVirtualServerListResponse

Name	Description	Schema	Default
servers required	서버 목록	array[AutoScalingGroupVirtualServerShowResponse]

4.2.30 - AutoScalingGroupVirtualServerListResponseV1Dot2

Name	Description	Schema	Default
servers required	서버 목록	array[AutoScalingGroupVirtualServerShowResponseV1Dot2]

4.2.31 - AutoScalingGroupVirtualServerShowResponse

Name	Description	Schema
account_id required	계정 ID Example : `a8f10467abfc4b87b64614ab36eb9ae4`	string
addresses optional	주소 목록	any of [array[ServerShowResponseAddress], null]
auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string
created_at required	생성일시 Example : `2026-04-14T15:06:28.891Z`	string (date-time)
created_by required	생성자 ID Example : `97e6b22c9a4143789ca522df7457a32f`	string
disk_config required	디스크 컨피그 Example : `MANUAL`	string
id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string
image_id optional	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	any of [string, null]
is_marketplace optional	Marketplace 여부 Example : `False`	any of [boolean, null]
keypair_name optional	키페어 이름 Example : `keypairname`	any of [string, null]
launch_configuration_id optional	Launch Configuration ID Example : `b5aea5a675fc4f6b9e0fcd1288354c5f`	any of [string, null]
lb_linked_state optional	Load Balancer 연결 상태 Example : `ATTACHED`	any of [string, null]
locked required	잠김 여부 Example : `False`	boolean
metadata required	메타 데이터 Example :	object
modified_at required	수정일시 Example : `2026-04-14T15:06:28.919Z`	string (date-time)
name required	서버 이름 Example : `servername`	string
partition_number optional	파티션 넘버 Example : `1`	any of [integer, null]
planned_compute_os_type optional	Planned Compute OS 유형 Example : `windows`	any of [enum (open_source, windows, rhel), null]
product_category optional	상품군 Example : `compute`	any of [enum (compute, container), null]
product_offering optional	상품 Example : `virtual_server`	any of [enum (virtual_server, gpu_server, k8s_vm, k8s_gpu_vm), null]
security_groups optional	Security Group 목록	any of [array[ServerShowResponseSecurityGroup], null]
server_group_id optional	서버 그룹 ID Example : `616fb98f-46ca-475e-917e-2563e5a8cd19`	any of [string, null]
server_type required	서버 타입	ServerShowResponseServerType
state required	서버 상태 Example : `ACTIVE`	string
volumes required	볼륨 목록	array[ServerShowResponseVolume]
vpc_id optional	VPC ID Example : `cc976b621087484ea5fd527f4b78708b`	any of [string, null]

4.2.32 - AutoScalingGroupVirtualServerShowResponseV1Dot2

Name	Description	Schema
account_id required	계정 ID Example : `a8f10467abfc4b87b64614ab36eb9ae4`	string
addresses optional	주소 목록	any of [array[ServerShowResponseAddress], null]
auto_scaling_group_id required	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	string
created_at required	생성일시 Example : `2026-04-14T15:06:31.249Z`	string (date-time)
created_by required	생성자 ID Example : `97e6b22c9a4143789ca522df7457a32f`	string
disk_config required	디스크 컨피그 Example : `MANUAL`	string
id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string
image_id optional	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	any of [string, null]
is_asg_virtual_server_healthy optional	ASG Virtual Server의 최종 Health State Example : `True`	boolean
is_lb_healthy required	ASG Virtual Server의 LB 헬스체크 결과 Example : `True`	boolean
is_marketplace optional	Marketplace 여부 Example : `False`	any of [boolean, null]
keypair_name optional	키페어 이름 Example : `keypairname`	any of [string, null]
launch_configuration_id optional	Launch Configuration ID Example : `b5aea5a675fc4f6b9e0fcd1288354c5f`	any of [string, null]
lb_linked_state optional	Load Balancer 연결 상태 Example : `ATTACHED`	any of [string, null]
locked required	잠김 여부 Example : `False`	boolean
metadata required	메타 데이터 Example :	object
modified_at required	수정일시 Example : `2026-04-14T15:06:31.279Z`	string (date-time)
name required	서버 이름 Example : `servername`	string
partition_number optional	파티션 넘버 Example : `1`	any of [integer, null]
planned_compute_os_type optional	Planned Compute OS 유형 Example : `windows`	any of [enum (open_source, windows, rhel), null]
product_category optional	상품군 Example : `compute`	any of [enum (compute, container), null]
product_offering optional	상품 Example : `virtual_server`	any of [enum (virtual_server, gpu_server, k8s_vm, k8s_gpu_vm), null]
security_groups optional	Security Group 목록	any of [array[ServerShowResponseSecurityGroup], null]
server_group_id optional	서버 그룹 ID Example : `616fb98f-46ca-475e-917e-2563e5a8cd19`	any of [string, null]
server_type required	서버 타입	ServerShowResponseServerType
state required	서버 상태 Example : `ACTIVE`	string
volumes required	볼륨 목록	array[ServerShowResponseVolume]
vpc_id optional	VPC ID Example : `cc976b621087484ea5fd527f4b78708b`	any of [string, null]

4.2.33 - DefaultConfigListResponse

Name	Description	Schema	Default
configs required	설정 값 Example : `('key': 'value'}`	object
count required	총 개수 Example : `20`	integer

4.2.34 - ImageCreateRequest

Name	Description	Schema	Default
container_format optional	컨테이너 형식 Example : `bare` Pattern : `bare`	string	bare
disk_format optional	디스크 형식 Example : `qcow2` Pattern : `qcow2`	string	qcow2
min_disk optional	생성할 이미지의 최소 디스크 용량(GB) Example : `100`	integer
min_ram optional	생성할 이미지의 최소 RAM 용량(GB) Example : `0` Maximum : `2097151`	integer
name required	이미지 이름 Example : `imagename` Pattern : `^[a-zA-Z0-9-_ ]$` Minimum length* : `1` Maximum length : `255`	string
os_distro required	업로드할 이미지의 OS 배포판 Example : `alma`	enum (alma, centos, rhel, rocky, ubuntu, windows, oracle)
protected optional	이미지 삭제 금지 여부 Example : `False`	boolean
tags optional	Tags Example : `[{'key': 'key', 'value': 'value'}]`	any of [array[Tag], null]
url required	이미지 파일에 대한 Object Storage URL (qcow2 형식만 허용) Example : `https://object-store.kr-west1.s.samsungsdscloud.com/8989447062e04a818baf9e073fd04fa7/bucket/object.qcow2` Maximum length : `255`	string
visibility optional	이미지에 대한 권한을 나타냅니다. 비공개: 계정 내에서만 사용 가능, 공유: 계정 간에 공유 가능 Example : `private` Pattern : `private\|shared`	string	private

4.2.35 - ImageImportRequest

Name	Description	Schema	Default
url required	이미지 파일에 대한 Object Storage URL (qcow2 형식만 허용) Example : `https://object-store.kr-west1.s.samsungsdscloud.com/8989447062e04a818baf9e073fd04fa7/bucket/object.qcow2` Pattern : `.\.qcow2$` Maximum length* : `255`	string

4.2.36 - ImageListResponse

Name	Description	Schema	Default
images required		array[ImageShowResponse]

4.2.37 - ImageListResponseV1Dot2

Name	Description	Schema	Default
images required		array[ImageShowResponseV1Dot2]

4.2.38 - ImageMemberCreateRequest

Name	Description	Schema	Default
member_id required	공유용 이미지 멤버 ID Example : `a8f10467abfc4b87b64614ab36eb9ae4` Pattern : `^[A-Za-z0-9-]$` Minimum length* : `1` Maximum length : `64`	string

4.2.39 - ImageMemberListResponse

Name	Description	Schema	Default
members required		array[ImageMemberShowResponse]

4.2.40 - ImageMemberSetRequest

Name	Description	Schema	Default
status required	이미지 멤버 상태. 승인 대기중, 승인 완료, 거부 중 하나의 값 Example : `pending`	enum (pending, accepted, rejected)

4.2.41 - ImageMemberShowResponse

Name	Description	Schema
created_at required	생성일시 Example : `2025-07-22T09:00:00Z`	string
image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string
member_id required	공유용 이미지 멤버 ID Example : `a8f10467abfc4b87b64614ab36eb9ae4`	string
status required	이미지 멤버 상태. 승인 대기중, 승인 완료, 거부 중 하나의 값 Example : `pending`	string
updated_at required	수정일시 Example : `2025-07-26T12:00:00Z`	string

4.2.42 - ImageSetRequest

Name	Description	Schema
min_disk optional	생성할 이미지의 최소 디스크 용량(GB) Example : `100`	any of [integer, null]
min_ram optional	생성할 이미지의 최소 RAM 용량(GB) Example : `0`	any of [integer, null]
protected optional	이미지 삭제 금지 여부 Example : `False`	any of [boolean, null]
visibility optional	이미지에 대한 권한을 나타냅니다. 비공개: 계정 내에서만 사용 가능, 공유: 계정 간에 공유 가능 Example : `private` Pattern : `private\|shared`	any of [string, null]

4.2.43 - ImageShowResponse

Name	Description	Schema
checksum optional	전체 이미지 데이터의 MD5 해시. 이 필드를 사용하여 이미지의 무결성 확인 Example : `7538e0fcb56e0e272cfd89eb384d6613`	any of [string, null]
container_format required	컨테이너 형식 Example : `bare`	string
created_at required	생성일시 Example : `2025-07-22T09:00:00Z`	string
disk_format required	디스크 형식 Example : `qcow2`	string
file required	서버 이미지 파일의 URL Example : `/v2/images/e08a37c1-2162-416e-b7fa-19902419170b/file`	string
id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string
min_disk required	생성할 이미지의 최소 디스크 용량(GB) Example : `100`	integer
min_ram required	생성할 이미지의 최소 RAM 용량(GB) Example : `0`	integer
name required	이미지 이름 Example : `imagename`	string
os_distro optional	업로드할 이미지의 OS 배포판 Example : `alma`	any of [string, null]
os_hash_algo optional	이미지 무결성을 확인하는 데 사용되는 OS 해시 알고리즘 Example : `sha512`	any of [string, null]
os_hash_value optional	OS 해시 알고리즘에 의해 표시된 알고리즘으로 계산된 이미지 바이너리의 실제 다이제스트. 값은 16진수 문자열로 표시 Example : `c6a32fc3b7c909b8900b46f5e6066c028a1d799c0a263cf064a600c430a714627c21f98ac248e2f2bf29870a1a2773c7908244745016878e1a5f31dc2c405b99`	any of [string, null]
os_hidden required	이미지 숨김 여부 Example : `False`	boolean
owner required	소유 account ID Example : `a8f10467abfc4b87b64614ab36eb9ae4`	string
owner_account_name optional	소유 account 이름 Example : `AccountName`	any of [string, null]
owner_user_name optional	소유자 이름 Example : `user@samsung.com`	any of [string, null]
protected required	이미지 삭제 금지 여부 Example : `False`	boolean
root_device_name optional	루트 디바이스 이름 Example : `/dev/vda`	any of [string, null]
scp_image_type optional	이미지 타입 Example : `custom`	any of [string, null]
scp_k8s_version optional	K8S 버전 Example : `v1.28.7`	any of [string, null]
scp_original_image_type optional	원본 이미지 타입 Example : `standard`	any of [string, null]
scp_os_build_version optional	OS 빌드 버전 Example : `20250101`	any of [string, null]
scp_os_version optional	OS 버전 Example : `8.8`	any of [string, null]
size optional	이미지 크기 Example : `2429747200`	any of [integer, null]
status required	이미지 상태 Example : `active`	string
updated_at required	수정일시 Example : `2025-07-26T12:00:00Z`	string
url optional	이미지 파일에 대한 Object Storage URL (qcow2 형식만 허용) Example : `https://object-store.kr-west1.s.samsungsdscloud.com/8989447062e04a818baf9e073fd04fa7/bucket/object.qcow2`	any of [string, null]
virtual_size optional	가상 크기 Example : `17179869184`	any of [integer, null]
visibility required	이미지에 대한 권한을 나타냅니다. 비공개: 계정 내에서만 사용 가능, 공유: 계정 간에 공유 가능 Example : `private`	string
volumes optional	볼륨 목록 Example : `[{"tag": null, "volume_id": null, "encryption_options": null, "encryption_secret_uuid": null, "encryption_format": null, "device_name": "/dev/vda", "disk_bus": "virtio", "volume_type": null, "encrypted": null, "image_id": null, "device_type": "disk", "source_type": "snapshot", "delete_on_termination": false, "volume_size": 104, "guest_format": null, "boot_index": 0, "destination_type": "volume", "snapshot_id": "abde9e38-2ed5-4ecd-b23c-b0120e30690e", "no_device": null}]`	any of [string, null]

4.2.44 - ImageShowResponseV1Dot2

Name	Description	Schema
checksum optional	전체 이미지 데이터의 MD5 해시. 이 필드를 사용하여 이미지의 무결성 확인 Example : `7538e0fcb56e0e272cfd89eb384d6613`	any of [string, null]
container_format required	컨테이너 형식 Example : `bare`	string
created_at required	생성일시 Example : `2025-07-22T09:00:00Z`	string
disk_format required	디스크 형식 Example : `qcow2`	string
file required	서버 이미지 파일의 URL Example : `/v2/images/e08a37c1-2162-416e-b7fa-19902419170b/file`	string
id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string
min_disk required	생성할 이미지의 최소 디스크 용량(GB) Example : `100`	integer
min_ram required	생성할 이미지의 최소 RAM 용량(GB) Example : `0`	integer
name required	이미지 이름 Example : `imagename`	string
os_distro optional	업로드할 이미지의 OS 배포판 Example : `alma`	any of [string, null]
os_hash_algo optional	이미지 무결성을 확인하는 데 사용되는 OS 해시 알고리즘 Example : `sha512`	any of [string, null]
os_hash_value optional	OS 해시 알고리즘에 의해 표시된 알고리즘으로 계산된 이미지 바이너리의 실제 다이제스트. 값은 16진수 문자열로 표시 Example : `c6a32fc3b7c909b8900b46f5e6066c028a1d799c0a263cf064a600c430a714627c21f98ac248e2f2bf29870a1a2773c7908244745016878e1a5f31dc2c405b99`	any of [string, null]
os_hidden required	이미지 숨김 여부 Example : `False`	boolean
owner required	소유 account ID Example : `a8f10467abfc4b87b64614ab36eb9ae4`	string
owner_account_name optional	소유 account 이름 Example : `AccountName`	any of [string, null]
owner_user_name optional	소유자 이름 Example : `user@samsung.com`	any of [string, null]
protected required	이미지 삭제 금지 여부 Example : `False`	boolean
root_device_name optional	루트 디바이스 이름 Example : `/dev/vda`	any of [string, null]
scp_gpu_driver optional	K8s GPU Image driver version Example : `535.183.06`	any of [string, null]
scp_image_type optional	이미지 타입 Example : `custom`	any of [string, null]
scp_k8s_version optional	K8S 버전 Example : `v1.28.7`	any of [string, null]
scp_original_image_type optional	원본 이미지 타입 Example : `standard`	any of [string, null]
scp_os_build_version optional	OS 빌드 버전 Example : `20250101`	any of [string, null]
scp_os_version optional	OS 버전 Example : `8.8`	any of [string, null]
size optional	이미지 크기 Example : `2429747200`	any of [integer, null]
status required	이미지 상태 Example : `active`	string
updated_at required	수정일시 Example : `2025-07-26T12:00:00Z`	string
url optional	이미지 파일에 대한 Object Storage URL (qcow2 형식만 허용) Example : `https://object-store.kr-west1.s.samsungsdscloud.com/8989447062e04a818baf9e073fd04fa7/bucket/object.qcow2`	any of [string, null]
virtual_size optional	가상 크기 Example : `17179869184`	any of [integer, null]
visibility required	이미지에 대한 권한을 나타냅니다. 비공개: 계정 내에서만 사용 가능, 공유: 계정 간에 공유 가능 Example : `private`	string
volumes optional	볼륨 목록 Example : `[{"tag": null, "volume_id": null, "encryption_options": null, "encryption_secret_uuid": null, "encryption_format": null, "device_name": "/dev/vda", "disk_bus": "virtio", "volume_type": null, "encrypted": null, "image_id": null, "device_type": "disk", "source_type": "snapshot", "delete_on_termination": false, "volume_size": 104, "guest_format": null, "boot_index": 0, "destination_type": "volume", "snapshot_id": "abde9e38-2ed5-4ecd-b23c-b0120e30690e", "no_device": null}]`	any of [string, null]

4.2.45 - InterfaceAttachmentFixedIp

Name	Description	Schema	Default
ip_address required	IP 주소 Example : `192.169.3.2`	string

4.2.46 - InterfaceResponse

Name	Description	Schema
fixed_ips required	고정 IP 목록	array[InterfaceAttachmentFixedIp]
mac_addr required	MAC 주소 Example : `fa:16:3e:c0:71:2b`	string
port_id required	포트 ID Example : `f2b02fc5-a5fd-4b5f-b1a9-987f4c0d66cc`	string
port_state required	Port 상태 Example : `ACTIVE`	string
private_static_nat optional	Private Static NAT	PrivateStaticNat
static_nat optional	Public Static NAT	PublicStaticNat
subnet_id required	서브넷 ID Example : `183c6c30df0c4fcbb16422aa2d64aa21`	string

4.2.47 - InterfaceResponseV1Dot2

Name	Description	Schema
fixed_ips required	고정 IP 목록	array[InterfaceAttachmentFixedIp]
is_default required	기본 포트인지 여부를 나타냅니다. Example : `True`	boolean
mac_addr required	MAC 주소 Example : `fa:16:3e:c0:71:2b`	string
port_id required	포트 ID Example : `f2b02fc5-a5fd-4b5f-b1a9-987f4c0d66cc`	string
port_state required	Port 상태 Example : `ACTIVE`	string
private_static_nat optional	Private Static NAT	PrivateStaticNat
static_nat optional	Public Static NAT	PublicStaticNat
subnet_id required	서브넷 ID Example : `183c6c30df0c4fcbb16422aa2d64aa21`	string

4.2.48 - Keypair

Name	Description	Schema
fingerprint required	Fingerprint Example : `7e:eb:ab:24:ba:d1:e1:88:ae:9a:fb:66:53:df:d3:bd`	string
name required	키페어 이름 Example : `keypairname`	string
public_key required	공개 키 Example : `ssh-rsa fakeKey Generated-by-SCP`	string
type required	키페어 유형 Example : `ssh`	string

4.2.49 - KeypairCreateRequest

Name	Description	Schema
name required	키페어 이름 Example : `keypairname` Pattern : `^[a-zA-Z0-9-_ ]$` Minimum length* : `1` Maximum length : `255`	string
public_key optional	공개 키 Example : `ssh-rsa fakeKey Generated-by-SCP`	any of [string, null]
tags optional	Tags Example : `[{'key': 'key', 'value': 'value'}]`	any of [array[Tag], null]

4.2.50 - KeypairCreateResponse

Name	Description	Schema
fingerprint required	Fingerprint Example : `7e:eb:ab:24:ba:d1:e1:88:ae:9a:fb:66:53:df:d3:bd`	string
name required	키페어 이름 Example : `keypairname`	string
private_key optional	비밀 키 Example : `—–BEGIN RSA PRIVATE KEY—–
fakeKey
—–END RSA PRIVATE KEY—–`	any of [string, null]
public_key required	공개 키 Example : `ssh-rsa fakeKey Generated-by-SCP`	string
type required	키페어 유형 Example : `ssh`	string

4.2.51 - KeypairListResponse

Name	Description	Schema	Default
keypairs required		array[Keypair]

4.2.52 - KeypairShowResponse

Name	Description	Schema
created_at required	생성일시 Example : `2025-07-22T09:00:00Z`	string (date-time)
fingerprint required	Fingerprint Example : `7e:eb:ab:24:ba:d1:e1:88:ae:9a:fb:66:53:df:d3:bd`	string
id required	키페어 ID Example : `1`	integer
name required	키페어 이름 Example : `keypairname`	string
public_key required	공개 키 Example : `ssh-rsa fakeKey Generated-by-SCP`	string
type required	키페어 유형 Example : `ssh`	string
user_id required	사용자 ID Example : `570907805e5447be84b618450ef52o0t`	string

4.2.53 - LaunchConfigurationCreateRequest

Name	Description	Schema
image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string
keypair_name required	키페어 이름 Example : `keypairname`	string
name required	Launch Configuration 이름 Example : `launch-configuration-name` Pattern : `^[a-zA-Z0-9-_]$` Minimum length* : `1` Maximum length : `63`	string
server_type_id required	서버 타입 ID Example : `s1v1m2`	string
tags optional	Tags Example : `[{'key': 'key', 'value': 'value'}]`	any of [array[Tag], null]
user_data optional	A script that runs at the start of a server on Auto-Scaling Group that will use Launch Configuration.It must be Base64-encoded string and must not exceed 45,000 bytes. Example : `IyEvYmluL2Jhc2gKL2Jpbi9zdQplY2hvICJJIGFtIGluIHlvdSEiCg==`	any of [string, null]
volumes optional	볼륨 목록	any of [array[LaunchConfigurationVolume], null]

4.2.54 - LaunchConfigurationDetailShowResponse

Name	Description	Schema
account_id required	계정 ID Example : `a8f10467abfc4b87b64614ab36eb9ae4`	string
auto_scaling_group_count optional	Launch Configuration에 연결된 Auto-Scaling Group 수 Example : `1`	any of [integer, null]
created_at required	생성 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	생성자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
id required	ID Example : `0fdd87aab8cb46f59b7c1f81ed03fb3e`	string
image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string
image_name required	이미지 이름 Example : `imagename`	string
keypair_name required	키페어 이름 Example : `keypairname`	string
modified_at required	수정 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	수정자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
name required	Launch Configuration 이름 Example : `launch-configuration-name`	string
public_key optional	공개 키 Example : `ssh-rsa fakeKey Generated-by-SCP`	any of [string, null]
server_type_id required	서버 타입 ID Example : `s1v1m2`	string
state required	Launch Configuration 상태 Example : `ACTIVE`	string
user_data optional	A script that runs at the start of a server on Auto-Scaling Group that will use Launch Configuration.It must be Base64-encoded string and must not exceed 45,000 bytes. Example : `IyEvYmluL2Jhc2gKL2Jpbi9zdQplY2hvICJJIGFtIGluIHlvdSEiCg==`	any of [string, null]
volumes optional	볼륨 목록	any of [array[LaunchConfigurationVolume], null]

4.2.55 - LaunchConfigurationDetailShowResponseV1Dot2

Name	Description	Schema
account_id required	계정 ID Example : `a8f10467abfc4b87b64614ab36eb9ae4`	string
auto_scaling_group_count optional	Launch Configuration에 연결된 Auto-Scaling Group 수 Example : `1`	any of [integer, null]
created_at required	생성 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	생성자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
file_storage_ids optional	File Storage ID list Example :	any of [array[string], null]
id required	ID Example : `0fdd87aab8cb46f59b7c1f81ed03fb3e`	string
image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string
image_name required	이미지 이름 Example : `imagename`	string
keypair_name required	키페어 이름 Example : `keypairname`	string
modified_at required	수정 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	수정자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
name required	Launch Configuration 이름 Example : `launch-configuration-name`	string
public_key optional	공개 키 Example : `ssh-rsa fakeKey Generated-by-SCP`	any of [string, null]
server_type_id required	서버 타입 ID Example : `s1v1m2`	string
state required	Launch Configuration 상태 Example : `ACTIVE`	string
user_data optional	A script that runs at the start of a server on Auto-Scaling Group that will use Launch Configuration.It must be Base64-encoded string and must not exceed 45,000 bytes. Example : `IyEvYmluL2Jhc2gKL2Jpbi9zdQplY2hvICJJIGFtIGluIHlvdSEiCg==`	any of [string, null]
volumes optional	볼륨 목록	any of [array[LaunchConfigurationVolumeV1Dot2], null]

4.2.56 - LaunchConfigurationListResponse

Name	Description	Schema	Default
count optional	총 개수 Example : `20`	integer
launch_configurations required	Launch Configuration 목록	array[LaunchConfigurationShowResponse]

4.2.57 - LaunchConfigurationListResponseV1Dot2

Name	Description	Schema	Default
count optional	총 개수 Example : `20`	integer
launch_configurations required	Launch Configuration 목록	array[LaunchConfigurationShowResponseV1Dot2]

4.2.58 - LaunchConfigurationShowResponse

Name	Description	Schema
account_id required	계정 ID Example : `a8f10467abfc4b87b64614ab36eb9ae4`	string
auto_scaling_group_count optional	Launch Configuration에 연결된 Auto-Scaling Group 수 Example : `1`	any of [integer, null]
boot_disk_size optional	기본 볼륨 크기 Example : `104`	any of [integer, null]
created_at required	생성 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	생성자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
extra_disk_size optional	추가 볼륨 크기 Example : `104`	any of [integer, null]
id required	ID Example : `0fdd87aab8cb46f59b7c1f81ed03fb3e`	string
image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string
image_name required	이미지 이름 Example : `imagename`	string
keypair_name required	키페어 이름 Example : `keypairname`	string
modified_at required	수정 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	수정자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
name required	Launch Configuration 이름 Example : `launch-configuration-name`	string
public_key optional	공개 키 Example : `ssh-rsa fakeKey Generated-by-SCP`	any of [string, null]
server_type_id required	서버 타입 ID Example : `s1v1m2`	string
state required	Launch Configuration 상태 Example : `ACTIVE`	string
user_data optional	A script that runs at the start of a server on Auto-Scaling Group that will use Launch Configuration.It must be Base64-encoded string and must not exceed 45,000 bytes. Example : `IyEvYmluL2Jhc2gKL2Jpbi9zdQplY2hvICJJIGFtIGluIHlvdSEiCg==`	any of [string, null]
volumes optional	볼륨 목록	any of [array[LaunchConfigurationVolume], null]

4.2.59 - LaunchConfigurationShowResponseV1Dot2

Name	Description	Schema
account_id required	계정 ID Example : `a8f10467abfc4b87b64614ab36eb9ae4`	string
auto_scaling_group_count optional	Launch Configuration에 연결된 Auto-Scaling Group 수 Example : `1`	any of [integer, null]
boot_disk_size optional	기본 볼륨 크기 Example : `104`	any of [integer, null]
created_at required	생성 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	생성자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
extra_disk_size optional	추가 볼륨 크기 Example : `104`	any of [integer, null]
file_storage_ids optional	File Storage ID list Example :	any of [array[string], null]
id required	ID Example : `0fdd87aab8cb46f59b7c1f81ed03fb3e`	string
image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string
image_name required	이미지 이름 Example : `imagename`	string
keypair_name required	키페어 이름 Example : `keypairname`	string
modified_at required	수정 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	수정자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
name required	Launch Configuration 이름 Example : `launch-configuration-name`	string
public_key optional	공개 키 Example : `ssh-rsa fakeKey Generated-by-SCP`	any of [string, null]
server_type_id required	서버 타입 ID Example : `s1v1m2`	string
state required	Launch Configuration 상태 Example : `ACTIVE`	string
user_data optional	A script that runs at the start of a server on Auto-Scaling Group that will use Launch Configuration.It must be Base64-encoded string and must not exceed 45,000 bytes. Example : `IyEvYmluL2Jhc2gKL2Jpbi9zdQplY2hvICJJIGFtIGluIHlvdSEiCg==`	any of [string, null]
volumes optional	볼륨 목록	any of [array[LaunchConfigurationVolume], null]

4.2.60 - LaunchConfigurationVolume

Name	Description	Schema
boot_index required	부팅 장치를 시도하는 순서 Example : `0`	integer
size required	볼륨 크기 Example : `104`	integer
type optional	볼륨 타입 Example : `SSD`	any of [string, null]

4.2.61 - LaunchConfigurationVolumeV1Dot2

Name	Description	Schema
boot_index required	부팅 장치를 시도하는 순서 Example : `0`	integer
max_iops optional	The number of distinct read or write operations a volume can process in a single second. Example : `10000`	any of [integer, null]
max_throughput optional	The actual amount of data (volume) transferred to or from the storage device per second. Example : `500`	any of [integer, null]
size required	볼륨 크기 Example : `104`	integer
type optional	볼륨 타입 Example : `SSD`	any of [string, null]

4.2.62 - Network

Name	Description	Schema
fixed_ip optional	고정 IP Example : `192.169.3.2`	any of [string, null]
port_id optional	포트 ID Example : `91424c08-0b26-49fb-9808-ed042292ceef`	any of [string, null]
public_ip_id optional	공개 IP ID Example : `615fa9cd5cff486c9de679b3ce63e601`	any of [string, null]
subnet_id optional	서브넷 ID Example : `78b2ee3f074145c580ab6abac4821f97`	any of [string, null]

4.2.63 - PrivateStaticNat

Name	Description	Schema
external_ip_address required	외부 IP 주소 Example : `182.197.61.81`	string
id required	NAT ID Example : `224b80106e6f41b38efe98ac9ddbf280`	string
private_nat_ip_id optional	비공개 NAT IP ID Example : `1f0cb5390c40483592ddc5a282f53496`	any of [string, null]
state required	NAT 상태 Example : `ACTIVE`	string

4.2.64 - PublicStaticNat

Name	Description	Schema
external_ip_address required	외부 IP 주소 Example : `182.197.61.81`	string
id required	NAT ID Example : `224b80106e6f41b38efe98ac9ddbf280`	string
publicip_id optional	공개 IP ID Example : `615fa9cd5cff486c9de679b3ce63e601`	any of [string, null]
state required	NAT 상태 Example : `ACTIVE`	string

4.2.65 - SecurityGroupResponse

Name	Description	Schema
account_id required	Security Group owner의 account ID Example : `6f70656e737461636b20342065766572`	string
description required	Security Group 설명 Example : `Security group description`	string
id required	Security Group ID Example : `616fb98f-46ca-475e-917e-2563e5a8cd19`	string
name required	Security Group 이름 Example : `securitygroup`	string
rules required	Security Group 규칙 목록	array[SecurityGroupResponseRule]

4.2.66 - SecurityGroupResponseRule

Name	Description	Schema
from_port required	포트 범위의 시작 값 Example : `1`	any of [integer, null]
id required	Security Group 규칙 ID Example : `ca5cb96b-9df6-4af7-9682-4d60a58d38a5`	string
ip_protocol required	IP 프로토콜 Example : `tcp`	any of [string, null]
ip_range optional	IP 범위	any of [SecurityGroupResponseRuleIpRange, null]
to_port required	포트 범위의 마지막 값 Example : `65535`	any of [integer, null]

4.2.67 - SecurityGroupResponseRuleIpRange

Name	Description	Schema	Default
cidr optional	CIDR Example : `0.0.0.0/0`	any of [string, null]

4.2.68 - ServerConsoleLogResponse

Name	Description	Schema	Default
output optional	서버 콘솔 로그. Example : `FAKE CONSOLE OUTPUT`	any of [string, null]

4.2.69 - ServerCreateImageRequestBody

Name	Description	Schema	Default
image_name required	이미지 이름 Example : `imagename`	string

4.2.70 - ServerCreateImageResponse

Name	Description	Schema	Default
image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string

4.2.71 - ServerCreateRequest

Name	Description	Schema	Default
image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string
keypair_name required	키페어 이름 Example : `keypairname`	string
lock optional	서버의 잠금 상태를 설정합니다. 서버가 잠긴 경우, 대부분의 사용자 작업이 허용되지 않습니다. Example : `False`	any of [boolean, null]
max_count optional	배포 가능한 서버의 최대 개수 Example : `2`	any of [integer, null]	1
metadata optional	사용자 정의한 메타데이터를 키-값 쌍의 형태로 지정할 수 있습니다. Example :	any of [object, null]
name required	서버 이름 Example : `servername` Pattern : `^[a-zA-Z0-9-_ ]$` Minimum length* : `1` Maximum length : `63`	string
networks required	네트워크 목록	array[Network]
partition_number optional	서버 생성을 위한 파티션 번호를 선택합니다. 서버 그룹의 유형이 파티션일 때만 사용할 수 있습니다. Example : `1`	any of [integer, null]
product_category optional	상품군 Example : `compute`	any of [enum (compute, container), null]
product_offering optional	상품 Example : `virtual_server`	any of [enum (virtual_server, gpu_server, k8s_vm, k8s_gpu_vm), null]
security_groups optional	Security Group 목록 Example : `['c09c3f05-03d9-443f-b27a-40e0f973c75f']`	any of [array[string], null]
server_group_id optional	서버 그룹 ID Example : `616fb98f-46ca-475e-917e-2563e5a8cd19`	any of [string, null]
server_type_id required	서버 타입 ID Example : `s1v1m2`	string
tags optional	Tags Example : `[{'key': 'key', 'value': 'value'}]`	any of [array[Tag], null]
user_data optional	서버 시작 시 실행되는 스크립트 또는 구성입니다. Base64로 인코딩된 문자열이어야 하며 65535 바이트를 초과할 수 없습니다. Example : `IyEvYmluL2Jhc2gKL2Jpbi9zdQplY2hvICJJIGFtIGluIHlvdSEiCg==`	any of [string, null]
volumes optional	볼륨 목록	any of [array[Volume], null]

4.2.72 - ServerCreateRequestV1Dot2

Name	Description	Schema	Default
file_storage_ids optional	File Storage ID list Example : `['96d258ea-dd5d-4cca-bb3a-b6909b7e2065', '949bd9c7-2098-4284-9685-13268d193117']`	any of [array[string], null]
image_id required	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	string
keypair_name required	키페어 이름 Example : `keypairname`	string
lock optional	서버의 잠금 상태를 설정합니다. 서버가 잠긴 경우, 대부분의 사용자 작업이 허용되지 않습니다. Example : `False`	any of [boolean, null]
max_count optional	배포 가능한 서버의 최대 개수 Example : `2`	any of [integer, null]	1
metadata optional	사용자 정의한 메타데이터를 키-값 쌍의 형태로 지정할 수 있습니다. Example :	any of [object, null]
name required	서버 이름 Example : `servername` Pattern : `^[a-zA-Z0-9-_ ]$` Minimum length* : `1` Maximum length : `63`	string
networks required	네트워크 목록	array[Network]
partition_number optional	서버 생성을 위한 파티션 번호를 선택합니다. 서버 그룹의 유형이 파티션일 때만 사용할 수 있습니다. Example : `1`	any of [integer, null]
product_category optional	상품군 Example : `compute`	any of [enum (compute, container), null]
product_offering optional	상품 Example : `virtual_server`	any of [enum (virtual_server, gpu_server, k8s_vm, k8s_gpu_vm), null]
security_groups optional	Security Group 목록 Example : `['c09c3f05-03d9-443f-b27a-40e0f973c75f']`	any of [array[string], null]
server_group_id optional	서버 그룹 ID Example : `616fb98f-46ca-475e-917e-2563e5a8cd19`	any of [string, null]
server_type_id required	서버 타입 ID Example : `s1v1m2`	string
tags optional	Tags Example : `[{'key': 'key', 'value': 'value'}]`	any of [array[Tag], null]
user_data optional	서버 시작 시 실행되는 스크립트 또는 구성입니다. Base64로 인코딩된 문자열이어야 하며 65535 바이트를 초과할 수 없습니다. Example : `IyEvYmluL2Jhc2gKL2Jpbi9zdQplY2hvICJJIGFtIGluIHlvdSEiCg==`	any of [string, null]
volumes required	볼륨 목록	array[VolumeV1Dot2]

4.2.73 - ServerCreateResponse

Name	Description	Schema	Default
servers required	서버 ID 목록	array[ServerCreateResponseParam]

4.2.74 - ServerCreateResponseParam

Name	Description	Schema	Default
id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string

4.2.75 - ServerGroup

Name	Description	Schema
account_id required	계정 ID Example : `a8f10467abfc4b87b64614ab36eb9ae4`	string
id required	서버 그룹 ID Example : `616fb98f-46ca-475e-917e-2563e5a8cd19`	string
members required	서버 그룹에 속한 서버 목록 Example : `['2a9be312-5d4b-4bc8-b2ae-35100fa9241f']`	array[string]
name required	서버 그룹 명 Example : `server-group`	string
partition_size required	서버 그룹 정책이 파티션인 경우 파티션의 크기 Example : `3`	any of [integer, null]
policy required	서버 그룹 정책 Example : `anti-affinity`	string
user_id required	사용자 ID Example : `570907805e5447be84b618450ef52o0t`	string

4.2.76 - ServerGroupCreateRequest

Name	Description	Schema
name required	서버 그룹 명 Example : `server-group` Pattern : `^[a-zA-Z0-9-_ ]$` Minimum length* : `1` Maximum length : `255`	string
policy required	서버 그룹 정책 Example : `anti-affinity` Pattern : `^affinity$\|^anti-affinity$\|^partition$`	string
tags optional	Tags Example : `[{'key': 'key', 'value': 'value'}]`	any of [array[Tag], null]

4.2.77 - ServerGroupListResponse

Name	Description	Schema	Default
server_groups required	서버 그룹 목록	array[ServerGroup]

4.2.78 - ServerGroupPartitionSizeResponse

Name	Description	Schema	Default
partition_size required	Example :	integer

4.2.79 - ServerInterfaceCreateRequest

Name	Description	Schema
fixed_ips optional	고정 IP 목록	any of [array[InterfaceAttachmentFixedIp], null]
port_id optional	포트 ID Example : `91424c08-0b26-49fb-9808-ed042292ceef`	any of [string, null]
subnet_id optional	서브넷 ID Example : `78b2ee3f074145c580ab6abac4821f97`	any of [string, null]

4.2.80 - ServerInterfaceListResponse

Name	Description	Schema	Default
interfaces required	인터페이스 목록	array[InterfaceResponse]

4.2.81 - ServerInterfaceListResponseV1Dot2

Name	Description	Schema	Default
interfaces required	인터페이스 목록	array[InterfaceResponseV1Dot2]

4.2.82 - ServerInterfaceUpdateRequest

Name	Description	Schema	Default
fixed_ip_address optional	IP 주소 Example : `192.169.3.2`	any of [string, null]
subnet_id optional	서브넷 ID Example :	any of [string, null]

4.2.83 - ServerIpsResponse

Name	Description	Schema	Default
addresses required	IP 주소 목록	array[ServerShowResponseAddress]

4.2.84 - ServerListResponse

Name	Description	Schema	Default
servers required	서버 목록	array[ServerShowResponse]

4.2.85 - ServerPasswordRequest

Name	Description	Schema	Default
private_key optional	비밀 키 Example : `—–BEGIN RSA PRIVATE KEY—–
fakeKey
—–END RSA PRIVATE KEY—–`	any of [string, null]

4.2.86 - ServerPasswordResponse

Name	Description	Schema	Default
password optional	Server password Example : `password`	any of [string, null]

4.2.87 - ServerPrivateStaticNatCreateRequest

Name	Description	Schema	Default
private_nat_id required	Private NAT ID Example : `3a6c1dc6b1b24e02a444d672c2798a1c`	string
private_nat_ip_id required	비공개 NAT IP ID Example : `1f0cb5390c40483592ddc5a282f53496`	string

4.2.88 - ServerQuotaSet

Name	Description	Schema
cores required	코어 한도	ServerQuotaSetObject
id required	쿼터 셋 ID Example : `fc7283354c6143a58629b59f4c3e16b2`	string
instances required	인스턴스 한도	ServerQuotaSetObject
keypairs required	키페어 한도	ServerQuotaSetObject
metadata_items required	메타 데이터 항목 한도	ServerQuotaSetObject
ram required	램 한도	ServerQuotaSetObject
server_group_members required	서버 그룹 멤버 한도	ServerQuotaSetObject
server_groups required	서버 그룹 한도	ServerQuotaSetObject

4.2.89 - ServerQuotaSetObject

Name	Description	Schema
in_use required	사용 중인 수 Example : `10`	integer
limit required	최대 한도 수 Example : `20`	integer
reserved required	예약 중인 수 Example : `0`	integer

4.2.90 - ServerRebootRequestBody

Name	Description	Schema	Default
reboot_type optional	재시작 유형. SOFT는 서버를 정상적으로 종료한 뒤 다시 시작합니다. HARD는 서버를 강제로 종료하고 다시 시작합니다. HARD 재부팅은 서버의 전원을 끄고 켜는 동작과 동일합니다. Example : `SOFT`	any of [enum (SOFT, HARD), null]	SOFT

4.2.91 - ServerSecurityGroupActionRequestBody

Name	Description	Schema	Default
security_group_id required	Security Group ID Example : `c09c3f05-03d9-443f-b27a-40e0f973c75f`	string

4.2.92 - ServerSecurityGroupListResponse

Name	Description	Schema	Default
security_groups required	Security Group 목록	array[SecurityGroupResponse]

4.2.93 - ServerSetServerTypeRequestBody

Name	Description	Schema	Default
server_type required	서버 타입 Example : `s1v1m2`	string

4.2.94 - ServerShowResponse

Name	Description	Schema
account_id required	계정 ID Example : `a8f10467abfc4b87b64614ab36eb9ae4`	string
addresses optional	주소 목록	any of [array[ServerShowResponseAddress], null]
auto_scaling_group_id optional	Auto-Scaling Group ID Example : `52613bd852b04b39adcb15a8364d856d`	any of [string, null]
created_at required	생성일시 Example : `2026-04-14T15:06:29.755Z`	string (date-time)
created_by required	생성자 ID Example : `97e6b22c9a4143789ca522df7457a32f`	string
disk_config required	디스크 컨피그 Example : `MANUAL`	string
id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string
image_id optional	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	any of [string, null]
is_marketplace optional	Marketplace 여부 Example : `False`	any of [boolean, null]
keypair_name optional	키페어 이름 Example : `keypairname`	any of [string, null]
launch_configuration_id optional	Launch Configuration ID Example : `b5aea5a675fc4f6b9e0fcd1288354c5f`	any of [string, null]
locked required	잠김 여부 Example : `False`	boolean
metadata required	메타 데이터 Example :	object
modified_at required	수정일시 Example : `2026-04-14T15:06:29.778Z`	string (date-time)
name required	서버 이름 Example : `servername`	string
partition_number optional	파티션 넘버 Example : `1`	any of [integer, null]
planned_compute_os_type optional	Planned Compute OS 유형 Example : `windows`	any of [enum (open_source, windows, rhel), null]
product_category optional	상품군 Example : `compute`	any of [enum (compute, container), null]
product_offering optional	상품 Example : `virtual_server`	any of [enum (virtual_server, gpu_server, k8s_vm, k8s_gpu_vm), null]
security_groups optional	Security Group 목록	any of [array[ServerShowResponseSecurityGroup], null]
server_group_id optional	서버 그룹 ID Example : `616fb98f-46ca-475e-917e-2563e5a8cd19`	any of [string, null]
server_type required	서버 타입	ServerShowResponseServerType
state required	서버 상태 Example : `ACTIVE`	string
volumes required	볼륨 목록	array[ServerShowResponseVolume]
vpc_id optional	VPC ID Example : `cc976b621087484ea5fd527f4b78708b`	any of [string, null]

4.2.95 - ServerShowResponseAddress

Name	Description	Schema	Default
ip_addresses required	IP 주소 목록	array[ServerShowResponseAddressIpAddress]
subnet_name required	서브넷 이름 Example : `subnetname`	string

4.2.96 - ServerShowResponseAddressIpAddress

Name	Description	Schema	Default
ip_address required	IP 주소 Example : `192.169.3.2`	string
version required	IP 주소 버전 Example : `4`	integer

4.2.97 - ServerShowResponseSecurityGroup

Name	Description	Schema	Default
name required	Security Group 이름 Example : `securitygroup`	string

4.2.98 - ServerShowResponseServerType

Name	Description	Schema
disk required	루트 디스크 크기 Example : `100`	integer
ephemeral required	임시 디스크 크기 Example : `0`	integer
extra_specs required	추가 스펙 Example :	object
id optional	서버 타입 ID Example : `s1v1m2`	any of [string, null]
name required	서버 타입 이름 Example : `s1v1m2`	string
ram required	RAM 크기 Example : `2`	integer
swap required	전용 스왑 디스크 크기 Example : `0`	integer
vcpus required	CPU 수 Example : `1`	integer

4.2.99 - ServerShowResponseVolume

Name	Description	Schema	Default
delete_on_termination required	서버가 제거될 때 볼륨을 삭제하도록 지정합니다. Example : `False`	boolean
id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string

4.2.100 - ServerStaticNatCreateRequest

Name	Description	Schema	Default
publicip_id required	공개 IP ID Example : `615fa9cd5cff486c9de679b3ce63e601`	string

4.2.101 - ServersVolumeResponse

Name	Description	Schema
delete_on_termination required	서버가 제거될 때 볼륨을 삭제하도록 지정합니다. Example : `False`	boolean
device required	Device 이름 : /dev/vda Example : `/dev/vda`	string
id required	볼륨 연결 ID Example : `3ad1cc18-1b09-4f51-9b1d-4ce4243f6a4c`	string
server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string
volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string

4.2.102 - ServerType

Name	Description	Schema
description required	설명 Example : `description`	any of [string, null]
disk required	루트 디스크 크기 Example : `100`	integer
ephemeral required	임시 디스크 크기 Example : `0`	integer
extra_specs required	추가 스펙 Example :	object
id required	서버 타입 ID Example : `s1v1m2`	string
name required	서버 타입 이름 Example : `s1v1m2`	string
ram required	RAM 크기 Example : `2`	integer
swap required	전용 스왑 디스크 크기 Example : `0`	integer
vcpus required	CPU 수 Example : `1`	integer

4.2.103 - ServerTypeListResponse

Name	Description	Schema	Default
server_types required	서버 타입 목록	array[ServerType]

4.2.104 - ServerUpdateRequest

Name	Description	Schema	Default
name required	서버 이름 Example : `servername` Pattern : `^[a-zA-Z0-9-_ ]$` Minimum length* : `1` Maximum length : `63`	string

4.2.105 - ServerVolumesCreateRequest

Name	Description	Schema
delete_on_termination optional	서버가 제거될 때 볼륨을 삭제하도록 지정합니다. Example : `False`	any of [boolean, null]
device optional	Device 이름 : /dev/vda Example : `/dev/vda`	any of [string, null]
volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string

4.2.106 - ServerVolumesResponse

Name	Description	Schema	Default
volumes required	볼륨 목록	array[ServersVolumeResponse]

4.2.107 - ServerVolumesUpdateRequest

Name	Description	Schema	Default
delete_on_termination optional	서버가 제거될 때 볼륨을 삭제하도록 지정합니다. Example : `False`	any of [boolean, null]
volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string

4.2.108 - SnapshotCreateRequest

Name	Description	Schema
description optional	설명 Example : `description`	any of [string, null]
force optional	볼륨이 연결된 경우에도 스냅샷을 생성할지 여부 Example : `True`	any of [boolean, null]
metadata optional	하나 이상의 스냅샷 메타데이터의 key-value 쌍 Example :	any of [object, null]
name required	스냅샷명 Example : `snapshot-1` Pattern : `^[a-zA-Z0-9-_ ]+$` Maximum length : `255`	string
volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string

4.2.109 - SnapshotDetailResponse

Name	Description	Schema
created_at required	생성일시 Example : `2025-07-22T09:00:00Z`	string
description optional	설명 Example : `description`	any of [string, null]
id required	스냅샷 ID Example : `cceed636-1f1e-4bb0-b85c-4e5b9e0bf790`	string
metadata optional	하나 이상의 스냅샷 메타데이터의 key-value 쌍 Example : `Metadata`	any of [object, null]
name optional	스냅샷명 Example : `snapshot-1`	any of [string, null]
size required	볼륨 크기 Example : `104`	integer
status optional	볼륨 상태 Example : `available`	any of [string, null]
updated_at optional	수정일시 Example : `2025-07-26T12:00:00Z`	any of [string, null]
user_id optional	사용자 ID Example : `570907805e5447be84b618450ef52o0t`	any of [string, null]
volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string

4.2.110 - SnapshotListResponse

Name	Description	Schema	Default
count optional	총 개수 Example : `100`	any of [integer, null]
snapshots required	스냅샷 목록	array[SnapshotDetailResponse]

4.2.111 - SnapshotUpdateRequest

Name	Description	Schema	Default
description optional	설명 Example : `description`	any of [string, null]
name required	스냅샷명 Example : `snapshot-1` Pattern : `^[a-zA-Z0-9-_ ]+$`	any of [string, null]

4.2.112 - Tag

Name	Description	Schema	Default
key required	Key Example : `Key`	string
value optional	Value Example : `Value`	any of [string, null]

4.2.113 - Volume

Name	Description	Schema
boot_index required	부팅 장치의 순서를 정의합니다. 부팅을 비활성화하려는 장치는 인덱스를 None이나 음수로 설정합니다. Example : `0`	integer
delete_on_termination optional	서버가 제거될 때 볼륨을 삭제하도록 지정합니다. Example : `False`	any of [boolean, null]
size required	볼륨 크기, GiB 단위이며 8의 배수로 입력해야 합니다. Example : `104`	integer
source_type optional	볼륨의 소스 유형. blank는 데이터가 없는 빈 볼륨이며, image는 이미지로 생성하는 볼륨입니다. 소스 유형을 지정하지 않으면 boot_index가 0일 때 ‘image’로 그 외에 경우 ‘blank’로 지정됩니다. Example : `image`	any of [enum (blank, image), null]
type optional	볼륨 타입 Example : `SSD`	any of [string, null]

4.2.114 - VolumeCreateRequest

Name	Description	Schema
name required	볼륨명 Example : `volume01` Pattern : `^[a-zA-Z0-9-_ ]$` Minimum length* : `1` Maximum length : `255`	string
size required	볼륨 크기, GiB 단위이며 8의 배수로 입력해야 합니다. Example : `104` Minimum : `8`	integer
snapshot_id optional	볼륨을 생성하기 위해 사용하는 스냅샷 ID입니다. 이 값이 지정되면 요청된 볼륨 크기는 해당 스냅샷의 크기보다 크거나 같아야 합니다. Example : `cceed636-1f1e-4bb0-b85c-4e5b9e0bf790`	any of [string, null]
tags optional	Tags Example : `[{'key': 'key', 'value': 'value'}]`	any of [array[Tag], null]
volume_type optional	볼륨 유형을 선택합니다. 볼륨 유형을 지정하지 않으면 기본 유형인 SSD로 볼륨이 생성됩니다 Example : `SSD`	any of [string, null]

4.2.115 - VolumeCreateRequestV1Dot2

Name	Description	Schema
max_iops optional	The number of distinct read or write operations a volume can process in a single second. Example : `10000`	any of [integer, null]
max_throughput optional	The actual amount of data (volume) transferred to or from the storage device per second. Example : `500`	any of [integer, null]
name required	볼륨명 Example : `volume01` Pattern : `^[a-zA-Z0-9-_ ]$` Minimum length* : `1` Maximum length : `255`	string
size required	볼륨 크기, GiB 단위이며 8의 배수로 입력해야 합니다. Example : `104` Minimum : `8`	integer
snapshot_id optional	볼륨을 생성하기 위해 사용하는 스냅샷 ID입니다. 이 값이 지정되면 요청된 볼륨 크기는 해당 스냅샷의 크기보다 크거나 같아야 합니다. Example : `cceed636-1f1e-4bb0-b85c-4e5b9e0bf790`	any of [string, null]
tags optional	Tags Example : `[{'key': 'key', 'value': 'value'}]`	any of [array[Tag], null]
volume_type optional	볼륨 유형을 선택합니다. 볼륨 유형을 지정하지 않으면 기본 유형인 SSD로 볼륨이 생성됩니다 Example : `SSD`	any of [string, null]

4.2.116 - VolumeExtendRequest

Name	Description	Schema	Default
size required	볼륨 크기 Example : `104` Minimum : `8`	integer

4.2.117 - VolumeImageMetadataResponse

Name	Description	Schema
checksum optional	전체 이미지 데이터의 MD5 해시. 이 필드를 사용하여 이미지의 무결성 확인 Example : `7538e0fcb56e0e272cfd89eb384d6613`	any of [string, null]
container_format optional	컨테이너 형식 Example : `bare`	any of [string, null]
disk_format optional	디스크 형식 Example : `qcow2`	any of [string, null]
image_id optional	이미지 ID Example : `70a599e0-31e7-49b7-b260-868f441e862b`	any of [string, null]
image_name optional	이미지 이름 Example : `imagename`	any of [string, null]
min_disk optional	생성할 이미지의 최소 디스크 용량(GB) Example : `100`	any of [integer, null]
min_ram optional	생성할 이미지의 최소 RAM 용량(GB) Example : `0`	any of [integer, null]
os_distro optional	업로드할 이미지의 OS 배포판 Example : `alma`	any of [string, null]
scp_image_type optional	이미지 타입 Example : `custom`	any of [string, null]
scp_k8s_version optional	K8S 버전 Example : `v1.28.7`	any of [string, null]
scp_original_image_type optional	원본 이미지 타입 Example : `standard`	any of [string, null]
signature_verified optional	서명 인증 완료 Example : `False`	any of [boolean, null]
size optional	이미지 크기 Example : `2429747200`	any of [integer, null]

4.2.118 - VolumeListResponse

Name	Description	Schema	Default
count optional	총 개수 Example : `100`	any of [integer, null]
volumes required	볼륨 목록	array[VolumeShowResponse]

4.2.119 - VolumeListResponseV1Dot2

Name	Description	Schema	Default
count optional	총 개수 Example : `100`	any of [integer, null]
volumes required	볼륨 목록	array[VolumeShowResponseV1Dot2]

4.2.120 - VolumeQuotaSet

Name	Description	Schema
id required	쿼터 셋 ID Example : `fc7283354c6143a58629b59f4c3e16b2`	string
per_volume_size required	볼륨 별 크기 Quota	VolumeQuotaSetObject
snapshots required	스냅샷 Quota	VolumeQuotaSetObject
usages required	사용량 Quota	VolumeQuotaSetObject
volumes required	볼륨 Quota	VolumeQuotaSetObject

4.2.121 - VolumeQuotaSetObject

Name	Description	Schema
in_use required	사용 중인 수 Example : `10`	integer
limit required	최대 한도 수 Example :	integer
reserved required	예약 중인 수 Example : `0`	integer

4.2.122 - VolumeRevertRequest

Name	Description	Schema	Default
snapshot_id required	스냅샷 ID Example : `cceed636-1f1e-4bb0-b85c-4e5b9e0bf790`	string

4.2.123 - VolumeServer

Name	Description	Schema
attached_at required	볼륨이 서버에 연결된 시간 Example : `2026-04-14T15:06:30.712Z`	string (date-time)
device required	Device 이름 : /dev/vda Example : `/dev/vda`	string
id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string

4.2.124 - VolumeServerAttachRequest

Name	Description	Schema	Default
delete_on_termination optional	서버가 제거될 때 볼륨을 삭제하도록 지정합니다. Example : `False`	any of [boolean, null]
server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string

4.2.125 - VolumeServerAttachResponse

Name	Description	Schema
delete_on_termination required	서버가 제거될 때 볼륨을 삭제하도록 지정합니다. Example : `False`	boolean
device required	Device 이름 : /dev/vda Example : `/dev/vda`	string
server_id required	서버 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string
volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string

4.2.126 - VolumeSetQosRequest

Name	Description	Schema	Default
max_iops optional	The number of distinct read or write operations a volume can process in a single second. Example : `10000`	any of [integer, null]
max_throughput optional	The actual amount of data (volume) transferred to or from the storage device per second. Example : `500`	any of [integer, null]

4.2.127 - VolumeShowResponse

Name	Description	Schema
bootable required	부트 디스크 여부 Example : `False`	boolean
created_at required	생성일시 Example : `2026-04-14T15:06:30.677Z`	string (date-time)
encrypted required	암호화 여부 Example : `True`	boolean
id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string
modified_at optional	수정일시 Example : `2025-07-26T12:00:00Z`	any of [string (date-time), null]
multiattach required	두 대 이상의 서버에 연결 수 있으며, 볼륨당 연결된 서버 수에 제한이 없습니다. 또한 서버는 최대 26개의 볼륨에 연결할 수 있습니다. Example : `False`	boolean
name optional	볼륨명 Example : `volume01`	any of [string, null]
servers required	연결 서버	array[VolumeServer]
size required	볼륨 크기 Example : `104`	integer
snapshot_id optional	스냅샷 ID Example : `cceed636-1f1e-4bb0-b85c-4e5b9e0bf790`	any of [string, null]
state required	볼륨 상태 Example : `available`	string
user_id required	사용자 ID Example : `570907805e5447be84b618450ef52o0t`	string
volume_image_metadata optional	볼륨 이미지 메타데이터	any of [VolumeImageMetadataResponse, null]
volume_type required	볼륨 타입 Example : `SSD`	string
volume_type_id required	볼륨 유형 ID Example : `c643ac35-3aec-43e6-b97a-3d6f666c5207`	string

4.2.128 - VolumeShowResponseV1Dot2

Name	Description	Schema
bootable required	부트 디스크 여부 Example : `False`	boolean
created_at required	생성일시 Example : `2026-04-14T15:06:31.797Z`	string (date-time)
encrypted required	암호화 여부 Example : `True`	boolean
id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string
max_iops optional	The number of distinct read or write operations a volume can process in a single second. Example : `10000`	any of [integer, null]
max_throughput optional	The actual amount of data (volume) transferred to or from the storage device per second. Example : `500`	any of [integer, null]
modified_at optional	수정일시 Example : `2025-07-26T12:00:00Z`	any of [string (date-time), null]
multiattach required	두 대 이상의 서버에 연결 수 있으며, 볼륨당 연결된 서버 수에 제한이 없습니다. 또한 서버는 최대 26개의 볼륨에 연결할 수 있습니다. Example : `False`	boolean
name optional	볼륨명 Example : `volume01`	any of [string, null]
servers required	연결 서버	array[VolumeServer]
size required	볼륨 크기 Example : `104`	integer
snapshot_id optional	스냅샷 ID Example : `cceed636-1f1e-4bb0-b85c-4e5b9e0bf790`	any of [string, null]
state required	볼륨 상태 Example : `available`	string
user_id required	사용자 ID Example : `570907805e5447be84b618450ef52o0t`	string
volume_image_metadata optional	볼륨 이미지 메타데이터	any of [VolumeImageMetadataResponse, null]
volume_type required	볼륨 타입 Example : `SSD`	string
volume_type_id required	볼륨 유형 ID Example : `c643ac35-3aec-43e6-b97a-3d6f666c5207`	string

4.2.129 - VolumeTransferAcceptRequest

Name	Description	Schema	Default
auth_key required	승인 key Example : `f5972fdb456897eb`	string

4.2.130 - VolumeTransferAcceptResponse

Name	Description	Schema
id required	볼륨 이전 ID Example : `1ac231be-823b-4a4d-8ff0-aac503a7118a`	string
name optional	볼륨명 Example : `volume01`	any of [string, null]
volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string

4.2.131 - VolumeTransferCreateResponse

Name	Description	Schema
auth_key required	승인 key Example : `f5972fdb456897eb`	string
created_at required	생성일시 Example :	string
id required	볼륨 이전 ID Example : `1ac231be-823b-4a4d-8ff0-aac503a7118a`	string
name optional	볼륨명 Example : `volume01`	any of [string, null]
volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string

4.2.132 - VolumeTransferListResponse

Name	Description	Schema	Default
transfers required	볼륨 이전 목록	array[VolumeTransferAcceptResponse]

4.2.133 - VolumeTransferRequest

Name	Description	Schema	Default
name optional	볼륨명 Example : `volume01`	any of [string, null]
volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string

4.2.134 - VolumeTransferShowResponse

Name	Description	Schema
created_at required	생성일시 Example : `2025-07-22T09:00:00Z`	string
id required	볼륨 이전 ID Example : `1ac231be-823b-4a4d-8ff0-aac503a7118a`	string
name optional	볼륨명 Example : `volume01`	any of [string, null]
volume_id required	볼륨 ID Example : `3f500f00-ed80-4566-a057-e31760226f9a`	string

4.2.135 - VolumeTypeDetailResponse

Name	Description	Schema
description optional	볼륨 타입 설명 Example : `Volume type description`	any of [string, null]
extra_specs optional	추가 스펙	any of [VolumeTypeExtraSpecs, null]
id required	볼륨 유형 ID Example : `c643ac35-3aec-43e6-b97a-3d6f666c5207`	string
name optional	볼륨 유형명 Example : `SSD`	any of [string, null]

4.2.136 - VolumeTypeExtraSpecs

Name	Description	Schema	Default
multiattach optional	다중 연결 Example : `<is> True`	any of [string, null]

4.2.137 - VolumeTypeListResponse

Name	Description	Schema	Default
volume_types required	볼륨 타입 목록	array[VolumeTypeDetailResponse]

4.2.138 - VolumeUpdateRequest

Name	Description	Schema	Default
name optional	볼륨명 Example : `volume01` Pattern : `^[a-zA-Z0-9-_ ]*$`	any of [string, null]

4.2.139 - VolumeV1Dot2

Name	Description	Schema
boot_index required	부팅 장치의 순서를 정의합니다. 부팅을 비활성화하려는 장치는 인덱스를 None이나 음수로 설정합니다. Example : `0`	integer
delete_on_termination optional	서버가 제거될 때 볼륨을 삭제하도록 지정합니다. Example : `False`	any of [boolean, null]
max_iops optional	The number of distinct read or write operations a volume can process in a single second. Example : `10000`	any of [integer, null]
max_throughput optional	The actual amount of data (volume) transferred to or from the storage device per second. Example : `500`	any of [integer, null]
size required	볼륨 크기, GiB 단위이며 8의 배수로 입력해야 합니다. Example : `104`	integer
source_type optional	볼륨의 소스 유형. blank는 데이터가 없는 빈 볼륨이며, image는 이미지로 생성하는 볼륨입니다. 소스 유형을 지정하지 않으면 boot_index가 0일 때 ‘image’로 그 외에 경우 ‘blank’로 지정됩니다. Example : `image`	any of [enum (blank, image), null]
type optional	볼륨 타입 Example : `SSD`	any of [string, null]