Object Storage Service:RestoreObject

Prérequis

• L'objet utilise une classe de stockage Archive, Cold Archive ou Deep Cold Archive. Pour plus d'informations, consultez Types de stockage.

• Vous disposez de l'autorisation oss:RestoreObject. Attacher une stratégie personnalisée à un utilisateur RAM.

Notes

• L'opération RestoreObject s'applique uniquement aux objets de classes de stockage Archive, Cold Archive et Deep Cold Archive. Elle ne s'applique pas aux objets Standard ou Infrequent Access (IA).

• Lors du premier appel de l'opération RestoreObject pour un objet, une réponse 202 Accepted est renvoyée. Si l'objet est déjà dans un état restauré, les appels suivants renvoient une réponse 200 OK.

• Vous ne pouvez pas appeler l'opération RestoreObject sur un objet en cours de restauration. Une telle tentative renvoie une erreur 409 Conflict. Attendez la fin de la restauration avant de rappeler l'opération.

• Pour un bucket avec versioning activé, différentes versions d'un objet peuvent avoir des classes de stockage distinctes. Par défaut, l'appel de l'opération RestoreObject restaure la version actuelle de l'objet. Vous pouvez restaurer une version spécifique en spécifiant son versionId.

Processus de restauration

Le processus de restauration est identique quelle que soit la classe de stockage de l'objet. Il se déroule comme suit.

1. Initialement, l'objet se trouve dans un état gelé (frozen).

2. Après soumission d'une demande de restauration, l'objet passe à l'état de restauration (restoring).

3. Une fois la tâche côté serveur terminée, l'objet passe à l'état restauré (restored). Vous pouvez alors lire l'objet.

4. Si vous soumettez une nouvelle demande de restauration tandis que l'objet est déjà restauré, la durée de l'état restauré est prolongée. La durée totale prolongée ne peut pas dépasser la durée maximale autorisée pour la classe de stockage concernée.

5. À la fin de l'état restauré, l'objet revient à l'état gelé.

Délai de restauration

Le tableau suivant indique les délais de restauration selon la classe de stockage des objets. Les durées réelles peuvent varier.

^①Pour un seul compte Alibaba Cloud dans une seule région, le taux de récupération des données estimé pour les objets Cold Archive est en moyenne de 500 objets par seconde. Le volume total de récupération, toutes priorités de restauration confondues, est de 100 à 120 To par jour. Si votre activité nécessite un taux de récupération plus élevé, contactez le support technique.

^②Pour un seul compte Alibaba Cloud dans une seule région, le taux de récupération des données estimé pour les objets Deep Cold Archive est en moyenne de 100 objets par seconde. Le volume total de récupération, toutes priorités de restauration confondues, est de 10 à 15 To par jour. Si votre activité nécessite un taux de récupération plus élevé, contactez le support technique.

Durée de l'état restauré

La durée pendant laquelle les objets peuvent rester dans l'état restauré varie selon la classe de stockage.

Facturation

• Des frais de récupération de données sont appliqués lors de la restauration d'objets de classes de stockage Archive, Cold Archive et Deep Cold Archive. Pour plus d'informations, consultez Frais de traitement des données.

• Les objets Archive peuvent rester dans l'état restauré jusqu'à 7 jours. Les objets Cold Archive et Deep Cold Archive peuvent y rester jusqu'à 365 jours. Aucun frais supplémentaire de récupération de données n'est facturé durant cette période.

• À la fin de l'état restauré, l'objet revient à l'état gelé. Si vous restaurez à nouveau l'objet, des frais de récupération de données seront appliqués.

• Lorsque vous restaurez un objet Cold Archive ou Deep Cold Archive, une réplique de l'objet est créée dans la classe de stockage Standard pour permettre l'accès. Tant que l'objet est dans l'état restauré, vous êtes facturé pour le stockage temporaire de cette réplique au tarif de la classe de stockage Standard. Pour plus d'informations, consultez Frais de stockage temporaire.

Syntaxe de la requête

POST /ObjectName?restore HTTP/1.1
Host: archive-bucket.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

En-têtes de requête

RestoreObject utilise uniquement les en-têtes de requête communs. Pour plus d'informations, consultez En-têtes de requête communs.

Paramètres de requête

En-têtes de réponse

Les réponses RestoreObject incluent les en-têtes de réponse communs. Pour plus d'informations, consultez En-têtes de réponse communs.

Exemples

