调用CreateK8sIngressRule接口创建应用路由规则。

调试

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

请求头

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

请求语法

POST /pop/v5/k8s/acs/k8s_ingress HTTP/1.1

请求参数

名称 类型 位置 是否必选 示例值 描述
ClusterId String Query 5b2b4ab4-efbc-4a81-9c45-xxxxxxxxxxxxx

集群ID。

Name String Query my-ingress-rule

路由规则名称。只能为小写字母、数字和短划线(-),必须以小写字母开头,不以短划线(-)结尾,长度不超过63个字符。

Namespace String Query default

K8s集群命名空间。

IngressConf Json Query {"rules":[{"host":"abc.com","secretName":"tls-secret","paths":[{"path":"/path","backend":{"servicePort":80,"serviceName":"xxx"}}]}]}

JSON对象字符串表示的应用路由规则,格式如下所示:


{
  "rules": [
    {
      "host": "abc.com",
      "secretName": "tls-secret",
      "paths": [
        {
          "path": "/path",
          "backend": {
            "servicePort": 80,
            "serviceName": "xxx"
          }
        }
      ]
    }
  ]
}

代码字段解释如下:

  • rules:路由规则列表。
  • host:路由规则域名。
  • secretName:TLS证书类型的Secret,当需要支持HTTPS协议时需要配置该证书。
  • paths:匹配路径列表。
  • path:匹配路径。
  • backend:后端服务,支持配置由EDAS控制台创建的Service。
  • serviceName:后端服务名称。
  • servicePort:后端服务端口。

返回数据

名称 类型 示例值 描述
Code Integer 200

接口状态码。

Message String success

返回信息。

示例

请求示例

POST /pop/v5/k8s/acs/k8s_ingress HTTP/1.1
公共请求头
{
"ClusterId": "5b2b4ab4-efbc-4a81-9c45-xxxxxxxxxxxxx",
"Name": "my-ingress-rule",
"Namespace": "default"
}

正常返回示例

XML格式

<Message>success</Message>
<Code>200</Code>

JSON格式

{
    "Message": "success",
    "Code": 200
}

错误码

HttpCode 错误码 错误信息 描述
500 Edas.errorcode.PermissionDenied.message You are not authorized to perform the operation. 无权限操作

访问错误中心查看更多错误码。