Todos os produtos
Search
Central de documentação

Resource Orchestration Service:DATASOURCE::ECS::NetworkInterfaces

Última atualização: Jun 27, 2026

Consulta informações sobre interfaces de rede elásticas (ENIs).

Sintaxe

{
  "Type": "DATASOURCE::ECS::NetworkInterfaces",
  "Properties": {
    "Status": String,
    "PrivateIpAddresses": List,
    "ServiceManaged": Boolean,
    "ResourceGroupId": String,
    "InstanceId": String,
    "SecurityGroupId": String,
    "VSwitchId": String,
    "NetworkInterfaceName": String,
    "NetworkInterfaceIds": List,
    "PrimaryIpAddress": String,
    "Ipv6Addresses": List,
    "Type": String,
    "VpcId": String,
    "Tags": List,
    "RefreshOptions": String
  }
}

Propriedades

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

Status

String

Não

Sim

Status da ENI.

Valores válidos:

  • Available: a ENI está disponível.

  • Attaching: a ENI está sendo anexada a uma instância.

  • InUse: a ENI está anexada a uma instância.

  • Detaching: a ENI está sendo desanexada de uma instância.

  • Deleting: a ENI está sendo excluída.

Nota

Se esta propriedade estiver vazia, a consulta retorna ENIs em todos os estados.

PrivateIpAddresses

List

Não

Sim

Endereços IPv4 privados secundários da ENI.

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

ServiceManaged

Boolean

Não

Sim

Indica se o usuário da ENI é um serviço da Alibaba Cloud ou um distribuidor.

Valores válidos:

  • true

  • false

ResourceGroupId

String

Não

Sim

ID do grupo de recursos.

Nenhuma.

InstanceId

String

Não

Sim

ID da instância ECS à qual a ENI está anexada.

Nenhuma.

SecurityGroupId

String

Não

Sim

ID do grupo de segurança ao qual a ENI secundária pertence.

Para consultar ENIs secundárias por grupo de segurança, especifique esta propriedade.

VSwitchId

String

Não

Sim

ID do vSwitch ao qual a ENI está conectada.

Nenhuma.

NetworkInterfaceName

String

Não

Sim

Nome da ENI.

Nenhuma.

NetworkInterfaceIds

List

Não

Sim

IDs das ENIs.

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

PrimaryIpAddress

String

Não

Sim

Endereço IPv4 privado primário da ENI.

Nenhuma.

Ipv6Addresses

List

Não

Sim

Endereços IPv6 da ENI.

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

Type

String

Não

Sim

Tipo da ENI.

Valores válidos:

  • Primary

  • Secondary

Nota

Se esta propriedade estiver vazia, a consulta retorna todos os tipos de ENIs.

VpcId

String

Não

Sim

ID da Virtual Private Cloud (VPC) à qual a ENI pertence.

Nenhuma.

Tags

List

Não

Sim

Tags da ENI.

Adicione até 20 tags.

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

RefreshOptions

String

Não

Sim

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

Valores válidos:

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

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

Sintaxe de Tags

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

Propriedades de Tags

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

Value

String

Não

Não

Valor da tag da ENI.

Nenhuma.

Key

String

Sim

Não

Chave da tag da ENI.

Nenhuma.

Valores de retorno (Fn::GetAtt)

  • NetworkInterfaceIds: os IDs das ENIs.

  • NetworkInterfaces: detalhes das ENIs.

Propriedade

Tipo

Descrição

Restrição

NetworkInterfaceIds

List

IDs das ENIs.

Nenhuma.

NetworkInterfaces

List

Detalhes das ENIs.

Nenhuma.

VpcId

String

ID da VPC à qual a ENI pertence.

Nenhuma.

Type

String

Tipo da ENI.

Valores válidos:

  • Primary

  • Secondary

Status

String

Status da ENI.

Valores válidos:

  • Available: a ENI está disponível.

  • Attaching: a ENI está sendo anexada a uma instância.

  • InUse: a ENI está anexada a uma instância.

  • Detaching: a ENI está sendo desanexada de uma instância.

  • Deleting: a ENI está sendo excluída.

NetworkInterfaceTrafficMode

String

Modo de comunicação da ENI.

Valores válidos:

  • Standard: modo de comunicação TCP

  • HighPerformance: modo de comunicação Remote Direct Memory Access (RDMA)

NetworkInterfaceId

String

ID da ENI.

Nenhuma.

InstanceId

String

ID da instância ECS à qual a ENI está anexada.

Nenhuma.

OwnerId

String

ID da conta Alibaba Cloud à qual a ENI pertence.

Nenhuma.

VSwitchId

String

ID do vSwitch ao qual a ENI está conectada.

Nenhuma.

ResourceGroupId

String

ID do grupo de recursos.

Nenhuma.

ZoneId

String

ID da zona.

Nenhuma.

PrivateIpAddress

String

Endereço IPv4 privado secundário da ENI.

Nenhuma.

QueueNumber

Number

Número de filas suportadas pela ENI.

Valores válidos:

  • Se a ENI for secundária, estiver no estado InUse e o número de filas nunca tiver sido alterado, o valor retornado será o número padrão de filas por ENI secundária suportado pelo tipo de instância.

  • Caso a ENI seja secundária e o número de filas tenha sido modificado, o novo número de filas é retornado.

  • Quando a ENI for secundária, estiver no estado Available e o número de filas nunca tiver sido alterado, um valor vazio será retornado.

  • Se a ENI for primária, o valor retornado corresponde ao número padrão de filas por ENI primária suportado pelo tipo de instância.

PrivateIpSets

List

Endereços IP privados da instância.

Nenhuma.

Ipv6Sets

List

Endereços IPv6 atribuídos à ENI.

Nenhuma.

Tags

List

As tags.

Nenhuma.

SecurityGroupIds

List

IDs dos grupos de segurança aos quais a ENI pertence.

Nenhuma.

AssociatedPublicIp

List

Endereços IP elásticos (EIPs) associados ao endereço IP privado secundário da ENI.

Nenhuma.

Exemplos

Formato JSON

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "Tags": {
      "Type": "Json",
      "Default": {"Key": "acs:privatelink:serviceType", "Value": "natgw"}
    }
  },
  "Resources": {
    "NetworkInterfaces": {
      "Type": "DATASOURCE::ECS::NetworkInterfaces",
      "Properties": {
        "RegionId": {
          "Ref": "ALIYUN::Region"
        },
        "Tags": {
          "Ref": "Tags"
        }
      }
    }
  },
  "Outputs": {
    "Images": {
      "Value": {
        "Fn::GetAtt": [
          "NetworkInterfaces",
          "NetworkInterfaceIds"
        ]
      }
    },
    "ImageIds": {
      "Value": {
        "Fn::GetAtt": [
          "NetworkInterfaces",
          "NetworkInterfaces"
        ]
      }
    }
  }
}