Générer, interroger et utiliser un ID de configuration - Edge Security Acceleration

Lorsque vous appelez l'opération BatchSetDcdnDomainConfigs pour configurer une fonctionnalité pour un nom de domaine, un ID de configuration unique (ConfigId) est généré. Vous pouvez utiliser cet ID de configuration pour mettre à jour ou supprimer des paramètres. Cette rubrique explique comment générer, interroger et utiliser un ID de configuration.

Notes d'utilisation

Fonctionnalité

description

Générer un ID de configuration

Appelez l'opération BatchSetDcdnDomainConfigs. Si l'opération réussit, un ID de configuration est généré.

Interroger un ID de configuration

Appelez l'opération DescribeDcdnDomainConfigs. Si l'opération réussit, un ID de configuration est renvoyé.

Utiliser un ID de configuration pour mettre à jour les paramètres

Appelez l'opération BatchSetDcdnDomainConfigs pour mettre à jour les paramètres en fonction d'un ID de configuration spécifié.

Utiliser un ID de configuration pour supprimer les paramètres

Appelez l'opération DeleteDcdnSpecificConfig pour supprimer les paramètres en fonction d'un ID de configuration spécifié.

Générer un ID de configuration

Configurer une seule règle de fonctionnalité : appelez l'opération BatchSetDcdnDomainConfigs pour configurer une seule règle de fonctionnalité pour un nom de domaine. Si l'opération réussit, un ID de configuration est généré et renvoyé.

Scénario : le nom de domaine accéléré example.com sert d'exemple. Activez les points de présence (POP) Dynamic Content Delivery Network (DCDN) pour informer les clients que le contenu renvoyé n'a pas besoin d'être mis en cache.

Par exemple, définissez la fonctionnalité set_resp_header pour le nom de domaine example.com : key=Cache-Control, value=no-cache. Exemple de requête :

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

Si l'opération réussit, un ID de configuration est renvoyé.

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

Certaines fonctionnalités supportent plusieurs règles. L'exemple suivant montre comment ajouter plusieurs règles à la fois :

Ajoutez les deux règles suivantes pour set_resp_header pour le nom de domaine example.aliyundoc.com :

Règle 1 : activez les POP DCDN pour informer les clients que le contenu renvoyé n'a pas besoin d'être mis en cache.

Paramètres : key=Cache-Control, value=no-cache.
Règle 2 : activez les POP DCDN pour informer les clients que le contenu renvoyé est de type texte.

Paramètres : key=Content-Type, value=text/plain.

Exemple de requête :

action: BatchSetDcdnDomainConfigs
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: dcdn

Si l'opération réussit, deux ID de configuration sont renvoyés.

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

Interroger un ID de configuration

Appelez l'opération DescribeDcdnDomainConfigs. Si l'opération réussit, un ID de configuration est renvoyé.

Exemple : interrogez les paramètres de set_resp_header pour le nom de domaine example.aliyundoc.com. Exemple de requête :

action: DescribeDcdnDomainConfigs
params: {
    "domainName": "example.aliyundoc.com",
    "functionNames": "set_resp_header"
}
product: dcdn

Un ID de configuration est renvoyé.

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

Utiliser un ID de configuration pour mettre à jour les paramètres

Appelez l'opération BatchSetDcdnDomainConfigs pour mettre à jour les paramètres en fonction d'un ID de configuration spécifié.

Scénario : le nom de domaine accéléré example.com sert d'exemple. Activez les POP pour mettre en cache le contenu servi pendant une heure.

Par exemple, définissez la fonctionnalité set_resp_header pour le nom de domaine example.com : key=Cache-Control, value=max-age=3600. Exemple de requête :

action: BatchSetDcdnDomainConfigs 
params: {
    "Functions": [
        {
            "functionArgs": [
                {
                    "argName": "value", 
                    "argValue": "max-age=3600"
                }, 
                {
                    "argName": "key", 
                    "argValue": "Cache-Control"
                }
            ], 
            "functionName": "set_resp_header", 
            "ConfigId": 19571990834****
        }
    ], 
    "domainNames": "example.com"
}
product: dcdn

Utiliser un ID de configuration pour supprimer les paramètres

Appelez l'opération DeleteDcdnSpecificConfig pour supprimer les paramètres en fonction d'un ID de configuration spécifié.

Par exemple, supprimez les paramètres spécifiés de set_resp_header pour le nom de domaine example.aliyundoc.com. Exemple de requête :

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