调用UpdateK8sService更新K8s集群中应用的K8s服务Service。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求头

该接口使用公共请求头,无特殊请求头。请参见公共请求参数文档。

请求语法

PUT /pop/v5/k8s/acs/k8s_service HTTPS|HTTP

请求参数

名称 类型 位置 是否必选 示例值 描述
AppId String Query 5a166fbd-****-****-a286-781659d9f54c

应用ID

Name String Query service-http

K8s Service名称,只支持小写字母、数字和中划线(-),只能以字母开头,字母或数字结尾,长度范围2~32。

ServicePorts Json Query [{"protocol":"TCP","port":80,"targetPort":8080}]

K8s Service端口映射表,需要符合JsonArray格式,支持的参数如下:

  • protocol:必填,服务协议,支持TCP和UDP。
  • port:必填,前端服务端口,取值范围1~65535。
  • targetPort:必填,后端容器端口,取值范围1~65535。
  • nodePort:必填,前端节点端口,取值范围1~65535。

参考示例:

[{"protocol": "TCP", "port": 80, "targetPort": 8080},{"protocol": "TCP", "port": 81, "targetPort": 8081}]
Type String Query ClusterIP

K8s服务类型,支持两种类型的K8s Service:NodePort和ClusterIP。

返回数据

名称 类型 示例值 描述
ChangeOrderId String b4b37bde-a125-****-****-741f7f4a9ae3

变更流程ID

Code Integer 200

接口状态或POP错误码

Message String success

附加信息

RequestId String 4823-bhjf-23u4-eiufh

请求ID

示例

请求示例

PUT /pop/v5/k8s/acs/k8s_service HTTP/1.1
公共请求头
{
"AppId": "5a166fbd-****-****-a286-781659d9f54c",
"Name": "service-http",
"ServicePorts": "[{"protocol":"TCP","port":80,"targetPort":8080}]",
"Type": "ClusterIP"
}

正常返回示例

XML 格式

<RequestId>4823-bhjf-23u4-eiufh</RequestId>
<Message>success</Message>
<ChangeOrderId>b4b37bde-a125-****-****-741f7f4a9ae3</ChangeOrderId>
<Code>200</Code>

JSON 格式

{
    "RequestId": "4823-bhjf-23u4-eiufh",
    "Message": "success",
    "ChangeOrderId": "b4b37bde-a125-****-****-741f7f4a9ae3",
    "Code": 200
}