Todos los productos
Search
Centro de documentos

Resource Orchestration Service:ALIYUN::ECS::CopyImage

Última actualización: Sep 04, 2026

Copia una imagen personalizada de una región a otra.

Sintaxis

{
  "Type": "ALIYUN::ECS::CopyImage",
  "Properties": {
    "Encrypted": Boolean,
    "DestinationImageName": String,
    "ImageId": String,
    "DestinationRegionId": String,
    "SourceRegionId": String,
    "Tag": List,
    "DestinationDescription": String,
    "KMSKeyId": String,
    "ResourceGroupId": String,
    "AllowCopyInSameRegion": Boolean
  }
}

Propiedades

Propiedad

Tipo

Obligatorio

Editable

Descripción

Restricción

Encrypted

Boolean

No

No

Indica si se cifra la copia de la imagen.

Valores válidos:

  • true

  • false (predeterminado)

DestinationImageName

String

No

No

Nombre de la imagen personalizada de destino.

El nombre debe tener de 2 a 128 caracteres. Debe comenzar con una letra y no puede empezar con http:// ni con https://. Puede contener letras, dígitos, dos puntos (:), guiones bajos (_) y guiones (-).

ImageId

String

Sí

No

ID de la imagen personalizada de origen.

Ninguna.

DestinationRegionId

String

Sí

No

ID de la región de destino.

Ninguna.

SourceRegionId

String

No

No

ID de la región de origen.

De forma predeterminada, se usa el ID de la región actual.

Tag

List

No

No

Etiquetas.

Para obtener más información, consulte Tag properties.

DestinationDescription

String

No

No

Descripción de la imagen personalizada de destino.

La descripción debe tener de 2 a 256 caracteres. No puede comenzar con http:// ni con https://.

KMSKeyId

String

No

No

ID de la clave KMS que se usa para cifrar la imagen.

Ninguna.

ResourceGroupId

String

No

Sí

ID del resource group.

Ninguna.

AllowCopyInSameRegion

Boolean

No

No

Indica si se prohíbe la copia de imágenes dentro de la misma región.

Valores válidos:

  • true: prohíbe la copia de imágenes dentro de la misma región, devuelve el ID de la imagen de origen y conserva dicha imagen.

  • false: permite la copia de imágenes dentro de la misma región.

Sintaxis de etiquetas

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

Propiedades de etiquetas

Propiedad

Tipo

Obligatorio

Editable

Descripción

Restricción

Key

String

No

No

Clave de la etiqueta.

La clave de la etiqueta debe tener de 1 a 128 caracteres y no puede contener http:// ni https://. No puede comenzar con aliyun ni con acs:.

Value

String

No

No

Valor de la etiqueta.

El valor de la etiqueta puede tener hasta 128 caracteres y no puede contener http:// ni https://. No puede comenzar con aliyun ni con acs:.

Valores de retorno

Fn::GetAtt

  • ImageId: ID de la imagen personalizada de destino.

  • DestinationRegionId: ID de la región de destino.

  • SourceRegionId: ID de la región de origen.

Ejemplos

  • Formato YAML

    ROSTemplateFormatVersion: '2015-09-01'
    Description:
       
      en: Create ECS CopyImage
    Parameters:
      ImageId:
        Type: String
        AssociationProperty: ALIYUN::ECS::Image::ImageId
        AssociationPropertyMetadata:
          SupportedImageOwnerAlias:
            - self
    Resources:
      CopyImage:
        Type: ALIYUN::ECS::CopyImage
        Properties:
          Encrypted: false
          ImageId:
            Ref: ImageId
          DestinationRegionId: cn-shanghai
          SourceRegionId: cn-hangzhou
          DestinationDescription: Test CopyImage
    Outputs:
      CopyImageId:
        Value:
          Fn::GetAtt:
            - CopyImage
            - ImageId                    
  • Formato JSON

    {
      "ROSTemplateFormatVersion": "2015-09-01",
      "Description": {
         
        "en": "Create ECS CopyImage"
      },
      "Parameters": {
        "ImageId": {
          "Type": "String",
          "AssociationProperty": "ALIYUN::ECS::Image::ImageId",
          "AssociationPropertyMetadata": {
            "SupportedImageOwnerAlias": [
              "self"
            ]
          }
        }
      },
      "Resources": {
        "CopyImage": {
          "Type": "ALIYUN::ECS::CopyImage",
          "Properties": {
            "Encrypted": false,
            "ImageId": {
              "Ref": "ImageId"
            },
            "DestinationRegionId": "cn-shanghai",
            "SourceRegionId": "cn-hangzhou",
            "DestinationDescription": "Test CopyImage"
          }
        }
      },
      "Outputs": {
        "CopyImageId": {
          "Value": {
            "Fn::GetAtt": [
              "CopyImage",
              "ImageId"
            ]
          }
        }
      }
    }