View Bucket

This method retrieves details of a specific bucket

Request Parameters

GET /api/clients/v1/s3Buckets/{id}/

Headers

• Content-Type: application/json
• Authorization: Bearer $access_token

Path

Parameter	Type	Constraints	Description	Example
id	integer	> 0, required	Bucket ID	46

Response Parameters

JSON body

Parameter	Type	Description
id	integer	Bucket ID
name	string	Bucket name
status	string	CDN status for the bucket
resource_id	integer	Resource ID
last_cache_cleanup	string	Last cache cleanup time for the bucket
headers	object[]	List of additional HTTP headers
headers.key	string	Header name
headers.value	string	Header value

200 OK

Bucket object

{
  "id": 46,
  "name": "media",
  "status": "ok",
  "resource_id": 16,
  "last_cache_cleanup": null,
  "headers": [
    {
      "key": "X-MEDIA-TYPE",
      "value": ".pptx"
    }
  ]
}

400 Bad Request

Invalid path parameters

{
  "id": [
    "A valid integer is required."
  ]
}

401 Unauthorized

Authentication credentials missing or invalid

{
  "detail": "Given token not valid for any token type",
  "code": "token_not_valid",
  "messages": [
    {
      "token_class": "AccessToken",
      "token_type": "access",
      "message": "Token is invalid or expired"
    }
  ]
}

403 Forbidden

Bucket access is only permitted for project participants associated with the bucket

{
  "detail": "Only project participants can view this project's buckets"
}

404 Not Found

Bucket with specified ID not found

{
  "detail": "Bucket not found"
}