curl --request GET \
--url https://api.cpln.io/org/{org}/gvc/{gvc}/volumeset/{name} \
--header 'Authorization: <api-key>'{
"id": "<string>",
"name": "<string>",
"kind": "<string>",
"version": 123,
"description": "<string>",
"tags": {},
"created": "2023-11-07T05:31:56Z",
"lastModified": "2023-11-07T05:31:56Z",
"links": [
{
"rel": "<string>",
"href": "<string>"
}
],
"spec": {
"initialCapacity": 123,
"performanceClass": "general-purpose-ssd",
"storageClassSuffix": "<string>",
"fileSystemType": "ext4",
"customEncryption": {
"regions": {}
},
"snapshots": {
"createFinalSnapshot": true,
"retentionDuration": "<string>",
"schedule": "<string>"
},
"autoscaling": {
"maxCapacity": 123,
"minFreePercentage": 123,
"scalingFactor": 123
},
"mountOptions": {
"resources": {
"maxCpu": "2000m",
"minCpu": "500m",
"minMemory": "1Gi",
"maxMemory": "2Gi"
}
}
},
"status": {
"parentId": "<string>",
"usedByWorkload": "<string>",
"workloadLinks": [
"<string>"
],
"bindingId": "<string>",
"locations": [
{
"name": "<string>",
"volumes": [
{
"lifecycle": "creating",
"storageDeviceId": "<string>",
"oldStorageDeviceIds": [
"<string>"
],
"resourceName": "<string>",
"index": 123,
"currentSize": 123,
"currentBytesUsed": 123,
"iops": 123,
"throughput": 123,
"driver": "<string>",
"volumeSnapshots": [
{
"name": "<string>",
"id": "<string>",
"created": "2023-11-07T05:31:56Z",
"expires": "2023-11-07T05:31:56Z",
"size": 123,
"tags": [
{}
]
}
],
"attributes": {},
"zone": "<string>"
}
],
"desiredVolumeCount": 123,
"clusterId": "<string>"
}
]
},
"gvc": {}
}Response will contain the requested volumeset if the caller is authorized to view it
curl --request GET \
--url https://api.cpln.io/org/{org}/gvc/{gvc}/volumeset/{name} \
--header 'Authorization: <api-key>'{
"id": "<string>",
"name": "<string>",
"kind": "<string>",
"version": 123,
"description": "<string>",
"tags": {},
"created": "2023-11-07T05:31:56Z",
"lastModified": "2023-11-07T05:31:56Z",
"links": [
{
"rel": "<string>",
"href": "<string>"
}
],
"spec": {
"initialCapacity": 123,
"performanceClass": "general-purpose-ssd",
"storageClassSuffix": "<string>",
"fileSystemType": "ext4",
"customEncryption": {
"regions": {}
},
"snapshots": {
"createFinalSnapshot": true,
"retentionDuration": "<string>",
"schedule": "<string>"
},
"autoscaling": {
"maxCapacity": 123,
"minFreePercentage": 123,
"scalingFactor": 123
},
"mountOptions": {
"resources": {
"maxCpu": "2000m",
"minCpu": "500m",
"minMemory": "1Gi",
"maxMemory": "2Gi"
}
}
},
"status": {
"parentId": "<string>",
"usedByWorkload": "<string>",
"workloadLinks": [
"<string>"
],
"bindingId": "<string>",
"locations": [
{
"name": "<string>",
"volumes": [
{
"lifecycle": "creating",
"storageDeviceId": "<string>",
"oldStorageDeviceIds": [
"<string>"
],
"resourceName": "<string>",
"index": 123,
"currentSize": 123,
"currentBytesUsed": 123,
"iops": 123,
"throughput": 123,
"driver": "<string>",
"volumeSnapshots": [
{
"name": "<string>",
"id": "<string>",
"created": "2023-11-07T05:31:56Z",
"expires": "2023-11-07T05:31:56Z",
"size": 123,
"tags": [
{}
]
}
],
"attributes": {},
"zone": "<string>"
}
],
"desiredVolumeCount": 123,
"clusterId": "<string>"
}
]
},
"gvc": {}
}Service account key can be used as API keys
Success
64250Show child attributes
The initial size in GB of volumes in this set.
general-purpose-ssd, high-throughput-ssd, shared For self-hosted locations only. The storage class used for volumes in this set will be {performanceClass}-{fileSystemType}-{storageClassSuffix} if it exists, otherwise it will be {performanceClass}-{fileSystemType}
ext4, xfs, shared Show child attributes
If true, a volume snapshot will be created immediately before deletion of any volume in this set
The default retention period for volume snapshots. This string should contain a floating point number followed by either d, h, or m. For example, "10d" would retain snapshots for 10 days.
A standard cron schedule expression used to determine when your job should execute.
Show child attributes
The maximum size in GB for a volume in this set. A volume cannot grow to be bigger than this.
The guaranteed free space on the volume as a percentage of the volume's total size. ControlPlane will try to maintain at least that many percent free by scaling up the total size
When scaling is necessary, then new_capacity = current_capacity * storageScalingFactor.
A list of mount options to use when mounting volumes in this set.
Show child attributes
For volume sets using the shared file system, this object specifies the CPU and memory resources allotted to each mount point
Show child attributes
20202020Show child attributes
Show child attributes
The name of the location in which this volume was provisioned
Show child attributes
creating, unused, unbound, bound, deleted, repairing The id of the volume as provided by the underlying storage implementation. If this is blank, an actual storage device has not yet been created.
The most recently used storageDeviceId. This is meant for use by Control Plane only
This number is used to order volumes within the volume set. It is used by Control Plane to link volumes with the workload replicas that use them.
The current capacity of the volume in GB
The total bytes used in the volume.
The name of the CSI driver used to provision and manage this volume
Show child attributes
A human-readable name for this snapshot.
The id of the snapshot as provided by the underlying storage implementation.
The date and time that the snapshot was created in the Control Plane API
The date and time on which this snapshot will be automatically deleted.
The size of the snapshot in GB.
The id of the cluster assigned to the gvc in this location.