Link a bucket
Link a bucket to a specified user, unlinking the bucket from any previous user.
Capabilities
`buckets=write`Syntax
PUT /admin/bucket?format=json HTTP/1.1
Host FULLY_QUALIFIED_DOMAIN_NAMERequest Parameters
bucket
- Description
-
The bucket to unlink.
- Type
-
String
- Example
-
foo_bucket - Required
-
Yes
uid
- Description
-
The user ID to link the bucket to.
- Type
-
String
- Example
-
foo_user - Required
-
Yes
Response Entities
bucket
- Description
-
Container for single bucket information.
- Type
-
Container
- Parent
-
N/A
name
- Description
-
The name of the bucket.
- Type
-
String
- Parent
-
bucket
pool
- Description
-
The pool the bucket is stored in.
- Type
-
String
- Parent
-
bucket
id
- Description
-
The unique bucket ID.
- Type
-
String
- Parent
-
bucket
marker
- Description
-
Internal bucket tag.
- Type
-
String
- Parent
-
bucket
owner
- Description
-
The user ID of the bucket owner.
- Type
-
String
- Parent
-
bucket
usage
- Description
-
Storage usage information.
- Type
-
Container
- Parent
-
bucket
index
- Description
-
Status of bucket index.
- Type
-
String
- Parent
-
bucket
Special Error Responses
BucketUnlinkFailed
- Description
-
Unable to unlink bucket from specified user.
- Code
-
409 Conflict
BucketLinkFailed
- Description
-
Unable to link bucket to specified user.
- Code
-
409 Conflict