Amazon S3 Uploads (bucket-level)

openapi: 3.1.0
info:
  title: Amazon S3 Uploads (bucket-level)
  description: '1 operations from the Amazon S3 REST API, generated from the authoritative service model.


    S3 identifies these operations by the `uploads` query subresource, which is declared as a required
    query parameter on each one because an OpenAPI path cannot carry a query string.


    Generated from boto/botocore `service-2.json` at `aeb03fc4ae530e0b3f47d588b6021581db870c8c` (Apache-2.0).
    Responses are XML.'
  version: '2006-03-01'
  contact:
    name: AWS Support
    url: https://aws.amazon.com/premiumsupport/
externalDocs:
  description: Amazon S3 API Reference
  url: https://docs.aws.amazon.com/AmazonS3/latest/API/
servers:
- url: https://s3.{region}.amazonaws.com
  variables:
    region:
      default: us-east-1
tags:
- name: uploads
paths:
  /{Bucket}:
    get:
      operationId: ListMultipartUploads
      summary: This operation lists in-progress multipart uploads in a bucket. An in-progress multipart
        upload is a multipart upload th
      description: This operation lists in-progress multipart uploads in a bucket. An in-progress multipart
        upload is a multipart upload that has been initiated by the CreateMultipartUpload request, but
        has not yet been completed or aborted. Directory buckets - If multipart uploads in a directory
        bucket are in progress, you can't delete the bucket until all the in-progress multipart uploads
        are aborted or completed. To delete these in-progress multipart uploads, use the ListMultipartUploads
        operation to list the in-progress multipart uploads in the bucket and use the AbortMultipartUpload
        operation to abort all the in-progress multipart uploads. The ListMultipartUploads operation returns
        a maximum of 1,000 multipart uploads in the response. The limit of 1,000 multipart uploads is
        also the default value. You can further limit the number of uploads in a response by specifying
        the max-uploads request parameter. If there are more than 1,000 multipart uploads that satisfy
        your ListMultipartUploads request, the response returns an IsTruncated element with the value
        of true, a NextKeyMarker element, and a NextUploadIdMarker element. To list the remaining multipart
        uploads, you need to make subsequent ListMul
      tags:
      - uploads
      parameters:
      - name: uploads
        in: query
        required: true
        description: Selects this operation. S3 identifies it by the `uploads` subresource.
        schema:
          type: string
      - name: Bucket
        in: path
        required: true
        description: The name of the bucket to which the multipart upload was initiated. Directory buckets
          - When you use this operation with a directory bucket, you must use virtual-hosted-style requests
          in the format Bu
        schema:
          type: string
      - name: delimiter
        in: query
        required: false
        description: Character you use to group keys. All keys that contain the same string between the
          prefix, if specified, and the first occurrence of the delimiter after the prefix are grouped
          under a single result el
        schema:
          type: string
      - name: encoding-type
        in: query
        required: false
        schema:
          type: string
          enum:
          - url
      - name: key-marker
        in: query
        required: false
        description: Specifies the multipart upload after which listing should begin. General purpose
          buckets - For general purpose buckets, key-marker is an object key. Together with upload-id-marker,
          this parameter spec
        schema:
          type: string
      - name: max-uploads
        in: query
        required: false
        description: Sets the maximum number of multipart uploads, from 1 to 1,000, to return in the response
          body. 1,000 is the maximum number of uploads that can be returned in a response.
        schema:
          type: integer
      - name: prefix
        in: query
        required: false
        description: Lists in-progress uploads only for those keys that begin with the specified prefix.
          You can use prefixes to separate a bucket into different grouping of keys. (You can think of
          using prefix to make gr
        schema:
          type: string
      - name: upload-id-marker
        in: query
        required: false
        description: Together with key-marker, specifies the multipart upload after which listing should
          begin. If key-marker is not specified, the upload-id-marker parameter is ignored. Otherwise,
          any multipart uploads f
        schema:
          type: string
      - name: x-amz-expected-bucket-owner
        in: header
        required: false
        description: The account ID of the expected bucket owner. If the account ID that you provide does
          not match the actual owner of the bucket, the request fails with the HTTP status code 403 Forbidden
          (access denied)
        schema:
          type: string
      - name: x-amz-request-payer
        in: header
        required: false
        schema:
          type: string
          enum:
          - requester
      responses:
        '200':
          description: Success. S3 answers in XML, not JSON.
          x-output-shape: ListMultipartUploadsOutput
        '403':
          description: AccessDenied. S3 validates the signature before it routes the operation, so this
            does not distinguish an unsupported operation from an unauthorised one.