全部产品
Search
文档中心

CDN:SetCdnDomainStagingConfig

更新时间:Dec 14, 2025

Anda dapat memanggil operasi SetCdnDomainStagingConfig untuk mengonfigurasi nama domain yang dipercepat di lingkungan staging.

Deskripsi operasi

Catatan

Satu pengguna dapat melakukan hingga 30 panggilan per detik.

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 waktu.

example.com

Functions

string

Yes

Daftar fitur. Formatnya sebagai berikut:

Catatan
  • functionName (nama fitur): Untuk informasi tentang fitur yang dapat dikonfigurasi, lihat Feature list. Pisahkan beberapa parameter dengan koma (,).

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

  • argValue: nilai dari 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: menentukan apakah aturan diaktifkan. Nilai valid: on dan off.
Parameter opsional:
name: nama aturan. Hanya huruf dan garis bawah (_) yang didukung.
pos: posisi eksekusi aturan.
brk: Jika aturan ini terkena (hit), aturan lain pada posisi eksekusi saat ini akan dilewati.
option: kontrol opsi.
grammar: kontrol tata bahasa. Nilai valid: kosong, es2, dan js.
jsmode: kontrol daftar putih nama domain JavaScript. Nilai valid: redirect dan bypass.




























Elemen respons

Element

Type

Description

Example

object

RequestId

string

ID permintaan.

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

DomainConfigList

array<object>

Daftar konfigurasi nama domain.

object

ConfigId

integer

ID konfigurasi.

1234567

DomainName

string

Nama domain.

www.example.com

FunctionName

string

Nama fitur.

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.