全部產品
Search

搜尋本產品

    Elastic Compute Service：DescribeInstances

    文件中心

    Elastic Compute Service：DescribeInstances

    更新時間：Jun 29, 2026

    本介面支援根據不同請求條件查詢執行個體列表，並關聯查詢執行個體的詳細資訊。

    介面說明

    使用須知

    • 透過阿里雲 CLI 呼叫 API 時，不同資料類型的請求參數取值必須遵循格式要求。更多資訊，請參見 CLI 參數格式說明。

    使用建議

    • 透過請求參數 DryRun 傳送預檢請求，可以檢查參數有效性和授權情況。

    • 分頁查詢首頁時，僅需設定MaxResults以限制返回資訊的條目數，返回結果中的NextToken值將作為查詢後續頁的憑證。查詢後續頁時，將NextToken參數設定為上一次返回結果中取得到的NextToken值作為查詢憑證，並設定MaxResults限制返回條目數。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    ecs:DescribeInstances

    list

    Instance

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

    Instance

    acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}
    • ResourceOwner
    		 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    RegionId

    string

    是

    執行個體所屬的地域 ID。您可以呼叫 DescribeRegions 查看最新的阿里雲地域列表。

    cn-hangzhou
    VpcId

    string

    否

    專有網路 VPC ID。

    v-bp67acfmxazb4p****
    VSwitchId

    string

    否

    交換機 ID。

    vsw-bp67acfmxazb4p****
    ZoneId

    string

    否

    可用區 ID。

    cn-hangzhou-g
    InstanceNetworkType

    string

    否

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

    • vpc：專有網路 VPC。

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

    vpc
    SecurityGroupId

    string

    否

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

    sg-bp67acfmxazb4p****
    InstanceIds

    string

    否

    執行個體 ID。取值可以由多個執行個體 ID 組成一個 JSON 陣列，最多支援 100 個 ID，ID 之間用半形逗號（,）隔開。

    ["i-bp67acfmxazb4p****", "i-bp67acfmxazb4p****", … "i-bp67acfmxazb4p****"]
    PageNumber

    integer

    否

    說明

    該參數即將下線，推薦您使用 NextToken 與 MaxResults 完成分頁查詢操作。

    1
    PageSize

    integer

    否

    說明

    該參數即將下線，推薦您使用 NextToken 與 MaxResults 完成分頁查詢操作。

    10
    NextToken

    string

    否

    查詢憑證（Token），取值為上一次 API 呼叫返回的NextToken參數值。

    caeba0bbb2be03f84eb48b699f0a4883
    MaxResults

    integer

    否

    分頁查詢時每頁行數。最大值為 100。

    預設值：

    • 當不設定值或設定的值小於 10 時，預設值為 10。

    • 當設定的值大於 100 時，預設值為 100。

    10
    InnerIpAddresses

    string

    否

    經典網路類型執行個體的內網 IP 列表。當 InstanceNetworkType=classic 時生效，取值可以由多個 IP 組成一個 JSON 陣列，最多支援 100 個 IP，IP 之間用半形逗號（,）隔開。

    說明

    • 經典網路功能已下線，詳情請參見下線公告。

    ["10.1.1.1", "10.1.2.1", … "10.1.10.1"]
    PrivateIpAddresses

    string

    否

    VPC 網路類型執行個體的私有 IP。當 InstanceNetworkType=vpc 時生效，取值可以由多個 IP 組成一個 JSON 陣列，最多支援 100 個 IP，IP 之間用半形逗號（,）隔開。

    ["172.16.1.1", "172.16.2.1", … "172.16.10.1"]
    PublicIpAddresses

    string

    否

    執行個體的公網 IP 列表。取值可以由多個 IP 組成一個 JSON 陣列，最多支援 100 個 IP，IP 之間用半形逗號（,）隔開。

    ["42.1.1.**", "42.1.2.**", … "42.1.10.**"]
    EipAddresses

    string

    否

    執行個體的彈性公網 IP 列表。當 InstanceNetworkType=vpc 時該參數生效，取值可以由多個 IP 組成一個 JSON 陣列，最多支援 100 個 IP，IP 之間用半形逗號（,）隔開。

    ["42.1.1.**", "42.1.2.**", … "42.1.10.**"]
    InstanceChargeType

    string

    否

    執行個體的計費方式。取值範圍：

    • PostPaid：隨用隨付。

    • PrePaid：包年包月。

    PostPaid
    InternetChargeType

    string

    否

    公網頻寬計費方式。取值範圍：

    • PayByBandwidth：按固定頻寬計費。

    • PayByTraffic：按使用流量計費。

    說明

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

    PayByTraffic
    InstanceName

    string

    否

    執行個體名稱，支援使用萬用字元*進行模糊搜尋。

    Test
    ImageId

    string

    否

    映像 ID。

    m-bp67acfmxazb4p****
    Status

    string

    否

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

    • Pending：建立中。

    • Running：執行中。

    • Starting：啟動中。

    • Stopping：停止中。

    • Stopped：已停止。

    Running
    LockReason

    string

    否

    資源被鎖定的原因。取值範圍：

    • financial：因欠費被鎖定。

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

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

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

    • refunded：因退款被鎖定。

    security
    Filter.1.Key

    string

    否

    查詢資源時的篩選鍵，取值必須為CreationStartTime。同時設定Filter.1.Key和Filter.1.Value可以查詢在指定時間點後建立的資源資訊。

    CreationStartTime
    Filter.2.Key

    string

    否

    查詢資源時的篩選鍵，取值必須為CreationEndTime。同時設定Filter.2.Key和Filter.2.Value可以查詢在指定時間點前建立的資源資訊。

    CreationEndTime
    Filter.3.Key

    string

    否

    查詢資源時的篩選鍵，取值必須為ExpiredStartTime。同時設定Filter.3.Key和Filter.3.Value可以查詢在指定時間點後到期的資源資訊。

    ExpiredStartTime
    Filter.4.Key

    string

    否

    查詢資源時的篩選鍵，取值必須為ExpiredEndTime。同時設定Filter.4.Key和Filter.4.Value可以查詢在指定時間點前到期的資源資訊。

    ExpiredEndTime
    Filter.1.Value

    string

    否

    查詢資源時的篩選值。指定該參數時必須同時指定Filter.1.Key參數，格式為：yyyy-MM-ddTHH:mmZ，採用 UTC +0 時區。

    2017-12-05T22:40Z
    Filter.2.Value

    string

    否

    查詢資源時的篩選值。指定該參數時必須同時指定Filter.2.Key參數，格式為：yyyy-MM-ddTHH:mmZ，採用 UTC +0 時區。

    2017-12-06T22:40Z
    Filter.3.Value

    string

    否

    查詢資源時的篩選值。指定該參數時必須同時指定Filter.3.Key參數，格式為：yyyy-MM-ddTHH:mmZ，採用 UTC +0 時區。

    2017-12-07T22:40Z
    Filter.4.Value

    string

    否

    查詢資源時的篩選值。指定該參數時必須同時指定Filter.4.Key參數，格式為：yyyy-MM-ddTHH:mmZ，採用 UTC +0 時區。

    2017-12-08T22:40Z
    DeviceAvailable

    boolean

    否

    說明

    該參數正在邀測中，暫不支援使用。

    false
    IoOptimized

    boolean

    否

    是否是 I/O 最佳化型執行個體。取值範圍：

    • true：是。

    • false：否。

    true
    NeedSaleCycle

    boolean

    否

    說明

    該參數正在邀測中，暫不支援使用。

    false
    InstanceType

    string

    否

    執行個體的規格。

    ecs.g5.large
    InstanceTypeFamily

    string

    否

    執行個體的規格族。

    ecs.g5
    KeyPairName

    string

    否

    執行個體使用的 SSH 金鑰對名稱。

    KeyPairNameTest
    ResourceGroupId

    string

    否

    執行個體所在的企業資源群組 ID。使用該參數過濾資源時，資源數量不能超過 1000 個。

    說明

    不支援預設資源群組過濾。

    rg-bp67acfmxazb4p****
    HpcClusterId

    string

    否

    執行個體所在的 HPC 叢集 ID。

    hpc-bp67acfmxazb4p****
    RdmaIpAddresses

    string

    否

    HPC 執行個體的 RDMA 網路 IP。

    10.10.10.102
    DryRun

    boolean

    否

    是否只預檢此次請求。取值範圍：

    • true：傳送檢查請求，不會查詢資源狀況。檢查項包括 AccessKey 是否有效、RAM 使用者的授權情況和是否填寫了必需參數。如果檢查不通過，則返回對應錯誤。如果檢查通過，會返回錯誤碼 DryRunOperation。

    • false：傳送正常請求，通過檢查後返回 2XX HTTP 狀態碼並直接查詢資源狀況。

    預設值：false。

    false
    HttpEndpoint

    string

    否

    是否啟用執行個體中繼資料的存取通道。取值範圍：

    • enabled：啟用。

    • disabled：停用。

    預設值：enabled。

    說明

    有關執行個體中繼資料的更多資訊，請參見執行個體中繼資料概述。

    enabled
    HttpTokens

    string

    否

    存取執行個體中繼資料時是否強制使用加固模式（IMDSv2）。取值範圍：

    • optional：不強制使用。

    • required：強制使用。設定該取值後，普通模式無法存取執行個體中繼資料。

    預設值：optional。

    說明

    有關存取執行個體中繼資料模式的更多資訊，請參見執行個體中繼資料存取模式。

    optional
    HttpPutResponseHopLimit

    integer

    否

    說明

    該參數暫未開放使用。

    0
    Ipv6Address

    array

    否

    為彈性網卡指定的 IPv6 位址。

    string

    否

    彈性網卡的 IPv6 位址。N 表示可以設定多個 IPv6 位址，N 的取值範圍為 1~100。

    2408:4321:180:1701:94c7:bc38:3bfa:****
    Tag

    array<object>

    否

    標籤列表。

    object

    否

    標籤列表。

    key

    string

    否

    標籤鍵。

    說明

    為提高相容性，建議您使用另一個Tag.N.Key參數。

    keyTest
    Key

    string

    否

    執行個體的標籤鍵。N 的取值範圍為 1~20。

    使用一個標籤過濾資源，查詢到該標籤下的資源數量不能超過 1000 個；使用多個標籤過濾資源，查詢到同時繫結了多個標籤的資源數量不能超過 1000 個。如果資源數量超過 1000 個，請使用 ListTagResources 介面進行查詢。

    TestKey
    Value

    string

    否

    執行個體的標籤值。N 的取值範圍：1~20。

    TestValue
    value

    string

    否

    標籤值。

    說明

    為提高相容性，建議您使用另一個Tag.N.Value參數。

    valueTest
    AdditionalAttributes

    array

    否

    執行個體其他屬性列表。

    META_OPTIONS

    string

    否

    其他屬性值。N 的取值範圍為 1~5。取值範圍：

    • META_OPTIONS：執行個體中繼資料。

    • DDH_CLUSTER：專有宿主機叢集。

    • NETWORK_PRIMARY_ENI_IP ：主網卡輔助 IP。

    • PRIVATE_DNS_OPTIONS：私網域名資訊。

    • CPU_OPTIONS_TOPOLOGY_TYPE：執行個體的 CPU 拓撲類型。

    • CURRENT_OS_NVME_SUPPORTED：當前作業系統是否支援透過 NVMe 協定存取磁碟。

    • LOGIN_AS_NON_ROOT：執行個體是否設定了 ecs-user 使用者登入。

    META_OPTIONS

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    NextToken

    string

    本次呼叫返回的查詢憑證值。

    caeba0bbb2be03f84eb48b699f0a4883
    PageSize

    integer

    輸入時設定的每頁行數。

    10
    PageNumber

    integer

    執行個體清單的頁碼。

    1
    RequestId

    string

    請求 ID。

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
    TotalCount

    integer

    查詢到的執行個體總數。

    說明

    使用MaxResults和NextToken參數進行分頁查詢時，返回的TotalCount參數值無意義。

    1
    Instances

    object

    Instance

    array<object>

    由 Instances 組成的陣列格式，返回執行個體的資訊。

    array<object>

    CreationTime

    string

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

    2017-12-10T04:04Z
    SerialNumber

    string

    例項序列號。

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

    string

    例項狀態。

    Running
    DeploymentSetId

    string

    部署集 ID。

    ds-bp67acfmxazb4p****
    KeyPairName

    string

    金鑰對名稱。

    testKeyPairName
    SaleCycle

    string
    說明

    該引數已棄用，不再返回有意義的資料。

    month
    SpotStrategy

    string

    按量例項的競價策略。可能值：

    • NoSpot：正常按量付費例項。

    • SpotWithPriceLimit：設定上限價格的搶佔式例項。

    • SpotAsPriceGo：系統自動出價，最高按量付費價格的搶佔式例項。

    NoSpot
    DeviceAvailable

    boolean

    例項是否可以掛載資料盤。

    • true：可以掛載資料盤。

    • false：不可以掛載資料盤。

    true
    LocalStorageCapacity

    integer

    例項掛載的本地儲存容量。單位：GiB。

    1000
    Description

    string

    例項描述。

    testDescription
    SpotDuration

    integer

    搶佔式例項的保留時長，單位為小時。可能值：

    • 1：建立後阿里雲會保證例項執行 1 小時不會被自動釋放；超過 1 小時後，系統會自動比較出價與市場價格、檢查資源庫存，來決定例項的持有和回收。

    • 0：建立後，阿里雲不保證例項執行 1 小時，系統會自動比較出價與市場價格、檢查資源庫存，來決定例項的持有和回收。

    例項回收前 5 分鐘阿里雲會透過 ECS 系統事件向您傳送通知。搶佔式例項按秒計費，建議您結合具體任務執行耗時來選擇合適的保留時長。

    說明

    當 SpotStrategy 值為 SpotWithPriceLimit 或 SpotAsPriceGo 時返回該引數。

    1
    InstanceNetworkType

    string

    例項網路型別。可能值：

    • classic：經典網路。

    • vpc：專有網路 VPC。

    vpc
    InstanceName

    string

    例項名稱。

    InstanceNameTest
    OSNameEn

    string

    例項作業系統的英文名稱。

    CentOS 7.4 64 bit
    HpcClusterId

    string

    例項所屬的 HPC 叢集 ID。

    hpc-bp67acfmxazb4p****
    SpotPriceLimit

    number

    例項的每小時最高價格。支援最大 3 位小數，引數 SpotStrategy=SpotWithPriceLimit 時，該引數生效。

    0.98
    Memory

    integer

    記憶體大小，單位為 MiB。

    16384
    OSName

    string

    例項的作業系統名稱。

    CentOS 7.4 64 位
    DeploymentSetGroupNo

    integer

    ECS 例項繫結部署集分散部署時，例項在部署集中的分組位置。

    1
    ImageId

    string

    例項執行的映象 ID。

    m-bp67acfmxazb4p****
    VlanId

    string

    例項的 VLAN ID。

    說明

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

    10
    ClusterId

    string

    例項所在的叢集 ID。

    說明

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

    c-bp67acfmxazb4p****
    ClockOptions

    object

    PtpStatus

    string

    GPUSpec

    string

    例項規格附帶的 GPU 型別。

    NVIDIA V100
    AutoReleaseTime

    string

    按量付費例項的自動釋放時間。

    2017-12-10T04:04Z
    DeletionProtection

    boolean

    例項釋放保護屬性，指定是否支援透過控制檯或 API（DeleteInstance）釋放例項。

    • true：已開啟例項釋放保護。

    • false：未開啟例項釋放保護。

    說明

    該屬性僅適用於按量付費例項，且只能限制手動釋放操作，對系統釋放操作不生效。

    false
    StoppedMode

    string

    例項停機後是否繼續收費。可能值：

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

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

    • Not-applicable：本例項不支援停機不收費功能。

    KeepCharging
    GPUAmount

    integer

    例項規格附帶的 GPU 數量。

    4
    HostName

    string

    例項主機名。

    testHostName
    InstanceId

    string

    例項 ID。

    i-bp67acfmxazb4p****
    InternetMaxBandwidthOut

    integer

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

    5
    InternetMaxBandwidthIn

    integer

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

    50
    InstanceType

    string

    例項規格。

    ecs.g5.large
    InstanceChargeType

    string

    例項的計費方式。可能值：

    • PrePaid：包年包月。

    • PostPaid：按量付費。

    PostPaid
    RegionId

    string

    例項所屬地域 ID。

    cn-hangzhou
    IoOptimized

    boolean

    是否為 I/O 最佳化型例項。

    • true：是。

    • false：否。

    true
    StartTime

    string

    例項最近一次的啟動時間。以 ISO 8601 為標準，並使用 UTC+0 時間，格式為 yyyy-MM-ddTHH:mmZ。更多資訊，請參見ISO 8601。

    2017-12-10T04:04Z
    Cpu

    integer

    vCPU 數。

    8
    LocalStorageAmount

    integer

    例項掛載的本地儲存數量。

    2
    ExpiredTime

    string

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

    2017-12-10T04:04Z
    ResourceGroupId

    string

    例項所屬的企業資源組 ID。

    rg-bp67acfmxazb4p****
    InternetChargeType

    string

    網路計費型別。可能值：

    • PayByBandwidth：按固定頻寬計費。

    • PayByTraffic：按使用流量計費。

    PayByTraffic
    ZoneId

    string

    例項所屬可用區。

    cn-hangzhou-g
    Recyclable

    boolean

    例項是否可以回收。

    false
    ISP

    string
    說明

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

    null
    CreditSpecification

    string

    突發效能例項的執行模式。可能值：

    • Standard：標準模式。有關例項效能的更多資訊，請參見什麼是突發效能例項中的效能約束模式章節。

    • Unlimited：無效能約束模式，有關例項效能的更多資訊，請參見什麼是突發效能例項中的無效能約束模式章節。

    Standard
    InstanceTypeFamily

    string

    例項規格族。

    ecs.g5
    OSType

    string

    例項的作業系統型別，分為 Windows Server 和 Linux 兩種。可能值：

    • windows。

    • linux。

    linux
    NetworkInterfaces

    object

    NetworkInterface

    array<object>

    例項包含的彈性網絡卡集合。

    array<object>

    例項包含的彈性網絡卡集合。

    Type

    string

    彈性網絡卡型別。可能值：

    • Primary：主網絡卡。

    • Secondary：輔助彈性網絡卡。

    Primary
    MacAddress

    string

    彈性網絡卡的 MAC 地址。

    00:16:3e:32:b4:**
    PrimaryIpAddress

    string

    彈性網絡卡主私有 IP 地址。

    172.17.**.***
    NetworkInterfaceId

    string

    彈性網絡卡的 ID。

    eni-2zeh9atclduxvf1z****
    PrivateIpSets

    object

    PrivateIpSet

    array<object>

    PrivateIpSet 組成的集合。

    object

    PrivateIpAddress

    string

    例項的私網 IP 地址。

    172.17.**.**
    Primary

    boolean

    是否是主私網 IP 地址，可能值：

    • true：是。

    • false：否。

    true
    PrivateDnsName

    string

    例項的私網域名。

    說明

    僅當HostnameType取值為IpBased或者InstanceIdBased時，返回固定格式的私網域名。

    dnsTestName
    Ipv6Sets

    object

    Ipv6Set

    array<object>

    彈性網絡卡已分配的 IPv6 地址集合。僅當請求引數AdditionalAttributes.N取值為NETWORK_PRIMARY_ENI_IP時，才會返回該引數值。

    object

    Ipv6Address

    string

    彈性網絡卡已分配的 IPv6 地址。

    2408:4321:180:1701:94c7:bc38:3bfa:***
    Ipv4PrefixSets

    object

    Ipv4PrefixSet

    array<object>

    彈性網絡卡已分配的 IPv4 字首集合。僅當請求引數AdditionalAttributes.N取值為NETWORK_PRIMARY_ENI_IP時，才會返回該引數值。

    object

    Ipv4Prefix

    string

    彈性網絡卡已分配的 IPv4 字首。

    192.168.*.*/28
    Ipv6PrefixSets

    object

    Ipv6PrefixSet

    array<object>

    彈性網絡卡已分配的 IPv6 字首集合。僅當請求引數AdditionalAttributes.N取值為NETWORK_PRIMARY_ENI_IP時，才會返回該引數值。

    object

    Ipv6Prefix

    string

    彈性網絡卡已分配的 IPv6 字首。

    2001:1111:*:*::/80
    OperationLocks

    object

    LockReason

    array<object>

    例項的鎖定原因。

    object

    LockMsg

    string

    例項被鎖定的描述資訊。

    The specified instance is locked due to financial reason.
    LockReason

    string

    鎖定型別。可能值：

    • financial：因欠費被鎖定。

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

    • Recycling：搶佔式例項的待釋放鎖定狀態。

    • dedicatedhostfinancial：因為專有宿主機欠費導致 ECS 例項被鎖定。

    • refunded：因退款被鎖定。

    Recycling
    Tags

    object

    Tag

    array<object>

    例項的標籤集合。

    object

    TagValue

    string

    例項的標籤值。

    TestValue
    TagKey

    string

    例項的標籤鍵。

    TestKey
    RdmaIpAddress

    object

    IpAddress

    array

    HPC 例項的 RDMA 網路 IP 列表。

    string

    HPC 例項的 RDMA 網路 IP。

    10.10.10.102
    SecurityGroupIds

    object

    SecurityGroupId

    array

    例項所屬安全組 ID 列表。

    string

    安全組 ID。

    sg-bp67acfmxazb4p****
    PublicIpAddress

    object

    IpAddress

    array

    例項公網 IP 地址列表。

    string

    例項公網 IP 地址。

    121.40.**.**
    InnerIpAddress

    object

    IpAddress

    array

    經典網路型別例項的內網 IP 地址列表。

    string

    經典網路型別例項的內網 IP 地址。

    10.170.**.**
    VpcAttributes

    object

    專有網路 VPC 屬性。

    VpcId

    string

    專有網路 VPC ID。

    vpc-2zeuphj08tt7q3brd****
    NatIpAddress

    string

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

    172.17.**.**
    VSwitchId

    string

    虛擬交換機 ID。

    vsw-2zeh0r1pabwtg6wcs****
    PrivateIpAddress

    object

    IpAddress

    array

    私有 IP 地址列表。

    string

    私有 IP 地址。

    172.17.**.**
    EipAddress

    object

    彈性公網 IP 繫結資訊。

    IsSupportUnassociate

    boolean

    是否可以解綁彈性公網 IP。

    true
    InternetChargeType

    string

    彈性公網 IP 的計費方式。

    • PayByBandwidth：按頻寬計費。

    • PayByTraffic：按流量計費。

    PayByTraffic
    IpAddress

    string

    彈性公網 IP。

    42.112.**.**
    Bandwidth

    integer

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

    5
    AllocationId

    string

    彈性公網 IP 的 ID。

    eip-2ze88m67qx5z****
    HibernationOptions

    object
    說明

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

    Configured

    boolean
    說明

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

    false
    DedicatedHostAttribute

    object

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

    DedicatedHostId

    string

    專有宿主機 ID。

    dh-bp67acfmxazb4p****
    DedicatedHostName

    string

    專有宿主機名稱。

    testDedicatedHostName
    DedicatedHostClusterId

    string

    專有宿主機叢集 ID。

    dc-bp67acfmxazb4h****
    EcsCapacityReservationAttr

    object

    雲伺服器 ECS 的容量預留相關引數。

    CapacityReservationPreference

    string

    容量預留偏好。

    cr-bp67acfmxazb4p****
    CapacityReservationId

    string

    容量預留 ID。

    cr-bp67acfmxazb4p****
    DedicatedInstanceAttribute

    object

    專有宿主機例項的屬性。

    Affinity

    string

    專有宿主機例項是否與專有宿主機關聯。可能值：

    • default：專有宿主機例項不與專有宿主機關聯。停機不收費例項重啟後，可能會放置在自動資源部署池中的其它專有宿主機上。

    • host：專有宿主機例項與專有宿主機關聯。停機不收費例項重啟後，仍放置在原專有宿主機上。

    default
    Tenancy

    string

    例項的宿主機型別是否為專有宿主機。可能值：

    • default：例項的宿主機型別不是專有宿主機。

    • host：例項的宿主機型別為專有宿主機。

    default
    CpuOptions

    object

    CPU 配置詳情。

    Numa

    string
    說明

    該引數已廢棄。

    null
    CoreCount

    integer

    物理 CPU 核心數。

    2
    ThreadsPerCore

    integer

    CPU 執行緒數。

    2
    TopologyType

    string

    例項的 CPU 拓撲型別。可能值：

    • HT 離散模式：ContinuousCoreToHTMapping

    • HT 連續模式：DiscreteCoreToHTMapping

    DiscreteCoreToHTMapping
    EnableVISST

    boolean

    TurboMode

    string

    EnableVRDT

    boolean

    NestedVirtualization

    string

    是否開啟巢狀虛擬化

    enabled
    MetadataOptions

    object

    後設資料選項集合。

    HttpEndpoint

    string

    是否啟用例項後設資料的訪問通道。可能值：

    • enabled：啟用。

    • disabled：禁用。

    enabled
    HttpPutResponseHopLimit

    integer
    說明

    該引數暫未開放使用。

    0
    HttpTokens

    string

    訪問例項後設資料時是否強制使用加固模式（IMDSv2）。可能值：

    • optional：不強制使用。

    • required：強制使用。

    optional
    InstanceMetadataTags

    string

    ImageOptions

    object

    映象相關屬性資訊。

    LoginAsNonRoot

    boolean

    使用該映象的例項是否支援使用 ecs-user 使用者登入。可能值：

    • true：是。

    • false：否。

    false
    CurrentOSNVMeSupported

    boolean

    當前作業系統是否支援透過 NVMe 協議訪問磁碟。可能值：

    • true：是。

    • false：否。

    說明

    當請求引數 AdditionalAttributes 包含 CURRENT_OS_NVME_SUPPORTED 時才會返回該引數。

    true
    SpotInterruptionBehavior

    string

    平臺發起搶佔式例項中斷時，搶佔式例項的中斷模式。可能值：

    • Terminate：釋放。

    • Stop：節省停機。

    Terminate
    PrivateDnsNameOptions

    object

    例項的私網域名配置資訊集合。

    關於私網域名解析，請參見ECS 私網域名解析 。

    說明

    僅當請求引數AdditionalAttributes取值包含PRIVATE_DNS_OPTIONS時，返回該引數。

    EnableInstanceIdDnsARecord

    boolean

    開啟/關閉例項 ID 型別的域名到 IPv4 的解析。可能值：

    • true：開啟。

    • false：關閉。

    預設值：false。

    false
    EnableInstanceIdDnsAAAARecord

    boolean

    開啟/關閉例項 ID 型別的域名到 IPv6 的解析。可能值：

    • true：開啟。

    • false：關閉。

    預設值：false。

    false
    EnableIpDnsARecord

    boolean

    開啟/關閉 IP 型別的域名到 IPv4 的解析。可能值：

    • true：開啟。

    • false：關閉。

    預設值：false。

    true
    EnableIpDnsPtrRecord

    boolean

    開啟/關閉 IPv4 到 IP 型別的域名解析。可能值：

    • true：開啟。

    • false：關閉。

    預設值：false。

    true
    HostnameType

    string

    主機名型別，可能值：

    • Custom：自定義。

    • IpBased：基於 IP 格式的主機。

    • InstanceIdBased：基於例項 ID 格式的主機名。

    預設值：Custom。

    Custom
    AdditionalInfo

    object
    說明

    該引數正在邀測中，暫不支援使用。

    EnableHighDensityMode

    boolean
    說明

    該引數正在邀測中，暫不支援使用。

    true
    NodeSerialNumber

    string

    EnableNVS

    boolean

    樣本

    正常返回樣本

    JSON格式

    {
  "NextToken": "caeba0bbb2be03f84eb48b699f0a4883",
  "PageSize": 10,
  "PageNumber": 1,
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "TotalCount": 1,
  "Instances": {
    "Instance": [
      {
        "CreationTime": "2017-12-10T04:04Z",
        "SerialNumber": "51d1353b-22bf-4567-a176-8b3e12e4****",
        "Status": "Running",
        "DeploymentSetId": "ds-bp67acfmxazb4p****",
        "KeyPairName": "testKeyPairName",
        "SaleCycle": "month",
        "SpotStrategy": "NoSpot",
        "DeviceAvailable": true,
        "LocalStorageCapacity": 1000,
        "Description": "testDescription",
        "SpotDuration": 1,
        "InstanceNetworkType": "vpc",
        "InstanceName": "InstanceNameTest",
        "OSNameEn": "CentOS  7.4 64 bit",
        "HpcClusterId": "hpc-bp67acfmxazb4p****",
        "SpotPriceLimit": 0.98,
        "Memory": 16384,
        "OSName": "CentOS  7.4 64 位",
        "DeploymentSetGroupNo": 1,
        "ImageId": "m-bp67acfmxazb4p****",
        "VlanId": "10",
        "ClusterId": "c-bp67acfmxazb4p****",
        "ClockOptions": {
          "PtpStatus": ""
        },
        "GPUSpec": "NVIDIA V100",
        "AutoReleaseTime": "2017-12-10T04:04Z",
        "DeletionProtection": false,
        "StoppedMode": "KeepCharging",
        "GPUAmount": 4,
        "HostName": "testHostName",
        "InstanceId": "i-bp67acfmxazb4p****",
        "InternetMaxBandwidthOut": 5,
        "InternetMaxBandwidthIn": 50,
        "InstanceType": "ecs.g5.large",
        "InstanceChargeType": "PostPaid",
        "RegionId": "cn-hangzhou",
        "IoOptimized": true,
        "StartTime": "2017-12-10T04:04Z",
        "Cpu": 8,
        "LocalStorageAmount": 2,
        "ExpiredTime": "2017-12-10T04:04Z",
        "ResourceGroupId": "rg-bp67acfmxazb4p****",
        "InternetChargeType": "PayByTraffic",
        "ZoneId": "cn-hangzhou-g",
        "Recyclable": false,
        "ISP": "null",
        "CreditSpecification": "Standard",
        "InstanceTypeFamily": "ecs.g5",
        "OSType": "linux",
        "NetworkInterfaces": {
          "NetworkInterface": [
            {
              "Type": "Primary",
              "MacAddress": "00:16:3e:32:b4:**",
              "PrimaryIpAddress": "172.17.**.***",
              "NetworkInterfaceId": "eni-2zeh9atclduxvf1z****",
              "PrivateIpSets": {
                "PrivateIpSet": [
                  {
                    "PrivateIpAddress": "172.17.**.**",
                    "Primary": true,
                    "PrivateDnsName": "dnsTestName"
                  }
                ]
              },
              "Ipv6Sets": {
                "Ipv6Set": [
                  {
                    "Ipv6Address": "2408:4321:180:1701:94c7:bc38:3bfa:***"
                  }
                ]
              },
              "Ipv4PrefixSets": {
                "Ipv4PrefixSet": [
                  {
                    "Ipv4Prefix": "192.168.*.*/28"
                  }
                ]
              },
              "Ipv6PrefixSets": {
                "Ipv6PrefixSet": [
                  {
                    "Ipv6Prefix": "2001:1111:*:*::/80"
                  }
                ]
              }
            }
          ]
        },
        "OperationLocks": {
          "LockReason": [
            {
              "LockMsg": "The specified instance is locked due to financial reason.",
              "LockReason": "Recycling"
            }
          ]
        },
        "Tags": {
          "Tag": [
            {
              "TagValue": "TestValue",
              "TagKey": "TestKey"
            }
          ]
        },
        "RdmaIpAddress": {
          "IpAddress": [
            "10.10.10.102"
          ]
        },
        "SecurityGroupIds": {
          "SecurityGroupId": [
            "sg-bp67acfmxazb4p****"
          ]
        },
        "PublicIpAddress": {
          "IpAddress": [
            "121.40.**.**"
          ]
        },
        "InnerIpAddress": {
          "IpAddress": [
            "10.170.**.**"
          ]
        },
        "VpcAttributes": {
          "VpcId": "vpc-2zeuphj08tt7q3brd****",
          "NatIpAddress": "172.17.**.**",
          "VSwitchId": "vsw-2zeh0r1pabwtg6wcs****",
          "PrivateIpAddress": {
            "IpAddress": [
              "172.17.**.**"
            ]
          }
        },
        "EipAddress": {
          "IsSupportUnassociate": true,
          "InternetChargeType": "PayByTraffic",
          "IpAddress": "42.112.**.**",
          "Bandwidth": 5,
          "AllocationId": "eip-2ze88m67qx5z****"
        },
        "HibernationOptions": {
          "Configured": false
        },
        "DedicatedHostAttribute": {
          "DedicatedHostId": "dh-bp67acfmxazb4p****",
          "DedicatedHostName": "testDedicatedHostName",
          "DedicatedHostClusterId": "dc-bp67acfmxazb4h****"
        },
        "EcsCapacityReservationAttr": {
          "CapacityReservationPreference": "cr-bp67acfmxazb4p****",
          "CapacityReservationId": "cr-bp67acfmxazb4p****"
        },
        "DedicatedInstanceAttribute": {
          "Affinity": "default",
          "Tenancy": "default"
        },
        "CpuOptions": {
          "Numa": "null",
          "CoreCount": 2,
          "ThreadsPerCore": 2,
          "TopologyType": "DiscreteCoreToHTMapping",
          "EnableVISST": false,
          "TurboMode": "",
          "EnableVRDT": false,
          "NestedVirtualization": "enabled"
        },
        "MetadataOptions": {
          "HttpEndpoint": "enabled",
          "HttpPutResponseHopLimit": 0,
          "HttpTokens": "optional",
          "InstanceMetadataTags": ""
        },
        "ImageOptions": {
          "LoginAsNonRoot": false,
          "CurrentOSNVMeSupported": true
        },
        "SpotInterruptionBehavior": "Terminate",
        "PrivateDnsNameOptions": {
          "EnableInstanceIdDnsARecord": false,
          "EnableInstanceIdDnsAAAARecord": false,
          "EnableIpDnsARecord": true,
          "EnableIpDnsPtrRecord": true,
          "HostnameType": "Custom"
        },
        "AdditionalInfo": {
          "EnableHighDensityMode": true,
          "NodeSerialNumber": ""
        },
        "EnableNVS": false
      }
    ]
  }
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 InvalidTag.Mismatch The specified Tag.n.Key and Tag.n.Value are not match.
    400 InvalidTagCount The specified tags are beyond the permitted range.
    400 InvalidHpcClusterId.NotFound The specified HpcClusterId is not found.
    400 InvalidHpcClusterId.Creating The specified HpcClusterId is creating.
    400 InternalError The request processing has failed due to some unknown error, exception or failure.
    400 Throttling.PageNumberLimited Request throttled. Please use NextToken instead of PageNumber for pagination.
    404 InvalidInstanceChargeType.NotFound The InstanceChargeType does not exist in our records.
    404 InvalidInternetChargeType.ValueNotSupported The specified InternetChargeType is not valid.
    404 InvalidLockReason.NotFound The specified LockReason is not found.
    404 InvalidFilterKey.NotFound Invalid filter.%s.
    404 InvalidFilterValue Invalid filter.%s.
    404 InvalidNetworkType.NotFound The specified InstanceNetworkType is not found.
    404 InvalidStatus.NotFound The specified Status is not found.

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

    變更歷史

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