查询 Upstream 来源配置详情。 ## 请求说明 * 请求方式：POST * 请求地址：https://open.volcengineapi.com?Action=GetUpstreamSource&Version=2021\-03\-03 ## 调试 [去调试](https://api.volcengine.com/api-explorer/debug?action=GetUpstreamSource&serviceCode=apig&version=2021-03-03&groupName=) ## 请求参数 |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Action |String |是 |GetUpstreamSource |接口名称。当前 API 的名称为 `GetUpstreamSource`。 | |Version |String |是 |2021\-03\-03 |接口版本。当前 API 的版本为 `2021-03-03`。 | |Id |String |是 |ust7\*\*\*\* |Upstream 来源 ID。您可以通过 [ListUpstreamSources](https://www.volcengine.com/docs/6569/1628113?lang=zh) 查询 Upstream 来源 ID。 | ## 请求示例 ```json POST https://open.volcengineapi.com?Action=GetUpstreamSource&Version=2021-03-03 Content-Type: application/json { "Id": "ust7****" } ``` ## 返回参数 |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |UpstreamSource |Object of [UpstreamSourceResponse](https://www.volcengine.com/docs/6569/1628112#upstreamsourceresponse) |\- |Upstream 来源配置详情。 | ### UpstreamSourceResponse |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |Id |String |ust7\*\*\*\* |Upstream 来源 ID。 | |GatewayId |String |gd8\*\*\*\* |网关 ID。 | |SourceType |String |K8S |Upstream 来源类型，取值：

* **K8S**：容器集群。

* **Nacos**：注册中心。 | |Comments |String |\- |Upstream 来源备注信息。 | |SourceSpec |Object of [SourceSpec](https://www.volcengine.com/docs/6569/1628112#sourcespec) |\- |Upstream 来源配置。 | |WatchNamespaces |Array of String |["default"] |指定命名空间。 | |IngressSettings |Object of [IngressSettings](https://www.volcengine.com/docs/6569/1628112#ingresssettings) |\- |路由同步。 | |CreateTime |String |2025\-01\-01T00:00:00+08:00 |Upstream 来源创建时间。

标准 [RFC3339](https://tools.ietf.org/html/rfc3339) 格式的 UTC+0 时间。 | |UpdateTime |String |2025\-01\-01T00:00:00+08:00 |Upstream 来源更新时间。

标准 [RFC3339](https://tools.ietf.org/html/rfc3339) 格式的 UTC+0 时间。 | |Status |String |SyncedSucceed |导入状态，取值：

* **Syncing**：导入中。

* **SyncedSucceed**：导入成功。

* **SyncedFailed**：导入失败。 | |StatusMessage |String |\- |导入状态信息，取值：

* **ConnectionFailed**：Nacos 集群无法连接。

* **AuthenticationFailed**：认证失败。

* **PermissionFailed**：Nacos 集群无法连接。 | ### SourceSpec |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |K8SSource |Object of [K8SSource](https://www.volcengine.com/docs/6569/1628112#k8ssource) |\- |容器集群来源。 | |NacosSource |Object of [NacosSource](https://www.volcengine.com/docs/6569/1628112#nacossource) |\- |注册中心来源。 | ### IngressSettings |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |EnableIngress |Boolean |true |是否开启路由同步。取值：

* **true**：开启。

* **false**：不开启。

说明

开启后，API 网关会自动监听 Ingress 资源的变化，并将 Ingress 资源转义为服务，域名和 Upstream 等资源合并至当前网关。

由 Ingress 转义的资源不支持在控制台操作。

说明

当IngressSettings.EnableAllIngressClasses取值为false时有返回值。

说明

当IngressSettings.EnableAllIngressClasses取值为false时有返回值。

说明

当IngressSettings.EnableAllNamespaces取值为false时有返回值。

说明

当IngressSettings.EnableAllNamespaces取值为false时有返回值。

开启后，当前集群 Ingress 中 Status 的 IP 地址会被修改为当前网关的 IP 地址。

| ### K8SSource |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |ClusterId |String |cc9q8p\*\*\*\* |集群 ID。您可以通过 [ListClusters](https://www.volcengine.com/docs/6460/115190?lang=zh) 查询集群 ID。 | |ClusterType |String |vke |集群类型，取值：**vke**，代表容器服务集群 | ### NacosSource |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |NacosId |String |ncn24\*\*\*\* |Nacos 实例 ID。 | |AuthConfig |Object of [AuthConfig](https://www.volcengine.com/docs/6569/1628112#authconfig) |\- |认证配置。 | |NacosName |String |example |Nacos 名称。 | ### AuthConfig |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |Basic |Object of [Basic](https://www.volcengine.com/docs/6569/1628112#basic) |\- |Nacos 登录认证。 | ### Basic |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |Username |String |username |Nacos 登录用户名。 | |Password |String |password |Nacos 登录密码。 | ## 返回示例 ```json Content-Type: application/json { "ResponseMetadata": { "RequestId": "20230604110420****100232280022D31", "Action": "GetUpstreamSource", "Version": "2021-03-03", "Service": "apig", "Region": "cn-beijing" }, "Result": { "UpstreamSource": { "Id": "ust7****", "Status": "SyncedSucceed", "Comments": "", "GatewayId": "gd8****", "CreateTime": "2025-01-01T00:00:00+08:00", "SourceSpec": { "K8SSource": { "ClusterId": "cc9q8p****", "ClusterType": "vke" }, "NacosSource": { "NacosId": "ncn24****", "NacosName": "example", "AuthConfig": { "Basic": { "Password": "password", "Username": "username" } } } }, "SourceType": "K8S", "UpdateTime": "2025-01-01T00:00:00+08:00", "StatusMessage": "", "IngressSettings": { "UpdateStatus": false, "EnableIngress": true, "IngressClasses": [ "example" ], "WatchNamespaces": [ "default" ], "EnableAllNamespaces": true, "EnableAllIngressClasses": false, "EnableIngressWithoutIngressClass": true }, "WatchNamespaces": [ "default" ] } } } ``` ## 错误码本接口无特有的错误码。更多信息请参见 [公共错误码](https://www.volcengine.com/docs/6569/1337089)。