Binding/Unbinding Public API Server Address
Function
This API is used to bind or unbind the public API server address of the cluster by cluster ID.
![](https://support.huaweicloud.com/eu/api-cce/public_sys-resources/note_3.0-en-us.png)
The URL for cluster management is in the format of https://Endpoint/uri. In the URL, uri indicates the resource path, that is, the path for API access.
URI
PUT /api/v3/projects/{project_id}/clusters/{cluster_id}/mastereip
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
project_id |
Yes |
String |
Project ID. For details about how to obtain the value, see How to Obtain Parameters in the API URI. |
cluster_id |
Yes |
String |
Cluster ID. For details about how to obtain the value, see How to Obtain Parameters in the API URI. |
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
Content-Type |
Yes |
String |
Message body type (format). |
X-Auth-Token |
Yes |
String |
Requests for calling an API can be authenticated using either a token or AK/SK. If token-based authentication is used, this parameter is mandatory and must be set to a user token. For details, see Obtaining a User Token. |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
spec |
Yes |
MasterEIPRequestSpec object |
Parameters in the request for binding or unbinding the public APIServer address of a cluster |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
action |
No |
String |
Binding or unbinding. Mandatory.
|
spec |
No |
spec object |
Configuration attributes of the elastic IP address to be bound |
bandwidth |
No |
String |
Bandwidth (This field has expired and is not recommended.) |
elasticIp |
No |
String |
ENI IP (This field has expired and is not recommended.) |
Response Parameters
Status code: 200
Parameter |
Type |
Description |
---|---|---|
metadata |
Metadata object |
Basic information about the object. Metadata is a collection of attributes. |
spec |
MasterEIPResponseSpec object |
Configuration of the bound public APIServer address of a cluster |
status |
status object |
Status information |
Parameter |
Type |
Description |
---|---|---|
uid |
String |
Unique ID. |
name |
String |
Resource name |
labels |
Map<String,String> |
Resource labels in key-value pairs. This is a reserved field and does not take effect. |
annotations |
Map<String,String> |
Resource annotations in the format of key-value pairs. |
updateTimestamp |
String |
Update time. |
creationTimestamp |
String |
Creation time. |
Parameter |
Type |
Description |
---|---|---|
action |
String |
A binding operation |
spec |
spec object |
Configuration attributes of the elastic IP address to be bound |
elasticIp |
String |
EIP |
Parameter |
Type |
Description |
---|---|---|
id |
String |
ENI ID |
eip |
EipSpec object |
EIP details |
IsDynamic |
Boolean |
Dynamic provisioning or not |
Example Requests
Bind the public API server address to a cluster.
{ "spec" : { "action" : "bind", "spec" : { "id" : "a757a69e-f920-455a-b1ba-d7a22db0fd50" } } }
Example Responses
Status code: 200
This indicates that the public API server address of the cluster is successfully bound. No response body is returned if the unbinding is successful.
{ "metadata" : { }, "spec" : { "action" : "bind", "spec" : { "id" : "a757a69e-f920-455a-b1ba-d7a22db0fd50", "eip" : { "bandwidth" : { "size" : 5, "sharetype" : "PER" } }, "IsDynamic" : false }, "elasticIp" : "8.8.8.8" }, "status" : { "privateEndpoint" : "https://192.168.3.238:5443", "publicEndpoint" : "https://8.8.8.8:5443" } }
Status Codes
Status Code |
Description |
---|---|
200 |
This indicates that the public API server address of the cluster is successfully bound. No response body is returned if the unbinding is successful. |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.