Todos os produtos
Search
Central de documentação

Resource Orchestration Service:DATASOURCE::ECS::Instances

Última atualização: Jun 27, 2026

Consulta informações sobre instâncias do Elastic Compute Service (ECS).

Sintaxe

{
  "Type": "DATASOURCE::ECS::Instances",
  "Properties": {
    "InnerIpAddresses": List,
    "ResourceGroupId": String,
    "PrivateIpAddresses": List,
    "InstanceChargeType": String,
    "InstanceTypeFamily": String,
    "InstanceNetworkType": String,
    "Filters": List,
    "AdditionalAttributes": List,
    "ImageId": String,
    "PublicIpAddresses": List,
    "RdmaIpAddresses": String,
    "InstanceIds": List,
    "InstanceType": String,
    "Ipv6Address": List,
    "Tags": List,
    "Status": String,
    "KeyPairName": String,
    "IoOptimized": Boolean,
    "ZoneId": String,
    "InstanceId": String,
    "HpcClusterId": String,
    "VSwitchId": String,
    "SecurityGroupId": String,
    "InternetChargeType": String,
    "InstanceName": String,
    "EipAddresses": List,
    "VpcId": String,
    "RefreshOptions": String
  }
}

Propriedades

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

InnerIpAddresses

List

Não

Sim

Endereços IP internos das instâncias implantadas na rede clássica.

Esta propriedade tem efeito quando InstanceNetworkType está definido como classic.

Especifique até 100 endereços IP. Separe vários endereços IP com vírgulas (,).

Exemplo: ["10.1.1.1", "10.1.2.1", … "10.1.10.1"].

ResourceGroupId

String

Não

Sim

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

Nenhuma.

PrivateIpAddresses

List

Não

Sim

Endereços IP privados das instâncias implantadas em Virtual Private Clouds (VPCs).

Esta propriedade tem efeito quando InstanceNetworkType está definido como vpc.

Especifique até 100 endereços IP. Separe vários endereços IP com vírgulas (,).

Exemplo: ["172.16.1.1", "172.16.2.1", … "172.16.10.1"].

InstanceChargeType

String

Não

Sim

Método de faturamento da instância.

Valores válidos:

  • PostPaid

  • PrePaid

InstanceTypeFamily

String

Não

Sim

Família da instância.

Nenhuma.

InstanceNetworkType

String

Não

Sim

Tipo de rede da instância.

Valores válidos:

  • classic

  • vpc

Filters

List

Não

Sim

Filtros para consulta de recursos.

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

AdditionalAttributes

List

Não

Sim

Atributos adicionais.

Valores válidos:

  • META_OPTIONS: metadados da instância

  • DDH_CLUSTER: cluster de host dedicado

  • NETWORK_PRIMARY_ENI_IP: endereço IP secundário associado à interface de rede elástica (ENI) primária

ImageId

String

Não

Sim

ID da imagem.

Nenhuma.

PublicIpAddresses

List

Não

Sim

Endereços IP públicos das instâncias.

Especifique até 100 endereços IP. Separe vários endereços IP com vírgulas (,).

Exemplo: ["192.0.2.0", "192.0.2.1", …, "192.0.2.10"].

RdmaIpAddresses

String

Não

Sim

Endereços IP de Remote Direct Memory Access (RDMA) das instâncias que pertencem a um cluster de High Performance Computing (HPC).

Nenhuma.

InstanceIds

List

Não

Sim

IDs das instâncias.

Especifique até 100 IDs. Separe vários IDs com vírgulas (,).

InstanceType

String

Não

Sim

Tipo da instância.

Nenhuma.

Ipv6Address

List

Não

Sim

Endereços IPv6 da ENI.

Especifique até 100 endereços IP. Separe vários endereços IP com vírgulas (,).

Tags

List

Não

Sim

Tags da instância.

Adicione até 20 tags.

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

Status

String

Não

Sim

Status da instância.

Valores válidos:

  • Pending: a instância está sendo criada.

  • Running: a instância está em execução.

  • Starting: a instância está sendo iniciada.

  • Stopping: a instância está sendo parada.

  • Stopped: a instância está parada.

