本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

**注意**  
 Amazon S3 的 SOAP API 不適用於新客戶，並且將於 2025 年 8 月 31 日接近生命週期結束 (EOL)。我們建議您使用 REST API 或 AWS SDKs。

`PutObjectInline` 操作會將物件新增至儲存貯體。物件的資料會在 SOAP 訊息的內文中提供。

如果儲存貯體中已存在物件，則新物件會覆寫它，因為 Amazon S3 會儲存最後一個寫入請求。不過，Amazon S3 是分散式系統。如果 Amazon S3 幾乎同時收到相同物件的多個寫入請求，所有物件都可能儲存，即使最後只有一個獲勝。Amazon S3 不提供物件鎖定；如果您需要，請務必將其建置到您的應用程式層。

為了確保物件不會在網路上損毀，您可以計算物件的 MD5、將物件 PUT 轉換為 Amazon S3，並將傳回的 Etag 與計算的 MD5 值進行比較。

PutObjectInline 不適用於大型物件。系統會限制此操作使用 1MB 或更小的物件。如果資料參數編碼大於 1MB 的物件，PutObjectInline 將使用`InlineDataTooLargeError`狀態碼失敗。若要上傳大型物件，請考慮改用非內嵌 PutObject API 或 REST API。

**Example**  
此範例會將一些文字和中繼資料寫入「引號」儲存貯體中的「Nelson」物件，讓使用者 （通常是擁有者） `FULL_CONTROL`存取物件，並讓匿名方讀取物件。  
`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>
```

## 元素
<a name="SOAPPutObjectInlineElements"></a>
+ `Bucket:` 要新增物件的儲存貯體。

  
+ `Key:` 要指派給物件的金鑰。

  
+ `Metadata:` 您可以在中繼資料元素中提供名稱值中繼資料對。這些會與 物件一起存放。

  
+ `Data:` 資料的基礎 64 編碼形式。

  
+ `ContentLength:` 資料的長度，以位元組為單位。

  
+ `AccessControlList:` 資源的存取控制清單。此元素是選用的。如果省略，請求者會獲得物件的`FULL_CONTROL`存取權。如果物件已存在，則會取代預先存在的存取控制政策。

  

## 回應
<a name="SOAPPutObjectInlineResponse"></a>
+  `ETag:` 實體標籤是 物件的 MD5 雜湊，您可以使用 對物件執行條件式擷取`GetObjectExtended`。ETag 只會反映物件內容的變更，而不是其中繼資料。
+ `LastModified:` 已儲存物件的 Amazon S3 時間戳記。

## 存取控制
<a name="SOAPPutObjectInlineAccessControl"></a>

您必須擁有儲存貯體的`WRITE`存取權，才能將物件放入儲存貯體。

## 相關資源
<a name="SOAPPutObjectInline_RelatedResources"></a>
+  [PutObject (SOAP API)](SOAPPutObject.md) 
+  [CopyObject (SOAP API)](SOAPCopyObject.md)