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

Security Center:ListCloudAssetInstances

最終更新日:Jun 11, 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:ListCloudAssetInstances

get

*All Resources

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

RegionId

string

任意

インスタンスが存在するリージョンの ID。

cn-hangzhou

Criteria

string

任意

アセットの検索に使用される条件。このパラメーターは JSON フォーマットで、以下のフィールドを含みます:

  • name: 検索項目。

  • value: 検索項目の値。

  • logicalExp: 複数の検索項目値間の論理関係。有効な値:
    • OR: 複数の検索項目値が OR 関係であることを示します。

    • AND: 複数の検索項目値が AND 関係であることを示します。

説明

GetCloudAssetCriteria 操作を呼び出して、サポートされている検索条件をクエリできます。

[{\"name\":\"internetIp\",\"value\":\"192.168\",\"logicalExp\":\"OR\"}]

LogicalExp

string

任意

複数の検索条件間の論理関係。有効な値:

  • OR: 複数の検索条件が OR 関係であることを示します。

  • AND: 複数の検索条件が AND 関係であることを示します。

OR

PageSize

integer

任意

1 ページあたりに表示できる最大行数。最大値: 100。デフォルト値: 20。

20

CurrentPage

integer

任意

ページネーションクエリで返す現在のページ番号。

2

CloudAssetTypes

array<object>

任意

クラウドアセットインスタンスのアセットリスト。

object

任意

クラウドアセットインスタンスのアセット。

AssetType

integer

任意

クラウドアセットのタイプ。

説明

詳細については、 GetCloudAssetCriteria 操作の AssetType を参照してください。

18

AssetSubType

integer

任意

クラウドサービスのサブタイプ。

説明

詳細については、 GetCloudAssetCriteria 操作の AssetSubType を参照してください。

0

Vendor

integer

任意

サーバーベンダー。有効な値:

  • 0: Alibaba Cloud アセット

  • 1: オフクラウドアセット

  • 2: IDC アセット

  • 3457: その他のクラウドアセット

  • 8: 軽量アセット。

0

CloudAssetQueryData

array<object>

任意

キーワードで照会されたデータリスト。

object

任意

Data

string

任意

クエリ内容。

163.8.8.9

Operator

string

任意

クエリ演算子。現在、INCLUDE のみがサポートされています。

INCLUDE

IsSaleData

boolean

任意

レスポンスフィールド

フィールド

説明

object

Success

boolean

API 呼び出しが成功したかどうかを示します。有効な値:

  • true: API 呼び出しが成功しました。

  • false: API 呼び出しが失敗しました。

true

RequestId

string

このリクエストの ID。Alibaba Cloud がリクエストに対して生成する一意の識別子です。問題のトラブルシューティングや特定に使用できます。

028CF634-5268-5660-9575-48C9ED6BF880

PageInfo

object

ページネーション情報。

CurrentPage

integer

ページネーションクエリにおける現在のページのページ番号。

2

PageSize

integer

ページサイズ。

100

TotalCount

integer

クラウドアセットの総数。

69

Count

integer

現在のページに表示されるデータエントリの数。

20

Instances

array<object>

クラウドアセットの詳細情報リスト。

object

クラウドアセットの詳細情報。

RegionId

string

アセットインスタンスが属するリージョンの ID。

cn-hanghzou

Vendor

integer

サーバーベンダー。有効な値:

  • 0: Alibaba Cloud アセット

  • 1: オフクラウドアセット

  • 2: IDC アセット

  • 3457: その他のクラウドアセット

  • 8: 軽量アセット。

0

AssetType

integer

アセットのタイプ。有効な値:

  • 0: Elastic Compute Service (ECS)

  • 1: Server Load Balancer (SLB)

  • 3: ApsaraDB RDS

  • 4: ApsaraDB for MongoDB

  • 5: ApsaraDB for Tair (Redis 互換)

  • 6: Container Registry

  • 8: Container Service for Kubernetes (ACK)

  • 9: Virtual Private Cloud (VPC)

  • 11: ActionTrail

  • 12: Alibaba Cloud CDN

  • 13: Certificate Management Service (旧 SSL Certificates Service)

  • 14: Apsara Devops

  • 16: Anti-DDoS

  • 17: Web Application Firewall (WAF)

  • 18: Object Storage Service (OSS)

  • 19: PolarDB

  • 20: ApsaraDB RDS for PostgreSQL

  • 21: Microservices Engine (MSE)

  • 22: Apsara File Storage NAS

  • 23: Data Security Center (DSC)

  • 24: Elastic IP Address (EIP)

  • 25: Identity as a Service - EIAM

  • 26: PolarDB-X

  • 27: Elasticsearch

0

AssetSubType

string

クラウドサービスのサブタイプ。 アセットタイプ-サブタイプ。有効な値:

  • 0: Elastic Compute Service (ECS)

    • 0: インスタンス

    • 1: ディスク (ストレージ)

    • 2: セキュリティグループ

  • 1: Server Load Balancer (SLB)

    • 0: Server Load Balancer

    • 1: Application Load Balancer

  • 3: ApsaraDB RDS

    • 0: インスタンス

  • 4: ApsaraDB for MongoDB

    • 0: インスタンス

  • 5: ApsaraDB for Tair (Redis 互換)

    • 0: インスタンス

  • 6: Container Registry

    • 1: Enterprise Edition

    • 2: Personal Edition

  • 8: Container Service for Kubernetes (ACK)

    • 0: クラスター

  • 9: Virtual Private Cloud (VPC)

    • 0: NAT Gateway

    • 1: EIP

    • 2: VPN

    • 3: FLOW_LOG

  • 11: ActionTrail

    • 0: トレイル

  • 12: Alibaba Cloud CDN

    • 0: インスタンス

  • 13: Certificate Management Service (旧 SSL Certificates Service)

    • 0: 証明書

  • 14: Apsara Devops

    • 0: 組織

  • 16: Anti-DDoS

    • 0: インスタンス

  • 17: Web Application Firewall (WAF)

    • 0: ドメイン名

  • 18: Object Storage Service (OSS)

    • 0: バケット

  • 19: PolarDB

    • 0: クラスター

  • 20: ApsaraDB RDS for PostgreSQL

    • 0: インスタンス

  • 21: Microservices Engine (MSE)

    • 0: クラスター

  • 22: Apsara File Storage NAS

    • 0: ファイルシステム

  • 23: Data Security Center (DSC)

    • 0: インスタンス

  • 24: Elastic IP Address (EIP)

    • 0: エニーキャスト EIP

  • 25: Identity as a Service - EIAM

    • 0: インスタンス

  • 26: PolarDB-X

    • 0: インスタンス

  • 27: Elasticsearch

    • 0: インスタンス

0

InstanceId

string

クラウドアセットインスタンスの ID。

d-uf60vevzkztnflx7cny5

InstanceName

string

アセットのインスタンス名。

yztest-l***

CreatedTime

integer

インスタンスが作成された時間。

1607365213000

InternetIp

string

インスタンスのパブリック IP アドレス。

1.2.XX.XX

AlarmStatus

string

クラウドアセットにセキュリティアラートがあるかどうかを示します。有効な値:

  • YES: セキュリティアラートが存在します。

  • NO: セキュリティアラートは存在しません。

NO

RiskStatus

string

クラウドアセットにセキュリティリスクがあるかどうかを示します。有効な値:

  • YES: 存在します。

  • NO: 存在しません。

NO

AssetTypeName

string

クラウドアセットタイプの名前。

ECS

AssetSubTypeName

string

クラウドアセットサブタイプの名前。

SECURITY_GROUP

SecurityInfo

string

クラウドアセットのセキュリティ情報。

{"seriousNum":0,"appNum":0,"baselineMedium":0,"remindNum":0,"imageVulNntf":0,"cveNum":0,"vul":0,"uuid":"yuejia-test","emgNum":0,"weakPWNum":0,"imageMaliciousFileRemind":0,"imageBaselineMedium":0,"laterVulCount":0,"cmsNum":0,"imageMaliciousFileSerious":0,"agentlessMalicious":0,"suspNum":0,"imageBaselineHigh":0,"asapVulCount":0,"imageVulLater":0,"agentlessAll":0,"sysNum":0,"containerLater":0,"containerSuspicious":0,"imageBaselineNum":0,"newSuspicious":0,"nntfVulCount":0,"scaNum":0,"containerNntf":0,"health":0,"trojan":0,"suspicious":0,"imageMaliciousFileSuspicious":0,"containerRemind":0,"baselineLow":0,"imageVulAsap":0,"imageBaselineLow":0,"containerAsap":0,"agentlessBaseline":0,"agentlessVulSca":0,"agentlessVulCve":0,"containerSerious":0,"baselineHigh":0,"account":0,"baselineNum":5}

Tags

array

タグリスト。

string

タグ。

AI

VendorUid

string

マルチクラウドインスタンスのアカウント ID。

123xxx

VendorUserName

string

マルチクラウドインスタンスのユーザー名。

testxxx

SaleCspm

integer

AssetUuid

string

SaleType

integer

成功レスポンス

JSONJSON

{
  "Success": true,
  "RequestId": "028CF634-5268-5660-9575-48C9ED6BF880",
  "PageInfo": {
    "CurrentPage": 2,
    "PageSize": 100,
    "TotalCount": 69,
    "Count": 20
  },
  "Instances": [
    {
      "RegionId": "cn-hanghzou",
      "Vendor": 0,
      "AssetType": 0,
      "AssetSubType": "0",
      "InstanceId": "d-uf60vevzkztnflx7cny5",
      "InstanceName": "yztest-l***",
      "CreatedTime": 1607365213000,
      "InternetIp": "1.2.XX.XX",
      "AlarmStatus": "NO",
      "RiskStatus": "NO",
      "AssetTypeName": "ECS",
      "AssetSubTypeName": "SECURITY_GROUP",
      "SecurityInfo": "{\"seriousNum\":0,\"appNum\":0,\"baselineMedium\":0,\"remindNum\":0,\"imageVulNntf\":0,\"cveNum\":0,\"vul\":0,\"uuid\":\"yuejia-test\",\"emgNum\":0,\"weakPWNum\":0,\"imageMaliciousFileRemind\":0,\"imageBaselineMedium\":0,\"laterVulCount\":0,\"cmsNum\":0,\"imageMaliciousFileSerious\":0,\"agentlessMalicious\":0,\"suspNum\":0,\"imageBaselineHigh\":0,\"asapVulCount\":0,\"imageVulLater\":0,\"agentlessAll\":0,\"sysNum\":0,\"containerLater\":0,\"containerSuspicious\":0,\"imageBaselineNum\":0,\"newSuspicious\":0,\"nntfVulCount\":0,\"scaNum\":0,\"containerNntf\":0,\"health\":0,\"trojan\":0,\"suspicious\":0,\"imageMaliciousFileSuspicious\":0,\"containerRemind\":0,\"baselineLow\":0,\"imageVulAsap\":0,\"imageBaselineLow\":0,\"containerAsap\":0,\"agentlessBaseline\":0,\"agentlessVulSca\":0,\"agentlessVulCve\":0,\"containerSerious\":0,\"baselineHigh\":0,\"account\":0,\"baselineNum\":5}",
      "Tags": [
        "AI"
      ],
      "VendorUid": "123xxx",
      "VendorUserName": "testxxx",
      "SaleCspm": 0,
      "AssetUuid": "",
      "SaleType": 0
    }
  ]
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 AccountIdNotExist AccountIdが存在しません
400 NoPermission 権限がありません
500 ServerError サーバーエラー
403 NoPermission 呼び出し元に権限がありません

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

変更履歴

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