すべてのプロダクト
Search

このプロダクト

    Security Center:DescribeCloudCenterInstances

    ドキュメントセンター

    Security Center:DescribeCloudCenterInstances

    最終更新日:Mar 21, 2026

    特定の検索条件に一致するアセットに関する情報をクエリします。たとえば、アセットのインスタンス名またはリージョンでアセットを検索できます。

    操作説明

    インスタンス ID、インスタンス名、VPC ID、リージョン、パブリック IP アドレスなどの検索条件を使用してアセットを検索できます。複数の検索条件間の論理関係を設定して、検索条件に一致するアセットを検索することもできます。

    今すぐお試しください

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

    get

    *Asset

    acs:yundun-sas:{#regionId}:{#accountId}:asset/*

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId deprecated

    string

    任意

    アセットが存在するリージョン ID。

    cn-hangzhou
    Criteria

    string

    任意

    検索条件。このパラメーターの値は JSON 形式で、大文字と小文字が区別されます。

    説明

    インスタンス ID、インスタンス名、VPC ID、リージョン、パブリック IP アドレスなどの検索条件を使用してアセットを検索できます。DescribeCriteria 操作を呼び出して、サポートされている検索条件をクエリできます。

    [{"name":"riskStatus","value":"YES"},{"name":"internetIp","value":"1.2.XX.XX"}]
    MachineTypes

    string

    任意

    クエリするアセットのタイプ。値は次のとおりです。

    • ecs：サーバー

    • cloud_product：クラウドプロダクト

    • eci：Elastic Container Instance (ECI)

    • rund：RunD コンテナインスタンス

    • runc：RunC コンテナインスタンス

    ecs
    LogicalExp

    string

    任意

    複数の検索条件間の論理関係。有効な値は次のとおりです。

    • OR：検索条件間の論理関係は OR です。

    • AND：検索条件間の論理関係は AND です。

    OR
    PageSize

    integer

    任意

    各ページで返すエントリ数。デフォルト値：20。

    100
    CurrentPage

    integer

    任意

    返すページ番号。デフォルト値：1。

    1
    Importance

    integer

    任意

    アセットの重要度。有効な値は次のとおりです。

    • 2：重要アセット

    • 1：一般アセット

    • 0：テストアセット

    2
    NoGroupTrace

    boolean

    任意

    デフォルトグループの名前を国際化するかどうかを指定します。有効な値は次のとおりです。

    • true：システムは GroupTrace レスポンスパラメーターに対してデフォルトグループの中国語名を返します。

    • false：システムは GroupTrace レスポンスパラメーターに対して default を返します。

    false
    Lang

    string

    任意

    リクエストと応答内のコンテンツの言語。デフォルト値：zh。有効な値は次のとおりです。

    • zh：中国語

    • en：英語

    zh
    UseNextToken

    boolean

    任意

    NextToken メソッドを使用して結果の新しいページを取得するかどうかを指定します。UseNextToken を true に設定した場合、TotalCount の値は返されません。有効な値は次のとおりです。

    • true：NextToken メソッドが使用されます。

    • false：NextToken メソッドは使用されません。

    false
    NextToken

    string

    任意

    NextToken メソッドが使用されるときに返される NextToken の値。最初のリクエストではこのパラメーターを指定する必要はありません。

    E17B501887A2D3AA5E8360A6EFA3B***
    ResourceDirectoryAccountId

    integer

    任意

    リソースディレクトリ内のメンバーの Alibaba Cloud アカウント ID。

    説明

    DescribeMonitorAccounts 操作を呼び出して ID を取得できます。

    1232428423234****
    Flags

    string

    任意

    アセットベンダー。複数のアセットベンダーはコンマ (,) で区切る必要があります。値は次のとおりです。

    • 0：Alibaba Cloud が提供するアセット

    • 1：Alibaba Cloud 外部のアセット

    • 2：データセンター内のアセット

    • 3、4、5、7、14、16：サードパーティのクラウドサービスプロバイダーのアセット

    • 8：軽量アセット

    • 9：Serverless App Engine (SAE) インスタンス

    • 10：Platform for AI (PAI) のインスタンス

    1,2,3

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    Success

    boolean

    呼び出しが成功したかどうかを示します。有効な値は次のとおりです。

    • true：呼び出しは成功です。

    • false：呼び出しは失敗です。

    true
    RequestId

    string

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

    32A73759-4C0F-4801-BE98-901223ACEE9A
    PageInfo

    object

    ページネーション情報。

    CurrentPage

    integer

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

    1
    PageSize

    integer

    ページごとに返されるエントリ数。デフォルト値：20。

    20
    TotalCount

    integer

    返されたエントリの総数。

    50
    Count

    integer

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

    10
    NextToken

    string

    NextToken メソッドが使用されるときに返される NextToken の値。

    B604532DEF982B875E8360A6EFA3B***
    Instances

    array<object>

    アセットに関する詳細。

    object

    アセットに関する詳細。

    Status

    string

    アセットのステータス。有効な値は次のとおりです。

    • Running：実行中

    • notRunning：停止

    Running
    CpuInfo

    string

    アセットの CPU 情報。

    Intel(R) Xeon(R) Platinum 8269CY CPU @ 2.50GHz
    InternetIp

    string

    アセットのパブリック IP アドレス。

    1.2.XX.XX
    Kernel

    string

    カーネルのバージョン。

    3.10.0-1127.19.1.el7.x86_64
    Bind

    boolean

    Security Center がアセットをスキャンする権限を持っているかどうかを示します。有効な値は次のとおりです。

    • true：Security Center はアセットをスキャンする権限を持っています。

    • false：Security Center はアセットをスキャンする権限を持っていません。

    true
    OsName

    string

    アセットのカーネルバージョン。

    -
    Tag

    string

    アセットタグの名前。

    InternetIp,test
    ClientStatus

    string

    アセットにインストールされている Security Center エージェントのステータス。有効な値は次のとおりです。

    • online：Security Center エージェントは有効です。

    • offline：Security Center エージェントは無効です。

    • pause：Security Center エージェントは一時停止しています。

    online
    Mem

    integer

    メモリのサイズ。単位：MB。

    1024
    VpcInstanceId

    string

    アセットが属する VPC の ID。

    vpc-uf60agqq65bs98zoo****
    TagId

    string

    アセットタグの ID。

    121313,41412
    Flag

    integer

    アセットが Alibaba Cloud アセットであるかどうかを示します。有効な値は次のとおりです。

    • 0：アセットは Alibaba Cloud アセットです。

    • 1：アセットは Alibaba Cloud アセットではありません。

    0
    LastLoginTimestamp

    integer

    Security Center エージェントが最後にオンラインだったときのタイムスタンプ。単位：ミリ秒。

    1637592907000
    AuthVersion

    integer

    アセットをスキャンする権限を持つ Security Center のエディション。有効な値は次のとおりです。

    • 1：Basic エディション

    • 6：ウイルス対策版

    • 5：Advanced エディション

    • 3：Enterprise エディション

    • 7：Ultimate エディション

    • 10：付加価値プラン版

    1
    Region

    string

    アセットのリージョン ID。

    cn-hangzhou-cm***-***
    InstanceName

    string

    アセットの名前。

    yztest-l***
    PodCount

    integer

    Pod の数。

    1
    VulCount

    integer

    アセットで検出された脆弱性の数。

    2
    HcStatus

    string

    アセットでベースラインリスクが検出されたかどうかを示します。有効な値は次のとおりです。

    • YES

    • NO

    YES
    CreatedTime

    integer

    クラスターが作成されたときのタイムスタンプ。単位：ミリ秒。

    1607365213000
    GroupTrace

    string

    アセットが属するグループの名前。

    default
    ClusterId

    string

    クラスターの ID。

    c690a0789419f4284a4e0a29e12fe****
    RiskStatus

    string

    アセットでリスクが検出されたかどうかを示します。有効な値は次のとおりです。

    • YES

    • NO

    NO
    Cores

    integer

    アセットが使用する CPU コアの数。

    4
    VulStatus

    string

    アセットで脆弱性が検出されたかどうかを示します。有効な値は次のとおりです。

    • YES

    • NO

    YES
    AlarmStatus

    string

    アセットでアラートが生成されたかどうかを示します。有効な値は次のとおりです。

    • YES

    • NO

    NO
    MacListString

    string

    システムの MAC アドレス。

    00:13:3e:31:13:39,02:12:67:b8:**:**
    Importance

    integer

    アセットの重要度。有効な値は次のとおりです。

    • 2：重要アセット

    • 1：一般アセット

    • 0：テストアセット

    2
    HealthCheckCount

    integer

    アセットで検出されたベースラインリスクの数。

    1
    Ip

    string

    アセットのパブリック IP アドレス。

    1.2.XX.XX
    Os

    string

    アセットのオペレーティングシステム。

    Linux
    AuthModifyTime

    integer

    Security Center がアセットをスキャンする権限を付与されたときのタイムスタンプ。

    1627974044000
    SafeEventCount

    integer

    アセットで生成されたアラートの数。

    5
    InstanceId

    string

    アセットの ID。

    i-m5***
    AssetType

    string

    アセットのタイプ。有効な値は次のとおりです。

    • 0：ECS インスタンス

    • 1：Server Load Balancer (SLB) インスタンス

    • 2：ネットワークアドレス変換 (NAT) ゲートウェイ

    • 3：ApsaraDB RDS インスタンス

    • 4：ApsaraDB for MongoDB インスタンス

    • 5：ApsaraDB for Redis インスタンス

    • 6：コンテナイメージ

    • 7：コンテナ

    0
    IntranetIp

    string

    アセットのプライベート IP アドレス。

    1.2.XX.XX
    Vendor

    integer

    アセットベンダー。値は次のとおりです。

    • 0：Alibaba Cloud が提供するアセット

    • 1：Alibaba Cloud 外部のアセット

    • 2：データセンター内のアセット

    • 3、4、5、7、14、16：サードパーティのクラウドサービスプロバイダーのアセット

    • 8：軽量アセット

    • 9：Serverless App Engine (SAE) インスタンス

    • 10：Platform for AI (PAI) のインスタンス

    0
    RegionId

    string

    アセットが存在するリージョン ID。

    cn-hanghzou
    Uuid

    string

    アセットの UUID。

    c9107c04-942f-40c1-981a-f1c1***
    GroupId

    integer

    アセットが属するアセットグループの ID。

    4120080
    RegionName

    string

    アセットが存在するリージョンの名前。

    China (Hangzhou)
    VendorName

    string

    アセットのサービスプロバイダーの名前。 値は次のとおりです。

    • ALIYUN：Alibaba Cloud

    • OUT：サードパーティのサービスプロバイダー

    • IDC：データセンター内のアセット

    • TENCENT：Tencent Cloud

    • HUAWEICLOUD：Huawei Cloud

    • Microsoft：Microsoft Azure

    • AWS：Amazon Web Services (AWS)

    • TRIPARTITE：軽量サーバー

    • SAE：Serverless App Engine (SAE) インスタンス

    • PAI：Platform for AI (PAI) のインスタンス

    • VOLCENGINE：VOLCENGINE Cloud

    • google：GOOGLE Cloud

    IDC
    AuthVersionName

    string

    アセットを保護する権限を持つ Security Center エディションの名前。有効な値は次のとおりです。

    • Basic エディション

    • ウイルス対策版

    • Advanced エディション

    • Enterprise エディション

    • Ultimate エディション

    Ultimate Edition
    ClusterName

    string

    クラスターの名前。

    cluster1
    ExposedStatus

    integer

    アセットが公開されているかどうかを示します。有効な値は次のとおりです。

    • 0：アセットは公開されていません。

    • 1：アセットは公開されています。

    0
    RiskCount

    string

    アセットで検出されたベースラインリスクの総数。このパラメーターの値は JSON 形式で、次のフィールドが含まれます。

    • account：承認されていない場所からログインし、パスワードがクラックされたアカウントの数

    • appNum：スキャナーの数

    • asapVulCount：高深刻度の脆弱性の総数

    • baselineHigh：高リスクのベースラインリスクの数

    • baselineLow：低リスクのベースラインリスクの数

    • baselineMedium：中リスクのベースラインリスクの数

    • baselineNum：ベースラインリスクの総数

    • cmsNum：Web-CMS 脆弱性の数

    • containerAsap：コンテナで検出された高深刻度の脆弱性の数

    • containerLater：コンテナで検出された中深刻度の脆弱性の数

    • containerNntf：コンテナで検出された低深刻度の脆弱性の数

    • containerRemind：コンテナで緊急度レベルが「注意」のアラートの数

    • containerSerious：コンテナで緊急度レベルが「緊急」のアラートの数

    • containerSuspicious：コンテナで緊急度レベルが「疑わしい」のアラートの数

    • cveNum：Linux ソフトウェア脆弱性の数

    • emgNum：緊急の脆弱性の数

    • health：未処理のベースラインアラートの数

    • imageBaselineHigh：イメージで検出された高リスクのベースラインリスクの数

    • imageBaselineLow：イメージで検出された低リスクのベースラインリスクの数

    • imageBaselineMedium：イメージで検出された中リスクのベースラインリスクの数

    • imageBaselineNum：イメージで検出されたベースラインリスクの総数

    • imageMaliciousFileRemind：イメージで検出され、緊急度レベルが「注意」の悪意のあるファイルの数

    • imageMaliciousFileSerious：イメージで検出され、緊急度レベルが「緊急」の悪意のあるファイルの数

    • imageMaliciousFileSuspicious：イメージで検出され、緊急度レベルが「疑わしい」の悪意のあるファイルの数

    • imageVulAsap：イメージで検出された高深刻度の脆弱性の数

    • imageVulLater：イメージで検出された中深刻度の脆弱性の数

    • imageVulNntf：イメージで検出された低深刻度の脆弱性の数

    • laterVulCount：中深刻度の脆弱性の数

    • newSuspicious：アラートの数

    • nntfVulCount：低深刻度の脆弱性の数。

    • remindNum：緊急度レベルが「注意」のアラートの数

    • scaNum：ソフトウェアコンポーネント分析に基づいて検出された脆弱性の数

    • seriousNum：緊急度レベルが「緊急」のアラートの数

    • suspNum：緊急度レベルが「疑わしい」のアラートの数

    • suspicious：アラートの総数

    • sysNum：Windows システム脆弱性の数

    • trojan：トロイの木馬の数

    • uuid：アセットの UUID

    • vul：脆弱性の数

    • weakPWNum：弱いパスワードの数

    { "account": 0, "appNum": 0, "asapVulCount": 0, "baselineHigh": 0, "baselineLow": 0, "baselineMedium": 0, "baselineNum": 0, "cmsNum": 0, "containerAsap": 0, "containerLater": 0, "containerNntf": 0, "containerRemind": 0, "containerSerious": 0, "containerSuspicious": 0, "cveNum": 0, "emgNum": 0, "health": 0, "imageBaselineHigh": 0, "imageBaselineLow": 0, "imageBaselineMedium": 0, "imageBaselineNum": 0, "imageMaliciousFileRemind": 0, "imageMaliciousFileSerious": 0, "imageMaliciousFileSuspicious": 0, "imageVulAsap": 0, "imageVulLater": 0, "imageVulNntf": 0, "laterVulCount": 0, "newSuspicious": 0, "nntfVulCount": 0, "remindNum": 0, "scaNum": 0, "seriousNum": 0, "suspNum": 0, "suspicious": 0, "sysNum": 0, "trojan": 0, "uuid": "inet-37316411-37fe-4b72-b245-346a2721****", "vul": 0, "weakPWNum": 0 }
    IpListString

    string

    システムの IP アドレス。

    172.31.XX.XX,172.171.XX.XX
    AssetTypeName

    string

    アセットタイプの名前。

    Elastic Compute Service
    FlagName

    string

    アセットベンダー。値は次のとおりです。

    • ALIYUN

    • OUT

    • IDC

    • Tencent

    • HUAWEICLOUD

    • Azure

    • AWS

    • ASK

    • TRIPARTITE

    • SAE

    • PAI

    • google

    • VOLCENGINE

    ASK
    AppId

    string

    アプリケーションの ID。

    説明

    このパラメーターは、Vendor パラメーターが 9 に設定されている場合にのみ使用できます。

    test
    AppName

    string

    アプリケーションの名前。

    説明

    このパラメーターは、Vendor パラメーターが 9 に設定されている場合にのみ使用できます。

    testAppName
    ClientSubStatus

    string

    アセットにインストールされている Security Center エージェントのサブステータス。有効な値は次のとおりです。

    • online：Security Center エージェントは有効です。

    • offline：Security Center エージェントは無効です。

    • pause：Security Center エージェントは一時停止しています。

    • uninstalled：Security Center エージェントはアンインストールされています。

    • stopped：Security Center エージェントは停止しています。

    online
    TagResources

    string

    Lingjun ノードに追加されたカスタムタグ。このパラメーターは LINGJUN GPU インスタンスに対してのみ返されます。

    app:test,type:lingjun
    PostPaidFlag

    integer

    現在アセットにバインドされている保護バージョンの課金方法。値は次のとおりです。- 0：サブスクリプション - 1：従量課金

    0
    HasContainer

    string

    コンテナが含まれているかどうかを示します。有効な値は次のとおりです。

    • YES：はい。

    • NO：いいえ。

    YES
    ServiceId

    string

    サービス ID。PAI インスタンスでのみ使用可能です。

    dsw-76jlywunsif09bp15p
    VendorUid

    string

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

    123
    VendorUserName

    string

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

    VendorUserName
    Namespace

    string

    名前空間。

    crm-test
    BindFileProtectType

    string

    改ざん防止の権限付与をバインドするかどうか。値は次のとおりです。

    • block：はい

    • none：いいえ

    block

    例

    成功レスポンス

    JSONJSON

    {
  "Success": true,
  "RequestId": "32A73759-4C0F-4801-BE98-901223ACEE9A",
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 20,
    "TotalCount": 50,
    "Count": 10,
    "NextToken": "B604532DEF982B875E8360A6EFA3B***"
  },
  "Instances": [
    {
      "Status": "Running",
      "CpuInfo": "Intel(R) Xeon(R) Platinum 8269CY CPU @ 2.50GHz",
      "InternetIp": "1.2.XX.XX",
      "Kernel": "3.10.0-1127.19.1.el7.x86_64",
      "Bind": true,
      "OsName": "-",
      "Tag": "InternetIp,test",
      "ClientStatus": "online",
      "Mem": 1024,
      "VpcInstanceId": "vpc-uf60agqq65bs98zoo****",
      "TagId": "121313,41412",
      "Flag": 0,
      "LastLoginTimestamp": 1637592907000,
      "AuthVersion": 1,
      "Region": "cn-hangzhou-cm***-***",
      "InstanceName": "yztest-l***",
      "PodCount": 1,
      "VulCount": 2,
      "HcStatus": "YES",
      "CreatedTime": 1607365213000,
      "GroupTrace": "default",
      "ClusterId": "c690a0789419f4284a4e0a29e12fe****",
      "RiskStatus": "NO",
      "Cores": 4,
      "VulStatus": "YES",
      "AlarmStatus": "NO",
      "MacListString": "00:13:3e:31:13:39,02:12:67:b8:**:**",
      "Importance": 2,
      "HealthCheckCount": 1,
      "Ip": "1.2.XX.XX",
      "Os": "Linux",
      "AuthModifyTime": 1627974044000,
      "SafeEventCount": 5,
      "InstanceId": "i-m5***",
      "AssetType": "0",
      "IntranetIp": "1.2.XX.XX",
      "Vendor": 0,
      "RegionId": "cn-hanghzou",
      "Uuid": "c9107c04-942f-40c1-981a-f1c1***",
      "GroupId": 4120080,
      "RegionName": "China (Hangzhou)",
      "VendorName": "IDC",
      "AuthVersionName": "Ultimate Edition",
      "ClusterName": "cluster1",
      "ExposedStatus": 0,
      "RiskCount": "{\n      \"account\": 0,\n      \"appNum\": 0,\n      \"asapVulCount\": 0,\n      \"baselineHigh\": 0,\n      \"baselineLow\": 0,\n      \"baselineMedium\": 0,\n      \"baselineNum\": 0,\n      \"cmsNum\": 0,\n      \"containerAsap\": 0,\n      \"containerLater\": 0,\n      \"containerNntf\": 0,\n      \"containerRemind\": 0,\n      \"containerSerious\": 0,\n      \"containerSuspicious\": 0,\n      \"cveNum\": 0,\n      \"emgNum\": 0,\n      \"health\": 0,\n      \"imageBaselineHigh\": 0,\n      \"imageBaselineLow\": 0,\n      \"imageBaselineMedium\": 0,\n      \"imageBaselineNum\": 0,\n      \"imageMaliciousFileRemind\": 0,\n      \"imageMaliciousFileSerious\": 0,\n      \"imageMaliciousFileSuspicious\": 0,\n      \"imageVulAsap\": 0,\n      \"imageVulLater\": 0,\n      \"imageVulNntf\": 0,\n      \"laterVulCount\": 0,\n      \"newSuspicious\": 0,\n      \"nntfVulCount\": 0,\n      \"remindNum\": 0,\n      \"scaNum\": 0,\n      \"seriousNum\": 0,\n      \"suspNum\": 0,\n      \"suspicious\": 0,\n      \"sysNum\": 0,\n      \"trojan\": 0,\n      \"uuid\": \"inet-37316411-37fe-4b72-b245-346a2721****\",\n      \"vul\": 0,\n      \"weakPWNum\": 0\n}",
      "IpListString": "172.31.XX.XX,172.171.XX.XX",
      "AssetTypeName": "Elastic Compute Service",
      "FlagName": "ASK",
      "AppId": "test",
      "AppName": "testAppName",
      "ClientSubStatus": "online",
      "TagResources": "app:test,type:lingjun",
      "PostPaidFlag": 0,
      "HasContainer": "YES",
      "ServiceId": "dsw-76jlywunsif09bp15p",
      "VendorUid": "123",
      "VendorUserName": "VendorUserName",
      "Namespace": "crm-test",
      "BindFileProtectType": "block"
    }
  ]
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    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

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

    変更履歴

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