Gunakan ALIYUN::ECS::NetworkInterface dalam pemanggilan untuk membuat ENI - Resource Orchestration Service

ALIYUN::ECS::NetworkInterface digunakan untuk membuat antarmuka jaringan elastis (ENI).

Sintaksis

{
  "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
  }
}

Properti

Properti	Tipe	Diperlukan	Dapat Diedit	Deskripsi	Batasan
ResourceGroupId	String	Tidak	Ya	ID grup sumber daya.	Anda dapat memanggil operasi ListResourceGroups untuk menanyakan ID grup sumber daya.
SecurityGroupId	String	Tidak	Ya	ID grup keamanan.	Grup keamanan dan ENI harus termasuk dalam virtual private cloud (VPC) yang sama. Catatan Anda tidak dapat menentukan SecurityGroupId dan SecurityGroupIds secara bersamaan.
VSwitchId	String	Ya	Tidak	ID vSwitch.	Tidak ada.
Description	String	Tidak	Ya	Deskripsi ENI.	Deskripsi harus memiliki panjang 2 hingga 256 karakter, dan tidak boleh dimulai dengan `http://` atau `https://`.
NetworkInterfaceName	String	Tidak	Ya	Nama ENI.	Nama harus memiliki panjang 2 hingga 128 karakter. Nama harus dimulai dengan huruf dan tidak boleh dimulai dengan `http://` atau `https://`. Nama dapat berisi huruf, angka, titik dua (:), garis bawah (_), dan tanda hubung (-).
PrimaryIpAddress	String	Tidak	Tidak	Alamat IP pribadi utama dari ENI.	Alamat IP pribadi utama harus berupa alamat IP yang tidak terpakai di dalam blok CIDR dari vSwitch yang ingin Anda asosiasikan dengan ENI. Jika Anda mengosongkan properti ini, alamat IP yang tidak terpakai akan ditetapkan secara acak dari blok CIDR vSwitch.
SecondaryPrivateIpAddressCount	Integer	Tidak	Tidak	Jumlah alamat IP pribadi sekunder.	Tidak ada.
Tags	List	Tidak	Ya	Tag.	Anda dapat menambahkan hingga 20 tag. Untuk informasi lebih lanjut, lihat Properti Tags.
SecurityGroupIds	List	Tidak	Ya	ID satu atau beberapa grup keamanan.	Grup keamanan dan ENI harus termasuk dalam VPC yang sama. Catatan Anda tidak dapat menentukan SecurityGroupId dan SecurityGroupIds secara bersamaan.
PrivateIpAddresses	List	Tidak	Tidak	Satu atau beberapa alamat IP pribadi sekunder yang akan ditetapkan pada ENI dari blok CIDR vSwitch yang ingin Anda asosiasikan dengan ENI.	Nilai valid jumlah alamat IP pribadi sekunder yang dapat ditetapkan pada ENI: Jika ENI dalam status Tersedia, nilai valid adalah 1 hingga 10. Jika ENI dalam status Digunakan, nilai valid bergantung pada jenis instans. Untuk informasi lebih lanjut, lihat Ikhtisar keluarga instans.
Ipv6Addresses	List	Tidak	Tidak	Satu atau beberapa alamat IPv6 yang akan ditetapkan pada ENI.	Anda dapat menentukan hingga 10 alamat IPv6. Catatan Jika Anda ingin menetapkan alamat IPv6 pada ENI, Anda harus menentukan properti `Ipv6Addresses` atau `Ipv6AddressCount`, tetapi tidak keduanya.
QueueNumber	Integer	Tidak	Tidak	Jumlah antrian yang didukung oleh ENI.	Nilai valid: 1 hingga 2048. Ketika Anda melampirkan ENI ke instans, pastikan bahwa nilai properti ini kurang dari jumlah maksimum antrian per ENI yang diizinkan untuk jenis instans. Untuk menanyakan jumlah maksimum antrian per ENI untuk jenis instans, panggil operasi DescribeInstanceTypes dan periksa nilai pengembalian dari `MaximumQueueNumberPerEni`. Properti QueueNumber dikosongkan secara default. Jika Anda mengosongkan properti ini ketika melampirkan ENI ke instans, jumlah antrian default per ENI yang diizinkan untuk jenis instans digunakan. Untuk menanyakan jumlah antrian default per ENI untuk jenis instans, panggil operasi DescribeInstanceTypes dan periksa nilai pengembalian dari `SecondaryEniQueueNumber`.
NetworkInterfaceTrafficMode	String	Tidak	Tidak	Mode komunikasi ENI.	Nilai valid: Standard: menggunakan mode komunikasi TCP. HighPerformance: menggunakan mode komunikasi remote direct memory access (RDMA) dengan fitur Elastic RDMA Interface (ERI) diaktifkan. Catatan Nilai HighPerformance hanya mendukung keluarga instans c7re yang ditingkatkan dengan RDMA. Jumlah maksimum ENI dalam mode RDMA yang dapat dilampirkan ke instans c7re ditentukan berdasarkan jenis instans. Keluarga instans c7re sedang dalam pratinjau undangan di Zona K Beijing. Untuk informasi lebih lanjut, lihat Ikhtisar keluarga instans.
Ipv6AddressCount	Integer	Tidak	Tidak	Jumlah alamat IPv6 yang akan dibuat secara acak untuk ENI.	Nilai valid: 1 hingga 10. Catatan Jika Anda ingin menetapkan alamat IPv6 pada ENI, Anda harus menentukan properti `Ipv6Addresses` atau `Ipv6AddressCount`, tetapi tidak keduanya.
Ipv6Prefixes	List	Tidak	Tidak	Awalan IPv6.	Tidak ada.
Ipv4Prefixes	List	Tidak	Tidak	Awalan IPv4.	Tidak ada.
Ipv4PrefixCount	Integer	Tidak	Tidak	Jumlah awalan IPv4 yang akan ditetapkan pada ENI.	Nilai valid: 1 hingga 10. Catatan Jika Anda ingin menetapkan awalan IPv4 pada ENI, Anda harus menentukan properti Ipv4Prefixes atau Ipv4PrefixCount, tetapi tidak keduanya.
TxQueueSize	Integer	Tidak	Ya	Kedalaman antrian transmisi (Tx) dari ENI.	Catatan hal-hal berikut: Kedalaman antrian Tx ENI harus sama dengan kedalaman antrian penerimaan (Rx) ENI. Nilai valid: pangkat dua dalam rentang 8192 hingga 16384. Kedalaman antrian Tx yang lebih besar menghasilkan throughput arah keluar yang lebih tinggi tetapi mengonsumsi lebih banyak memori.
DeleteOnRelease	Boolean	Tidak	Ya	Menentukan apakah akan mempertahankan ENI ketika instans terkait dilepaskan.	Nilai valid: true false
Ipv6PrefixCount	Integer	Tidak	Tidak	Jumlah awalan IPv6 yang akan ditetapkan pada ENI.	Nilai valid: 1 hingga 10. Catatan Jika Anda ingin menetapkan awalan IPv6 pada ENI, Anda harus menentukan properti Ipv6Prefixes atau Ipv6PrefixCount, tetapi tidak keduanya.
RxQueueSize	Integer	Tidak	Ya	Kedalaman antrian Rx dari ENI.	Catatan hal-hal berikut: Kedalaman antrian Rx ENI harus sama dengan kedalaman antrian Tx ENI. Nilai valid: pangkat dua dalam rentang 8192 hingga 16384. Kedalaman antrian Rx yang lebih besar menghasilkan throughput arah masuk yang lebih tinggi tetapi mengonsumsi lebih banyak memori.

