Use ALIYUN::ECS::NetworkInterface in a call to create an ENI - Resource Orchestration Service: Central de Documentação do Alibaba Cloud

O recurso ALIYUN::ECS::NetworkInterface crie uma elastic network interface (ENI).

Sintaxe

{
  "Type": "ALIYUN::ECS::NetworkInterface",
  "Properties": {
    "Description": String,
    "SecurityGroupId": String,
    "PrimaryIpAddress": String,
    "ResourceGroupId": String,
    "VSwitchId": String,
    "NetworkInterfaceName": String,
    "Tags": List,
    "SecurityGroupIds": List,
    "PrivateIpAddresses": List,
    "SecondaryPrivateIpAddressCount": Integer,
    "Ipv6Addresses": List,
    "QueueNumber": Integer,
    "NetworkInterfaceTrafficMode": String,
    "Ipv6AddressCount": Integer,
    "Ipv6Prefixes": List,
    "Ipv4Prefixes": List,
    "Ipv4PrefixCount": Integer,
    "TxQueueSize": Integer,
    "DeleteOnRelease": Boolean,
    "Ipv6PrefixCount": Integer,
    "RxQueueSize": Integer
  }
}

Propriedades

Propriedade	Tipo	Obrigatória	Editável	Descrição	Restrição
ResourceGroupId	String	Não	Sim	ID do grupo de recursos.	Chame a operação ListResourceGroups para consultar o ID do grupo de recursos.
SecurityGroupId	String	Não	Sim	ID do grupo de segurança.	O grupo de segurança e a ENI devem pertencer à mesma virtual private cloud (VPC). Nota Não especifique SecurityGroupId e SecurityGroupIds simultaneamente.
VSwitchId	String	Sim	Não	ID do vSwitch.	Nenhuma.
Description	String	Não	Sim	Descrição da ENI.	A descrição deve ter de 2 a 256 caracteres e não pode começar com `http://` ou `https://`.
NetworkInterfaceName	String	Não	Sim	Nome da ENI.	O nome deve ter de 2 a 128 caracteres, começar com uma letra e não pode iniciar com `http://` ou `https://`. Pode conter letras, dígitos, dois pontos (:), sublinhados (_) e hifens (-).
PrimaryIpAddress	String	Não	Não	Endereço IP privado principal da ENI.	O endereço IP privado principal deve estar disponível no bloco CIDR do vSwitch ao qual você deseja associar a ENI. Se esta propriedade ficar vazia, um endereço IP disponível será atribuído aleatoriamente a partir do bloco CIDR do vSwitch.
SecondaryPrivateIpAddressCount	Integer	Não	Não	Quantidade de endereços IP privados secundários.	Nenhuma.
Tags	List	Não	Sim	As tags.	É possível adicionar até 20 tags. Para mais informações, consulte Propriedades de Tags.
SecurityGroupIds	List	Não	Sim	IDs de um ou mais grupos de segurança.	Os grupos de segurança e a ENI devem pertencer à mesma VPC. Nota Não especifique SecurityGroupId e SecurityGroupIds simultaneamente.
PrivateIpAddresses	List	Não	Não	Um ou mais endereços IP privados secundários para atribuir à ENI a partir do bloco CIDR do vSwitch ao qual você deseja associá-la.	Valores válidos para a quantidade de endereços IP privados secundários atribuíveis à ENI: Se a ENI estiver no estado Available, os valores válidos variam de 1 a 10. Caso a ENI esteja no estado InUse, os valores válidos dependem do tipo de instância. Para mais informações, consulte Visão geral das famílias de instâncias.
Ipv6Addresses	List	Não	Não	Um ou mais endereços IPv6 para atribuir à ENI.	É possível especificar até 10 endereços IPv6. Nota Para atribuir endereços IPv6 à ENI, especifique a propriedade `Ipv6Addresses` ou `Ipv6AddressCount`, mas não ambas.
QueueNumber	Integer	Não	Não	Número de filas suportadas pela ENI.	Valores válidos: 1 a 2048. Ao anexar a ENI a uma instância, garanta que o valor desta propriedade seja inferior ao número máximo de filas por ENI permitido para o tipo de instância. Para consultar esse limite, chame a operação DescribeInstanceTypes e verifique o valor retornado de `MaximumQueueNumberPerEni`. A propriedade QueueNumber fica vazia por padrão. Se você deixar esta propriedade vazia ao anexar a ENI a uma instância, o sistema usará o número padrão de filas por ENI do tipo de instância. Para consultar esse valor padrão, chame a operação DescribeInstanceTypes e verifique o valor retornado de `SecondaryEniQueueNumber`.
NetworkInterfaceTrafficMode	String	Não	Não	Modo de comunicação da ENI.	Valores válidos: Standard: usa o modo de comunicação TCP. HighPerformance: usa o modo de comunicação remote direct memory access (RDMA) com o recurso Elastic RDMA Interface (ERI) ativado. Nota O valor HighPerformance suporta apenas a família de instâncias aprimoradas para RDMA c7re. O número máximo de ENIs no modo RDMA anexáveis a uma instância c7re depende do tipo de instância. A família de instâncias c7re está em preview por convite na Zona K de Pequim. Para mais informações, consulte Visão geral das famílias de instâncias.
Ipv6AddressCount	Integer	Não	Não	Quantidade de endereços IPv6 a gerar aleatoriamente para a ENI.	Valores válidos: 1 a 10. Nota Para atribuir endereços IPv6 à ENI, especifique a propriedade `Ipv6Addresses` ou `Ipv6AddressCount`, mas não ambas.
Ipv6Prefixes	List	Não	Não	Os prefixos IPv6.	Nenhuma.
Ipv4Prefixes	List	Não	Não	Os prefixos IPv4.	Nenhuma.
Ipv4PrefixCount	Integer	Não	Não	Número de prefixos IPv4 a atribuir à ENI.	Valores válidos: 1 a 10. Nota Para atribuir prefixos IPv4 à ENI, especifique a propriedade Ipv4Prefixes ou Ipv4PrefixCount, mas não ambas.
TxQueueSize	Integer	Não	Sim	Profundidade da fila de transmissão (Tx) da ENI.	Observe os seguintes itens: A profundidade da fila Tx de uma ENI deve ser igual à profundidade da fila de recepção (Rx) da mesma ENI. Valores válidos: potências de 2 no intervalo de 8192 a 16384. Uma maior profundidade de fila Tx proporciona maior throughput de saída, mas consome mais memória.
DeleteOnRelease	Boolean	Não	Sim	Define se a ENI deve ser mantida quando a instância associada for liberada.	Valores válidos: true false
Ipv6PrefixCount	Integer	Não	Não	Número de prefixos IPv6 a atribuir à ENI.	Valores válidos: 1 a 10. Nota Para atribuir prefixos IPv6 à ENI, especifique a propriedade Ipv6Prefixes ou Ipv6PrefixCount, mas não ambas.
RxQueueSize	Integer	Não	Sim	Profundidade da fila Rx da ENI.	Observe os seguintes itens: A profundidade da fila Rx de uma ENI deve ser igual à profundidade da fila Tx da mesma ENI. Valores válidos: potências de 2 no intervalo de 8192 a 16384. Uma maior profundidade de fila Rx proporciona maior throughput de entrada, mas consome mais memória.

