Todos los productos
Search
Centro de documentos

Resource Orchestration Service:ALIYUN::ECS::InstanceClone

Última actualización: Sep 04, 2026

El tipo ALIYUN::ECS::InstanceClone se usa para clonar una instancia de ECS.

Sintaxis

{
  "Type": "ALIYUN::ECS::InstanceClone",
  "Properties": {
    "DeletionProtection": Boolean,
    "DiskMappings": List,
    "LoadBalancerIdToAttach": String,
    "Description": String,
    "BackendServerWeight": Integer,
    "Tags": List,
    "SecurityGroupId": String,
    "RamRoleName": String,
    "ImageId": String,
    "ResourceGroupId": String,
    "SpotPriceLimit": String,
    "InstanceChargeType": String,
    "SourceInstanceId": String,
    "Period": Number,
    "SpotStrategy": String,
    "Password": String,
    "InstanceName": String,
    "ZoneId": String,
    "KeyPairName": String,
    "InternetMaxBandwidthIn": Integer
  }
}

Propiedades

Nombre de la propiedad

Tipo

Obligatorio

Actualización permitida

Descripción

Restricciones

ResourceGroupId

String

No

No

ID del resource group al que pertenece la nueva instancia.

Ninguna

SourceInstanceId

String

Sí

No

ID de la instancia de ECS de origen que se va a clonar.

Esta operación clona todos los datos y configuraciones de la instancia, como el tipo de instancia, la imagen, el método de facturación de ancho de banda, el límite de ancho de banda y el tipo de red. Si la instancia de ECS de origen pertenece a varios security groups, la nueva instancia se agrega al primer security group de la instancia de origen.

BackendServerWeight

Integer

No

No

Peso de la nueva instancia de ECS en la instancia de SLB.

Valores válidos: de 0 a 100.

Valor predeterminado: 100.

LoadBalancerIdToAttach

String

No

No

ID de la instancia de SLB a la que se agregará la nueva instancia de ECS.

Ninguna

Description

String

No

No

Descripción.

La descripción puede tener hasta 256 caracteres.

ImageId

String

No

Sí

ID de la imagen usada para iniciar la nueva instancia de ECS. Puede ser una imagen pública, personalizada o de Alibaba Cloud Marketplace.

Puede especificar un ID de imagen pública mediante coincidencia aproximada. No es necesario especificar el ID completo. Por ejemplo:

  • Si especifica ubuntu, coincide con ubuntu16_0402_64_20G_alibase_20170818.vhd.

  • Si especifica ubuntu_14, coincide con ubuntu_14_0405_64_20G_alibase_20170824.vhd.

  • Si especifica ubuntu1432, coincide con ubuntu_14_0405_32_40G_alibase_20170711.vhd.

  • Si especifica ubuntu_16_0402_32, coincide con ubuntu_16_0402_32_40G_alibase_20170711.vhd.

SecurityGroupId

String

No

No

ID del security group al que pertenece la nueva instancia.

Ninguna

InstanceName

String

No

Sí

Nombre de la nueva instancia.

El nombre debe tener entre 2 y 128 caracteres. Debe comenzar con una letra o un carácter chino y no puede empezar con http:// ni con https://. Puede contener letras, caracteres chinos, dígitos, dos puntos (:), guiones bajos (_) y guiones (-).

Password

String

No

No

Contraseña de inicio de sesión para la nueva instancia de ECS.

La longitud debe ser de 8 a 30 caracteres.

Debe incluir tres de los siguientes tipos de caracteres: letras mayúsculas, letras minúsculas, dígitos y caracteres especiales.

Los caracteres especiales admitidos son: ( ) ' ~ ! @ # $ % ^ & * - + = | { } [ ] : ; ‘ < > , . ? /.

Si especifica este parámetro, llame a la API mediante HTTPS para evitar fugas de contraseñas.

DiskMappings

List

No

Sí

Discos por montar.

Se pueden montar hasta 16 discos.

