3.3 KiB

Raw Blame History

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
- SetCredentials
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
- Response: On success 200, return json formatted object which contains StorageInfo and ServerVersion structures
SetCredentials
- GET /?service
- x-minio-operation: set-credentials
- Response: Success 200
- Possible error responses
  - ErrMethodNotAllowed MethodNotAllowed The specified method is not allowed against this resource. / 3L137 3L137
  - ErrAdminBadCred XMinioBadCred XMinioBadCred / 3L137 3L137
  - ErrInternalError InternalError We encountered an internal error, please try again. / 3L137 3L137

Lock Management APIs

ListLocks
- GET /?lock&bucket=mybucket&prefix=myprefix&older-than=rel_time
- x-minio-operation: list
- Response: On success 200, json encoded response containing all locks held, older than rel_time. e.g, older than 3 hours.
- Possible error responses
  - ErrInvalidBucketName InvalidBucketName The specified bucket is not valid. / 3L137 3L137
  - ErrInvalidObjectName XMinioInvalidObjectName Object name contains unsupported characters. Unsupported characters are `^*|" / 3L137 3L137
  - ErrInvalidDuration InvalidDuration Relative duration provided in the request is invalid. / 3L137 3L137
ClearLocks
- POST /?lock&bucket=mybucket&prefix=myprefix&older-than=rel_time
- x-minio-operation: clear
- Response: On success 200, json encoded response containing all locks cleared, older than rel_time. e.g, older than 3 hours.
- Possible error responses, similar to errors listed in ListLocks.
  - ErrInvalidBucketName
  - ErrInvalidObjectName
  - ErrInvalidDuration

Healing

ListBucketsHeal
- GET /?heal
- x-minio-operation: list-buckets