Sintaksis Tags

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

Properti Tags

Properti	Tipe	Diperlukan	Dapat Diedit	Deskripsi	Batasan
Key	String	Ya	Tidak	Kunci tag.	Kunci tag harus memiliki panjang 1 hingga 128 karakter, dan tidak boleh berisi `http://` atau `https://`. Tidak boleh dimulai dengan `aliyun` atau `acs:`.
Value	String	Tidak	Tidak	Nilai tag.	Nilai tag dapat memiliki panjang hingga 128 karakter, dan tidak boleh berisi `http://` atau `https://`. Tidak boleh dimulai dengan `aliyun` atau `acs:`.

Nilai Pengembalian

Fn::GetAtt

NetworkInterfaceId: ID ENI.
MacAddress: Alamat media access control (MAC) dari ENI.
PrivateIpAddress: Alamat IP pribadi dari ENI.
SecondaryPrivateIpAddresses: Alamat IP pribadi sekunder dari ENI.
Arn: Nama Sumber Daya Alibaba Cloud (ARN).

Contoh

Format `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: Alamat IP pribadi utama dari Network Interface Anda.
    Value:
      Fn::GetAtt:
        - EniInstance
        - PrivateIpAddress
  SecondaryPrivateIpAddresses:
    Description: Alamat IP pribadi sekunder dari Network Interface Anda.
    Value:
      Fn::GetAtt:
        - EniInstance
        - SecondaryPrivateIpAddresses
  MacAddress:
    Description: Alamat MAC dari Network Interface Anda.
    Value:
      Fn::GetAtt:
        - EniInstance
        - MacAddress
  NetworkInterfaceId:
    Description: ID dari Network Interface Anda.
    Value:
      Fn::GetAtt:
        - EniInstance
        - NetworkInterfaceId

Format `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": "Alamat IP pribadi utama dari Network Interface Anda.",
      "Value": {
        "Fn::GetAtt": [
          "EniInstance",
          "PrivateIpAddress"
        ]
      }
    },
    "SecondaryPrivateIpAddresses": {
      "Description": "Alamat IP pribadi sekunder dari Network Interface Anda.",
      "Value": {
        "Fn::GetAtt": [
          "EniInstance",
          "SecondaryPrivateIpAddresses"
        ]
      }
    },
    "MacAddress": {
      "Description": "Alamat MAC dari Network Interface Anda.",
      "Value": {
        "Fn::GetAtt": [
          "EniInstance",
          "MacAddress"
        ]
      }
    },
    "NetworkInterfaceId": {
      "Description": "ID dari Network Interface Anda.",
      "Value": {
        "Fn::GetAtt": [
          "EniInstance",
          "NetworkInterfaceId"
        ]
      }
    }
  }
}

Sintaksis

Properti

Sintaksis Tags

Properti Tags

Nilai Pengembalian

Contoh

Format YAML

Format JSON

Format `YAML`

Format `JSON`