根據資產的分組名稱查詢分組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 | 當前操作未被授權,請聯絡主帳號在RAM控制台進行授權後再執行操作。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。