All Products
Search
Document Center

ENS:PutBucket

Last Updated:Mar 12, 2024

Creates an EOS bucket.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
LogicalBucketTypestringNo

Single-node storage. Set the value to sink.

sink
CommentstringNo

The remarks. The remarks are 0 to 128 characters in length.

numb
BucketAclstringNo

The access control list (ACL) of the bucket.

  • private (default)
  • public-read-write
  • public-read
private
BucketNamestringYes

The name of the bucket.

This parameter can contain 3 to 50 characters in length and can contain only lowercase letters, digits, and hyphens (-). The name cannot start or end with a hyphen (-).

test
EnsRegionIdstringNo

The ID of the region where the node is located. If this parameter is not specified, the node is the global default node.

cn-beijing-15

Response parameters

ParameterTypeDescriptionExample
object

Schema of Response

RequestIdstring

The ID of the request.

85123E71-7710-4620-8AAB-133CCE49EC83

Examples

Sample success responses

JSONformat

{
  "RequestId": "85123E71-7710-4620-8AAB-133CCE49EC83"
}

Error codes

HTTP status codeError codeError message
400TooManyBucketsThe number of buckets created exceeds the limit.
400Invalid%sSpecified parameter %s is not valid.
400UnSupportedCityThe city is not supported.
400BucketAlreadyExistsThe bucket already exists or is occupied by other users.
400InvalidEngineIdThe engineId does not belong to the city.
400InvalidBucketNameSpecified parameter BucketName is not valid.
400InvalidCommentSpecified parameter Comment is not valid.
400InvalidDataRedundancyTypeSpecified parameter DataRedundancyType is not valid.
400NoPermissionPermission denied.
400InvalidParameter.%sThe specified field %s invalid. Please check it again.
403AccessDeniedauth is not valid
403OperationDeniedThe current ens region has not been purchased
404NoSuchEnsRegionThe ens region does not exist
404NoSuchStorageDomainThe specified storageDomain does not exist.
500InternalErrorThe request processing has failed due to some unknown error.

For a list of error codes, visit the Service error codes.