All Products
Search

This Product

    IPv6 Gateway:CreateIpv6EgressOnlyRule

    Document Center

    IPv6 Gateway:CreateIpv6EgressOnlyRule

    Last Updated:Jun 12, 2026

    Anda dapat membuat aturan egress-only sehingga instans ECS pada VPC yang telah diaktifkan dengan blok CIDR IPv6 dapat secara aktif mengakses titik akhir IPv6 klien, tetapi titik akhir IPv6 klien tidak diizinkan mengakses instans ECS pada jaringan VPC melalui internet. Panggil CreateIpv6EgressOnlyRule untuk menambahkan aturan egress-only ke alamat IPv6.

    Deskripsi operasi

    • Antarmuka CreateIpv6EgressOnlyRule adalah antarmuka asinkron. Artinya, sistem mengembalikan ID instans, tetapi aturan egress-only untuk alamat IPv6 tersebut belum berhasil dibuat dan tugas pembuatan masih berlangsung di latar belakang sistem. Anda dapat memanggil DescribeIpv6EgressOnlyRules untuk mengkueri status pembuatan aturan egress-only untuk alamat IPv6:

      • Ketika aturan egress-only alamat IPv6 berada dalam status Creating, ini menunjukkan bahwa aturan egress-only IPv6 sedang dibuat.

      • Ketika aturan egress-only alamat IPv6 berada dalam status Created, ini menunjukkan bahwa aturan egress-only IPv6 telah berhasil dibuat.

    • Antarmuka 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 region gateway IPv6.

    Anda dapat memperoleh ID region dengan memanggil antarmuka DescribeRegions.

    cn-huhehaote
    Ipv6GatewayId

    string

    Yes

    ID instans gateway IPv6.

    ipv6gw-hp3c2paq0ywauasza****
    InstanceId

    string

    Yes

    ID alamat IPv6 yang akan dikonfigurasi dengan aturan egress-only.

    ipv6-hp3nxjkfxn5pnhgl5****
    InstanceType

    string

    No

    Jenis instans yang akan dikonfigurasi dengan aturan egress-only.

    Nilai yang valid: Ipv6Address (nilai default), yang menunjukkan jenis alamat IPv6.

    Ipv6Address
    Name

    string

    No

    Nama aturan egress-only.

    Panjangnya 0 sampai 128 karakter dan tidak boleh diawali dengan http:// atau https://.

    rulename
    Description

    string

    No

    Deskripsi aturan egress-only.

    Panjangnya 0 sampai 256 karakter dan tidak boleh diawali dengan http:// atau https://.

    ruledescription
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan.

    Nilai parameter ini dihasilkan oleh klien, harus unik di antara permintaan yang berbeda, dan tidak boleh melebihi 64 karakter ASCII.

    Catatan

    Jika Anda tidak menentukannya, sistem secara otomatis menggunakan RequestId dari permintaan API sebagai pengenal ClientToken. RequestId untuk setiap permintaan API berbeda.

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

    string

    Yes

    ID region gateway IPv6.

    Anda dapat memperoleh ID region dengan memanggil antarmuka DescribeRegions.

    cn-huhehaote
    DryRun

    boolean

    No

    Pra-pemeriksaan parameter tanpa benar-benar menjalankan

    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.