Changed1
[{"label":"Latest (v37.2)","version":"latest"},{"version":"v37.1"},{"version":"v37.0"},{"version":"v36.3"},{"version":"v36.2"},{"version":"v36.1"},{"version":"v36.0"},{"link":"https://developer.vmware.com/apis/1046/vmware-cloud-director","version":"v35.0"}]
vmware-cloud-director

Get Service Account

Description

Retrieves a specific service account

Request

Request

URL

URL


get
https://{api_host}/cloudapi/1.0.0/serviceAccounts/{id}
Copy

Path Parameters

Path Parameters

string
id Required

Service account ID URN


Authentication

Authentication

This operation uses the following authentication methods.

Response

Response

Response Body

Response Body

200 OK

Returns ServiceAccount of type(s) application/json;version=37.0
{
	"id": "string",
	"name": "string",
	"org": {
		"id": "string",
		"name": "string"
	},
	"role": {
		"id": "string",
		"name": "string"
	},
	"softwareId": "string",
	"softwareVersion": "string",
	"status": "string",
	"uri": "string"
}
string
id Optional

ID of this service account. Sorting on this field is not supported.


string
name Optional

Name of the service account.


org Optional

Entity reference used to describe VCD entities


role Optional

Entity reference of the Role assigned to this service account.


string
softwareId Optional

Unique identifier string to identify the client software being registered.


string
softwareVersion Optional

Version identifier string for the client software identified by software_id.


string
status Optional

The status of the refresh token for this service account. CREATED: The client exists with no refresh token and no user codes REQUESTED: The client exists with no refresh token and has user codes GRANTED: The client exists with no refresh token and has a single user code marked as granted ACTIVE: The client exists with refresh token


string
uri Optional

URL of a web page providing information about the client.

No error details were provided in the OpenAPI specification.

Code Samples

Code Samples

cURL Command

curl https://{api_host}/cloudapi/1.0.0/serviceAccounts/{id}


[{"label":"Latest (v37.2)","version":"latest"},{"version":"v37.1"},{"version":"v37.0"},{"version":"v36.3"},{"version":"v36.2"},{"version":"v36.1"},{"version":"v36.0"},{"link":"https://developer.vmware.com/apis/1046/vmware-cloud-director","version":"v35.0"}]
vmware-cloud-director
What's changed in v37.0?
INTRODUCED
Availability
Added in 37.0
Service Account Operations
Feedback

Was this page helpful?