EditRoutineConf - Dynamic Route for CDN - Alibaba Cloud Documentation Center

Modifies the configurations of a routine.

Note

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 in China and 1 is deployed outside China. The canary release environments are:
- Outside China: presetCanaryOverseas.
- In China: The 34 canary release environments are named in the format of presetCanaryXX. For example, presetCanaryBeijing represents the canary release environment in Beijing. A canary release environment is in each of the following regions: 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, Yunnan, and Zhejiang.
You can call this operation up to 100 times per second per account.

Debugging

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	Map	No	{"staging":{"SpecName":"50ms","AllowedHosts":["test-a.alicdn.com","test-b.alicdn.com"]},"production":{"SpecName":"50ms","AllowedHosts":["test-c.alicdn.com","test-d.alicdn.com"]},"presetCanaryZhejiang":{"SpecName":"100ms","AllowedHosts":["test-e.alicdn.com","test-f.alicdn.com"]},"presetCanaryBeijing":{"SpecName":"5ms","AllowedHosts":["test-g.alicdn.com","test-h.alicdn.com"]},"presetCanaryNotExist":{"SpecName":"5ms","CodeRev":"1622446907645949975","AllowedHosts":["error hosts"]}}	The configurations of the specified environment.

Response parameters


Parameter	Type	Example	Description
Content	Map		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.

Fields in Content


Field	Type	Example	Description
Description	String	Validate (Env: presetCanaryNotExist, Error: not valid canary name )	The description of the routine.
EnvConfRev	JSON	1622033526212272495	The configuration version number of each environment.

Examples

Sample requests

http://dcdn.aliyuncs.com/?Action=EditRoutineConf
&Name="test-slc"
&Description="the description of this routine"
&EnvConf={"staging":{"SpecName":"50ms","AllowedHosts":["test-a.alicdn.com","test-b.alicdn.com"]},"production":{"SpecName":"50ms","AllowedHosts":["test-c.alicdn.com","test-d.alicdn.com"]},"presetCanaryZhejiang":{"SpecName":"100ms","AllowedHosts":["test-e.alicdn.com","test-f.alicdn.com"]},"presetCanaryBeijing":{"SpecName":"5ms","AllowedHosts":["test-g.alicdn.com","test-h.alicdn.com"]},"presetCanaryNotExist":{"SpecName":"5ms","CodeRev":"1622446907645949975","AllowedHosts":["error hosts"]}}
&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<EditRoutineConfResponse>
    <RequestId>BAECB354-6D42-42C1-87DA-C9992EF1E7C8</RequestId>
    <Content>
        <Description>Validate (Env: presetCanaryNotExist, Error: not valid canary name ) </Description>
        <EnvConfRev>
            <presetCanaryZhejiang>1622033526212272495</presetCanaryZhejiang>
            <staging>1622033526008611202</staging>
            <presetCanaryBeijing>1622033526223670241</presetCanaryBeijing>
            <production>1622033526162527140</production>
        </EnvConfRev>
    </Content>
</EditRoutineConfResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "BAECB354-6D42-42C1-87DA-C9992EF1E7C8",
  "Content" : {
    "Description" : "Validate (Env: presetCanaryNotExist, Error: not valid canary name ) ",
    "EnvConfRev" : {
      "presetCanaryZhejiang" : "1622033526212272495",
      "staging" : "1622033526008611202",
      "presetCanaryBeijing" : "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, see Service error codes.