- Anis
- KP
- AWS signatureV4
- Region can't be empty string. Currently using "minio" as constant string.
- No versioning in URL.
-
Service
- Stop
- Restart
- Status
-
Locks
- List
- Clear
-
Healing
-
Stop
- POST /?service
- x-minio-operation: stop
- Response: On success 200
-
Restart
- POST /?service
- x-minio-operation: restart
- Response: On success 200
-
Status
- GET /?service
- x-minio-operation: status
- Response: On success 200, json format of StorageInfo
-
List
- 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 // for bucket
- ErrInvalidObjectName // for prefix
- ErrInvalidDuration // for rel_time
-
Clear
- POST /?lock&bucket=mybucket&object=myobject
- x-minio-operation: clear
- Response: On success 200, returning a list of locks that were cleared
- Possible error responses
- ErrInvalidBucketName // for bucket
- ErrInvalidObjectName // for object name
-
StorageFormat
- POST /?heal
- x-minio-operation: format
- Response: On success 200, indicate if format was healed. TBD: {wasHealed:true}
-
HealBucket
- POST /?heal&bucket=mybucket&dry-run=[yes|no]
- x-minio-operation: bucket
- Response: On success 200, return list of objects healed as json.
-
HealObject
- POST /?heal&bucket=mybucket&prefix=myprefix&dry-run=[yes|no]
- x-minio-operation: object
- Response: On success 200, return list of objects matching prefix that were healed.
-
ListObjectHeal
- GET /?heal&bucket=mybucket&prefix=myprefix&marker=mymarker&delimiter=&mydelimiter&maxKey=1000
- x-minio-operation: list
- On success 200, return list of objects matching prefix that require healing.
- On failure one of the following errors are returned.
- ErrServerNotInitialized
- ErrSignatureMismatch
- ErrInvalidObjectName
- ErrInvalidBucketName
- ErrInvalidMaxKeys
- ErrNotImplemented
- ErrInternalError - json marshalling failure
We could also add free space available in the cluster as a part of this API so the operator can query this value to get alerts about space usage.