Updated on 2024-08-09 GMT+08:00

Editing the Name of a Cloud Phone

Function

This API is used to modify the cloud phone name based on the cloud phone ID.

URI

PUT /v1/{project_id}/cloud-phone/phones/{phone_id}

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Specifies the project ID.

phone_id

Yes

String

Specifies the cloud phone ID.

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

Specifies the user token. It can be obtained by calling an Identity and Access Management (IAM) API. The value of X-Subject-Token in the response header is the user token.

Table 3 Request body parameters

Parameter

Mandatory

Type

Description

phone_name

Yes

String

Specifies the cloud phone name. The name can contain a maximum of 60 characters, including letters, digits, hyphens (-), and underscores (_).

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

request_id

String

Specifies the request ID, which is unique.

Example Requests

Editing the name of a cloud phone

PUT https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones/1564567b8bab40f34711234cb80d8574

{
  "phone_name" : "newName"
}

Example Responses

Status code: 200

OK

{
  "request_id" : "135d898e69344a13925a0899e1a4ac53"
}

Status Codes

Status Code

Description

200

OK

Error Codes

See Error Codes.