DescribeJob - Object Storage Service - Centre de documentation Alibaba Cloud

Autorisations

Par défaut, un compte Alibaba Cloud dispose de toutes les autorisations. Les utilisateurs RAM et les rôles RAM ne disposent d'aucune autorisation par défaut. Le compte Alibaba Cloud ou un administrateur doit accorder les autorisations via une politique RAM ou une politique de bucket.

API

Action

Description

DescribeJob

oss:DescribeJob

Consulte les détails d'une tâche d'opération par lot.

Syntaxe de la requête

GET /?batchJob&batchJobId=xxx HTTP/1.1
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

Paramètres de requête

Nom

Type

Obligatoire

Exemple

Description

batchJobId

String

Oui

MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=

ID de la tâche d'opération par lot. L'ID compte 44 caractères alphanumériques. Il ne contient ni tirets (-) ni traits de soulignement (_).

Nœud enfant : Aucun

Nœud parent : 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 les En-têtes de requête communs.

Éléments de réponse

Nom	Type	Exemple	Description
DescribeJobResult	Container	Aucun	Nœud racine de la réponse. Nœud enfant : Job Nœud parent : Aucun
Job	Container	Aucun	Conteneur regroupant les détails de la tâche. Nœuds enfants : ConfirmationRequired, CreationTime, FailureReasons, JobId, Operation, Report, Manifest, Description, Priority, RoleArn, StatusUpdateReason, KeyPrefixManifestGenerator, ProgressSummary, Status et TerminationDate Nœud parent : DescribeJobResult
ConfirmationRequired	Boolean	false	Indique si la tâche nécessite une confirmation avant son exécution. Nœud enfant : Aucun Nœud parent : Job
CreationTime	Timestamp	1749983400	Date et heure de création de la tâche. Nœud enfant : Aucun Nœud parent : Job
FailureReasons	Container	Aucun	Motif de l'échec de la tâche. Ce nœud est renvoyé même en cas de succès de la tâche. Dans ce cas, le nœud enfant JobFailure est vide. Une erreur sur une opération unique n'entraîne pas l'échec de la tâche globale. Nœud enfant : JobFailure Nœud parent : Job
JobFailure	Container	Aucun	Détails relatifs à l'échec de la tâche. Nœuds enfants : FailureCode et FailureReason Nœud parent : FailureReasons
FailureCode	String	InternalError	Code d'erreur. Nœud enfant : Aucun Nœud parent : JobFailure
FailureReason	String	Internal service error	Message d'erreur. Nœud enfant : Aucun Nœud parent : JobFailure
JobId	String	MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=	ID de tâche généré par OSS. Nœud enfant : Aucun Nœud parent : Job
Operation	Container	Aucun	Détails de l'opération à effectuer. Nœud enfant : RestoreObject Nœud parent : Job
RestoreObject	Container	Aucun	Détails de l'opération de restauration des objets Archive. Nœuds enfants : Days et Tier Nœud parent : Operation
Days	Integer	7	Nombre de jours pendant lesquels l'objet restauré reste accessible. Nœud enfant : Aucun Nœud parent : RestoreObject
Tier	String	Standard	Priorité de restauration Nœud enfant : Aucun Nœud parent : RestoreObject
Report	Container	Aucun	Configuration du rapport. Nœuds enfants : Bucket, Enabled, Prefix et ReportScope Nœud parent : Job
Bucket	String	report-bucket	Bucket dans lequel le rapport est stocké. Nœud enfant : Aucun Nœud parent : Report
Enabled	Boolean	true	Indique si un rapport est généré. Nœud enfant : Aucun Nœud parent : Report
Prefix	String	reports/	Préfixe du rapport. Nœud enfant : Aucun Nœud parent : Report
ReportScope	String	AllTasks	Portée du rapport. Nœud enfant : Aucun Nœud parent : Report
Manifest	Container	Aucun	Informations relatives au manifeste. Spécifiez ce paramètre ou KeyPrefixManifestGenerator, mais pas les deux simultanément. Nœuds enfants : Location et Spec Nœud parent : Job
Location	Container	Aucun	Emplacement du manifeste. Le bucket contenant le fichier manifeste doit se trouver dans la même région que la tâche d'opération par lot. Nœuds enfants : Bucket, ETag, Object et VersionId Nœud parent : Manifest
Bucket	String	manifest-bucket	Bucket dans lequel le fichier manifeste est stocké. Nœud enfant : Aucun Nœud parent : Location
ETag	String	d41d8cd98f00b204e9800998ecf8427e	ETag du fichier manifeste. Nœud enfant : Aucun Nœud parent : Location
Object	String	manifest.csv	Objet correspondant au fichier manifeste. Nœud enfant : Aucun Nœud parent : Location
VersionId	String	3/L4kqtJlcpXroDTDmJ+rmSpXd3dIbrHY+MTRCxf3vjVBH40Nr8X8gdRQBpUMLUo	ID de version de l'objet correspondant au fichier manifeste. Nœud enfant : Aucun Nœud parent : Location
Spec	Container	Aucun	Description du format du manifeste. Nœuds enfants : Fields et Format Nœud parent : Manifest
Fields	String	Bucket,Key	Champs présents dans le manifeste. Nœud enfant : Aucun Nœud parent : Spec
Format	String	OSS_BatchOperations_CSV_20250611	Format indiquant que la sortie provient d'un rapport d'inventaire. Nœud enfant : Aucun Nœud parent : Spec
Description	String	Batch restore archive objects job	Description de la tâche. Nœud enfant : Aucun Nœud parent : Job
Priority	Integer	10	Priorité de la tâche. Nœud enfant : Aucun Nœud parent : Job
RoleArn	String	arn:acs:ram::uid:role/BatchOperationRole	Rôle IAM Nœud enfant : Aucun Nœud parent : Job
StatusUpdateReason	String	Task completed successfully	Motif de la mise à jour du statut. Nœud enfant : Aucun Nœud parent : Job
KeyPrefixManifestGenerator	Container	Aucun	Configuration de génération automatique du manifeste. Spécifiez ce paramètre ou Manifest, mais pas les deux simultanément. Nœuds enfants : SourceBucket et Prefix Nœud parent : Job
SourceBucket	String	source-bucket	Bucket source. Nœud enfant : Aucun Nœud parent : KeyPrefixManifestGenerator
Prefix	String	data/	Préfixe. Nœud enfant : Aucun Nœud parent : KeyPrefixManifestGenerator
ProgressSummary	Container	Aucun	Résumé de la progression de la tâche. Nœuds enfants : NumberOfTasksFailed, NumberOfTasksSucceeded, Timers et TotalNumberOfTasks Nœud parent : Job
NumberOfTasksFailed	Long	0	Nombre de tâches ayant échoué. Nœud enfant : Aucun Nœud parent : ProgressSummary
NumberOfTasksSucceeded	Long	1000	Nombre de tâches réussies. Nœud enfant : Aucun Nœud parent : ProgressSummary
Timers	Container	Aucun	Informations relatives au temps d'exécution. Nœud enfant : ElapsedTimeInActiveSeconds Nœud parent : ProgressSummary
ElapsedTimeInActiveSeconds	Long	3600	Temps écoulé pour la tâche, en secondes. Nœud enfant : Aucun Nœud parent : Timers
TotalNumberOfTasks	Long	1000	Nombre total de tâches. Nœud enfant : Aucun Nœud parent : ProgressSummary
Status	String	Complete	Statut actuel de la tâche. Valeurs possibles : New : La tâche vient d'être créée et n'est pas encore en cours de préparation. Preparing : Le système analyse le fichier manifeste, authentifie les autorisations et initialise les ressources d'exécution. Ready : La tâche est prête et attend d'être planifiée pour exécution. Suspended : La tâche nécessite une confirmation explicite de l'utilisateur pour continuer. Cela se produit si vous avez défini ConfirmationRequired sur true lors de la création de la tâche. Active : La tâche traite les objets. Vous pouvez consulter la progression en temps réel dans ProgressSummary. Pausing : Le système met la tâche en pause. La pause s'applique uniquement à cette tâche. Paused : La tâche est en pause. Le service OSS reprend automatiquement la tâche. Completing : Tous les objets ont été traités. Le système génère un rapport d'exécution et nettoie les ressources. Complete : La tâche est terminée avec succès. Il s'agit d'un état final. Cancelling : Le système annule la tâche. Cancelled : La tâche a été annulée par l'utilisateur. Il s'agit d'un état final. Failing : La tâche a rencontré une erreur critique et le système termine son exécution. Failed : La tâche est terminée en raison d'une erreur au niveau du système. Pour plus d'informations, consultez le champ FailureReasons. Il s'agit d'un état final. Nœud enfant : Aucun Nœud parent : Job
TerminationDate	Timestamp	1749987000	Date et heure de fin de la tâche. Nœud enfant : Aucun Nœud parent : Job

