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

Resource Orchestration Service:ALIYUN::ECS::Disk

最終更新日:Mar 01, 2025

ALIYUN::ECS::Disk は、Elastic Compute Service (ECS) でクラウドディスクを作成するために使用されます。

構文

{
  "Type": "ALIYUN::ECS::Disk",
  "Properties": {
    "StorageSetId": String,
    "Description": String,
    "Tags": List,
    "AutoSnapshotPolicyId": String,
    "Encrypted": Boolean,
    "DiskName": String,
    "DiskCategory": String,
    "ResourceGroupId": String,
    "KMSKeyId": String,
    "DeleteAutoSnapshot": Boolean,
    "SnapshotId": String,
    "StorageSetPartitionNumber": Integer,
    "PerformanceLevel": String,
    "ZoneId": String,
    "Size": Integer,
    "BurstingEnabled": Boolean,
    "ProvisionedIops": Integer,
    "MultiAttach": String,
    "InstanceId": String
  }
}

プロパティ

プロパティ

タイプ

必須

編集可能

説明

制約

ResourceGroupId

String

いいえ

はい

クラウドディスクが属するリソースグループの ID です。

なし。

ZoneId

String

いいえ

いいえ

従量課金制クラウドディスクを作成するゾーンの ID です。

  • InstanceId を指定しない場合は、ZoneId を指定する必要があります。

  • ZoneId と InstanceId の両方を指定することはできません。

DiskName

String

いいえ

いいえ

クラウドディスクの名前です。

名前は 2 ~ 128 文字の長さでなければなりません。文字で始まり、http:// または https:// で始めることはできません。文字、数字、ピリオド(.)、アンダースコア(_)、ハイフン(-) を含めることができます。

Description

String

いいえ

いいえ

クラウドディスクの説明です。

説明は 2 ~ 256 文字の長さでなければなりません。http:// または https:// で始めることはできません。

InstanceId

String

いいえ

いいえ

サブスクリプションクラウドディスクをアタッチするサブスクリプションインスタンスの ID です。

  • InstanceId を指定した場合、ResourceGroupId、Tags、および KMSKeyId の定義済み値は無視されます。

  • ZoneId と InstanceId の両方を指定することはできません。

デフォルト値: null。null 値は、従量課金制クラウドディスクが RegionId と ZoneId によって個別に表されるリージョンとゾーンに作成されることを指定します。

Tags

List

いいえ

いいえ

タグ。

最大 20 個のタグを追加できます。

詳細については、「タグのプロパティ」をご参照ください。

DiskCategory

String

いいえ

いいえ

クラウドディスクのカテゴリです。

有効な値:

  • cloud (デフォルト): 基本ディスク

  • cloud_efficiency: Ultra ディスク

  • cloud_ssd: 標準 SSD

  • cloud_essd: 企業向け SSD (ESSD)

SnapshotId

String

いいえ

いいえ

スナップショット ID です。

SnapshotId と Size の両方を指定した場合、SnapshotId の値が優先されます。

作成されたクラウドディスクの実際のサイズは、指定されたスナップショットのサイズです。

説明

2013 年 7 月 15 日以前に作成されたスナップショットは、クラウドディスクの作成に使用できません。

PerformanceLevel

String

いいえ

いいえ

ESSD のパフォーマンスレベル (PL) です。

有効な値:

  • PL0: ESSD は最大 10,000 ランダム読み取り/書き込み IOPS を提供できます。

  • PL1 (デフォルト): ESSD は最大 50,000 ランダム読み取り/書き込み IOPS を提供できます。

  • PL2: ESSD は最大 100,000 ランダム読み取り/書き込み IOPS を提供できます。

  • PL3: ESSD は最大 1,000,000 ランダム読み取り/書き込み IOPS を提供できます。

ESSD PL の選択方法の詳細については、「ESSD」をご参照ください。

Size

Integer

いいえ

いいえ

