DescribeJob - Object Storage Service: Central de Documentação do Alibaba Cloud

Chame a operação DescribeJob para consultar os detalhes e o status de execução de um job de operação em lote específico.

Permissões

Uma conta Alibaba Cloud possui todas as permissões por padrão. Usuários do Resource Access Management (RAM) e funções RAM não têm permissões por padrão. A conta Alibaba Cloud ou um administrador deve conceder permissões usando uma RAM policy ou uma bucket policy.

API	Action	Descrição
DescribeJob	`oss:DescribeJob`	Consulta os detalhes de um job de operação em lote.

Sintaxe da solicitação

Parâmetros da solicitação

Nome

Tipo

Obrigatório

Exemplo

Descrição

batchJobId

String

Sim

MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=

O ID do job de operação em lote. O ID tem 44 caracteres e contém letras e dígitos. Não contém hifens (-) ou sublinhados (_).

Nó filho: Nenhum

Nó pai: Nenhum

Cabeçalhos da solicitação

Esta operação utiliza apenas cabeçalhos de solicitação comuns. Para mais informações, consulte Common request headers.

Elementos da resposta

Nome	Tipo	Exemplo	Descrição
DescribeJobResult	Container	Nenhum	O nó raiz da resposta. Nó filho: Job Nó pai: Nenhum
Job	Container	Nenhum	O container para os detalhes do job. Nós filhos: ConfirmationRequired, CreationTime, FailureReasons, JobId, Operation, Report, Manifest, Description, Priority, RoleArn, StatusUpdateReason, KeyPrefixManifestGenerator, ProgressSummary, Status e TerminationDate Nó pai: DescribeJobResult
ConfirmationRequired	Boolean	false	Indica se o job requer confirmação antes da execução. Nó filho: Nenhum Nó pai: Job
CreationTime	Timestamp	1749983400	A hora em que o job foi criado. Nó filho: Nenhum Nó pai: Job
FailureReasons	Container	Nenhum	O motivo da falha do job. Este nó é retornado mesmo se o job for bem-sucedido. Nesse caso, o nó filho JobFailure está vazio. Um erro em uma única operação não causa a falha do job. Nó filho: JobFailure Nó pai: Job
JobFailure	Container	Nenhum	Os detalhes sobre a falha do job. Nós filhos: FailureCode e FailureReason Nó pai: FailureReasons
FailureCode	String	InternalError	O código de erro. Nó filho: Nenhum Nó pai: JobFailure
FailureReason	String	Internal service error	A mensagem de erro. Nó filho: Nenhum Nó pai: JobFailure
JobId	String	MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=	O ID de job que o OSS gera para o job. Nó filho: Nenhum Nó pai: Job
Operation	Container	Nenhum	Os detalhes sobre a operação a ser executada. Nó filho: RestoreObject Nó pai: Job
RestoreObject	Container	Nenhum	Os detalhes sobre a operação para restaurar objetos Archive. Nós filhos: Days e Tier Nó pai: Operation
Days	Integer	7	O número de dias durante os quais o objeto restaurado permanece acessível. Nó filho: Nenhum Nó pai: RestoreObject
Tier	String	Standard	Prioridade de restauração Nó filho: Nenhum Nó pai: RestoreObject
Report	Container	Nenhum	A configuração do relatório. Nós filhos: Bucket, Enabled, Prefix e ReportScope Nó pai: Job
Bucket	String	report-bucket	O bucket onde o relatório é armazenado. Nó filho: Nenhum Nó pai: Report
Enabled	Boolean	true	Indica se um relatório é gerado. Nó filho: Nenhum Nó pai: Report
Prefix	String	reports/	O prefixo do relatório. Nó filho: Nenhum Nó pai: Report
ReportScope	String	AllTasks	O escopo do relatório. Nó filho: Nenhum Nó pai: Report
Manifest	Container	Nenhum	As informações do manifesto. Especifique este parâmetro ou KeyPrefixManifestGenerator. Nós filhos: Location e Spec Nó pai: Job
Location	Container	Nenhum	A localização do manifesto. O bucket que armazena o arquivo de manifesto deve estar na mesma região do job de operação em lote. Nós filhos: Bucket, ETag, Object e VersionId Nó pai: Manifest
Bucket	String	manifest-bucket	O bucket onde o arquivo de manifesto é armazenado. Nó filho: Nenhum Nó pai: Location
ETag	String	d41d8cd98f00b204e9800998ecf8427e	O ETag do arquivo de manifesto. Nó filho: Nenhum Nó pai: Location
Object	String	manifest.csv	O objeto correspondente ao arquivo de manifesto. Nó filho: Nenhum Nó pai: Location
VersionId	String	3/L4kqtJlcpXroDTDmJ+rmSpXd3dIbrHY+MTRCxf3vjVBH40Nr8X8gdRQBpUMLUo	O ID de versão do objeto correspondente ao arquivo de manifesto. Nó filho: Nenhum Nó pai: Location
Spec	Container	Nenhum	A descrição do formato do manifesto. Nós filhos: Fields e Format Nó pai: Manifest
Fields	String	Bucket,Key	Os campos no manifesto. Nó filho: Nenhum Nó pai: Spec
Format	String	OSS_BatchOperations_CSV_20250611	O formato. Indica que a saída é de um relatório de inventário. Nó filho: Nenhum Nó pai: Spec
Description	String	Batch restore archive objects job	A descrição do job. Nó filho: Nenhum Nó pai: Job
Priority	Integer	10	A prioridade do job. Nó filho: Nenhum Nó pai: Job
RoleArn	String	arn:acs:ram::uid:role/BatchOperationRole	Função IAM Nó filho: Nenhum Nó pai: Job
StatusUpdateReason	String	Task completed successfully	O motivo da atualização de status. Nó filho: Nenhum Nó pai: Job
KeyPrefixManifestGenerator	Container	Nenhum	A configuração para gerar automaticamente um manifesto. Especifique este parâmetro ou Manifest. Nós filhos: SourceBucket e Prefix Nó pai: Job
SourceBucket	String	source-bucket	O bucket de source. Nó filho: Nenhum Nó pai: KeyPrefixManifestGenerator
Prefix	String	data/	O prefixo. Nó filho: Nenhum Nó pai: KeyPrefixManifestGenerator
ProgressSummary	Container	Nenhum	O resumo do progresso do job. Nós filhos: NumberOfTasksFailed, NumberOfTasksSucceeded, Timers e TotalNumberOfTasks Nó pai: Job
NumberOfTasksFailed	Long	0	O número de tarefas que falharam. Nó filho: Nenhum Nó pai: ProgressSummary
NumberOfTasksSucceeded	Long	1000	O número de tarefas bem-sucedidas. Nó filho: Nenhum Nó pai: ProgressSummary
Timers	Container	Nenhum	As informações sobre o tempo de execução. Nó filho: ElapsedTimeInActiveSeconds Nó pai: ProgressSummary
ElapsedTimeInActiveSeconds	Long	3600	O tempo decorrido do job, em segundos. Nó filho: Nenhum Nó pai: Timers
TotalNumberOfTasks	Long	1000	O número total de tarefas. Nó filho: Nenhum Nó pai: ProgressSummary
Status	String	Complete	O status atual do job. Valores válidos: New: O job foi recém-criado e ainda não está sendo preparado. Preparing: O sistema está analisando o arquivo de manifesto, autenticando permissões e inicializando recursos de execução. Ready: O job está preparado e aguardando agendamento para execução. Suspended: O job requer confirmação explícita do usuário para prosseguir. Isso ocorre se você definir ConfirmationRequired como true ao criar o job. Active: O job está processando objetos. Visualize o progresso em tempo real em ProgressSummary. Pausing: O sistema está pausando o job. A pausa aplica-se apenas a este job. Paused: O job está pausado. O service OSS retoma o job automaticamente. Completing: Todos os objetos foram processados. O sistema está gerando um relatório de execução e limpando recursos. Complete: O job foi concluído com sucesso. Este é um estado final. Cancelling: O sistema está cancelando o job. Cancelled: O job foi cancelado pelo usuário. Este é um estado final. Failing: O job encontrou um erro crítico e o sistema está encerrando sua execução. Failed: O job foi encerrado devido a um erro no nível do sistema. Para mais informações, consulte o campo FailureReasons. Este é um estado final. Nó filho: Nenhum Nó pai: Job
TerminationDate	Timestamp	1749987000	A hora em que o job terminou. Nó filho: Nenhum Nó pai: Job

Cabeçalhos da resposta

Esta operação utiliza apenas cabeçalhos de resposta comuns. Para mais informações, consulte Common response headers.

Exemplos

Exemplo de solicitação
Exemplo de resposta

Comando ossutil

Para o comando ossutil correspondente à operação DescribeJob, consulte describe-job.