En-têtes de réponse

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

Exemples

Exemple de requête

GET /?batchJob&batchJobId=MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU= HTTP/1.1
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

Exemple de réponse

HTTP/1.1 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<DescribeJobResult>
  <Job>
    <ConfirmationRequired>false</ConfirmationRequired>
    <CreationTime>1749983400</CreationTime>
    <JobId>MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=</JobId>
    <Operation>
      <RestoreObject>
        <Days>7</Days>
        <Tier>Standard</Tier>
      </RestoreObject>
    </Operation>
    <Report>
      <Bucket>report-bucket</Bucket>
      <Enabled>true</Enabled>
      <Prefix>reports/</Prefix>
      <ReportScope>AllTasks</ReportScope>
    </Report>
    <Manifest>
      <Location>
        <ETag>d41d8cd98f00b204e9800998ecf8427e</ETag>
        <Bucket>manifest-bucket</Bucket>
        <Object>manifest.csv</Object>
        <VersionId>3/L4kqtJlcpXroDTDmJ+rmSpXd3dIbrHY+MTRCxf3vjVBH40Nr8X8gdRQBpUMLUo</VersionId>
      </Location>
      <Spec>
        <Fields>Bucket,Key</Fields>
        <Format>OSS_BatchOperations_CSV_20250611</Format>
      </Spec>
    </Manifest>
    <Description>Batch restore archive objects job</Description>
    <Priority>10</Priority>
    <RoleArn>arn:acs:ram::uid:role/BatchOperationRole</RoleArn>
    <StatusUpdateReason>Task completed successfully</StatusUpdateReason>
    <ProgressSummary>
      <NumberOfTasksFailed>0</NumberOfTasksFailed>
      <NumberOfTasksSucceeded>1000</NumberOfTasksSucceeded>
      <Timers>
        <ElapsedTimeInActiveSeconds>3600</ElapsedTimeInActiveSeconds>
      </Timers>
      <TotalNumberOfTasks>1000</TotalNumberOfTasks>
    </ProgressSummary>
    <Status>Complete</Status>
    <TerminationDate>1749987000</TerminationDate>
  </Job>
</DescribeJobResult>