すべてのプロダクト
Search
ドキュメントセンター

Resource Orchestration Service:DATASOURCE::ECS::RecommendInstanceTypes

最終更新日:Jan 16, 2025

DATASOURCE::ECS::RecommendInstanceTypes は、Elastic Compute Service (ECS) インスタンスの推奨インスタンスタイプをクエリするために使用されます。

構文

{
  "Type": "DATASOURCE::ECS::RecommendInstanceTypes",
  "Properties": {
    "ZoneMatchMode": String,
    "IoOptimized": String,
    "ZoneId": String,
    "InstanceChargeType": String,
    "Memory": Number,
    "Scene": String,
    "SystemDiskCategory": String,
    "Cores": Integer,
    "PriorityStrategy": String,
    "InstanceFamilyLevel": String,
    "MaxPrice": Number,
    "InstanceType": String,
    "InstanceTypeFamilies": List,
    "SpotStrategy": String,
    "RefreshOptions": String
  }
}

プロパティ

プロパティ

タイプ

必須

編集可能

説明

制約

ZoneMatchMode

String

いいえ

はい

ZoneId で指定されたゾーンでのみ利用可能なインスタンスタイプを推奨するかどうかを指定します。

有効な値:

  • Strict: ZoneId で指定されたゾーンでのみ利用可能なインスタンスタイプを推奨します。

  • Include: ZoneId で指定されたゾーンで利用可能なインスタンスタイプと、同じリージョン内の他のゾーンで利用可能なインスタンスタイプを推奨します。

説明

ZoneId を指定する場合、ZoneMatchMode のデフォルト値は Strict です。

IoOptimized

String

いいえ

はい

インスタンスが I/O 最適化されているかどうかを指定します。

有効な値:

  • optimized (デフォルト): インスタンスは I/O 最適化されています。

  • none: インスタンスは I/O 最適化されていません。

説明

廃止されたインスタンスタイプをクエリする場合、このプロパティのデフォルト値は none です。

ZoneId

String

いいえ

はい

ゾーン ID です。

DescribeZones オペレーションを呼び出して、ゾーン ID をクエリできます。

InstanceChargeType

String

いいえ

はい

インスタンスの課金方法です。

有効な値:

  • PrePaid: サブスクリプション

  • PostPaid (デフォルト): 従量課金

Memory

Number

いいえ

はい

インスタンスのメモリサイズです。

単位: GiB。

Cores プロパティと Memory プロパティを指定した場合、システムは両方のプロパティの値に一致するすべてのインスタンスタイプを返します。

Scene

String

いいえ

はい

インスタンスタイプが使用されるシナリオです。

有効な値:

  • UPGRADE: インスタンスタイプのアップグレードまたはダウングレード

  • CREATE (デフォルト): インスタンスの作成

SystemDiskCategory

String

いいえ

はい

システムディスクのカテゴリです。

有効な値:

  • cloud_efficiency: ウルトラディスク

  • cloud_ssd: 標準 SSD

  • cloud_essd: エンタープライズ SSD (ESSD)

  • cloud: ベーシックディスク

説明

I/O 最適化されていないインスタンスの場合、このプロパティのデフォルト値は cloud です。 I/O 最適化されたインスタンスの場合、このプロパティのデフォルト値は cloud_efficiency です。

Cores

Integer

いいえ

はい

インスタンスの vCPU の数です。

Cores プロパティと Memory プロパティを指定した場合、システムは両方のプロパティの値に一致するすべてのインスタンスタイプを返します。

PriorityStrategy

String

いいえ

はい

インスタンスタイプを推奨するために使用されるポリシーです。

有効な値:

  • InventoryFirst (デフォルト): 在庫が最も豊富なインスタンスタイプを推奨します。

  • PriceFirst: vCPU の時間単価の昇順に基づいてインスタンスタイプを推奨します。

  • NewProductFirst: 最新のインスタンスタイプを推奨します。

InstanceFamilyLevel

String

いいえ

はい

インスタンスファミリのレベルです。

有効な値:

  • EntryLevel: エントリーレベル

  • EnterpriseLevel: エンタープライズレベル

  • CreditEntryLevel: クレジットベースのエントリーレベル。 詳細については、概要 をご参照ください。

MaxPrice

Number

いいえ

はい

従量課金インスタンスまたはプリエンプティブインスタンスの時間単価の最大値です。

このプロパティは、SpotStrategy が SpotWithPriceLimit に設定されている場合に有効になります。

InstanceType

String

いいえ

いいえ

インスタンスタイプです。

詳細については、インスタンスファミリの概要 および DescribeInstanceTypes をご参照ください。

説明

リクエストで InstanceType と Cores または Memory のいずれかを一緒に指定することはできません。

InstanceTypeFamilies

List

いいえ

はい

インスタンスファミリです。

DescribeInstanceTypeFamilies を呼び出して、インスタンスファミリをクエリできます。

SpotStrategy

String

いいえ

はい

プリエンプティブインスタンスの入札ポリシーです。

有効な値:

  • NoSpot (デフォルト): インスタンスは通常の従量課金インスタンスとして作成されます。

  • SpotWithPriceLimit: インスタンスは、ユーザー定義の時間単価の最大値を持つプリエンプティブインスタンスとして作成されます。

  • SpotAsPriceGo: インスタンスは、購入時の市場価格が自動的に入札価格として使用されるプリエンプティブインスタンスとして作成されます。 市場価格は従量課金価格まで上がることがあります。

説明

このプロパティは、InstanceChargeType が PostPaid に設定されている場合に有効になります。

RefreshOptions

String

いいえ

はい

スタックが更新されたときのデータソースリソースの更新ポリシーです。

有効な値:

  • Never (デフォルト): スタックが更新されたときにデータソースリソースを更新しません。

  • Always: スタックが更新されたときにデータソースリソースを更新します。

戻り値 (Fn::GetAtt)

  • InstanceTypeIds: インスタンスタイプ

  • InstanceTypes: インスタンスタイプの詳細

プロパティ

タイプ

説明

制約

InstanceTypeIds

List

インスタンスタイプ

なし

InstanceTypes

List

インスタンスタイプの詳細

なし

CommodityCode

String

インスタンスタイプの商品コード

なし

ZoneId

String

インスタンスタイプのゾーン ID

なし

Priority

Integer

ソートの優先順位

なし

NetworkType

String

インスタンスのネットワークタイプ

有効な値:

  • classic

  • vpc

Scene

String

インスタンスタイプが使用されるシナリオ

なし

SpotStrategy

String

プリエンプティブインスタンスの入札ポリシー

なし

InstanceChargeType

String

インスタンスの課金方法

なし

InstanceType

String

インスタンスタイプ

なし

ROSTemplateFormatVersion: '2015-09-01'
Parameters: {}
Resources:
  RecommendInstanceTypes:
    Type: DATASOURCE::ECS::RecommendInstanceTypes
    Properties:
      Cores: 2
      Memory: 2
Outputs:
  RecommendInstanceTypes:
    Value:
      Ref: RecommendInstanceTypes
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
  },
  "Resources": {
    "RecommendInstanceTypes": {
      "Type": "DATASOURCE::ECS::RecommendInstanceTypes",
      "Properties": {
        "Cores": 2,
        "Memory": 2
      }
    }
  },
  "Outputs": {
    "RecommendInstanceTypes": {
      "Value": {
        "Ref": "RecommendInstanceTypes"
      }
    }
  }
}