PreloadDcdnObjectCaches - - Centre de documentation Alibaba Cloud

Description de l'opération

Opérations associées : les opérations d'actualisation et de préchargement incluent l'opération d'actualisation RefreshDcdnObjectCaches et l'opération de préchargement PreloadDcdnObjectCaches.
Méthode de requête : les requêtes POST sont prises en charge. Les paramètres sont affichés dans un formulaire.
Quota quotidien de préchargement d'URL : par défaut, chaque compte peut soumettre jusqu'à 1 000 nœuds de préchargement d'URL par jour. Si la bande passante de pointe quotidienne de votre compte dépasse 200 Mbit/s, vous pouvez demander à augmenter le quota quotidien via le soumettre un ticket. Alibaba Cloud évaluera et configurera le quota en fonction de vos besoins commerciaux réels.
Vous pouvez soumettre jusqu'à 100 nœuds de préchargement d'URL à la fois.
Règles de file d'attente de préchargement : la taille maximale de la file d'attente de préchargement pour chaque compte est de 100 000 URL. DCDN précharge les URL dans l'ordre où elles sont soumises. Lorsque le nombre de nœuds non terminés dans la file d'attente de préchargement atteint 100 000 URL, Alibaba Cloud DCDN met en œuvre un mécanisme de file d'attente. Cela signifie que vous ne pouvez soumettre le nœud de préchargement d'URL suivant qu'après le préchargement de la première URL dans le tri.
Fréquence d'appel par utilisateur : 15 appels par seconde.

Précautions

Après qu'un nœud de préchargement est soumis et exécuté avec succès, le point de présence (POP) DCDN demande immédiatement les ressources au serveur d'origine. Par conséquent, la soumission d'un grand nombre de nœuds de préchargement génère de nombreux nœuds de téléchargement simultanés, ce qui entraîne une augmentation soudaine de la bande passante de retour à l'origine et des requêtes, et augmente la charge sur le serveur d'origine.
Le temps d'exécution réel, de la soumission à l'achèvement d'un nœud de préchargement, dépend de la taille des fichiers préchargés et prend environ 5 à 30 minutes. Plus la taille moyenne des fichiers est petite, plus la vitesse de préchargement est rapide.
Pour utiliser un utilisateur Resource Access Management (RAM) afin d'effectuer des opérations d'actualisation ou de préchargement, vous devez d'abord obtenir l'autorisation pour l'utilisateur Resource Access Management (RAM). Pour plus d'informations, consultez Accorder l'autorisation à un utilisateur Resource Access Management (RAM) pour actualiser et précharger des ressources.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

dcdn:PreloadDcdnObjectCaches

none

*domain

acs:dcdn:*:{#accountId}:domain/{#domainName}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
ObjectPath	string	Oui	Les URL à précharger. Le format est nom de domaine accéléré/fichier préchargé. Remarque Séparez plusieurs URL par des sauts de ligne. La longueur maximale d'un seul ObjectPath est de 1 024 caractères.	http://example.com/examplefile.txt http://example.com/examplefile2.txt
Area	string	Non	La région de préchargement. Valeurs valides : domestic : la Chine continentale. overseas : mondial (à l'exclusion de la Chine continentale). Si vous ne spécifiez pas ce paramètre, la région de préchargement par défaut est la région d'accélération DCDN configurée pour votre nom de domaine. Les détails sont les suivants : Si la région d'accélération du nom de domaine est la Chine continentale, la région de préchargement est la Chine continentale. Si la région d'accélération du nom de domaine est Mondial, la région de préchargement est mondiale. Si la région d'accélération du nom de domaine est Mondial (à l'exclusion de la Chine continentale), la région de préchargement est mondiale (à l'exclusion de la Chine continentale). Valeurs valides : domestic : La Chine continentale. overseas : Mondial (à l'exclusion de la Chine continentale).	domestic
L2Preload	boolean	Non	Indique si le contenu doit être préchargé directement vers les nœuds L2. Valeurs valides : true : la hiérarchie des nœuds pour le préchargement doit inclure des nœuds L2. false : le contenu est préchargé uniquement vers les nœuds de récupération d'origine. Il s'agit de la valeur par défaut. Les nœuds de récupération d'origine peuvent être des nœuds L2 ou des nœuds L3.	true
WithHeader	string	Non	Les en-têtes de préchargement personnalisés. Soumettez les en-têtes au format JSON.	{ "Accept-Encoding": [ "gzip" ] }
QueryHashkey	boolean	Non	Ce paramètre est utilisé lorsque des règles spécifiques, telles que la réécriture d'URL et le filtrage de paramètres, sont configurées. Il indique si le mode de requête de clé de hachage doit être activé lors de l'exécution des tâches de préchargement. Valeurs valides : false : le mode par défaut. Ce mode est utilisé lorsque ce paramètre n'est pas spécifié. L'URL soumise est directement utilisée comme clé de hachage du fichier préchargé. true : la clé de hachage réelle utilisée pour l'URL préchargée est interrogée en fonction de la configuration du nom de domaine.	true

Éléments de réponse

Élément	Type	Description	Exemple
	object
PreloadTaskId	string	L'identifiant de la tâche de préchargement. Les identifiants de plusieurs tâches sont séparés par des virgules (,). Les identifiants de tâche renvoyés sont fusionnés selon les deux règles suivantes : Les tâches de préchargement soumises pour le même nom de domaine dans la même seconde à la granularité de l'URL sont fusionnées dans le même RushTaskId. Si plus de 500 tâches de préchargement sont soumises pour le même nom de domaine dans la même seconde à la granularité de l'URL, chaque groupe de 500 tâches est fusionné en un seul RushTaskId.	95248880
RequestId	string	L'identifiant de la requête.	E5BD4B50-7A02-493A-AE0B-97B9024B4135

Exemples

JSON format

{
  "PreloadTaskId": "95248880",
  "RequestId": "E5BD4B50-7A02-493A-AE0B-97B9024B4135"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	SingleRequest.OverLimit	A maximum of 1000 URLs are supported for each request.
400	QuotaExceeded.Preload	Your refresh attempts have exceeded the daily limit.	La limite quotidienne d'actualisation et de préchargement a été dépassée.
400	InvalidObjectPath.Malformed	The specified ObjectPath is invalid.	L'ObjectPath n'est pas valide. Spécifiez un ObjectPath valide.
400	InvalidExtensiveDomain.ValueNotSupported	The specified ExtensiveDomain is not supported.	Les noms de domaine génériques ne sont pas pris en charge.
400	PreloadQueueFull	The warming queue is full; please try again later.	Le nombre d'URL en cours de préchargement pour le nom de domaine a atteint la limite supérieure. Réessayez plus tard.
400	InvalidObjectPath.ExceedsMaximum	The maximum number of urls is exceeded.	Le nombre d'URL soumises dépasse la limite maximale.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.