クラウドディスクのサイズです。

  • DiskCategory が cloud に設定されている場合の有効な値: 5 ~ 2000。

  • DiskCategory が cloud_efficiency に設定されている場合の有効な値: 20 ~ 32768。

  • DiskCategory が cloud_ssd に設定されている場合の有効な値: 20 ~ 32768。

  • DiskCategory が cloud_essd に設定されている場合の有効な値: 20 ~ 32768。

単位: GiB。

このプロパティの値は、指定されたスナップショットのサイズ以上でなければなりません。

BurstingEnabled

Boolean

いいえ

いいえ

バーストモードを有効にするかどうかを指定します。

有効な値:

  • true

  • false (デフォルト)

ProvisionedIops

Integer

いいえ

いいえ

事前設定された IOPS です。

なし。

AutoSnapshotPolicyId

String

いいえ

いいえ

自動スナップショットポリシーの ID です。

なし。

Encrypted

Boolean

いいえ

いいえ

クラウドディスクを暗号化するかどうかを指定します。

有効な値:

  • true

  • false (デフォルト)

DeleteAutoSnapshot

Boolean

いいえ

いいえ

クラウドディスクが解放されたときに、クラウドディスクの自動スナップショットを削除するかどうかを指定します。

有効な値:

  • true (デフォルト)

  • false

StorageSetId

String

いいえ

いいえ

ストレージセットの ID です。

なし。

KMSKeyId

String

いいえ

いいえ

クラウドディスクに使用する Key Management Service (KMS) キーの ID です。

なし。

StorageSetPartitionNumber

Integer

いいえ

いいえ

ストレージセットのパーティション数です。

なし。

MultiAttach

String

いいえ

いいえ

マルチアタッチ機能を有効にするかどうかを指定します。

有効な値:

  • Disabled (デフォルト): マルチアタッチ機能を無効にします。

  • Enabled: マルチアタッチ機能を有効にします。この値は ESSD の場合にのみ有効です。

説明

マルチアタッチ機能が有効になっているクラウドディスクは、従量課金制の課金方法のみをサポートします。

タグの構文

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

タグのプロパティ

プロパティ

タイプ

必須

編集可能

説明

制約

Key

String

はい

いいえ

タグキーです。

タグキーは 1 ~ 128 文字の長さでなければならず、http:// または https:// を含めることはできません。aliyun または acs: で始めることはできません。

Value

String

いいえ

いいえ

タグ値です。

タグ値は最大 128 文字の長さで、http:// または https:// を含めることはできません。aliyun または acs: で始めることはできません。

戻り値

Fn::GetAtt

  • DiskId: クラウドディスクの ID です。

  • Status: クラウドディスクの状態です。

YAML 形式

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  ZoneId:
    AssociationProperty: ALIYUN::ECS::Instance:ZoneId
    Type: String
    Label:
       
      en: VSwitch Availability Zone
Resources:
  DataDisk:
    Type: ALIYUN::ECS::Disk
    Properties:
      Size: 10
      ZoneId:
        Ref: ZoneId
      DiskName: DataDisk
Outputs:
  DiskId:
    Value:
      Fn::GetAtt:
        - DataDisk
        - DiskId
  Status:
    Value:
      Fn::GetAtt:
        - DataDisk
        - Status

JSON 形式

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "ZoneId": {
      "AssociationProperty": "ALIYUN::ECS::Instance:ZoneId",
      "Type": "String",
      "Label": {
         
        "en": "VSwitch Availability Zone"
      }
    }
  },
  "Resources": {
    "DataDisk": {
      "Type": "ALIYUN::ECS::Disk",
      "Properties": {
        "Size": 10,
        "ZoneId": {
          "Ref": "ZoneId"
        },
        "DiskName": "DataDisk"
      }
    }
  },
  "Outputs": {
    "DiskId": {
      "Value": {
        "Fn::GetAtt": [
          "DataDisk",
          "DiskId"
        ]
      }
    },
    "Status": {
      "Value": {
        "Fn::GetAtt": [
          "DataDisk",
          "Status"
        ]
      }
    }
  }
}