All Products
Search

This Product

    Security Center:DescribeCloudCenterInstances

    Document Center

    Security Center:DescribeCloudCenterInstances

    Last Updated:Jul 09, 2026

    Menetapkan kondisi pencarian untuk melakukan kueri bersyarat terhadap informasi aset yang sesuai dengan kriteria tertentu, seperti nama Instans aset atau Wilayah Instans aset. Metode paginasi dan NextToken didukung. Metode NextToken direkomendasikan.

    Deskripsi operasi

    Anda dapat mencari aset berdasarkan ID instans, nama instans, ID VPC, wilayah, alamat IP publik, dan kondisi lainnya. Anda juga dapat menetapkan hubungan logis antara berbagai kondisi pencarian untuk mencari aset yang memenuhi beberapa kriteria.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId deprecated

    string

    No

    ID wilayah tempat instans berada.

    cn-hangzhou
    Criteria

    string

    No

    Kondisi pencarian untuk aset. Parameter ini dalam format JSON. Perhatikan bahwa nama parameter peka terhadap huruf besar/kecil.

    Catatan

    Anda dapat mencari aset berdasarkan ID instans, nama instans, ID VPC, wilayah, alamat IP publik, dan kondisi lainnya. Panggil operasi DescribeCriteria untuk mengkueri kondisi pencarian yang didukung.

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

    string

    No

    Tipe aset yang akan dikueri. Nilai valid:

    • ecs: server

    • cloud_product: produk cloud

    • eci: elastic container instance

    • rund: RunD Kontainer Instans

    • runc: RunC Kontainer Instans

    ecs
    LogicalExp

    string

    No

    Hubungan logis antara beberapa kondisi pencarian. Nilai default: OR. Nilai valid:

    • OR: Kondisi pencarian memiliki hubungan OR.

    • AND: Kondisi pencarian memiliki hubungan AND.

    OR
    PageSize

    integer

    No

    Jumlah entri per halaman dalam kueri berpaginasi. Nilai default: 20.

    100
    CurrentPage

    integer

    No

    Nomor halaman dari halaman pertama yang dikembalikan. Nilai default: 1.

    1
    Importance

    integer

    No

    Tingkat kepentingan aset. Nilai valid:

    • 2: aset penting

    • 1: aset umum

    • 0: aset uji coba

    2
    NoGroupTrace

    boolean

    No

    Apakah akan melewatkan pemrosesan internasionalisasi untuk kelompok default Ungrouped di Pusat Keamanan. Nilai default: false. Nilai valid:

    • true: Pemrosesan internasionalisasi dilewati. Ketika nilai parameter respons GroupTrace adalah kelompok default Pusat Keamanan Ungrouped, itu ditampilkan sebagai 未分组.

    • false: Pemrosesan internasionalisasi diterapkan. Ketika nilai parameter respons GroupTrace adalah kelompok default Pusat Keamanan Ungrouped, itu ditampilkan sebagai default.

    false
    Lang

    string

    No

    Bahasa permintaan dan tanggapan. Nilai default: zh. Nilai valid:

    • zh: Bahasa Tionghoa

    • en: Bahasa Inggris

    zh
    UseNextToken

    boolean

    No

    Apakah akan menggunakan metode NextToken untuk mengambil data daftar aset. Jika parameter ini diatur ke true, TotalCount tidak lagi dikembalikan. Nilai valid:

    • true: Menggunakan metode NextToken.

    • false: Tidak menggunakan metode NextToken.

    false
    NextToken

    string

    No

    Nilai NextToken yang dikembalikan saat metode NextToken digunakan. Biarkan parameter ini kosong untuk permintaan pertama.

    E17B501887A2D3AA5E8360A6EFA3B***
    ResourceDirectoryAccountId

    integer

    No

    ID akun Alibaba Cloud dari akun anggota dalam folder Sumber daya.

    Catatan

    Panggil operasi DescribeMonitorAccounts untuk mendapatkan parameter ini.

    1232428423234****
    Flags

    string

    No

    Vendor aset. Pisahkan beberapa vendor dengan koma (,). Nilai valid:

    • 0: Aset Alibaba Cloud

    • 1: Aset non-cloud

    • 2: Aset IDC

    • 3, 4, 5, 7, 14, 16: Aset cloud pihak ketiga

    • 8: Aset ringan

    • 9: SAE

    • 10: PAI

    1,2,3

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Success

    boolean

    Indikator apakah panggilan berhasil. Nilai valid:

    • true: Panggilan berhasil.

    • false: Panggilan gagal.

    true
    RequestId

    string

    ID permintaan, yaitu pengidentifikasi unik yang dihasilkan oleh Alibaba Cloud untuk permintaan tersebut. Anda dapat menggunakan ID ini untuk memecahkan masalah.

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

    object

    Informasi paginasi.

    CurrentPage

    integer

    Nomor halaman dari halaman saat ini dalam kueri berpaginasi.

    1
    PageSize

    integer

    Jumlah entri per halaman dalam kueri berpaginasi. Nilai default: 20.

    20
    TotalCount

    integer

    Jumlah total aset yang dikembalikan.

    50
    Count

    integer

    Jumlah aset pada halaman saat ini.

    10
    NextToken

    string

    Nilai NextToken yang dikembalikan saat metode NextToken digunakan.

    B604532DEF982B875E8360A6EFA3B***
    Instances

    array<object>

    Daftar detail aset.

    object

    Detail aset.

    Status

    string

    Status berjalan instans. Nilai valid:

    • Running: Berjalan.

    • notRunning: Dihentikan.

    Running
    CpuInfo

    string

    Informasi CPU aset.

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

    string

    Alamat IP publik instans.

    1.2.XX.XX
    Kernel

    string

    Informasi versi kernel.

    3.10.0-1127.19.1.el7.x86_64
    Bind

    boolean

    Apakah aset terikat dengan otorisasi. Nilai valid:

    • true: Terikat.

    • false: Tidak terikat.

    true
    OsName

    string

    Versi kernel instans.

    -
    Tag

    string

    Nama tag instans aset.

    InternetIp,test
    ClientStatus

    string

    Status online klien pada instans. Nilai valid:

    • online: Online. Status klien Agen adalah Enabled.

    • offline: Offline. Status klien Agen adalah Disabled.

    • pause: Dijeda. Status klien Agen adalah Protection Paused.

    online
    Mem

    integer

    Ukuran memori, dalam MB.

    1024
    VpcInstanceId

    string

    ID VPC tempat instans berada.

    vpc-uf60agqq65bs98zoo****
    TagId

    string

    ID tag aset.

    121313,41412
    Flag

    integer

    Apakah instans merupakan aset Alibaba Cloud. Nilai valid:

    • 0: Aset Alibaba Cloud

    • 1: Aset non-Alibaba Cloud

    0
    LastLoginTimestamp

    integer

    Stempel waktu saat klien terakhir kali online. Unit: milidetik.

    1637592907000
    AuthVersion

    integer

    Versi otorisasi aset. Nilai valid:

    • 1: Edisi Gratis

    • 6: Edisi Anti-virus

    • 5: Advanced

    • 3: Edisi Perusahaan

    • 7: Edisi Ultimate

    • 1: Edisi Gratis

    • 6: Edisi Anti-virus

    • 5: Advanced

    • 3: Edisi Perusahaan

    • 7: Edisi Ultimate

    1
    Region

    string

    ID wilayah tempat instans berada.

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

    string

    Nama instans.

    yztest-l***
    PodCount

    integer

    Jumlah pod.

    1
    VulCount

    integer

    Jumlah kerentanan pada instans.

    2
    HcStatus

    string

    Apakah risiko garis dasar terdeteksi pada instans. Nilai valid:

    • YES: Risiko garis dasar terdeteksi.

    • NO: Tidak ada risiko garis dasar yang terdeteksi.

    YES
    CreatedTime

    integer

    Stempel waktu saat kluster dibuat. Unit: milidetik.

    1607365213000
    GroupTrace

    string

    Nama kelompok tempat aset berada.

    default
    ClusterId

    string

    ID kluster.

    c690a0789419f4284a4e0a29e12fe****
    RiskStatus

    string

    Apakah terdapat risiko keamanan pada aset. Nilai valid:

    • YES: Terdapat risiko keamanan.

    • NO: Tidak ada risiko keamanan.

    NO
    Cores

    integer

    Jumlah core CPU aset.

    4
    VulStatus

    string

    Apakah terdapat kerentanan pada instans. Nilai valid:

    • YES: Terdapat kerentanan.

    • NO: Tidak ada kerentanan.

    YES
    AlarmStatus

    string

    Apakah terdapat peringatan keamanan pada aset. Nilai valid:

    • YES: Terdapat peringatan keamanan.

    • NO: Tidak ada peringatan keamanan.

    NO
    MacListString

    string

    Alamat MAC sistem.

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

    integer

    Tingkat kepentingan aset. Nilai valid:

    • 2: aset penting

    • 1: aset umum

    • 0: aset uji coba

    2
    HealthCheckCount

    integer

    Jumlah risiko garis dasar pada instans.

    1
    Ip

    string

    Alamat IP publik instans.

    1.2.XX.XX
    Os

    string

    Sistem operasi instans.

    Linux
    AuthModifyTime

    integer

    Stempel waktu saat otorisasi diikat ke aset. Unit: milidetik.

    1627974044000
    SafeEventCount

    integer

    Jumlah peringatan keamanan pada aset.

    5
    InstanceId

    string

    ID instans.

    i-m5***
    AssetType

    string

    Tipe aset. Nilai valid:

    • 0: server

    • 1: load balancer

    • 2: gerbang NAT

    • 3: database ApsaraDB RDS

    • 4: database ApsaraDB for MongoDB

    • 5: database ApsaraDB for Redis

    • 6: gambar kontainer

    • 7: Kontainer

    0
    IntranetIp

    string

    Alamat IP privat instans.

    1.2.XX.XX
    Vendor

    integer

    Vendor aset. Nilai valid:

    • 0: Aset Alibaba Cloud

    • 1: Aset non-cloud

    • 2: Aset IDC

    • 3, 4, 5, 7, 14, 16: Aset cloud pihak ketiga

    • 8: Aset ringan

    • 9: SAE

    • 10: PAI

    0
    RegionId

    string

    ID wilayah tempat aset berada.

    cn-hanghzou
    Uuid

    string

    UUID instans.

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

    integer

    ID kelompok tempat instans berada.

    4120080
    RegionName

    string

    Nama wilayah tempat aset berada.

    China (Hangzhou)
    VendorName

    string

    Nama vendor aset.

    Nilai valid:

    • ALIYUN: Alibaba Cloud

    • OUT: aset non-cloud

    • IDC: IDC

    • TENCENT: cloud pihak ketiga

    • HUAWEICLOUD: cloud pihak ketiga

    • Microsoft: cloud pihak ketiga

    • AWS: cloud pihak ketiga

    • TRIPARTITE: server ringan

    • SAE: SAE

    • PAI: PAI

    • VOLCENGINE: cloud pihak ketiga

    • google: cloud pihak ketiga

    IDC
    AuthVersionName

    string

    Nama versi otorisasi aset. Nilai valid:

    • Edisi Gratis

    • Edisi Anti-virus

    • Advanced

    • Edisi Perusahaan

    • Edisi Ultimate

    Ultimate Edition
    ClusterName

    string

    Nama kluster.

    cluster1
    ExposedStatus

    integer

    Status eksposur aset. Nilai valid:

    • 0: Tidak terekspos.

    • 1: Terekspos.

    0
    RiskCount

    string

    Statistik risiko aset. Nilainya dalam format JSON dan berisi bidang berikut:

    • account: jumlah akun dengan login tidak biasa atau serangan brute-force yang berhasil

    • appNum: jumlah kerentanan Pemindai

    • asapVulCount: jumlah total kerentanan prioritas tinggi

    • baselineHigh: jumlah risiko garis dasar berisiko tinggi

    • baselineLow: jumlah risiko garis dasar berisiko rendah

    • baselineMedium: jumlah risiko garis dasar berisiko Menengah

    • baselineNum: jumlah total risiko konfigurasi produk cloud

    • cmsNum: jumlah kerentanan Web-CMS

    • containerAsap: jumlah kerentanan Kontainer prioritas tinggi

    • containerLater: jumlah kerentanan Kontainer prioritas menengah

    • containerNntf: jumlah kerentanan Kontainer prioritas rendah

    • containerRemind: jumlah acara Peringatan pengingat Kontainer

    • containerSerious: jumlah acara Peringatan kritis Kontainer

    • containerSuspicious: jumlah acara Peringatan mencurigakan Kontainer

    • cveNum: jumlah kerentanan Linux

    • emgNum: jumlah kerentanan darurat

    • health: jumlah acara Peringatan garis dasar yang belum ditangani

    • imageBaselineHigh: jumlah risiko garis dasar gambar berisiko tinggi

    • imageBaselineLow: jumlah risiko garis dasar gambar berisiko rendah

    • imageBaselineMedium: jumlah risiko garis dasar gambar berisiko Menengah

    • imageBaselineNum: jumlah total risiko garis dasar gambar

    • imageMaliciousFileRemind: jumlah file berbahaya tingkat pengingat gambar

    • imageMaliciousFileSerious: jumlah file berbahaya tingkat kritis gambar

    • imageMaliciousFileSuspicious: jumlah file berbahaya tingkat mencurigakan gambar

    • imageVulAsap: jumlah kerentanan gambar prioritas tinggi

    • imageVulLater: jumlah kerentanan gambar prioritas menengah

    • imageVulNntf: jumlah kerentanan gambar prioritas rendah

    • laterVulCount: jumlah kerentanan prioritas menengah

    • newSuspicious: jumlah acara Peringatan

    • nntfVulCount: jumlah kerentanan prioritas rendah

    • remindNum: jumlah acara Peringatan pengingat

    • scaNum: jumlah kerentanan Pencampuran aliran perangkat lunak

    • seriousNum: jumlah acara Peringatan kritis

    • suspNum: jumlah acara Peringatan mencurigakan

    • suspicious: jumlah total acara Peringatan

    • sysNum: jumlah kerentanan Windows

    • trojan: jumlah trojan

    • uuid: UUID aset

    • vul: jumlah kerentanan

    • weakPWNum: jumlah kata sandi lemah

    { "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

    Daftar alamat IP sistem.

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

    string

    Nama tipe aset.

    Elastic Compute Service
    FlagName

    string

    Vendor aset. Nilai valid:

    • ALIYUN

    • OUT

    • IDC

    • Tencent

    • HUAWEICLOUD

    • Azure

    • AWS

    • ASK

    • TRIPARTITE

    • SAE

    • PAI

    • google

    • VOLCENGINE

    ASK
    AppId

    string

    ID aplikasi.

    Catatan

    Bidang ini hanya dikembalikan ketika Vendor diatur ke 9.

    test
    AppName

    string

    Nama aplikasi.

    Catatan

    Bidang ini hanya dikembalikan ketika Vendor diatur ke 9.

    testAppName
    ClientSubStatus

    string

    Sub-status klien pada instans. Nilai valid:

    • online: Online. Status klien Agen adalah Enabled.

    • offline: Offline. Status klien Agen adalah Disabled.

    • pause: Dijeda. Status klien Agen adalah Protection Paused.

    • uninstalled: Tidak diinstal. Klien Agen Not Installed.

    • stopped: Server dimatikan. Status klien Agen adalah Server Shut Down.

    online
    TagResources

    string

    Tag kustom node Lingjun AI Computing Service. Bidang ini hanya dikembalikan ketika server adalah server Lingjun AI Computing Service.

    app:test,type:lingjun
    PostPaidFlag

    integer

    Metode penagihan edisi perlindungan yang diikat ke aset. Nilai valid:

    • 0: langganan

    • 1: bayar sesuai pemakaian

    0
    HasContainer

    string

    Apakah aset berisi Kontainer. Nilai valid:

    • YES: Berisi Kontainer.

    • NO: Tidak berisi Kontainer.

    YES
    ServiceId

    string

    ID layanan. Bidang ini memiliki nilai hanya ketika instans adalah instans arsitektur tanpa server yang termasuk dalam platform PAI.

    dsw-76jlywunsif09bp15p
    VendorUid

    string

    ID akun instans multi-cloud.

    123
    VendorUserName

    string

    Nama akun instans multi-cloud.

    VendorUserName
    Namespace

    string

    Namespace.

    crm-test
    BindFileProtectType

    string

    Apakah otorisasi pencegahan perubahan diikat. Nilai valid:

    • block: Blok.

    • none: Tidak terikat.

    block
    EdrAuthVersion

    string

    Contoh

    Respons sukses

    JSONformat

    {
  "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",
      "EdrAuthVersion": ""
    }
  ]
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    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

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.