All Products
Search
Document Center

CDN:SetCdnDomainStagingConfig

Last Updated:Jun 10, 2026

Mengonfigurasi nama domain yang dipercepat di lingkungan staging.

Deskripsi operasi

Catatan

A single user can make up to 30 calls per second.

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

cdn:SetCdnDomainStagingConfig

update

*Domain

acs:cdn:*:{#accountId}:domain/{#DomainName}

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

DomainName

string

Yes

Nama domain yang dipercepat. Hanya satu Nama domain yang dapat dikonfigurasi dalam satu pengatur waktu.

example.com

Functions

string

Yes

Daftar fitur. Formatnya adalah sebagai berikut:

Catatan
  • functionName (nama fitur): Untuk informasi tentang fitur yang dapat Anda konfigurasi, lihat Daftar fitur. Pisahkan beberapa parameter dengan koma (,).

  • argName: item konfigurasi untuk functionName. Anda dapat menentukan beberapa item konfigurasi.

  • argValue: nilai item konfigurasi untuk functionName.

[
  {
    "functionArgs": [
      {
        "argName": "Parameter fitur A",
        "argValue": "Nilai parameter fitur A"
      },
      {
        "argName": "Parameter fitur B",
        "argValue": "Nilai parameter fitur B"
      }
    ],
    "functionName": "Nama fitur"
  }
]
```.

[{"functionArgs":[{"argName":"enable","argValue":"on"},{"argName":"pri","argValue":"1"},{"argName":"rule","argValue":"xxx"}],"functionName":"edge_function"}]

Deskripsi fitur edge_function

Semua nilai parameter diproses sebagai string.

Nama fiturParameter
edge_function: edge functionParameter wajib:
rule: aturan DSL.
pri: prioritas.
enable: apakah akan mengaktifkan aturan. Nilai valid: on dan off.
Parameter opsional:
name: nama aturan. Hanya huruf dan garis bawah (_) yang didukung.
pos: posisi tempat aturan dijalankan.
brk: Jika aturan ini terpicu, aturan yang tersisa di posisi eksekusi saat ini akan dilewati.
option: kontrol opsi.
grammar: kontrol grammar. Nilai valid: empty, es2, dan js.
jsmode: kontrol daftar putih Nama domain JavaScript. Nilai valid: redirect dan bypass.

Elemen respons

Element

Type

Description

Example

object

RequestId

string

The request ID.

04F0F334-1335-436C-A1D7-6C044FE73368

DomainConfigList

array<object>

The list of domain name configurations.

object

ConfigId

integer

The configuration ID.

1234567

DomainName

string

The domain name.

www.example.com

FunctionName

string

The feature name.

set_resp_header

Contoh

Respons sukses

JSONformat

{
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
  "DomainConfigList": [
    {
      "ConfigId": 1234567,
      "DomainName": "www.example.com",
      "FunctionName": "set_resp_header"
    }
  ]
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 InvalidFunctionName.ValueNotSupported %s
400 InvalidArgValue.Malformed %s
400 ConfigurationConflicts The staging environment has a configuration in effect and cannot modify the production environment configuration. Failed to modify the parameter settings in the production environment because the parameter settings are different from those in the stating environment. Set parameters in the staging environment before you publish them to the production environment.
400 InvalidArgName.ValueNotSupported %s
400 GrayConfigExist The domain exists other gray config. The staging environment already contains settings for the domain name.
400 InvalidRule.Malformed %s
400 InvalidDomain.BelongToConfigGroup This Domain activated in configuration group and should modify by config group.
400 EdgeScriptCountExceedLimit The number of rules exceeds the default limit. The number of rules exceeds the limit. To increase the limit, submit a ticket.
400 EdgeScripOptionsHasInnerConfig The extension has a background configuration or a parameter of this configuration is invalid. For more information, submit a ticket. The extension has a background configuration or a configured parameter is invalid. For more information, submit a ticket.
400 EdgeScriptGrammarNotSupport A background customization rule exists or a parameter of this configuration is invalid. For more information, submit a ticket. A background custom rule exists or a configured parameter is invalid. For more information, submit a ticket.
400 EdgeScriptNotSupportJs JavaScript rules are not supported. For more information, submit a ticket. JavaScript rules are not supported. For more information, submit a ticket.
400 MissingRequiredArg required argument missing. When configuring the function, the necessary parameters are missing.
400 FunctionArgError The function parameter of the domain configuration is incorrect.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.