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

Permissões

Por padrão, uma conta Alibaba Cloud possui todas as permissões. No entanto, um usuário RAM ou uma função RAM não possui nenhuma permissão. A conta Alibaba Cloud ou um administrador deve conceder permissões ao usuário RAM ou à função RAM por meio de uma política de RAM ou de uma política de bucket.

API	Action	Descrição
ListJobs	`oss:ListJobs`	Consulta jobs de operação em lote.

Sintaxe da solicitação

GET /?batchJob&batchJobStatuses=JobStatuses&max-keys=MaxKeys&continuation-token=ContinuationToken HTTP/1.1
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

Parâmetros da solicitação

Nome	Tipo	Obrigatório	Exemplo	Descrição
batchJobStatuses	String	Não	Complete	A condição de filtro para o status do job. Se não for especificada, jobs em todos os estados são retornados. Valores válidos: Active, Cancelled, Cancelling, Complete, Completing, Failed, Failing, New, Paused, Pausing, Preparing, Ready e Suspended. Você pode especificar vários valores, como Active \| Cancelled \| Cancelling. Nó pai: None
max-keys	Integer	Não	100	O número máximo de jobs a retornar por página. Valores válidos: 1 a 1000. Valor padrão: 100. Nó pai: None
continuation-token	String	Não	next-page-token-123	O token de paginação. Se uma resposta não incluir todos os resultados, o servidor retorna NextToken. Passe esse valor como continuation-token na próxima solicitação para obter os resultados restantes. O token pode ter de 1 a 1.024 caracteres e pode conter letras maiúsculas (A-Z), letras minúsculas (a-z), dígitos (0-9) e os seguintes caracteres especiais: +, :, /, =, ?, #, - e _. Nó pai: None

Cabeçalhos da solicitação

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

Elementos da resposta

Nome	Tipo	Exemplo	Descrição
ListJobsResult	Container	None	O nó raiz da resposta. Nó pai: None Nós filhos: NextToken e Jobs
NextToken	String	next-page-token-456	O token para a próxima página. Se a resposta não incluir todos os resultados, passe esse valor como continuation-token na próxima solicitação para obter os resultados restantes. Nó pai: ListJobsResult
Jobs	Container	None	O contêiner da lista de jobs. Nó pai: ListJobsResult Nó filho: JobListDescriptor
JobListDescriptor	Container	None	A descrição do job. Nó pai: Jobs Nós filhos: CreationTime, Description, JobId, Operation, Priority, ProgressSummary, Status e TerminationDate
CreationTime	Timestamp	1749983400	O momento em que o job foi criado. Nó pai: JobListDescriptor
Description	String	Batch job for setting object tags	A descrição do job. Nó pai: JobListDescriptor
JobId	String	MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=	O ID do job. Nó pai: JobListDescriptor
Operation	String	PutObjectTagging	A operação que o job executa. Nó pai: JobListDescriptor
Priority	Integer	10	A prioridade do job. Nó pai: JobListDescriptor
ProgressSummary	Container	None	O resumo do progresso atual do job. Nó pai: JobListDescriptor Nós filhos: NumberOfTasksFailed, NumberOfTasksSucceeded, Timers e TotalNumberOfTasks
NumberOfTasksFailed	Long	0	O número de tarefas com falha. Nó pai: ProgressSummary
NumberOfTasksSucceeded	Long	1000	O número de tarefas bem-sucedidas. Nó pai: ProgressSummary
Timers	Container	None	As informações sobre o tempo de execução. Nó pai: ProgressSummary Nó filho: ElapsedTimeInActiveSeconds
ElapsedTimeInActiveSeconds	Long	3600	O tempo de execução em segundos. Nó pai: Timers
TotalNumberOfTasks	Long	1000	O número total de tarefas. Nó pai: ProgressSummary
Status	String	Complete	O estado de execução atual. Valores válidos: New: O job foi recém-criado e ainda não iniciou as preparações. Preparing: O sistema está analisando o arquivo de manifesto, autenticando permissões e inicializando recursos. Ready: O job concluiu as preparações e aguarda o agendamento e a execução pelo sistema. Suspended: O job requer confirmação explícita do usuário para continuar. Isso ocorre quando ConfirmationRequired é definido como true durante a criação do job. Active: O job está processando objetos em lote. Você pode acompanhar o progresso em tempo real em ProgressSummary. Pausing: O sistema está pausando o job. Aplica-se apenas a este job. Paused: O job está pausado. O serviço OSS retoma o job automaticamente. Completing: Todos os objetos foram processados. O sistema está gerando o relatório de execução e limpando recursos. Complete: O job foi concluído com sucesso. Este é um estado desejado. Cancelling: O sistema está cancelando o job. Cancelled: O job foi cancelado pelo usuário. Este é um estado desejado. Failing: O job encontrou um erro crítico e o sistema está interrompendo sua execução. Failed: O job foi interrompido devido a um erro no nível do sistema. Para mais informações sobre a causa, consulte o campo FailureReasons. Este é um estado desejado. Nó pai: JobListDescriptor
TerminationDate	Timestamp	1749987000	O momento em que o job foi interrompido. Nó pai: JobListDescriptor

Cabeçalhos da resposta

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

Exemplos

Exemplo de solicitação

GET /?batchJob&batchJobStatuses=Complete&max-keys=10&continuation-token=next-page-token-123 HTTP/1.1
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

Exemplo de resposta

HTTP/1.1 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<ListJobsResult>
   <NextToken>next-page-token-456</NextToken>
   <Jobs>
      <JobListDescriptor>
         <CreationTime>1749983400</CreationTime>
         <Description>Batch job for setting object tags</Description>
         <JobId>MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=</JobId>
         <Operation>PutObjectTagging</Operation>
         <Priority>10</Priority>
         <ProgressSummary>
            <NumberOfTasksFailed>0</NumberOfTasksFailed>
            <NumberOfTasksSucceeded>1000</NumberOfTasksSucceeded>
            <Timers>
               <ElapsedTimeInActiveSeconds>3600</ElapsedTimeInActiveSeconds>
            </Timers>
            <TotalNumberOfTasks>1000</TotalNumberOfTasks>
         </ProgressSummary>
         <Status>Complete</Status>
         <TerminationDate>1749987000</TerminationDate>
      </JobListDescriptor>
   </Jobs>
</ListJobsResult>

Interface de linha de comando ossutil

Para o comando ossutil correspondente à operação ListJobs, consulte list-jobs.