全部产品
Search
文档中心

Resource Orchestration Service:ALIYUN::NLB::LoadBalancer

更新时间:Jul 06, 2025

ALIYUN::NLB::LoadBalancer digunakan untuk membuat instance Network Load Balancer (NLB).

Sintaksis

{
  "Type": "ALIYUN::NLB::LoadBalancer",
  "Properties": {
    "LoadBalancerName": String,
    "AddressIpVersion": String,
    "ResourceGroupId": String,
    "VpcId": String,
    "LoadBalancerBillingConfig": Map,
    "TrafficAffinityEnabled": Boolean,
    "BandwidthPackageId": String,
    "AddressType": String,
    "ZoneMappings": List,
    "CrossZoneEnabled": Boolean,
    "LoadBalancerType": String,
    "DeletionProtectionConfig": Map,
    "ModificationProtectionConfig": Map,
    "Tags": List
  }
}

Properti

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Kendala

LoadBalancerName

String

Tidak

Ya

Nama instance NLB.

Tidak ada

AddressIpVersion

String

Tidak

Tidak

Versi IP dari instance NLB.

Nilai yang valid:

  • Ipv4

  • DualStack

ResourceGroupId

String

Tidak

Tidak

ID grup sumber daya.

Tidak ada

VpcId

String

Ya

Tidak

ID virtual private cloud (VPC) tempat instance NLB berada.

Tidak ada

LoadBalancerBillingConfig

Map

Tidak

Tidak

Konfigurasi penagihan instance NLB.

Untuk informasi lebih lanjut, lihat Properti LoadBalancerBillingConfig.

TrafficAffinityEnabled

Boolean

Tidak

Ya

Menentukan apakah akan mengaktifkan afinitas trafik.

Nilai yang valid:

  • true

  • false

BandwidthPackageId

String

Tidak

Ya

ID paket bandwidth EIP dari instance NLB yang menghadap ke Internet.

Tidak ada

AddressType

String

Ya

Ya

Tipe alamat IPv4 dari instance NLB.

Nilai yang valid:

  • Internet: Instance NLB menggunakan alamat IP publik. Nama domain instance NLB diarahkan ke alamat IP publik. Oleh karena itu, instance NLB dapat diakses melalui Internet.

  • Intranet: Instance NLB menggunakan alamat IP pribadi. Nama domain instance NLB diarahkan ke alamat IP pribadi. Oleh karena itu, instance NLB dapat diakses melalui VPC di mana instance NLB ditempatkan.

ZoneMappings

List

Ya

Tidak

Pemetaan antara zona dan vSwitches.

Untuk informasi lebih lanjut, lihat Properti ZoneMappings.

CrossZoneEnabled

Boolean

Tidak

Ya

Menentukan apakah akan mengaktifkan load balancing lintas zona.

Nilai yang valid:

  • true

  • false

LoadBalancerType

String

Tidak

Tidak

Tipe instance NLB.

Tidak ada

DeletionProtectionConfig

Map

Tidak

Ya

Konfigurasi perlindungan penghapusan.

Untuk informasi lebih lanjut, lihat Properti DeletionProtectionConfig.

ModificationProtectionConfig

Map

Tidak

Ya

Konfigurasi perlindungan penghapusan.

Untuk informasi lebih lanjut, lihat Properti ModificationProtectionConfig.

Tags

List

Tidak

Ya

Tag.

Untuk informasi lebih lanjut, lihat Properti Tags.

Sintaksis LoadBalancerBillingConfig

"LoadBalancerBillingConfig": {
  "PayType": String
}

Properti LoadBalancerBillingConfig

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Kendala

PayType

String

Tidak

Tidak

Metode penagihan instance NLB.

Nilai yang valid:

  • PayAsYouGo

  • PostPaid

  • PayOnDemand

  • Postpaid

  • PostPay

Sintaksis ZoneMappings

"ZoneMappings": [
  {
    "ZoneId": String,
    "VSwitchId": String,
    "AllocationId": String,
    "PrivateIPv4Address": String,
    "LoadBalancerAddresses": List
  }
]

Properti ZoneMappings

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Kendala

ZoneId

String

Ya

Tidak

ID zona dari instance NLB.

Anda dapat memanggil operasi DescribeZones untuk menanyakan zona dari instance NLB.

VSwitchId

String

Ya

Tidak

vSwitch dari zona.

Anda hanya dapat menggunakan satu vSwitch di setiap zona.

AllocationId

String

Tidak

Tidak

ID EIP.

Tidak ada

PrivateIPv4Address

String

Tidak

Tidak

Alamat IPv4.

Tidak ada

LoadBalancerAddresses

List

Tidak

Tidak

Titik akhir instance NLB.

Properti ini memiliki prioritas lebih tinggi daripada AllocationId dan EipType di bagian "ZoneMappings". Untuk informasi lebih lanjut, lihat Properti LoadBalancerAddresses.

