根据资产的分组名称查询分组ID。
接口说明
本接口用于根据资产的分组名称,查询资产所在分组的分组 ID。当您调用其他接口(如 GetSuspiciousStatistics 、 DeleteGroup )入参需要输入资产分组的 ID,您可调用本接口获取资产分组的 ID。
QPS 限制
本接口的单用户 QPS 限制为 10 次/秒。超过限制,API 调用会被限流,这可能会影响您的业务,请合理调用。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
yundun-sas:QueryGroupIdByGroupName |
get |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| SourceIp |
string |
否 |
访问源的 IP 地址。 |
10.12.XX.XX |
| GroupName |
string |
是 |
要查询的分组的名称。 |
TestGroupName |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| RequestId |
string |
本次调用请求的 ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。 |
24A20733-10A0-4AF6-BE6B-E3322413BB68 |
| GroupId |
integer |
查询到的分组 ID。 |
9935302 |
示例
正常返回示例
JSON格式
{
"RequestId": "24A20733-10A0-4AF6-BE6B-E3322413BB68",
"GroupId": 9935302
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 500 | ServerError | ServerError | |
| 403 | NoPermission | caller has no permission |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。
该文章对您有帮助吗?