BatchSetCdnDomainConfigまたはSetCdnDomainStagingConfig操作を呼び出してドメイン名の機能を設定すると、一意の設定ID (ConfigId) が生成されます。 この設定IDを使用して、設定を更新または削除できます。 このトピックでは、構成IDを生成、クエリ、および使用する方法について説明します。
使用上の注意
機能 | 説明 |
構成IDの生成 | BatchSetCdnDomainConfigまたはSetCdnDomainStagingConfig操作を呼び出します。 操作が成功すると、構成IDが生成されます。 |
設定IDの照会 | DescribeCdnDomainConfigsまたはDescribeCdnDomainStagingConfig操作を呼び出します。 操作が成功した場合、構成IDが返されます。 |
設定IDを使用して設定を更新する | 指定された構成IDに基づいて設定を更新するには、BatchSetCdnDomainConfigまたはSetCdnDomainStagingConfig操作を呼び出します。 |
設定IDを使用した設定の削除 | 指定された構成IDに基づいて設定を削除するには、DeleteSpecificConfigまたはDeleteSpecificStagingConfig操作を呼び出します。 |
構成IDの生成
単一の機能ルールを設定する:
BatchSetCdnDomainConfig操作を呼び出して、ドメイン名の特定の機能を設定します。 操作が成功した場合、構成IDが返されます。
SetCdnDomainStagingConfig操作を呼び出して、ドメイン名の特定の機能を設定します。 ただし、操作が成功した後、構成IDは返されません。 構成IDを照会するには、DescribeCdnDomainStagingConfig操作を呼び出す必要があります。
シナリオ: ドメイン名
example.comを例として使用します。 POPs (Point of presence) を有効にして、クライアントに返されたコンテンツをキャッシュする必要がないことをクライアントに通知します。例: ドメイン名のset_resp_headerパラメーターを次の
example.comに設定します。key=Cache-Control、value=no-cache。 リクエストの例action: BatchSetCdnDomainConfig params: { "Functions": [{ "functionArgs": [{ "argName": "value", "argValue": "no-cache" }, { "argName": "key", "argValue": "Cache-Control" } ], "functionName": "set_resp_header" }], "domainNames": "example.com" } product: cdn操作が成功した場合、構成IDが返されます。
{ "code": "200", "data": { "DomainConfigList": { "DomainConfigModel": [ { "FunctionName": "set_resp_header", "DomainName": "example.com", "ConfigId": 19571990834**** } ] }, "RequestId": "4FF61A1D-E697-5E6C-9E5D-7D1E1529****" }, "httpStatusCode": "200", "requestId": "4FF61A1D-E697-5E6C-9E5D-7D1E1529****", "successResponse": true }一部の機能は複数のルールをサポートしています。 次の例は、一度に複数のルールを追加する方法を示しています。
例: ドメイン名
example.aliyundoc.comにset_resp_headerパラメーターを設定し、次の2つのルールを追加します。ルール1: POPを有効にして、クライアントに返されたコンテンツをキャッシュする必要がないことをクライアントに通知します。
パラメーター設定: key=Cache-Control、value=no-cache。
ルール2: POPを有効にして、クライアントに返されるコンテンツがテキストタイプであることをクライアントに通知します。
パラメーター設定: key=Content-Type、value=text/plain。
リクエストの例
action: BatchSetCdnDomainConfig params: { "domainNames": "example.aliyundoc.com", "functions": [ { "functionArgs": [ { "ArgValue": "Cache-Control", "ArgName": "key" }, { "ArgValue": "no-cache", "ArgName": "value" } ], "functionName": "set_resp_header" }, { "functionArgs": [ { "ArgValue": "Content-Type", "ArgName": "key" }, { "ArgValue": "text/plain", "ArgName": "value" } ], "functionName": "set_resp_header" } ] } product: cdn操作が成功した場合、2つの構成IDが返されます。
{ "code":"200", "data":{ "DomainConfigList":{ "DomainConfigModel":[ { "FunctionName":"set_resp_header", "DomainName":"example.aliyundoc.com", "ConfigId":20953663204**** }, { "FunctionName":"set_resp_header", "DomainName":"example.aliyundoc.com", "ConfigId":20953663204**** } ] }, "RequestId":"69A79ACE-FD8E-5993-9CEA-7AAB2F08****" }, "httpStatusCode":"200", "requestId":"69A79ACE-FD8E-5993-9CEA-7AAB2F08****", "successResponse":true }
設定IDの照会
DescribeCdnDomainConfigsまたはDescribeCdnDomainStagingConfig操作を呼び出します。 操作が成功した場合、構成IDが返されます。
例: ドメイン名example.aliyundoc.comのset_resp_headerの設定を照会します。 リクエストの例
action: DescribeCdnDomainConfigs
params: {
"domainName": "example.aliyundoc.com",
"functionNames": "set_resp_header"
}
product: cdn構成IDが返されます。
{
"code": "200",
"data": {
"RequestId": "51B7DF03-A7AE-56ED-BF1E-D16F6A6B****",
"DomainConfigs": {
"DomainConfig": [{
"Status": "configuring",
"FunctionName": "set_resp_header",
"FunctionArgs": {
"FunctionArg": [{
"ArgValue": "no-cache",
"ArgName": "value"
},
{
"ArgValue": "Cache-Control",
"ArgName": "key"
}
]
},
"ConfigId": 19572306654****
}]
}
},
"httpStatusCode": "200",
"requestId": "51B7DF03-A7AE-56ED-BF1E-D16F6A6B****",
"successResponse": true
}設定IDを使用して設定を更新する
BatchSetCdnDomainConfigまたはSetCdnDomainStagingConfigを呼び出して、指定された構成IDに基づいて設定を更新します。
シナリオ: ドメイン名example.comを例として使用します。 POPを有効にして、クライアントに応答したコンテンツを1時間キャッシュします。
例: ドメイン名のset_resp_headerパラメーターを次のexample.comに設定します。key=Cache-Control、value=max-age=3600。 リクエストの例
action: BatchSetCdnDomainConfig
params: {
"Functions": [
{
"functionArgs": [
{
"argName": "value",
"argValue": "max-age=3600"
},
{
"argName": "key",
"argValue": "Cache-Control"
}
],
"functionName": "set_resp_header",
"ConfigId": 19571990834****
}
],
"domainNames": "example.com"
}
product: cdn設定IDを使用した設定の削除
指定された構成IDに基づいて設定を削除するには、DeleteSpecificConfigまたはDeleteSpecificStagingConfig操作を呼び出します。
例: ドメイン名example.aliyundoc.comのset_req_headerパラメーターの設定を削除します。 リクエストの例
action: DeleteSpecificConfig
params: {
"ConfigId": 19571990834****,
"functionName": "set_resp_header",
"domainName": "example.aliyundoc.com"
}
product: cdn