identity
Get an identity by GVC and name
Overview
agent
auditctx
cloudaccount
- 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
domain
group
gvc
identity
- 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
image
location
org
policy
quota
secret
- GETGet a secret by name
- DELDelete a secret by name
- PATCHPerform a Patch on an IP Set 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
serviceaccount
- 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
task
user
volumeset
- 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
workload
- 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
identity
Get an identity by GVC and name
Response will contain the requested identity if the caller is authorized to view it
GET
/
org
/
{org}
/
gvc
/
{gvc}
/
identity
/
{name}
curl --request GET \
--url https://api.cpln.io/org/{org}/gvc/{gvc}/identity/{name}
{
"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>"
}
],
"aws": {
"cloudAccountLink": "<string>",
"policyRefs": [
"<string>"
],
"trustPolicy": {
"Version": "2012-10-17",
"Statement": [
{}
]
},
"roleName": "<string>"
},
"gcp": {
"cloudAccountLink": "<string>",
"scopes": [
"<string>"
],
"serviceAccount": "<string>",
"bindings": [
{
"resource": "<string>",
"roles": [
"<string>"
]
}
]
},
"azure": {
"cloudAccountLink": "<string>",
"roleAssignments": [
{
"scope": "<string>",
"roles": [
"<string>"
]
}
]
},
"ngs": {
"cloudAccountLink": "<string>",
"pub": {
"allow": [
"<string>"
],
"deny": [
"<string>"
]
},
"sub": {
"allow": [
"<string>"
],
"deny": [
"<string>"
]
},
"resp": {
"max": 123,
"ttl": "<string>"
},
"subs": 123,
"data": 123,
"payload": 123
},
"networkResources": [
{
"name": "<string>",
"agentLink": "<string>",
"IPs": [
"<string>"
],
"FQDN": "<string>",
"resolverIP": "<string>",
"ports": [
123
]
}
],
"nativeNetworkResources": [
{
"name": "<string>",
"FQDN": "<string>",
"ports": [
123
],
"awsPrivateLink": {
"endpointServiceName": "<string>"
},
"gcpServiceConnect": {
"targetService": "<string>"
}
}
],
"memcacheAccess": [
{
"clusterLink": "<string>",
"role": "readWrite"
}
],
"spicedbAccess": [
{
"clusterLink": "<string>",
"role": "checkPermission"
}
],
"status": {
"objectName": "<string>",
"aws": {
"lastError": "<string>",
"usable": true
},
"gcp": {
"lastError": "<string>",
"usable": true
},
"azure": {
"lastError": "<string>",
"usable": true
}
},
"gvc": "<string>"
}
Authorizations
Service account key can be used as API keys
Response
200
application/json
Success
Maximum length:
64
Maximum length:
250
Max number of subscriptions per connection
Max number of bytes a connection can send
Max message payload
Maximum length:
64
curl --request GET \
--url https://api.cpln.io/org/{org}/gvc/{gvc}/identity/{name}
{
"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>"
}
],
"aws": {
"cloudAccountLink": "<string>",
"policyRefs": [
"<string>"
],
"trustPolicy": {
"Version": "2012-10-17",
"Statement": [
{}
]
},
"roleName": "<string>"
},
"gcp": {
"cloudAccountLink": "<string>",
"scopes": [
"<string>"
],
"serviceAccount": "<string>",
"bindings": [
{
"resource": "<string>",
"roles": [
"<string>"
]
}
]
},
"azure": {
"cloudAccountLink": "<string>",
"roleAssignments": [
{
"scope": "<string>",
"roles": [
"<string>"
]
}
]
},
"ngs": {
"cloudAccountLink": "<string>",
"pub": {
"allow": [
"<string>"
],
"deny": [
"<string>"
]
},
"sub": {
"allow": [
"<string>"
],
"deny": [
"<string>"
]
},
"resp": {
"max": 123,
"ttl": "<string>"
},
"subs": 123,
"data": 123,
"payload": 123
},
"networkResources": [
{
"name": "<string>",
"agentLink": "<string>",
"IPs": [
"<string>"
],
"FQDN": "<string>",
"resolverIP": "<string>",
"ports": [
123
]
}
],
"nativeNetworkResources": [
{
"name": "<string>",
"FQDN": "<string>",
"ports": [
123
],
"awsPrivateLink": {
"endpointServiceName": "<string>"
},
"gcpServiceConnect": {
"targetService": "<string>"
}
}
],
"memcacheAccess": [
{
"clusterLink": "<string>",
"role": "readWrite"
}
],
"spicedbAccess": [
{
"clusterLink": "<string>",
"role": "checkPermission"
}
],
"status": {
"objectName": "<string>",
"aws": {
"lastError": "<string>",
"usable": true
},
"gcp": {
"lastError": "<string>",
"usable": true
},
"azure": {
"lastError": "<string>",
"usable": true
}
},
"gvc": "<string>"
}