Endpoint

/v1/s3/buckets/{name}/uploads/

GET

List all in-progress S3 uploads for a specific bucket.

Parameters

Name Description Required
name Bucket name Yes
after Return entries after the given key (keys are returned in the paging object) No
limit Return no more than this many entries; the system may choose a smaller limit. No

Response

Codes

Code Description
200 Return value on success

Schema

{
  "description": "api_upload_description_list_model",
  "type": "object",
  "properties": {
    "uploads": {
      "type": "array",
      "items": {
        "description": "uploads",
        "type": "object",
        "properties": {
          "id": {
            "description": "The ID of the S3 upload.",
            "type": "string"
          },
          "key": {
            "description": "The key for which the system initiates the upload.",
            "type": "string"
          },
          "bucket": {
            "description": "The name of the S3 bucket to which the upload belongs.",
            "type": "string"
          },
          "initiator": {
            "description": "The system identity that represents the user who initiated the upload.",
            "type": "object",
            "properties": {
              "domain": {
                "type": "string",
                "enum": [
                  "LOCAL",
                  "API_NULL_DOMAIN",
                  "WORLD",
                  "POSIX_USER",
                  "POSIX_GROUP",
                  "ACTIVE_DIRECTORY",
                  "API_INVALID_DOMAIN",
                  "API_RESERVED_DOMAIN",
                  "API_INTERNAL_DOMAIN",
                  "API_OPERATOR_DOMAIN",
                  "API_CREATOR_DOMAIN"
                ],
                "description": "domain:\n * `ACTIVE_DIRECTORY` - ACTIVE_DIRECTORY,\n * `API_CREATOR_DOMAIN` - API_CREATOR_DOMAIN,\n * `API_INTERNAL_DOMAIN` - API_INTERNAL_DOMAIN,\n * `API_INVALID_DOMAIN` - API_INVALID_DOMAIN,\n * `API_NULL_DOMAIN` - API_NULL_DOMAIN,\n * `API_OPERATOR_DOMAIN` - API_OPERATOR_DOMAIN,\n * `API_RESERVED_DOMAIN` - API_RESERVED_DOMAIN,\n * `LOCAL` - LOCAL,\n * `POSIX_GROUP` - POSIX_GROUP,\n * `POSIX_USER` - POSIX_USER,\n * `WORLD` - WORLD"
              },
              "auth_id": {
                "description": "auth_id",
                "type": "string"
              },
              "uid": {
                "description": "uid",
                "type": "number"
              },
              "gid": {
                "description": "gid",
                "type": "number"
              },
              "sid": {
                "description": "sid",
                "type": "string"
              },
              "name": {
                "description": "name",
                "type": "string"
              }
            }
          },
          "initiated": {
            "description": "The time at which the upload was initiated.",
            "type": "string"
          },
          "last_modified": {
            "description": "The time at which the upload was modified last.",
            "type": "string"
          },
          "total_blocks": {
            "description": "The total number of blocks (data and meta blocks) that the upload has used.",
            "type": "string"
          },
          "datablocks": {
            "description": "The number of data blocks that the upload has used.",
            "type": "string"
          },
          "metablocks": {
            "description": "The number of meta blocks that the upload has used.",
            "type": "string"
          },
          "completing": {
            "description": "The upload is in progress.",
            "type": "boolean"
          },
          "system_initiated": {
            "description": "The system has initiated the current upload as part of a different request.",
            "type": "boolean"
          }
        }
      }
    }
  }
}