Crie uma tarefa para converter um bucket de armazenamento com redundância local (LRS) para armazenamento com redundância de zona (ZRS).
Observações de uso
O bucket deve estar em uma região compatível: China (Hangzhou), China (Shanghai), China (Beijing), China (Zhangjiakou), China (Ulanqab), China (Shenzhen), China (Hong Kong), Japão (Tóquio), Singapura, Indonésia (Jacarta) e Alemanha (Frankfurt).
O tipo de redundância atual do bucket é LRS.
A classe de armazenamento do bucket é Standard, Infrequent Access (IA) ou Archive. Objetos em Cold Archive ou Deep Cold Archive permanecem em LRS após a conversão. Não é possível converter buckets com classe de armazenamento Cold Archive ou Deep Cold Archive.
Esta tarefa exige a permissão
oss:CreateBucketDataRedundancyTransition. Conceder uma política personalizada a um usuário RAM.Consulte os mapeamentos entre regiões e endpoints em Endpoints.
Sintaxe da solicitação
POST /?redundancyTransition&x-oss-target-redundancy-type=ZRS HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValueCabeçalhos da solicitação
Esta operação utiliza apenas Cabeçalhos comuns de solicitação.
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Exemplo |
Descrição |
|
x-oss-target-redundancy-type |
String |
Sim |
ZRS |
Tipo de redundância de destino. Defina como ZRS para converter o bucket de LRS para ZRS. |
Cabeçalhos da resposta
Esta operação retorna apenas Cabeçalhos comuns de resposta.
Elementos da resposta
|
Parâmetro |
Tipo |
Exemplo |
Descrição |
|
BucketDataRedundancyTransition |
Container |
N/A |
Container da tarefa de conversão de redundância. Elemento pai: Nenhum (elemento raiz). Elemento filho: TaskId |
|
TaskId |
String |
4be5beb0f74f490186311b268bf6**** |
ID da tarefa de conversão de redundância. Use este ID para consultar ou exclua a tarefa. Elemento pai: BucketDataRedundancyTransition Elemento filho: Nenhum |
Exemplos
-
Exemplo de solicitação
POST /?redundancyTransition&x-oss-target-redundancy-type=ZRS HTTP/1.1 Host: oss-example.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 -
Exemplo de resposta
HTTP/1.1 200 x-oss-request-id: 655726F18EAD9B710C00B235 Date: Fri, 17 Nov 2023 08:40:17 GMT Content-Type: application/xml Content-Length: 151 Server: AliyunOSS <?xml version="1.0" encoding="UTF-8"?> <BucketDataRedundancyTransition> <TaskId>4be5beb0f74f490186311b268bf6****</TaskId> </BucketDataRedundancyTransition>
ossutil
Comando correspondente do ossutil: create-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. |
|
BucketDataRedundancyTransitionTaskNotSupport |
400 |
Não é possível converter o bucket. Apenas a conversão de LRS para ZRS é compatível. |
|
BucketDataRedundancyTransitionTaskAlreadyExist |
409 |
Já existe uma tarefa de conversão de redundância em execução para este bucket. |
|
BucketDataRedundancyTransitionTaskExceedLimit |
400 |
Limite máximo de tarefas de conversão de redundância atingido. Exclua as tarefas concluídas antes de crie novas. |
|
AccessDenied |
403 |
Esta operação não é compatível na região do bucket. |