Todos os produtos
Search
Central de documentação

Resource Orchestration Service:ALIYUN::ECS::CopyImage

Última atualização: Jun 27, 2026

Copia uma imagem personalizada de uma região para outra.

Sintaxe

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

Propriedades

Propriedade

Tipo

Obrigatória

Editável

Descrição

Restrição

Encrypted

Boolean

Não

Não

Indica se a cópia da imagem deve ser criptografada.

Valores válidos:

  • true

  • false (padrão)

DestinationImageName

String

Não

Não

Nome da imagem personalizada de destino.

O nome deve ter de 2 a 128 caracteres. Deve começar com uma letra e não pode iniciar com http:// ou https://. Pode conter letras, dígitos, dois pontos (:), sublinhados (_) e hifens (-).

ImageId

String

Sim

Não

ID da imagem personalizada de origem.

Nenhuma.

DestinationRegionId

String

Sim

Não

ID da região de destino.

Nenhuma.

SourceRegionId

String

Não

Não

ID da região de origem.

Por padrão, o ID da região atual é usado.

Tag

List

Não

Não

As tags.

Para mais informações, consulte Propriedades de Tag.

DestinationDescription

String

Não

Não

Descrição da imagem personalizada de destino.

A descrição deve ter de 2 a 256 caracteres. Não pode começar com http:// ou https://.

KMSKeyId

String

Não

Não

ID da chave KMS usada para criptografar a imagem.

Nenhuma.

ResourceGroupId

String

Não

Sim

ID do grupo de recursos.

Nenhuma.

AllowCopyInSameRegion

Boolean

Não

Não

Indica se a cópia de imagem na mesma região é proibida.

Valores válidos:

  • true: proíbe a cópia de imagem na mesma região, retorna o ID da imagem de origem e mantém a imagem original.

  • false: permite a cópia de imagem na mesma região.

Sintaxe de Tag

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

Propriedades de Tag

Propriedade

Tipo

Obrigatória

Editável

Descrição

Restrição

Key

String

Não

Não

Chave da tag.

A chave da tag deve ter de 1 a 128 caracteres e não pode conter http:// ou https://. Não pode começar com aliyun ou acs:.

Value

String

Não

Não

Valor da tag.

O valor da tag pode ter até 128 caracteres e não pode conter http:// ou https://. Não pode começar com aliyun ou acs:.

Valores de retorno

Fn::GetAtt

  • ImageId: ID da imagem personalizada de destino.

  • DestinationRegionId: ID da região de destino.

  • SourceRegionId: ID da região de origem.

Exemplos

  • 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"
            ]
          }
        }
      }
    }