全部产品
Search
文档中心

Resource Orchestration Service:ALIYUN::ECS::CustomImage

更新时间:Jul 06, 2025

ALIYUN::ECS::CustomImage digunakan untuk membuat gambar kustom.

Sintaksis

{
  "Type": "ALIYUN::ECS::CustomImage",
  "Properties": {
    "Description": String,
    "InstanceId": String,
    "ImageName": String,
    "SnapshotId": String,
    "Tag": List,
    "ResourceGroupId": String,
    "Platform": String,
    "DiskDeviceMapping": List,
    "Architecture": String,
    "ImageFamily": String,
    "Features": Map,
    "SourceRegionId": String,
    "DetectionStrategy": String,
    "ImageVersion": String,
    "BootMode": String
  }
}

Properti

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Batasan

Deskripsi

String

Tidak

Tidak

Deskripsi dari gambar kustom.

Deskripsi harus memiliki panjang 2 hingga 256 karakter. Tidak boleh dimulai dengan http:// atau https://.

InstanceId

String

Tidak

Tidak

ID instance.

Jika Anda menentukan properti ini, instance Elastic Compute Service (ECS) digunakan untuk membuat gambar kustom. Untuk informasi lebih lanjut, lihat Buat gambar kustom dari instance.

ImageName

String

Tidak

Tidak

Nama gambar kustom.

Nama harus memiliki panjang 2 hingga 128 karakter, dan dapat berisi huruf, angka, garis bawah (_), dan tanda hubung (-). Harus dimulai dengan huruf dan tidak boleh dimulai dengan http:// atau https://.

SnapshotId

String

Tidak

Tidak

ID snapshot.

Jika Anda menentukan properti ini, snapshot digunakan untuk membuat gambar kustom. Untuk informasi lebih lanjut, lihat Buat gambar kustom dari snapshot.

Tag

List

Tidak

Tidak

Tag.

Untuk informasi lebih lanjut, lihat Properti Tag.

ResourceGroupId

String

Tidak

Ya

ID grup sumber daya tempat gambar kustom termasuk.

Tidak ada.

Platform

String

Tidak

Tidak

Distribusi OS untuk disk sistem. Jika Anda menentukan snapshot disk data untuk membuat disk sistem dari gambar kustom, Anda harus menggunakan properti Platform untuk menentukan distribusi OS untuk disk sistem.

Nilai yang valid:

  • CentOS

  • Ubuntu

  • SUSE

  • OpenSUSE

  • RedHat

  • Debian

  • CoreOS

  • Aliyun

  • Windows Server 2012

  • Windows 7

  • Linux Kustom

  • Lainnya Linux (default)

Fitur

Map

Tidak

Tidak

Atribut fitur dari gambar kustom.

Untuk informasi lebih lanjut, lihat Properti Fitur.

DiskDeviceMapping

List

Tidak

Tidak

Pemetaan antara gambar kustom dan snapshot.

Untuk informasi lebih lanjut, lihat Properti DiskDeviceMapping.

Architecture

String

Tidak

Tidak

Arsitektur sistem dari disk sistem. Jika Anda menentukan snapshot disk data untuk membuat disk sistem dari gambar kustom, Anda harus menggunakan properti Architecture untuk menentukan arsitektur sistem dari disk sistem.

Nilai yang valid:

  • i386

  • x86_64 (default)

ImageFamily

String

Tidak

Tidak

Nama keluarga gambar.

Nama harus memiliki panjang 2 hingga 128 karakter, dan dapat berisi huruf, angka, titik dua (:), garis bawah (_), dan tanda hubung (-). Harus dimulai dengan huruf dan tidak boleh dimulai dengan aliyun atau acs:. Tidak boleh mengandung http:// atau https://.

SourceRegionId

String

Tidak

Tidak

ID wilayah tempat instance atau snapshot berada.

Secara default, ID wilayah saat ini digunakan.

DetectionStrategy

String

Tidak

Tidak

Mode yang ingin Anda gunakan untuk memeriksa gambar kustom.

Jika Anda tidak menentukan properti ini, gambar kustom tidak diperiksa. Hanya mode pemeriksaan standar yang didukung.

Catatan

Sebagian besar distribusi Linux dan Windows didukung. Untuk informasi lebih lanjut tentang item pemeriksaan dan batasan OS untuk pemeriksaan gambar, lihat Periksa dan perbaiki gambar kustom dan Batasan sistem operasi untuk pemeriksaan gambar.

ImageVersion

String

Tidak

Tidak

Versi gambar kustom.

Jika Anda menentukan InstanceId dan gambar instance adalah gambar Marketplace Alibaba Cloud atau gambar kustom yang dibuat dari gambar Marketplace Alibaba Cloud, Anda harus membiarkan ImageVersion kosong atau menetapkan ImageVersion ke versi gambar instance.

BootMode

String

Tidak

