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

Resource Orchestration Service:ALIYUN::ECS::DiskAttachment

最終更新日:Aug 02, 2025

ALIYUN::ECS::DiskAttachment は、Elastic Compute Service (ECS) インスタンスにディスクをアタッチするために使用されます。

構文

{
  "Type": "ALIYUN::ECS::DiskAttachment",
  "Properties": {
    "InstanceId": String, // インスタンスID
    "Device": String, // デバイス名
    "DeleteWithInstance": Boolean, // インスタンスの削除時にディスクを削除するかどうか
    "DiskId": String, // ディスクID
    "DeleteAutoSnapshot": Boolean, // ディスクの削除時に自動スナップショットを削除するかどうか
    "Password": String, // パスワード
    "InstanceType": String, // インスタンスタイプ
    "Force": Boolean, // 強制的にアタッチするかどうか
    "KeyPairName": String, // キーペア名
    "Bootable": Boolean // システムディスクとしてアタッチするかどうか
  }
}

プロパティ

プロパティ

タイプ

必須

編集可能

説明

制約

InstanceId

String

はい

いいえ

ディスクをアタッチする ECS インスタンスの ID です。

なし。

DiskId

String

はい

いいえ

ディスクの ID です。

ディスクと ECS インスタンスは同じゾーンに存在する必要があります。

Device

String

いいえ

いいえ

ディスクのデバイス名です。

このプロパティを指定しない場合、システムは /dev/xvdb から /dev/xvdz までのアルファベット順でデバイス名を自動的に割り当てます。

DeleteWithInstance

Boolean

いいえ

いいえ

インスタンスのリリース時にディスクを解放するかどうかを指定します。

有効な値:

  • true

  • false

Password

String

いいえ

いいえ

システムディスクをアタッチするときにインスタンスに設定されるパスワードです。

パスワードは管理者ユーザーと root ユーザーにのみ適用されます。パスワードは 8 ~ 30 文字で、大文字、小文字、数字、特殊文字のうち少なくとも 3 種類の文字を含める必要があります。次の文字がサポートされています。

( ) ` ~ ! @ # $ % ^ & * - _ + = | { } [ ] : ; ' < > , . ? /

Windows インスタンスの場合、パスワードをスラッシュ (/) で始めることはできません。

Force

Boolean

いいえ

いいえ

ディスクをインスタンスに強制的にアタッチするかどうかを指定します。

有効な値:

  • true

  • false

デフォルト値: false。

KeyPairName

String

いいえ

いいえ

システムディスクをアタッチするときに ECS Linux インスタンスにバインドする SSH キーペアの名前です。

  • Windows Server インスタンスの場合、SSH キーペアはサポートされていません。 KeyPairName が指定されている場合でも、Password の値が使用されます。

  • Linux インスタンスの場合、初期化中にパスワードベースのログインは無効になります。

InstanceType

String

いいえ

いいえ

インスタンスタイプ。

有効な値:

  • LingJun

  • ECS (デフォルト)

Bootable

Boolean

いいえ

いいえ

ディスクをシステムディスクとしてアタッチするかどうかを指定します。

有効な値:

  • true

  • false

デフォルト値: false。

DeleteAutoSnapshot

Boolean

いいえ

いいえ

ディスクのリリース時にディスクの自動スナップショットを削除するかどうかを指定します。

デフォルト値: true。有効な値:

  • true

  • false

戻り値

Fn::GetAtt

  • DiskId: 作成されたディスクの ID。

  • Status: 作成されたディスクのステータス。

  • Device: 作成されたディスクのデバイス名。

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  InstanceId:
    Type: String
    AssociationProperty: ALIYUN::ECS::Instance::InstanceId  # インスタンスID
  DiskId:
    Type: String
    AssociationProperty: ALIYUN::ECS::Disk::DiskId # ディスクID
Resources:
  DiskAttachment:
    Type: ALIYUN::ECS::DiskAttachment
    Properties:
      InstanceId:
        Ref: InstanceId
      Device: /dev/xvda # デバイス名
      DiskId:
        Ref: DiskId
Outputs:
  Status:
    Description: The disk status now. # 現在のディスクステータス
    Value:
      Fn::GetAtt:
        - DiskAttachment
        - Status
  Device:
    Description: The device where the volume is exposed on ecs instance. # ボリュームがECSインスタンスに公開されているデバイス
    Value:
      Fn::GetAtt:
        - DiskAttachment
        - Device
  DiskId:
    Description: The disk id of created disk # 作成されたディスクのID
    Value:
      Fn::GetAtt:
        - DiskAttachment
        - DiskId                   
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "InstanceId": {  // インスタンスID
      "Type": "String",
      "AssociationProperty": "ALIYUN::ECS::Instance::InstanceId"
    },
    "DiskId": {  // ディスクID
      "Type": "String",
      "AssociationProperty": "ALIYUN::ECS::Disk::DiskId"
    }
  },
  "Resources": {
    "DiskAttachment": {
      "Type": "ALIYUN::ECS::DiskAttachment",
      "Properties": {
        "InstanceId": {
          "Ref": "InstanceId"
        },
        "Device": "/dev/xvda",  // デバイス名
        "DiskId": {
          "Ref": "DiskId"
        }
      }
    }
  },
  "Outputs": {
    "Status": {  // 現在のディスクステータス
      "Description": "The disk status now.",
      "Value": {
        "Fn::GetAtt": [
          "DiskAttachment",
          "Status"
        ]
      }
    },
    "Device": {  // ボリュームがECSインスタンスに公開されているデバイス
      "Description": "The device where the volume is exposed on ecs instance.",
      "Value": {
        "Fn::GetAtt": [
          "DiskAttachment",
          "Device"
        ]
      }
    },
    "DiskId": {  // 作成されたディスクのID
      "Description": "The disk id of created disk",
      "Value": {
        "Fn::GetAtt": [
          "DiskAttachment",
          "DiskId"
        ]
      }
    }
  }
}