All Products
Search

This Product

    Virtual Private Cloud:CreateTrafficMirrorFilterRules

    Document Center

    Virtual Private Cloud:CreateTrafficMirrorFilterRules

    Last Updated:Jun 12, 2026

    Panggil operasi CreateTrafficMirrorFilterRules untuk membuat aturan masuk atau keluar bagi traffic mirroring.

    Deskripsi operasi

    • CreateTrafficMirrorFilterRules adalah operasi asinkron. Setelah Anda mengirim permintaan, sistem mengembalikan ID instans, tetapi aturan masuk atau keluar untuk traffic mirroring belum dibuat pada saat itu. Sistem membuat aturan tersebut di latar belakang. Anda dapat memanggil operasi ListTrafficMirrorFilters untuk mengkueri status aturan masuk atau keluar untuk traffic mirroring:

      • Jika aturan masuk atau keluar berada dalam status Creating, aturan tersebut sedang dibuat.

      • Jika aturan masuk atau keluar berada dalam status Created, aturan tersebut telah dibuat.

    • Anda tidak dapat berulang kali memanggil operasi CreateTrafficMirrorFilterRules untuk membuat aturan masuk atau keluar bagi traffic mirroring dalam traffic mirror filter 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:CreateTrafficMirrorFilterRules

    create

    *TrafficMirrorFilter

    acs:vpc:{#regionId}:{#accountId}:trafficmirrorfilter/{#TrafficMirrorFilterId}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    TrafficMirrorFilterId

    string

    Yes

    ID dari traffic mirror filter.

    tmf-j6cmls82xnc86vtpe****
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan.

    Anda dapat menggunakan klien untuk menghasilkan nilainya, tetapi Anda harus memastikan nilainya unik di antara permintaan yang berbeda. Nilai ClientToken hanya boleh berisi karakter ASCII.

    Catatan

    Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan request ID sebagai client token. request ID mungkin berbeda untuk setiap permintaan API.

    123e4567-e89b-12d3-a456-426655440000
    DryRun

    boolean

    No

    Menentukan apakah akan melakukan dry run. Nilai yang valid:

    • true: melakukan dry run. Sistem memeriksa parameter yang diperlukan, format permintaan, dan batasan. Jika permintaan gagal dry run, pesan kesalahan akan dikembalikan. Jika permintaan lolos dry run, kode kesalahan DryRunOperation akan dikembalikan.

    • false (default): melakukan dry run dan mengirimkan permintaan sebenarnya. Jika permintaan lolos dry run, aturan masuk atau keluar akan dibuat.

    false
    IngressRules

    array<object>

    No

    Informasi tentang aturan masuk.

    object

    No

    Informasi tentang aturan masuk.

    Action

    string

    No

    Kebijakan pengumpulan dari aturan masuk. Nilai yang valid:

    • accept: mengumpulkan lalu lintas jaringan.

    • drop: tidak mengumpulkan lalu lintas jaringan.

    accept
    SourceCidrBlock

    string

    No

    Blok CIDR sumber dari lalu lintas masuk.

    10.0.0.0/24
    Protocol

    string

    No

    Protokol yang digunakan oleh lalu lintas masuk yang akan dicerminkan. Nilai yang valid:

    • ALL: semua protokol.

    • ICMP: Internet Control Message Protocol.

    • TCP: Transmission Control Protocol.

    • UDP: User Datagram Protocol.

    TCP
    IpVersion

    string

    Yes

    Versi IP dari instans. Nilai yang valid:

    • IPv4: IPv4.

    • IPv6: IPv6.

    IPv4
    DestinationPortRange

    string

    No

    Rentang port tujuan dari lalu lintas masuk. Nilai yang valid untuk sebuah port: 1 hingga 65535. Tentukan rentang port dalam format /. Contoh: 1/200 dan 80/80.

    Catatan

    Jika IngressRules.N.Protocol diatur ke ALL atau ICMP, Anda tidak perlu menentukan parameter ini. Dalam hal ini, semua port tersedia.

    80/120
    Priority

    integer

    No

    Prioritas dari aturan masuk. Nilai yang lebih kecil menunjukkan prioritas yang lebih tinggi. Nilai maksimum N adalah 10, yang berarti Anda dapat mengonfigurasi hingga 10 aturan masuk untuk satu filter.

    1
    DestinationCidrBlock

    string

    No

    Blok CIDR tujuan dari lalu lintas masuk.

    10.0.0.0/24
    SourcePortRange

    string

    No

    Rentang port sumber dari lalu lintas masuk. Nilai yang valid untuk sebuah port: 1 hingga 65535. Tentukan rentang port dalam format /. Contoh: 1/200 dan 80/80. Nilai -1/-1 tidak dapat diatur secara terpisah. Nilai ini menentukan bahwa semua port tersedia.

    Catatan

    Jika IngressRules.N.Protocol diatur ke ALL atau ICMP, Anda tidak perlu menentukan parameter ini. Dalam hal ini, semua port tersedia.

    80/120
    EgressRules

    array<object>

    No

    Informasi tentang aturan keluar.

    object

    No

    Informasi tentang aturan keluar.

    Action

    string

    Yes

    Kebijakan pengumpulan dari aturan keluar. Nilai yang valid:

    • accept: mengumpulkan lalu lintas jaringan.

    • drop: tidak mengumpulkan lalu lintas jaringan.

    accept
    SourceCidrBlock

    string

    No

    Blok CIDR sumber dari lalu lintas keluar.

    10.0.0.0/24
    Protocol

    string

    Yes

    Protokol yang digunakan oleh lalu lintas keluar yang akan dicerminkan. Nilai yang valid:

    • ALL: semua protokol.

    • ICMP: Internet Control Message Protocol.

    • TCP: Transmission Control Protocol.

    • UDP: User Datagram Protocol.

    TCP
    IpVersion

    string

    Yes

    Versi IP dari instans. Nilai yang valid:

    • IPv4: IPv4.

    • IPv6: IPv6.

    IPv4
    DestinationPortRange

    string

    No

    Rentang port tujuan dari lalu lintas keluar. Nilai yang valid untuk sebuah port: 1 hingga 65535. Tentukan rentang port dalam format /. Contoh: 1/200 dan 80/80. Nilai -1/-1 tidak dapat diatur secara terpisah. Nilai ini menentukan bahwa semua port tersedia.

    Catatan

    Jika EgressRules.N.Protocol diatur ke ALL atau ICMP, Anda tidak perlu menentukan parameter ini. Dalam hal ini, semua port tersedia.

    22/40
    Priority

    integer

    No

    Prioritas dari aturan keluar. Nilai yang lebih kecil menunjukkan prioritas yang lebih tinggi. Nilai maksimum N adalah 10, yang berarti Anda dapat mengonfigurasi hingga 10 aturan keluar untuk satu filter.

    1
    DestinationCidrBlock

    string

    No

    Blok CIDR tujuan dari lalu lintas keluar.

    10.0.0.0/24
    SourcePortRange

    string

    No

    Rentang port sumber dari lalu lintas keluar. Nilai yang valid untuk sebuah port: 1 hingga 65535. Tentukan rentang port dalam format /. Contoh: 1/200 dan 80/80. Nilai -1/-1 tidak dapat diatur secara terpisah. Nilai ini menentukan bahwa semua port tersedia.

    Catatan

    Jika EgressRules.N.Protocol diatur ke ALL atau ICMP, Anda tidak perlu menentukan parameter ini. Dalam hal ini, semua port tersedia.

    22/40
    RegionId

    string

    Yes

    ID region dari traffic mirror.

    Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar region terbaru. Untuk informasi tentang region yang mendukung traffic mirroring, lihat Ikhtisar traffic mirroring.

    cn-hongkong

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Informasi.

    RequestId

    string

    ID permintaan.

    07F272E2-6AD5-433A-8207-A607C76F1676
    IngressRules

    array<object>

    Daftar aturan masuk.

    object

    Daftar aturan masuk.

    InstanceId

    string

    ID dari aturan masuk.

    tmr-j6c6rtallo51ouzv3****
    EgressRules

    array<object>

    Daftar aturan keluar.

    object

    Daftar aturan keluar.

    InstanceId

    string

    ID dari aturan keluar.

    tmr-j6cok23ugp53eeib5****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "07F272E2-6AD5-433A-8207-A607C76F1676",
  "IngressRules": [
    {
      "InstanceId": "tmr-j6c6rtallo51ouzv3****"
    }
  ],
  "EgressRules": [
    {
      "InstanceId": "tmr-j6cok23ugp53eeib5****"
    }
  ]
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 ResourceNotFound.TrafficMirrorFilter The specified resource of traffic mirror filter is not found. The specified filter does not exist.
    400 IncorrectStatus.TrafficMirrorFilter The status of traffic mirror filter is incorrect. The filter is in an invalid state.
    400 IncorrectStatus.TrafficMirrorSession The status of traffic mirror session is incorrect.
    400 QuotaExceeded.TrafficMirrorRulesPerFilter The quota of the number of traffic mirror rules per filter is exceeded. The number of rules associated with the filter has reached the upper limit.
    400 DuplicatedParam.Priority The specified priority conflicts with the existing priority. The specified priority is the same as an existing one.
    400 UnsupportedRegion The feature is not supported in current region. The feature is not supported in the current region.
    400 IllegalParam.CidrBlock The specified CidrBlock is illegal. The operation failed because CidrBlock is set to an invalid value.
    400 IllegalParam.SourceCidrBlock The param of SourceCidrBlock %s is illegal.
    400 IllegalParam.DestinationCidrBlock The param of DestinationCidrBlock %s is illegal.
    400 IllegalParam.Protocol The specified Protocol %s is invalid.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.