全部產品
Search
文件中心

:DATASOURCE::ECS::Instances

更新時間:Oct 30, 2024

DATASOURCE::ECS::Instances類型用於查詢ECS執行個體的詳細資料。

文法

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

屬性

屬性名稱

類型

必須

允許更新

描述

約束

InnerIpAddresses

List

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

當InstanceNetworkType取值為classic時,該參數有效。

最多支援100個IP地址,多個IP地址間用半形逗號(,)分隔。

取值樣本:["10.1.1.1", "10.1.2.1", … "10.1.10.1"]

ResourceGroupId

String

執行個體所在的資源群組ID。

PrivateIpAddresses

List

VPC網路類型執行個體的私人IP地址。

當InstanceNetworkType取值為vpc時,該參數有效。

最多支援100個IP地址,多個IP地址間用半形逗號(,)分隔。

取值樣本:["172.16.1.1", "172.16.2.1", … "172.16.10.1"]

InstanceChargeType

String

執行個體的計費方式。

取值:

  • PostPaid:隨用隨付。

  • PrePaid:訂用帳戶。

InstanceTypeFamily

String

執行個體的規格類型系列。

InstanceNetworkType

String

執行個體的網路類型。

取值:

  • classic:傳統網路。

  • vpc:Virtual Private Cloud。

Filters

List

查詢資源時的過濾條件。

更多資訊,請參見Filters屬性

AdditionalAttributes

List

其他屬性值。

取值:

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

  • DDH_CLUSTER:Dedicated Host叢集。

  • NETWORK_PRIMARY_ENI_IP:主網卡輔助IP地址。

ImageId

String

鏡像ID。

PublicIpAddresses

List

執行個體的公網IP地址。

最多支援100個IP地址,多個IP地址間用半形逗號(,)分隔。

取值樣本:["192.0.2.0", "192.0.2.1", …, "192.0.2.10"]

RdmaIpAddresses

String

HPC執行個體的RDMA網路IP地址。

InstanceIds

List

執行個體ID列表。

最多支援100個執行個體ID,多個執行個體ID之間用半形逗號(,)分隔。

InstanceType

String

執行個體的規格。

Ipv6Address

List

彈性網卡的IPv6地址。

最多支援100個IP地址,多個地址之間用半形逗號(,)分隔。

Tags

List

執行個體的標籤。

最多支援20個標籤。

更多資訊,請參見Tags屬性

Status

String

執行個體的狀態。

取值:

  • Pending:建立中。

  • Running:運行中。

  • Starting:啟動中。

  • Stopping:停止中。

  • Stopped:已停止。

KeyPairName

String

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

IoOptimized

Boolean

是否為I/O最佳化型執行個體。

取值:

  • true:I/O最佳化。

  • false:非I/O最佳化。

ZoneId

String

可用性區域ID。

InstanceId

String

執行個體ID。

HpcClusterId

String

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

VSwitchId

String

交換器ID。

SecurityGroupId

String

安全性群組ID。

InternetChargeType

String

公網頻寬計費方式。

取值:

  • PayByBandwidth:按固定頻寬計費。

  • PayByTraffic:按使用流量計費。

InstanceName

String

執行個體的名稱。

EipAddresses

List

執行個體的Elastic IP Address地址。

當InstanceNetworkType取值為vpc時,該參數有效。

最多支援100個IP地址,多個IP地址間用半形逗號(,)分隔。

VpcId

String

專用網路ID。

RefreshOptions

String

當資源棧更新時,資料來源資源的重新整理策略。

有效值:

  • Never(預設值):更新堆棧時,從不重新整理資料來源資源。

  • Always:更新堆棧時,始終重新整理資料來源資源。

Filters文法

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

Filters屬性

屬性名稱

類型

必須

允許更新

描述

約束

Key

String

查詢資源時的過濾鍵。

取值:CreationStartTime,表示建立開始時間。

同時設定Key和Value可以查詢在指定時間點後建立的資源資訊。