KeyPairName

String

Não

Sim

Nome do par de chaves SSH vinculado à instância.

Nenhuma.

IoOptimized

Boolean

Não

Sim

Indica se a instância é otimizada para E/S.

Valores válidos:

  • true

  • false

ZoneId

String

Não

Sim

ID da zona.

Nenhuma.

InstanceId

String

Não

Sim

ID da instância.

Nenhuma.

HpcClusterId

String

Não

Sim

ID do cluster HPC ao qual a instância pertence.

Nenhuma.

VSwitchId

String

Não

Sim

ID do vSwitch.

Nenhuma.

SecurityGroupId

String

Não

Sim

ID do grupo de segurança.

Nenhuma.

InternetChargeType

String

Não

Sim

Método de medição para uso de rede.

Valores válidos:

  • PayByBandwidth

  • PayByTraffic

InstanceName

String

Não

Sim

Nome da instância.

Nenhuma.

EipAddresses

List

Não

Sim

Endereços IP elásticos (EIPs) das instâncias.

Esta propriedade tem efeito quando InstanceNetworkType está definido como vpc.

Especifique até 100 EIPs. Separe vários EIPs com vírgulas (,).

VpcId

String

Não

Sim

ID da VPC.

Nenhuma.

RefreshOptions

String

Não

Sim

Política de atualização dos recursos da source de dados durante a atualização da pilha.

Valores válidos:

  • Never (padrão): não atualiza os recursos da source de dados durante a atualização da pilha.

  • Always: atualiza os recursos da source de dados durante a atualização da pilha.

Sintaxe de Filters

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

Propriedades de Filters

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

Key

String

Sim

Não

Chave do filtro.

Defina o valor como CreationStartTime. Esse valor especifica o início do intervalo de tempo de criação dos recursos.

Especifique Key e Value para consultar recursos criados após o momento especificado.

Value

String

Não

Não

Valor do filtro.

Especifique a hora no padrão ISO 8601 no formato yyyy-MM-ddTHH:mmZ. A hora deve estar em UTC+0.

Sintaxe de Tags

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

Propriedades de Tags

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

Key

String

Sim

Não

Chave da tag.

Nenhuma.

Value

String

Não

Não

Valor da tag.

Nenhuma.

Valores de retorno (Fn::GetAtt)

  • InstanceIds: os IDs das instâncias.

  • Instances: detalhes das instâncias.

Propriedade

Tipo

Descrição

Restrição

InstanceIds

List

IDs das instâncias.

Nenhuma.

Instances

List

Detalhes das instâncias.

Nenhuma.

SerialNumber

String

Número de série da instância.

Nenhuma.

Status

String

Status da instância.

Nenhuma.

DeploymentSetId

String

ID do conjunto de implantação.

Nenhuma.

SpotStrategy

String

Política de preempção para a instância de pagamento conforme o uso.

Valores válidos:

  • NoSpot: a instância é criada como uma instância regular de pagamento conforme o uso.

  • SpotWithPriceLimit: a instância é criada como uma instância preemptível com preço máximo por hora definido pelo usuário.

  • SpotAsPriceGo: a instância é criada como uma instância preemptível que usa automaticamente o preço de mercado no momento da compra como preço do lance. O preço de mercado pode chegar ao preço de pagamento conforme o uso.

DeviceAvailable

Boolean

Indica se discos de dados podem ser anexados à instância.

Valores válidos:

  • true

  • false

Description

String

Descrição da instância.

Nenhuma.

InstanceNetworkType

String

Tipo de rede da instância.

Valores válidos:

  • classic

  • vpc

InstanceName

String

Nome da instância.

Nenhuma.

OSNameEn

String

Nome do SO da instância em inglês.

Nenhuma.

SpotPriceLimit

Number

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

Esta propriedade tem efeito quando SpotStrategy está definido como SpotWithPriceLimit.

Memory

Number

Tamanho da memória.

Unidade: MiB.

OSName

String

Nome do SO da instância em chinês.

Nenhuma.

ImageId

String

ID da imagem.

