CDN：Catatan Penggunaan ConfigId

Catatan Penggunaan

Menghasilkan ID konfigurasi

• Konfigurasikan aturan fitur tunggal:

  • Panggil operasi BatchSetCdnDomainConfig untuk mengonfigurasi fitur tertentu pada nama domain. Jika berhasil, ID konfigurasi akan dikembalikan.

  • Panggil operasi SetCdnDomainStagingConfig untuk mengonfigurasi fitur tertentu pada nama domain. Namun, tidak ada ID konfigurasi yang dikembalikan setelah operasi berhasil. Anda harus memanggil operasi DescribeCdnDomainStagingConfig untuk memeriksa ID konfigurasi.

  Skenario: Nama domain example.com digunakan sebagai contoh. Aktifkan points of presence (POPs) untuk memberi tahu klien bahwa konten yang dikembalikan ke klien tidak perlu disimpan dalam cache.

  Contoh: Atur parameter set_resp_header untuk nama domain example.com: key=Cache-Control,value=no-cache. Contoh permintaan:

  action: BatchSetCdnDomainConfig
  params: {
      "Functions": [{
          "functionArgs": [{
                  "argName": "value",
                  "argValue": "no-cache"
              },
              {
                  "argName": "key",
                  "argValue": "Cache-Control"
              }
          ],
          "functionName": "set_resp_header"
      }],
      "domainNames": "example.com"
  }
  product: cdn

  Jika operasi berhasil, ID konfigurasi akan dikembalikan.

  {
      "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
  }

• Beberapa fitur mendukung lebih dari satu aturan. Contoh berikut menunjukkan cara menambahkan beberapa aturan sekaligus:

  Contoh: Atur parameter set_resp_header untuk nama domain example.aliyundoc.com dan tambahkan dua aturan berikut:

  • Aturan 1: Aktifkan POPs untuk memberi tahu klien bahwa konten yang dikembalikan ke klien tidak perlu disimpan dalam cache.

    Pengaturan parameter: key=Cache-Control,value=no-cache.

  • Aturan 2: Aktifkan POPs untuk memberi tahu klien bahwa konten yang dikembalikan ke klien adalah tipe teks.

    Pengaturan parameter: key=Content-Type,value=text/plain.

  Contoh permintaan:

  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

  Jika operasi berhasil, dua ID konfigurasi akan dikembalikan.

  {
      "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
  }

Memeriksa ID konfigurasi

Panggil operasi DescribeCdnDomainConfigs atau DescribeCdnDomainStagingConfig. Jika berhasil, ID konfigurasi akan dikembalikan.

action: DescribeCdnDomainConfigs
params: {
    "domainName": "example.aliyundoc.com",
    "functionNames": "set_resp_header"
}
product: cdn

{
    "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
}

Menggunakan ID konfigurasi untuk memperbarui pengaturan

Panggil operasi BatchSetCdnDomainConfig atau SetCdnDomainStagingConfig untuk memperbarui pengaturan berdasarkan ID konfigurasi tertentu.

Skenario: Nama domain example.com digunakan sebagai contoh. Aktifkan POPs untuk menyimpan konten yang dikembalikan ke klien selama satu jam.

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

Menggunakan ID konfigurasi untuk menghapus pengaturan

Panggil operasi DeleteSpecificConfig atau DeleteSpecificStagingConfig untuk menghapus pengaturan berdasarkan ID konfigurasi tertentu.

action: DeleteSpecificConfig
params: {
    "ConfigId": 19571990834****, 
    "functionName": "set_resp_header", 
    "domainName": "example.aliyundoc.com"
}
product: cdn