All Products
Search
Document Center

Elastic Compute Service:DescribeInstanceAttribute

Last Updated:Jun 29, 2026

Mengkueri informasi atribut Instans ECS tertentu.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

  • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

  • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

  • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

  • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

    • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

    • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

  • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

  • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

ecs:DescribeInstanceAttribute

get

*Instance

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

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

InstanceId

string

Yes

ID instans.

i-uf6f5trc95ug8t33****

Elemen respons

Element

Type

Description

Example

object

Status

string

Status instans. Nilai valid:

  • Pending: sedang dibuat.

  • Running: berjalan.

  • Starting: sedang dimulai.

  • Stopping: sedang dihentikan.

  • Stopped: dihentikan.

Running

SerialNumber

string

Nomor seri instans.

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

CreationTime

string

Waktu pembuatan instans. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mmZ. Waktu ditampilkan dalam UTC. Untuk informasi selengkapnya, lihat ISO 8601.

2017-12-10T04:04Z

RequestId

string

ID permintaan.

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

Description

string

Deskripsi instans.

testDescription

InstanceName

string

Nama instans.

testInstanceName

InstanceNetworkType

string

Jenis jaringan instans. Nilai valid:

  • vpc: virtual private cloud (VPC).

  • classic: jaringan klasik. Jaringan klasik sudah tidak digunakan lagi. Untuk informasi selengkapnya, lihat Pemberitahuan penghentian.

vpc

Memory

integer

Ukuran memori. Unit: MiB.

16384

ImageId

string

ID image yang sedang berjalan pada instans.

m-bp1h46wfpjsjastc****

ClusterId

string

ID kluster tempat instans berada.

Catatan

Parameter ini akan segera dihentikan penggunaannya. Untuk memastikan kompatibilitas di masa mendatang, gunakan parameter lain.

cls-bp67acfmxazb4p****

VlanId

string

ID VLAN instans.

Catatan

Parameter ini akan segera dihentikan penggunaannya. Untuk memastikan kompatibilitas di masa mendatang, gunakan parameter lain.

10

StoppedMode

string

Apakah instans tetap ditagih setelah dihentikan. Nilai valid:

  • KeepCharging: Instans tetap ditagih setelah dihentikan. Sumber daya inventaris dicadangkan untuk instans.

  • StopCharging: Instans tidak ditagih setelah dihentikan. Setelah instans dihentikan, sumber dayanya seperti vCPU, memori, dan alamat IP publik akan dirilis. Apakah instans dapat dimulai ulang bergantung pada ketersediaan sumber daya di wilayah saat ini.

  • Not-applicable: Instans tidak mendukung fitur Tanpa Biaya untuk Instans yang Dihentikan.

KeepCharging

HostName

string

Hostname instans.

testHostName

InstanceId

string

ID instans.

i-uf6f5trc95ug8t33****

InstanceType

string

Tipe instans.

ecs.g5.large

InternetMaxBandwidthIn

integer

Bandwidth publik arah masuk maksimum. Unit: Mbit/s.

50

InternetMaxBandwidthOut

integer

Bandwidth publik arah keluar maksimum. Unit: Mbit/s.

5

RegionId

string

ID wilayah instans.

cn-hangzhou

InstanceChargeType

string

Metode penagihan instans. Nilai valid:

  • PrePaid: langganan.

  • PostPaid: bayar sesuai pemakaian.

PrePaid

IoOptimized

string

Apakah instans dioptimalkan I/O. Nilai valid:

  • optimized: dioptimalkan I/O.

  • none: tidak dioptimalkan I/O.

optimized

Cpu

integer

Jumlah inti vCPU.

8

ExpiredTime

string

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

2017-12-10T04:04Z

ZoneId

string

ID zona instans.

cn-hangzhou-g

InternetChargeType

string

Metode penagihan untuk bandwidth publik. Nilai valid:

  • PayByBandwidth: bayar berdasarkan bandwidth.

  • PayByTraffic: bayar berdasarkan Trafik.

Catatan

Dalam mode pay-by-traffic, bandwidth puncak arah masuk dan arah keluar digunakan sebagai batas atas bandwidth dan tidak dijamin. Ketika terjadi konflik sumber daya, bandwidth puncak dapat dibatasi. Jika workload Anda memerlukan bandwidth yang dijamin, gunakan mode pay-by-bandwidth.

PayByTraffic

CreditSpecification

string

Mode berjalan Instance Burstable. Nilai valid:

  • Jenis Penyimpanan Standar: mode standar. Untuk informasi selengkapnya tentang performa instans, lihat Mode performa.

  • Unlimited: mode tanpa batas. Untuk informasi selengkapnya tentang performa instans, lihat Mode performa.

Standard

SecurityGroupIds

object

SecurityGroupId

array

Grup keamanan tempat instans berada.

string

Grup keamanan tempat instans berada.

