- Blog
- FAQ
- Product Demos
- API Guide
- GETGet an agent by name
- DELDelete an agent by name
- PATCHPerform a Patch on an agent by name
- GETQuery agent health
- GETGet all agents
- POSTCreate an agent
- POSTGet all agents based on a query
- GETGet the access report for an agent by name
- GETGet available permissions for an agent
- GETGet an audit context by name
- PATCHPerform a Patch on an audit context by name
- GETGet all audit contexts
- POSTCreate an audit context
- POSTGet all audit contexts based on a query
- GETGet the access report for an audit context by name
- GETGet available permissions for an audit context
- GETGet a cloud account by name
- DELDelete an cloud account by name
- PATCHPerform a Patch on a cloud account by name
- GETGet all cloud accounts
- POSTCreate a cloud account
- POSTGet all cloud accounts based on a query
- GETGet the access report for a cloud account by name
- GETGet available permissions for a cloud account resource type
- GETGet a domain by name
- DELDelete a domain by name
- PATCHPerform a Patch on a domain by name
- GETGet all domains
- POSTCreate a domain
- POSTGet all domains based on a query
- GETGet the access report for a domain by name
- GETGet available permissions for a domain resource type
- GETGet a group by name
- DELDelete a group by name
- PATCHPerform a Patch on a group by name
- GETGet all groups
- POSTCreate a group
- POSTGet all groups based on a query
- GETGet the access report for a group by name
- GETGet available permissions for a group resource type
- GETGet a GVC by name
- DELDelete a GVC by name
- PATCHPerform a Patch on a GVC by name
- GETGet all GVCs
- POSTCreate a GVC
- POSTGet all GVCs based on a query
- GETGet the access report for a GVC by name
- GETGet available permissions for a GVC resource type
- GETGet an identity by GVC and name
- DELDelete an identity by GVC and name
- PATCHPerform a Patch on an identity by name
- GETGet all identities in a GVC
- POSTCreate an identity
- GETGet all identities from all GVCs
- POSTGet all GVC identities based on a query
- GETGet the access report for an identity by GVC and name
- GETGet available permissions for an identity
- GETGet a image by name
- DELDelete an image by name
- PATCHPerform a Patch on an image by name
- GETGet all images
- POSTGet all images based on a query
- GETGet the access report for an image by name
- GETGet available permissions for an image resource type
- GETGet a location by name
- PATCHPerform a Patch on a location by name
- GETGet all locations
- POSTGet all locations based on a query
- GETGet the access report for a location by name
- GETGet available permissions for a location resource type
- GETGet an org by name
- PATCHPerform a Patch on an org by name
- GETGet all orgs
- POSTCreate an org
- POSTGet all orgs based on a query
- GETGet the access report for an org by name
- GETGet available permissions for an org resource type
- GETGet a policy by name
- DELDelete a policy by name
- PATCHPerform a Patch on a policy by name
- GETGet all policies
- POSTCreate a policy
- POSTGet all policies based on a query
- GETGet the access report for a policy by name
- GETGet available permissions for a policy resource type
- GETGet a quota by ID
- GETGet all quotas
- POSTGet all quotas based on a query
- GETGet available permissions for a quota resource type
- GETGet a secret by name
- DELDelete a secret by name
- PATCHPerform a Patch on a secret by name
- GETGet all secrets
- POSTCreate a secret
- GETGet the sensitive content of a secret by name
- POSTGet all secrets based on a query
- GETGet the access report for a secret by name
- GETGet available permissions for a secret resource type
- GETGet a service account by name
- DELDelete a service account by name
- PATCHPerform a Patch on a service account by name
- GETGet all service accounts
- POSTCreate a service account
- POSTGet all service accounts based on a query
- GETGet the access report for a service account by name
- POSTAdd a key to a service account
- GETGet available permissions for a service account resource type
- GETList tasks that you can accept to refuse
- GETList tasks that you can accept to refuse in a specific org
- GETGet a task by ID
- POSTPost
- DELDelete/Cancel a task by ID
- GETGet all tasks
- POSTGet all tasks based on a query
- GETGet available permissions for a task resource type
- GETGet a user by name
- DELDelete a user by name
- PATCHPerform a Patch on a user by name
- GETGet all users
- POSTGet all users based on a query
- POSTInvite users to this org
- GETGet the access report for a user by name
- GETGet available permissions for a user resource type
- GETGet a volumeset by GVC and name
- DELDelete a volumeset by name
- PATCHPerform a Patch on a volumeset by name
- GETList volumesets in a GVC you are authorized to view
- POSTCreate a volumeset
- GETGet all volumesets
- POSTGet all volumesets based on a query
- GETGet the access report for a volumeset by GVC and name
- GETGet available permissions for a volumeset resource type
- GETGet a workload by GVC and name
- DELDelete a workload by name
- PATCHPerform a Patch on a workload by name
- GETGet a deployment by GVC, workload and name
- GETList workloads in a GVC you are authorized to view
- POSTCreate a workload
- GETGet all workloads
- GETList deployments in a workload
- POSTGet all workloads based on a query
- GETGet the access report for a workload by GVC and name
- GETGet available permissions for a workload resource type
Overview
agent
auditctx
cloudaccount
domain
group
gvc
identity
image
location
org
policy
quota
secret
serviceaccount
task
user
volumeset
workload
Perform a Patch on a volumeset by name
Service account key can be used as API keys
The initial size in GB of volumes in this set.
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}
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.
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.
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.
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.
The initial size in GB of volumes in this set.
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}
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.
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.
Authorizations
Service account key can be used as API keys
Path Parameters
Body
description
, tags
, spec
, gvc
initialCapacity
, performanceClass
, storageClassSuffix
, fileSystemType
, snapshots
, autoscaling
The initial size in GB of volumes in this set.
general-purpose-ssd
, high-throughput-ssd
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}
xfs
, ext4
createFinalSnapshot
, retentionDuration
, schedule
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.
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.
maxCapacity
, minFreePercentage
, scalingFactor
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.
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.
The initial size in GB of volumes in this set.
general-purpose-ssd
, high-throughput-ssd
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}
xfs
, ext4
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.
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.
Response
The initial size in GB of volumes in this set.
general-purpose-ssd
, high-throughput-ssd
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}
xfs
, ext4
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.
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.
The name of the location in which this volume was provisioned
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.
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
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.