Todos os produtos
Search
Central de documentação

Resource Orchestration Service:ALIYUN::ECS::InstanceClone

Última atualização: Aug 20, 2026

O tipo ALIYUN::ECS::InstanceClone clona uma instância ECS.

Sintaxe

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

Propriedades

Nome da propriedade

Tipo

Obrigatório

Atualização permitida

Descrição

Restrições

ResourceGroupId

String

Não

Não

ID do grupo de recursos ao qual a nova instância pertence.

Nenhuma

SourceInstanceId

String

Sim

Não

ID da instância ECS de origem a ser clonada.

A clonagem copia todos os dados e configurações da instância, como tipo de instância, imagem, método de faturamento de largura de banda, limite de largura de banda e tipo de rede. Se a instância ECS de origem estiver associada a vários grupos de segurança, a nova instância será adicionada ao primeiro grupo de segurança da instância de origem.

BackendServerWeight

Integer

Não

Não

Peso da nova instância ECS na instância SLB.

Valores válidos: 0 a 100.

Valor padrão: 100.

LoadBalancerIdToAttach

String

Não

Não

ID da instância SLB à qual adicionar a nova instância ECS.

Nenhuma

Description

String

Não

Não

Descrição da instância.

A descrição pode ter até 256 caracteres.

ImageId

String

Não

Sim

ID da imagem usada para iniciar a nova instância ECS. Pode ser uma imagem pública, personalizada ou do Alibaba Cloud Marketplace.

É possível especificar um ID de imagem pública usando correspondência aproximada. Não é necessário informar o ID completo da imagem pública. Exemplo:

  • Se você especificar ubuntu, o sistema corresponderá a ubuntu16_0402_64_20G_alibase_20170818.vhd.

  • Se você especificar ubuntu_14, o sistema corresponderá a ubuntu_14_0405_64_20G_alibase_20170824.vhd.

  • Se você especificar ubuntu1432, o sistema corresponderá a ubuntu_14_0405_32_40G_alibase_20170711.vhd.

  • Se você especificar ubuntu_16_0402_32, o sistema corresponderá a ubuntu_16_0402_32_40G_alibase_20170711.vhd.

SecurityGroupId

String

Não

Não

ID do grupo de segurança ao qual a nova instância pertence.

Nenhuma

InstanceName

String

Não

Sim

Nome da nova instância.

O nome deve ter entre 2 e 128 caracteres. Deve começar com uma letra ou caractere chinês e não pode iniciar com http:// ou https://. Pode conter letras, caracteres chineses, dígitos, dois pontos (:), sublinhados (_) e hífens (-).

Password

String

Não

Não

Senha de login da nova instância ECS.

O comprimento deve estar entre 8 e 30 caracteres.

Deve conter três dos seguintes tipos de caracteres: letras maiúsculas, letras minúsculas, dígitos e caracteres especiais.

Caracteres especiais suportados: ( ) ' ~ ! @ # $ % ^ & * - + = | { } [ ] : ; ‘ < > , . ? /.

Caso especifique este parâmetro, chame a API via HTTPS para evitar vazamento da senha.

DiskMappings

List

Não

Sim

Discos a serem anexados.

É possível anexar até 16 discos.

Para mais informações, consulte DiskMappings properties.

Tags

List

Não

Sim

Tags personalizadas.

Adicione até 20 tags. Formato: [{"Key":"tagKey","Value":"tagValue"},{"Key":"tagKey2","Value":"tagValue2"}].

Para mais informações, consulte Tags properties.

ZoneId

String

Não

Não

ID da zona.

Nenhuma

InstanceChargeType

String

Não

Não

Método de faturamento da nova instância.

Valores válidos:

  • PrePaid: assinatura.

    Nota

    Ao definir o valor como PrePaid, certifique-se de que sua conta tenha saldo suficiente. Caso contrário, a criação da instância falhará.

  • PostPaid (padrão): pagamento conforme o uso.

Period

Number

Não

Não

Período da assinatura.

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

Unidade: mês.

Este parâmetro é obrigatório quando InstanceChargeType está definido como PrePaid. É opcional quando InstanceChargeType está definido como PostPaid.

KeyPairName

String

Não

Sim

Nome do par de chaves a ser anexado à nova instância ECS.

O valor padrão para Windows é vazio.

No Linux, caso este parâmetro seja especificado, o conteúdo do parâmetro Password ainda será definido para a instância, mas o login por senha ficará desativado por padrão. A autenticação por par de chaves será utilizada para login.

RamRoleName

String

Não

Não

