搭AbortMultipartUpload配 AWS SDK或使用 CLI

下列程式碼範例會示範如何使用AbortMultipartUpload。

動作範例是大型程式的程式碼摘錄，必須在內容中執行。您可以在下列程式碼範例的內容中看到此動作：

• 刪除不完整的分段上傳

• 使用 Amazon S3 物件完整性

C++

SDK對於 C ++

注意

還有更多關於 GitHub。尋找完整範例，並了解如何在AWS 設定和執行程式碼範例儲存庫。

//! Abort a multipart upload to an S3 bucket.
/*!
    \param bucket: The name of the S3 bucket where the object will be uploaded.
    \param key: The unique identifier (key) for the object within the S3 bucket.
    \param uploadID: An upload ID string.
    \param client: The S3 client instance used to perform the upload operation.
    \return bool: Function succeeded.
*/

bool AwsDoc::S3::abortMultipartUpload(const Aws::String &bucket,
                                      const Aws::String &key,
                                      const Aws::String &uploadID,
                                      const Aws::S3::S3Client &client) {
    Aws::S3::Model::AbortMultipartUploadRequest request;
    request.SetBucket(bucket);
    request.SetKey(key);
    request.SetUploadId(uploadID);

    Aws::S3::Model::AbortMultipartUploadOutcome outcome =
            client.AbortMultipartUpload(request);

    if (outcome.IsSuccess()) {
        std::cout << "Multipart upload aborted." << std::endl;
    } else {
        std::cerr << "Error aborting multipart upload: " << outcome.GetError().GetMessage() << std::endl;
    }

    return outcome.IsSuccess();
}

• 如需詳API細資訊，請參閱AWS SDK for C++ API參考AbortMultipartUpload中的。

CLI

AWS CLI

中止指定的分段上傳

下列abort-multipart-upload指令會中止儲存貯體multipart/01中金鑰的多部分上傳。my-bucket

aws s3api abort-multipart-upload \
    --bucket my-bucket \
    --key multipart/01 \
    --upload-id dfRtDYU0WWCCcH43C3WFbkRONycyCpTJJvxu2i5GYkZljF.Yxwh6XG7WfS2vC4to6HiV6Yjlx.cph0gtNBtJ8P3URCSbB7rjxI5iEwVDmgaXZOGgkk5nVTW16HOQ5l0R

此命令所需的上傳 ID 由輸出create-multipart-upload，也可以使用擷取list-multipart-uploads。

• 如需詳API細資訊，請參閱AWS CLI 指令參考AbortMultipartUpload中的。

PowerShell

用於的工具 PowerShell

範例 1：此指令會中止 5 天前建立的分段上傳。

Remove-S3MultipartUpload -BucketName test-files -DaysBefore 5

範例 2：此指令會中止在 2014 年 1 月 2 日之前建立的分段上傳。

Remove-S3MultipartUpload -BucketName test-files -InitiatedDate "Thursday, January 02, 2014"

範例 3：此指令會中止在 2014 年 1 月 2 日 10:45：37 之前建立的分段上傳。

Remove-S3MultipartUpload -BucketName test-files -InitiatedDate "2014/01/02 10:45:37"

• 如需詳API細資訊，請參閱AWS Tools for PowerShell 指令程AbortMultipartUpload式參考中的。

如需 AWS SDK開發人員指南和程式碼範例的完整清單，請參閱搭配 AWS SDK 使用此服務。本主題也包含有關入門的資訊以及舊SDK版的詳細資訊。