创建一条路由规则
调试
您可以在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 |
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交