UpdateJobStatus - Object Storage Service - Centre de documentation Alibaba Cloud

Permissions

Les comptes Alibaba Cloud disposent de toutes les autorisations par défaut. Les utilisateurs RAM et les rôles RAM ne possèdent aucune autorisation par défaut ; vous devez leur accorder l'accès via une politique RAM ou une politique de bucket.

API

Action

Description

UpdateJobStatus

oss:UpdateJobStatus

Met à jour le statut d'une tâche d'opération par lot.

Syntaxe de la requête

POST /?batchJobStatus&batchJobId=xx&requestedJobStatus=RequestedJobStatus&statusUpdateReason=StatusUpdateReason HTTP/1.1
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

Paramètres de requête

Name	Type	Required	Example	Description
batchJobId	string	Yes	MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=	ID de la tâche d'opération par lot. L'ID doit comporter 44 caractères et peut contenir des lettres minuscules (a-z), des lettres majuscules (A-Z) et des chiffres (0-9). L'ID ne peut pas contenir de traits d'union (-) ni de tirets bas (_). Nœud parent : Aucun Nœuds enfants : Aucun
requestedJobStatus	string	Yes	Cancelled	Statut cible de la tâche. Ce paramètre affecte le flux d'exécution de la tâche. Valeurs valides : `Cancelled` et `Ready`. Vous ne pouvez pas définir ce paramètre sur `Cancelled` si le statut actuel de la tâche est `Cancelled`, `Cancelling`, `Complete`, `Completing`, `Failed` ou `Failing`. Vous ne pouvez définir ce paramètre sur `Ready` que si le statut actuel de la tâche est `Suspended` ou `Preparing`. Nœud parent : Aucun Nœuds enfants : Aucun
statusUpdateReason	string	Optional	User requested cancellation	Motif de la mise à jour du statut. Ce champ est facultatif lorsque `requestedJobStatus` est défini sur `Ready`. Le motif doit comporter entre 1 et 256 caractères. Nœud parent : Aucun Nœuds enfants : Aucun

En-têtes de requête

Cette opération utilise uniquement des en-têtes de requête communs. Pour plus d'informations, consultez la section En-têtes de requête communs.

Éléments de réponse

Name	Type	Example	Description
UpdateJobStatusResult	Container	None	Nœud racine de la réponse. Nœud parent : Aucun Nœuds enfants : JobId, Status et StatusUpdateReason
JobId	string	MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=	ID de la tâche. Nœud parent : UpdateJobStatusResult Nœuds enfants : Aucun
Status	string	Cancelling	Statut mis à jour de la tâche. Nœud parent : UpdateJobStatusResult Nœuds enfants : Aucun
StatusUpdateReason	string	User requested cancellation	Motif de la mise à jour du statut. Nœud parent : UpdateJobStatusResult Nœuds enfants : Aucun

En-têtes de réponse

Cette opération utilise uniquement des en-têtes de réponse communs. Pour plus d'informations, consultez la section En-têtes de réponse communs.

Exemples

Exemple de requête

POST /?batchJobStatus&batchJobId=MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=&requestedJobStatus=Cancelled&statusUpdateReason=User%20requested%20cancellation HTTP/1.1
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: OSS LTAI4Fw2Nb3o4f5a3a1f****:2s98lj9n796c9kdc6b5f4l5b****

Exemple de réponse

HTTP/1.1 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<UpdateJobStatusResult>
   <JobId>MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=</JobId>
   <Status>Cancelling</Status>
   <StatusUpdateReason>User requested cancellation</StatusUpdateReason>
</UpdateJobStatusResult>