Update Service Account

Update Service Account

Updates a service account

Request
URI
PUT
https://{api_host}/cloudapi/1.0.0/serviceAccounts/{id}
COPY
Path Parameters
string
id
Required

Service account ID URN


Request Body
ServiceAccount of type(s) application/json
Required
{
    "id": "string",
    "name": "string",
    "softwareId": "string",
    "softwareVersion": "string",
    "roles": [
        {
            "name": "string",
            "id": "string"
        }
    ],
    "uri": "string",
    "org": {
        "name": "string",
        "id": "string"
    },
    "status": "string",
    "requireRotation": false
}
string
id
Optional

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

string
name
Optional

Name of the 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.

array of object
roles
Optional
Constraints: maxItems: 128

Entity references of the Roles assigned to this service account.

string
uri
Optional

URL of a web page providing information about the client.

object
org
Optional

Entity reference used to describe VCD entities

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

boolean
requireRotation
Optional

Whether or not token rotation is required on every use of the refresh token for this service account.

Authentication
This operation uses the following authentication methods.
Responses
200

OK

Returns ServiceAccount of type(s) application/json;version=40.0
"ServiceAccount Object"
string
id
Optional

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

string
name
Optional

Name of the 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.

array of object
roles
Optional
Constraints: maxItems: 128

Entity references of the Roles assigned to this service account.

string
uri
Optional

URL of a web page providing information about the client.

object
org
Optional

Entity reference used to describe VCD entities

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

boolean
requireRotation
Optional

Whether or not token rotation is required on every use of the refresh token for this service account.


Vendor Extension

This operation contains the following vendor extensions defined in the spec:

                    [object Object],[object Object]
                
Code Samples
COPY
                    curl -X PUT -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{}' https://{api_host}/cloudapi/1.0.0/serviceAccounts/{id}