sg-bp1fg655nh68xyz9i****

PublicIpAddress

object

IpAddress

array

Daftar alamat IP publik instans.

string

Alamat IP publik instans.

121.40.**.**

InnerIpAddress

object

IpAddress

array

Daftar alamat IP jaringan internal instans jenis jaringan klasik.

Catatan

Jaringan klasik sudah tidak digunakan lagi. Untuk informasi selengkapnya, lihat Pemberitahuan penghentian.

string

Alamat IP jaringan internal instans jenis jaringan klasik.

192.168.**.**

VpcAttributes

object

Atribut VPC.

VpcId

string

ID VPC.

vpc-wz9e4e9pmbcnj6ki6****

NatIpAddress

string

Alamat IP layanan cloud, yang digunakan untuk komunikasi jaringan antarlayanan cloud yang terhubung ke VPC.

172.17.**.**

VSwitchId

string

ID vSwitch.

vsw-uf6ixacqz8osrwnqb****

PrivateIpAddress

object

IpAddress

array

Daftar alamat IP privat.

string

Alamat IP privat.

192.168.**.**

EipAddress

object

Informasi pengikatan Elastic IP Address (EIP).

InternetChargeType

string

Metode penagihan untuk bandwidth publik. Nilai valid:

  • PayByBandwidth: bayar berdasarkan bandwidth.

  • PayByTraffic: bayar berdasarkan Trafik.

Catatan

Dalam mode pay-by-traffic, bandwidth puncak arah masuk dan arah keluar digunakan sebagai batas atas bandwidth dan tidak dijamin. Ketika terjadi konflik sumber daya, bandwidth puncak dapat dibatasi. Jika workload Anda memerlukan bandwidth yang dijamin, gunakan mode pay-by-bandwidth.

PayByTraffic

IpAddress

string

EIP.

30.21.**.**

Bandwidth

integer

Batas bandwidth publik EIP. Unit: Mbit/s.

8

AllocationId

string

ID EIP.

eip-wz9uilio26dfscamm****

DedicatedHostAttribute

object

Atribut host spesifikasi khusus, yang terdiri dari ID kluster host spesifikasi khusus (DedicatedHostClusterId), ID host spesifikasi khusus (DedicatedHostId), dan nama host spesifikasi khusus (DedicatedHostName).

DedicatedHostName

string

Nama host khusus.

ecs-autoui-create-ddh-temp

DedicatedHostId

string

ID host khusus.

dh-2ze7qrzz6lvbfhr0****

OperationLocks

object

LockReason

array<object>

Daftar alasan penguncian.

object

Alasan penguncian.

LockReason

string

Alasan penguncian. Nilai yang mungkin:

  • financial: Dikunci karena keterlambatan pembayaran.

  • security: Dikunci karena alasan keamanan.

  • Recycling: Status terkunci menunggu rilis dari instance preemptible.

  • dedicatedhostfinancial: Instance ECS dikunci karena keterlambatan pembayaran dedicated host.

  • refunded: Dikunci karena pengembalian dana.

financial

EnableJumboFrame

boolean

Apakah fitur Jumbo Frame diaktifkan untuk Instans ECS. Nilai valid:

  • true: diaktifkan.

  • false: tidak diaktifkan.

Untuk informasi selengkapnya, lihat ECS instance MTU.

false

EnableNetworkEncryption

boolean

Apakah enkripsi lalu lintas jaringan VPC diaktifkan untuk instans. Nilai valid:

  • true: diaktifkan.

  • false: tidak diaktifkan.

Catatan

Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.

True

NetworkOptions

object

Atribut terkait jaringan.

Catatan

Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.

EnableJumboFrame

boolean

Apakah fitur Jumbo Frame diaktifkan untuk Instans ECS. Nilai valid:

  • true: diaktifkan.

  • false: tidak diaktifkan.

Untuk informasi selengkapnya, lihat ECS instance MTU.

Catatan

Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.

false

EnableNetworkEncryption

boolean

Apakah enkripsi lalu lintas jaringan VPC diaktifkan untuk instans. Nilai valid:

  • true: diaktifkan.

  • false: tidak diaktifkan.

Catatan

Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.

False

BandwidthWeighting

string

Bobot bandwidth.

Tipe instans yang berbeda mendukung nilai yang berbeda. Panggil DescribeInstanceTypes untuk mengkueri nilai bobot bandwidth yang didukung oleh tipe instans saat ini.

Valid values:

  • Vpc-L1 :

    Vpc-L1

  • Vpc-L2 :

    Vpc-L2

  • Ebs-L1 :

    Ebs-L1

  • Ebs-L2 :

    Ebs-L2

  • Default :

    Default.

Vpc-L1

Contoh

Respons sukses

JSONformat

{
  "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"
  }
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

500 InternalError The request processing has failed due to some unknown error.
404 InvalidInstanceId.NotFound The specified InstanceId does not exist.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.