ListCheckInstanceResult API を使用した失敗したチェックの特定 - Security Center - Alibaba Cloud - Security Center

クラウドプラットフォーム構成の確認項目に失敗したインスタンスを取得します。

今すぐお試しください

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

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

yundun-sas:ListCheckInstanceResult

get

*すべてのリソース。

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
CheckId	integer	必須	確認項目の ID。	23
Statuses	array	任意	確認項目ステータスのコレクション。
	string	任意	確認項目のステータス。有効な値: PASS: 合格。 NOT_PASS: 不合格。 CHECKING: 確認中。 NOT_CHECK: 未確認。 WHITELIST: ホワイトリスト登録済み。 FAILED: 失敗。	PASS
InstanceIdKey	string	任意	確認項目のインスタンス ID。	i-uf64w4q6p9jti5gl****
InstanceNameKey	string	任意	確認項目のインスタンス名。	i-uf64w4q6p9jti5gl****
RegionIdKey	string	任意	インスタンスのリージョン ID。	cn-qingdao
CurrentPage	integer	任意	ページングクエリにおける現在のページのページ番号。このパラメーターはページングに使用されます。	1
PageSize	integer	任意	ページングクエリにおける 1 ページあたりのエントリの最大数。最大値: 100。このパラメーターはページングに使用されます。	20
InstanceIds	array	任意	クエリを実行するクラウドサービスインスタンス ID のコレクション。
	string	任意	クエリを実行するクラウドサービスインスタンス ID。	i-uf64w4q6p9jti5gl****
Lang	string	任意	リクエストおよび応答メッセージの言語タイプ。デフォルト値: zh。有効な値: zh: 中国語 en: 英語	zh
SortTypes	array	任意	確認項目のソートタイプリスト。
	string	任意	確認項目のソートタイプ。現在、値は STATUS に固定されています。	STATUS

レスポンスフィールド

フィールド	型	説明	例
	object	レスポンス構造体。
RequestId	string	リクエスト ID。Alibaba Cloud によってこのリクエストに対して生成される一意の識別子です。問題のトラブルシューティングに使用できます。	3AB18264-8A1B-52A6-A9AF-A886556E0F2E
BasicData	array<object>	影響を受けたインスタンスに関する基本情報のリスト。
	array<object>	影響を受けたインスタンスに関する基本情報。
Id	integer	インスタンスの確認結果 ID。	300054
Status	string	確認項目のステータスリスト。複数のステータスはコンマ (,) で区切られます。有効な値: PASS: 合格。 NOT_PASS: 不合格。 CHECKING: 確認中。 NOT_CHECK: 未確認。 WHITELIST: ホワイトリスト登録済み。 FAILED: 失敗。	NOT_PASS
RegionId	string	インスタンスのリージョン ID。	ap-southeast-1
InstanceId	string	サーバーのインスタンス ID。	rm-m5es7ch1s62i4****
InstanceName	string	サーバーインスタンス名。	sg-t4nbk2aodzio52xv****
StatusMessage	string	確認項目の例外ステータスメッセージ。	確認タスクが失敗した
InstanceInfo	object	対応する確認項目に対して表示されるインスタンス情報。
FirstUpdateTime	integer	最初の確認の時間。値は UNIX タイムスタンプです。単位: ミリ秒。	1716447535531
LastUpdateTime	integer	最新の確認の時間。値は UNIX タイムスタンプです。単位: ミリ秒。	1716447535531
Config	array<object>	対応する修復構成に対して表示される現在のインスタンス情報。
	object	インスタンス情報構造体。
Name	string	対応する構成の一意の名前。	prot
Value	string	現在の資産に対する対応する構成の値。	8080
ShowName	string	対応する設定項目の国際化された名前。	prot
VendorUserName	string	マルチクラウドベンダーのアカウント名。	test
Columns	array<object>	影響を受けたインスタンス情報表示リストのメタデータ。
	array<object>	影響を受けたインスタンス情報表示リストのメタデータ情報。
