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

# 上傳附件
<a name="upload-attachments"></a>

您可以在建立支援案例或回覆現有案例時連接檔案。您最多可以連接 10 個檔案，每個檔案最多 150 MB。

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

**使用主控台上傳附件**

1. 在**建立案例**頁面或案例的回覆區段中，選擇**選擇檔案**。

1. 從檔案挑選器選取最多 10 個檔案。每個檔案最多可達 150 MB。每個檔案會立即開始上傳，狀態****欄會在上傳期間顯示即時進度列。

1. 當檔案完成上傳時，狀態會變更為**上傳完成**，且**動作**欄會顯示**移除**。

1. 所有檔案都達到**上傳完成**狀態後，請完成其餘案例欄位，然後選擇**提交**。

提交案例後，上傳的附件會在**案例詳細資訊**頁面上的案例通訊中顯示為可點選連結。

------
#### [ AWS 支援 API ]

您可以使用 AWS 支援 API，以程式設計方式將檔案連接至支援案例或案例通訊。API 使用具有預先簽章 URLs分段上傳流程。

**使用 API 上傳附件**

1. **開始上傳。**`GetAttachmentUploadLinks` 使用 `fileName`和 呼叫 `fileSizeBytes`。回應會傳回 `uploadId`、`totalParts`、 `partSizeBytes`和第一批預先簽章上傳 URLs。

1. **分割和上傳您的 檔案。**從檔案開頭循序讀取，將檔案分割為`partSizeBytes`位元組區段。第一個區段對應至 `partIndex` 1，第二個對應至 `partIndex` 2，以此類推。最後一個區段可能小於 `partSizeBytes`。將每個區段放入具有相符 的預先簽章 URL`partIndex`。儲存 Amazon S3 `ETag` 為每個成功 PUT 傳回的 。

1. **視需要取得更多 URLs。**每個呼叫最多傳回 10 URLs。如果您的檔案有超過 10 個部分，請使用相同的 `GetAttachmentUploadLinks`再次呼叫 `uploadId`，並傳遞`nextIndex`為 `uploadRange.startIndex`。重複直到 `nextIndex`為 null。

1. **報告已完成的組件。**一旦 PUT 成功`partIndex`，請針對`ETag`每個部分`CompleteAttachmentUpload`呼叫 `uploadId`、 和 。立即報告組件可讓上傳恢復。如果上傳中斷，則只需要重新上傳未報告的部分。

1. **等待上傳準備就緒。**輪詢 `DescribeAttachmentUploadStatus`直到 `uploadStatus`為 `attachment-ready`。處理是非同步的，大型檔案可能需要幾分鐘的時間。

1. **連接至案例。**在 `CreateCase`或 的 `uploadIds` 參數`uploadId`中傳遞 `AddCommunicationToCase`。

**uploadId 與 attachmentId**  
`uploadId` 可識別進行中的上傳工作階段，並與上傳操作 (`GetAttachmentUploadLinks`、`CompleteAttachmentUpload`、`DescribeAttachmentUploadStatus`) 和 搭配使用，做為 `CreateCase`或 的輸入`AddCommunicationToCase`。  
上傳遞交至案例通訊後，`attachmentId`會產生 。使用 `GetAttachmentDownloadLink`搭配 `attachmentId`下載附件。您可以從 `attachmentId` `Communication`傳回`attachments`的 欄位取得 `DescribeCommunications`。

**注意**  
`DescribeAttachment` 僅支援 5 MB 或更小的附件。呼叫`DescribeAttachment`較大的附件會傳回 `InvalidParameterValueException`。若要下載大於 5 MB 的附件，請使用 `GetAttachmentDownloadLink`。

**端點**

這些操作傳回的預先簽章 URLs 會從下列網域提供：
+ **上傳 URLs**(`GetAttachmentUploadLinks`)： `v1.uploads.attachments.support.us-east-1.amazonaws.com`
+ **下載 URLs**(`GetAttachmentDownloadLink`)： `v1.downloads.attachments.support.us-east-1.amazonaws.com`

如果您的環境限制傳出流量，請確定兩個網域都可以連線。

**限制條件**
+ 每次上傳的檔案大小上限：150 MB。
+ 每次呼叫傳回的上傳 URLs 上限`GetAttachmentUploadLinks`：10。
+ `uploadIds` 每個 `CreateCase`或 `AddCommunicationToCase`請求的最大數量：10。

------