EipType

String

Tidak

Tidak

Tipe EIP.

Nilai yang valid:

  • Common: EIP

  • Anycast: Anycast EIP

Catatan

Untuk informasi tentang wilayah di mana Anda dapat mengaitkan Anycast EIP dengan instance NLB, lihat Kaitkan Anycast EIP dengan instance ALB untuk mengaktifkan akses melalui titik akses terdekat.

Sintaksis LoadBalancerAddresses

"LoadBalancerAddresses": {
  "AllocationId": String,
  "PrivateIPv4Address": String
}

Properti LoadBalancerAddresses

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Kendala

AllocationId

String

Ya

Tidak

ID EIP.

Tidak ada

PrivateIPv4Address

String

Tidak

Tidak

Alamat IPv4.

Tidak ada

Sintaksis DeletionProtectionConfig

"DeletionProtectionConfig": {
  "Enabled": String,
  "Reason": String
}

Properti DeletionProtectionConfig

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Kendala

Enabled

String

Ya

Ya

Menentukan apakah perlindungan penghapusan diaktifkan.

Nilai yang valid:

  • true

  • false (default)

Reason

String

Tidak

Ya

Alasan mengapa perlindungan penghapusan diaktifkan atau dinonaktifkan.

Nilainya harus memiliki panjang 2 hingga 128 karakter, dan dapat berisi huruf, angka, titik (.), garis bawah (_), dan tanda hubung (-). Nilai tersebut harus dimulai dengan huruf.

Sintaksis ModificationProtectionConfig

"ModificationProtectionConfig": {
  "Reason": String,
  "Status": String
}

Properti ModificationProtectionConfig

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Kendala

Reason

String

Tidak

Ya

Alasan mengapa perlindungan penghapusan diaktifkan.

Nilainya harus memiliki panjang 2 hingga 128 karakter, dan dapat berisi huruf, angka, titik (.), garis bawah (_), dan tanda hubung (-). Nilai tersebut harus dimulai dengan huruf.

Catatan

Properti ini hanya berlaku jika Status disetel ke ConsoleProtection.

Status

String

Ya

Ya

Menentukan apakah perlindungan penghapusan diaktifkan.

Nilai yang valid:

  • NonProtection: Perlindungan penghapusan dinonaktifkan. Dalam hal ini, Anda tidak dapat memberikan alasan untuk mengaktifkan mode konfigurasi hanya-baca. Anda harus menghapus pengaturan properti Reason.

  • ConsoleProtection: Perlindungan penghapusan diaktifkan. Dalam hal ini, Anda dapat memberikan alasan untuk mengaktifkan mode konfigurasi hanya-baca.

Catatan

Jika Anda menyetel properti ini ke ConsoleProtection, Anda tidak dapat mengubah konfigurasi instance di konsol NLB. Namun, Anda dapat mengubah konfigurasi instance dengan memanggil operasi API.

Sintaksis Tags

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

Properti Tags

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Kendala

Key

String

Ya

Tidak

Kunci tag.

Kunci tag dapat memiliki panjang hingga 128 karakter dan tidak boleh mengandung http:// atau https://. Tidak boleh dimulai dengan acs: atau aliyun.

Anda dapat menambahkan hingga 20 tag dalam setiap pemanggilan.

Value

String

Tidak

Tidak

Nilai tag.

Nilai tag dapat memiliki panjang hingga 128 karakter dan tidak boleh dimulai dengan acs: atau aliyun. Tidak boleh mengandung http:// atau https://.

Anda dapat menambahkan hingga 20 tag dalam setiap pemanggilan.

Nilai Pengembalian

Fn::GetAtt

  • AddressIpVersion: Versi IP dari instance NLB.

  • VpcId: ID VPC tempat instance NLB ditempatkan.

  • LoadBalancerId: ID instance NLB.

  • AddressType: Jenis alamat IPv4 yang digunakan oleh instance NLB.

  • DNSName: Nama domain instance NLB.

  • ZoneMappings: Pemetaan antara zona dan vSwitches.

  • LoadBalancerType: Jenis instance NLB.

  • Arn: Nama Sumber Daya Alibaba Cloud (ARN).

Contoh

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  VpcId:
    Type: String
    Description: ID virtual private cloud (VPC) tempat instance NLB ditempatkan.
  AddressType:
    Type: String
    Description: |-
      Jenis alamat IP yang digunakan oleh instance NLB untuk menyediakan layanan. Nilai yang valid:
      Internet: Instance NLB menggunakan alamat IP publik. Nama domain instance NLB diarahkan ke alamat IP publik. Oleh karena itu, instance NLB dapat diakses melalui Internet.
      Intranet: Instance NLB menggunakan alamat IP pribadi. Nama domain instance NLB diarahkan ke alamat IP pribadi. Oleh karena itu, instance NLB dapat diakses melalui VPC tempat instance NLB ditempatkan.
    AllowedValues:
      - Internet
      - Intranet
  ZoneMappings:
    Type: Json
    Description: Zona dan vSwitches di zona tersebut. Anda harus menentukan setidaknya dua zona.
    MinLength: 2
    MaxLength: 3
