调用ListK8sIngressRules接口获取应用路由列表。

调试

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

请求头

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

请求语法

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

请求参数

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

集群ID。

RegionId String Query cn-hangzhou

阿里云地域ID。

Namespace String Query default

K8s集群命名空间。

Condition String Query {"field":"Name", "pattern":"my-"}

过滤条件,JSON类型,格式为{"field":"Name", "pattern":"my-"},其中:

  • field:需要匹配的字段,支持Name和ClusterName。
  • pattern:匹配内容。

以{"field":"Name", "pattern":"my-"}这条过滤条件为例,该条过滤规则会匹配名称为“my-”开头的路由规则。

返回数据

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

接口状态码。

Data Array of Data

接口响应数据。

ClusterId String 5b2b4ab4-efbc-4a81-9c45-a5942881****

集群ID。

ClusterName String my-dev-cluster

集群名称。

IngressConfs Array of IngressConfs

应用路由列表。

CreationTime String 2021-04-27 20:16:52

应用路由创建时间。

DashboardUrl String http://grafana.console.aliyun.com/d/10xxxx/ingress

应用路由监控URL。

Endpoint String 47.11x.xx.xx

应用路由入口IP地址。

Name String my-ingress

应用路由名称。

Namespace String default

应用路由所属K8s命名空间。

Rules Array of Rules

应用路由规则列表。

Host String abc.com

应用路由域名。

Paths Array of Paths

应用路由匹配路径列表。

AppId String 43d30ba5-c568-460c-8080-d447ed1a****

EDAS应用ID。

AppName String my-app

EDAS应用名称。

Backend Struct

后端服务配置。

ServiceName String http-service

后端服务名称。

ServicePort String 8080

后端服务端口。

Path String /foo/bar

匹配路径。

Status String Normal

应用路由状态,支持以下状态:

  • Normal:状态正常。
  • ServiceNotFound:后端Service不存在。
  • InvalidServicePort:无效服务端口。
  • NotManagedService:非EDAS管控Service。
  • Unknown:未知错误。
SecretName String my-secret

保存TLS证书的Secret名称。

SslRedirect Boolean true
RegionId String cn-hangzhou

阿里云地域ID。

Message String success

返回信息。

RequestId String 5C1C9DE7-88FF-4B56-A47B-3DBBCEB23256

请求ID。

示例

请求示例

GET /pop/v5/k8s/acs/k8s_ingress HTTP/1.1
公共请求头
{
"ClusterId": "5b2b4ab4-efbc-4a81-9c45-xxxxxxxxxxxxx",
"RegionId": "cn-hangzhou"
}

正常返回示例

XML格式

<RequestId>5C1C9DE7-88FF-4B56-A47B-3DBBCEB23256</RequestId>
<Message>success</Message>
<Data>
    <ClusterId>5b2b4ab4-efbc-4a81-9c45-a5942881****</ClusterId>
    <ClusterName>my-dev-cluster</ClusterName>
    <RegionId>cn-hangzhou</RegionId>
    <IngressConfs>
        <SslRedirect/>
        <Endpoint>47.11x.xx.xx</Endpoint>
        <CreationTime>2021-04-27 20:16:52</CreationTime>
        <Namespace>default</Namespace>
        <DashboardUrl>http://grafana.console.aliyun.com/d/10xxxx/ingress</DashboardUrl>
        <Name>my-ingress</Name>
        <Rules>
            <SecretName>my-secret</SecretName>
            <Host>abc.com</Host>
            <Paths>
                <Path>/foo/bar</Path>
                <Status>Normal</Status>
                <AppId>43d30ba5-c568-460c-8080-d447ed1a****</AppId>
                <AppName>my-app</AppName>
                <Backend>
                    <ServicePort>8080</ServicePort>
                    <ServiceName>http-service</ServiceName>
                </Backend>
            </Paths>
        </Rules>
    </IngressConfs>
</Data>
<Code>200</Code>

JSON格式

{
    "RequestId": "5C1C9DE7-88FF-4B56-A47B-3DBBCEB23256",
    "Message": "success",
    "Data": {
        "ClusterId": "5b2b4ab4-efbc-4a81-9c45-a5942881****",
        "ClusterName": "my-dev-cluster",
        "RegionId": "cn-hangzhou",
        "IngressConfs": {
            "SslRedirect": "",
            "Endpoint": "47.11x.xx.xx",
            "CreationTime": "2021-04-27 20:16:52",
            "Namespace": "default",
            "DashboardUrl": "http://grafana.console.aliyun.com/d/10xxxx/ingress",
            "Name": "my-ingress",
            "Rules": {
                "SecretName": "my-secret",
                "Host": "abc.com",
                "Paths": {
                    "Path": "/foo/bar",
                    "Status": "Normal",
                    "AppId": "43d30ba5-c568-460c-8080-d447ed1a****",
                    "AppName": "my-app",
                    "Backend": {
                        "ServicePort": 8080,
                        "ServiceName": "http-service"
                    }
                }
            }
        }
    },
    "Code": 200
}

错误码

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

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