创建一条路由规则

调试

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

请求头

请求语法

POST /pop/v1/sam/ingress/Ingress HTTPS|HTTP

请求参数

名称 类型 是否必选 示例值 描述
ListenerPort Integer 是 80

slb监听端口，该端口不能被占用
NamespaceId String 是 cn-beijing:sae-test

应用所在命名空间id，目前不支持跨namespace应用
Rules String 是 [{"appId":"395b60e4-0550-458d-9c54-a265d036d8c8","containerPort":8080,"domain":"www.edas.site","path":"/path1"},{"appId":"666403ce-d25b-47cf-87fe-497565d20935","containerPort":8080,"domain":"edas.site","path":"/path2"}]

转发规则。按照域名跟路径转发流量到指定应用
SlbId String 是 lb-xxxxxx

ingress所使用的slb
Description String 否 ingress-for-sae-test

用于显示的名称
CertId String 否 1362xxxxxx373809_xxxxxxx_841665875_-419427029

https监听所使用的证书id，证书录入slb控制台即可
DefaultRule String 否 {"appId":"395b60e4-0550-458d-9c54-a265d036d8c8","containerPort":8080}

默认配置。按照ip访问的流量将被转发到这里

返回数据

名称 类型 示例值 描述
RequestId String 00000000-0000-0000-0000-000000000000

请求ID
Code String 200

接口状态或 POP 错误码
Message String success

附加信息
Success Boolean true

是否成功
ErrorCode String success

错误码
TraceId String 000000000000000000000000000000

调用链ID
Data Struct

返回值
IngressId Long 78

创建的ingress对象id

示例

请求示例

POST /pop/v1/sam/ingress/Ingress HTTP/1.1
公共请求头
{
  "ListenerPort": 80
  "NamespaceId": "cn-beijing:sae-test"
  "Rules": "[{"appId":"395b60e4-0550-458d-9c54-a265d036d8c8","containerPort":8080,"domain":"www.edas.site","path":"/path1"},{"appId":"666403ce-d25b-47cf-87fe-497565d20935","containerPort":8080,"domain":"edas.site","path":"/path2"}]"
  "SlbId": "lb-xxxxxx"
}

正常返回示例

XML 格式 

<Data>
    <IngressId>17</IngressId>
</Data>
<Message>success</Message>
<RequestId>00000000-0000-0000-0000-000000000000</RequestId>
<TraceId>000000000000000000000000000000</TraceId>
<Success>true</Success>
<ErrorCode>success</ErrorCode>
<Code>200</Code>

JSON 格式 

{
    "Data": {
        "IngressId": 17
    },
    "Message": "success",
    "RequestId": "00000000-0000-0000-0000-000000000000",
    "TraceId": "000000000000000000000000000000",
    "Success": true,
    "ErrorCode": "success",
    "Code": 200
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidParameter.NotEmpty You must specify the parameter %s. 不合法的参数：%s 不能为空
400 InvalidParameter.Obviously The specified parameter is invalid {%s}. 不合法的参数{%s}
400 InvalidParameter.WithMessage The parameter is invalid {%s}: %s 不合法的参数{%s}：%s

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