全部產品
Search
文件中心

Resource Orchestration Service:ALIYUN::ECS::DiskAttachment

更新時間:Jul 19, 2025

ALIYUN::ECS::DiskAttachment用於掛載ECS磁碟。

文法

{
  "Type": "ALIYUN::ECS::DiskAttachment",
  "Properties": {
    "InstanceId": String,
    "Device": String,
    "DeleteWithInstance": Boolean,
    "DiskId": String,
    "DeleteAutoSnapshot": Boolean,
    "Password": String,
    "InstanceType": String,
    "Force": Boolean,
    "KeyPairName": String,
    "Bootable": Boolean
  }
}

屬性

屬性名稱

類型

必須

允許更新

描述

約束

InstanceId

String

需掛載磁碟的執行個體ID

DiskId

String

磁碟ID

磁碟和ECS執行個體必須在同一個可用性區域。

Device

String

磁碟裝置名稱

如不指定,則預設由系統按順序分配,即從 /dev/xvdb 到 /dev/xvdz。

DeleteWithInstance

Boolean

磁碟是否隨執行個體釋放

取值:

  • true:釋放執行個體時,該磁碟隨執行個體一起釋放。

  • false:釋放執行個體時,保留該磁碟,不隨執行個體一起釋放。

Password

String

掛載系統硬碟時,設定執行個體的使用者名稱密碼。

僅對 administrator 和 root 使用者名稱生效,其他使用者名稱不生效。長度為 8 至 30 個字元,必須同時包含大小寫英文字母、數字和特殊符號中的三類字元。特殊符號可以是:

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

其中,Windows 執行個體不能以斜線號(/)為密碼首字元。

Force

Boolean

是否是強制掛載請求。

取值範圍:

  • true:是。

  • false:否。

預設值:false。

KeyPairName

String

掛載系統硬碟時,為 Linux 系統 ECS 執行個體綁定的 SSH 金鑰對的名稱。

  • Windows Server 系統:不支援 SSH 金鑰對。即使填寫了該參數,只執行Password的配置。

  • Linux 系統:密碼登入方式會被初始化成禁止。

InstanceType

String

執行個體類型。

取值:

  • LingJun

  • ECS(預設值)

Bootable

Boolean

是否作為系統硬碟掛載。

取值範圍:

  • true:是。

  • false:否。

預設值:false。

DeleteAutoSnapshot

Boolean

刪除磁碟時是否刪除自動快照

取值:

  • true(預設值)

  • false

傳回值

Fn::GetAtt

  • DiskId:建立磁碟的ID。

  • Status:建立磁碟的狀態。

  • Device:磁碟裝置名稱。

樣本

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  InstanceId:
    Type: String
    AssociationProperty: ALIYUN::ECS::Instance::InstanceId
  DiskId:
    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:
    Description: The device where the volume is exposed on ecs instance.
    Value:
      Fn::GetAtt:
        - DiskAttachment
        - Device
  DiskId:
    Description: The disk id of created disk
    Value:
      Fn::GetAtt:
        - DiskAttachment
        - DiskId                   
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "InstanceId": {
      "Type": "String",
      "AssociationProperty": "ALIYUN::ECS::Instance::InstanceId"
    },
    "DiskId": {
      "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": {
      "Description": "The device where the volume is exposed on ecs instance.",
      "Value": {
        "Fn::GetAtt": [
          "DiskAttachment",
          "Device"
        ]
      }
    },
    "DiskId": {
      "Description": "The disk id of created disk",
      "Value": {
        "Fn::GetAtt": [
          "DiskAttachment",
          "DiskId"
        ]
      }
    }
  }
}