

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.

# POST Object
<a name="RESTObjectPOST"></a>

## Description
<a name="RESTObjectPOST-description"></a>

L'`POST`opération ajoute un objet à un compartiment spécifié à l'aide de formulaires HTML. `POST`est une autre forme `PUT` qui permet les téléchargements via un navigateur afin de placer des objets dans des compartiments. Les paramètres transmis `PUT` via les en-têtes HTTP sont plutôt transmis sous forme de champs de formulaire `POST` dans le corps du message codé en multipart/form -data. Pour ajouter un objet à un compartiment, vous devez `WRITE` y avoir accès. Amazon S3 ne stocke jamais d'objets partiels. Si vous recevez une réponse positive, vous pouvez être sûr que l'objet entier a été stocké.

Amazon S3 est un système distribué. À moins que vous n'ayez activé la gestion des versions pour un compartiment, si Amazon S3 reçoit simultanément plusieurs demandes d'écriture pour le même objet, seule la dernière version de l'objet écrite est stockée.

Pour vous assurer que les données ne sont pas corrompues lors de la traversée du réseau, utilisez le champ du `Content-MD5` formulaire. Lorsque vous utilisez ce champ de formulaire, Amazon S3 compare l'objet à la valeur MD5 fournie. S'ils ne correspondent pas, Amazon S3 renvoie un message d'erreur. En outre, vous pouvez calculer la valeur MD5 lors de la publication d'un objet sur Amazon S3 et comparer la valeur renvoyée `ETag` à la valeur MD5 calculée. L'ETag reflète uniquement les modifications apportées au contenu d'un objet, pas à ses métadonnées.

