与 AWS SDK或AbortMultipartUpload一起使用 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 命令中止存储桶 my-bucket 中键 multipart/01 的分段上传：

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

此命令所需的上传 ID 由 create-multipart-upload 输出，也可以使用 list-multipart-uploads 进行检索。

• 有关API详细信息，请参阅 “AbortMultipartUpload AWS CLI命令参考”。

PowerShell

用于 PowerShell

示例 1：此命令中止在 5 天前创建的分段上传。

Remove-S3MultipartUpload -BucketName amzn-s3-demo-bucket -DaysBefore 5

示例 2：此命令中止在 2014 年 1 月 2 日之前创建的分段上传。

Remove-S3MultipartUpload -BucketName amzn-s3-demo-bucket -InitiatedDate "Thursday, January 02, 2014"

示例 3：此命令中止在 2014 年 1 月 2 日 10:45:37 之前创建的分段上传。

Remove-S3MultipartUpload -BucketName amzn-s3-demo-bucket -InitiatedDate "2014/01/02 10:45:37"

• 有关API详细信息，请参阅 AWS Tools for PowerShell Cmdlet 参考AbortMultipartUpload中的。