すべてのプロダクト
Search
ドキュメントセンター

Security Center:GetMaliciousFileWhitelistConfig

最終更新日:Mar 21, 2026

エージェントレス検出機能を使用して検出された機密ファイルのアラートホワイトリストルールを照会します。

今すぐお試しください

この 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:GetMaliciousFileWhitelistConfig

get

*MaliciousFileWhitelistConfig

acs:yundun-sas:{#regionId}:{#accountId}:maliciousfilewhitelistconfig/{#ConfigId}

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

ConfigId

integer

任意

ホワイトリストルールの ID。

1

レスポンスフィールド

フィールド

説明

object

PlainResult

Data

object

レスポンスパラメーター。

GmtCreate

string

作成時間。

1671607025000

GmtModified

string

更新時間。

1674095396000

EventName

string

アラート名。

  • 値は ALL に固定されており、すべてのアラートタイプを示します。

ALL

Field

string

ホワイトリストルールで使用されるフィールド。

fileMd5

FieldValue

string

ホワイトリストルールで使用されるフィールドの値。

b2cf9747ee49d8d9b105cf16e078cc16

Operator

string

ホワイトリストルールで使用される論理演算子。

  • 値は strEqual に固定されており、等価演算子 (=) を示します。

strEqual

TargetValue

string

ホワイトリストルールが適用される資産。有効な値は次のとおりです。

  • ALL: すべての資産

  • Others: 選択された資産

ALL

TargetType

string

ホワイトリストルールが適用される資産のタイプ。有効な値は次のとおりです。

  • ALL: すべての資産

  • SELECTION_KEY: 選択された資産

ALL

Count

string

ホワイトリストルールが適用される資産数。

説明

このパラメーターの値は、TargetType の値が SELECTION_KEY の場合にのみ返されます。

0

Source

string

この操作が属する機能。

  • 値は agentless に固定されており、エージェントレス検出機能を示します。

agentless

Id

integer

ホワイトリストルールの ID。

1

Success

boolean

リクエストが成功したかどうかを示します。有効な値は次のとおりです。

  • true

  • false

true

Code

string

レスポンスコード。状態コード 200 は、リクエストが成功したことを示します。その他の状態コードは、リクエストが失敗したことを示します。状態コードに基づいて失敗の原因を特定できます。

200

Message

string

返されたメッセージ。

successful

RequestId

string

リクエスト ID。

F8B6F758-BCD4-597A-8A2C-DA5A552C****

HttpStatusCode

integer

HTTP ステータスコード。値 200 は、リクエストが成功したことを示します。

200

成功レスポンス

JSONJSON

{
  "Data": {
    "GmtCreate": "1671607025000",
    "GmtModified": "1674095396000",
    "EventName": "ALL",
    "Field": "fileMd5",
    "FieldValue": "b2cf9747ee49d8d9b105cf16e078cc16",
    "Operator": "strEqual",
    "TargetValue": "ALL",
    "TargetType": "ALL",
    "Count": "0",
    "Source": "agentless",
    "Id": 1
  },
  "Success": true,
  "Code": "200",
  "Message": "successful",
  "RequestId": "F8B6F758-BCD4-597A-8A2C-DA5A552C****",
  "HttpStatusCode": 200
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 NoPermission no permission
400 UnknownError UnknownError
500 ServerError ServerError
403 NoPermission caller has no permission

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

変更履歴

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