PATCH
/
iam
/
clients
/
{clientId}
/
services
/
{serviceId}
Update service's details (Deprecated).
curl --request PATCH \
  --url https://api.gcore.com/iam/clients/{clientId}/services/{serviceId} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "CDN",
  "status": "paused",
  "previous_status": "active",
  "enabled": true,
  "options": [
    {
      "id": 123,
      "value": "<string>",
      "value_type": "int",
      "name": "<string>",
      "category": "<string>",
      "description": "<string>",
      "title": "<string>"
    }
  ],
  "status_transition_options": [
    {
      "id": 123,
      "value": "<string>",
      "value_type": "int",
      "name": "<string>",
      "category": "<string>",
      "description": "<string>",
      "title": "<string>"
    }
  ]
}'
{
  "id": 123,
  "name": "CDN",
  "client": 123,
  "status": "paused",
  "previous_status": "active",
  "status_changed_at": "2023-11-07T05:31:56Z",
  "start": "2023-11-07T05:31:56Z",
  "deleted_date": "2023-11-07T05:31:56Z",
  "enabled": true,
  "options": [
    {
      "id": 123,
      "value": "<string>",
      "value_type": "int",
      "name": "<string>",
      "category": "<string>",
      "description": "<string>",
      "title": "<string>"
    }
  ],
  "status_transition_options": [
    {
      "id": 123,
      "value": "<string>",
      "value_type": "int",
      "name": "<string>",
      "category": "<string>",
      "description": "<string>",
      "title": "<string>"
    }
  ]
}

Authorizations

Authorization
string
header
required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Path Parameters

clientId
integer
required

Account ID.

serviceId
integer
required

Service's ID.

Body

application/json
name
enum<string>

Service's name.

Available options:
CDN,
STORAGE,
STREAMING,
DNS,
DDOS,
CLOUD
status
enum<string>

Status of the service. Current service status.

Available options:
new,
trial,
trialend,
active,
paused,
activating,
deleted
Example:

"paused"

previous_status
enum<string>

Previous service status. Status of the service.

Available options:
new,
trial,
trialend,
active,
paused,
activating,
deleted
Example:

"active"

enabled
boolean

Shows if a service is enabled or disabled.

options
object[]

List of service options.

status_transition_options
object[]

List of status transition options.

Response

OK.

id
integer

Service's ID.

name
enum<string>

Service's name.

Available options:
CDN,
STORAGE,
STREAMING,
DNS,
DDOS,
CLOUD
client
integer

Client's ID.

status
enum<string>

Status of the service. Current service status.

Available options:
new,
trial,
trialend,
active,
paused,
activating,
deleted
Example:

"paused"

previous_status
enum<string>

Previous service status. Status of the service.

Available options:
new,
trial,
trialend,
active,
paused,
activating,
deleted
Example:

"active"

status_changed_at
string<date-time>

When status was changed.

start
string<date-time>

Trial start date.

deleted_date
string<date-time> | null

Date and time when service's status will be changed to deleted.

Applicable only if current service's status is trialend or paused.

enabled
boolean

Shows if a service is enabled or disabled.

options
object[]

List of service options.

status_transition_options
object[]

List of status transition options.