All Products
Search

This Product

    :DescribeInstances

    Document Center

    :DescribeInstances

    Last Updated:May 22, 2026

    Mengambil detail instans Elastic Compute Service (ECS).

    Catatan penggunaan

    • Anda dapat menentukan beberapa parameter permintaan untuk memfilter hasil kueri. Parameter permintaan yang ditentukan memiliki relasi logis AND. Hanya parameter yang ditentukan yang disertakan dalam kondisi filter. Namun, jika InstanceIds diatur ke array JSON kosong, hal tersebut dianggap sebagai kondisi filter yang valid dan mengembalikan hasil kosong.
    • Jika Anda menggunakan pengguna Resource Access Management (RAM) atau peran RAM yang tidak memiliki izin untuk memanggil operasi ini, daftar kosong akan dikembalikan. Anda dapat menyertakan parameter DryRun dalam permintaan untuk memeriksa apakah daftar kosong disebabkan oleh kurangnya izin.
    • Saat memanggil operasi API menggunakan Alibaba Cloud CLI, Anda harus menentukan nilai parameter permintaan dengan tipe data berbeda dalam format yang diperlukan. Untuk informasi selengkapnya, lihat Ikhtisar format parameter.
    • Anda dapat menggunakan salah satu metode berikut untuk memeriksa respons:
      • Metode 1: Saat melakukan kueri berhalaman, pada pemanggilan operasi DescribeInstances untuk mengambil halaman pertama hasil, atur MaxResults untuk menentukan jumlah maksimum entri yang dikembalikan dalam panggilan tersebut. Nilai kembali dari NextToken adalah token paginasi yang dapat digunakan dalam permintaan berikutnya untuk mengambil halaman hasil berikutnya. Saat memanggil operasi DescribeInstances untuk mengambil halaman hasil berikutnya, atur NextToken ke nilai NextToken yang dikembalikan dalam panggilan sebelumnya dan atur MaxResults untuk menentukan jumlah maksimum entri yang dikembalikan dalam panggilan ini.

      • Metode 2: Gunakan PageSize untuk menentukan jumlah entri yang dikembalikan pada setiap halaman, lalu gunakan PageNumber untuk menentukan nomor halaman yang akan dikembalikan.

        Anda hanya dapat menggunakan salah satu metode di atas. Jika jumlah entri yang besar perlu dikembalikan, kami menyarankan Anda menggunakan Metode 1. Saat MaxResults atau NextToken ditentukan, parameter permintaan PageSize dan PageNumber tidak berlaku, dan parameter respons TotalCount tidak valid.

    Debugging

    OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

    Parameter permintaan

    Parameter

    Tipe

    Wajib

    Contoh

    Deskripsi
    Action String Ya DescribeInstances

    Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeInstances.

    RegionId String Ya cn-hangzhou

    ID wilayah instans. Anda dapat memanggil operasi DescribeRegions untuk menanyakan daftar wilayah terbaru.

    VpcId String Tidak v-bp67acfmxazb4p****

    ID virtual private cloud (VPC) tempat instans berada.

    VSwitchId String Tidak vsw-bp67acfmxazb4p****

    ID vSwitch tempat instans terhubung.

    ZoneId String Tidak cn-hangzhou-g

    ID zona instans.

    InstanceNetworkType String Tidak vpc

    Jenis jaringan instans. Nilai yang valid:

    • classic
    • vpc
    SecurityGroupId String Tidak sg-bp67acfmxazb4p****

    ID grup keamanan tempat instans berada.

    InstanceIds String Tidak ["i-bp67acfmxazb4p****", "i-bp67acfmxazb4p****", ... "i-bp67acfmxazb4p****"]

    ID instans. Nilainya dapat berupa array JSON yang terdiri dari hingga 100 ID instans. Pisahkan ID dengan koma (,).

    PageNumber Integer Tidak 1

    Nomor halaman.

    Halaman dimulai dari halaman 1.

    Nilai default: 1.

    PageSize Integer Tidak 10

    Jumlah entri per halaman.

    Nilai yang valid: 1 hingga 100.

    Nilai default: 10.

    NextToken String Tidak caeba0bbb2be03f84eb48b699f0a4883

    Token paginasi yang digunakan dalam permintaan berikutnya untuk mengambil halaman baru hasil. Anda harus menentukan token yang diperoleh dari kueri sebelumnya sebagai nilai NextToken.

    MaxResults Integer Tidak 10

    Jumlah maksimum entri per halaman. Nilai yang valid: 1 hingga 100.

    Nilai default:

    • Jika parameter ini tidak ditentukan atau diatur ke nilai kurang dari 10, nilai default-nya adalah 10.
    • Jika parameter ini diatur ke nilai lebih dari 100, nilai default-nya adalah 100.
    InnerIpAddresses String Tidak ["10.1.1.1", "10.1.2.1", ... "10.1.10.1"]

    Alamat IP internal instans yang berada di jaringan klasik. Parameter ini berlaku ketika InstanceNetworkType diatur ke classic. Nilainya dapat berupa array JSON yang terdiri dari hingga 100 alamat IP. Pisahkan alamat IP dengan koma (,).

    PrivateIpAddresses String Tidak ["172.16.1.1", "172.16.2.1", ... "172.16.10.1"]

    Alamat IP pribadi instans yang berada di VPC. Parameter ini berlaku ketika InstanceNetworkType diatur ke vpc. Nilainya dapat berupa array JSON yang terdiri dari hingga 100 alamat IP. Pisahkan alamat IP dengan koma (,).

    PublicIpAddresses String Tidak ["42.1.1.**", "42.1.2.**", ... "42.1.10.**"]

    Alamat IP publik instans. Nilainya dapat berupa array JSON yang terdiri dari hingga 100 alamat IP. Pisahkan alamat IP dengan koma (,).

    EipAddresses String Tidak ["42.1.1.**", "42.1.2.**", ... "42.1.10.**"]

    elastic IP addresses (EIPs) instans. Parameter ini berlaku ketika InstanceNetworkType diatur ke vpc. Nilainya dapat berupa array JSON yang terdiri dari hingga 100 alamat IP. Pisahkan alamat IP dengan koma (,).

    InstanceChargeType String Tidak PostPaid

    Metode penagihan instans. Nilai yang valid:

    • PostPaid: pay-as-you-go
    • PrePaid: subscription
    InternetChargeType String Tidak PayByTraffic

    Metode penagihan penggunaan jaringan. Nilai yang valid:

    • PayByBandwidth
    • PayByTraffic
    Catatan Ketika metode penagihan jaringan pay-by-traffic digunakan, bandwidth inbound dan outbound maksimum digunakan sebagai batas atas bandwidth, bukan sebagai kinerja yang dijamin. Dalam skenario di mana permintaan melebihi pasokan sumber daya, nilai bandwidth maksimum mungkin dibatasi. Jika Anda menginginkan bandwidth yang dijamin untuk instans Anda, gunakan metode penagihan jaringan pay-by-bandwidth.
    InstanceName String Tidak Test

    Nama instans. Pencarian fuzzy dengan karakter wildcard asterisk (*) didukung.

    ImageId String Tidak m-bp67acfmxazb4p****

    ID citra.

    Status String Tidak Running

    Status instans. Nilai yang valid:

    • Pending: Instans sedang dibuat.
    • Running: Instans sedang berjalan.
    • Starting: Instans sedang dinyalakan.
    • Stopping: Instans sedang dihentikan.
    • Stopped: Instans telah dihentikan.
    LockReason String Tidak security

    Alasan instans dikunci. Nilai yang valid:

    • financial: Instans dikunci karena pembayaran tertunda.
    • security: Instans dikunci karena alasan keamanan.
    • recycling: Instans preemptible dikunci dan menunggu pelepasan.
    • dedicatedhostfinancial: Instans dikunci karena pembayaran tertunda untuk host khusus.
    • refunded: Instans dikunci karena pengembalian dana dilakukan untuk instans tersebut.
    Filter.1.Key String Tidak CreationStartTime

    Kunci filter 1 yang digunakan untuk menanyakan resource. Tetapkan nilainya ke CreationStartTime. Anda dapat menentukan waktu dengan menetapkan Filter.1.Key dan Filter.1.Value untuk menanyakan resource yang dibuat setelah waktu tersebut.

    Filter.2.Key String Tidak CreationEndTime

    Kunci filter 2 yang digunakan untuk menanyakan resource. Tetapkan nilainya ke CreationEndTime. Anda dapat menentukan waktu dengan menetapkan Filter.2.Key dan Filter.2.Value untuk menanyakan resource yang dibuat sebelum waktu tersebut.

    Filter.3.Key String Tidak ExpiredStartTime

    Kunci filter 3 yang digunakan untuk menanyakan resource. Tetapkan nilainya ke ExpiredStartTime. Anda dapat menentukan waktu dengan menetapkan Filter.3.Key dan Filter.3.Value untuk menanyakan resource yang kedaluwarsa setelah waktu tersebut.

    Filter.4.Key String Tidak ExpiredEndTime

    Kunci filter 4 yang digunakan untuk menanyakan resource. Tetapkan nilainya ke ExpiredEndTime. Anda dapat menentukan waktu dengan menetapkan Filter.4.Key dan Filter.4.Value untuk menanyakan resource yang kedaluwarsa sebelum waktu tersebut.

    Filter.1.Value String Tidak 2017-12-05T22:40Z

    Nilai filter 1 yang digunakan untuk menanyakan resource. Tetapkan nilainya ke waktu. Jika Anda menentukan parameter ini, Anda juga harus menentukan Filter.1.Key. Tentukan waktu dalam format yyyy-MM-ddTHH:mmZ. Waktu harus dalam UTC.

    Filter.2.Value String Tidak 2017-12-06T22:40Z

    Nilai filter 2 yang digunakan untuk menanyakan resource. Tetapkan nilainya ke waktu. Jika Anda menentukan parameter ini, Anda juga harus menentukan Filter.2.Key. Tentukan waktu dalam format yyyy-MM-ddTHH:mmZ. Waktu harus dalam UTC.

    Filter.3.Value String Tidak 2017-12-07T22:40Z

    Nilai filter 3 yang digunakan untuk menanyakan resource. Tetapkan nilainya ke waktu. Jika Anda menentukan parameter ini, Anda juga harus menentukan Filter.3.Key. Tentukan waktu dalam format yyyy-MM-ddTHH:mmZ. Waktu harus dalam UTC.

    Filter.4.Value String Tidak 2017-12-08T22:40Z

    Nilai filter 4 yang digunakan untuk menanyakan resource. Tetapkan nilainya ke waktu. Jika Anda menentukan parameter ini, Anda juga harus menentukan Filter.4.Key. Tentukan waktu dalam format yyyy-MM-ddTHH:mmZ. Waktu harus dalam UTC.

    DeviceAvailable Boolean Tidak false
    Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia untuk umum.
    IoOptimized Boolean Tidak true

    Menentukan apakah instans dioptimalkan I/O. Nilai yang valid:

    • true
    • false
    NeedSaleCycle Boolean Tidak false
    Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia untuk umum.
    InstanceType String Tidak ecs.g5.large

    Tipe instans instans.

    InstanceTypeFamily String Tidak ecs.g5

    Keluarga instans instans.

    KeyPairName String Tidak KeyPairNameTest

    Nama pasangan kunci SSH yang terikat ke instans.

    ResourceGroupId String Tidak rg-bp67acfmxazb4p****

    ID kelompok sumber daya tempat instans ditugaskan. Jika parameter ini ditentukan untuk menanyakan resource, hingga 1.000 resource yang termasuk dalam kelompok sumber daya yang ditentukan akan dikembalikan.

    Catatan Elastic network interfaces (ENIs) dalam kelompok sumber daya default ditampilkan dalam respons terlepas dari bagaimana parameter ini diatur.
    HpcClusterId String Tidak hpc-bp67acfmxazb4p****

    ID kluster komputasi kinerja tinggi (HPC) tempat instans berada.

    RdmaIpAddresses String Tidak 10.10.10.102

    Alamat IP remote direct memory access (RDMA) instans yang termasuk dalam kluster HPC.

    DryRun Boolean Tidak false

    Menentukan apakah hanya menjalankan dry run tanpa melakukan permintaan aktual. Nilai yang valid:

    • true: hanya menjalankan dry run. Sistem memeriksa permintaan terhadap potensi masalah, termasuk Pasangan Kunci Akses yang tidak valid, pengguna RAM yang tidak berwenang, dan nilai parameter yang hilang. Jika permintaan gagal dalam dry run, pesan kesalahan dikembalikan. Jika tidak, kode kesalahan DryRunOperation dikembalikan.
    • false: menjalankan dry run dan melakukan permintaan aktual. Jika permintaan lolos dry run, kode status HTTP 2xx dikembalikan dan operasi dilakukan.

    Nilai default: false.

    HttpEndpoint String Tidak enabled

    Menentukan apakah saluran akses diaktifkan untuk metadata instans. Nilai yang valid:

    • enabled
    • disabled

    Nilai default: enabled.

    Catatan Untuk informasi selengkapnya tentang metadata instans, lihat Ikhtisar metadata instans ECS.
    HttpTokens String Tidak optional

    Menunjukkan apakah mode penguatan keamanan (IMDSv2) dipaksakan untuk mengakses metadata instans. Nilai yang valid:

    • optional: Mode penguatan keamanan (IMDSv2) tidak dipaksakan.
    • required: Mode penguatan keamanan (IMDSv2) dipaksakan. Setelah Anda mengatur parameter ini ke required, Anda tidak dapat mengakses metadata instans dalam mode normal.

    Nilai default: optional.

    Catatan Untuk informasi selengkapnya tentang mode akses metadata instans, lihat Mode akses metadata instans.
    HttpPutResponseHopLimit Integer Tidak 0
    Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia untuk umum.
    Ipv6Address.N String Tidak 2408:4321:180:1701:94c7:bc38:3bfa:****

    Alamat IPv6 N dari ENI. Anda dapat menentukan beberapa alamat IPv6. Nilai N yang valid: 1 hingga 100.

    Tag.N.key String Tidak keyTest

    Kunci tag N instans.

    Catatan Parameter ini akan dihapus di masa mendatang. Kami menyarankan Anda menggunakan parameter Tag.N.Key untuk memastikan kompatibilitas di masa depan.
    Tag.N.Key String Tidak TestKey

    Kunci tag N instans. Nilai N yang valid: 1 hingga 20.

    Jika satu tag ditentukan untuk menanyakan resource, hingga 1.000 resource yang memiliki tag tersebut akan dikembalikan. Jika beberapa tag ditentukan untuk menanyakan resource, hingga 1.000 resource yang memiliki semua tag tersebut akan dikembalikan. Untuk menanyakan lebih dari 1.000 resource yang memiliki tag yang ditentukan, panggil operasi ListTagResources.

    Tag.N.Value String Tidak TestValue

    Nilai tag N instans. Nilai N yang valid: 1 hingga 20.

    Tag.N.value String Tidak valueTest

    Nilai tag N instans.

    Catatan Parameter ini akan dihapus di masa mendatang. Kami menyarankan Anda menggunakan parameter Tag.N.Value untuk memastikan kompatibilitas di masa depan.
    AdditionalAttributes.N String Tidak META_OPTIONS

    Nilai atribut N. Nilai N yang valid: 1 hingga 20. Nilai yang valid:

    • META_OPTIONS: metadata instans
    • DDH_CLUSTER: kluster host khusus
    • NETWORK_PRIMARY_ENI_IP: alamat IP sekunder yang terkait dengan ENI primer
    • CPU_OPTIONS_TOPOLOGY_TYPE: topologi CPU instans

    Parameter respons

    Parameter

    Tipe

    Contoh

    Deskripsi
    NextToken String caeba0bbb2be03f84eb48b699f0a4883

    Token paginasi. Dapat digunakan dalam permintaan berikutnya untuk mengambil halaman baru hasil.

    PageSize Integer 10

    Jumlah entri per halaman.

    PageNumber Integer 1

    Nomor halaman.

    RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

    ID permintaan.

    TotalCount Integer 1

    Jumlah total instans yang ditanyakan.

    Catatan Jika Anda menentukan parameter MaxResults dan NextToken untuk melakukan kueri berhalaman, nilai TotalCount tidak valid.
    Instances Array of Instance

    Instans yang ditanyakan.

    Instance
    CreationTime String 2017-12-10T04:04Z

    Waktu saat instans dibuat. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC. Untuk informasi selengkapnya, lihat ISO 8601.

    SerialNumber String 51d1353b-22bf-4567-a176-8b3e12e4****

    Nomor seri instans.

    Status String Running

    Status instans.

    DeploymentSetId String ds-bp67acfmxazb4p****

    ID set penyebaran tempat instans ditempatkan.

    KeyPairName String testKeyPairName

    Nama pasangan kunci yang diikat ke instans.

    SaleCycle String month
    Catatan Parameter ini dihapus.
    SpotStrategy String NoSpot

    Kebijakan penawaran untuk instans pay-as-you-go. Nilai yang valid:

    • NoSpot: Instans adalah instans pay-as-you-go reguler.
    • SpotWithPriceLimit: Instans adalah instans preemptible dengan harga maksimum per jam yang ditentukan pengguna.
    • SpotAsPriceGo: Instans adalah instans preemptible yang menggunakan harga pasar secara otomatis sebagai harga penawaran. Harga pasar dapat mencapai harga pay-as-you-go.
    DeviceAvailable Boolean true

    Menunjukkan apakah disk data dapat disambungkan ke instans.

    • true
    • false
    LocalStorageCapacity Long 1000

    Kapasitas disk lokal yang disambungkan ke instans. Satuan: GiB.

    Description String testDescription

    Deskripsi instans.

    SpotDuration Integer 1

    Periode perlindungan instans preemptible. Satuan: jam. Nilai yang valid:

    • 1: Setelah instans preemptible dibuat, Alibaba Cloud memastikan bahwa instans tidak dilepaskan secara otomatis dalam waktu 1 jam. Setelah periode perlindungan 1 jam berakhir, sistem membandingkan harga penawaran dengan harga pasar dan memeriksa inventaris sumber daya untuk menentukan apakah akan mempertahankan atau melepaskan instans.
    • 0: Setelah instans preemptible dibuat, Alibaba Cloud tidak menjamin bahwa instans berjalan selama 1 jam. Sistem membandingkan harga penawaran dengan harga pasar dan memeriksa inventaris sumber daya untuk menentukan apakah akan mempertahankan atau melepaskan instans.

    Alibaba Cloud mengirimkan event sistem ECS untuk memberi tahu Anda 5 menit sebelum instans dilepaskan. Instans preemptible ditagih per detik. Kami menyarankan Anda menentukan periode perlindungan yang sesuai berdasarkan kebutuhan bisnis Anda.

    Catatan Parameter ini dikembalikan ketika parameter SpotStrategy diatur ke SpotWithPriceLimit atau SpotAsPriceGo.
    InstanceNetworkType String vpc

    Jenis jaringan instans. Nilai yang valid:

    • classic
    • vpc
    InstanceName String InstanceNameTest

    Nama instans.

    OSNameEn String CentOS 7.4 64 bit

    Nama bahasa Inggris sistem operasi instans.

    HpcClusterId String hpc-bp67acfmxazb4p****

    ID kluster HPC tempat instans berada.

    SpotPriceLimit Float 0.98

    Harga maksimum per jam instans. Dapat akurat hingga tiga tempat desimal. Parameter ini berlaku ketika parameter SpotStrategy diatur ke SpotWithPriceLimit.

    Memory Integer 16384

    Ukuran memori instans. Satuan: MiB.

    OSName String CentOS 7.4 64-bit

    Nama sistem operasi instans.

    DeploymentSetGroupNo Integer 1

    Nomor grup set penyebaran tempat instans berada dalam set penyebaran.

    ImageId String m-bp67acfmxazb4p****

    ID citra instans.

    VlanId String 10

    ID virtual LAN (VLAN) instans.

    Catatan Parameter ini akan dihapus di masa mendatang. Kami menyarankan Anda menggunakan parameter lain untuk memastikan kompatibilitas di masa depan.
    ClusterId String c-bp67acfmxazb4p****

    ID kluster tempat instans berada.

    Catatan Parameter ini akan dihapus di masa mendatang. Kami menyarankan Anda menggunakan parameter lain untuk memastikan kompatibilitas di masa depan.
    GPUSpec String NVIDIA V100

    Model GPU yang digunakan oleh tipe instans.

    AutoReleaseTime String 2017-12-10T04:04Z

    Waktu saat instans pay-as-you-go dilepaskan secara otomatis.

    DeletionProtection Boolean false

    Atribut perlindungan pelepasan instans. Parameter ini menunjukkan apakah Anda dapat menggunakan Konsol ECS atau memanggil operasi DeleteInstance untuk melepaskan instans.

    • true: Perlindungan pelepasan diaktifkan untuk instans.
    • false: Perlindungan pelepasan dinonaktifkan untuk instans.
    Catatan Parameter ini hanya berlaku untuk instans pay-as-you-go. Parameter ini dapat melindungi instans dari pelepasan manual, tetapi tidak dari pelepasan otomatis.
    StoppedMode String KeepCharging

    Menunjukkan apakah instans terus ditagih setelah dihentikan. Nilai yang valid:

    • KeepCharging: Instans dihentikan dalam mode standar. Penagihan instans berlanjut setelah instans dihentikan, dan sumber daya dipertahankan untuk instans.
    • StopCharging: Instans dihentikan dalam mode hemat. Penagihan untuk beberapa sumber daya instans berhenti setelah instans dihentikan. Saat instans dihentikan, sumber dayanya seperti vCPU, memori, dan alamat IP publik dilepaskan. Instans mungkin tidak dapat dinyalakan kembali jika beberapa sumber daya yang diperlukan tidak tersedia di wilayah saat ini.
    • Not-applicable: Mode hemat tidak berlaku untuk instans.
    GPUAmount Integer 4

    Jumlah GPU yang digunakan oleh tipe instans.

    HostName String testHostName

    Hostname instans.

    InstanceId String i-bp67acfmxazb4p****

    ID instans.

    InternetMaxBandwidthOut Integer 5

    Bandwidth publik keluar maksimum. Satuan: Mbit/s.

    InternetMaxBandwidthIn Integer 50

    Bandwidth masuk publik maksimum. Satuan: Mbit/s.

    InstanceType String ecs.g5.large

    Tipe instans.

    InstanceChargeType String PostPaid

    Metode penagihan instans. Nilai yang valid:

    • PrePaid: subscription
    • PostPaid: pay-as-you-go
    RegionId String cn-hangzhou

    ID wilayah instans.

    IoOptimized Boolean true

    Menunjukkan apakah instans dioptimalkan I/O.

    • true
    • false
    StartTime String 2017-12-10T04:04Z

    Waktu saat instans terakhir dinyalakan. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC. Untuk informasi selengkapnya, lihat ISO 8601.

    Cpu Integer 8

    Jumlah vCPU.

    LocalStorageAmount Integer 2

    Jumlah disk lokal yang disambungkan ke instans.

    ExpiredTime String 2017-12-10T04:04Z

    Waktu saat instans kedaluwarsa. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC. Untuk informasi selengkapnya, lihat ISO 8601.

    ResourceGroupId String rg-bp67acfmxazb4p****

    ID kelompok sumber daya tempat instans berada.

    InternetChargeType String PayByTraffic

    Metode penagihan penggunaan jaringan. Nilai yang valid:

    • PayByBandwidth
    • PayByTraffic
    ZoneId String cn-hangzhou-g

    ID zona instans.

    Recyclable Boolean false

    Menunjukkan apakah instans dapat didaur ulang.

    ISP String null
    Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia untuk umum.
    CreditSpecification String Standard

    Mode kinerja instans burstable. Nilai yang valid:

    • Standard: mode standar. Untuk informasi selengkapnya, lihat bagian "Mode standar" dalam Ikhtisar.
    • Unlimited: mode tanpa batas. Untuk informasi selengkapnya, lihat bagian "Mode tanpa batas" dalam Ikhtisar.
    InstanceTypeFamily String ecs.g5

    Keluarga instans instans.

    OSType String linux

    Jenis sistem operasi instans. Nilai yang valid:

    • windows
    • linux
    NetworkInterfaces Array of NetworkInterface

    ENI yang terikat ke instans.

    NetworkInterface
    Type String Primary

    Jenis ENI. Nilai yang valid:

    • Primary
    • Secondary
    MacAddress String 00:16:3e:32:b4:**

    Alamat media access control (MAC) ENI.

    PrimaryIpAddress String 172.17.**.***

    Alamat IP pribadi utama ENI.

    NetworkInterfaceId String eni-2zeh9atclduxvf1z****

    ID ENI.

    PrivateIpSets Array of PrivateIpSet

    Alamat IP pribadi.

    PrivateIpSet
    PrivateIpAddress String 172.17.**.**

    Alamat IP pribadi instans.

    Primary Boolean true

    Menunjukkan apakah alamat IP pribadi adalah alamat IP pribadi utama.

    • true
    • false
    Ipv6Sets Array of Ipv6Set

    Alamat IPv6 yang ditetapkan ke ENI. Parameter ini memiliki nilai hanya ketika AdditionalAttributes.N diatur ke NETWORK_PRIMARY_ENI_IP.

    Ipv6Set
    Ipv6Address String 2408:4321:180:1701:94c7:bc38:3bfa:***

    Alamat IPv6 yang ditetapkan ke ENI.

    Ipv4PrefixSets Array of Ipv4PrefixSet

    Awalan IPv4 yang ditetapkan ke ENI. Parameter ini memiliki nilai hanya ketika AdditionalAttributes.N diatur ke NETWORK_PRIMARY_ENI_IP.

    Ipv4PrefixSet
    Ipv4Prefix String 192.168.*.*/28

    Awalan IPv4 yang ditetapkan ke ENI.

    Ipv6PrefixSets Array of Ipv6PrefixSet

    Awalan IPv6 yang ditetapkan ke ENI. Parameter ini memiliki nilai hanya ketika AdditionalAttributes.N diatur ke NETWORK_PRIMARY_ENI_IP.

    Ipv6PrefixSet
    Ipv6Prefix String 2001:1111:*:*::/80

    Awalan IPv6 yang ditetapkan ke ENI.

    OperationLocks Array of LockReason

    Alasan instans dikunci.

    LockReason
    LockMsg String The specified instance is locked due to financial reason.

    Pesan yang dikembalikan saat instans dikunci.

    LockReason String Recycling

    Alasan instans dikunci. Nilai yang valid:

    • financial: Instans dikunci karena pembayaran tertunda.
    • security: Instans dikunci karena alasan keamanan.
    • recycling: Instans preemptible dikunci dan menunggu pelepasan.
    • dedicatedhostfinancial: Instans dikunci karena pembayaran tertunda untuk host khusus.
    • refunded: Instans dikunci karena pengembalian dana dilakukan untuk instans tersebut.
    Tags Array of Tag

    Tag instans.

    Tag
    TagValue String TestValue

    Nilai tag instans.

    TagKey String TestKey

    Kunci tag instans.

    RdmaIpAddress Array of String 10.10.10.102

    Alamat IP RDMA instans yang termasuk dalam kluster HPC.

    SecurityGroupIds Array of String sg-bp67acfmxazb4p****

    ID grup keamanan tempat instans berada.

    PublicIpAddress Array of String 121.40.**.**

    Alamat IP publik instans.

    InnerIpAddress Array of String 10.170.**.**

    Alamat IP internal instans yang berada di jaringan klasik.

    VpcAttributes Object

    Atribut VPC instans.

    VpcId String vpc-2zeuphj08tt7q3brd****

    ID VPC.

    NatIpAddress String 172.17.**.**

    Alamat IP NAT instans. Digunakan oleh instans ECS di VPC berbeda untuk komunikasi.

    VSwitchId String vsw-2zeh0r1pabwtg6wcs****

    ID vSwitch.

    PrivateIpAddress Array of String 172.17.**.**

    Alamat IP pribadi instans.

    EipAddress Object

    EIP yang terkait dengan instans.

    IsSupportUnassociate Boolean true

    Menunjukkan apakah EIP dapat diputuskan asosiasinya.

    InternetChargeType String PayByTraffic

    Metode penagihan EIP. Nilai yang valid:

    • PayByBandwidth
    • PayByTraffic
    IpAddress String 42.112.**.**

    EIP.

    Bandwidth Integer 5

    Bandwidth publik maksimum EIP. Satuan: Mbit/s.

    AllocationId String eip-2ze88m67qx5z****

    ID EIP.

    HibernationOptions Object
    Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia untuk umum.
    Configured Boolean false
    Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia untuk umum.
    DedicatedHostAttribute Object

    Informasi tentang host khusus. Merupakan array yang terdiri dari parameter DedicatedHostClusterId, DedicatedHostId, dan DedicatedHostName.

    DedicatedHostId String dh-bp67acfmxazb4p****

    ID host khusus.

    DedicatedHostName String testDedicatedHostName

    Nama host khusus.

    DedicatedHostClusterId String dc-bp67acfmxazb4h****

    ID kluster host khusus tempat host khusus berada.

    EcsCapacityReservationAttr Object

    Kapasitas reservasi yang terkait dengan instans.

    CapacityReservationPreference String cr-bp67acfmxazb4p****

    Preferensi kapasitas reservasi.

    CapacityReservationId String cr-bp67acfmxazb4p****

    ID kapasitas reservasi.

    DedicatedInstanceAttribute Object

    Atribut instans pada host khusus.

    Affinity String default

    Menunjukkan apakah instans pada host khusus diasosiasikan dengan host khusus. Nilai yang valid:

    • default: Instans tidak diasosiasikan dengan host khusus. Saat instans dinyalakan dari mode hemat, instans mungkin secara otomatis ditempatkan pada host khusus lain dalam kolam sumber daya penyebaran otomatis.
    • host: Instans diasosiasikan dengan host khusus. Saat instans dinyalakan dari mode hemat, instans tetap ditempatkan pada host khusus asal.
    Tenancy String default

    Menunjukkan apakah instans di-host pada host khusus. Nilai yang valid:

    • default: Instans tidak di-host pada host khusus.
    • host: Instans di-host pada host khusus.
    CpuOptions Object

    Opsi CPU.

    Numa String 2

    Jumlah thread yang dialokasikan. Nilai yang valid: 2.

    CoreCount Integer 2

    Jumlah core CPU fisik.

    ThreadsPerCore Integer 4

    Jumlah thread per core CPU.

    TopologyType String DiscreteCoreToHTMapping

    Jenis topologi CPU instans. Nilai yang valid:

    • ContinuousCoreToHTMapping: Mode kontinu Hyper-Threading (HT)
    • DiscreteCoreToHTMapping: Mode diskrit HT
    MetadataOptions Object

    Opsi metadata.

    HttpEndpoint String enabled

    Menunjukkan apakah saluran akses diaktifkan untuk metadata instans. Nilai yang valid:

    • enabled
    • disabled
    HttpPutResponseHopLimit Integer 0
    Catatan Parameter ini tidak tersedia untuk umum.
    HttpTokens String optional

    Menunjukkan apakah mode penguatan keamanan (IMDSv2) dipaksakan untuk mengakses metadata instans. Nilai yang valid:

    • optional: Mode penguatan keamanan (IMDSv2) tidak dipaksakan.
    • required: Mode penguatan keamanan (IMDSv2) dipaksakan.
    ImageOptions Object

    Opsi citra.

    LoginAsNonRoot Boolean false

    Menunjukkan apakah instans yang menggunakan citra mendukung login pengguna ecs-user. Nilai yang valid:

    • true
    • false
    SpotInterruptionBehavior String Terminate

    Mode interupsi instans preemptible ketika sistem memulai operasi interupsi instans preemptible. Nilai yang valid:

    • terminate: melepaskan instans preemptible.
    • Stop: menghentikan instans dalam mode hemat.

    Contoh

    Permintaan contoh

    https://ecs.aliyuncs.com/?Action=DescribeInstances
