BatchSetDcdnDomainConfigs操作を呼び出してドメイン名の機能を設定すると、一意の設定ID (ConfigId) が生成されます。 この設定IDを使用して、設定を更新または削除できます。 このトピックでは、構成IDを生成、クエリ、および使用する方法について説明します。
使用上の注意
機能 | 説明 |
構成IDの生成 | BatchSetDcdnDomainConfigs操作を呼び出します。 操作が成功すると、構成IDが生成されます。 |
構成IDの照会 | DescribeDcdnDomainConfigs操作を呼び出します。 操作が成功した場合、構成IDが返されます。 |
設定IDを使用して設定を更新する | BatchSetDcdnDomainConfigs操作を呼び出して、指定された構成IDに基づいて設定を更新します。 |
設定IDを使用した設定の削除 | 指定された構成IDに基づいて設定を削除するには、DeleteDcdnSpecificConfig操作を呼び出します。 |
構成IDの生成
単一の機能ルールを設定する: BatchSetDcdnDomainConfigs操作を呼び出して、ドメイン名に単一の機能ルールを設定します。 操作が成功すると、構成IDが生成されて返されます。
シナリオ: 高速化ドメイン名
example.comを例として使用します。 Dynamic Content Delivery Network (DCDN) Point of presence (POP) を有効にして、返されたコンテンツをキャッシュする必要がないことをクライアントに通知します。たとえば、ドメイン名のset_resp_header機能を次の
example.comに設定します。key=Cache-Control、value=no-cache。 リクエストの例アクション: BatchSetDcdnDomainConfigs params: { "関数": [{ "functionArgs": [{ "argName": "値" 、 "argValue": "no-cache" }, { "argName": "キー" 、 "argValue": "キャッシュ制御" } ], "functionName": "set_resp_header" }], "domainNames": "example.com" } プロダクト: dcdn操作が成功した場合、構成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: DCDN POPを有効にして、返されたコンテンツをキャッシュする必要がないことをクライアントに通知します。
パラメーター設定: key=Cache-Control、value=no-cache。
ルール2: DCDN POPを有効にして、返されたコンテンツがテキストタイプであることをクライアントに通知します。
パラメーター設定: key=Content-Type、value=text/plain。
リクエストの例
アクション: BatchSetDcdnDomainConfigs params: { "domainNames": "example.aliyundoc.com" 、 "functions": [ { "functionArgs": [ { "ArgValue": "キャッシュ制御" 、 "ArgName": "キー" }, { "ArgValue": "no-cache" 、 "ArgName": "value" } ], "functionName": "set_resp_header" }, { "functionArgs": [ { "ArgValue": "Content-Type" 、 "ArgName": "キー" }, { "ArgValue": "text/plain" 、 "ArgName": "value" } ], "functionName": "set_resp_header" } ] } プロダクト: dcdn操作が成功した場合、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の照会
DescribeDcdnDomainConfigs操作を呼び出します。 操作が成功した場合、構成IDが返されます。
例: ドメイン名example.aliyundoc.comのset_resp_headerの設定を照会します。 リクエストの例
アクション: DescribeDcdnDomainConfigs
params: {
"domainName": "example.aliyundoc.com" 、
"functionNames": "set_resp_header"
}
プロダクト: dcdn 構成IDが返されます。
{
"code": "200"、
"data": {
"RequestId": "51B7DF03-A7AE-56ED-BF1E-D16F6A6B ****" 、
"DomainConfigs": {
"DomainConfig": [{
"ステータス": "設定" 、
"FunctionName": "set_resp_header" 、
"FunctionArgs": {
"FunctionArg": [{
"ArgValue": "no-cache" 、
"ArgName": "value"
},
{
"ArgValue": "キャッシュ制御" 、
"ArgName": "キー"
}
]
},
"ConfigId": 19572306654 ****
}]
}
},
"httpStatusCode": "200" 、
"requestId": "51B7DF03-A7AE-56ED-BF1E-D16F6A6B ****" 、
"successResponse": true
} 設定IDを使用して設定を更新する
BatchSetDcdnDomainConfigsを呼び出して、指定された構成IDに基づいて設定を更新します。
シナリオ: 高速化ドメイン名example.comを例として使用します。 POPを有効にして、提供されたコンテンツを1時間キャッシュします。
たとえば、ドメイン名のexample.comにset_resp_header機能を設定します。key=Cache-Control, value=max-age=3600です。 リクエストの例
アクション: BatchSetDcdnDomainConfigs
params: {
"関数": [
{
"functionArgs": [
{
"argName": "値" 、
"argValue": "max-age=3600"
},
{
"argName": "キー" 、
"argValue": "キャッシュ制御"
}
],
"functionName": "set_resp_header" 、
"ConfigId": 19571990834 ****
}
],
"domainNames": "example.com"
}
プロダクト: dcdn 設定IDを使用した設定の削除
指定された構成IDに基づいて設定を削除するには、DeleteDcdnSpecificConfig操作を呼び出します。
たとえば、ドメイン名example.aliyundoc.comのset_resp_headerの設定を削除します。 リクエストの例
アクション: DeleteDcdnSpecificConfig
params: {
"ConfigId": 19571990834 **** 、
"functionName": "set_resp_header" 、
"domainName": "example.aliyundoc.com"
}
プロダクト: dcdn