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

Security Center:ListCloudAssetInstances

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

get

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

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 操作を呼び出して、クラウドアセットのタイプを照会できます。

18

AssetSubType

integer

任意

クラウドアセットのサブタイプです。

GetCloudAssetCriteria 操作を呼び出して、クラウドアセットのサブタイプを照会できます。

0

Vendor

integer

任意

サーバータイプです。有効な値は以下のとおりです。

  • 0:Alibaba Cloud が提供するクラウドアセット

  • 1:Alibaba Cloud 外部のクラウドアセット

  • 2:データセンター内のクラウドアセット

  • 345、および 7:サードパーティのサービスプロバイダが提供するクラウドアセット

  • 8:軽量クラウドアセット

0

CloudAssetQueryData

array<object>

任意

キーワードに基づくクエリデータリストです。

object

任意

Data

string

任意

クエリ内容です。

163.8.8.9

Operator

string

任意

クエリ演算子です。現在、INCLUDE のみをサポートしています。

INCLUDE

レスポンスフィールド

フィールド

説明

object

Success

boolean

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

  • true:リクエストが成功しました。

  • false:リクエストが失敗しました。

true

RequestId

string

問題の特定とトラブルシューティングに使用されるリクエスト ID です。

028CF634-5268-5660-9575-48C9ED6BF880

PageInfo

object

ページネーション情報です。

CurrentPage

integer

返されたページのページ番号です。

2

PageSize

integer

1 ページあたりに返されるエントリ数です。

100

TotalCount

integer

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

69

Count

integer

現在のページに返されるエントリ数です。

20

Instances

array<object>

クラウドアセットの詳細です。

object

クラウドアセットの詳細です。

RegionId

string

クラウドアセットが属するリージョンの ID です。

cn-hanghzou

Vendor

integer

クラウドアセットのサービスプロバイダ (SP) です。有効な値は以下のとおりです。

  • 0:Alibaba Cloud が提供するクラウドアセット

  • 1:サードパーティのクラウドアセット

  • 2:データセンター内のクラウドアセット

  • 345、および 7:その他のクラウドアセット

  • 8:軽量クラウドアセット

0

AssetType

integer

クラウドアセットのタイプです。有効な値は以下のとおりです。

  • 0:Elastic Compute Service (ECS)

  • 1:Server Load Balancer (SLB)

  • 3:ApsaraDB RDS

  • 4:ApsaraDB for MongoDB

  • 5:ApsaraDB for 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:File Storage NAS (NAS)

  • 23:Data Security Center (DSC)

  • 24:Elastic IP Address (EIP)

  • 25:Identity as a Service (IDaaS) Employee Identity and Access Management (EIAM)

  • 26:PolarDB-X

  • 27:Elasticsearch

0

AssetSubType

string

クラウドサービスのサブタイプです。クラウドアセットのサブタイプです。有効な値は以下のとおりです。

  • 0:ECS

    • 0:インスタンス

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

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

  • 1:SLB

    • 0:SLB

    • 1:Application Load Balancer (ALB)

  • 3:ApsaraDB RDS

    • 0:インスタンス

  • 4:ApsaraDB for MongoDB

    • 0:インスタンス

  • 5:ApsaraDB for Redis

    • 0:インスタンス

  • 6:Container Registry

    • 1:Enterprise Edition

    • 2:Personal Edition

  • 8:ACK

    • 0:クラスター

  • 9:VPC

    • 0:NAT ゲートウェイ

    • 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:WAF

    • 0:ドメイン名

  • 18:OSS

    • 0:バケット

  • 19:PolarDB

    • 0:クラスター

  • 20:ApsaraDB RDS for PostgreSQL

    • 0:インスタンス

  • 21:MSE

    • 0:クラスター

  • 22:NAS

    • 0:ファイルシステム

  • 23:DSC

    • 0:インスタンス

  • 24:EIP

    • 0:Anycast EIP

  • 25:IDaaS 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

成功レスポンス

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"
    }
  ]
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 AccountIdNotExist AccountId not exist
400 NoPermission no permission
500 ServerError ServerError
403 NoPermission caller has no permission

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

変更履歴

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