2017-01-04 08:39:22 +01:00
|
|
|
# Management REST API
|
|
|
|
|
|
|
|
## Authentication
|
|
|
|
- AWS signatureV4
|
|
|
|
- We use "minio" as region. Here region is set only for signature calculation.
|
|
|
|
|
|
|
|
## List of management APIs
|
|
|
|
- Service
|
|
|
|
- Restart
|
|
|
|
- Status
|
2017-01-17 23:25:59 +01:00
|
|
|
- SetCredentials
|
2017-01-04 08:39:22 +01:00
|
|
|
|
|
|
|
- Locks
|
|
|
|
- List
|
|
|
|
- Clear
|
|
|
|
|
|
|
|
- Healing
|
|
|
|
|
|
|
|
### Service Management APIs
|
|
|
|
* Restart
|
|
|
|
- POST /?service
|
|
|
|
- x-minio-operation: restart
|
|
|
|
- Response: On success 200
|
|
|
|
|
|
|
|
* Status
|
|
|
|
- GET /?service
|
|
|
|
- x-minio-operation: status
|
2017-01-23 17:56:06 +01:00
|
|
|
- Response: On success 200, return json formatted object which contains StorageInfo and ServerVersion structures
|
2017-01-04 08:39:22 +01:00
|
|
|
|
2017-01-17 23:25:59 +01:00
|
|
|
* SetCredentials
|
|
|
|
- GET /?service
|
|
|
|
- x-minio-operation: set-credentials
|
|
|
|
- Response: Success 200
|
|
|
|
- Possible error responses
|
|
|
|
- ErrMethodNotAllowed
|
|
|
|
<Error>
|
|
|
|
<Code>MethodNotAllowed</Code>
|
|
|
|
<Message>The specified method is not allowed against this resource.</Message>
|
|
|
|
<Key></Key>
|
|
|
|
<BucketName></BucketName>
|
|
|
|
<Resource>/</Resource>
|
|
|
|
<RequestId>3L137</RequestId>
|
|
|
|
<HostId>3L137</HostId>
|
|
|
|
</Error>
|
|
|
|
- ErrAdminBadCred
|
|
|
|
<Error>
|
|
|
|
<Code>XMinioBadCred</Code>
|
|
|
|
<Message>XMinioBadCred</Message>
|
|
|
|
<Key></Key>
|
|
|
|
<BucketName></BucketName>
|
|
|
|
<Resource>/</Resource>
|
|
|
|
<RequestId>3L137</RequestId>
|
|
|
|
<HostId>3L137</HostId>
|
|
|
|
</Error>
|
|
|
|
- ErrInternalError
|
|
|
|
<Error>
|
|
|
|
<Code>InternalError</Code>
|
|
|
|
<Message>We encountered an internal error, please try again.</Message>
|
|
|
|
<Key></Key>
|
|
|
|
<BucketName></BucketName>
|
|
|
|
<Resource>/</Resource>
|
|
|
|
<RequestId>3L137</RequestId>
|
|
|
|
<HostId>3L137</HostId>
|
|
|
|
</Error>
|
|
|
|
|
|
|
|
|
2017-01-04 08:39:22 +01:00
|
|
|
### Lock Management APIs
|
|
|
|
* ListLocks
|
2017-02-01 20:17:30 +01:00
|
|
|
- GET /?lock&bucket=mybucket&prefix=myprefix&duration=duration
|
2017-01-04 08:39:22 +01:00
|
|
|
- x-minio-operation: list
|
2017-02-01 20:17:30 +01:00
|
|
|
- Response: On success 200, json encoded response containing all locks held, for longer than duration.
|
2017-01-04 08:39:22 +01:00
|
|
|
- Possible error responses
|
|
|
|
- ErrInvalidBucketName
|
|
|
|
<Error>
|
|
|
|
<Code>InvalidBucketName</Code>
|
|
|
|
<Message>The specified bucket is not valid.</Message>
|
|
|
|
<Key></Key>
|
|
|
|
<BucketName></BucketName>
|
|
|
|
<Resource>/</Resource>
|
|
|
|
<RequestId>3L137</RequestId>
|
|
|
|
<HostId>3L137</HostId>
|
|
|
|
</Error>
|
|
|
|
|
|
|
|
- ErrInvalidObjectName
|
|
|
|
<Error>
|
|
|
|
<Code>XMinioInvalidObjectName</Code>
|
|
|
|
<Message>Object name contains unsupported characters. Unsupported characters are `^*|\"</Message>
|
|
|
|
<Key></Key>
|
|
|
|
<BucketName></BucketName>
|
|
|
|
<Resource>/</Resource>
|
|
|
|
<RequestId>3L137</RequestId>
|
|
|
|
<HostId>3L137</HostId>
|
|
|
|
</Error>
|
|
|
|
|
|
|
|
- ErrInvalidDuration
|
|
|
|
<Error>
|
|
|
|
<Code>InvalidDuration</Code>
|
2017-02-01 20:17:30 +01:00
|
|
|
<Message>Duration provided in the request is invalid.</Message>
|
2017-01-04 08:39:22 +01:00
|
|
|
<Key></Key>
|
|
|
|
<BucketName></BucketName>
|
|
|
|
<Resource>/</Resource>
|
|
|
|
<RequestId>3L137</RequestId>
|
|
|
|
<HostId>3L137</HostId>
|
|
|
|
</Error>
|
|
|
|
|
|
|
|
|
|
|
|
* ClearLocks
|
2017-02-01 20:17:30 +01:00
|
|
|
- POST /?lock&bucket=mybucket&prefix=myprefix&duration=duration
|
2017-01-04 08:39:22 +01:00
|
|
|
- x-minio-operation: clear
|
2017-02-01 20:17:30 +01:00
|
|
|
- Response: On success 200, json encoded response containing all locks cleared, for longer than duration.
|
2017-01-04 08:39:22 +01:00
|
|
|
- Possible error responses, similar to errors listed in ListLocks.
|
|
|
|
- ErrInvalidBucketName
|
|
|
|
- ErrInvalidObjectName
|
|
|
|
- ErrInvalidDuration
|
2017-01-19 18:34:18 +01:00
|
|
|
|
|
|
|
### Healing
|
|
|
|
|
|
|
|
* ListBucketsHeal
|
|
|
|
- GET /?heal
|
|
|
|
- x-minio-operation: list-buckets
|