Objects V1

GET https://s3.amazonaws.com/{{bucket}}/?Delimiter={{Delimiter}}&EncodingType={{EncodingType}}&Marker={{Marker}}&MaxKeys={{MaxKeys}}&Prefix={{Prefix}}

Returns some or all (up to 1000) of the objects in a bucket. You can use the request parameters as selection criteria to return a subset of the objects in a bucket. A 200 OK response can contain valid or invalid XML. Be sure to design your application to parse the contents of the response and handle it appropriately.

Request Params

KeyDatatypeRequiredDescription
Delimiterstring
EncodingTypestring
Markerstring
MaxKeysstring
Prefixstring

HEADERS

KeyDatatypeRequiredDescription
x-amz-content-sha256string
Accept-Encodingstring

RESPONSES

status: OK

"\u003c?xml version=\"1.0\" encoding=\"UTF-8\"?\u003e\n\u003cListBucketResult xmlns=\"http://s3.amazonaws.com/doc/2006-03-01/\"\u003e\n    \u003cName\u003eworking-demo-2\u003c/Name\u003e\n    \u003cPrefix\u003e\u003c/Prefix\u003e\n    \u003cMarker\u003e\u003c/Marker\u003e\n    \u003cMaxKeys\u003e1000\u003c/MaxKeys\u003e\n    \u003cIsTruncated\u003efalse\u003c/IsTruncated\u003e\n    \u003cContents\u003e\n        \u003cKey\u003eanother-folder/\u003c/Key\u003e\n        \u003cLastModified\u003e2019-11-17T05:08:53.000Z\u003c/LastModified\u003e\n        \u003cETag\u003e\u0026quot;d41d8cd98f00b204e9800998ecf8427e\u0026quot;\u003c/ETag\u003e\n        \u003cSize\u003e0\u003c/Size\u003e\n        \u003cOwner\u003e\n            \u003cID\u003e94aebaef4c4fbbe84a36f076a1adbf6208742d219ac1cecb29939e262efabf56\u003c/ID\u003e\n            \u003cDisplayName\u003ekinlane\u003c/DisplayName\u003e\n        \u003c/Owner\u003e\n        \u003cStorageClass\u003eSTANDARD\u003c/StorageClass\u003e\n    \u003c/Contents\u003e\n    \u003cContents\u003e\n        \u003cKey\u003ebf-skinner.jpg\u003c/Key\u003e\n        \u003cLastModified\u003e2019-11-17T05:09:04.000Z\u003c/LastModified\u003e\n        \u003cETag\u003e\u0026quot;a8478262b03109b46277979cad682155\u0026quot;\u003c/ETag\u003e\n        \u003cSize\u003e47000\u003c/Size\u003e\n        \u003cOwner\u003e\n            \u003cID\u003e94aebaef4c4fbbe84a36f076a1adbf6208742d219ac1cecb29939e262efabf56\u003c/ID\u003e\n            \u003cDisplayName\u003ekinlane\u003c/DisplayName\u003e\n        \u003c/Owner\u003e\n        \u003cStorageClass\u003eSTANDARD\u003c/StorageClass\u003e\n    \u003c/Contents\u003e\n    \u003cContents\u003e\n        \u003cKey\u003etest123/\u003c/Key\u003e\n        \u003cLastModified\u003e2019-11-17T05:08:47.000Z\u003c/LastModified\u003e\n        \u003cETag\u003e\u0026quot;d41d8cd98f00b204e9800998ecf8427e\u0026quot;\u003c/ETag\u003e\n        \u003cSize\u003e0\u003c/Size\u003e\n        \u003cOwner\u003e\n            \u003cID\u003e94aebaef4c4fbbe84a36f076a1adbf6208742d219ac1cecb29939e262efabf56\u003c/ID\u003e\n            \u003cDisplayName\u003ekinlane\u003c/DisplayName\u003e\n        \u003c/Owner\u003e\n        \u003cStorageClass\u003eSTANDARD\u003c/StorageClass\u003e\n    \u003c/Contents\u003e\n    \u003cContents\u003e\n        \u003cKey\u003etest123/api-with-examples.yaml.txt\u003c/Key\u003e\n        \u003cLastModified\u003e2019-11-17T06:30:15.000Z\u003c/LastModified\u003e\n        \u003cETag\u003e\u0026quot;c49414d54deb9ce2e61488424adfaaa2\u0026quot;\u003c/ETag\u003e\n        \u003cSize\u003e6337\u003c/Size\u003e\n        \u003cOwner\u003e\n            \u003cID\u003e94aebaef4c4fbbe84a36f076a1adbf6208742d219ac1cecb29939e262efabf56\u003c/ID\u003e\n            \u003cDisplayName\u003ekinlane\u003c/DisplayName\u003e\n        \u003c/Owner\u003e\n        \u003cStorageClass\u003eSTANDARD\u003c/StorageClass\u003e\n    \u003c/Contents\u003e\n    \u003cContents\u003e\n        \u003cKey\u003etest123/callback-example.yaml.txt\u003c/Key\u003e\n        \u003cLastModified\u003e2019-11-17T06:30:15.000Z\u003c/LastModified\u003e\n        \u003cETag\u003e\u0026quot;ee22b187e786232f2d01f943e8410b81\u0026quot;\u003c/ETag\u003e\n        \u003cSize\u003e2158\u003c/Size\u003e\n        \u003cOwner\u003e\n            \u003cID\u003e94aebaef4c4fbbe84a36f076a1adbf6208742d219ac1cecb29939e262efabf56\u003c/ID\u003e\n            \u003cDisplayName\u003ekinlane\u003c/DisplayName\u003e\n        \u003c/Owner\u003e\n        \u003cStorageClass\u003eSTANDARD\u003c/StorageClass\u003e\n    \u003c/Contents\u003e\n\u003c/ListBucketResult\u003e"