全部產品
Search

搜尋本產品

    Security Center：DescribeAssetDetailByUuid

    文件中心

    Security Center：DescribeAssetDetailByUuid

    更新時間：Jun 15, 2026

    根據 UUID 查詢伺服器資產詳情和擴展資訊。

    說明

    目前該API介面已標記為棄用，推薦使用替代API：Sas(2018-12-03) - GetAssetDetailByUuid。

    介面說明

    該服務即將下線。請採呼叫 GetAssetDetailByUuid 介面獲取資產詳情。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    yundun-sas:DescribeAssetDetailByUuid

    get

    *All Resource

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    SourceIp

    string

    否

    存取來源的 IP 位址。

    192.0.XX.XX
    Uuid

    string

    是

    要查詢的資產的 UUID。

    說明

    呼叫 DescribeCloudCenterInstances 介面獲取該參數。

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

    string

    否

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

    • zh：中文

    • en：英文。

    zh

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

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

    39031E31-6BBA-5C99-A870-D807E78918CD
    AssetDetail

    object

    資產資訊詳情。

    CpuInfo

    string

    CPU 詳細資訊。

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

    string

    伺服器的公網 IP 位址。

    192.168.XX.XX
    OsDetail

    string

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

    Linux 64bit
    CreateTime

    integer

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

    1603863599000
    Kernel

    string

    作業系統的核心版本。

    4.18.0-80.11.2.el8_0.x86_64
    Bind

    boolean

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

    • true：已綁定授權

    • false：未綁定授權。

    true
    OsName

    string

    伺服器的作業系統名稱。

    -
    Tag

    string

    伺服器的標籤。

    InternetIp
    ClientStatus

    string

    Agent 用戶端狀態。取值：

    • pause：暫停保護

    • online：保護中

    • offline：未受保護。

    online
    Mem

    integer

    記憶體大小，單位為 GB。

    32
    Memory

    integer

    記憶體大小，單位為 MB。

    512
    VpcInstanceId

    string

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

    vpc-bp1fs3bwonlfq503w****
    AuthVersion

    integer

    資產的授權版本。取值：

    • 1：免費版（未授權）

    • 6：防病毒版

    • 5：進階版

    • 3：企業版

    • 7：旗艦版。

    7
    InstanceName

    string

    伺服器名稱。

    i-fasdfasdfadfafa****
    Region

    string

    伺服器所在地域。

    cn-hangzhou-dg-a01
    GroupTrace

    string

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

    default
    Ip

    string

    ECS 分配的 IP 位址。

    192.168.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：雲端伺服器 ECS

    • 1：負載平衡 SLB

    • 2：NAT 閘道

    • 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 位址清單。

    ["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": "39031E31-6BBA-5C99-A870-D807E78918CD",
  "AssetDetail": {
    "CpuInfo": "Intel(R) Xeon(R) Platinum 8163 CPU @ 2.50GHz",
    "InternetIp": "192.168.XX.XX",
    "OsDetail": "Linux 64bit",
    "CreateTime": 1603863599000,
    "Kernel": "4.18.0-80.11.2.el8_0.x86_64",
    "Bind": true,
    "OsName": "-",
    "Tag": "InternetIp",
    "ClientStatus": "online",
    "Mem": 32,
    "Memory": 512,
    "VpcInstanceId": "vpc-bp1fs3bwonlfq503w****",
    "AuthVersion": 7,
    "InstanceName": "i-fasdfasdfadfafa****",
    "Region": "cn-hangzhou-dg-a01",
    "GroupTrace": "default",
    "Ip": "192.168.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": [
      "[\"192.168.XX.XX\"]"
    ],
    "MacList": [
      "[\n      \"00:16:3*:1*:9*:cf\"\n]"
    ],
    "DiskInfoList": [
      "{diskName: \"/dev/vda1\", useSizeByte: 2998996992, totalSize: 40, useSize: 2, totalSizeByte: 42140479488}"
    ]
  }
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 NoPermission no permission
    500 ServerError ServerError
    403 NoPermission caller has no permission

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

    變更歷史

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