Todos os produtos
Search
Central de documentação

Resource Orchestration Service:ALIYUN::ECS::AssignPrivateIpAddresses

Última atualização: Jun 27, 2026

O recurso ALIYUN::ECS::AssignPrivateIpAddresses atribui endereços IP privados secundários a uma elastic network interface (ENI). É possível especificar endereços IP privados disponíveis dentro do bloco CIDR do vSwitch associado à ENI. Como alternativa, indique uma quantidade para que o sistema atribua automaticamente esse número de endereços IP privados à ENI.

Sintaxe

{
  "Type": "ALIYUN::ECS::AssignPrivateIpAddresses",
  "Properties": {
    "NetworkInterfaceId": String,
    "SecondaryPrivateIpAddressCount": Integer,
    "Ipv4Prefixes": List,
    "Ipv4PrefixCount": Integer,
    "PrivateIpAddresses": List
  }
}

Propriedades

Propriedade

Tipo

Obrigatória

Editável

Descrição

Restrição

NetworkInterfaceId

String

Sim

Não

O ID da ENI.

Nenhuma.

SecondaryPrivateIpAddressCount

Integer

Não

Não

A quantidade de endereços IP privados.

Nenhuma.

Ipv4Prefixes

List

Não

Não

Um ou mais prefixos IPv4 para atribuir à ENI.

Exemplo:

["192.168../28"]. É permitido especificar até 10 prefixos IPv4.

Ipv4PrefixCount

Integer

Não

Não

O número de prefixos IPv4 a serem gerados aleatoriamente para a ENI.

Valores válidos: 1 a 10.

PrivateIpAddresses

List

Não

Não

Um ou mais endereços IP privados secundários dentro do bloco CIDR do vSwitch associado à ENI.

Se a ENI estiver no estado Available, o limite é de 10 endereços IP. Caso esteja no estado InUse, a quantidade permitida varia conforme o tipo de instância. Para mais detalhes, consulte Visão geral das famílias de instâncias. Ao atribuir endereços IP privados secundários, especifique apenas um dos parâmetros: PrivateIpAddress ou SecondaryPrivateIpAddressCount.

Valores de retorno

Fn::GetAtt

  • NetworkInterfaceId: o ID da ENI.

  • PrivateIpAddresses: os endereços IP privados secundários.

Exemplos

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  NetworkInterfaceId:
    Type: String
    Description: The ID of the ENI.
  SecondaryPrivateIpAddressCount:
    Type: Number
    Description: The specified number of private IP addresses to be assigned by the ECS instance.
    MinValue: 0
Resources:
  AssignPrivateIpAddresses:
    Type: ALIYUN::ECS::AssignPrivateIpAddresses
    Properties:
      NetworkInterfaceId:
        Ref: NetworkInterfaceId
      SecondaryPrivateIpAddressCount: 0
Outputs:
  NetworkInterfaceId:
    Description: The ID of the ENI.
    Value:
      Fn::GetAtt:
        - AssignPrivateIpAddresses
        - NetworkInterfaceId
  PrivateIpAddresses:
    Description: Assigned private ip addresses.
    Value:
      Fn::GetAtt:
        - AssignPrivateIpAddresses
        - PrivateIpAddresses
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "NetworkInterfaceId": {
      "Type": "String",
      "Description": "The ID of the ENI."
    },
    "SecondaryPrivateIpAddressCount": {
      "Type": "Number",
      "Description": "The specified number of private IP addresses to be assigned by the ECS instance.",
      "MinValue": 0
    }
  },
  "Resources": {
    "AssignPrivateIpAddresses": {
      "Type": "ALIYUN::ECS::AssignPrivateIpAddresses",
      "Properties": {
        "NetworkInterfaceId": {
          "Ref": "NetworkInterfaceId"
        },
        "SecondaryPrivateIpAddressCount": 0
      }
    }
  },
  "Outputs": {
    "NetworkInterfaceId": {
      "Description": "The ID of the ENI.",
      "Value": {
        "Fn::GetAtt": [
          "AssignPrivateIpAddresses",
          "NetworkInterfaceId"
        ]
      }
    },
    "PrivateIpAddresses": {
      "Description": "Assigned private ip addresses.",
      "Value": {
        "Fn::GetAtt": [
          "AssignPrivateIpAddresses",
          "PrivateIpAddresses"
        ]
      }
    }
  }
}