All Products
Search

This Product

    IPv6 Gateway:CreateIpv6Gateway

    Document Center

    IPv6 Gateway:CreateIpv6Gateway

    Last Updated:Jul 07, 2026

    Membuat gerbang IPv6. Gerbang IPv6 digunakan untuk mengontrol lalu lintas jaringan IPv6 untuk virtual private cloud (VPC).

    Deskripsi operasi

    • Sebelum membuat gerbang IPv6, pastikan bahwa VPC dan vSwitch target telah mengaktifkan blok CIDR IPv6. Anda dapat memanggil DescribeVpcAttribute untuk mengkueri konfigurasi VPC.

    • Hanya satu gerbang IPv6 yang dapat dibuat dalam sebuah VPC.

    • CreateIpv6Gateway adalah operasi asinkron. Setelah Anda mengirim permintaan, sistem mengembalikan ID instans tetapi gerbang IPv6 belum dibuat. Sistem terus menjalankan tugas startup di latar belakang. Anda dapat memanggil DescribeIpv6GatewayAttribute untuk mengkueri status pembuatan gerbang IPv6:

      • Jika gerbang IPv6 berada dalam status Creating, gerbang IPv6 sedang dibuat.

      • Jika gerbang IPv6 berada dalam status Created, gerbang IPv6 telah dibuat.

    • Operasi CreateIpv6Gateway tidak mendukung pembuatan gerbang IPv6 secara konkuren dalam VPC yang sama.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    vpc:CreateIpv6Gateway

    create

    *Ipv6Gateway

    acs:vpc:{#regionId}:{#accountId}:ipv6gateway/*

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID wilayah gerbang IPv6. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.

    cn-huhehaote
    VpcId

    string

    Yes

    ID VPC yang ingin Anda aktifkan IPv6-nya dan buat gerbang IPv6-nya.

    vpc-123sedrfswd23****
    Name

    string

    No

    Nama gerbang IPv6.

    Panjang nama harus 0 hingga 128 karakter dan tidak boleh dimulai dengan http:// atau https://.

    ipv6GW
    Description

    string

    No

    Deskripsi gerbang IPv6.

    Panjang deskripsi harus 0 hingga 256 karakter dan tidak boleh dimulai dengan http:// atau https://.

    ipv6gatewayforVPC1
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan.

    Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan bahwa token tersebut unik di antara berbagai permintaan. Nilai ClientToken hanya dapat berisi karakter ASCII.

    Catatan

    Jika Anda tidak menentukan parameter ini, sistem menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId mungkin berbeda untuk setiap permintaan API.

    0c593ea1-3bea-11e9-b96b-88e9fe637760
    ResourceGroupId

    string

    No

    ID kelompok sumber daya tempat gerbang IPv6 berada.

    Untuk informasi lebih lanjut tentang kelompok sumber daya, lihat Apa itu kelompok sumber daya?.

    rg-acfmxazb4ph6aiy****
    Tag

    array<object>

    No

    Tag Sumber daya.

    object

    No

    Tag.

    Key

    string

    No

    Kunci tag Sumber daya. Anda dapat menentukan hingga 20 kunci tag. Kunci tag tidak boleh berupa string kosong.

    Panjang kunci tag maksimal 128 karakter dan tidak boleh dimulai dengan aliyun atau acs:. Tidak boleh mengandung http:// atau https://.

    FinanceDept
    Value

    string

    No

    Nilai tag Sumber daya. Anda dapat menentukan hingga 20 nilai tag. Nilai tag dapat berupa string kosong.

    Panjang nilai tag maksimal 128 karakter dan tidak boleh dimulai dengan aliyun atau acs:. Tidak boleh mengandung http:// atau https://.

    FinanceJoshua
    RegionId

    string

    Yes

    ID wilayah gerbang IPv6. Anda dapat memanggil DescribeRegions untuk mengkueri ID wilayah.

    cn-huhehaote
    DryRun

    boolean

    No

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Parameter tanggapan.

    Ipv6GatewayId

    string

    ID gerbang IPv6.

    ipv6gw-hp3y0l3ln89j8cdvf****
    ResourceGroupId

    string

    ID kelompok sumber daya tempat gerbang IPv6 berada.

    rg-acfmxazb4ph6aiy****
    RequestId

    string

    ID permintaan.

    0ED8D006-F706-4D23-88ED-E11ED28DCAC

    Contoh

    Respons sukses

    JSONformat

    {
  "Ipv6GatewayId": "ipv6gw-hp3y0l3ln89j8cdvf****",
  "ResourceGroupId": "rg-acfmxazb4ph6aiy****",
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidVpcId.NotFound %s
    400 IllegalParam.Name %s
    400 IllegalParam.Description %s
    400 IllegalParam.Spec %s
    400 IllegalParam.ChargeType %s
    400 OperationUnsupported.OnlyOneIpv6GatewayInVpc %s
    400 OperationFailed.VpcIpv6Disabled %s
    400 IllegalParam.ResourceGroupId Invalid ResourceGroupld value. Kelompok sumber daya yang ditentukan tidak valid atau tidak ada.
    400 MissingParam.vpcId The parameter vpcId is mandatory.
    400 Forbidden.OperateShareResource You cannot operate shared resources. Operasi pada Resource yang dibagikan tidak diizinkan.
    404 InvalidVpcId.NotFound Specified VPC does not exist.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.