All Products
Search

This Product

    Virtual Private Cloud:CreateIpv6EgressOnlyRule

    Document Center

    Virtual Private Cloud:CreateIpv6EgressOnlyRule

    Last Updated:Jun 12, 2026

    Membuat aturan egress-only IPv6 untuk alamat IPv6. Anda dapat membuat aturan egress-only untuk mengizinkan instans ECS di VPC yang memiliki blok CIDR IPv6 mengakses endpoint IPv6 di sisi klien secara proaktif, sambil mencegah endpoint IPv6 mengakses instans ECS di VPC melalui Internet.

    Deskripsi operasi

    • CreateIpv6EgressOnlyRule adalah operasi asinkron. Setelah Anda memanggil operasi ini, sistem mengembalikan ID instans, tetapi aturan egress-only IPv6 belum dibuat. Tugas pembuatan masih berjalan di latar belakang. Anda dapat memanggil DescribeIpv6EgressOnlyRules untuk mengkueri status pembuatan aturan egress-only IPv6:

      • Jika aturan egress-only IPv6 berada dalam status Creating, aturan sedang dibuat.

      • Jika aturan egress-only IPv6 berada dalam status Created, aturan telah dibuat.

    • CreateIpv6EgressOnlyRule tidak mendukung penambahan aturan egress-only secara bersamaan untuk alamat IPv6 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

    Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID wilayah gerbang IPv6.

    Anda dapat memanggil operasi DescribeRegions untuk mendapatkan ID wilayah.

    cn-huhehaote
    Ipv6GatewayId

    string

    Yes

    ID instans gerbang IPv6.

    ipv6gw-hp3c2paq0ywauasza****
    InstanceId

    string

    Yes

    ID alamat IPv6 yang akan dibuatkan aturan egress-only.

    ipv6-hp3nxjkfxn5pnhgl5****
    InstanceType

    string

    No

    Tipe instans yang akan dibuatkan aturan egress-only.

    Tetapkan nilai ke Ipv6Address (default), yang menentukan tipe alamat IPv6.

    Ipv6Address
    Name

    string

    No

    Nama aturan egress-only.

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

    rulename
    Description

    string

    No

    Deskripsi aturan egress-only.

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

    ruledescription
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan.

    Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan token tersebut unik di antara permintaan yang berbeda. Token hanya dapat berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter.

    Catatan

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

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

    string

    Yes

    IPv6 网关的地域 ID。

    您可以通过调用 DescribeRegions 接口获取地域 ID。

    cn-huhehaote
    DryRun

    boolean

    No

    Apakah akan menjalankan dry run tanpa benar-benar mengeksekusi operasi.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Ipv6EgressRuleId

    string

    ID aturan egress-only.

    ipv6py-hp3w98rmlbqp01245****
    RequestId

    string

    ID permintaan.

    9DFEDBEE-E5AB-49E8-A2DC-CC114C67AF75

    Contoh

    Respons sukses

    JSONformat

    {
  "Ipv6EgressRuleId": "ipv6py-hp3w98rmlbqp01245****",
  "RequestId": "9DFEDBEE-E5AB-49E8-A2DC-CC114C67AF75"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidIpv6Gateway.NotFound The specified IPv6 gateway was not found.
    400 IllegalParam.Name The param of Name [%s] is illegal.
    400 IllegalParam.Description The parameter of Description is illegal.
    400 IllegalParam.InstanceType The parameter of InstanceType is illegal.
    400 OperationFailed.FinancialLocked The operation is forbidden because of financialLocked.
    400 OperationUnsupported.EgressRuleVSwitch The specified VSwitch is not supported to create egress-only rule.
    400 InvalidIpv6Instance.NotFound The specified resource of InvalidIpv6Instance is not found.
    400 OperationFailed.NoInternetBandwidth Operation failed because the ipv6 instance has no internet bandwidth.
    400 OperationFailed.Ipv6EgressRuleExisted An egress-only rule already exists for the IPv6 address.
    400 OperationFailed.InternetBandwidthUnstable The operation is forbidden because of InternetBandwidthUnstable.
    400 IncorrectStatus.Ipv6InternetBandwidth The status of the IPv6InternetBandwidth is incorrect.
    400 OperationUnsupported.EgressRuleInDefaultSpec Egress-only rule is not supported. Please update the spec of IPv6 Gateway to Medium or Large.
    400 QuotaExceeded.Ipv6EgressRules %s quota exceeded.
    400 Mismatch.Ipv6AddressAndIpv6Gateway The %s and %s are mismatched.
    400 OperationUnsupported.EgressOnlyRuleOnFreeIpv6Instance Creating ipv6 egress only rule on ipv6 instance that not associated with any resource is unsupported.
    400 MissingParam.InstanceId The parameter InstanceId is mandatory.
    400 InvalidRegionId.NotFound The specified RegionId does not exist in our records.
    400 OperationUnsupported.ULA %s is unsupported.
    400 OperationUnsupported.PrivateGUA This operation does not support private GUA addresses.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.