全部產品
Search

搜尋本產品

    Elastic Compute Service：DescribeInstanceAttribute

    文件中心

    Elastic Compute Service：DescribeInstanceAttribute

    更新時間：Jul 31, 2026

    本介面用於查詢一部指定 ECS 執行個體的屬性資訊。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    ecs:DescribeInstanceAttribute

    get

    *Instance

    acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    InstanceId

    string

    是

    指定執行個體的 ID。

    i-uf6f5trc95ug8t33****

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Status

    string

    執行個體狀態。取值範圍：

    • Pending：建立中。

    • Running：執行中。

    • Starting：啟動中。

    • Stopping：停止中。

    • Stopped：已停止。

    Running
    SerialNumber

    string

    執行個體序號。

    51d1353b-22bf-4567-a176-8b3e12e4****
    CreationTime

    string

    執行個體建立時間。以 ISO 8601 為標準，並使用 UTC+0 時間，格式為 yyyy-MM-ddTHH:mmZ。更多資訊，請參見ISO 8601。

    2017-12-10T04:04Z
    RequestId

    string

    請求 ID。

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
    Description

    string

    執行個體描述。

    testDescription
    InstanceName

    string

    執行個體名稱。

    testInstanceName
    InstanceNetworkType

    string

    執行個體網路類型。取值範圍：

    • vpc：專有網路 VPC。

    • classic：傳統網路。傳統網路功能已下線，詳情請參見下線公告。

    vpc
    Memory

    integer

    記憶體大小，單位為 MiB。

    16384
    ImageId

    string

    執行個體執行的映像 ID。

    m-bp1h46wfpjsjastc****
    ClusterId

    string

    執行個體所在的叢集 ID。

    說明

    該參數即將被棄用，為提高相容性，請盡量使用其他參數。

    cls-bp67acfmxazb4p****
    VlanId

    string

    執行個體的 VLAN ID。

    說明

    該參數即將被棄用，為提高相容性，請盡量使用其他參數。

    10
    StoppedMode

    string

    執行個體停機後是否繼續收費。可能值：

    • KeepCharging：停機後繼續收費，為您繼續保留庫存資源。

    • StopCharging：停機後不收費。停機後，我們釋放執行個體對應的資源，例如 vCPU、記憶體和公網 IP 等資源。重新啟動是否成功依賴於當前地域中是否仍有資源庫存。

    • Not-applicable：本執行個體不支援停機不收費功能。

    KeepCharging
    HostName

    string

    執行個體主機名稱。

    testHostName
    InstanceId

    string

    執行個體 ID。

    i-uf6f5trc95ug8t33****
    InstanceType

    string

    執行個體的規格。

    ecs.g5.large
    InternetMaxBandwidthIn

    integer

    公網入頻寬最大值，單位為 Mbit/s。

    50
    InternetMaxBandwidthOut

    integer

    公網出頻寬最大值，單位為 Mbit/s。

    5
    RegionId

    string

    執行個體所屬地域 ID。

    cn-hangzhou
    InstanceChargeType

    string

    執行個體的計費方式。可能值：

    • PrePaid：包年包月。

    • PostPaid：按量付費。

    PrePaid
    IoOptimized

    string

    是否是 I/O 最佳化型執行個體。可能值：

    • optimized：I/O 最佳化。

    • none：非 I/O 最佳化。

    optimized
    Cpu

    integer

    vCPU 處理器核心數量。

    8
    ExpiredTime

    string

    過期時間。以 ISO 8601 為標準，並使用 UTC+0 時間，格式為 yyyy-MM-ddTHH:mmZ。更多資訊，請參見ISO 8601。

    2017-12-10T04:04Z
    ZoneId

    string

    執行個體所屬可用區。

    cn-hangzhou-g
    InternetChargeType

    string

    公網頻寬計費方式。可能值：

    • PayByBandwidth：按固定頻寬計費。

    • PayByTraffic：按使用流量計費。

    說明

    按使用流量計費模式下的出入頻寬峰值都是頻寬上限，不作為業務承諾指標。當出現資源爭搶時，頻寬峰值可能會受到限制。如果您的業務需要有頻寬的保障，請使用按固定頻寬計費模式。

    PayByTraffic
    CreditSpecification

    string

    突發效能執行個體的執行模式。可能值：

    • Standard：標準模式。有關執行個體效能的更多資訊，請參見效能模式。

    • Unlimited：無效能約束模式，有關執行個體效能的更多資訊，請參見效能模式。

    Standard
    SecurityGroupIds

    object

    SecurityGroupId

    array

    執行個體所屬安全性群組集合。

    string

    執行個體所屬安全性群組。

    sg-bp1fg655nh68xyz9i****
    PublicIpAddress

    object

    IpAddress

    array

    執行個體公網 IP 地址清單。

    string

    執行個體公網 IP 地址。

    121.40.**.**
    InnerIpAddress

    object

    IpAddress

    array

    傳統網路類型執行個體的內網 IP 地址清單。

    說明

    傳統網路功能已下線，詳情請參見下線公告。

    string

    傳統網路類型執行個體的內網 IP 地址。

    192.168.**.**
    VpcAttributes

    object

    專有網路 VPC 屬性。

    VpcId

    string

    專有網路 VPC ID。

    vpc-wz9e4e9pmbcnj6ki6****
    NatIpAddress

    string

    雲端產品的 IP，用於 VPC 雲端產品之間的網路互通。

    172.17.**.**
    VSwitchId

    string

    虛擬交換器 ID。

    vsw-uf6ixacqz8osrwnqb****
    PrivateIpAddress

    object

    IpAddress

    array

    私有 IP 地址清單。

    string

    私有 IP 地址。

    192.168.**.**
    EipAddress

    object

    彈性公網 IP 綁定資訊。

    InternetChargeType

    string

    公網頻寬計費方式。可能值：

    • PayByBandwidth：按固定頻寬計費。

    • PayByTraffic：按使用流量計費。

    說明

    按使用流量計費模式下的出入頻寬峰值都是頻寬上限，不作為業務承諾指標。當出現資源爭搶時，頻寬峰值可能會受到限制。如果您的業務需要有頻寬的保障，請使用按固定頻寬計費模式。

    PayByTraffic
    IpAddress

    string

    彈性公網 IP。

    30.21.**.**
    Bandwidth

    integer

    彈性公網 IP 的公網頻寬限速，單位為 Mbit/s。

    8
    AllocationId

    string

    彈性公網 IP 的 ID。

    eip-wz9uilio26dfscamm****
    DedicatedHostAttribute

    object

    由專屬宿主機叢集 ID（DedicatedHostClusterId）、專屬宿主機 ID（DedicatedHostId）和名稱（DedicatedHostName）組成的宿主機屬性陣列。

    DedicatedHostName

    string

    專屬宿主機的名稱。

    ecs-autoui-create-ddh-temp
    DedicatedHostId

    string

    專屬宿主機 ID。

    dh-2ze7qrzz6lvbfhr0****
    OperationLocks

    object

    LockReason

    array<object>

    鎖定原因清單。

    object

    鎖定原因。

    LockReason

    string

    鎖定原因。可能值：

    • financial：因欠費被鎖定。

    • security：因安全原因被鎖定。

    • Recycling：搶占式執行個體的待釋放鎖定狀態。

    • dedicatedhostfinancial：因為專屬宿主機欠費導致 ECS 執行個體被鎖定。

    • refunded：因退款被鎖定。

    financial
    EnableJumboFrame

    boolean

    ECS 執行個體是否開啟了 Jumbo frame 特性。 可能值：

    • true：開啟。

    • false：不開啟。

    更多資訊，請參見ECS 執行個體 MTU。

    false
    EnableNetworkEncryption

    boolean

    執行個體是否開啟 VPC 網路流量加密，可能值：

    • true：開啟。

    • false：未開啟。

    說明

    該參數正在邀測中，暫未開放使用。

    True
    NetworkOptions

    object

    網路相關屬性參數。

    說明

    該參數正在邀測中，暫未開放使用。

    EnableJumboFrame

    boolean

    執行個體是否開啟了 Jumbo frame 特性。 可能值：

    • true：開啟。

    • false：未開啟。

    更多資訊，請參見ECS 執行個體 MTU。

    說明

    該參數正在邀測中，暫未開放使用。

    false
    EnableNetworkEncryption

    boolean

    執行個體是否開啟 VPC 網路流量加密，可能值：

    • true：開啟。

    • false：未開啟。

    說明

    該參數正在邀測中，暫未開放使用。

    False
    BandwidthWeighting

    string

    頻寬權重。

    不同規格支援設定的值不一樣，您可以透過 DescribeInstanceTypes 查詢當前執行個體規格支援的頻寬權重值。

    枚舉值：

    • Vpc-L1 :

      Vpc-L1

    • Vpc-L2 :

      Vpc-L2

    • Ebs-L1 :

      Ebs-L1

    • Ebs-L2 :

      Ebs-L2

    • Default :

      Default

    Vpc-L1
    SecurityOptions

    object

    EnableSecureBoot

    boolean

    樣本

    正常返回樣本

    JSON格式

    {
  "Status": "Running",
  "SerialNumber": "51d1353b-22bf-4567-a176-8b3e12e4****",
  "CreationTime": "2017-12-10T04:04Z",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "Description": "testDescription",
  "InstanceName": "testInstanceName",
  "InstanceNetworkType": "vpc",
  "Memory": 16384,
  "ImageId": "m-bp1h46wfpjsjastc****",
  "ClusterId": "cls-bp67acfmxazb4p****",
  "VlanId": "10",
  "StoppedMode": "KeepCharging",
  "HostName": "testHostName",
  "InstanceId": "i-uf6f5trc95ug8t33****",
  "InstanceType": "ecs.g5.large",
  "InternetMaxBandwidthIn": 50,
  "InternetMaxBandwidthOut": 5,
  "RegionId": "cn-hangzhou",
  "InstanceChargeType": "PrePaid",
  "IoOptimized": "optimized",
  "Cpu": 8,
  "ExpiredTime": "2017-12-10T04:04Z",
  "ZoneId": "cn-hangzhou-g",
  "InternetChargeType": "PayByTraffic",
  "CreditSpecification": "Standard",
  "SecurityGroupIds": {
    "SecurityGroupId": [
      "sg-bp1fg655nh68xyz9i****"
    ]
  },
  "PublicIpAddress": {
    "IpAddress": [
      "121.40.**.**"
    ]
  },
  "InnerIpAddress": {
    "IpAddress": [
      "192.168.**.**"
    ]
  },
  "VpcAttributes": {
    "VpcId": "vpc-wz9e4e9pmbcnj6ki6****",
    "NatIpAddress": "172.17.**.**",
    "VSwitchId": "vsw-uf6ixacqz8osrwnqb****",
    "PrivateIpAddress": {
      "IpAddress": [
        "192.168.**.**"
      ]
    }
  },
  "EipAddress": {
    "InternetChargeType": "PayByTraffic",
    "IpAddress": "30.21.**.**",
    "Bandwidth": 8,
    "AllocationId": "eip-wz9uilio26dfscamm****"
  },
  "DedicatedHostAttribute": {
    "DedicatedHostName": "ecs-autoui-create-ddh-temp",
    "DedicatedHostId": "dh-2ze7qrzz6lvbfhr0****"
  },
  "OperationLocks": {
    "LockReason": [
      {
        "LockReason": "financial"
      }
    ]
  },
  "EnableJumboFrame": false,
  "EnableNetworkEncryption": true,
  "NetworkOptions": {
    "EnableJumboFrame": false,
    "EnableNetworkEncryption": true,
    "BandwidthWeighting": "Vpc-L1"
  },
  "SecurityOptions": {
    "EnableSecureBoot": false
  }
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    500 InternalError The request processing has failed due to some unknown error.
    404 InvalidInstanceId.NotFound The specified InstanceId does not exist. 指定的執行個體 ID 無效。

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

    變更歷史

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