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

Security Center:ListCloudAssetInstances

最終更新日:Sep 07, 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

*すべてのリソース。

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

RegionId

string

任意

インスタンスのリージョン ID。

cn-hangzhou

Criteria

string

任意

アセットの検索条件。このパラメーターは JSON フォーマットで、次のフィールドが含まれます。

  • name: 検索項目。

  • value: 検索項目の値。

  • logicalExp: 複数の検索項目の値の論理関係。有効な値:
    • OR: 検索項目の値は OR 演算子を使用して評価されます。

    • AND: 検索項目の値は AND 演算子を使用して評価されます。

説明

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

[{"name":"internetIp","値":"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 アセット

  • 3, 4, 5, 7: サードパーティクラウドアセット

  • 8: 軽量アセット

0

CloudAssetQueryData

array<object>

任意

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

object

任意

Data

string

任意

照会内容。

163.8.8.9

Operator

string

任意

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

INCLUDE

IsSaleData

boolean

任意

販売関連データを返すかどうかを指定します。有効な値:

  • true: 販売関連データを返します。

  • false: 販売関連データを返しません。

ResourceDirectoryAccountId

integer

任意

リソースフォルダのメンバーアカウントの Alibaba Cloud アカウントの ID。

説明

このパラメーターを取得するには、 DescribeMonitorAccounts 操作を呼び出します。

レスポンスフィールド

フィールド

説明

object

Success

boolean

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

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

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

true

RequestId

string

リクエスト ID。Alibaba Cloud によってリクエストに対して生成される一意の識別子です。この ID を使用して問題のトラブルシューティングを実行できます。

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 アセット

  • 3, 4, 5, 7: サードパーティクラウドアセット

  • 8: 軽量アセット

0

AssetType

integer

アセットタイプ (検索)。有効な値:

  • 0: Elastic Compute Service (ECS) サーバー

  • 1: Server Load Balancer (SLB)

  • 3: ApsaraDB RDS データベース

  • 4: ApsaraDB for MongoDB データベース

  • 5: Tair (Redis® OSS-Compatible) データベース

  • 6: Container Registry

  • 8: Container Service for Kubernetes (ACK)

  • 9: Virtual Private Cloud (VPC)

  • 11: ActionTrail

  • 12: CDN

  • 13: 証明書管理サービス (旧 SSL 証明書サービス)

  • 14: Apsara DevOps

  • 16: Anti-DDoS (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: Alibaba Cloud IDaaS EIAM

  • 26: PolarDB-X

  • 27: Elasticsearch

0

AssetSubType

string

クラウドサービスのサブタイプ。値は「アセットタイプ - サブタイプ」のフォーマットです (検索)。有効な値:

  • 0: Elastic Compute Service (ECS) サーバー

    • 0: インスタンス

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

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

  • 1: Server Load Balancer (SLB)

    • 0: Classic Load Balancer (CLB)

    • 1: Application Load Balancer (ALB)

  • 3: ApsaraDB RDS データベース

    • 0: インスタンス

  • 4: ApsaraDB for MongoDB データベース

    • 0: インスタンス

  • 5: Tair (Redis® OSS-Compatible) データベース

    • 0: インスタンス

  • 6: Container Registry

    • 1: Enterprise Edition

    • 2: Personal エディション

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

    • 0: インスタンス

  • 13: 証明書管理サービス (旧 SSL 証明書サービス)

    • 0: 証明書

  • 14: Apsara DevOps

    • 0: 組織

  • 16: Anti-DDoS (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: Alibaba Cloud IDaaS EIAM

    • 0: インスタンス

  • 26: PolarDB-X

    • 0: インスタンス

  • 27: Elasticsearch

    • 0: インスタンス

0

InstanceId

string

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

d-uf60vevzkztnflx7cny5

InstanceName

string

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

yztest-l***

CreatedTime

integer

インスタンスが作成された時間。値はミリ秒単位の UNIX タイムスタンプです。

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,"コンテナLater":0,"コンテナSuspicious":0,"imageBaselineNum":0,"newSuspicious":0,"nntfVulCount":0,"scaNum":0,"コンテナNntf":0,"health":0,"trojan":0,"suspicious":0,"imageMaliciousFileSuspicious":0,"コンテナRemind":0,"baselineLow":0,"imageVulAsap":0,"imageBaselineLow":0,"コンテナAsap":0,"agentlessBaseline":0,"agentlessVulSca":0,"agentlessVulCve":0,"コンテナSerious":0,"baselineHigh":0,"アカウント":0,"baselineNum":5}

Tags

array

タグのリスト。

string

タグ。

AI

VendorUid

string

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

123xxx

VendorUserName

string

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

testxxx

SaleCspm

integer

Cloud Security Posture Management (CSPM) の販売識別子。

AssetUuid

string

アセットの UUID。

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 not exist
400 NoPermission no permission
400 RdCheckNoPermission Resource directory account verification has no permission.
500 ServerError ServerError
500 RdCheckInnerError Resource directory account service internal error.
403 NoPermission caller has no permission

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

変更履歴

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