How to generate, query, and use a ConfigId - CDN - Alibaba Cloud Dokümantasyon Merkezi

Bir alan adı için bir özelliği BatchSetCdnDomainConfig veya SetCdnDomainStagingConfig API'lerini kullanarak her yapılandırdığınızda, Alibaba Cloud CDN bu kural için benzersiz bir yapılandırma kimliği (ConfigId) oluşturur. Aynı türdeki diğer kuralları etkilemeden belirli bir kuralı güncellemek veya silmek için ConfigId'yi kullanın.

Tipik iş akışı şöyledir: Bir kuralı yapılandırırken bir ConfigId oluşturun, gerekirse sorgulayın ve ardından bu kuralı güncellemek veya silmek için bu kimliği kullanın.

API hızlı başvurusu

İşlem	API
Yapılandırma kimliği oluşturma	BatchSetCdnDomainConfig veya SetCdnDomainStagingConfig
Yapılandırma kimliklerini sorgulama	DescribeCdnDomainConfigs veya DescribeCdnDomainStagingConfig
ConfigId kullanarak ayarları güncelleme	BatchSetCdnDomainConfig veya SetCdnDomainStagingConfig
ConfigId kullanarak ayarları silme	DeleteSpecificConfig veya DeleteSpecificStagingConfig

Yapılandırma kimliği oluşturma

Bir alan adı için bir özellik yapılandırmak üzere BatchSetCdnDomainConfig veya SetCdnDomainStagingConfig API'sini çağırın. İşlem başarılı olduğunda her kural için bir ConfigId oluşturulur.

BatchSetCdnDomainConfig: ConfigId'yi doğrudan yanıtta döndürür.
SetCdnDomainStagingConfig: Yanıtta bir ConfigId döndürmez. Kimliği almak için ayrı olarak DescribeCdnDomainStagingConfig API'sini çağırın.

Bir özellik birden çok kuralı destekliyorsa tek bir çağrıda birkaç kural eklediğinizde kural başına bir ConfigId döndürülür.

Örnek: Tek bir yanıt üst bilgisi kuralı ekleme

Varlık sunucularının (POP'lar) istemcilere döndürülen içeriği önbelleğe almamasını sağlamak için example.com alanında Cache-Control: no-cache değerini ayarlayın.

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

Başarılı olduğunda bir ConfigId döndürülür:

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

Örnek: Birden çok yanıt üst bilgisi kuralını aynı anda ekleme

example.aliyundoc.com için iki set_resp_header kuralı ekleyin: Biri Cache-Control: no-cache değerini, diğeri ise Content-Type: text/plain değerini ayarlar.

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

Başarılı olduğunda her kural için bir tane olmak üzere iki ConfigId döndürülür:

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

Yapılandırma kimliklerini sorgulama

Mevcut kurallar için ConfigId'leri almak üzere DescribeCdnDomainConfigs veya DescribeCdnDomainStagingConfig API'sini çağırın.

Örnek: Bir alan adı için ConfigId'leri sorgulama

example.aliyundoc.com için set_resp_header ayarlarını sorgulayın:

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

Yanıt, eşleşen her kural için ConfigId'yi içerir:

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

Yapılandırma kimliği kullanarak ayarları güncelleme

Belirli bir kuralı güncellemek için ConfigId parametresiyle BatchSetCdnDomainConfig veya SetCdnDomainStagingConfig API'sini çağırın. Bu kuralı hedeflemek için işlev nesnesine ConfigId'yi dahil edin.

Örnek: Cache-Control değerini max-age=3600 olarak güncelleme

Varlık sunucularının yanıtları bir saat boyunca önbelleğe almasını sağlamak için example.com üzerindeki Cache-Control üst bilgisini no-cache değerinden max-age=3600 değerine değiştirin:

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

Yapılandırma kimliği kullanarak ayarları silme

Belirli bir kuralı silmek için bir ConfigId ile DeleteSpecificConfig veya DeleteSpecificStagingConfig API'sini çağırın.

Örnek: Bir yanıt üst bilgisi kuralını silme

example.aliyundoc.com üzerinde ConfigId'si 19571990834**** olan kuralı silin:

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