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.

# PutObjectInline (API SOAP)
<a name="SOAPPutObjectInline"></a>

**Note**  
 Les SOAP API pour Amazon S3 ne sont pas disponibles pour les nouveaux clients. Leur fin de vie est prévue le 31 août 2025. Nous vous recommandons d'utiliser l'API REST ou les AWS SDK. 

L'`PutObjectInline`opération ajoute un objet à un compartiment. Les données de l'objet sont fournies dans le corps du message SOAP. 

Si un objet existe déjà dans un compartiment, le nouvel objet le remplacera car Amazon S3 stocke la dernière demande d'écriture. Amazon S3 est toutefois un système distribué. Si Amazon S3 reçoit plusieurs demandes d'écriture pour le même objet presque simultanément, tous les objets peuvent être stockés, même si un seul gagne au final. Amazon S3 ne fournit pas de verrouillage des objets ; si vous en avez besoin, assurez-vous de l'intégrer à votre couche d'application.

Pour vous assurer qu'un objet n'est pas endommagé sur le réseau, vous pouvez calculer le MD5 d'un objet, le placer dans Amazon S3 et comparer l'Etag renvoyé à la valeur MD5 calculée.

PutObjectInline ne convient pas à une utilisation avec de gros objets. Le système limite cette opération à l'utilisation d'objets de 1 Mo ou moins. PutObjectInlineéchouera avec le code `InlineDataTooLargeError` d'état si le paramètre Data code un objet de plus de 1 Mo. Pour charger des objets volumineux, pensez à utiliser l'API non intégrée ou PutObject l'API REST à la place. 

**Example**  
Cet exemple écrit du texte et des métadonnées dans l'objet « Nelson » du compartiment « guillemets », permet à un utilisateur (généralement le propriétaire) `FULL_CONTROL` d'accéder à l'objet et le rend lisible par des personnes anonymes.  
`Sample Request`  

```
 1. <PutObjectInline xmlns="https://doc.s3.amazonaws.com/2006-03-01">
 2.   <Bucket>quotes</Bucket>
 3.   <Key>Nelson</Key>
 4.   <Metadata>
 5.     <Name>Content-Type</Name>
 6.     <Value>text/plain</Value>
 7.   </Metadata>
 8.   <Metadata>
 9.     <Name>family</Name>
10.     <Value>Muntz</Value>
11.   </Metadata>
12.   <Data>aGEtaGE=</Data>
13.   <ContentLength>5</ContentLength>
14.   <AccessControlList>
15.     <Grant>
16.       <Grantee xsi:type="CanonicalUser">
17.         <ID>a9a7b886d6fde241bf9b1c61be666e9</ID>
18.         <DisplayName>chriscustomer</DisplayName>
19.       </Grantee>
20.       <Permission>FULL_CONTROL</Permission>
21.     </Grant>
22.     <Grant>
23.       <Grantee xsi:type="Group">
24.         <URI>http://acs.amazonaws.com/groups/global/AllUsers</URI>
25.       </Grantee>
26.       <Permission>READ</Permission>
27.     </Grant>
28.   </AccessControlList>
29.   <AWSAccessKeyId>AKIAIOSFODNN7EXAMPLE</AWSAccessKeyId>
30.   <Timestamp>2006-03-01T12:00:00.183Z</Timestamp>
31.   <Signature>Iuyz3d3P0aTou39dzbqaEXAMPLE=</Signature>
32. </PutObjectInline>
```
`Sample Response`  

```
1. <PutObjectInlineResponse xmlns="https://s3.amazonaws.com/doc/2006-03-01">
2.   <PutObjectInlineResponse>
3.     <ETag>&quot828ef3fdfa96f00ad9f27c383fc9ac7f&quot</ETag>
4.     <LastModified>2006-01-01T12:00:00.000Z</lastModified>
5.   </PutObjectInlineResponse>
6. </PutObjectInlineResponse>
```

## Eléments
<a name="SOAPPutObjectInlineElements"></a>
+ `Bucket:`Le compartiment dans lequel ajouter l'objet.

  
+ `Key:`La touche à attribuer à l'objet.

  
+ `Metadata:`Vous pouvez fournir des paires de métadonnées nom-valeur dans l'élément de métadonnées. Ils seront stockés avec l'objet.

  
+ `Data:`La forme codée en base 64 des données.

  
+ `ContentLength:`Longueur des données en octets.

  
+ `AccessControlList:`Une liste de contrôle d'accès pour la ressource. Cet élément est facultatif. En cas d'omission, le demandeur a `FULL_CONTROL` accès à l'objet. Si l'objet existe déjà, la politique de contrôle d'accès préexistante est remplacée.

  

## Réponses
<a name="SOAPPutObjectInlineResponse"></a>
+  `ETag:`La balise d'entité est un hachage MD5 de l'objet que vous pouvez utiliser pour effectuer des extractions conditionnelles de l'objet. `GetObjectExtended` L'ETag reflète uniquement les modifications apportées au contenu d'un objet, pas à ses métadonnées. 
+ `LastModified:`L'horodatage Amazon S3 de l'objet enregistré.

## Contrôle d’accès
<a name="SOAPPutObjectInlineAccessControl"></a>

Vous devez avoir `WRITE` accès au seau pour y placer des objets. 

## Ressources connexes
<a name="SOAPPutObjectInline_RelatedResources"></a>
+  [PutObject (API SOAP)](SOAPPutObject.md) 
+  [CopyObject (API SOAP)](SOAPCopyObject.md)