全部产品
Search
文档中心

Resource Orchestration Service:DATASOURCE::ECS::Instances

更新时间:Jun 26, 2025

DATASOURCE::ECS::Instances digunakan untuk menanyakan informasi tentang instance Elastic Compute Service (ECS).

Sintaksis

{
  "Type": "DATASOURCE::ECS::Instances",
  "Properties": {
    "InnerIpAddresses": List,
    "ResourceGroupId": String,
    "PrivateIpAddresses": List,
    "InstanceChargeType": String,
    "InstanceTypeFamily": String,
    "InstanceNetworkType": String,
    "Filters": List,
    "AdditionalAttributes": List,
    "ImageId": String,
    "PublicIpAddresses": List,
    "RdmaIpAddresses": String,
    "InstanceIds": List,
    "InstanceType": String,
    "Ipv6Address": List,
    "Tags": List,
    "Status": String,
    "KeyPairName": String,
    "IoOptimized": Boolean,
    "ZoneId": String,
    "InstanceId": String,
    "HpcClusterId": String,
    "VSwitchId": String,
    "SecurityGroupId": String,
    "InternetChargeType": String,
    "InstanceName": String,
    "EipAddresses": List,
    "VpcId": String,
    "RefreshOptions": String
  }
}

Properti

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Kendala

InnerIpAddresses

List

Tidak

Ya

Alamat IP internal dari instance yang diterapkan di jaringan klasik.

Properti ini berlaku ketika InstanceNetworkType disetel ke classic.

Anda dapat menentukan hingga 100 alamat IP. Pisahkan beberapa alamat IP dengan koma (,).

Contoh: ["10.1.1.1", "10.1.2.1", … "10.1.10.1"].

ResourceGroupId

String

Tidak

Ya

ID grup sumber daya tempat instance tersebut termasuk.

Tidak ada.

PrivateIpAddresses

List

Tidak

Ya

Alamat IP privat dari instance yang diterapkan di virtual private clouds (VPC).

Properti ini berlaku ketika InstanceNetworkType disetel ke vpc.

Anda dapat menentukan hingga 100 alamat IP. Pisahkan beberapa alamat IP dengan koma (,).

Contoh: ["172.16.1.1", "172.16.2.1", … "172.16.10.1"].

InstanceChargeType

String

Tidak

Ya

Metode penagihan instance.

Nilai valid:

  • PostPaid

  • PrePaid

InstanceTypeFamily

String

Tidak

Ya

Keluarga instance.

Tidak ada.

InstanceNetworkType

String

Tidak

Ya

Jenis jaringan instance.

Nilai valid:

  • classic

  • vpc

Filters

List

Tidak

Ya

Filter yang ingin Anda gunakan untuk menanyakan sumber daya.

Untuk informasi lebih lanjut, lihat Properti Filters.

AdditionalAttributes

List

Tidak

Ya

Atribut tambahan.

Nilai valid:

  • META_OPTIONS: metadata instans

  • DDH_CLUSTER: kluster host khusus

  • NETWORK_PRIMARY_ENI_IP: alamat IP sekunder terkait dengan antarmuka jaringan elastis utama (ENI)

ImageId

String

Tidak

Ya

ID gambar.

Tidak ada.

PublicIpAddresses

List

Tidak

Ya

Alamat IP publik dari instance.

Anda dapat menentukan hingga 100 alamat IP. Pisahkan beberapa alamat IP dengan koma (,).

Contoh: ["192.0.2.0", "192.0.2.1", …, "192.0.2.10"].

RdmaIpAddresses

String

Tidak

Ya

Alamat Remote Direct Memory Access (RDMA) dari instance yang termasuk dalam High Performance Computing (HPC) cluster.

Tidak ada.

InstanceIds

List

Tidak

Ya

ID instance.

Anda dapat menentukan hingga 100 ID. Pisahkan beberapa ID dengan koma (,).

InstanceType

String

Tidak

Ya

Tipe instance.

Tidak ada.

Ipv6Address

List

Tidak

Ya

Alamat IPv6 dari ENI.

Anda dapat menentukan hingga 100 alamat IP. Pisahkan beberapa alamat IP dengan koma (,).

Tags

List

Tidak

Ya

Tag instance.

Anda dapat menambahkan hingga 20 tag.

Untuk informasi lebih lanjut, lihat Properti Tags.

Status

String

Tidak

Ya

Status instance.

Nilai valid:

  • Pending: Instance sedang dibuat.

  • Running: Instance sedang berjalan.

  • Starting: Instance sedang dimulai.

  • Stopping: Instance sedang dihentikan.

  • Stopped: Instance telah dihentikan.

