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.

URI
PUT /api/v3/projects/{project_id}/clusters/{cluster_id}/mastereip
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
project_id |
Yes |
String |
Details: Project ID. For details about how to obtain the value, see How to Obtain Parameters in the API URI. Constraints: None Options: Project IDs of the account Default value: N/A |
cluster_id |
Yes |
String |
Details: Cluster ID. For details about how to obtain the value, see How to Obtain Parameters in the API URI. Constraints: None Options: Cluster IDs Default value: N/A |
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
Content-Type |
Yes |
String |
Details: The request body type or format Constraints: The GET method is not verified. Options:
Default value: N/A |
X-Auth-Token |
Yes |
String |
Details: 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. Constraints: None Options: N/A Default value: N/A |
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.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot