Object Storage Service:complete-multipart-upload

Notes d'utilisation

• Lorsque vous exécutez la commande complete-multipart-upload, vous devez fournir une liste complète de toutes les parties valides, incluant le numéro de partie et l'empreinte numérique (ETag) de chacune. La valeur de PartNumber varie de 1 à 10 000. Les numéros de partie indiqués dans la requête peuvent ne pas être consécutifs, mais ils doivent être triés par ordre croissant. Object Storage Service (OSS) vérifie séquentiellement la validité de chaque partie et s'assure que chaque partie, à l'exception de la dernière, a une taille supérieure ou égale à 100 Ko. Une fois toutes les parties vérifiées, OSS les assemble pour former un objet complet.

• Le traitement d'une requête CompleteMultipartUpload par OSS nécessite un certain délai. Si le client se déconnecte d'OSS pendant cette période, OSS continue de traiter la requête.

• Vous pouvez télécharger un objet en exécutant plusieurs tâches de téléchargement disposant d'ID de téléchargement indépendants. Lorsqu'une tâche de téléchargement multiple est terminée, son ID de téléchargement devient invalide, mais les ID des autres tâches de téléchargement multiple restent inchangés.

Permissions

Par défaut, un compte Alibaba Cloud dispose de toutes les autorisations. Les utilisateurs RAM ou les rôles RAM associés à un compte Alibaba Cloud ne disposent d'aucune autorisation par défaut. Le compte Alibaba Cloud ou l'administrateur du compte doit accorder les autorisations d'opération via les politiques RAM ou la politique de bucket.

Syntaxe

ossutil api complete-multipart-upload --bucket value --key value --upload-id value --complete-multipart-upload value [flags]

--complete-multipart-upload

L'option --complete-multipart-upload prend en charge les formats XML et JSON. Si la valeur de l'option contient le préfixe file://, les configurations sont lues depuis le fichier de configuration.

• Format XML :

  <CompleteMultipartUpload>
    <Part>
      <PartNumber>integer</PartNumber>
      <ETag>string</ETag>
    </Part>
    ...
  </CompleteMultipartUpload>

• Format JSON :

  {
    "Part": [
      {
        "PartNumber": integer,
        "ETag": "string"
      },
      ...
    ]
  }

Exemples

Les exemples suivants décrivent comment télécharger l'objet exampleobject dans le bucket examplebucket à l'aide du téléchargement multipartie. L'ID de téléchargement de la tâche multipartie est 123.

• Créez un fichier de configuration XML nommé complete-multipart-upload.xml et ajoutez le code suivant au fichier de configuration :

  <?xml version="1.0" encoding="UTF-8"?>
  <CompleteMultipartUpload>
    <Part>
      <PartNumber>1</PartNumber>
      <ETag>"C884BAB4F7A89D38A194568C7DE****"</ETag>
    </Part>
    <Part>
      <PartNumber>2</PartNumber>
      <ETag>"C884BAB4F7A89D38A194568C7DEA****"</ETag>
    </Part>
  </CompleteMultipartUpload>

Exemple de commande :

ossutil api complete-multipart-upload --bucket examplebucket --key exampleobject --upload-id 123 --complete-multipart-upload file://complete-multipart-upload.xml

• Créez un fichier de configuration JSON nommé complete-multipart-upload.json et ajoutez le code suivant au fichier de configuration :

  {
    "Part": [
      {
        "PartNumber": "1",
        "ETag": "\"C884BAB4F7A89D38A194568C7DE****\""
      },
      {
        "PartNumber": "2",
        "ETag": "\"C884BAB4F7A89D38A194568C7DEA****\""
      }
    ]
  }

  Exemple de commande :

  ossutil api complete-multipart-upload --bucket examplebucket --key exampleobject --upload-id 123 --complete-multipart-upload file://complete-multipart-upload.json

• Configurez les paramètres de la commande suivante au format JSON :

  ossutil api complete-multipart-upload --bucket examplebucket --key exampleobject --upload-id 123 --complete-multipart-upload file://complete-multipart-upload.json

L'exemple suivant décrit comment lister toutes les parties téléchargées dont l'ID de téléchargement est 123 dans le bucket examplebucket :

ossutil api complete-multipart-upload --bucket examplebucket --key exampleobject --upload-id 123 --complete-all yes