MyFavMirrors/minio
1
0
Fork 0
mirror of https://github.com/minio/minio.git synced 2025-04-19 02:05:24 -04:00
Code Issues Packages Projects Releases Wiki Activity
minio/docs/docs/api/minio.md
Frederick F. Kautz IV eded653fd2 Adding additional entry into bucket list in docs
2015-02-03 17:36:14 -08:00

2.9 KiB
Raw Blame History

Minio API

General Overview

Minio stores and retrieves data in a logical format based upon REST based URLs.

Form:
http://minio.example.com/{bucket}/{path:.*}

Examples:
http://minio.example.com/bucket/object
http://minio.example.com/bucket/path/to/object
http://minio.example.com/bucket2/path/to/object

GET /

List buckets accessible by the user.

Example:

GET / HTTP/1.1

HTTP/1.1 200 OK
Connection: close
Content-Type: application/xml
Server: Minio
Date: Mon, 02 Feb 2015 22:09:00 GMT
Content-Length: 306

<ListAllMyBucketsResult>
  <Owner>
    <ID>minio</ID>
    <DisplayName>minio</DisplayName>
  </Owner>
  <Buckets>
    <Bucket>
      <Name>bucket</Name>
      <CreationDate>2015-01-30T15:20:09.013Z</CreationDate>
    </Bucket>
    <Bucket>
      <Name>minio</Name>
      <CreationDate>2015-01-27T17:46:28.264Z</CreationDate>
    </Bucket>
  </Buckets>
</ListAllMyBucketsResult>

GET /{bucket}/

Lists objects in a bucket.

Example:

GET /minio/ HTTP/1.1

HTTP/1.1 200 OK
Connection: close
Content-Type: application/xml
Server: Minio
Date: Tue, 03 Feb 2015 00:57:59 GMT
Content-Length: 579

<?xml version="1.0"?>
<ListBucketResult>
  <Name>minio</Name>
  <Marker/>
  <MaxKeys>1000</MaxKeys>
  <IsTruncated>false</IsTruncated>
  <Contents>
    <Key>hello</Key>
    <LastModified>2015-02-02T14:52:34.914Z</LastModified>
    <ETag>minio#hello</ETag>
    <Size>75</Size>
    <StorageClass>STANDARD</StorageClass>
    <Owner>
      <ID>minio</ID>
      <DisplayName>minio</DisplayName>
    </Owner>
  </Contents>
  <Contents>
    <Key>one</Key>
    <LastModified>2015-01-27T17:46:28.264Z</LastModified>
    <ETag>minio#one</ETag>
    <Size>4096</Size>
    <StorageClass>STANDARD</StorageClass>
    <Owner>
      <ID>minio</ID>
      <DisplayName>minio</DisplayName>
    </Owner>
  </Contents>
</ListBucketResult>

PUT /{bucket}/

Example:

PUT /books/ HTTP/1.1

HTTP/1.1 200 OK
Connection: close
Server: Minio
Date: Mon, 02 Feb 2015 22:05:43 GMT
Content-Length: 0
Content-Type: text/plain; charset=utf-8

EXAMPLE

GET /{bucket}/{object}

GET /minio/hello HTTP/1.1

HTTP/1.1 200 OK
Connection: close
Content-Length: 75
Content-Type: text/plain
Etag: minio#hello
Last-Modified: Mon, 02 Feb 2015 14:52:34 PST
Server: Minio
Date: Mon, 02 Feb 2015 22:59:51 GMT

<?xml version="1.0"?>
<html>
  <head/>
  <body>Hello World!</body>
</html>

Retrieves an object from a bucket

HEAD /{bucket}/{object}

HEAD /minio/hello HTTP/1.1

HTTP/1.1 200 OK
Connection: close
Content-Length: 75
Content-Type: text/plain
Etag: minio#hello
Last-Modified: Mon, 02 Feb 2015 14:52:34 PST
Server: Minio
Date: Mon, 02 Feb 2015 23:02:30 GMT

Retrieves meta-data about an object

PUT /{bucket}/{object}

Stores an object

PUT /minio/hello HTTP/1.1
Content-Length: 75

<?xml version="1.0"?>
<html>
  <head/>
  <body>Hello World!</body>
</html>

HTTP/1.1 200 OK