ResetScheduledPreloadJob - Edge Security Acceleration - Centre de documentation Alibaba Cloud

Réinitialise la progression d'une tâche de préchargement planifiée pour redémarrer le préchargement depuis le début. Prérequis : vous devez d'abord créer une tâche de préchargement planifiée en appelant CreateScheduledPreloadJob pour obtenir un identifiant de tâche valide, puis transmettre cet identifiant à cette opération pour réinitialiser la tâche.

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.

esa:ResetScheduledPreloadJob

update

*Toutes les ressources.

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
Id	string	Non	L'identifiant de la tâche de préchargement planifiée. Important L'identifiant de la tâche de préchargement planifiée. Ce paramètre est requis. Vous pouvez obtenir l'identifiant à partir de la réponse après avoir créé une tâche en appelant CreateScheduledPreloadJob, ou interroger l'identifiant d'une tâche existante en appelant GetScheduledPreloadJob ou ListScheduledPreloadJobs.	665d3af3621bccf3fe29e1a4

Éléments de réponse

Élément	Type	Description	Exemple
	object	Schéma de la réponse.
RequestId	string	L'identifiant de la requête.	15C66C7B-671A-4297-9187-2C4477247A74
AliUid	string	L'identifiant du compte Alibaba Cloud.	15685865xxx14622
CreatedAt	string	L'heure à laquelle la tâche a été créée, au format ISO 8601, par exemple 2024-01-01T00:00:00+Z.	2024-06-02T02:23:26Z
Domains	string	La liste des noms de domaine préchargés.	testurl.com
ErrorInfo	string	Le message d'erreur.	invalid domain:test.com
FailedFileOss	string	L'URL OSS du fichier ayant échoué.	https://xxxobject.oss-cn-region.aliyuncs.com/9d91_xxxxxxxxxxx_158bb6e0f97c477791209bb46bd599f7
FileId	string	L'identifiant du fichier de liste d'URL, qui est utilisé pour le téléchargement.	665d3b48621bccf3fe29e1a7
Id	string	L'identifiant de la tâche.	665d3af3621bccf3fe29e1a4
InsertWay	string	La méthode d'insertion d'URL. Valeurs valides : oss : Importation par lot d'URL à partir de fichiers OSS. testBox : Saisie des URL une par une dans une zone de texte.	oss
Name	string	Le nom de la tâche.	example
SiteId	integer	L'identifiant du site.	190007158391808
TaskSubmitted	integer	Le nombre d'URL soumises au système pour les tâches de préchargement.	1
TaskType	string	Le type de tâche (actualisation ou préchargement). Valeurs valides : path : Actualisation de répertoire. refresh : Actualisation d'URL. preload : Préchargement d'URL.	preload
UrlCount	integer	Le nombre total d'URL.	2
UrlSubmitted	integer	Le nombre d'URL soumises.	1

Exemples

JSON format

{
  "RequestId": "15C66C7B-671A-4297-9187-2C4477247A74",
  "AliUid": "15685865xxx14622",
  "CreatedAt": "2024-06-02T02:23:26Z",
  "Domains": "testurl.com",
  "ErrorInfo": "domaine non valide : test.com",
  "FailedFileOss": "https://xxxobject.oss-cn-region.aliyuncs.com/9d91_xxxxxxxxxxx_158bb6e0f97c477791209bb46bd599f7",
  "FileId": "665d3b48621bccf3fe29e1a7",
  "Id": "665d3af3621bccf3fe29e1a4",
  "InsertWay": "oss",
  "Name": "example",
  "SiteId": 190007158391808,
  "TaskSubmitted": 1,
  "TaskType": "preload",
  "UrlCount": 2,
  "UrlSubmitted": 1
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidEndTime.Mismatch	The specified EndTime is earlier than the StartTime.	L'heure de fin est antérieure à l'heure de début. Vérifiez les valeurs et réessayez.
400	InvalidJob.JobCountOfSiteFull	The maximum number of prefetch tasks for the website has been reached. Delete some unwanted ones and try again.	Le nombre de tâches de préchargement de site a atteint la limite supérieure. Aucune tâche supplémentaire ne peut être ajoutée. Supprimez les tâches inutiles et réessayez.
400	InvalidParameter.ObjectId	Invalid task ID or execution plan ID.	L'identifiant de la tâche ou du plan d'exécution que vous avez fourni n'est pas valide. Vérifiez que l'identifiant est valide et saisi correctement.
400	MissingOssUrl	OssUrl missing. Specify a valid URL of the OSS object that stores URLs to prefetch.	Le champ OssUrl est manquant. Assurez-vous qu'une URL de tâche de préchargement OSS valide est fournie.
400	MissingUrlList	Enter the URLs you want to prefetch.	L'URL de préchargement est vide. Saisissez l'URL à précharger.
400	TooManyRequests	Too many requests.Please try again later.	La charge du système fluctue. Réessayez plus tard.
403	InvalidUid.PermissionDenied	You do not have the permissions to perform this operation on this resource. Check whether the specified UID is correct and has the required permissions.	Vous n'êtes pas autorisé à effectuer des opérations sur cette ressource. Assurez-vous que l'UID est correct et qu'il dispose des autorisations requises.
404	InvalidJob.NotFound	The task does not exist. Check whether the task ID is correct or whether the task has been deleted.	La tâche n'existe pas. Vérifiez si l'identifiant de la tâche est correct ou si la tâche a été supprimée.
404	LogNotFound	Failed to query the log. Check whether the task ID and execution ID are valid.	Aucun journal n'a été trouvé. Vérifiez que l'identifiant de la tâche, l'identifiant d'exécution et les autres paramètres sont corrects et valides.
404	InvalidExecution.NotFound	The execution plan does not exist. Check whether the parameters such as the execution ID, start time, and end time are correct.	Le plan d'exécution n'existe pas. Vérifiez si l'identifiant d'exécution, l'heure de début, l'heure de fin et les autres paramètres sont corrects.

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

Notes de version

Consultez Notes de version pour la liste complète.