• Restaurer un objet Archive gelé (première requête)

  Exemple de requête

  POST /oss.jpg?restore HTTP/1.1
  Host: oss-archive-example.oss-cn-hangzhou.aliyuncs.com
  Date: Sat, 15 Apr 2017 07:45:28 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

  Exemple de réponse réussie

  HTTP/1.1 202 Accepted
  Date: Sat, 15 Apr 2017 07:45:28 GMT
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS
  x-oss-request-id: 5374A2880232A65C23002D74

• Restaurer un objet Archive en cours de restauration

  Exemple de requête

  POST /oss.jpg?restore HTTP/1.1
  Host: oss-archive-example.oss-cn-hangzhou.aliyuncs.com
  Date: Sat, 15 Apr 2017 07:45:29 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

  Exemple de réponse réussie

  HTTP/1.1 409 Conflict
  Date: Sat, 15 Apr 2017 07:45:29 GMT
  Content-Length: 556
  Connection: keep-alive
  Server: AliyunOSS
  x-oss-request-id: 5374A2880232A65C23002D74
  <?xml version="1.0" encoding="UTF-8"?>
  <Error>
    <Code>RestoreAlreadyInProgress</Code>
    <Message>The restore operation is in progress.</Message>
    <RequestId>58EAF141461FB42C2B000008</RequestId>
    <HostId>10.101.XX.XX</HostId>
  </Error>

• Restaurer un objet Archive déjà dans l'état restauré

  Exemple de requête

  POST /oss.jpg?restore HTTP/1.1
  Host: oss-archive-example.oss-cn-hangzhou.aliyuncs.com
  Date: Sat, 15 Apr 2017 07:45:29 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  <RestoreRequest>
    <Days>2</Days>
  </RestoreRequest>

  Exemple de réponse réussie

  HTTP/1.1 200 Ok
  Date: Sat, 15 Apr 2017 07:45:30 GMT
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS
  x-oss-request-id: 5374A2880232A65C23002D74

• Restaurer un objet Cold Archive ou Deep Cold Archive déjà dans l'état restauré

  Exemple de requête

  POST /coldarchiveobject?restore HTTP/1.1
  Host: cold-archive-bucket.oss-cn-hangzhou.aliyuncs.com
  User-Agent: aliyun-sdk-go/v2.1.0 (Darwin/17.5.0/x86_64;go1.11.8)/ossutil-v1.6.12
  Content-Length: 99
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  Content-Type: text/plain; charset=utf-8
  Date: Tue, 21 Apr 2020 11:09:19 GMT
  Accept-Encoding: gzip
  <RestoreRequest>
    <Days>2</Days>
    <JobParameters>
      <Tier>Standard</Tier>
    </JobParameters>
  </RestoreRequest>

  Exemple de réponse réussie

  HTTP/1.1 200 OK
  Server: AliyunOSS
  Date: Tue, 21 Apr 2020 11:09:19 GMT
  Content-Length: 0
  Connection: keep-alive
  x-oss-request-id: 5E9ED45F093E2F3930318EA0
  x-oss-object-restore-priority: Standard
  x-oss-server-time: 10

• Restaurer une version spécifique d'un objet

  Exemple de requête

  POST /oss.jpg?restore&versionId=CAEQNRiBgMClj7qD0BYiIDQ5Y2QyMjc3NGZkODRlMTU5M2VkY2U3MWRiNGRh**** HTTP/1.1
  Host: oss-archive-example.oss-cn-hangzhou.aliyuncs.com
  Date: Tue, 09 Apr 2019 06:50:48 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

  Exemple de réponse réussie

  HTTP/1.1 202 Accepted
  Date: Tue, 09 Apr 2019 06:50:48 GMT
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS
  x-oss-version-id: CAEQNRiBgMClj7qD0BYiIDQ5Y2QyMjc3NGZkODRlMTU5M2VkY2U3MWRiNGRh****
  x-oss-request-id: 5CAC40C8B7AEADE017000653

Kits SDK OSS

Appelez RestoreObject avec les kits SDK OSS pour les langages suivants :

• Java

• Python V2

• PHP V2

• Go V2

• C

• C++

• .NET

• Android

• iOS

• Node.js

• Harmony

• Browser.js

ossutil

Pour obtenir des informations sur la commande ossutil correspondant à l'opération RestoreObject, consultez restore-object.

Codes d'erreur

Références

• Pour plus d'informations sur le temps nécessaire à la restauration et sur le nombre de jours pendant lesquels un objet reste dans l'état restauré, consultez Restaurer des objets.

• Pour savoir comment utiliser ossutil afin de restaurer un objet, consultez Restaurer des fichiers.

• Pour conserver définitivement un objet dans l'état restauré, consultez Comment conserver un objet OSS restauré de façon permanente ?