调用ListSpareIps查询CNAME备用IP列表信息_全球加速(GA)-阿里云帮助中心

调用ListSpareIps接口查询CNAME备用IP列表信息。

调试

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

操作	访问级别	资源类型	条件关键字	关联操作
ga:ListSpareIps	list	Accelerator acs:ga:{#regionId}:{#accountId}:ga/{#acceleratorId}	无	无

名称	类型	必填	描述	示例值
RegionId	string	是	全球加速实例所在的地域 ID，仅取值：cn-hangzhou。	cn-hangzhou
ClientToken	string	否	客户端 Token，用于保证请求的幂等性。由客户端生成该参数值，要保证在不同请求间唯一。说明若您未指定，则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 不一样。	123e4567-e89b-12d3-a456-426655440000
DryRun	boolean	否	是否只预检此次请求，取值： true：发送检查请求，不会查询资源。检查项包括是否填写了必需参数、请求格式、业务限制。如果检查不通过，则返回对应错误。如果检查通过，则返回错误码`DryRunOperation`。 false（默认值）：发送正常请求，通过检查后返回 HTTP 2xx 状态码并直接进行操作。	true
AcceleratorId	string	是	全球加速实例 ID。	ga-bp1odcab8tmno0hdq****

名称	类型	描述	示例值
	object	返回信息列表。
RequestId	string	请求 ID。	6FEA0CF3-D3B9-43E5-A304-D217037876A8
SpareIps	array<object>	CNAME 备用 IP 列表。
	object	CNAME 备用 IP 列表。
SpareIp	string	CNAME 备用 IP，当加速区域异常时，流量切换到该 IP。	47.100.XX.XX
State	string	CNAME 备用 IP 的状态。取值： active：可用。 inuse：使用中。	active

正常返回示例

JSON格式

{
  "RequestId": "6FEA0CF3-D3B9-43E5-A304-D217037876A8",
  "SpareIps": [
    {
      "SpareIp": "47.100.XX.XX",
      "State": "active"
    }
  ]
}

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

变更时间	变更内容概要	操作

暂无变更历史