Nenhuma.

GPUSpec

String

Modelo de GPU usado pelo tipo de instância.

Nenhuma.

StoppedMode

String

Modo de parada da instância. Determina se o faturamento continua após a parada da instância.

Valores válidos:

  • KeepCharging: modo padrão. O faturamento continua após a parada da instância e os recursos são retidos.

  • StopCharging: modo econômico. O faturamento de recursos específicos é interrompido após a parada da instância. Recursos como vCPUs, memória e endereços IP públicos são liberados.

  • Not-applicable: o modo econômico não se aplica à instância.

GPUAmount

Number

Quantidade de GPUs usadas pelo tipo de instância.

Nenhuma.

HostName

String

Nome do host da instância.

Nenhuma.

InstanceId

String

ID da instância.

Nenhuma.

InternetMaxBandwidthOut

Number

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

Unidade: Mbit/s.

InternetMaxBandwidthIn

Number

Largura de banda pública de entrada máxima.

Unidade: Mbit/s.

InstanceType

String

Tipo da instância.

Nenhuma.

InstanceChargeType

String

Método de faturamento da instância.

Valores válidos:

  • PrePaid

  • PostPaid

IoOptimized

Boolean

Indica se a instância é otimizada para E/S.

Valores válidos:

  • true

  • false

Cpu

Number

Número de vCPUs.

Nenhuma.

ResourceGroupId

String

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

Nenhuma.

InternetChargeType

String

Método de medição para uso de rede.

Valores válidos:

  • PayByBandwidth

  • PayByTraffic

ZoneId

String

ID da zona.

Nenhuma.

InstanceTypeFamily

String

Família da instância.

Nenhuma.

OSType

String

Tipo de SO da instância.

Valores válidos:

  • windows

  • linux

NetworkInterfaces

List

ENIs anexadas à instância.

Nenhuma.

Tags

List

Tags da instância.

Nenhuma.

SecurityGroupIds

List

IDs dos grupos de segurança aos quais a instância pertence.

Nenhuma.

PublicIpAddress

List

Endereços IP públicos das instâncias.

Nenhuma.

InnerIpAddress

List

Endereços IP internos das instâncias implantadas na rede clássica.

Nenhuma.

EipAddress

List

EIPs das instâncias.

Nenhuma.

DedicatedHostAttribute

List

Atributos do host dedicado.

Nenhuma.

EcsCapacityReservationAttr

List

Atributos da reserva de capacidade da instância.

Nenhuma.

DedicatedInstanceAttribute

List

Atributos da instância no host dedicado.

Nenhuma.

OperationLocks

List

Motivos do bloqueio da instância.

Nenhuma.

PrivateIpAddress

List

Endereços IP privados das instâncias.

Nenhuma.

VpcId

String

ID da VPC.

Nenhuma.

VswitchId

String

ID do vSwitch.

Nenhuma.

Exemplos

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  InstanceIds:
    Type: Json
    Default:
      - i-bp17f03tk0f4bi86***
Resources:
  NetworkInterfaces:
    Type: DATASOURCE::ECS::Instances
    Properties:
      InstanceIds:
        Ref: InstanceIds
Outputs:
  Images:
    Value:
      Fn::GetAtt:
        - NetworkInterfaces
        - InstanceIds
  ImageIds:
    Value:
      Fn::GetAtt:
        - NetworkInterfaces
        - Instances
                    
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "InstanceIds": {
      "Type": "Json",
      "Default": [
        "i-bp17f03tk0f4bi86***"
      ]
    }
  },
  "Resources": {
    "NetworkInterfaces": {
      "Type": "DATASOURCE::ECS::Instances",
      "Properties": {
        "InstanceIds": {
          "Ref": "InstanceIds"
        }
      }
    }
  },
  "Outputs": {
    "Images": {
      "Value": {
        "Fn::GetAtt": [
          "NetworkInterfaces",
          "InstanceIds"
        ]
      }
    },
    "ImageIds": {
      "Value": {
        "Fn::GetAtt": [
          "NetworkInterfaces",
          "Instances"
        ]
      }
    }
  }
}