&RegionId=cn-hangzhou
&PageSize=1
&PageNumber=1
&<Common request parameters>

    Respons sukses contoh

    XML format

    HTTP/1.1 200 OK
Content-Type:application/xml

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

    JSON format

    HTTP/1.1 200 OK
Content-Type:application/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-bit",
      "DeploymentSetGroupNo" : 1,
      "ImageId" : "m-bp67acfmxazb4p****",
      "VlanId" : "10",
      "ClusterId" : "c-bp67acfmxazb4p****",
      "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
            } ]
          },
          "Ipv6Sets" : {
            "Ipv6Set" : [ {
              "Ipv6Address" : "2408:4321:180:1701:94c7:bc38:3bfa:***"
            } ]
          },
          "Ipv4PrefixSets" : {
            "Ipv4PrefixSet" : [ {
              "Ipv4Prefix" : "192.168.*.*/28"
            } ]
          },
          "Ipv6PrefixSets" : {
            "Ipv6PrefixSet" : [ {
              "Ipv6Prefix" : "2001:1111:*:*::/80"
            } ]
          },
          "OperationLocks" : {
            "OperationLock" : [ {
              "LockMsg" : "The specified instance is locked due to financial reason.",
              "LockReason" : "Recycling"
            } ]
          },
          "Tags" : {
            "Tag" : [ {
              "TagValue" : "TestValue",
              "TagKey" : "TestKey"
            } ]
          },
          "RdmaIpAddresses" : {
            "RdmaIpAddress" : [ "10.10.10.102" ]
          },
          "SecurityGroupIds" : {
            "SecurityGroupId" : [ "sg-bp67acfmxazb4p****" ]
          },
          "PublicIpAddress" : {
            "PublicIpAddres" : [ "121.40.**.**" ]
          },
          "InnerIpAddress" : {
            "InnerIpAddres" : [ "10.170.**.**" ]
          },
          "VpcAttributes" : {
            "VpcId" : "vpc-2zeuphj08tt7q3brd****",
            "NatIpAddress" : "172.17.**.**",
            "VSwitchId" : "vsw-2zeh0r1pabwtg6wcs****",
            "PrivateIpAddress" : {
              "PrivateIpAddres" : [ "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" : "2",
            "CoreCount" : 2,
            "ThreadsPerCore" : 4
          },
          "MetadataOptions" : {
            "HttpEndpoint" : "enabled",
            "HttpPutResponseHopLimit" : 0,
            "HttpTokens" : "optional"
          },
          "ImageOptions" : {
            "LoginAsNonRoot" : false
          }
        } ]
      }
    } ]
  }
}

    Kode kesalahan

    Kode status HTTP

    Kode kesalahan

    Pesan kesalahan

    Deskripsi
    400 InvalidTag.Mismatch The specified Tag.n.Key and Tag.n.Value are not match. Nilai Tag.N.Key dan Tag.N.Value tidak sesuai satu sama lain.
    400 InvalidTagCount The specified tags are beyond the permitted range. Jumlah maksimum tag telah terlampaui.
    400 InvalidHpcClusterId.NotFound The specified HpcClusterId is not found. Nilai HpcClusterId yang ditentukan tidak ditemukan.
    400 InvalidHpcClusterId.Creating The specified HpcClusterId is creating. Kluster HPC sedang dibuat.
    400 InternalError The request processing has failed due to some unknown error, exception or failure. Terjadi kesalahan internal. Coba lagi nanti.
    404 InvalidInstanceChargeType.NotFound The InstanceChargeType does not exist in our records. Nilai InstanceChargeType tidak valid.
    404 InvalidInternetChargeType.ValueNotSupported The specified InternetChargeType is not valid. Nilai InternetChargeType tidak valid.
    404 InvalidLockReason.NotFound The specified LockReason is not found. Nilai LockReason yang ditentukan tidak ditemukan.
    404 InvalidStatus.NotFound The specified Status is not found. Nilai Status yang ditentukan tidak ditemukan.

    Untuk daftar kode kesalahan, lihat Kode kesalahan layanan.