使用DATASOURCE::ECS::Instances查詢ECS執行個體詳細資料-Resource Orchestration Service-阿里雲

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。	無

樣本

YAML

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

JSON

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