All Products
Search
Document Center

Resource Orchestration Service:ALIYUN::ECS::AssignIpv6Addresses

Last Updated:Apr 17, 2025

ALIYUN::ECS::AssignIpv6Addresses is used to assign IPv6 addresses to an elastic network interface (ENI).

Syntax

{
  "Type": "ALIYUN::ECS::AssignIpv6Addresses",
  "Properties": {
    "Ipv6Addresses": List,
    "Ipv6AddressCount": Integer,
    "NetworkInterfaceId": String,
    "Ipv6PrefixCount": Integer,
    "Ipv6Prefixes": List
  }
}

Properties

Property

Type

Required

Editable

Description

Constraint

Ipv6Addresses

List

No

No

The IPv6 addresses to assign to the ENI.

Example: ["2001:db8:1234:1a00::***"]. You can specify only one IPv6 address. You cannot specify both Ipv6Addresses and Ipv6AddressCount.

Ipv6AddressCount

Integer

No

No

The number of randomly generated IPv6 addresses to assign to the ENI.

You cannot specify both Ipv6Addresses and Ipv6AddressCount.

Ipv6PrefixCount

Integer

No

No

The number of IPv6 prefixes to assign to the ENI.

Valid values: 1 to 10.

Ipv6Prefixes

List

No

No

The IPv6 prefixes to assign to the ENI.

Example:

["2001:db8:1234:1a00:****::/80"].

You can specify up to 10 IPv6 prefixes.

NetworkInterfaceId

String

Yes

No

The ID of the ENI.

None.

Return values

Fn::GetAtt

  • Ipv6Addresses: the IPv6 addresses.

  • Ipv6AddressIds: the IDs of the IPv6 addresses.

  • NetworkInterfaceId: the ID of the ENI.

Examples

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  NetworkInterfaceId:
    Type: String
    Description: Elastic network interface ID.
Resources:
  AssignIpv6Addresses:
    Type: ALIYUN::ECS::AssignIpv6Addresses
    Properties:
      NetworkInterfaceId:
        Ref: NetworkInterfaceId
      Ipv6AddressCount: 1
Outputs:
  Ipv6AddressIds:
    Description: Assigned IPv6 address IDs.
    Value:
      Fn::GetAtt:
        - AssignIpv6Addresses
        - Ipv6AddressIds
  Ipv6Addresses:
    Description: Assigned IPv6 addresses.
    Value:
      Fn::GetAtt:
        - AssignIpv6Addresses
        - Ipv6Addresses
  NetworkInterfaceId:
    Description: Elastic network interface ID.
    Value:
      Fn::GetAtt:
        - AssignIpv6Addresses
        - NetworkInterfaceId
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "NetworkInterfaceId": {
      "Type": "String",
      "Description": "Elastic network interface ID."
    }
  },
  "Resources": {
    "AssignIpv6Addresses": {
      "Type": "ALIYUN::ECS::AssignIpv6Addresses",
      "Properties": {
        "NetworkInterfaceId": {
          "Ref": "NetworkInterfaceId"
        },
        "Ipv6AddressCount": 1
      }
    }
  },
  "Outputs": {
    "Ipv6AddressIds": {
      "Description": "Assigned IPv6 address IDs.",
      "Value": {
        "Fn::GetAtt": [
          "AssignIpv6Addresses",
          "Ipv6AddressIds"
        ]
      }
    },
    "Ipv6Addresses": {
      "Description": "Assigned IPv6 addresses.",
      "Value": {
        "Fn::GetAtt": [
          "AssignIpv6Addresses",
          "Ipv6Addresses"
        ]
      }
    },
    "NetworkInterfaceId": {
      "Description": "Elastic network interface ID.",
      "Value": {
        "Fn::GetAtt": [
          "AssignIpv6Addresses",
          "NetworkInterfaceId"
        ]
      }
    }
  }
}