Type	string	確認インスタンス結果のプロパティタイプ。有効な値: text: テキスト link: リンク	text
Key	string	リストプロパティのキー。	RegionIdShow
ShowName	string	表示名。	リージョン
Search	boolean	検索がサポートされているかどうかを示します。有効な値: true: サポートされています。 false: サポートされていません。	true
SearchKey	string	検索に使用されるキー。	InstanceIdKey
Grids	array<object>	リストタイプメタデータのリスト。
	object	リストタイプメタデータ。
Type	string	確認インスタンス結果のタイプ。有効な値: text: テキスト link: リンク	text
Key	string	検索値。	RegionIdShow
ShowName	string	検索表示名。	リージョン
Checks	array<object>	影響を受けたインスタンスに関する拡張情報のリスト。	[{ "セキュリティGroupNameShow": { "値": "Sas_Malicious_Ip_セキュリティ_Group" }, "InstanceIdShow": { "link": "https://ecs.コンソール.aliyun.com/#/セキュリティGroupDetail/リージョン/ap-southeast-1/groupId/sg-t4nbk2aodzio52xvj00s/rule/intranetIngress", "値": "sg-t4nbk2aodzio52xv****" } }]
	object	影響を受けたインスタンスに関する拡張情報。	[{ "セキュリティGroupNameShow": { "値": "Sas_Malicious_Ip_セキュリティ_Group" }, "InstanceIdShow": { "link": "https://ecs.コンソール.aliyun.com/#/セキュリティGroupDetail/リージョン/ap-southeast-1/groupId/sg-t4nbk2aodzio52xvj00s/rule/intranetIngress", "値": "sg-t4nbk2aodzio52xv****" } }]
	any	確認項目情報。	{ "InstanceIdShow": { "link": "https://vpcnext.コンソール.aliyun.com/vpc/cn-beijing/vpcs", "値": "ngw-2zenx8j1lf5w8rcdhdqs5" }, "RegionIdShow": { "値": "中国 (北京)" } }
PageInfo	object	ページングクエリにおいてページに表示されるページング情報。
CurrentPage	integer	ページングクエリにおける現在のページのページ番号。このパラメーターはページングに使用されます。	1
PageSize	integer	ページングクエリにおける 1 ページあたりのエントリの最大数。このパラメーターはページングに使用されます。	20
TotalCount	integer	エントリの総数。	100
Count	string	現在のページで返されるエントリ数。	20

例

成功レスポンス

JSONJSON

{
  "RequestId": "3AB18264-8A1B-52A6-A9AF-A886556E0F2E",
  "BasicData": [
    {
      "Id": 300054,
      "Status": "NOT_PASS",
      "RegionId": "ap-southeast-1",
      "InstanceId": "rm-m5es7ch1s62i4****",
      "InstanceName": "sg-t4nbk2aodzio52xv****",
      "StatusMessage": "检查任务失败。",
      "InstanceInfo": {
        "FirstUpdateTime": 1716447535531,
        "LastUpdateTime": 1716447535531,
        "Config": [
          {
            "Name": "prot",
            "Value": "8080",
            "ShowName": "prot"
          }
        ]
      },
      "VendorUserName": "test"
    }
  ],
  "Columns": [
    {
      "Type": "text",
      "Key": "RegionIdShow",
      "ShowName": "Region",
      "Search": true,
      "SearchKey": "InstanceIdKey",
      "Grids": [
        {
          "Type": "text",
          "Key": "RegionIdShow",
          "ShowName": "Region"
        }
      ]
    }
  ],
  "Checks": [
    {
      "key": "{\n      \"InstanceIdShow\": {\n        \"link\": \"https://vpc.console.alibabacloud.com/vpc/cn-beijing/vpcs\",\n        \"value\": \"ngw-2zenx8j1lf5w8rcdhdqs5\"\n      },\n      \"RegionIdShow\": {\n        \"value\": \"China(Beijing)\"\n      }\n    }"
    }
  ],
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 20,
    "TotalCount": 100,
    "Count": "20"
  }
}

エラーコード

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

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

変更履歴

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