ListScheduledPreloadJobs - Edge Security Acceleration - Centre de documentation Alibaba Cloud

Répertorie les tâches de préchargement planifiées pour un site.

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:ListScheduledPreloadJobs

get

*Site.

acs:esa:{#regionId}:{#accountId}:site/{#SiteId}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
SiteId	integer	Oui	L'identifiant du site.	190007158391808
StartTime	integer	Non	L'heure de début de la plage de temps pour interroger l'heure de création de la tâche. La valeur est un horodatage UNIX en millisecondes.	1717225276000
EndTime	integer	Non	L'heure de fin de la plage de temps pour interroger l'heure de création de la tâche. La valeur est un horodatage UNIX en millisecondes.	1717225277000
PageNumber	integer	Non	Le numéro de la page à renvoyer.	1
PageSize	integer	Non	Le nombre d'entrées à renvoyer par page.	20

É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.	CB1A380B-09F0-41BB-A198-72F8FD6DA2FE
TotalCount	string	Le nombre total d'enregistrements filtrés.	5
Jobs	array<object>	La liste des tâches de préchargement.
	object	Les informations sur la tâche de préchargement.
AliUid	string	L'identifiant du compte Alibaba Cloud.	15685865xxx14622
CreatedAt	string	L'heure à laquelle la tâche a été créée. L'heure suit la norme ISO 8601, par exemple 2024-01-01T00:00:00Z.	2024-06-01T08:53:13Z
Domains	string	La liste des noms de domaine à précharger.	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-reginon.aliyuncs.com/9d91_xxxxxxxxxxx_158bb6e0f97c477791209bb46bd599f7
FileId	string	L'identifiant du fichier de liste d'URL, utilisé pour le téléchargement.	665d3b48621bccf3fe29e1a7
Id	string	L'identifiant de la tâche.	665d3af3621bccf3fe29e1a4
InsertWay	string	La méthode utilisée pour insérer des URL. Valeurs valides : oss : Importation par lot d'URL via un fichier 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, tel que l'actualisation ou le 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
ExecutionCount	integer	Le nombre de plans de préchargement.	1

Exemples

JSON format

{
  "RequestId": "CB1A380B-09F0-41BB-A198-72F8FD6DA2FE",
  "TotalCount": "5",
  "Jobs": [
    {
      "AliUid": "15685865xxx14622",
      "CreatedAt": "2024-06-01T08:53:13Z",
      "Domains": "testurl.com",
      "ErrorInfo": "invalid domain:test.com",
      "FailedFileOss": "https://xxxobject.oss-cn-reginon.aliyuncs.com/9d91_xxxxxxxxxxx_158bb6e0f97c477791209bb46bd599f7",
      "FileId": "665d3b48621bccf3fe29e1a7",
      "Id": "665d3af3621bccf3fe29e1a4",
      "InsertWay": "oss",
      "Name": "example",
      "SiteId": 190007158391808,
      "TaskSubmitted": 1,
      "TaskType": "preload",
      "UrlCount": 2,
      "UrlSubmitted": 1,
      "ExecutionCount": 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.