Para más información, consulte DiskMappings properties.

Tags

List

No

Sí

Etiquetas personalizadas.

Se pueden agregar hasta 20 etiquetas. El formato es: [{"Key":"tagKey","Value":"tagValue"},{"Key":"tagKey2","Value":"tagValue2"}].

Para más información, consulte Tags properties.

ZoneId

String

No

No

ID de la zona.

Ninguna

InstanceChargeType

String

No

No

Método de facturación de la nueva instancia.

Valores válidos:

  • PrePaid: suscripción.

    Nota

    Si establece el valor en PrePaid, asegúrese de que su cuenta tenga saldo suficiente. De lo contrario, la creación de la instancia fallará.

  • PostPaid (predeterminado): pay-as-you-go.

Period

Number

No

No

Periodo de suscripción.

Valores válidos: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24 y 36.

Unidad: mes.

Este parámetro es obligatorio si InstanceChargeType se establece en PrePaid. Es opcional si InstanceChargeType se establece en PostPaid.

KeyPairName

String

No

Sí

Nombre del key pair que se asociará a la nueva instancia de ECS.

El valor predeterminado para Windows está vacío.

En Linux, si especifica este parámetro, el contenido del parámetro Password se mantiene para la instancia, pero el inicio de sesión con contraseña se deshabilita de forma predeterminada. Se usa la autenticación por key pair para iniciar sesión.

RamRoleName

String

No

No

Nombre del rol de RAM de instancia para la nueva instancia.

Para más información, consulte Create a role y Get a list of roles.

SpotPriceLimit

String

No

No

Precio máximo por hora para la nueva instancia.

Este parámetro admite hasta tres decimales. Solo surte efecto cuando SpotStrategy se establece en SpotWithPriceLimit.

SpotStrategy

String

No

No

Directiva de puja para la nueva instancia pay-as-you-go.

Este parámetro solo surte efecto cuando InstanceChargeType se establece en PostPaid. Valores válidos:

  • NoSpot (predeterminado): Instancia pay-as-you-go regular.

  • SpotWithPriceLimit: Instancia spot con precio máximo definido por el usuario.

  • SpotAsPriceGo: El sistema puja automáticamente a un precio no superior al precio pay-as-you-go.

DeletionProtection

Boolean

No

No

Atributo de protección contra liberación para la nueva instancia. Especifica si la instancia se puede liberar desde la consola o al llamar a la operación DeleteInstance.

Valores válidos:

  • true: La instancia se puede liberar mediante una llamada a la API.

  • false (predeterminado): La instancia no se puede liberar mediante una llamada a la API.

InternetMaxBandwidthIn

Integer

No

No

Ancho de banda máximo de salida hacia la red pública

Unidad: Mbit/s.

Valores válidos: de 0 a 200.

Valor predeterminado: 200.

Sintaxis de DiskMappings

"DiskMappings": [
  {
    "Category": String,
    "DiskName": String,
    "Description": String,
    "Device": String,
    "SnapshotId": String,
    "PerformanceLevel": String,
    "Size": String
  }
]

Propiedades de DiskMappings

Nombre de la propiedad

Tipo

Obligatorio

Actualización permitida

Descripción

Restricciones

Size

String

Sí

No

Tamaño del disco de datos.

Valores válidos: de 20 a 500.

Unidad: GB.

Category

String

No

No

Tipo del disco de datos.

Valores válidos:

  • cloud: disco básico.

  • cloud_ssd: SSD estándar.

  • cloud_essd: SSD empresarial.

  • cloud_efficiency: disco ultra.

  • ephemeral_ssd: SSD local.

El valor predeterminado para instancias optimizadas para E/S es cloud_efficiency. Para instancias no optimizadas para E/S, el valor predeterminado es cloud.

DiskName

String

No

No

Nombre del disco de datos.

