调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求头
该接口使用公共请求头,无特殊请求头。请参见公共请求参数文档。
请求语法
GET /clusters/{ClusterId} HTTP/1.1
请求参数
名称 |
类型 |
位置 |
是否必选 |
示例值 |
描述 |
ClusterId | String | Path | 是 | cdde1f21ae22e483ebcb068a6eb7f**** |
集群ID。 |
返回数据
名称 |
类型 |
示例值 |
描述 |
cluster_id | String | c82e6987e2961451182edacd74faf**** |
集群ID。 |
cluster_type | String | Kubernetes |
集群类型,取值:
|
created | String | 2019-11-25T15:50:20+08:00 |
集群创建时间。 |
init_version | String | 1.16.6-aliyun.1 |
集群初始化版本。 |
current_version | String | 1.16.6-aliyun.1 |
集群当前版本。ACK支持的Kubernetes版本,请参见Kubernetes版本发布概览。 |
deletion_protection | Boolean | true |
集群删除保护,防止通过控制台或API误删除集群。取值:
|
docker_version | String | 19.03.5 |
集群中的Docker版本。 |
meta_data | String | \”Addons\”:*** |
集群元数据信息。 |
name | String | cluster-demo |
集群名称。 命名规则:由数字、汉字、英文字符或短划线(-)组成,长度范围1~63个字符,且不能以短划线(-)开头。 |
region_id | String | cn-beijing |
集群所在地域ID。 |
resource_group_id | String | rg-acfmyvw3wjm**** |
集群资源组ID。 |
security_group_id | String | sg-25yq**** |
集群安全组ID。 |
size | Long | 5 |
集群节点数,包含Master节点及Worker节点。 |
state | String | running |
集群运行状态,取值:
|
tags | Array of tag |
集群资源标签。 |
|
updated | String | 2020-01-13T23:01:03+08:00 |
集群更新时间。 |
vpc_id | String | vpc-2zecuu62b9zw7a7qn**** |
集群专有网络ID,创建集群时的必填参数。 |
vswitch_id | String | vsw-2zete8s4qocqg0mf6****,vsw-2zete8s4qocqg0mf6**** |
虚拟交换机ID,创建集群时可选择1~3个虚拟交换机。为保证集群高可用,建议选择不同可用区的虚拟交换机。 |
subnet_cidr | String | 172.20.0.0/16 |
Pod网络地址段,必须是有效的私有网段,即以下网段及其子网:
不能与VPC及VPC内已有Kubernetes集群使用的网段重复,创建成功后不能被修改。 关于集群网络规划,请参见VPC下Kubernetes的网络地址段规划。 |
master_url | String | {\”intranet_api_server_endpoint\”:\”https://192.168.0.251:6443\”***} |
集群访问地址,包含内网访问地址及公网访问地址。 |
profile | String | Default |
面向场景时的集群类型:
|
cluster_spec | String | ack.pro.small |
托管版集群类型,面向托管集群:
|
worker_ram_role_name | String | KubernetesWorkerRole-ec87d15b-edca-4302-933f-c8a16bf0**** |
Worker RAM角色名称,授权ECS实例为集群Woker节点。 |
maintenance_window | maintenance_window |
集群维护窗口配置,只在专业托管版本(即:ACK Pro版集群)中生效。 |
|
parameters | Map |
集群ROS参数集合。 |
|
String | WorkerImageId |
ROS参数 |
示例
请求示例
GET /clusters/cdde1f21ae22e483ebcb068a6eb7f**** HTTP/1.1
Content-Type:application/json
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
c82e6987e2961451182edacd74faf****
Kubernetes
2019-11-25T15:50:20+08:00
1.16.6-aliyun.1
1.16.6-aliyun.1
1.18.8-aliyun.1
true
19.03.5
lb-2ze3buguz3gx9920z****
\"Addons\":***
cluster-demo
vpc
cn-beijing
rg-acfmyvw3wjm****
sg-25yq****
5
running
env
prod
2020-01-13T23:01:03+08:00
vpc-2zecuu62b9zw7a7qn****
vsw-2zete8s4qocqg0mf6****,vsw-2zete8s4qocqg0mf6****
172.20.0.0/16
cn-beijing-a
{\"intranet_api_server_endpoint\":\"https://192.168.0.251:6443\"***}
false
Default
ack.pro.small
KubernetesWorkerRole-ec87d15b-edca-4302-933f-c8a16bf0****
false
03:00:00Z
3h
Monday,Thursday
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"cluster_id" : "c82e6987e2961451182edacd74faf****",
"cluster_type" : "Kubernetes",
"created" : "2019-11-25T15:50:20+08:00",
"init_version" : "1.16.6-aliyun.1",
"current_version" : "1.16.6-aliyun.1",
"next_version" : "1.18.8-aliyun.1",
"deletion_protection" : true,
"docker_version" : "19.03.5",
"external_loadbalancer_id" : "lb-2ze3buguz3gx9920z****",
"meta_data" : "\\"Addons\\":***",
"name" : "cluster-demo",
"network_mode" : "vpc",
"region_id" : "cn-beijing",
"resource_group_id" : "rg-acfmyvw3wjm****",
"security_group_id" : "sg-25yq****",
"size" : 5,
"state" : "running",
"tags" : [ {
"key" : "env",
"value" : "prod"
} ],
"updated" : "2020-01-13T23:01:03+08:00",
"vpc_id" : "vpc-2zecuu62b9zw7a7qn****",
"vswitch_id" : "vsw-2zete8s4qocqg0mf6****,vsw-2zete8s4qocqg0mf6****",
"subnet_cidr" : "172.20.0.0/16",
"zone_id" : "cn-beijing-a",
"master_url" : "{\\"intranet_api_server_endpoint\\":\\"https://192.168.0.251:6443\\"***}",
"private_zone" : false,
"profile" : "Default",
"cluster_spec" : "ack.pro.small",
"worker_ram_role_name" : "KubernetesWorkerRole-ec87d15b-edca-4302-933f-c8a16bf0****",
"maintenance_window" : {
"enable" : false,
"maintenance_time" : "03:00:00Z",
"duration" : "3h",
"weekly_period" : "Monday,Thursday"
}
}
错误码
访问错误中心查看更多错误码。
内容没看懂? 不太想学习?想快速解决? 有偿解决: 联系专家
阿里云企业补贴进行中: 马上申请
腾讯云限时活动1折起,即将结束: 马上收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折,更有现金返利:同意关联,立享优惠
转转请注明出处:https://www.yunxiaoer.com/171337.html