Todos os produtos
Search
Central de documentação

Object Storage Service:GetBucketDataRedundancyTransition

Última atualização: Sep 22, 2026

Consulta uma tarefa de alteração do tipo de redundância de um bucket.

Notas de uso

  • Esta operação requer a permissão oss:GetBucketDataRedundancyTransition. Para mais informações, consulte Conceder uma política personalizada.

  • Cada região tem um endpoint do OSS correspondente. Para mais informações sobre as regiões e seus respectivos endpoints, consulte Regiões e endpoints.

Sintaxe da requisição

GET /?redundancyTransition&x-oss-redundancy-transition-taskid=xxx HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Cabeçalhos da requisição

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

Parâmetros da requisição

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

x-oss-redundancy-transition-taskid

String

Sim

751f5243f8ac4ae89f34726534d1****

ID da tarefa de alteração do tipo de redundância.

Cabeçalhos da resposta

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

Elementos da resposta

Elemento

Tipo

Exemplo

Descrição

BucketDataRedundancyTransition

Contêiner

N/A

Contêiner que armazena a tarefa de alteração do tipo de redundância.

Nó pai: nenhum

Nós filhos: TaskId, CreateTime, StartTime, EndTime, Status, EstimatedRemainingTime e ProcessPercentage

TaskId

String

909c6c818dd041d1a44e0fdc66aa****

ID da tarefa.

Nó pai: BucketDataRedundancyTransition

Nós filhos: nenhum

CreateTime

String

2023-11-17T09:14:39.000Z

Horário de criação da tarefa.

Nó pai: BucketDataRedundancyTransition

Nós filhos: nenhum

StartTime

String

2023-11-17T09:14:39.000Z

Horário de execução da tarefa. Disponível quando a tarefa está no estado Processing ou Finished.

Nó pai: BucketDataRedundancyTransition

Nós filhos: nenhum

EndTime

String

N/A

Horário de conclusão da tarefa. Disponível quando a tarefa está no estado Finished.

Nó pai: BucketDataRedundancyTransition

Nós filhos: nenhum

Status

String

Processing

Estado da tarefa. Valores válidos:

  • Queueing

  • Processing

  • Finished

Nó pai: BucketDataRedundancyTransition

Nós filhos: nenhum

EstimatedRemainingTime

Integer

100

Tempo restante estimado para a tarefa, em horas. Disponível quando a tarefa está no estado Processing ou Finished.

Nó pai: BucketDataRedundancyTransition

Nós filhos: nenhum

ProcessPercentage

Integer

0

Progresso da tarefa em porcentagem. Valores válidos: 0 a 100. Disponível quando a tarefa está no estado Processing ou Finished.

Nó pai: BucketDataRedundancyTransition

Nós filhos: nenhum

Exemplos

  • Exemplo de requisição

    GET /?redundancyTransition&x-oss-redundancy-transition-taskid=909c6c818dd041d1a44e0fdc66aa**** HTTP/1.1
    Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
    Date: Thu, 17 Apr 2025 08:40:17 GMT
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  • Exemplos de respostas

    • Exemplo de resposta para uma tarefa de alteração do tipo de redundância no estado Queueing

      HTTP/1.1 200 OK
      Server: AliyunOSS
      x-oss-request-id: 655726F18EAD9B710C0****
      Date: Fri, 17 Nov 2023 08:40:17 GMT
      Content-Type: application/xml
      Content-Length: 216
      
      <?xml version="1.0" encoding="UTF-8"?>
      <BucketDataRedundancyTransition>
        <Bucket>examplebucket</Bucket>
        <TaskId>4be5beb0f74f490186311b268bf6****</TaskId>
        <Status>Queueing</Status>
        <CreateTime>2023-11-17T09:11:58.000Z</CreateTime>
      </BucketDataRedundancyTransition>
    • Exemplo de resposta para uma tarefa de alteração do tipo de redundância no estado Processing

      HTTP/1.1 200 OK
      Server: AliyunOSS
      x-oss-request-id: 655726F18EAD9B710C00****
      Date: Fri, 17 Nov 2023 08:40:17 GMT
      Content-type: application/xml
      Content-length: 397
      
      <?xml version="1.0" encoding="UTF-8"?>
      <BucketDataRedundancyTransition>
        <Bucket>examplebucket</Bucket>
        <TaskId>909c6c818dd041d1a44e0fdc66aa****</TaskId>
        <Status>Processing</Status>
        <CreateTime>2023-11-17T09:14:39.000Z</CreateTime>
        <StartTime>2023-11-17T09:14:39.000Z</StartTime>
        <ProcessPercentage>0</ProcessPercentage>
        <EstimatedRemainingTime>100</EstimatedRemainingTime>
      </BucketDataRedundancyTransition>
    • Exemplo de resposta para uma tarefa de alteração do tipo de redundância no estado Finished

      HTTP/1.1 200 OK
      Server: AliyunOSS
      x-oss-request-id: 655726F18EAD9B710C00****
      Date: Fri, 17 Nov 2023 08:40:17 GMT
      Content-type: application/xml
      Content-length: 420
      
      <?xml version="1.0" encoding="UTF-8"?>
      <BucketDataRedundancyTransition>
        <Bucket>examplebucket</Bucket>
        <TaskId>909c6c818dd041d1a44e0fdc66aa****</TaskId>
        <Status>Finished</Status>
        <CreateTime>2023-11-17T09:14:39.000Z</CreateTime>
        <StartTime>2023-11-17T09:14:39.000Z</StartTime>
        <ProcessPercentage>100</ProcessPercentage>
        <EstimatedRemainingTime>0</EstimatedRemainingTime>
        <EndTime>2023-11-18T09:14:39.000Z</EndTime>
      </BucketDataRedundancyTransition>

ossutil

Para obter informações sobre o comando do ossutil correspondente à operação da API GetBucketDataRedundancyTransition, consulte get-bucket-data-redundancy-transition.

Códigos de erro

Código de erro

Código de status HTTP

Descrição

NoSuchBucket

404

O bucket especificado não existe.

BucketDataRedundancyTransitionTaskNotExist

404

Não há nenhuma tarefa de alteração do tipo de redundância para o bucket.