アセットグルーピング向け DescribeGroupedInstances API の概要 - Security Center

指定されたフィルター条件に基づき、資産の統計情報を照会します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
Lang	string	任意	リクエストおよび応答内のコンテンツ言語。デフォルト値：zh。有効な値： zh：中国語 en：英語	zh
MachineTypes	string	任意	照会対象の資産タイプ。値を ecs に設定します。これは Elastic Compute Service (ECS) インスタンスを示します。	ecs
GroupField	string	必須	資産を照会するためのフィルター条件。有効な値： groupId：資産が所属するグループ regionId：資産が配置されているリージョン vpcInstanceId：資産が配置されている仮想プライベートクラウド (VPC)	groupId
FieldValue	string	任意	資産が所属するグループの名前。あいまい検索がサポートされます。	test-01
NoPage	boolean	任意	ページングクエリを有効化するかどうかを指定します。デフォルト値：true。有効な値： true：有効 false：無効	true
PageSize	integer	任意	1 ページあたりに返すエントリ数。デフォルト値：20。	20
CurrentPage	integer	任意	返すページのページ番号。デフォルト値：1。	1
Vendor	integer	任意	サーバーのソース。有効な値： 0：Alibaba Cloud が提供する資産 1：サードパーティのクラウドサーバー 2：データセンター内のサーバー 3、4、5、および 7：その他のクラウド資産 8：軽量資産	0
Vendors	string	任意	サーバーのソース。複数のソースをカンマ (,) で区切ります。有効な値： 0：Alibaba Cloud が提供する資産 1：サードパーティのクラウドサーバー 2：データセンター内のサーバー 3、4、5、および 7：その他のクラウド資産 8：軽量資産	0,8
SaleVersionCheckCode	string	任意	資産を保護する Security Center のエディション。有効な値： sas_gte_advanced：Advanced エディション以上 sas_gte_enterprise：Enterprise エディション以上 sas_gt_basic：有料エディション sas_eq_advanced：Advanced エディションのみ sas_gt_anti_virus：Anti-virus エディションより上位のエディション	sas_gt_basic

レスポンスフィールド

フィールド	型	説明	例
	object	レスポンスパラメーター。
RequestId	string	リクエスト ID。問題の特定およびトラブルシューティングに使用されます。	52A3AEE6-114A-499D-8990-4BA9B27FE0AA
PageInfo	object	ページネーション情報。
CurrentPage	integer	返されるページのページ番号。	5
PageSize	integer	1 ページあたりに返されるエントリ数。デフォルト値：20。	20
TotalCount	integer	返されるエントリの合計数。	100
Count	integer	現在のページに返されるエントリ数。	20
Instances	array<object>	資産に関する情報。
	object	資産に関する情報。
AsapVulInstanceCount	integer	高リスク脆弱性が検出された資産数。	11
UnProtectedInstanceCount	string	Security Center で保護されていない資産数。	32
FieldAliasName	string	サーバーグループの名前。	testA
InstanceCount	string	指定されたタイプに属する資産の総数。説明 MachineTypes リクエストパラメーターが指定されていない場合、InstanceCount パラメーターの値はご利用のアカウントにおける資産総数になります。	205
RiskInstanceCount	string	リスクのある資産数。	172
GroupFlag	integer	サーバーグループのタイプ。有効な値： 0：デフォルトグループ 1：その他のグループ	1
AuthVersionCheckCount	integer	指定されたエディションで保護されている資産数。	205
Os	string	資産のオペレーティングシステムタイプ。有効な値： windows linux 説明このパラメーターは、Lang が zh に設定されている場合にのみ返されます。	windows
InstanceCoreCount	integer	指定された資産タイプにおける資産のコア数。説明 MachineTypes リクエストパラメーターが指定されていない場合、InstanceCoreCount パラメーターの値はご利用のアカウント内における資産のコア総数を示します。	610

例

成功レスポンス

JSONJSON

{
  "RequestId": "52A3AEE6-114A-499D-8990-4BA9B27FE0AA",
  "PageInfo": {
    "CurrentPage": 5,
    "PageSize": 20,
    "TotalCount": 100,
    "Count": 20
  },
  "Instances": [
    {
      "AsapVulInstanceCount": 11,
      "UnProtectedInstanceCount": "32",
      "FieldAliasName": "testA",
      "InstanceCount": "205",
      "RiskInstanceCount": "172",
      "GroupFlag": 1,
      "AuthVersionCheckCount": 205,
      "Os": "windows",
      "InstanceCoreCount": 610
    }
  ]
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	NoPermission	no permission
500	ServerError	ServerError
403	NoPermission	caller has no permission

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。