KeyPairName

String

Tidak

Ya

Nama pasangan kunci SSH yang terikat pada instance.

Tidak ada.

IoOptimized

Boolean

Tidak

Ya

Menentukan apakah instance adalah instance dioptimalkan I/O.

Nilai valid:

  • true

  • false

ZoneId

String

Tidak

Ya

ID zona.

Tidak ada.

InstanceId

String

Tidak

Ya

ID instance.

Tidak ada.

HpcClusterId

String

Tidak

Ya

ID HPC cluster tempat instance tersebut termasuk.

Tidak ada.

VSwitchId

String

Tidak

Ya

ID vSwitch.

Tidak ada.

SecurityGroupId

String

Tidak

Ya

ID grup keamanan.

Tidak ada.

InternetChargeType

String

Tidak

Ya

Metode pengukuran untuk penggunaan jaringan.

Nilai valid:

  • PayByBandwidth

  • PayByTraffic

InstanceName

String

Tidak

Ya

Nama instance.

Tidak ada.

EipAddresses

List

Tidak

Ya

Alamat elastic IP (EIP) dari instance.

Properti ini berlaku ketika InstanceNetworkType disetel ke vpc.

Anda dapat menentukan hingga 100 EIP. Pisahkan beberapa EIP dengan koma (,).

VpcId

String

Tidak

Ya

ID VPC.

Tidak ada.

RefreshOptions

String

Tidak

Ya

Kebijakan refresh untuk sumber daya sumber data saat tumpukan diperbarui.

Nilai valid:

  • Never (default): tidak merefresh sumber daya sumber data saat tumpukan diperbarui.

  • Always: merefresh sumber daya sumber data saat tumpukan diperbarui.

Sintaksis Filters

"Filters": [
  {
    "Value": String,
    "Key": String
  }
]

Properti Filters

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Kendala

Key

String

Ya

Tidak

Kunci filter.

Tetapkan nilai menjadi CreationStartTime. Nilai CreationStartTime menentukan awal rentang waktu selama mana sumber daya dibuat.

Anda dapat menentukan baik Key dan Value untuk menanyakan sumber daya yang dibuat setelah titik waktu tertentu.

Value

String

Tidak

Tidak

Nilai filter.

Tentukan waktu dalam standar ISO 8601 dalam format yyyy-MM-ddTHH:mmZ. Waktu harus dalam UTC+0.

Sintaksis Tags

"Tags": [
  {
    "Value": String,
    "Key": String
  }
]

Properti Tags

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Kendala

Key

String

Ya

Tidak

Kunci tag.

Tidak ada.

Value

String

Tidak

Tidak

Nilai tag.

Tidak ada.

Nilai Pengembalian (Fn::GetAtt)

  • InstanceIds: ID instance.

  • Instances: Detail instance.

Properti

Tipe

Deskripsi

Kendala

InstanceIds

List

ID instance.

Tidak ada.

Instances

List

Detail instance.

Tidak ada.

SerialNumber

String

Nomor seri instance.

Tidak ada.

Status

String

Status instance.

Tidak ada.

DeploymentSetId

String

ID set penyebaran.

Tidak ada.

SpotStrategy

String

Kebijakan preemption untuk instance bayar sesuai pemakaian.

Nilai valid:

  • NoSpot: Instance dibuat sebagai instance bayar sesuai pemakaian biasa.

  • SpotWithPriceLimit: Instance dibuat sebagai instance preemptible yang memiliki harga maksimum per jam yang ditentukan pengguna.

  • SpotAsPriceGo: Instance dibuat sebagai instance preemptible di mana harga pasar pada saat pembelian secara otomatis digunakan sebagai harga penawaran. Harga pasar bisa mencapai harga bayar sesuai pemakaian.

DeviceAvailable

Boolean

Menunjukkan apakah disk data dapat dilampirkan ke instance.

Nilai valid:

  • true

  • false

Description

String

Deskripsi instance.

Tidak ada.

InstanceNetworkType

String

Jenis jaringan instance.

Nilai valid:

  • classic

  • vpc

InstanceName

String

Nama instance.

Tidak ada.

OSNameEn

String

Nama OS instance dalam bahasa Inggris.

Tidak ada.

SpotPriceLimit

Number

Harga maksimum per jam dari instance.

Properti ini berlaku ketika SpotStrategy disetel ke SpotWithPriceLimit.

Memory

Number

Ukuran memori.

Satuan: MiB.

OSName

String

