Tous les produits
Search
Centre de documentation

Object Storage Service:CreateBucketDataRedundancyTransition

Dernière mise à jour :Aug 18, 2026

Créez une tâche pour convertir un bucket du stockage localement redondant (LRS) vers le stockage redondant interzones (ZRS).

Remarques d'utilisation

  • Le bucket se trouve dans une région prise en charge : Chine (Hangzhou), Chine (Shanghai), Chine (Pékin), Chine (Zhangjiakou), Chine (Ulanqab), Chine (Shenzhen), Chine (Hong Kong), Japon (Tokyo), Singapour, Indonésie (Jakarta) et Allemagne (Francfort).

  • Le type de redondance actuel du bucket est LRS.

  • La classe de stockage du bucket est Standard, Infrequent Access (IA) ou Archive. Les objets stockés en Cold Archive ou Deep Cold Archive restent en LRS après la conversion. Les buckets dont la classe de stockage est Cold Archive ou Deep Cold Archive ne peuvent pas être convertis.

  • Cette tâche nécessite l'autorisation oss:CreateBucketDataRedundancyTransition. Accorder une stratégie personnalisée à un utilisateur RAM.

  • Les mappages entre les régions et les endpoints sont répertoriés dans la section Endpoints.

Syntaxe de la requête

POST /?redundancyTransition&x-oss-target-redundancy-type=ZRS HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

En-têtes de requête

Cette opération utilise uniquement des en-têtes de requête communs.

Paramètres de requête

Paramètre

Type

Obligatoire

Exemple

Description

x-oss-target-redundancy-type

String

Oui

ZRS

Type de redondance cible. Définissez cette valeur sur ZRS pour convertir le bucket de LRS vers ZRS.

En-têtes de réponse

Cette opération renvoie uniquement des en-têtes de réponse communs.

Éléments de réponse

Paramètre

Type

Exemple

Description

BucketDataRedundancyTransition

Container

N/A

Conteneur pour la tâche de conversion de redondance.

Élément parent : Aucun (élément racine).

Élément enfant : TaskId

TaskId

String

4be5beb0f74f490186311b268bf6****

ID de la tâche de conversion de redondance. Utilisez cet ID pour interroger ou supprimer la tâche.

Élément parent : BucketDataRedundancyTransition

Élément enfant : Aucun

Exemples

  • Exemple de requête

    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
  • Exemple de réponse

    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

Commande ossutil correspondante : create-bucket-data-redundancy-transition.

Codes d'erreur

Code d'erreur

Code d'état HTTP

Description

NoSuchBucket

404

Le bucket spécifié n'existe pas.

BucketDataRedundancyTransitionTaskNotSupport

400

Le bucket ne peut pas être converti. Seule la conversion de LRS vers ZRS est prise en charge.

BucketDataRedundancyTransitionTaskAlreadyExist

409

Une tâche de conversion de redondance est déjà en cours d'exécution pour ce bucket.

BucketDataRedundancyTransitionTaskExceedLimit

400

Nombre maximal de tâches de conversion de redondance atteint. Supprimez les tâches terminées avant d'en créer de nouvelles.

AccessDenied

403

Cette opération n'est pas prise en charge dans la région du bucket.