Modifies the configurations of a specified routine.

  • This operation modifies only the specified configurations. Other configurations remain unchanged.
  • If you want to delete a setting, delete the parameter value.
  • This operation can add canary release environments. Make sure that the environment names comply with the naming rules. Otherwise, you will fail to add the environments.
  • Dynamic Route for CDN (DCDN) provides 35 canary release environments. Among these environments, 34 are deployed inside China and 1 is deployed outside China. The canary release environments are:
    • Outside China: presetCanaryOverseas and presetCanaryXX.
    • Inside China: Anhui, Beijing, Chongqing, Fujian, Gansu, Guangdong, Guangxi, Guizhou, Hainan, Hebei, Heilongjiang, Henan, Hong Kong, Hubei, Hunan, Jiangsu, Jiangxi, Jilin, Liaoning, Macao, Neimenggu, Ningxia, Qinghai, Shaanxi, Shandong, Shanghai, Shanxi, Sichuan, Taiwan, Tianjin, Xinjiang, Xizang, Yunan, and Zhejiang.
    • The call frequency of the API is no more than 100 queries per second.


OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes EditRoutineConf

The operation that you want to perform. Set the value to EditRoutineConf.

Name String Yes test-slc

The name of the routine. The name must be unique among the routines that belong to the same Alibaba Cloud account.

Description String No the description of this routine

The description of the routine.

EnvConf Json No {"Staging":{"SpecName":"50ms","AllowedHosts":["",""]},"Production":{"SpecName":"50ms","AllowedHosts":["",""]},"Preset_Canary_Zhejiang":{"SpecName":"100ms","AllowedHosts":["",""]},"Preset_Canary_Beijing":{"SpecName":"5ms","AllowedHosts":["",""]},"Preset_Canary_Not_Exist":{"SpecName":"5ms","CodeRev":"1622446907645949975","AllowedHosts":["error hosts"]}}

The configurations of the specified environment.

Response parameters

Parameter Type Example Description
Content Map Description and EnvConfRev

The description of the execution errors and the version number of the latest environment configurations.

RequestId String BAECB354-6D42-42C1-87DA-C9992EF1E7C8

The ID of the request.


Sample requests"test-slc"&Description="the description of this routine"&EnvConf={"Staging":{"SpecName":"50ms","AllowedHosts":["",""]},"Production":{"SpecName":"50ms","AllowedHosts":["",""]},"Preset_Canary_Zhejiang":{"SpecName":"100ms","AllowedHosts":["",""]},"Preset_Canary_Beijing":{"SpecName":"5ms","AllowedHosts":["",""]},"Preset_Canary_Not_Exist":{"SpecName":"5ms","CodeRev":"1622446907645949975","AllowedHosts":["error hosts"]}}&<Common request parameters>

Sample success responses

XML format

    <Description>Validate (Env: Preset_Canary_Not_Exist, Error: not valid canary name ) </Description>

JSON format

    "RequestId": "BAECB354-6D42-42C1-87DA-C9992EF1E7C8",
    "Content": {
        "Description": "Validate (Env: Preset_Canary_Not_Exist, Error: not valid canary name ) ",
        "EnvConfRev": {
            "Preset_Canary_Zhejiang": "1622033526212272495",
            "Staging": "1622033526008611202",
            "Preset_Canary_Beijing": "1622033526223670241",
            "Production": "1622033526162527140"

Error codes

HttpCode Error code Error message Description
400 EdgeRoutine.GeneralError A server error occurred: %s The error message returned because an error %s occurred on the server. If the problem persists, submit a ticket.

For a list of error codes, visit the API Error Center.