全部產品
Search

搜尋本產品

    Security Center：GetAssetDetailByUuid - 查詢服務器資產詳情和擴充資訊

    文件中心

    Security Center：GetAssetDetailByUuid - 查詢服務器資產詳情和擴充資訊

    更新時間：Mar 21, 2026

    根據UUID查詢服務器資產詳情和擴充資訊。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    yundun-sas:GetAssetDetailByUuid

    get

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    SourceIp

    string

    否

    請求源 IP。無需填寫，系統自動擷取。

    120.245.XX.XX
    Uuid

    string

    是

    要查詢的資產的 UUID。

    說明

    調用 DescribeCloudCenterInstances 介面擷取該參數。

    9e6cad93-a379-46fd-a701-9bbf02f4****
    Lang

    string

    否

    佈建要求和接收訊息的語言類型。預設為 zh。取值：

    • zh：中文

    • en：英文

    zh

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    請求返回資料。

    RequestId

    string

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

    4892B68B-47BC-5E56-B327-9C2ACC6C1C09
    AssetDetail

    object

    資產資訊詳情。

    CpuInfo

    string

    CPU 詳細資料。

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

    string

    伺服器的公網 IP 位址。

    120.47.XX.XX
    OsDetail

    string

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

    Linux 64bit
    CreateTime

    integer

    Security Center記錄當前資產資訊的時間戳記，單位為毫秒。

    1603863599000
    Kernel

    string

    作業系統的核心版本。

    4.18.0-80.11.2.el8_0.x86_64
    Bind

    boolean

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

    • true：已綁定授權

    • false：未綁定授權

    true
    OsName

    string

    伺服器的作業系統名稱。

    CentOS 7.4 64bit
    Tag

    string

    伺服器的標籤。

    InternetIp
    ClientStatus

    string

    Agent 用戶端狀態。取值：

    • pause：暫停保護

    • online：保護中

    • offline：未受保護

    online
    Mem

    integer

    記憶體大小，單位為 GB。

    16
    Memory

    integer

    記憶體大小，單位為 MB。

    16384
    VpcInstanceId

    string

    伺服器所在的 VPC 執行個體 ID。

    vpc-bp1fs3bwonlfq503w****
    AuthVersion

    integer

    資產的授權版本。取值：

    • 1：免費版（未授權）

    • 6：防病毒版

    • 5：進階版

    • 3：企業版

    • 7：旗艦版

    7
    InstanceName

    string

    伺服器名稱。

    i-fasdfasdfadfafa****
    Region

    string

    伺服器所在地區。

    cn-shanghai
    GroupTrace

    string

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

    default
    Ip

    string

    ECS 分配的 IP 位址。

    120.47.XX.XX
    HostName

    string

    主機名稱。

    qewrqwerqs****
    Os

    string

    伺服器的作業系統類型。

    linux
    AuthModifyTime

    integer

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

    1627974044000
    InstanceId

    string

    伺服器 ID。

    i-uf6h7p2fgk6rkk0g****
    IntranetIp

    string

    伺服器的私網 IP 位址。

    192.168.XX.XX
    AssetType

    string

    資產類型。取值：

    • 0：Elastic Compute Service

    • 1：Server Load Balancer

    • 2：NAT Gateway

    • 3：RDS 資料庫

    • 4：MongoDb 資料庫

    • 5：REDIS 資料庫

    • 6：容器鏡像 IMAGE

    • 7：容器 CONTAINER

    0
    RegionId

    string

    資產的地區 ID。

    cn-hanghzou
    SysInfo

    string

    伺服器的作業系統資訊。

    CentOS Linux 8.0.1905
    Uuid

    string

    伺服器 UUID。

    9e6cad93-a379-46fd-a701-9bbf02f4****
    Cpu

    integer

    CPU 核心數。

    2
    RegionName

    string

    伺服器所在地區名稱。

    China (Hohhot)
    Flag

    integer

    資產是否為阿里雲資產。取值：

    • 0：阿里雲資產

    • 1：非阿里雲資產

    0
    ClientVersion

    string

    Agent 用戶端的版本。

    2.0.0
    IpList

    array

    伺服器的 IP 位址列表。

    string

    伺服器的 IP 位址列表。

    120.47.XX.XX
    MacList

    array

    MAC 位址。

    string

    MAC 位址。

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

    array<object>

    磁碟資訊列表。

    object

    磁碟資訊。

    DiskName

    string

    磁碟名稱。

    /dev/vda1
    UseSizeByte

    integer

    磁碟已使用容量。單位為 Byte。

    2998996992
    TotalSize

    integer

    磁碟總容量，單位為 GB。

    40
    UseSize

    integer

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

    2
    TotalSizeByte

    integer

    磁碟總容量，單位為 Byte。

    42140479488
    ClientSubStatus

    string

    執行個體的用戶端子狀態。取值：

    • online：線上，表示資產的 Agent 用戶端狀態為開啟。

    • offline：離線，表示資產的 Agent 用戶端狀態為關閉。

    • pause：暫停，表示資產的 Agent 用戶端狀態為暫停保護。

    • uninstalled：未安裝，表示資產的 Agent 用戶端狀態為未安裝。

    • stopped：伺服器關機，表示資產的 Agent 用戶端狀態伺服器關機。

    online
    VendorAuthAlias

    string

    AK 所屬的帳號名稱。

    說明

    僅第三方主機資產可能會返回該參數，該參數值為空白時不返回。

    test

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "4892B68B-47BC-5E56-B327-9C2ACC6C1C09",
  "AssetDetail": {
    "CpuInfo": "Intel(R) Xeon(R) Platinum 8163 CPU @ 2.50GHz",
    "InternetIp": "120.47.XX.XX",
    "OsDetail": "Linux 64bit",
    "CreateTime": 1603863599000,
    "Kernel": "4.18.0-80.11.2.el8_0.x86_64",
    "Bind": true,
    "OsName": "CentOS  7.4 64bit",
    "Tag": "InternetIp",
    "ClientStatus": "online",
    "Mem": 16,
    "Memory": 16384,
    "VpcInstanceId": "vpc-bp1fs3bwonlfq503w****",
    "AuthVersion": 7,
    "InstanceName": "i-fasdfasdfadfafa****",
    "Region": "cn-shanghai",
    "GroupTrace": "default",
    "Ip": "120.47.XX.XX",
    "HostName": "qewrqwerqs****",
    "Os": "linux",
    "AuthModifyTime": 1627974044000,
    "InstanceId": "i-uf6h7p2fgk6rkk0g****",
    "IntranetIp": "192.168.XX.XX",
    "AssetType": "0",
    "RegionId": "cn-hanghzou",
    "SysInfo": "CentOS Linux 8.0.1905",
    "Uuid": "9e6cad93-a379-46fd-a701-9bbf02f4****",
    "Cpu": 2,
    "RegionName": "China (Hohhot)",
    "Flag": 0,
    "ClientVersion": "2.0.0",
    "IpList": [
      "120.47.XX.XX"
    ],
    "MacList": [
      "00:16:3*:1*:9*:cf"
    ],
    "DiskInfoList": [
      {
        "DiskName": "/dev/vda1",
        "UseSizeByte": 2998996992,
        "TotalSize": 40,
        "UseSize": 2,
        "TotalSizeByte": 42140479488
      }
    ],
    "ClientSubStatus": "online",
    "VendorAuthAlias": "test"
  }
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 NoPermission no permission 無此服務的存取權限。
    500 ServerError ServerError 服務故障，請稍後重試！
    403 NoPermission caller has no permission 當前操作未被授權，請聯絡主帳號在RAM控制台進行授權後再執行操作。

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

    變更歷史

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