功能介紹
該API用于通過集群ID綁定、解綁集群公網(wǎng)apiserver地址
集群管理的URL格式為:https://Endpoint/uri。其中uri為資源路徑,也即API訪問的路徑。
調(diào)用方法
請(qǐng)參見如何調(diào)用API。
URI
PUT /api/v3/projects/{project_id}/clusters/{cluster_id}/mastereip
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
項(xiàng)目ID,獲取方式請(qǐng)參見如何獲取接口URI中參數(shù)。 |
|
cluster_id |
是 |
String |
集群ID,獲取方式請(qǐng)參見如何獲取接口URI中參數(shù)。 |
請(qǐng)求參數(shù)
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
Content-Type |
是 |
String |
消息體的類型(格式) |
|
X-Auth-Token |
是 |
String |
調(diào)用接口的認(rèn)證方式分為Token和AK/SK兩種,如果您使用的Token方式,此參數(shù)為必填,請(qǐng)?zhí)顚慣oken的值,獲取方式請(qǐng)參見獲取token。 |
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
spec |
是 |
綁定、解綁集群公網(wǎng)apiserver地址的請(qǐng)求配置參數(shù) |
響應(yīng)參數(shù)
狀態(tài)碼: 200
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
metadata |
基本信息,為集合類的元素類型,包含一組由不同名稱定義的屬性 |
|
|
spec |
綁定集群公網(wǎng)apiserver地址的配置信息 |
|
|
status |
狀態(tài)信息 |
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
uid |
String |
唯一id標(biāo)識(shí) |
|
name |
String |
資源名稱 |
|
labels |
Map<String,String> |
資源標(biāo)簽,key/value對(duì)格式,接口保留字段,填寫不會(huì)生效 |
|
annotations |
Map<String,String> |
資源注解,由key/value組成 |
|
updateTimestamp |
String |
更新時(shí)間 |
|
creationTimestamp |
String |
創(chuàng)建時(shí)間 |
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
action |
String |
綁定動(dòng)作 |
|
spec |
待綁定的彈性IP配置屬性 |
|
|
elasticIp |
String |
請(qǐng)求示例
綁定集群公網(wǎng)apiserver地址。
{
"spec" : {
"action" : "bind",
"spec" : {
"id" : "a757a69e-f920-455a-b1ba-d7a22db0fd50"
}
}
}
響應(yīng)示例
狀態(tài)碼: 200
表示綁定集群公網(wǎng)apiserver地址成功,解綁成功無響應(yīng)體。
{
"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"
}
}
SDK代碼示例
SDK代碼示例如下。
綁定集群公網(wǎng)apiserver地址。
package com.huaweicloud.sdk.test;
import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.cce.v3.region.CceRegion;
import com.huaweicloud.sdk.cce.v3.*;
import com.huaweicloud.sdk.cce.v3.model.*;
public class UpdateClusterEipSolution {
public static void main(String[] args) {
String ak = "<YOUR AK>";
String sk = "<YOUR SK>";
String projectId = "<project_id>";
ICredential auth = new BasicCredentials()
.withProjectId(projectId)
.withAk(ak)
.withSk(sk);
CceClient client = CceClient.newBuilder()
.withCredential(auth)
.withRegion(CceRegion.valueOf("cn-north-4"))
.build();
UpdateClusterEipRequest request = new UpdateClusterEipRequest();
request.withClusterId("<cluster_id>");
MasterEIPRequest body = new MasterEIPRequest();
MasterEIPRequestSpecSpec specSpec = new MasterEIPRequestSpecSpec();
specSpec.withId("a757a69e-f920-455a-b1ba-d7a22db0fd50");
MasterEIPRequestSpec specbody = new MasterEIPRequestSpec();
specbody.withAction(MasterEIPRequestSpec.ActionEnum.fromValue("bind"))
.withSpec(specSpec);
body.withSpec(specbody);
request.withBody(body);
try {
UpdateClusterEipResponse response = client.updateClusterEip(request);
System.out.println(response.toString());
} catch (ConnectionException e) {
e.printStackTrace();
} catch (RequestTimeoutException e) {
e.printStackTrace();
} catch (ServiceResponseException e) {
e.printStackTrace();
System.out.println(e.getHttpStatusCode());
System.out.println(e.getRequestId());
System.out.println(e.getErrorCode());
System.out.println(e.getErrorMsg());
}
}
}
綁定集群公網(wǎng)apiserver地址。
# coding: utf-8
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkcce.v3.region.cce_region import CceRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkcce.v3 import *
if __name__ == "__main__":
ak = "<YOUR AK>"
sk = "<YOUR SK>"
projectId = "<project_id>"
credentials = BasicCredentials(ak, sk, projectId) \
client = CceClient.new_builder() \
.with_credentials(credentials) \
.with_region(CceRegion.value_of("cn-north-4")) \
.build()
try:
request = UpdateClusterEipRequest()
request.cluster_id = "<cluster_id>"
specSpec = MasterEIPRequestSpecSpec(
id="a757a69e-f920-455a-b1ba-d7a22db0fd50"
)
specbody = MasterEIPRequestSpec(
action="bind",
spec=specSpec
)
request.body = MasterEIPRequest(
spec=specbody
)
response = client.update_cluster_eip(request)
print(response)
except exceptions.ClientRequestException as e:
print(e.status_code)
print(e.request_id)
print(e.error_code)
print(e.error_msg)
綁定集群公網(wǎng)apiserver地址。
package main
import (
"fmt"
"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
cce "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cce/v3"
"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cce/v3/model"
region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cce/v3/region"
)
func main() {
ak := "<YOUR AK>"
sk := "<YOUR SK>"
projectId := "<project_id>"
auth := basic.NewCredentialsBuilder().
WithAk(ak).
WithSk(sk).
WithProjectId(projectId).
Build()
client := cce.NewCceClient(
cce.CceClientBuilder().
WithRegion(region.ValueOf("cn-north-4")).
WithCredential(auth).
Build())
request := &model.UpdateClusterEipRequest{}
request.ClusterId = "<cluster_id>"
idSpec:= "a757a69e-f920-455a-b1ba-d7a22db0fd50"
specSpec := &model.MasterEipRequestSpecSpec{
Id: &idSpec,
}
actionSpec:= model.GetMasterEipRequestSpecActionEnum().BIND
specbody := &model.MasterEipRequestSpec{
Action: &actionSpec,
Spec: specSpec,
}
request.Body = &model.MasterEipRequest{
Spec: specbody,
}
response, err := client.UpdateClusterEip(request)
if err == nil {
fmt.Printf("%+v\n", response)
} else {
fmt.Println(err)
}
}
更多編程語言的SDK代碼示例,請(qǐng)參見API Explorer的代碼示例頁簽,可生成自動(dòng)對(duì)應(yīng)的SDK代碼示例。
狀態(tài)碼
|
狀態(tài)碼 |
描述 |
|---|---|
|
200 |
表示綁定集群公網(wǎng)apiserver地址成功,解綁成功無響應(yīng)體。 |
錯(cuò)誤碼
請(qǐng)參見錯(cuò)誤碼。
最新文章
- GaussDB端口_綁定和解綁彈性公網(wǎng)IP_高斯數(shù)據(jù)庫端口-華為云
- 彈性公網(wǎng)IP使用_綁定彈性公網(wǎng)IP-華為云
- 如何通過NAT網(wǎng)關(guān)訪問公網(wǎng)_公網(wǎng)NAT_SNAT規(guī)則_地址轉(zhuǎn)換-華為云
- 彈性公網(wǎng)IP有什么作用_彈性公網(wǎng)IP多少錢_如何切換彈性公網(wǎng)IP
- 申請(qǐng)公網(wǎng)IP_彈性公網(wǎng)_公網(wǎng)IP什么意思
- 免費(fèi)公網(wǎng)IP_彈性公網(wǎng)IP有什么用_公網(wǎng)IP 彈性公網(wǎng)IP