Sintaxe de Tags

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

Propriedades de Tags

Propriedade	Tipo	Obrigatória	Editável	Descrição	Restrição
Key	String	Sim	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

NetworkInterfaceId: o ID da ENI.
MacAddress: o endereço media access control (MAC) da ENI.
PrivateIpAddress: o endereço IP privado da ENI.
SecondaryPrivateIpAddresses: os endereços IP privados secundários da ENI.
Arn: o Alibaba Cloud Resource Name (ARN).

Exemplos

Formato `YAML`

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  SecurityGroupId:
    Type: String
    AssociationProperty: ALIYUN::ECS::SecurityGroup::SecurityGroupId
    Label:
       
      en: Security Group ID
  VSwitchId:
    AssociationProperty: ALIYUN::ECS::VSwitch::VSwitchId
    Type: String
    Label:
       
      en: VSwitch ID
Resources:
  EniInstance:
    Type: ALIYUN::ECS::NetworkInterface
    Properties:
      SecurityGroupId:
        Ref: SecurityGroupId
      VSwitchId:
        Ref: VSwitchId
      NetworkInterfaceName: TestNetworkInterface
Outputs:
  PrivateIpAddress:
    Description: The primary private ip address of your Network Interface.
    Value:
      Fn::GetAtt:
        - EniInstance
        - PrivateIpAddress
  SecondaryPrivateIpAddresses:
    Description: The secondary private IP addresses of your Network Interface.
    Value:
      Fn::GetAtt:
        - EniInstance
        - SecondaryPrivateIpAddresses
  MacAddress:
    Description: The MAC address of your Network Interface.
    Value:
      Fn::GetAtt:
        - EniInstance
        - MacAddress
  NetworkInterfaceId:
    Description: ID of your Network Interface.
    Value:
      Fn::GetAtt:
        - EniInstance
        - NetworkInterfaceId

Formato `JSON`

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "SecurityGroupId": {
      "Type": "String",
      "AssociationProperty": "ALIYUN::ECS::SecurityGroup::SecurityGroupId",
      "Label": {
         
        "en": "Security Group ID"
      }
    },
    "VSwitchId": {
      "AssociationProperty": "ALIYUN::ECS::VSwitch::VSwitchId",
      "Type": "String",
      "Label": {
         
        "en": "VSwitch ID"
      }
    }
  },
  "Resources": {
    "EniInstance": {
      "Type": "ALIYUN::ECS::NetworkInterface",
      "Properties": {
        "SecurityGroupId": {
          "Ref": "SecurityGroupId"
        },
        "VSwitchId": {
          "Ref": "VSwitchId"
        },
        "NetworkInterfaceName": "TestNetworkInterface"
      }
    }
  },
  "Outputs": {
    "PrivateIpAddress": {
      "Description": "The primary private ip address of your Network Interface.",
      "Value": {
        "Fn::GetAtt": [
          "EniInstance",
          "PrivateIpAddress"
        ]
      }
    },
    "SecondaryPrivateIpAddresses": {
      "Description": "The secondary private IP addresses of your Network Interface.",
      "Value": {
        "Fn::GetAtt": [
          "EniInstance",
          "SecondaryPrivateIpAddresses"
        ]
      }
    },
    "MacAddress": {
      "Description": "The MAC address of your Network Interface.",
      "Value": {
        "Fn::GetAtt": [
          "EniInstance",
          "MacAddress"
        ]
      }
    },
    "NetworkInterfaceId": {
      "Description": "ID of your Network Interface.",
      "Value": {
        "Fn::GetAtt": [
          "EniInstance",
          "NetworkInterfaceId"
        ]
      }
    }
  }
}

Sintaxe

Propriedades

Sintaxe de Tags

Propriedades de Tags

Valores de retorno

Exemplos

Formato YAML

Formato JSON

Formato `YAML`

Formato `JSON`