minio/docs/zh_CN/admin-api/README.md
2017-11-22 15:15:40 -08:00

3.3 KiB

管理REST API

认证

  • AWS signatureV4
  • 我们使用minio作为区域。 这里区域仅用于签名计算。

##管理接口

  • Service

    • Restart
    • Status
    • SetCredentials
  • Locks

    • List
    • Clear
  • Healing

服务管理接口

  • 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
      <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>
      

锁管理API

  • ListLocks

    • GET /?lock&bucket=mybucket&prefix=myprefix&duration=duration

    • x-minio-operation: list

    • Response: On success 200, json encoded response containing all locks held, for longer than duration.

    • 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 `^*|\&#34;</Message>
          <Key></Key>
          <BucketName></BucketName>
          <Resource>/</Resource>
          <RequestId>3L137</RequestId>
          <HostId>3L137</HostId>
      </Error>
      
      • ErrInvalidDuration
        <Error>
            <Code>InvalidDuration</Code>
            <Message>Duration provided in the request is invalid.</Message>
            <Key></Key>
            <BucketName></BucketName>
            <Resource>/</Resource>
            <RequestId>3L137</RequestId>
            <HostId>3L137</HostId>
        </Error>
        
  • ClearLocks

    • POST /?lock&bucket=mybucket&prefix=myprefix&duration=duration
    • x-minio-operation: clear
    • Response: On success 200, json encoded response containing all locks cleared, for longer than duration.
    • Possible error responses, similar to errors listed in ListLocks.
      • ErrInvalidBucketName
      • ErrInvalidObjectName
      • ErrInvalidDuration

修复

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