El nombre debe tener entre 2 y 128 caracteres. Debe comenzar con una letra o un carácter chino y no puede empezar con http:// ni con https://. Puede contener letras, caracteres chinos, dígitos, guiones bajos (_), dos puntos (:) o guiones (-).

PerformanceLevel

String

No

No

Al crear un SSD empresarial para usarlo como disco del sistema, establezca el nivel de rendimiento del disco.

Valores válidos:

  • PL0: El disco ofrece hasta 10,000 IOPS de lectura/escritura aleatoria.

  • PL1 (predeterminado): El disco ofrece hasta 50,000 IOPS de lectura/escritura aleatoria.

  • PL2: El disco ofrece hasta 100,000 IOPS de lectura/escritura aleatoria.

  • PL3: El disco ofrece hasta 1,000,000 IOPS de lectura/escritura aleatoria.

Para obtener información sobre cómo seleccionar un nivel de rendimiento ESSD, consulte Enterprise SSDs.

Description

String

No

No

Descripción.

La longitud debe ser de 2 a 256 caracteres.

El valor predeterminado está vacío.

Device

String

No

No

Destino de montaje.

Este parámetro está en desuso. Para garantizar la compatibilidad, se recomienda no usarlo.

SnapshotId

String

No

No

Instantánea usada para crear el disco de datos.

Ninguna

Sintaxis de Tags

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

Propiedades de Tags

Nombre de la propiedad

Tipo

Obligatorio

Actualización permitida

Descripción

Restricciones

Key

String

Sí

No

Clave de la etiqueta.

La clave debe tener entre 1 y 128 caracteres. No puede comenzar con aliyun ni con acs:, y no puede contener http:// ni https://.

Value

String

No

No

Valor de la etiqueta.

El valor puede tener entre 0 y 128 caracteres. No puede comenzar con aliyun ni con acs:, y no puede contener http:// ni https://.

Valores de retorno

Fn::GetAtt

  • InstanceId: ID de la nueva instancia. Es un identificador único global generado por el sistema.

  • PrivateIp: Dirección IP privada de la instancia en una VPC. Este atributo solo se devuelve cuando NetworkType se establece en vpc.

  • InnerIp: Dirección IP privada de la instancia en la red clásica. Este atributo solo se devuelve cuando NetworkType se establece en classic.

  • PublicIp: Dirección IP pública de la instancia en la red clásica. Este atributo solo se devuelve cuando NetworkType se establece en classic.

  • ZoneId: ID de la zona.

  • HostName: Nombre de host de la instancia.

  • PrimaryNetworkInterfaceId: ID de la interfaz de red principal (NIC).

  • SecurityGroupIds: Lista de los ID de los security groups a los que pertenece la instancia.

Ejemplos

Formato YAML

ROSTemplateFormatVersion: '2015-09-01'
Description: Test ECS Instance Clone
Parameters:
  RegionId:
    Type: String
    AssociationProperty: ALIYUN::ECS::RegionId
  SourceInstanceId:
    Type: String
    AssociationProperty: ALIYUN::ECS::Instance::InstanceId
    AssociationPropertyMetadata:
      RegionId: ${RegionId}
Resources:
  InstanceClone:
    Type: ALIYUN::ECS::InstanceClone
    Properties:
      SourceInstanceId:
        Ref: SourceInstanceId

Formato JSON

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Description": "Test ECS Instance Clone",
  "Parameters": {
    "RegionId": {
      "Type": "String",
      "AssociationProperty": "ALIYUN::ECS::RegionId"
    },
    "SourceInstanceId": {
      "Type": "String",
      "AssociationProperty": "ALIYUN::ECS::Instance::InstanceId",
      "AssociationPropertyMetadata": {
        "RegionId": "${RegionId}"
      }
    }
  },
  "Resources": {
    "InstanceClone": {
      "Type": "ALIYUN::ECS::InstanceClone",
      "Properties": {
        "SourceInstanceId": {
          "Ref": "SourceInstanceId"
        }
      }
    }
  }
}