查询网关详情。 ## 请求说明 API 网关已在全球多个地域部署服务，旨在为您提供更稳定、低延迟的访问体验。您可以通过查阅 [服务地址](https://docs.volcengine.com/docs/6569/2603628?lang=zh&TagIDs=2%2C286) 文档，根据业务所在地域，选择最合适的接入点。 * 请求方式：POST * 请求地址：https://apig.cn\-beijing.volcengineapi.com?Action=GetGateway&Version=2021\-03\-03 ## 调试 [去调试](https://api.volcengine.com/api-explorer/debug?action=GetGateway&serviceCode=apig&version=2021-03-03&groupName=) ## 请求参数 |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Action |String |是 |GetGateway |接口名称。当前 API 的名称为 `GetGateway`。 | |Version |String |是 |2021\-03\-03 |接口版本。当前 API 的版本为 `2021-03-03`。 | |Id |String |是 |gd8\*\*\*\* |网关实例 ID。 | ## 返回参数 |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |Gateway |Object of [GatewayResponse](https://docs.volcengine.com/docs/6569/1337086#gatewayresponse) |\- |网关实例详情。 | ### GatewayResponse |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |Id |String |gd8\*\*\*\* |网关实例 ID。 | |Name |String |example |网关实例名称。 | |Region |String |cn\-beijing |网关实例所属地域。 | |NetworkSpec |Object of [DetailedNetworkSpec](https://docs.volcengine.com/docs/6569/1337086#detailednetworkspec) |\- |网络配置。 | |ResourceSpec |Object of [ResourceSpec](https://docs.volcengine.com/docs/6569/1337086#resourcespec) |\- |规格配置。 | |Status |String |Running |网关实例状态，取值：

* **Creating**：创建中。

* **CreatedFailed**：创建失败。

* **Updating**：更新中。

* **Running**：运行中。

* **Deleting**：删除中。

* **DeletedFailed**：删除失败。

* **Abnormal**：异常。 | |Message |String |\- |网关实例创建失败、删除失败或异常时的错误信息。 | |CreateTime |String |2025\-01\-01T00:00:00+08:00 |网关实例创建时间。