Nome da função RAM da instância para a nova instância.

Para mais informações, consulte Create a role e Get a list of roles.

SpotPriceLimit

String

Não

Não

Preço máximo por hora da nova instância.

Este parâmetro aceita até três casas decimais. Só tem efeito quando SpotStrategy está definido como SpotWithPriceLimit.

SpotStrategy

String

Não

Não

Política de lance para a nova instância de pagamento conforme o uso.

Este parâmetro só tem efeito quando InstanceChargeType está definido como PostPaid. Valores válidos:

  • NoSpot (padrão): instância regular de pagamento conforme o uso.

  • SpotWithPriceLimit: instância spot com preço máximo definido pelo usuário.

  • SpotAsPriceGo: o sistema dá lances automaticamente a um preço não superior ao preço de pagamento conforme o uso.

DeletionProtection

Boolean

Não

Não

Atributo de proteção contra liberação da nova instância. Define se a instância pode ser liberada pelo console ou chamando a operação DeleteInstance.

Valores válidos:

  • true: a instância pode ser liberada por chamada de API.

  • false (padrão): a instância não pode ser liberada por chamada de API.

InternetMaxBandwidthIn

Integer

Não

Não

Largura de banda máxima de saída da rede pública

Unidade: Mbit/s.

Valores válidos: 0 a 200.

Valor padrão: 200.

Sintaxe de DiskMappings

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

Propriedades de DiskMappings

Nome da propriedade

Tipo

Obrigatório

Atualização permitida

Descrição

Restrições

Size

String

Sim

Não

Tamanho do disco de dados.

Valores válidos: 20 a 500.

Unidade: GB.

Category

String

Não

Não

Tipo do disco de dados.

Valores válidos:

  • cloud: disco básico.

  • cloud_ssd: SSD padrão.

  • cloud_essd: SSD empresarial.

  • cloud_efficiency: disco ultra.

  • ephemeral_ssd: SSD local.

O valor padrão para instâncias otimizadas para I/O é cloud_efficiency. Para instâncias não otimizadas para I/O, o padrão é cloud.

DiskName

String

Não

Não

Nome do disco de dados.

O nome deve ter entre 2 e 128 caracteres. Deve começar com uma letra ou caractere chinês e não pode iniciar com http:// ou https://. Pode conter letras, caracteres chineses, dígitos, sublinhados (_), dois pontos (:) ou hífens (-).

PerformanceLevel

String

Não

Não

Ao criar um SSD empresarial para uso como disco do sistema, defina o nível de desempenho do disco.

Valores válidos:

  • PL0: o disco oferece até 10.000 IOPS de leitura/gravação aleatória.

  • PL1 (padrão): o disco oferece até 50.000 IOPS de leitura/gravação aleatória.

  • PL2: o disco oferece até 100.000 IOPS de leitura/gravação aleatória.

  • PL3: o disco oferece até 1.000.000 IOPS de leitura/gravação aleatória.

Para informações sobre como selecionar um nível de desempenho ESSD, consulte Enterprise SSDs.

Description

String

Não

Não

Descrição do disco.

O comprimento deve estar entre 2 e 256 caracteres.

O valor padrão é vazio.

Device

String

Não

Não

Destino de montagem.

Este parâmetro está sendo descontinuado. Para garantir compatibilidade, recomendamos não utilizá-lo.

SnapshotId

String

Não

Não

Snapshot usado para criar o disco de dados.

Nenhuma

Sintaxe de Tags

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

Propriedades de Tags

Nome da propriedade

Tipo

Obrigatório

Atualização permitida

Descrição

Restrições

Key

String

Sim

Não

Chave da tag.

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

Value

String

Não

Não

Valor da tag.

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

Valores de retorno

Fn::GetAtt

  • InstanceId: ID da nova instância. Trata-se de um identificador exclusivo global gerado pelo sistema.

  • PrivateIp: endereço IP privado da instância em uma VPC. Este atributo é retornado apenas quando NetworkType está definido como vpc.

  • InnerIp: endereço IP privado da instância na rede clássica. Este atributo é retornado apenas quando NetworkType está definido como classic.

  • PublicIp: endereço IP público da instância na rede clássica. Este atributo é retornado apenas quando NetworkType está definido como classic.

  • ZoneId: ID da zona.

  • HostName: nome do host da instância.

  • PrimaryNetworkInterfaceId: ID do controlador de interface de rede (NIC) primário.

  • SecurityGroupIds: lista dos IDs dos grupos de segurança aos quais a instância pertence.

Exemplos

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