Nama OS instance dalam bahasa Cina.

Tidak ada.

ImageId

String

ID gambar.

Tidak ada.

GPUSpec

String

Model GPU yang digunakan oleh tipe instance.

Tidak ada.

StoppedMode

String

Mode di mana instance dihentikan. Properti ini menentukan apakah sistem masih mengimplementasikan penagihan untuk instance setelah instance dihentikan.

Nilai valid:

  • KeepCharging: mode standar. Sistem masih mengimplementasikan penagihan untuk instance setelah instance dihentikan, dan mempertahankan sumber daya instance.

  • StopCharging: mode hemat biaya. Sistem tidak mengimplementasikan penagihan untuk sumber daya tertentu dari instance setelah instance dihentikan, dan melepaskan sumber daya tersebut, seperti vCPU, memori, dan alamat IP publik.

  • Not-applicable: Mode hemat biaya tidak berlaku untuk instance.

GPUAmount

Number

Jumlah GPU yang digunakan oleh tipe instance.

Tidak ada.

HostName

String

Nama host instance.

Tidak ada.

InstanceId

String

ID instance.

Tidak ada.

InternetMaxBandwidthOut

Number

Bandwidth publik keluar maksimum.

Satuan: Mbit/s.

InternetMaxBandwidthIn

Number

Bandwidth publik masuk maksimum.

Satuan: Mbit/s.

InstanceType

String

Tipe instance.

Tidak ada.

InstanceChargeType

String

Metode penagihan instance.

Nilai valid:

  • PrePaid

  • PostPaid

IoOptimized

Boolean

Menunjukkan apakah instance adalah instance dioptimalkan I/O.

Nilai valid:

  • true

  • false

Cpu

Number

Jumlah vCPU.

Tidak ada.

ResourceGroupId

String

ID grup sumber daya tempat instance tersebut termasuk.

Tidak ada.

InternetChargeType

String

Metode pengukuran untuk penggunaan jaringan.

Nilai valid:

  • PayByBandwidth

  • PayByTraffic

ZoneId

String

ID zona.

Tidak ada.

InstanceTypeFamily

String

Keluarga instance.

Tidak ada.

OSType

String

Tipe OS instance.

Nilai valid:

  • windows

  • linux

NetworkInterfaces

List

ENI yang dilampirkan ke instance.

Tidak ada.

Tags

List

Tag instance.

Tidak ada.

SecurityGroupIds

List

ID grup keamanan tempat instance tersebut termasuk.

Tidak ada.

PublicIpAddress

List

Alamat IP publik dari instance.

Tidak ada.

InnerIpAddress

List

Alamat IP internal dari instance yang diterapkan di jaringan klasik.

Tidak ada.

EipAddress

List

EIP dari instance.

Tidak ada.

DedicatedHostAttribute

List

Atribut host khusus.

Tidak ada.

EcsCapacityReservationAttr

List

Atribut reservasi kapasitas untuk instance.

Tidak ada.

DedicatedInstanceAttribute

List

Atribut instance pada host khusus.

Tidak ada.

OperationLocks

List

Alasan mengapa instance terkunci.

Tidak ada.

PrivateIpAddress

List

Alamat IP privat dari instance.

Tidak ada.

VpcId

String

ID VPC.

Tidak ada.

VswitchId

String

ID vSwitch.

Tidak ada.

Contoh

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  InstanceIds:
    Type: Json
    Default:
      - i-bp17f03tk0f4bi86***
Resources:
  NetworkInterfaces:
    Type: DATASOURCE::ECS::Instances
    Properties:
      InstanceIds:
        Ref: InstanceIds
Outputs:
  Images:
    Value:
      Fn::GetAtt:
        - NetworkInterfaces
        - InstanceIds
  ImageIds:
    Value:
      Fn::GetAtt:
        - NetworkInterfaces
        - Instances
                    
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "InstanceIds": {
      "Type": "Json",
      "Default": [
        "i-bp17f03tk0f4bi86***"
      ]
    }
  },
  "Resources": {
    "NetworkInterfaces": {
      "Type": "DATASOURCE::ECS::Instances",
      "Properties": {
        "InstanceIds": {
          "Ref": "InstanceIds"
        }
      }
    }
  },
  "Outputs": {
    "Images": {
      "Value": {
        "Fn::GetAtt": [
          "NetworkInterfaces",
          "InstanceIds"
        ]
      }
    },
    "ImageIds": {
      "Value": {
        "Fn::GetAtt": [
          "NetworkInterfaces",
          "Instances"
        ]
      }
    }
  }
}