

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Téléchargement de pièces jointes
<a name="upload-attachments"></a>

Vous pouvez joindre des fichiers lorsque vous créez un dossier d'assistance ou lorsque vous répondez à un dossier existant. Vous pouvez joindre jusqu'à 10 fichiers, chaque fichier ne dépassant pas 150 Mo.

------
#### [ Support Center Console ]

**Pour télécharger des pièces jointes à l'aide de la console**

1. Sur la ** page ** Créer un dossier ou dans la section Réponse d'un dossier, choisissez ** Choisir un fichier**.

1. Sélectionnez jusqu'à 10 fichiers dans votre sélecteur de fichiers. Chaque fichier peut peser jusqu'à 150 Mo. Le chargement de chaque fichier commence immédiatement et la ** colonne ** État affiche une barre de progression en temps réel pendant le téléchargement.

1. Lorsque le chargement d'un fichier est terminé, le statut passe à ** Chargement terminé ** et la ** colonne ** Action affiche ** Supprimer**.

1. Une fois que tous les fichiers ont atteint le ** statut ** Chargement terminé, complétez les champs restants, puis choisissez ** Soumettre**.

Une fois que vous avez soumis le dossier, les pièces jointes téléchargées apparaissent sous forme de liens cliquables dans la correspondance du dossier sur la ** page Détails du ** dossier.

------
#### [ AWS Support API ]

Vous pouvez joindre des fichiers par programmation à un dossier d'assistance ou à une communication de dossier à l'aide de l' AWS Support API. L'API utilise un flux de téléchargement en plusieurs parties avec des URL présignées.

**Pour télécharger une pièce jointe à l'aide de l'API**

1. **Lancez le téléchargement. ** Appelez `GetAttachmentUploadLinks` avec `fileName` et`fileSizeBytes`. La réponse renvoie un`uploadId`, `partSizeBytes``totalParts`, et un premier lot d'URL de téléchargement présignées.

1. **Divisez et chargez votre fichier. ** Divisez votre fichier en segments d'`partSizeBytes`octets en effectuant une lecture séquentielle depuis le début du fichier. Le premier segment correspond à `partIndex` 1, le second à `partIndex` 2, et ainsi de suite. Le segment final peut être plus petit que`partSizeBytes`. PLACEZ chaque segment dans l'URL présignée avec l'URL correspondante`partIndex`. Enregistrez les informations `ETag` renvoyées par Amazon S3 pour chaque PUT réussi.

1. **Obtenez d'autres URL si nécessaire. ** Chaque appel renvoie jusqu'à 10 URL. Si votre fichier comporte plus de 10 parties, appelez `GetAttachmentUploadLinks` à nouveau en indiquant la même partie`uploadId`, `nextIndex` en passant par`uploadRange.startIndex`. Répétez jusqu'à ce que `nextIndex` la valeur soit nulle.

1. **Signaler les pièces terminées. ** Appelez `CompleteAttachmentUpload` avec le `uploadId``partIndex`, et `ETag` pour chaque partie dès que son PUT est réussi. Le fait de signaler des parties permet de reprendre immédiatement le téléchargement. Si le téléchargement est interrompu, seules les parties non signalées doivent être chargées à nouveau.

1. **Attendez que le téléchargement soit prêt. ** `DescribeAttachmentUploadStatus`Sondez jusqu'`uploadStatus`à `attachment-ready` ce que Le traitement est asynchrone et peut prendre quelques minutes pour les fichiers plus volumineux.

1. **Attachez-le à un étui. ** Passez le paramètre `uploadId` dans le `uploadIds` paramètre de `CreateCase` ou`AddCommunicationToCase`.

**UploadId contre AttachmentID**  
Un `uploadId` identifie une session de téléchargement en cours et est utilisé pour les opérations de téléchargement (`GetAttachmentUploadLinks`,`CompleteAttachmentUpload`,`DescribeAttachmentUploadStatus`) et comme entrée vers `CreateCase` ou`AddCommunicationToCase`.  
Un `attachmentId` est généré une fois que le téléchargement a été validé dans une communication de dossier. À utiliser `GetAttachmentDownloadLink` avec et `attachmentId` pour télécharger des pièces jointes. Vous pouvez obtenir le `attachmentId` `attachments` dans le champ d'un `Communication` renvoyé par`DescribeCommunications`.

**Note**  
`DescribeAttachment`ne prend en charge que les pièces jointes de 5 Mo ou moins. La `DescribeAttachment` demande d'une pièce jointe plus importante revient`InvalidParameterValueException`. Pour télécharger des pièces jointes d'une taille supérieure à 5 Mo, utilisez`GetAttachmentDownloadLink`.

**Points de terminaison**

Les URL présignées renvoyées par ces opérations sont diffusées à partir des domaines suivants :
+ **URL de téléchargement ** (`GetAttachmentUploadLinks`) : `v1.uploads.attachments.support.us-east-1.amazonaws.com`
+ **URL de téléchargement ** (`GetAttachmentDownloadLink`) : `v1.downloads.attachments.support.us-east-1.amazonaws.com`

Si votre environnement restreint le trafic sortant, assurez-vous que les deux domaines sont accessibles.

**Contraintes**
+ Taille de fichier maximale par téléchargement : 150 Mo.
+ Nombre maximum d'URL de téléchargement renvoyées par appel à `GetAttachmentUploadLinks` : 10.
+ Nombre maximum de `uploadIds` personnes par `CreateCase` `AddCommunicationToCase` demande : 10.

------