AI 助理
备案控制台
官方文档
有奖调研
输入文档关键字查找
首页 云存储网关 开发参考 API参考指南 API目录 网关 DescribeGateway - 查询网关基本信息

DescribeGateway - 查询网关基本信息

更新时间：
产品详情
我的收藏

根据指定网关ID查询网关的基本信息。包括网关状态、类型等详情。

接口说明

调用该接口时，您需要注意：

  • 请确保在使用该接口前，已充分了解云存储网关产品的收费方式和价格。

  • 如果您需要购买网关，您可以通过该接口返回的购买链接或续费链接进行购买或续费。

调试

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

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。
  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
    • 对于必选的资源类型，用前面加 * 表示。
    • 对于不支持资源级授权的操作，用全部资源表示。
  • 条件关键字：是指云产品自身定义的条件关键字。
  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
操作访问级别资源类型条件关键字关联操作
hcs-sgw:DescribeGatewayget
*全部资源
*
    无
无

请求参数

名称类型必填描述示例值
GatewayIdstring是

网关 ID。

gw-000eg44nmxbsfwbvq***

返回参数

名称类型描述示例值
object
Descriptionstring

网关描述。

测试使用
CreatedTimelong

网关创建时间。时间戳为秒（s）。

1532099461
PublicNetworkBandwidthinteger

数据公网带宽，单位为 Mbps。如果网关为线上网关返回数据公网带宽。

5
DataLoadTypestring

废弃。

 废弃
Categorystring

网关类别。默认值为Aliyun。

Aliyun
TaskIdstring

任务 ID。

t-0000iwdggbharrw6r***
Messagestring

请求结果描述。

successful
ExpireStatusinteger

预付费情况下，网关是否过期的状态。可能值：

  • 0：正常

  • 1：将要过期

  • 2：已经过期

0
Ipstring

公网 IP。

47.101.**.**
GatewayTypestring

网关类型，可能值如下：

  • File：文件网关

  • Iscsi：块网关

File
StorageBundleIdstring

网关集群 ID。

sb-000dt67z4ijqfocpy***
GatewayClassstring

网关规格。当网关为线上网关时会返回网关规格。可能值如下：

  • Basic：基础型

  • Standard：标准型

  • Enhanced：增强型

  • Advanced：性能型

Basic
Successboolean

请求是否成功。可能值如下：

  • true：是

  • false：否

true
Namestring

网关名称。

alex***
IsPostPaidboolean

是否为后付费网关。可能值如下：

  • true：后付费网关，即按量付费网关。

  • false：预付费网关，即包年包月网关。

true
Capacityinteger

废弃。

500
ExpiredTimelong

预付费情况下，网关的过期时间，时间戳为毫秒（ms）。

1532530021
GatewayVersionstring

网关版本。

1.0.39
IsReleaseAfterExpirationboolean

预付费情况下，是否到期释放。可能值如下：

  • true：到期自动释放，直接收回。

  • false：预付费到期后自动转为按量付费模式。

false
Statusstring

网关状态。可能值如下：

  • Initialized：已初始化

  • Deactivated：未激活

  • Activated：已激活

  • Deploying：部署中

  • Running：运行中

  • Stopping：停止中

  • Stopped：已停止

  • Starting：启动中

  • Rebooting：重启中

  • Deleting：删除中

  • Failed：失败

  • Upgrading：升级中

  • Modifying：修改中

  • Unknown：长时间没有心跳

Initialized
BuyURLstring

未完成支付情况下，预付费的购买支付链接。

https://expense.console.aliyun.com/?returnExpense=true#/order/list/
MaxThroughputinteger

废弃。

30
DataLoadIntervalinteger

废弃。

120
InnerIpstring

挂载 IP。

172.19.55.65
RequestIdstring

请求 ID。

736C7733-FCED-4AFB-8407-C325F210CE03
VSwitchIdstring

虚拟交换机 vSwitch ID。

vsw-bp1b3mvml55ziekq7e***
ElasticNodesarray

弹性网关节点 IP 信息。

ElasticNodestring

废弃。

172.16.0.23
GatewayIdstring

网关 ID。

gw-0000ewknguw5o96vn***
Codestring

状态码。状态码为 200 表示请求成功。

200
EcsInstanceIdstring

ECS 实例 ID。

i-uf62406gy5vyao4y8***
Typestring

参见 GatewayType 参数。

