Tous les produits
Search
Centre de documentation

Resource Orchestration Service:ALIYUN::ECS::CustomImage

Dernière mise à jour :Aug 10, 2026

Crée une image personnalisée.

Syntaxe

{
  "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
  }
}

Propriétés

Propriété

Type

Obligatoire

Modifiable

Description

Contrainte

Description

String

Non

Non

La description de l'image.

La description doit comporter entre 2 et 256 caractères. Elle ne peut pas commencer par http:// ou https://.

InstanceId

String

Non

Non

L'ID de l'instance.

Utilise une instance ECS pour créer l'image. Pour plus d'informations, consultez Créer une image personnalisée à partir d'une instance.

ImageName

String

Non

Non

Le nom de l'image.

Le nom doit comporter entre 2 et 128 caractères et peut contenir des lettres, des chiffres, des traits de soulignement (_) et des tirets (-). Il doit commencer par une lettre et ne peut pas commencer par http:// ou https://.

SnapshotId

String

Non

Non

L'ID du snapshot.

Utilise un snapshot pour créer l'image. Pour plus d'informations, consultez Créer une image personnalisée à partir d'un snapshot.

Tag

List

Non

Non

Les tags.

Pour plus d'informations, consultez Propriétés Tag.

ResourceGroupId

String

Non

Oui

L'ID du groupe de ressources.

Aucune.

Platform

String

Non

Non

La distribution du système d'exploitation pour le disque système. Obligatoire lors de la création d'un disque système à partir d'un snapshot de disque de données.

Valeurs valides :

  • CentOS

  • Ubuntu

  • SUSE

  • OpenSUSE

  • RedHat

  • Debian

  • CoreOS

  • Aliyun

  • Windows Server 2012

  • Windows 7

  • Customized Linux

  • Others Linux (par défaut)

Features

Map

Non

Non

Les attributs de fonctionnalité de l'image.

Propriété Features.

DiskDeviceMapping

List

Non

Non

Les mappages disque-snapshot.

Pour plus d'informations, consultez Propriétés DiskDeviceMapping.

Architecture

String

Non

Non

L'architecture système. Obligatoire lors de la création d'un disque système à partir d'un snapshot de disque de données.

Valeurs valides :

  • i386

  • x86_64 (par défaut)

ImageFamily

String

Non

Non

Le nom de la famille d'images.

Le nom doit comporter entre 2 et 128 caractères et peut contenir des lettres, des chiffres, deux-points (:), traits de soulignement (_) et tirets (-). Il doit commencer par une lettre et ne peut pas commencer par aliyun ou acs:. Il ne peut pas contenir http:// ou https://.

SourceRegionId

String

Non

Non

L'ID de la région de l'instance ou du snapshot source.

Par défaut, l'ID de la région actuelle est utilisé.

DetectionStrategy

String

Non

Non

Le mode de vérification de l'image.

Si non spécifié, aucune vérification n'est effectuée. Seul le mode de vérification standard est pris en charge.

Remarque

La plupart des distributions Linux et Windows sont prises en charge. Pour plus d'informations sur les éléments de vérification et les limites du système d'exploitation pour les vérifications d'images, consultez Analyser et corriger les images personnalisées et Limites du système d'exploitation pour la vérification des images.

ImageVersion

String

Non

Non

La version de l'image.

Si InstanceId fait référence à une instance dont l'image provient d'Alibaba Cloud Marketplace ou en est dérivée, laissez ce champ vide ou définissez-le sur la version de l'image de l'instance.

BootMode

String

Non

Non

Le mode de démarrage de l'image.

Valeurs valides :

  • BIOS : mode de démarrage BIOS (Basic Input/Output System)

  • UEFI : mode de démarrage UEFI (Unified Extensible Firmware Interface)

Remarque

Assurez-vous que le mode de démarrage spécifié est pris en charge par l'image. Un mode de démarrage non pris en charge empêche le démarrage des instances.

Syntaxe Features

"Features": 
  {
    "ImdsSupport": String
  }

Propriété Features

Propriété

Type

Obligatoire

Modifiable

Description

Contrainte

ImdsSupport

String

Non

Non

Le mode d'accès aux métadonnées de l'image.

Valeurs valides :

  • v1 : mode de renforcement de la sécurité indisponible pour les instances créées à partir de cette image.

  • v2 : mode de renforcement de la sécurité disponible pour les instances créées à partir de cette image.

Syntaxe Tag

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

Propriétés Tag

Propriété

Type

Obligatoire

Modifiable

Description

Contrainte

Key

String

Non

Non

La clé du tag.

La clé du tag doit comporter entre 1 et 128 caractères et ne peut pas contenir http:// ni https://. Elle ne peut pas commencer par aliyun ni acs:.

Value

String

Non

Non

La valeur du tag.

La valeur du tag peut comporter jusqu'à 128 caractères et ne peut pas contenir http:// ni https://. Elle ne peut pas commencer par aliyun ni acs:.

Syntaxe DiskDeviceMapping

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

Propriétés DiskDeviceMapping

Propriété

Type

Obligatoire

Modifiable

Description

Contrainte

Device

String

Non

Non

Le nom du périphérique disque.

Valeurs valides :

  • Pour les disques basiques, les valeurs valides vont de /dev/xvda to /dev/xvdz dans l'ordre alphabétique.

  • Pour les catégories de disques autres que les disques basiques, les valeurs valides vont de /dev/vda to /dev/vdz dans l'ordre alphabétique.

SnapshotId

String

Non

Non

L'ID du snapshot.

Aucune.

Size

Integer

Non

Non

La taille du disque.

  • Si vous laissez SnapshotId vide, les valeurs valides suivantes sont prises en charge pour Size :

    • Valeurs valides pour les disques basiques : 5 à 2000.

      Valeur par défaut : 5.

    • Valeurs valides pour les catégories de disques autres que les disques basiques : 20 à 32768.

      Valeur par défaut : 20.

  • Si SnapshotId est spécifié, Size doit être supérieur ou égal à la taille du snapshot. Par défaut : la taille du snapshot.

Unité : GiB.

DiskType

String

Non

Non

Le type de disque.

Crée un disque système à partir d'un snapshot de disque de données. Si non spécifié, utilise le type de disque du snapshot.

Valeurs valides :

  • system : disque système

  • data : disque de données

Valeurs de retour

Fn::GetAtt

ImageId : l'ID de l'image personnalisée.

SourceRegionId : l'ID de la région à laquelle appartient l'instance ou le snapshot.

Exemples

ROSTemplateFormatVersion: '2015-09-01'
Description:
  en: Create 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": "Create 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"
        ]
      }
    }
  }
}          

Plus d'exemples : custom-image.yml. Ces exemples utilisent ALIYUN::ECS::CustomImage et ALIYUN::ECS::CopyImage.