CDN:ConfigIdの使用状況ノート

使用上の注意

構成IDの生成

• 単一の機能ルールを設定する:

  • BatchSetCdnDomainConfig操作を呼び出して、ドメイン名の特定の機能を設定します。 操作が成功した場合、構成IDが返されます。

  • SetCdnDomainStagingConfig操作を呼び出して、ドメイン名の特定の機能を設定します。 ただし、操作が成功した後、構成IDは返されません。 構成IDを照会するには、DescribeCdnDomainStagingConfig操作を呼び出す必要があります。

  シナリオ: ドメイン名example.comを例として使用します。 POPs (Point of presence) を有効にして、クライアントに返されたコンテンツをキャッシュする必要がないことをクライアントに通知します。

  例: ドメイン名のset_resp_headerパラメーターを次のexample.comに設定します。key=Cache-Control、value=no-cache。 リクエストの例

  アクション: BatchSetCdnDomainConfig
  params: {
      "関数": [{
          "functionArgs": [{
                  "argName": "値" 、
                  "argValue": "no-cache"
              },
              {
                  "argName": "キー" 、
                  "argValue": "キャッシュ制御"
              }
          ],
          "functionName": "set_resp_header"
      }],
      "domainNames": "example.com"
  }
  プロダクト: 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。

  リクエストの例

  アクション: BatchSetCdnDomainConfig
  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"
          }
      ]
  }
  プロダクト: 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が返されます。

アクション: DescribeCdnDomainConfigs
params: {
    "domainName": "example.aliyundoc.com" 、
    "functionNames": "set_resp_header"
}
プロダクト: cdn 

{
    "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を使用して設定を更新する

BatchSetCdnDomainConfigまたはSetCdnDomainStagingConfigを呼び出して、指定された構成IDに基づいて設定を更新します。

シナリオ: ドメイン名example.comを例として使用します。 POPを有効にして、クライアントに応答したコンテンツを1時間キャッシュします。

アクション: BatchSetCdnDomainConfig
params: {
    "関数": [
        {
            "functionArgs": [
                {
                    "argName": "値" 、 
                    "argValue": "max-age=3600"
                }, 
                {
                    "argName": "キー" 、 
                    "argValue": "キャッシュ制御"
                }
            ], 
            "functionName": "set_resp_header" 、 
            "ConfigId": 19571990834 ****
        }
    ], 
    "domainNames": "example.com"
}
プロダクト: cdn 

設定IDを使用した設定の削除

指定された構成IDに基づいて設定を削除するには、DeleteSpecificConfigまたはDeleteSpecificStagingConfig操作を呼び出します。

アクション: DeleteSpecificConfig
params: {
    "ConfigId": 19571990834 **** 、 
    "functionName": "set_resp_header" 、 
    "domainName": "example.aliyundoc.com"
}
プロダクト: cdn