**Note**  
Pour configurer votre application afin qu'elle envoie les en-têtes de demande avant d'envoyer le corps de la demande, utilisez le code d'état HTTP 100 (Continuer). Pour les `POST` opérations, l'utilisation de ce code d'état vous permet d'éviter d'envoyer le corps du message si celui-ci est rejeté sur la base des en-têtes (par exemple, en raison d'un échec d'authentification ou d'une redirection). Pour plus d'informations sur le code d'état HTTP 100 (Continuer), reportez-vous à la Section 8.2.3 de [ http://www.ietf.org/rfc/rfc2616.txt](http://www.ietf.org/rfc/rfc2616.txt).

Amazon S3 chiffre automatiquement tous les nouveaux objets chargés dans un compartiment S3. Le paramètre de chiffrement d'un objet chargé dépend de la configuration de chiffrement par défaut du compartiment de destination. Par défaut, tous les compartiments ont une configuration de chiffrement par défaut qui utilise le chiffrement côté serveur avec des clés gérées par Amazon S3 (). SSE-S3 

Si le compartiment de destination possède une configuration de chiffrement qui utilise le chiffrement côté serveur avec une clé AWS Key Management Service (AWS KMS) clé (SSE-KMS), un cryptage double couche côté serveur avec une AWS KMS clé (DSSE-KMS) ou une clé de cryptage fournie par le client (SSE-C), Amazon S3 utilise la clé KMS correspondante ou la clé fournie par le client pour chiffrer l'objet chargé. Lorsque vous chargez un objet, si vous souhaitez modifier le paramètre de cryptage de l'objet chargé, vous pouvez spécifier le type de cryptage côté serveur. Vous pouvez configurer SSE-S3 SSE-KMS, DSSE-KMS, ou SSE-C. Pour plus d’informations, consultez [Protection des données à l’aide du chiffrement côté serveur](https://docs.aws.amazon.com/AmazonS3/latest/userguide/serv-side-encryption.html) dans le *Guide de l’utilisateur Amazon Simple Storage Service*.

**Important**  
Lors de la création de votre demande, assurez-vous que le `file` champ est le dernier du formulaire.

## Requêtes
<a name="RESTObjectPOST-requests"></a>

### Syntaxe
<a name="RESTObjectPOST-requests-syntax"></a>

```
 1. POST / HTTP/1.1
 2. Host: {{destinationBucket}}.s3.amazonaws.com
 3. User-Agent: {{browser_data}}
 4. Accept: {{file_types}}
 5. Accept-Language: {{Regions}}
 6. Accept-Encoding: {{encoding}}
 7. Accept-Charset: {{character_set}}
 8. Keep-Alive: 300
 9. Connection: keep-alive
10. Content-Type: multipart/form-data; boundary=9431149156168
11. Content-Length: {{length}}
12. 
13. --9431149156168
14. Content-Disposition: form-data; name="key"
15. 
16. acl
17. --9431149156168
18. Content-Disposition: form-data; name="tagging"
19. 
20. <Tagging><TagSet><Tag><Key>{{Tag Name}}</Key><Value>{{Tag Value}}</Value></Tag></TagSet></Tagging>
21. --9431149156168
22. Content-Disposition: form-data; name="success_action_redirect"
23. 
24. success_redirect
25. --9431149156168
26. Content-Disposition: form-data; name="Content-Type"
27. 
28. content_type
29. --9431149156168
30. Content-Disposition: form-data; name="x-amz-meta-uuid"
31. 
32. uuid
33. --9431149156168
34. Content-Disposition: form-data; name="x-amz-meta-tag"
35. 
36. metadata
37. --9431149156168
38. Content-Disposition: form-data; name="AWSAccessKeyId"
39. 
40. access-key-id
41. --9431149156168
42. Content-Disposition: form-data; name="Policy"
43. 
44. encoded_policy
45. --9431149156168
46. Content-Disposition: form-data; name="Signature"
47. 
48. signature=
49. --9431149156168
50. Content-Disposition: form-data; name="file"; filename="{{MyFilename.jpg}}"
51. Content-Type: image/jpeg
52. 
53. file_content
54. --9431149156168
55. Content-Disposition: form-data; name="submit"
56. 
57. Upload to Amazon S3
58. --9431149156168--
```

### Paramètres de demande
<a name="RESTObjectPOST-requests-request-parameters"></a>

Cette implémentation de l'opération n'utilise pas de paramètres de demande.

### Champs de formulaire
<a name="RESTObjectPOST-requests-form-fields"></a>

Cette opération peut utiliser les champs de formulaire suivants.


| Nom | Description | Obligatoire | 
| --- | --- | --- | 
| AWSAccessKeyId | L'ID de clé d' AWS accès du propriétaire du bucket qui accorde à un utilisateur anonyme l'accès à une demande qui répond à l'ensemble de contraintes de la politique.<br />Type : Chaîne<br />Par défaut : aucun<br />Contraintes : Obligatoire si un document de politique est inclus dans la demande.  | Conditionnel | 
| acl | La liste de contrôle d'accès (ACL) Amazon S3 spécifiée. Si l'ACL spécifiée n'est pas valide, une erreur est générée. Pour plus d'informations sur les ACL, consultez la section Présentation de la liste de contrôle d'[accès (ACL) ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/acl-overview.html) dans le guide * de l'utilisateur d'*Amazon Simple Storage Service. <br />Type : Chaîne<br />Valeur par défaut : private<br /> Valeurs valides : `private \| public-read \| public-read-write \| aws-exec-read \| authenticated-read \| bucket-owner-read \| bucket-owner-full-control `  | Non | 
| Cache-Control, Content-Type, Content-Disposition, Content-Encoding, Expires | Les REST-specific en-têtes. Pour de plus amples informations, veuillez consulter [PutObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html).<br />Type : Chaîne<br />Par défaut : aucun | Non | 
| file | Le contenu du fichier ou du texte. <br />Le contenu du fichier ou du texte doit être le dernier champ du formulaire.<br />Vous ne pouvez pas charger plus d'un fichier à la fois.<br />Type : contenu de fichier ou de texte<br />Par défaut : aucun | Oui | 
| key | Nom de la clé chargée.<br />Pour utiliser le nom de fichier fourni par l'utilisateur, utilisez la `${filename}` variable. Par exemple, si un utilisateur nommé Mary charge le fichier `example.jpg` et que vous le spécifiez`/user/mary/${filename}`, le nom de la clé est`/user/mary/example.jpg`.<br />Pour plus d'informations, consultez la section Clé d'[objet et métadonnées ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingMetadata.html) dans le guide de l'utilisateur d'*Amazon Simple Storage Service*.<br />Type : Chaîne<br />Par défaut : aucun | Oui | 
| policy | La politique de sécurité qui décrit ce qui est autorisé dans la demande. Les demandes sans politique de sécurité sont considérées comme anonymes et ne fonctionnent que sur des compartiments accessibles en écriture publique. Pour plus d'informations, consultez les formulaires [ HTML ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/HTTPPOSTForms.html) et les exemples de [ téléchargement ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/HTTPPOSTExamples.html) dans le guide de l'utilisateur d'*Amazon Simple Storage Service*. <br />Type : Chaîne<br />Par défaut : aucun<br />Contraintes : une politique de sécurité est requise si le bucket n'est pas accessible en écriture publique. | Conditionnel | 
| success\_action\_redirect, redirect | URL vers laquelle le client est redirigé en cas de téléchargement réussi.<br />Si `success_action_redirect` n'est pas spécifié, Amazon S3 retourne le type de document vide spécifié dans le champ `success_action_status`.<br />Si Amazon S3 ne peut pas interpréter l'URL, il agit comme si le champ n'était pas présent.<br />Si le téléchargement échoue, Amazon S3 affiche une erreur et ne redirige pas l'utilisateur vers une URL.<br />Type : Chaîne<br />Par défaut : aucun Le nom du `redirect` champ est obsolète et la prise en charge du nom de `redirect` champ sera supprimée à l'avenir.   | Non | 
| success\_action\_status | Si vous ne le spécifiez pas`success_action_redirect`, le code d'état est renvoyé au client lorsque le téléchargement est réussi.<br />Ce champ accepte les valeurs `200``201`, ou `204` (valeur par défaut).<br />Si la valeur est définie sur `200` ou`204`, Amazon S3 renvoie un document vide avec un code de statut 200 ou 204.<br />Si la valeur est définie sur`201`, Amazon S3 renvoie un document XML avec un code d'état 201. <br />Si la valeur n'est pas définie ou si elle est définie sur une valeur non valide, Amazon S3 renvoie un document vide avec un code de statut 204. <br />Type : Chaîne<br />Par défaut : aucun | Non | 
| tagging | Ensemble de balises spécifié à ajouter à l'objet. Pour ajouter des balises, utilisez le schéma de codage suivant.<br /> <pre><Tagging><br />  <TagSet><br />    <Tag><br />      <Key>{{TagName}}</Key><br />      <Value>{{TagValue}}</Value><br />    </Tag><br />    ...<br />  </TagSet><br /></Tagging></pre><br />Pour plus d'informations, consultez la section Marquage des [ objets ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html) dans le guide * de l'utilisateur d'*Amazon Simple Storage Service.<br />Type : Chaîne<br />Par défaut : aucun | Non | 
| x-amz-storage-class | Classe de stockage à utiliser pour stocker l'objet. Si vous ne spécifiez aucune classe, Amazon S3 utilise la classe de stockage par défaut,`STANDARD`. Amazon S3 prend en charge d'autres classes de stockage. Pour plus d'informations, consultez la section Classes [ de stockage ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-class-intro.html) dans le guide de l'utilisateur d'*Amazon Simple Storage Service*. <br />Type : Chaîne<br />Valeur par défaut : `STANDARD`<br />Valeurs valides : `REDUCED_REDUNDANCY` \| `EXPRESS_ONEZONE` \| `DEEP_ARCHIVE` \| `GLACIER` \| `GLACIER_IR` \| `INTELLIGENT_TIERING` \| `ONEZONE_IA` \| `STANDARD` \| `STANDARD_IA`  | Non | 
| x-amz-meta-\* | Les en-têtes commençant par ce préfixe sont des métadonnées définies par l'utilisateur. Chacune est stockée et renvoyée sous la forme d'un ensemble de paires clé-valeur. Amazon S3 ne valide ni n'interprète les métadonnées définies par l'utilisateur. Pour de plus amples informations, veuillez consulter [PutObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html).<br />Type : Chaîne<br />Par défaut : aucun | Non | 
| x-amz-security-token | Le jeton DevPay de sécurité Amazon. <br />Chaque demande qui utilise Amazon DevPay nécessite deux champs de `x-amz-security-token` formulaire : un pour le jeton du produit et un pour le jeton utilisateur.<br />Type : Chaîne<br />Par défaut : aucun | Non | 
| x-amz-signature | (AWS Signature Version 4) Le HMAC-SHA256 hachage de la politique de sécurité.<br />Type : Chaîne<br />Par défaut : aucun | Conditionnel | 
| x-amz-website-redirect-location  | Si le compartiment est configuré en tant que site Web, ce champ redirige les demandes relatives à cet objet vers un autre objet du même compartiment ou vers une URL externe. Amazon S3 stocke la valeur de cet en-tête dans les métadonnées de l'objet. Pour plus d'informations sur les métadonnées des objets, consultez la section Clé d'[objet et métadonnées ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingMetadata.html) dans le guide de l'utilisateur d'*Amazon Simple Storage Service*.<br />Dans l'exemple suivant, l'en-tête de demande définit la redirection vers un objet (`anotherPage.html`) dans le même compartiment :<br />`x-amz-website-redirect-location: /anotherPage.html`<br />Dans l'exemple suivant, l'en-tête de la demande définit la redirection de l'objet vers un autre site Web :<br />`x-amz-website-redirect-location: http://www.example.com/`<br />Pour plus d'informations sur l'hébergement de sites Web dans Amazon S3, consultez les [ rubriques Hébergement de sites Web sur Amazon S3 ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/WebsiteHosting.html) et [ Comment configurer les redirections de pages Web ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/how-to-page-redirect.html) dans le guide * de l'utilisateur d'*Amazon Simple Storage Service.<br />Type : Chaîne<br />Par défaut : aucun<br />Contraintes : la valeur doit être préfixée par `/``http://`, ou`https://`. La longueur de la valeur est limitée à 2 Ko. |  Non  | 

#### Champs supplémentaires du formulaire de demande de somme de contrôle
<a name="post-object-additional-checksums"></a>

Lorsque vous chargez un objet, vous pouvez spécifier les différentes sommes de contrôle que vous souhaitez utiliser pour vérifier l'intégrité de vos données. Vous pouvez spécifier un algorithme de somme de contrôle supplémentaire à utiliser par Amazon S3. Pour plus d'informations sur les valeurs de somme de contrôle supplémentaires, consultez la section [ Vérification de l'intégrité des objets ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html) dans le guide * de l'utilisateur d'*Amazon Simple Storage Service.


|  Nom  |  Description  |  Obligatoire  | 
| --- | --- | --- | 
|  x-amz-checksum-algorithm  | Indique l'algorithme utilisé pour créer la somme de contrôle pour l'objet. Si une valeur est spécifiée, vous devez inclure l'en-tête de somme de contrôle correspondant. Dans le cas contraire, votre demande générera une erreur 400.<br />Les valeurs possibles incluent `CRC32`, `CRC32C`, `SHA1` et `SHA256`. | Non | 
|  x-amz-checksum-crc32  | Spécifie la somme de contrôle CRC32 32 bits codée en base64 de l'objet.<br />Ce paramètre est obligatoire si la valeur de `x-amz-checksum-algorithm` est`CRC32`. | Conditionnel | 
|  x-amz-checksum-crc32c  | Spécifie la somme de contrôle CRC32C 32 bits codée en base64 de l'objet.<br />Ce paramètre est obligatoire si la valeur de `x-amz-checksum-algorithm` est`CRC32C`. | Conditionnel | 
|  x-amz-checksum-sha1  | Spécifie le SHA-1 condensé de 160 bits codé en base64 de l'objet.<br />Ce paramètre est obligatoire si la valeur de `x-amz-checksum-algorithm` est`SHA1`. | Conditionnel | 
|  x-amz-checksum-sha256  | Spécifie le SHA-256 condensé de 256 bits codé en base64 de l'objet.<br />Ce paramètre est obligatoire si la valeur de `x-amz-checksum-algorithm` est`SHA256`. | Conditionnel | 

#### Server-Side Champs de formulaire de demande spécifiques au chiffrement
<a name="post-object-sse-specific-request-headers"></a>

Server-side le chiffrement est le chiffrement des données au repos. Amazon S3 chiffre vos données lors de leur écriture sur des disques situés dans AWS des centres de données et les déchiffre lorsque vous y accédez. Lorsque vous chargez un objet, vous pouvez spécifier le type de chiffrement côté serveur qu'Amazon S3 doit utiliser pour chiffrer l'objet. 

Il existe quatre types de chiffrement côté serveur : 
+ **Server-side chiffrement à l'aide de clés gérées par Amazon S3 (SSE-S3) ** : à compter de mai 2022, le chiffrement est configuré par défaut pour tous les compartiments Amazon S3. L'option par défaut pour le chiffrement côté serveur est avec. SSE-S3 Chaque objet est chiffré à l’aide d’une clé unique. Comme mesure de protection supplémentaire, SSE-S3 chiffre la clé elle-même à l'aide d'une clé racine qu'il change régulièrement. SSE-S3 utilise l'un des systèmes de chiffrement par blocs les plus puissants disponibles, le Advanced Encryption Standard (AES-256) 256 bits, pour chiffrer vos données.
+ **Server-side chiffrement à l'aide de AWS KMS clés (SSE-KMS) ** : SSE-KMS est fourni par le biais d'une intégration du AWS KMS service à Amazon S3. Avec AWS KMS, vous avez plus de contrôle sur vos clés. Par exemple, vous pouvez afficher des clés distinctes, modifier des politiques de contrôle et suivre les clés dans AWS CloudTrail. En outre, vous pouvez créer et gérer les clés gérées par le client ou utiliser les Clés gérées par AWS qui sont propres à vous-même, à votre service et à votre région.
+ **Dual-layer chiffrement côté serveur avec AWS KMS clés (DSSE-KMS) ** : le chiffrement côté Dual-layer serveur avec () est similaire au chiffrement côté serveur avec AWS KMS keys (DSSE-KMS) SSE-KMS, mais applique deux couches individuelles de chiffrement au niveau de l'objet au lieu d'une seule. 
+ **Server-side chiffrement à l'aide de clés fournies par le client (SSE-C) ** : avec SSE-C, vous gérez les clés de chiffrement, et Amazon S3 gère le chiffrement lors de l'écriture sur les disques, ainsi que le déchiffrement lorsque vous accédez à vos objets. 
**Note**  
Si le chiffrement côté serveur avec les clés fournies par le client (SSE-C) est bloqué pour votre compartiment à usage général, une erreur HTTP 403 Access Denied s'affiche lorsque vous spécifiez les en-têtes de SSE-C demande lors de l'écriture de nouvelles données dans votre bucket. Pour plus d'informations, consultez la section [ Blocage ou déblocage SSE-C d'un compartiment ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/blocking-unblocking-s3-c-encryption-gpb.html) à usage général.

Pour plus d'informations, consultez [ la section Protection des données à l'aide du chiffrement côté serveur ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/serv-side-encryption.html) dans le guide de l'utilisateur d'*Amazon Simple Storage Service. *

Selon le type de chiffrement côté serveur que vous souhaitez utiliser, spécifiez les champs de formulaire suivants. 
+ **Utiliser SSE-S3 SSE-KMS, ou DSSE-KMS ** — Si vous souhaitez utiliser ces types de chiffrement côté serveur, spécifiez les champs de formulaire suivants dans la demande. 


<table>
<thead>
  <tr><th> Nom </th><th> Description </th><th> Obligatoire </th></tr>
</thead>
<tbody>
  <tr><td> <code>x-amz-server-side-encryption</code> </td><td>Spécifie l'algorithme de chiffrement côté serveur à utiliser lorsqu'Amazon S3 crée un objet. Pour l'utiliser SSE-S3, spécifiez<code>AES256</code>. Pour l'utiliser SSE-KMS, spécifiez<code>aws:kms</code>. Pour l'utiliser DSSE-KMS, spécifiez<code>aws:kms:dsse</code>.<br />Type : Chaîne<br />Valeur valide :<code>aws:kms</code>,<code>AES256</code>, <code>aws:kms:dsse</code></td><td>Oui</td></tr>
  <tr><td> <code>x-amz-server-side-encryption-aws-kms-key-id</code> </td><td>Si l'<code>x-amz-server-side-encryption</code>en-tête a une valeur valide de <code>aws:kms</code> ou<code>aws:kms:dsse</code>, cet en-tête spécifie l'ID de l'objet AWS KMS key qui a été utilisé pour chiffrer l'objet.<br />Type : Chaîne</td><td>Oui, si la valeur de <code>x-amz-server-side-encryption</code> est <code>aws:kms</code> ou <code>aws:kms:dsse</code></td></tr>
  <tr><td> <code>x-amz-server-side-encryption-context</code> </td><td>Si la valeur <code>aws:kms</code> ou <code>x-amz-server-side-encryption</code> est valide<code>aws:kms:dsse</code>, cet en-tête spécifie le contexte de chiffrement de l'objet. La valeur de cet en-tête est une UTF-8 chaîne codée en base64 qui contient des paires JSON-formatted clé-valeur pour le contexte de chiffrement.<br />Type : Chaîne</td><td>Non</td></tr>
  <tr><td> <code>x-amz-server-side-encryption-bucket-key-enabled</code> </td><td>Si la valeur <code>aws:kms</code> ou <code>x-amz-server-side-encryption</code> est valide<code>aws:kms:dsse</code>, cet en-tête indique si Amazon S3 doit utiliser une clé de compartiment S3 avec SSE-KMS ou DSSE-KMS. Si vous définissez cet en-tête <code>true</code> pour qu'Amazon S3 utilise une clé de compartiment S3 pour le chiffrement des objets avec SSE-KMS ou DSSE-KMS.<br />Type : Boolean</td><td>Non</td></tr>
</tbody>
</table>

**Note**  
Si vous spécifiez `x-amz-server-side-encryption:aws:kms` ou`x-amz-server-side-encryption:aws:kms:dsse`, mais que vous ne le fournissez pas`x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 utilise le Clé gérée par AWS (`aws/S3`) pour protéger les données.
+ **Utilisation SSE-C ** — Si vous souhaitez gérer vos propres clés de chiffrement, vous devez fournir tous les champs de formulaire suivants dans la demande. 
**Note**  
Si vous utilisez SSE-C, la `ETag` valeur renvoyée par Amazon S3 dans la réponse n'est pas le MD5 de l'objet.


<table>
<thead>
  <tr><th> Nom </th><th> Description </th><th> Obligatoire </th></tr>
</thead>
<tbody>
  <tr><td><code>x-amz-server-side-encryption-customer-algorithm</code> </td><td>Spécifie l'algorithme à utiliser pour chiffrer l'objet.<br />Type : Chaîne<br />Par défaut : aucun<br />Valeur valide : <code>AES256</code><br />Contraintes : Doit être accompagné de <code>x-amz-server-side-encryption-customer-key-MD5</code> champs <code>x-amz-server-side-encryption-customer-key</code> et valides.</td><td> Oui </td></tr>
  <tr><td><code>x-amz-server-side-encryption-customer-key</code> </td><td>Spécifie la clé de chiffrement codée en base64 fournie par le client à utiliser par Amazon S3 pour chiffrer les données. Cette valeur est utilisée pour stocker l'objet, puis il est supprimé. Amazon ne stocke pas la clé de chiffrement. La clé doit être appropriée pour pouvoir être utilisée avec l'algorithme spécifié dans l'en-tête <code>x-amz-server-side-encryption-customer-algorithm</code>.<br />Type : Chaîne<br />Par défaut : aucun<br />Contraintes : Doit être accompagné de <code>x-amz-server-side-encryption-customer-key-MD5</code> champs <code>x-amz-server-side-encryption-customer-algorithm</code> et valides.</td><td>Oui</td></tr>
  <tr><td><code>x-amz-server-side-encryption-customer-key-MD5</code> </td><td>Spécifie le condensé MD5 128 bits codé en base64 de la clé de chiffrement conformément à la RFC 1321. <a href="http://tools.ietf.org/html/rfc1321">http://tools.ietf.org/html/rfc1321</a> Amazon S3 utilise cet en-tête pour vérifier l'intégrité des messages afin de s'assurer que la clé de chiffrement a été transmise sans erreur.<br />Type : Chaîne<br />Par défaut : aucun<br />Contraintes : Doit être accompagné de <code>x-amz-server-side-encryption-customer-key</code> champs <code>x-amz-server-side-encryption-customer-algorithm</code> et valides.</td><td> Oui </td></tr>
</tbody>
</table>


### Réponses
<a name="RESTObjectPOST-requests-responses"></a>

#### En-têtes de réponse
<a name="RESTObjectPOST-requests-responses-response-headers"></a>

Cette implémentation de l'opération peut inclure les en-têtes de réponse suivants en plus des en-têtes de réponse communs à toutes les réponses. Pour plus d'informations, consultez la section En-têtes [ de réponse ](RESTCommonResponseHeaders.md) communs.


|  Nom  |  Description  | 
| --- | --- | 
|  x-amz-checksum-crc32  | Somme de contrôle CRC32 32 bits codée en base64 de l'objet.<br />Type : Chaîne | 
|  x-amz-checksum-crc32c  | Somme de contrôle CRC32C 32 bits codée en base64 de l'objet.<br />Type : Chaîne | 
|  x-amz-checksum-sha1  | Résumé de 160 bits codé en base64 de l'objet SHA-1 .<br />Type : Chaîne | 
|  x-amz-checksum-sha256  | Résumé de 256 bits codé en base64 de l'objet SHA-256 .<br />Type : Chaîne | 
|  x-amz-expiration  | Si une `Expiration` action est configurée pour l'objet dans le cadre de la configuration du cycle de vie du bucket, Amazon S3 renvoie cet en-tête.  La valeur d'en-tête comprend un `expiry-date` composant et un URL-encoded `rule-id` composant.  Pour les buckets activés par version, cet en-tête s'applique uniquement aux versions actuelles. Amazon S3 ne fournit pas d'en-tête pour indiquer à quel moment une version non actuelle peut être supprimée définitivement. Pour de plus amples informations, veuillez consulter [PutBucketLifecycleConfiguration](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html).<br />Type : Chaîne | 
|  success\_action\_redirect, redirect  | URL vers laquelle le client est redirigé en cas de téléchargement réussi.<br />Type : Chaîne<br />Ancêtre : PostResponse | 
|  x-amz-server-side-encryption  | Algorithme de chiffrement côté serveur qui a été utilisé lors du stockage de cet objet dans Amazon S3 (par exemple,, `AES256``aws:kms`,`aws:kms:dsse`).<br />Type : Chaîne | 
|  x-amz-server-side-encryption-aws-kms-key-id  | Si la valeur de l'`x-amz-server-side-encryption`en-tête est valide`aws:kms`, cet en-tête spécifie l'ID de la clé KMS qui a été utilisée pour chiffrer l'objet.<br />Type : Chaîne | 
|  x-amz-server-side-encryption-bucket-key-enabled  | S'il `x-amz-server-side-encryption` possède une valeur valide de`aws:kms`, cet en-tête indique si l'objet est chiffré à l'aide SSE-KMS d'une clé de compartiment S3. Si cet en-tête est défini sur`true`, l'objet utilise une clé de compartiment S3 avec SSE-KMS.<br />Type : Boolean | 
|  x-amz-server-side-encryption-customer-algorithm  | Si cela SSE-C a été demandé, la réponse inclut cet en-tête, qui confirme l'algorithme de chiffrement utilisé.<br />Type : Chaîne<br />Valeurs valides : `AES256` | 
|  x-amz-server-side-encryption-customer-key-MD5  | Si cela SSE-C a été demandé, la réponse inclut cet en-tête pour vérifier l'intégrité du message aller-retour de la clé de cryptage fournie par le client.<br />Type : Chaîne | 
| x-amz-version-id | Version de l'objet.<br />Type : Chaîne | 

#### Éléments de réponse
<a name="RESTObjectPOST-requests-responses-response-elements"></a>


|  Nom  |  Description  | 
| --- | --- | 
|  Bucket  | Le nom du compartiment dans lequel l'objet a été stocké.<br />Type : Chaîne<br />Ancêtre : PostResponse | 
|  ETag  | La balise d'entité (ETag) est un hachage MD5 de l'objet que vous pouvez utiliser pour effectuer des `GET` opérations conditionnelles en utilisant la balise de `If-Modified` requête avec l'opération de `GET` demande. `ETag`reflète uniquement les modifications apportées au contenu d'un objet, et non à ses métadonnées.<br />Type : Chaîne<br />Ancêtre : PostResponse | 
|  Key  | Le nom de la clé de l'objet.<br />Type : Chaîne<br />Ancêtre : PostResponse | 
|  Location  | L'URI de l'objet.<br />Type : Chaîne<br />Ancêtre : PostResponse | 

#### Erreurs spéciales
<a name="RESTObjectPOST-requests-responses-special-errors"></a>

Cette implémentation de l'opération ne renvoie pas d'erreurs spéciales. Pour obtenir des informations générales sur les erreurs Amazon S3 et une liste des codes d'erreur, consultez la section Réponses aux [ erreurs](ErrorResponses.md).

## Exemples
<a name="RESTObjectPOST-requests-examples"></a>

### Exemple de demande
<a name="ExampleVersionObjectPost"></a>

```
1. POST /Neo HTTP/1.1
2. Content-Length: 4
3. Host: quotes.s3.amazonaws.com
4. Date: Wed, 01 Mar  2006 12:00:00 GMT
5. Authorization: {{authorization string}}
6. Content-Type: text/plain
7. Expect: the 100-continue HTTP status code
8. 
9. {{ObjectContent}}
```

### Exemple de réponse avec suspension de la gestion des versions
<a name="RESTObjectPOST-requests-examples-sample-response-with-versioning-suspended"></a>

Voici un exemple de réponse lorsque la gestion des versions des compartiments est suspendue :

```
 1. HTTP/1.1 100 Continue
 2. HTTP/1.1 200 OK
 3. x-amz-id-2: LriYPLdmOdAiIfgSm/F1YsViT1LW94/xUQxMsF7xiEb1a0wiIOIxl+zbwZ163pt7
 4. x-amz-request-id: 0A49CE4060975EAC
 5. x-amz-version-id: default
 6. Date: Wed, 12 Oct 2009 17:50:00 GMT
 7. ETag: "1b2cf535f27731c974343645a3985328"
 8. Content-Length: 0
 9. Connection: close
10. Server: AmazonS3
```

Dans cette réponse, l'ID de version est`null`.

### Exemple de réponse avec la gestion des versions activée
<a name="RESTObjectPOST-requests-examples-sample-response-with-versioning-enabled"></a>

Voici un exemple de réponse lorsque la gestion des versions des compartiments est activée.

```
 1. HTTP/1.1 100 Continue
 2. HTTP/1.1 200 OK
 3. x-amz-id-2: LriYPLdmOdAiIfgSm/F1YsViT1LW94/xUQxMsF7xiEb1a0wiIOIxl+zbwZ163pt7
 4. x-amz-request-id: 0A49CE4060975EAC
 5. x-amz-version-id: 43jfkodU8493jnFJD9fjj3HHNVfdsQUIFDNsidf038jfdsjGFDSIRp
 6. Date: Wed, 01 Mar  2006 12:00:00 GMT
 7. ETag: "828ef3fdfa96f00ad9f27c383fc9ac7f"
 8. Content-Length: 0
 9. Connection: close
10. Server: AmazonS3
```

## Ressources connexes
<a name="RESTObjectPOST-requests-related-resources"></a>
+  [CopyObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html) 
+  [POST Object](#RESTObjectPOST) 
+  [GetObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html) 