标准 [RFC3339](https://tools.ietf.org/html/rfc3339) 格式的 UTC+8 时间。 | |MonitorSpec |Object of [MonitorSpec](https://docs.volcengine.com/docs/6569/1337086#monitorspec) |\- |监控配置。 | |LogSpec |Object of [LogSpec](https://docs.volcengine.com/docs/6569/1337086#logspec) |\- |日志配置。 | |Comments |String |example |网关实例备注信息。 | |Type |String |standard |网关实例类型，取值：

* **standard**：标准网关。

* **serverless**：Serverless 网关。

* **elastic**：弹性网关。 | |Version |String |1.16.0 |网关实例版本。 | |Events |Array of [GatewayEvent](https://docs.volcengine.com/docs/6569/1337086#gatewayevent) |\- |网关实例对应的事件信息。 | |ProjectName |String |default |网关实例所属的项目名称。 | |CustomLog |Object of [CustomLog](https://docs.volcengine.com/docs/6569/1337086#customlog) |\- |网关实例自定义日志。 | |TraceSpec |Object of [TraceSpecResponse](https://docs.volcengine.com/docs/6569/1337086#tracespecresponse) |\- |链路追踪配置。 | ### DetailedNetworkSpec |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |VpcId |String |vpc\-rrd\*\*\*\* |网关实例所在的私有网络的 ID。 | |VpcName |String |example |网关实例所在的私有网络的名称。 | |Subnets |Array of [DetailedSubnetSpec](https://docs.volcengine.com/docs/6569/1337086#detailedsubnetspec) |\- |网关实例所属的子网配置。 | ### ResourceSpec |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |Replicas |Integer |3 |节点数量。整数形式，取值范围为 2~100。 | |InstanceSpecCode |String |2c4g |节点规格，取值：

* **1c2g**。

* **2c4g**。

* **4c8g**。

* **8c16g**。 | |CLBSpecCode |String |small_1 |CLB 规格，取值：

* **small_1**：小型 I。

* **small_2**：小型 II。

* **medium_1**：中型 I。

* **medium_2**：中型 II。

* **large_1**：大型 I。

* **large_2**：大型 II。 | |PublicNetworkBillingType |String |traffic |公网网络计费方式，取值：

* **traffic**：按实际流量计费。

* **bandwidth**：按带宽上限计费。 | |PublicNetworkBandwidth |Integer |20 |公网带宽上限。单位为Mbps，取值范围为 0~500，默认值为 0。

说明

当ResourceSpec.PublicNetworkBillingType取值为 bandwidth 时，需要配置本参数。

| |NetworkType |Object of [NetworkType](https://docs.volcengine.com/docs/6569/1337086#networktype) |\- |网络类型。 | ### MonitorSpec |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |Enable |Boolean |true |是否开启托管 Prometheus（VMP）服务。取值：

* **true**：开启。

* **false**：不开启。 | |WorkspaceID |String |e28ae\*\*\*\* |Prometheus 工作区 ID。详情请参见 [创建通用工作区](https://www.volcengine.com/docs/6731/1037488?lang=zh)。

说明

当MonitorSpec.Enable值为 true 时，需要配置本参数。

| ### LogSpec |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |Enable |Boolean |true |是否开启日志服务。取值：

* **true**：开启。

* **false**：不开启。 | |ProjectId |String |fc69\*\*\*\* |日志项目 ID。详情请参见 [创建日志项目](https://www.volcengine.com/docs/6470/112174?lang=zh)。

说明

当LogSpec.Enable值为 true 时，需要配置本参数。

说明

当LogSpec.Enable值为 true 时，需要配置本参数。

| ### GatewayEvent |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |Code |String |example |事件代码。 | |Description |String |example |事件描述。 | |CreateTime |String |2025\-01\-01T00:00:00+08:00 |事件创建时间。 | |Data |JSON Map |{"example\-key":"example\-value"} |事件附带信息。 | ### CustomLog |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |RequestHeaders |Array of [LogEntry](https://docs.volcengine.com/docs/6569/1337086#logentry) |\- |请求头。长度限制为 0~20 个。 | |ResponseHeaders |Array of [LogEntry](https://docs.volcengine.com/docs/6569/1337086#logentry) |\- |响应头。长度限制为 0~20 个。 | |CustomVariables |Array of [LogEntry](https://docs.volcengine.com/docs/6569/1337086#logentry) |\- |自定义变量。长度限制为 0~20 个。 | ### TraceSpecResponse |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |Enable |Boolean |true |是否开启链路追踪。取值：

* **true**：开启。

* **false**：不开启。 | |TraceType |String |tls |链路追踪类型，取值：

* **tls**：日志服务。

* **apm**：应用性能监控全链路版。 | |TLSTraceSpec |Object of [TLSTraceSpecResponse](https://docs.volcengine.com/docs/6569/1337086#tlstracespecresponse) |\- |日志服务链路追踪配置。 | ### DetailedSubnetSpec |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |SubnetId |String |subnet\-5g3\*\*\*\* |网关实例所属的子网 ID。 | |AZ |String |cn\-beijing |子网所属的可用区。 | |SubnetName |String |example |子网名称。 | ### NetworkType |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |EnablePublicNetwork |Boolean |true |是否开启公网。取值：

* **true**：开启。

* **false**：不开启。 | |EnablePrivateNetwork |Boolean |true |是否开启私网。取值：

* **true**：开启。

* **false**：不开启。 | ### Data |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |key |String |example\-key |事件附带信息的键。 | |value |String |example\-value |事件附带信息的值。 | ### LogEntry |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |Key |String |example |日志规则的字段值。 | |AliasesInLog |String |alias |日志规则的字段别名。 | ### TLSTraceSpecResponse |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |ProjectId |String |fc69\*\*\*\* |日志项目ID。详情请参见 [创建日志项目](https://www.volcengine.com/docs/6470/112174?lang=zh)。 | |TraceId |String |0fda\*\*\*\* |Trace ID。详情请参见 [创建Trace实例](https://www.volcengine.com/docs/6470/2117571?lang=zh)。 | ## 示例 #### 请求示例 ```json POST https://apig.cn-beijing.volcengineapi.com?Action=GetGateway&Version=2021-03-03 Content-Type: application/json { "Id": "gd8****" } ``` #### 返回示例 ```json Content-Type: application/json { "ResponseMetadata": { "RequestId": "20230604110420****100232280022D31", "Action": "GetGateway", "Version": "2021-03-03", "Service": "apig", "Region": "cn-beijing" }, "Result": { "Gateway": { "Id": "gd8****", "Name": "example", "Type": "standard", "Events": [ { "Code": "example", "Data": { "example-key": "example-value" }, "CreateTime": "2025-01-01T00:00:00+08:00", "Description": "example" } ], "Region": "cn-beijing", "Status": "Running", "LogSpec": { "Enable": true, "TopicId": "b****", "ProjectId": "fc69****" }, "Message": "", "Version": "1.16.0", "Comments": "example", "CustomLog": { "RequestHeaders": [ { "Key": "example", "AliasesInLog": "alias" } ], "CustomVariables": [ { "Key": "example", "AliasesInLog": "alias" } ], "ResponseHeaders": [ { "Key": "example", "AliasesInLog": "alias" } ] }, "TraceSpec": { "Enable": true, "TraceType": "tls", "TLSTraceSpec": { "TraceId": "0fda****", "ProjectId": "fc69****" } }, "CreateTime": "2025-01-01T00:00:00+08:00", "MonitorSpec": { "Enable": true, "WorkspaceID": "e28ae****" }, "NetworkSpec": { "VpcId": "vpc-rrd****", "Subnets": [ { "AZ": "cn-beijing", "SubnetId": "subnet-5g3****", "SubnetName": "example" } ], "VpcName": "example" }, "ProjectName": "default", "ResourceSpec": { "Replicas": 3, "CLBSpecCode": "small_1", "NetworkType": { "EnablePublicNetwork": true, "EnablePrivateNetwork": true }, "InstanceSpecCode": "2c4g", "PublicNetworkBandwidth": 20, "PublicNetworkBillingType": "traffic" } } } } ``` ## 错误码本接口无特有的错误码。更多信息请参见 [公共错误码](https://www.volcengine.com/docs/6569/1337089)。