Resources:
  LoadBalancer:
    Type: ALIYUN::NLB::LoadBalancer
    Properties:
      VpcId:
        Ref: VpcId
      AddressType:
        Ref: AddressType
      ZoneMappings:
        Ref: ZoneMappings
Outputs:
  AddressIpVersion:
    Description: Versi alamat IP yang digunakan oleh instance NLB untuk menyediakan layanan.
    Value:
      Fn::GetAtt:
        - LoadBalancer
        - AddressIpVersion
  VpcId:
    Description: ID virtual private cloud (VPC) tempat instance NLB ditempatkan.
    Value:
      Fn::GetAtt:
        - LoadBalancer
        - VpcId
  LoadBalancerId:
    Description: ID instance NLB.
    Value:
      Fn::GetAtt:
        - LoadBalancer
        - LoadBalancerId
  AddressType:
    Description: Jenis alamat IP yang digunakan oleh instance NLB untuk menyediakan layanan.
    Value:
      Fn::GetAtt:
        - LoadBalancer
        - AddressType
  DNSName:
    Description: Nama domain instance NLB.
    Value:
      Fn::GetAtt:
        - LoadBalancer
        - DNSName
  ZoneMappings:
    Description: Zona, vSwitches, dan alamat yang dipetakan ke zona.
    Value:
      Fn::GetAtt:
        - LoadBalancer
        - ZoneMappings
  LoadBalancerType:
    Description: Jenis instance NLB.
    Value:
      Fn::GetAtt:
        - LoadBalancer
        - LoadBalancerType
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "VpcId": {
      "Type": "String",
      "Description": "ID virtual private cloud (VPC) tempat instance NLB ditempatkan."
    },
    "AddressType": {
      "Type": "String",
      "Description": "Jenis alamat IP yang digunakan oleh instance NLB untuk menyediakan layanan. Nilai yang valid:\nInternet: Instance NLB menggunakan alamat IP publik. Nama domain instance NLB diarahkan ke alamat IP publik. Oleh karena itu, instance NLB dapat diakses melalui Internet.\nIntranet: Instance NLB menggunakan alamat IP pribadi. Nama domain instance NLB diarahkan ke alamat IP pribadi. Oleh karena itu, instance NLB dapat diakses melalui VPC tempat instance NLB ditempatkan.",
      "AllowedValues": [
        "Internet",
        "Intranet"
      ]
    },
    "ZoneMappings": {
      "Type": "Json",
      "Description": "Zona dan vSwitches di zona tersebut. Anda harus menentukan setidaknya dua zona.",
      "MinLength": 2,
      "MaxLength": 3
    }
  },
  "Resources": {
    "LoadBalancer": {
      "Type": "ALIYUN::NLB::LoadBalancer",
      "Properties": {
        "VpcId": {
          "Ref": "VpcId"
        },
        "AddressType": {
          "Ref": "AddressType"
        },
        "ZoneMappings": {
          "Ref": "ZoneMappings"
        }
      }
    }
  },
  "Outputs": {
    "AddressIpVersion": {
      "Description": "Versi alamat IP yang digunakan oleh instance NLB untuk menyediakan layanan.",
      "Value": {
        "Fn::GetAtt": [
          "LoadBalancer",
          "AddressIpVersion"
        ]
      }
    },
    "VpcId": {
      "Description": "ID virtual private cloud (VPC) tempat instance NLB ditempatkan.",
      "Value": {
        "Fn::GetAtt": [
          "LoadBalancer",
          "VpcId"
        ]
      }
    },
    "LoadBalancerId": {
      "Description": "ID instance NLB.",
      "Value": {
        "Fn::GetAtt": [
          "LoadBalancer",
          "LoadBalancerId"
        ]
      }
    },
    "AddressType": {
      "Description": "Jenis alamat IP yang digunakan oleh instance NLB untuk menyediakan layanan.",
      "Value": {
        "Fn::GetAtt": [
          "LoadBalancer",
          "AddressType"
        ]
      }
    },
    "DNSName": {
      "Description": "Nama domain instance NLB.",
      "Value": {
        "Fn::GetAtt": [
          "LoadBalancer",
          "DNSName"
        ]
      }
    },
    "ZoneMappings": {
      "Description": "Zona, vSwitches, dan alamat yang dipetakan ke zona.",
      "Value": {
        "Fn::GetAtt": [
          "LoadBalancer",
          "ZoneMappings"
        ]
      }
    },
    "LoadBalancerType": {
      "Description": "Jenis instance NLB.",
      "Value": {
        "Fn::GetAtt": [
          "LoadBalancer",
          "LoadBalancerType"
        ]
      }
    }
  }
}