Tidak

Mode boot gambar kustom.

Nilai yang valid:

  • BIOS: Mode boot Basic Input/Output System (BIOS)

  • UEFI: Mode boot Unified Extensible Firmware Interface (UEFI)

Catatan

Anda harus memahami mode boot yang didukung oleh gambar yang ditentukan. Saat Anda menggunakan properti ini untuk mengubah mode boot gambar, Anda harus menentukan mode boot yang didukung untuk gambar tersebut. Dengan cara ini, instance yang menggunakan gambar dapat dimulai sesuai harapan.

Sintaksis Fitur

"Features": 
  {
    "ImdsSupport": String
  }

Properti Fitur

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Batasan

ImdsSupport

String

Tidak

Tidak

Mode akses metadata gambar.

Nilai yang valid:

  • v1: Anda tidak dapat menyetel mode akses metadata gambar ke Penguatan Keamanan saat membuat instance ECS dari gambar.

  • v2: Anda dapat menyetel mode akses metadata gambar ke Penguatan Keamanan saat membuat instance ECS dari gambar.

Sintaksis Tag

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

Properti Tag

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Batasan

Key

String

Tidak

Tidak

Kunci tag.

Kunci tag harus memiliki panjang 1 hingga 128 karakter, dan tidak boleh mengandung http:// atau https://. Tidak boleh dimulai dengan aliyun atau acs:.

Value

String

Tidak

Tidak

Nilai tag.

Nilai tag dapat memiliki panjang hingga 128 karakter, dan tidak boleh mengandung http:// atau https://. Tidak boleh dimulai dengan aliyun atau acs:.

Sintaksis DiskDeviceMapping

"DiskDeviceMapping": [
  {
    "Device": String,
    "SnapshotId": String,
    "Size": Integer,
    "DiskType": String
  }
]

Properti DiskDeviceMapping

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Batasan

Device

String

Tidak

Tidak

Nama perangkat disk dalam gambar kustom.

Nilai yang valid:

  • Untuk disk dasar, nilai yang valid berkisar dari /dev/xvda hingga /dev/xvdz secara alfabetis.

  • Untuk kategori disk selain disk dasar, nilai yang valid berkisar dari /dev/vda hingga /dev/vdz secara alfabetis.

SnapshotId

String

Tidak

Tidak

ID snapshot.

Tidak ada.

Size

Integer

Tidak

Tidak

Ukuran disk.

  • Jika Anda membiarkan SnapshotId kosong, nilai yang valid berikut didukung untuk Size:

    • Nilai valid untuk disk dasar: 5 hingga 2000.

      Nilai default: 5.

    • Nilai valid untuk kategori disk selain disk dasar: 20 hingga 32768.

      Nilai default: 20.

  • Jika Anda menentukan SnapshotId, nilai Size harus lebih besar dari atau sama dengan nilai SnapshotId. Nilai default Size sama dengan nilai default SnapshotId.

Satuan: GiB.

DiskType

String

Tidak

Tidak

Tipe disk dalam gambar kustom.

Anda dapat menggunakan properti ini untuk membuat disk sistem dari snapshot disk data untuk gambar kustom. Jika Anda membiarkan properti ini kosong, tipe disk snapshot digunakan.

Nilai yang valid:

  • system: disk sistem

  • data: disk data

Nilai Kembali

Fn::GetAtt

ImageId: ID gambar kustom.

SourceRegionId: ID wilayah tempat instance atau snapshot berada.

Contoh

ROSTemplateFormatVersion: '2015-09-01'
Description:
  en: Buat ECS Custom Image
Parameters:
  InstanceId:
    Type: String
    AssociationProperty: ALIYUN::ECS::Instance::InstanceId
Resources:
  CustomImage:
    Type: ALIYUN::ECS::CustomImage
    Properties:
      InstanceId:
        Ref: InstanceId
      ImageName: myImageName
Outputs:
  ImageId:
    Value:
      Fn::GetAtt:
        - CustomImage
        - ImageId
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Description": {
    "en": "Buat ECS Custom Image"
  },
  "Parameters": {
    "InstanceId": {
      "Type": "String",
      "AssociationProperty": "ALIYUN::ECS::Instance::InstanceId"
    }
  },
  "Resources": {
    "CustomImage": {
      "Type": "ALIYUN::ECS::CustomImage",
      "Properties": {
        "InstanceId": {
          "Ref": "InstanceId"
        },
        "ImageName": "myImageName"
      }
    }
  },
  "Outputs": {
    "ImageId": {
      "Value": {
        "Fn::GetAtt": [
          "CustomImage",
          "ImageId"
        ]
      }
    }
  }
}          

Untuk lebih banyak contoh, kunjungi custom-image.yml. Dalam contoh-contoh tersebut, tipe sumber daya ALIYUN::ECS::CustomImage dan ALIYUN::ECS::CopyImage digunakan.