调用CountGateways统计当前用户账号名下符合过滤条件的网关数量。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CountGateways |
系统规定参数。取值:CountGateways。 |
FreqBandPlanGroupId | Long | 否 | 123 |
网关频段ID过滤。 |
FuzzyCity | String | 否 | 杭州 |
城市名模糊过滤。 |
FuzzyGwEui | String | 否 | 123456 |
GwEUI模糊过滤。 |
FuzzyName | String | 否 | name |
网关名称模糊过滤。 |
IsEnabled | Boolean | 否 | false |
网关启停用状态过滤。 若未传入此参数,则不限制启停状态。 |
OnlineState | String | 否 | ONLINE |
网关在离线状态过滤。 若未传入此参数,则不限制在线状态。可取值为ONLINE和OFFLINE。 |
RegionId | String | 否 | cn-hangzhou |
地域ID。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Data | Long | 100 |
满足过滤条件的网关总数。 |
RequestId | String | 89EF6CAA-958F-F32C-BE45-FE003C6DE097 |
请求ID。 |
Success | Boolean | true |
是否成功。 |
示例
请求示例
http(s)://linkwan.cn-shanghai.aliyuncs.com/?Action=CountGateways
&<公共请求参数>
正常返回示例
XML
格式
<CountGatewaysResponse>
<Data>100</Data>
<RequestId>89EF6CAA-958F-F32C-BE45-FE003C6DE097</RequestId>
<Success>true</Success>
</CountGatewaysResponse>
JSON
格式
{
"Data":100,
"RequestId":"89EF6CAA-958F-F32C-BE45-FE003C6DE097",
"Success":true
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | ForbiddenByRam | User not authorized to operate on the specified resource, or this API does not support RAM. | 用户没有执行该操作所需要的RAM权限。 |
400 | ForbiddenByRiskControl | This operation cannot be performed because of security risks. | 存在安全风险,无法执行该操作 |
400 | InternalError | The request processing has failed due to some unknown error, exception or failure. | 内部错误。 |
访问错误中心查看更多错误码。