File
RenewURLstring

预付费情况下的续费链接。

https://common-buy.aliyun.com/?commodityCode=hcs_sgw_csg_pre&orderType=RENEW&instanceId=ca-0007va9bnideidndn***#/renew
VpcIdstring

专有网络 VPC ID。

vpc-uf6j237kxmsw08auey***
ActivatedTimelong

网关激活时间。时间戳为秒（s）。

1578986214
ElasticGatewayboolean

废弃。

false
CommonBuyInstanceIdstring

包年包月网关在售卖系统中的实例 ID。

gw-000fhosecoziy6ri****
InnerIpv6Ipstring

IPv6 地址。

2408:4004::ffff:ffff:ffff:ffff:ffff:ffff
LastErrorKeystring

错误关键字。

InternalError
Locationstring

网关位置。可能值如下：

  • Cloud：线上网关

  • On_Premise：线下网关

Cloud
GatewayRegionIdstring

网关地域。

cn-hangzhou
UntrustedEnvInstanceTypestring

非授信（云盒）场景下网关的实际规格。

ecs.g6.large
UntrustedEnvOssEndpointstring

非授信（云盒）场景下网关的 OSS Endpoint。

oss-cn-hangzhou.aliyuncs.com
HighAvailabilityboolean

是否为高可用网关。

false
SecondaryVSwitchIdstring

高可用网关备节点虚拟交换机 ID。

vsw-bp1xw499jo5****

示例

正常返回示例

JSON格式

{
  "Description": "测试使用",
  "CreatedTime": 1532099461,
  "PublicNetworkBandwidth": 5,
  "DataLoadType": "  废弃",
  "Category": "Aliyun",
  "TaskId": "t-0000iwdggbharrw6r***",
  "Message": "successful",
  "ExpireStatus": 0,
  "Ip": "47.101.**.**",
  "GatewayType": "File",
  "StorageBundleId": "sb-000dt67z4ijqfocpy***",
  "GatewayClass": "Basic",
  "Success": true,
  "Name": "alex***",
  "IsPostPaid": true,
  "Capacity": 500,
  "ExpiredTime": 1532530021,
  "GatewayVersion": "1.0.39",
  "IsReleaseAfterExpiration": false,
  "Status": "Initialized",
  "BuyURL": "https://expense.console.aliyun.com/?returnExpense=true#/order/list/",
  "MaxThroughput": 30,
  "DataLoadInterval": 120,
  "InnerIp": "172.19.55.65",
  "RequestId": "736C7733-FCED-4AFB-8407-C325F210CE03",
  "VSwitchId": "vsw-bp1b3mvml55ziekq7e***",
  "ElasticNodes": {
    "ElasticNode": [
      "172.16.0.23"
    ]
  },
  "GatewayId": "gw-0000ewknguw5o96vn***",
  "Code": "200",
  "EcsInstanceId": "i-uf62406gy5vyao4y8***",
  "Type": "File",
  "RenewURL": "https://common-buy.aliyun.com/?commodityCode=hcs_sgw_csg_pre&orderType=RENEW&instanceId=ca-0007va9bnideidndn***#/renew",
  "VpcId": "vpc-uf6j237kxmsw08auey***",
  "ActivatedTime": 1578986214,
  "ElasticGateway": false,
  "CommonBuyInstanceId": "gw-000fhosecoziy6ri****",
  "InnerIpv6Ip": "2408:4004::ffff:ffff:ffff:ffff:ffff:ffff",
  "LastErrorKey": "InternalError",
  "Location": "Cloud",
  "GatewayRegionId": "cn-hangzhou",
  "UntrustedEnvInstanceType": "ecs.g6.large",
  "UntrustedEnvOssEndpoint": "oss-cn-hangzhou.aliyuncs.com",
  "HighAvailability": false,
  "SecondaryVSwitchId": "vsw-bp1xw499jo5****"
}

错误码

HTTP status code错误码错误信息描述
400EmptyGatewayIdYou must enter a valid ID for the gateway.网关ID不能为空。
400GatewayNotExistThe specified gateway does not exist. You must specify a valid parameter.网关不存在，请确认输入参数是否正确。

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

变更历史

变更时间变更内容概要操作
2024-03-14OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更查看变更详情
2023-06-30OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更查看变更详情
上一篇：DeleteGateway - 删除网关下一篇：ModifyGateway - 修改网关基本信息