Returns a list of objects associated with the specified bucket.
URI
GET /buckets/${BUCKET}/objects
URI parameters
Name | Type | Default | Description |
---|---|---|---|
BUCKET | string | required | Name of the bucket |
Request parameters
Name | Type | Default | Description |
---|---|---|---|
rows | int | 100 | Sets the maximum number of objects returned in the response body |
lexprefix | string | - | Limits the response to keys that begins with the specified prefix |
lexmarker | string | - | Limits the response to keys that starts from the specified marker |
Response
List of objects
Example
curl -fsSL \
-XGET ${ENDPOINT}/buckets/example-bucket/objects \
-H "authorization: Bearer ${ACCESS_TOKEN}"
[
{
"data": {
"size": 1
},
"id": "example1"
},
{
"data": {
"size": 2
},
"id": "example2"
}
Returns an object associated with the specified bucket.
URI
GET /buckets/${BUCKET}/objects/${KEY}
URI parameters
Name | Type | Default | Description |
---|---|---|---|
BUCKET | string | required | Name of the bucket |
KEY | string | required | Key of the object |
Response
Object
Example
curl -fsSL \
-XGET ${ENDPOINT}/buckets/example-bucket/objects/example \
-H "authorization: Bearer ${ACCESS_TOKEN}"
Creates new or updates an existing object.
URI
PUT /buckets/${BUCKET}/objects/${KEY}
URI parameters
Name | Type | Default | Description |
---|---|---|---|
BUCKET | string | required | Name of the bucket |
KEY | string | required | Key of the object |
URI parameters
Name | Type | Default | Description |
---|---|---|---|
content-type | string | required | MIME type of the object |
content-length | string | required | The size of the object in bytes |
content-encoding | string | - | Indicates which encodings were applied to the object |
cache-control | string | - | Caching directives (no-store , no-cache , max-age=31536000 , etc.) |
x-datastore-acl | [object] | - | ACL entries associated with the object |
Response
empty
Example
curl -fsSL \
-XPUT ${ENDPOINT}/buckets/example-bucket/objects/example \
-H "authorization: Bearer ${ACCESS_TOKEN}" \
-H 'x-datastore-acl: [{"id":"anonymous","data":{"access":"r-"}}]' \
-H 'Content-Type: text/plain' \
--data-binary @example.txt
Removes an existing object.
URI
DELETE /buckets/${BUCKET}/objects/${KEY}
URI parameters
Name | Type | Default | Description |
---|---|---|---|
BUCKET | string | required | Name of the bucket |
KEY | string | required | Key of the object |
Response
empty
Example
curl -fsSL \
-XDELETE ${ENDPOINT}/buckets/example-bucket/objects/example \
-H "Authorization: Bearer ${ACCESS_TOKEN}"