全部產品
Search

搜尋本產品

    Security Center：DescribeAssetDetailByUuids

    文件中心

    Security Center：DescribeAssetDetailByUuids

    更新時間：Jun 15, 2026

    查詢資產（ECS 伺服器）的詳細資訊。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    yundun-sas:DescribeAssetDetailByUuids

    get

    *All Resource

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Uuids

    string

    是

    資產執行個體的 UUID 列表。多個 UUID 之間使用半形逗號（,）分隔。

    說明

    呼叫 DescribeCloudCenterInstances 介面取得該參數。

    0687b17f-2a36-4e5****,0687b17f-2a36-4e****

    Lang

    string

    否

    設定請求和接收訊息的語言類型，預設為 zh。取值：

    • zh：中文

    • en：英文。

    zh
    ResourceDirectoryAccountId

    integer

    否

    資源目錄成員帳號主帳號 ID。

    說明

    呼叫 DescribeMonitorAccounts 介面可以取得該參數。

    127608589417****

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    本次呼叫請求的 ID，是由阿里雲為該請求生成的唯一識別碼，可用於排查和定位問題。

    92016EC8-D52D-49D8-9FF7-9EA340A950B9
    AssetList

    array<object>

    返回的資產詳情列表。

    object

    返回的資產詳情。

    InternetIp

    string

    伺服器的公網 IP。

    10.10.XX.XX
    OsName

    string

    伺服器資產的作業系統名稱。

    CentOS 7.6 64位
    Ip

    string

    伺服器的 IP。

    說明

    公網 IP 存在則該值為公網 IP，公網 IP 不存在私網 IP 存在則為私網 IP。

    10.10.XX.XX
    Os

    string

    伺服器的作業系統類型。

    Linux
    InstanceId

    string

    資產的執行個體 ID。

    i-rj9gda4wolo0zixi****
    ClientStatus

    string

    Agent 用戶端狀態。取值：

    • online：線上

    • offline：離線。

    online
    VpcInstanceId

    string

    VPC 執行個體 ID。

    13231-331331
    IntranetIp

    string

    伺服器的私網 IP。

    192.168.XX.XX
    AssetType

    string

    資產的類型。

    唯一取值為 0，表示 ECS 伺服器。

    0
    RegionId

    string

    伺服器所在地域。

    說明

    Region ID 和區域名稱的對應關係，請參見地域和可用區。

    cn-shanghai
    Uuid

    string

    資產 UUID。

    2a98f149-0256-414c-a29a-a69f8a75****
    Flag

    integer

    資產廠商。取值：

    • 0：阿里雲資產

    • 1：雲外資產

    • 2：IDC 資產

    • 3、4、5、7：其它雲端資產

    • 8：輕量級資產。

    0
    RegionName

    string

    伺服器所在地域名稱。

    cn-shenzhen
    InstanceName

    string

    資產的執行個體名稱。

    TestInstanceName
    Region

    string

    伺服器所在的地域。

    cn-guangzhou
    CpuInfo

    string

    CPU 詳細資訊。

    Intel(R) Xeon(R) Platinum 8163 CPU @ 2.50GHz
    OsDetail

    string

    伺服器的作業系統版本位元數。

    Linux 64bit
    CreateTime

    integer

    雲端安全中心記錄當前資產資訊的時間戳記，單位為毫秒。

    1603863599000
    Kernel

    string

    作業系統的核心版本。

    4.18.0-80.11.2.el8_0.x86_64
    Bind

    boolean

    資產是否已綁定授權。取值：

    • true：已綁定授權

    • false：未綁定授權。

    true
    Tag

    string

    伺服器的標籤。

    test
    Mem

    integer

    記憶體大小，單位為 GB。

    4
    Memory

    integer

    記憶體大小，單位為 MB。

    1024
    AuthVersion

    integer

    資產的授權版本。取值：

    • 1：免費版（未授權）

    • 6：防病毒版

    • 5：進階版

    • 3：企業版

    • 7：旗艦版。

    7
    GroupTrace

    string

    伺服器所屬的分組。未設定分組的伺服器預設屬於未分組。

    default
    HostName

    string

    主機名稱。

    test
    AuthModifyTime

    integer

    資產授權綁定的時間戳記，單位為毫秒。

    1627974044000
    SysInfo

    string

    伺服器的作業系統資訊。

    CentOS Linux 8.0.1905
    Cpu

    integer

    CPU 核心數。

    4
    ClientVersion

    string

    Agent 用戶端的版本。

    2.0.0
    IpList

    array

    伺服器的 IP 位址列表。

    string

    伺服器的 IP 位址。

    192.168.XX.XX
    MacList

    array

    MAC 位址列表。

    string

    MAC 位址。

    00:16:3*:1*:9*:cf
    DiskInfoList

    array

    磁碟資訊集合。

    string

    磁碟資訊。以下是磁碟相關參數的說明：

    • diskName：磁碟名稱。

    • totalSize：磁碟總容量，單位為 GB。

    • useSize：已使用磁碟容量，單位為 GB。

    • useSizeByte：已使用磁碟容量，單位為 Byte。

    • totalSizeByte：已使用磁碟容量，單位為 Byte。

    {diskName: "/dev/vda1", useSizeByte: 2998996992, totalSize: 40, useSize: 2, totalSizeByte: 42140479488}

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "92016EC8-D52D-49D8-9FF7-9EA340A950B9",
  "AssetList": [
    {
      "InternetIp": "10.10.XX.XX",
      "OsName": "CentOS  7.6 64位",
      "Ip": "10.10.XX.XX",
      "Os": "Linux",
      "InstanceId": "i-rj9gda4wolo0zixi****",
      "ClientStatus": "online",
      "VpcInstanceId": "13231-331331",
      "IntranetIp": "192.168.XX.XX",
      "AssetType": "0",
      "RegionId": "cn-shanghai",
      "Uuid": "2a98f149-0256-414c-a29a-a69f8a75****",
      "Flag": 0,
      "RegionName": "cn-shenzhen",
      "InstanceName": "TestInstanceName",
      "Region": "cn-guangzhou",
      "CpuInfo": "Intel(R) Xeon(R) Platinum 8163 CPU @ 2.50GHz",
      "OsDetail": "Linux 64bit",
      "CreateTime": 1603863599000,
      "Kernel": "4.18.0-80.11.2.el8_0.x86_64",
      "Bind": true,
      "Tag": "test",
      "Mem": 4,
      "Memory": 1024,
      "AuthVersion": 7,
      "GroupTrace": "default",
      "HostName": "test",
      "AuthModifyTime": 1627974044000,
      "SysInfo": "CentOS Linux 8.0.1905",
      "Cpu": 4,
      "ClientVersion": "2.0.0",
      "IpList": [
        "192.168.XX.XX"
      ],
      "MacList": [
        "00:16:3*:1*:9*:cf"
      ],
      "DiskInfoList": [
        "{diskName: \"/dev/vda1\", useSizeByte: 2998996992, totalSize: 40, useSize: 2, totalSizeByte: 42140479488}"
      ]
    }
  ]
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 IllegalParam Illegal param
    400 RdCheckNoPermission Resource directory account verification has no permission.
    500 RdCheckInnerError Resource directory account service internal error.
    500 GetAssetDetailFail Asset detail service has failed due to some unknown error.
    500 ServerError ServerError
    403 NoPermission caller has no permission

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。