Value

String

查詢資源時的過濾值。

採用UTC+0時區,格式為:yyyy-MM-ddTHH:mmZ

Tags文法

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

Tags屬性

屬性名稱

類型

必須

允許更新

描述

約束

Key

String

執行個體的標籤鍵。

Value

String

執行個體的標籤值。

返回資料(Fn::GetAtt)

  • InstanceIds:執行個體ID列表。

  • Instances:執行個體詳情列表。

屬性名稱

類型

描述

約束

InstanceIds

List

執行個體ID列表。

Instances

List

執行個體詳情列表。

SerialNumber

String

執行個體的序號。

Status

String

執行個體的狀態。

DeploymentSetId

String

部署集ID。

SpotStrategy

String

搶佔式執行個體的搶佔策略。

取值:

  • NoSpot:正常隨用隨付執行個體。

  • SpotWithPriceLimit:設定上限價格的搶佔式執行個體。

  • SpotAsPriceGo:系統自動出價,最高隨用隨付價格。

DeviceAvailable

Boolean

執行個體是否可以掛載資料盤。

取值:

  • true:可以。

  • false:不可以。

Description

String

執行個體的描述。

InstanceNetworkType

String

執行個體的網路類型。

取值:

  • classic:傳統網路。

  • vpc:Virtual Private Cloud。

InstanceName

String

執行個體的名稱。

OSNameEn

String

執行個體作業系統的英文名稱。

SpotPriceLimit

Number

執行個體的每小時最高價格。

當返回的SpotStrategy取值為SpotWithPriceLimit時,該參數有效。

Memory

Number

記憶體大小。

單位:MiB。

OSName

String

執行個體的作業系統名稱。

ImageId

String

鏡像ID。

GPUSpec

String

執行個體規格附帶的GPU類型。

StoppedMode

String

執行個體停機後是否繼續收費。

取值:

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

  • StopCharging:停機後不收費。停機後,將釋放執行個體對應的資源,例如:vCPU、記憶體和公網IP等資源。

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

GPUAmount

Number

執行個體規格附帶的GPU數量。

HostName

String

執行個體的主機名稱。

InstanceId

String

執行個體ID。

InternetMaxBandwidthOut

Number

公網出頻寬最大值。

單位:Mbit/s。

InternetMaxBandwidthIn

Number

公網入頻寬最大值。

單位:Mbit/s。

InstanceType

String

執行個體的規格。

InstanceChargeType

String

執行個體的計費方式。

取值:

  • PrePaid:訂用帳戶。

  • PostPaid:隨用隨付。

IoOptimized

Boolean

是否為I/O最佳化型執行個體。

取值:

  • true:I/O最佳化。

  • false:非I/O最佳化。

Cpu

Number

vCPU的數量。

ResourceGroupId

String

執行個體所屬資源群組ID。

InternetChargeType

String

網路計費類型。

取值:

  • PayByBandwidth:按固定頻寬計費。

  • PayByTraffic:按使用流量計費。

ZoneId

String

可用性區域ID。

InstanceTypeFamily

String

執行個體規格類型系列。

OSType

String

執行個體的作業系統類型。

取值:

  • windows

  • linux

NetworkInterfaces

List

執行個體包含的彈性網卡列表。

Tags

List

執行個體的標籤列表。

SecurityGroupIds

List

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

PublicIpAddress

List

執行個體的公網IP地址。

InnerIpAddress

List

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

EipAddress

List

執行個體的Elastic IP Address地址。

DedicatedHostAttribute

List

Dedicated Host的相關參數。

EcsCapacityReservationAttr

List

ECS的容量預留相關參數。

DedicatedInstanceAttribute

List

Dedicated Host執行個體的屬性。

OperationLocks

List

執行個體的鎖定原因。

PrivateIpAddress

List

私人IP地址清單。

VpcId

String

Virtual Private Cloud ID。

VswitchId

String

交換器ID。

樣本

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