Object Storage Service:restore-object

Notes d'utilisation

• Par défaut, un compte Alibaba Cloud dispose des autorisations nécessaires pour restaurer des objets. Pour restaurer des objets en tant qu'utilisateur RAM ou via Security Token Service (STS), l'autorisation oss:RestoreObject est requise. Pour plus d'informations, consultez la rubrique Accorder une stratégie personnalisée.

• La commande restore-object s'applique uniquement aux objets Archive ou Cold Archive. Elle ne concerne pas les objets Standard ni les objets Infrequent Access (IA).

• Pour lire un objet Archive ou Cold Archive, vous devez au préalable le restaurer. La restauration d'un objet Archive prend quelques minutes, tandis que celle d'un objet Cold Archive nécessite plusieurs heures.

Facturation

La restauration d'objets engendre des frais de stockage, des frais de récupération de données et des frais d'appel d'API. De plus, des frais de stockage temporaire s'appliquent lors de la restauration d'objets Cold Archive et Deep Cold Archive.

• Frais de stockage : vous êtes facturé selon les règles de facturation applicables aux classes de stockage Archive, Cold Archive et Deep Cold Archive, pendant et après la restauration. Pour en savoir plus, consultez la section Frais de stockage.

• Des frais de récupération de données sont appliqués en fonction de la taille des objets Archive, Cold Archive ou Deep Cold Archive restaurés. Consultez la rubrique Frais de traitement des données pour plus de détails.

• Frais d'appel d'API :

  • Lors de la restauration d'objets Archive, vous êtes facturé en fonction du nombre de requêtes PUT. Pour plus d'informations, reportez-vous à la page Frais de requête.

  • La restauration d'objets Cold Archive ou Deep Cold Archive entraîne des frais liés aux requêtes de récupération de données. Consultez la section Frais de requête pour obtenir davantage de précisions.

• Frais de stockage temporaire : la restauration d'un objet Cold Archive ou Deep Cold Archive génère un réplica permettant un accès temporaire. Vous êtes facturé pour le stockage temporaire de ce réplica selon le tarif de la classe de stockage Standard, jusqu'à ce que l'objet Cold Archive ou Deep Cold Archive retourne à l'état figé. Pour en savoir plus, voir Frais de stockage temporaire.

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 figé.

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

3. Une fois la tâche côté serveur terminée, l'objet atteint l'état restauré. Vous pouvez alors le lire.

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

5. À l'issue de l'état restauré, l'objet revient à l'état figé.

Délai de restauration

Le tableau ci-dessous indique les délais de restauration selon la classe de stockage de l'objet. Les durées réelles peuvent varier.

^①Pour un seul compte Alibaba Cloud dans une seule région, le taux estimé de récupération des données 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, varie entre 100 To et 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 estimé de récupération des données pour les objets Deep Cold Archive est en moyenne de 100 objets par seconde. Le volume total de récupération, pour les deux priorités de restauration, varie entre 10 To et 15 To par jour. Si votre activité exige un taux de récupération supérieur, adressez-vous au support technique.

Durée de l'état restauré

La durée pendant laquelle les objets restent dans l'état restauré dépend de leur classe de stockage.

Syntaxe de la commande

ossutil api restore-object --bucket value --key value [flags]

--restore-request

L'option de configuration --restore-request accepte les formats XML et JSON. Si la valeur de l'option contient le préfixe file://, les paramètres de configuration sont lus depuis le fichier spécifié.

• Format XML :

  <RestoreRequest>
    <Days>integer</Days>
    <JobParameters>
      <Tier>string</Tier>
    </JobParameters>
  </RestoreRequest>

• Format JSON :

  {
    "Days": integer,
    "JobParameters": {
      "Tier": "string"
    }
  }

Exemples

Opération API associée

La commande restore-object correspond à l'opération RestoreObject. Pour plus d'informations, consultez la documentation RestoreObject.