使用GetSpareIp查询CNAME备用IP的状态-全球加速-阿里云-全球加速(GA)-阿里云帮助中心

调试

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

操作

访问级别

资源类型

条件关键字

关联操作

ga:GetSpareIp

get

*Accelerator

acs:ga:{#regionId}:{#accountId}:ga/{#acceleratorId}

无

名称	类型	必填	描述	示例值
RegionId	string	是	全球加速实例所在的地域 ID，仅取值：cn-hangzhou。	cn-hangzhou
ClientToken	string	否	保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。	1F4B6A4A-C89E-489E-BAF1-52777EE148EF
DryRun	boolean	否	是否只预检此次请求，取值： true：发送检查请求，不会创建资源。检查项包括是否填写了必需参数、请求格式、业务限制。如果检查不通过，则返回对应错误。如果检查通过，则返回错误码`DryRunOperation`。 false（默认值）：发送正常请求，通过检查后返回 HTTP 2xx 状态码并直接进行操作。	true
AcceleratorId	string	是	全球加速实例 ID。	ga-bp1odcab8tmno0hdq****
SpareIp	string	是	CNAME 备用 IP，当加速区域异常时，流量切换到该 IP。	47.100.XX.XX

名称	类型	描述	示例值
	object	返回信息列表。
RequestId	string	请求 ID。	6FEA0CF3-D3B9-43E5-A304-D217037876A8
State	string	CNAME 备用 IP 的状态。取值： active：可用。 inuse：使用中。	active

正常返回示例

JSON格式

{
  "RequestId": "6FEA0CF3-D3B9-43E5-A304-D217037876A8",
  "State": "active"
}

HTTP status code	错误码	错误信息	描述
400	NoPermission	No permissions.	无权限

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

更多信息，参考变更详情。