Dong, Qiu Jian 3336ba8df7 CCE API for v1.23

Reviewed-by: gtema <artem.goncharov@gmail.com>
Co-authored-by: Dong, Qiu Jian <qiujiandong1@huawei.com>
Co-committed-by: Dong, Qiu Jian <qiujiandong1@huawei.com>

2022-11-10 12:48:59 +00:00

20 KiB

Raw Blame History

Modifying the Access Information of a Specified Cluster

Function

This API is used to modify the access information of a specified cluster.

URI

PUT /api/v3/projects/{project_id}/clusters/{cluster_id}/mastereip

Table 1 describes the parameters of the API.

**Table 1** Parameter description
Parameter	Mandatory	Description
project_id	Yes	Project ID.
cluster_id	Yes	Cluster ID.

Request

Request parameters:

Table 2 describes the request parameters.

**Table 2** Parameter description
Parameter	Mandatory	Type	Description
spec	Yes	Table 3	-

**Table 3** Data structure of the spec field
Parameter	Mandatory	Type	Description
action	Yes	String	Whether to bind an elastic IP address to the cluster or unbind an elastic IP address from the cluster. The value is bind or unbind (case insensitive). NOTE: id needs to be configured only when action is set to bind.
spec	No	Table 4	Information about the elastic IP address.

**Table 4** Data structure of the spec-spec field
Parameter	Mandatory	Type	Description
id	Yes	String	ID of the elastic IP address.

Example request:

Binding an elastic IP address to the cluster

{
    "spec": {
        "action": "bind",
        "spec": {
            "id": "0ef26920-3527-405d-a7b4-27106618c2d7"
        }
    }
}

Unbinding an elastic IP address from the cluster

{
    "spec": {
        "action": "unbind"
    }
}

Response

Response parameters:

Table 5 describes the response parameters.

**Table 5** Response parameters
Parameter	Type	Description
metadata	json	Metadata.
spec	Table 6	-
status	Table 7	Cluster endpoint.

**Table 6** Data structure of the spec field
Parameter	Type	Description
action	String	Whether an EIP is bound to or unbound from the cluster. The value is bind or unbind (case insensitive).
spec	Table 4	Information about the elastic IP address.
elasticIp	String	Elastic IP address.

**Table 7** Data structure of the status field
Parameter	Type	Description
privateEndpoint	String	Address for access within the VPC.
publicEndpoint	String	Address for access outside the VPC.

Example response:

{
    "metadata": {},
    "spec": {
        "action": "bind",
        "spec": {
            "id": "0ef26920-3527-405d-a7b4-27106618c2d7",
            "eip": {
                "bandwidth": {
                    "size": 5,
                    "sharetype": "PER"
                }
            },
            "IsDynamic": false
        },
        "elasticIp": "10.154.50.11"
    },
    "status": {
        "privateEndpoint": "https://172.16.0.86:5443",
        "publicEndpoint": "https://10.154.50.11:5443"
    }
}

Status Code

Table 8 describes the status code of the API.

**Table 8** Status code
Status Code	Description
200	The progress of the specified job is successfully obtained.

For details about error status codes, see Status Code.

Parent topic: Cluster Management

20 KiB Raw Blame History