Create a new bucket for a specific cloud storage

Select

SaaS

Customer Managed

Create a new bucket for a specific cloud storage

Path Parameters

• cloudStorageId int32 required

application/json

Request Body

oneOf

• Alibaba Cloud Object Storage Service
• Amazon S3
• Ceph Object Gateway (S3-compatible)
• China Mobile oNest
• Cloudian HyperStore
• Dell EMC ECS (S3-compatible)
• EMC Atmos
• Fujitsu Storage ETERNUS CD10000
• Google Cloud Storage
• Hitachi Content Platform
• Hitachi Content Platform for Cloud Scale
• Huawei Object Storage
• IBM Cloud Object Storage (S3-compatible)
• Microsoft Azure Storage
• NetApp StorageGRID
• Nutanix Objects
• OpenStack Object Storage
• Oracle Cloud Infrastructure Archive Storage
• Oracle Cloud Infrastructure Object Storage
• Rackspace Cloud Files
• CCL Vault v2
• S3 Compatible Storage
• Scality RING
• Wasabi Hot Cloud Storage

---

cloudType string required

Possible values: [Alibaba Cloud Object Storage Service]

Name of cloud vendor

mediaAgent object required

id int32

name string

serviceHost string

Default value: oss.aliyuncs.com

IP address or fully qualified domain name or URL for the cloud library based on cloud vendor

credentials object required

id int32

name string

bucket string required

Name of bucket

storageClass string required

Possible values: [Bucket's default, Standard, Standard - Infrequent access, Archive, Standard/Archive (Combined Storage Tiers), Infrequent Access/Archive (Combined Storage Tiers)]

Appropriate storage class for your account

proxyAddress string

If the MediaAgent accesses the mount path using a proxy then proxy server address needs to be provided. If you want to remove proxy information, pass empty string in proxyAddress.

port int32

Port for proxy configuration

username string

Username for proxy configuration

password password

Password for proxy configuration (Should be in Base64 format)

cloudType string required

Possible values: [Amazon S3]

Name of cloud vendor

mediaAgent object required

id int32

name string

serviceHost string required

IP address or fully qualified domain name or URL for the cloud library based on cloud vendor

authentication string required

Possible values: [Access and secret keys, AWS IAM role policy, AWS STS assume role, AWS STS assume role with IAM role policy]

Authentication type for the cloud storage server

arnRole string

Needed for AWS STS assume role and AWS STS assume role with IAM role policy

credentials object

id int32

name string

bucket string required

Name of bucket

storageClass string required

Possible values: [Standard, Reduced Redundancy Storage, Standard - Infrequent access, One zone - Infrequent access, Intelligent tiering, S3 Glacier, Standard/Glacier (Combined Storage Tiers), Standard-IA/Glacier (Combined Storage Tiers), One Zone-IA/Glacier (Combined Storage Tiers), Intelligent-Tiering/Glacier (Combined Storage Tiers), S3 Glacier Deep Archive, Standard/Deep Archive (Combined Storage Tiers), Standard-IA/Deep Archive (Combined Storage Tiers), One Zone-IA/Deep Archive (Combined Storage Tiers), Intelligent-Tiering/Deep Archive (Combined Storage Tiers)]

Appropriate storage class for your account

proxyAddress string

If the MediaAgent accesses the mount path using a proxy then proxy server address needs to be provided. If you want to remove proxy information, pass empty string in proxyAddress.

port int32

Port for proxy configuration

username string

Username for proxy configuration

password password

Password for proxy configuration (Should be in Base64 format)

cloudType string required

Possible values: [Ceph Object Gateway (S3-compatible)]

Name of cloud vendor

mediaAgent object

id int32

name string

serviceHost string required

IP address or fully qualified domain name or URL for the cloud library based on cloud vendor

credentials object required

id int32

name string

bucket string required

Name of bucket

proxyAddress string

If the MediaAgent accesses the mount path using a proxy then proxy server address needs to be provided. If you want to remove proxy information, pass empty string in proxyAddress.

port int32

Port for proxy configuration

username string

Username for proxy configuration

password password

Password for proxy configuration (Should be in Base64 format)

cloudType string required

Possible values: [China Mobile oNest]

Name of cloud vendor

mediaAgent object

id int32

name string

serviceHost string required

IP address or fully qualified domain name or URL for the cloud library based on cloud vendor

credentials object required

id int32

name string

container string required

Name of container

proxyAddress string

If the MediaAgent accesses the mount path using a proxy then proxy server address needs to be provided. If you want to remove proxy information, pass empty string in proxyAddress.

port int32

Port for proxy configuration

username string

Username for proxy configuration

password password

Password for proxy configuration (Should be in Base64 format)

cloudType string required

Possible values: [Cloudian HyperStore]

Name of cloud vendor

mediaAgent object

id int32

name string

serviceHost string required

IP address or fully qualified domain name or URL for the cloud library based on cloud vendor

credentials object required

id int32

name string

bucket string required

Name of bucket

proxyAddress string

If the MediaAgent accesses the mount path using a proxy then proxy server address needs to be provided. If you want to remove proxy information, pass empty string in proxyAddress.

port int32

Port for proxy configuration

username string

Username for proxy configuration

password password

Password for proxy configuration (Should be in Base64 format)

cloudType string required

Possible values: [Dell EMC ECS (S3-compatible)]

Name of cloud vendor

mediaAgent object

id int32

name string

serviceHost string required

IP address or fully qualified domain name or URL for the cloud library based on cloud vendor

credentials object required

id int32

name string

bucket string required

Name of bucket

proxyAddress string

If the MediaAgent accesses the mount path using a proxy then proxy server address needs to be provided. If you want to remove proxy information, pass empty string in proxyAddress.

port int32

Port for proxy configuration

username string

Username for proxy configuration

password password

Password for proxy configuration (Should be in Base64 format)

cloudType string required

Possible values: [EMC Atmos]

Name of cloud vendor

mediaAgent object

id int32

name string

serviceHost string

Default value: accesspoint.atmosonline.com

IP address or fully qualified domain name or URL for the cloud library based on cloud vendor

credentials object required

id int32

name string

rootFolder string required

Root folder for the account

proxyAddress string

If the MediaAgent accesses the mount path using a proxy then proxy server address needs to be provided. If you want to remove proxy information, pass empty string in proxyAddress.

port int32

Port for proxy configuration

username string

Username for proxy configuration

password password

Password for proxy configuration (Should be in Base64 format)

cloudType string required

Possible values: [Fujitsu Storage ETERNUS CD10000]

Name of cloud vendor

mediaAgent object

id int32

name string

serviceHost string required

IP address or fully qualified domain name or URL for the cloud library based on cloud vendor

credentials object required

id int32

name string

bucket string required

Name of bucket

proxyAddress string

If the MediaAgent accesses the mount path using a proxy then proxy server address needs to be provided. If you want to remove proxy information, pass empty string in proxyAddress.

port int32

Port for proxy configuration

username string

Username for proxy configuration

password password

Password for proxy configuration (Should be in Base64 format)

cloudType string required

Possible values: [Google Cloud Storage]

Name of cloud vendor

mediaAgent object

id int32

name string

serviceHost string

Default value: storage.googleapis.com

IP address or fully qualified domain name or URL for the cloud library based on cloud vendor

credentials object required

id int32

name string

bucket string required

Name of bucket

proxyAddress string

If the MediaAgent accesses the mount path using a proxy then proxy server address needs to be provided. If you want to remove proxy information, pass empty string in proxyAddress.

port int32

Port for proxy configuration

username string

Username for proxy configuration

password password

Password for proxy configuration (Should be in Base64 format)

cloudType string required

Possible values: [Hitachi Content Platform]

Name of cloud vendor

mediaAgent object

id int32

name string

serviceHost string required

IP address or fully qualified domain name or URL for the cloud library based on cloud vendor

credentials object required

id int32

name string

StorageNamespace string required

Namespace for the user account

proxyAddress string

If the MediaAgent accesses the mount path using a proxy then proxy server address needs to be provided. If you want to remove proxy information, pass empty string in proxyAddress.

port int32

Port for proxy configuration

username string

Username for proxy configuration

password password

Password for proxy configuration (Should be in Base64 format)

cloudType string required

Possible values: [Hitachi Content Platform for Cloud Scale]

Name of cloud vendor

mediaAgent object

id int32

name string

serviceHost string required

IP address or fully qualified domain name or URL for the cloud library based on cloud vendor

credentials object required

id int32

name string

bucket string required

Name of bucket

proxyAddress string

If the MediaAgent accesses the mount path using a proxy then proxy server address needs to be provided. If you want to remove proxy information, pass empty string in proxyAddress.

port int32

Port for proxy configuration

username string

Username for proxy configuration

password password

Password for proxy configuration (Should be in Base64 format)

cloudType string required

Possible values: [Huawei Object Storage]

Name of cloud vendor

mediaAgent object

id int32

name string

serviceHost string

Default value: obs.myhwclouds.com

IP address or fully qualified domain name or URL for the cloud library based on cloud vendor

credentials object required

id int32

name string

bucket string required

Name of bucket

storageClass string required

Possible values: [Standard, Cold, Standard - Infrequent access]

Appropriate storage class for your account

proxyAddress string

If the MediaAgent accesses the mount path using a proxy then proxy server address needs to be provided. If you want to remove proxy information, pass empty string in proxyAddress.

port int32

Port for proxy configuration

username string

Username for proxy configuration

password password

Password for proxy configuration (Should be in Base64 format)

cloudType string required

Possible values: [IBM Cloud Object Storage (S3-compatible)]

Name of cloud vendor

mediaAgent object

id int32

name string

serviceHost string required

IP address or fully qualified domain name or URL for the cloud library based on cloud vendor

credentials object required

id int32

name string

bucket string required

Name of bucket

proxyAddress string

If the MediaAgent accesses the mount path using a proxy then proxy server address needs to be provided. If you want to remove proxy information, pass empty string in proxyAddress.

port int32

Port for proxy configuration

username string

Username for proxy configuration

password password

Password for proxy configuration (Should be in Base64 format)

cloudType string required

Possible values: [Microsoft Azure Storage]

Name of cloud vendor

mediaAgent object required

id int32

name string

serviceHost string

Default value: blob.core.windows.net

IP address or fully qualified domain name or URL for the cloud library based on cloud vendor

authentication string required

Possible values: [Access and secret keys, IAM VM role assignment, IAM AD application role assignment (Credential Manager)]

Authentication type for the cloud storage server. Only Access & Account Name and IAM AD require credentials.

accountName string

Only for IAM VM and IAM AD

credentials object required

id int32

name string

container string required

Name of container

storageClass string required

Possible values: [Container's default, Hot, Cool, Archive, Hot/Archive (Combined Storage Tiers), Cool/Archive (Combined Storage Tiers)]

Appropriate storage class for your account

proxyAddress string

If the MediaAgent accesses the mount path using a proxy then proxy server address needs to be provided. If you want to remove proxy information, pass empty string in proxyAddress.

port int32

Port for proxy configuration

username string

Username for proxy configuration

password password

Password for proxy configuration (Should be in Base64 format)

cloudType string required

Possible values: [NetApp StorageGRID]

Name of cloud vendor

mediaAgent object

id int32

name string

serviceHost string required

IP address or fully qualified domain name or URL for the cloud library based on cloud vendor

credentials object required

id int32

name string

bucket string required

Name of bucket

proxyAddress string

If the MediaAgent accesses the mount path using a proxy then proxy server address needs to be provided. If you want to remove proxy information, pass empty string in proxyAddress.

port int32

Port for proxy configuration

username string

Username for proxy configuration

password password

Password for proxy configuration (Should be in Base64 format)

cloudType string required

Possible values: [Nutanix Objects]

Name of cloud vendor

mediaAgent object

id int32

name string

serviceHost string required

IP address or fully qualified domain name or URL for the cloud library based on cloud vendor

credentials object required

id int32

name string

bucket string required

Name of bucket

proxyAddress string

If the MediaAgent accesses the mount path using a proxy then proxy server address needs to be provided. If you want to remove proxy information, pass empty string in proxyAddress.

port int32

Port for proxy configuration

username string

Username for proxy configuration

password password

Password for proxy configuration (Should be in Base64 format)

cloudType string required

Possible values: [OpenStack Object Storage]

Name of cloud vendor

mediaAgent object

id int32

name string

serviceHost string required

IP address or fully qualified domain name or URL for the cloud library based on cloud vendor

credentials object required

id int32

name string

container string required

Name of container

proxyAddress string

If the MediaAgent accesses the mount path using a proxy then proxy server address needs to be provided. If you want to remove proxy information, pass empty string in proxyAddress.

port int32

Port for proxy configuration

username string

Username for proxy configuration

password password

Password for proxy configuration (Should be in Base64 format)

cloudType string required

Possible values: [Oracle Cloud Infrastructure Archive Storage]

Name of cloud vendor

mediaAgent object

id int32

name string

serviceHost string

Default value: objectstorage.us-phoenix-1.oraclecloud.com

IP address or fully qualified domain name or URL for the cloud library based on cloud vendor

credentials object required

id int32

name string

compartmentName string required

OCI compartment name

bucket string required

Name of bucket

proxyAddress string

If the MediaAgent accesses the mount path using a proxy then proxy server address needs to be provided. If you want to remove proxy information, pass empty string in proxyAddress.

port int32

Port for proxy configuration

username string

Username for proxy configuration

password password

Password for proxy configuration (Should be in Base64 format)

cloudType string required

Possible values: [Oracle Cloud Infrastructure Object Storage]

Name of cloud vendor

mediaAgent object

id int32

name string

serviceHost string

Default value: objectstorage.us-phoenix-1.oraclecloud.com

IP address or fully qualified domain name or URL for the cloud library based on cloud vendor

credentials object required

id int32

name string

compartmentName string

OCI compartment name

bucket string required

Name of the bucket

storageClass string required

Possible values: [Infrequent access, Standard, Archive]

Appropriate storage class for your account

useCombinedStorage boolean

Applicable for Archive storage class only

combinedStorageClass string

Possible values: [Infrequent access, Standard]

Appropriate combined storage class for archive. Applicable only when useCombinedStorage is true.

proxyAddress string

If the MediaAgent accesses the mount path using a proxy then proxy server address needs to be provided. If you want to remove proxy information, pass empty string in proxyAddress.

port int32

Port for proxy configuration

username string

Username for proxy configuration

password password

Password for proxy configuration (Should be in Base64 format)

cloudType string required

Possible values: [Rackspace Cloud Files]

Name of cloud vendor

mediaAgent object

id int32

name string

serviceHost string

Default value: api.mosso.com

IP address or fully qualified domain name or URL for the cloud library based on cloud vendor

credentials object required

id int32

name string

container string required

Name of container

proxyAddress string

If the MediaAgent accesses the mount path using a proxy then proxy server address needs to be provided. If you want to remove proxy information, pass empty string in proxyAddress.

port int32

Port for proxy configuration

username string

Username for proxy configuration

password password

Password for proxy configuration (Should be in Base64 format)

cloudType string required

Possible values: [CCL Vault v2]

Name of cloud vendor

mediaAgent object

id int32

name string

serviceHost string required

Default value: s3-nzl.vault.net.nz

IP address or fully qualified domain name or URL for the cloud library based on cloud vendor

credentials object required

id int32

name string

bucket string required

Name of bucket

proxyAddress string

If the MediaAgent accesses the mount path using a proxy then proxy server address needs to be provided. If you want to remove proxy information, pass empty string in proxyAddress.

port int32

Port for proxy configuration

username string

Username for proxy configuration

password password

Password for proxy configuration (Should be in Base64 format)

cloudType string required

Possible values: [S3 Compatible Storage]

Name of cloud vendor

mediaAgent object

id int32

name string

serviceHost string required

IP address or fully qualified domain name or URL for the cloud library based on cloud vendor

credentials object required

id int32

name string

bucket string required

Name of bucket

proxyAddress string

If the MediaAgent accesses the mount path using a proxy then proxy server address needs to be provided. If you want to remove proxy information, pass empty string in proxyAddress.

port int32

Port for proxy configuration

username string

Username for proxy configuration

password password

Password for proxy configuration (Should be in Base64 format)

cloudType string required

Possible values: [Scality RING]

Name of cloud vendor

mediaAgent object

id int32

name string

serviceHost string required

IP address or fully qualified domain name or URL for the cloud library based on cloud vendor

credentials object required

id int32

name string

bucket string required

Name of bucket

proxyAddress string

If the MediaAgent accesses the mount path using a proxy then proxy server address needs to be provided. If you want to remove proxy information, pass empty string in proxyAddress.

port int32

Port for proxy configuration

username string

Username for proxy configuration

password password

Password for proxy configuration (Should be in Base64 format)

cloudType string required

Possible values: [Wasabi Hot Cloud Storage]

Name of cloud vendor

mediaAgent object

id int32

name string

serviceHost string required

IP address or fully qualified domain name or URL for the cloud library based on cloud vendor

credentials object required

id int32

name string

bucket string required

Name of bucket

proxyAddress string

If the MediaAgent accesses the mount path using a proxy then proxy server address needs to be provided. If you want to remove proxy information, pass empty string in proxyAddress.

port int32

Port for proxy configuration

username string

Username for proxy configuration

password password

Password for proxy configuration (Should be in Base64 format)

Responses

• 200
• 400
• 404
• 500

---

Success

application/json

• Schema
• Example (from schema)

---

Schema

• id int32
• name string
• errorMessage string
• errorCode int32

{
  "id": 0,
  "name": "string",
  "errorMessage": "string",
  "errorCode": 0
}

Bad Request

Requested Details not found

application/json

• Schema
• Example (from schema)

---

Schema

• errorMessage string
• errorCode int32

{
  "errorMessage": "string",
  "errorCode": 0
}

Internal Server Error

POST /v4/storage/cloud/:cloudstorageid/bucket    

Authorization

type: apiKeyname: Authtokenin: header

Request

Click Edit to configure Base URL

https://CommandCenterHostName/commandcenter/api

Security Scheme

tokenbearerToken

token

cloudStorageId — path required

Body

• Default
• Amazon S3

---

{
  "cloudType": "Alibaba Cloud Object Storage Service",
  "mediaAgent": {
    "id": 0,
    "name": "string"
  },
  "serviceHost": "oss.aliyuncs.com",
  "credentials": {
    "id": 0,
    "name": "string"
  },
  "bucket": "string",
  "storageClass": "Bucket's default",
  "proxyAddress": "string",
  "port": 0,
  "username": "string",
  "password": "string"
}

curl -L -X POST 'https://CommandCenterHostName/commandcenter/api/V4/Storage/Cloud/:cloudStorageId/Bucket' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authtoken: <API_KEY_VALUE>' \
--data-raw '{
  "cloudType": "Alibaba Cloud Object Storage Service",
  "mediaAgent": {
    "id": 0,
    "name": "string"
  },
  "serviceHost": "oss.aliyuncs.com",
  "credentials": {
    "id": 0,
    "name": "string"
  },
  "bucket": "string",
  "storageClass": "Bucket'\''s default",
  "proxyAddress": "string",
  "port": 0,
  "username": "string",
  "password": "string"
}'

curl -L -X POST 'https://CommandCenterHostName/commandcenter/api/V4/Storage/Cloud/:cloudStorageId/Bucket' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authtoken: <API_KEY_VALUE>' \
--data-raw '{
  "cloudType": "Alibaba Cloud Object Storage Service",
  "mediaAgent": {
    "id": 0,
    "name": "string"
  },
  "serviceHost": "oss.aliyuncs.com",
  "credentials": {
    "id": 0,
    "name": "string"
  },
  "bucket": "string",
  "storageClass": "Bucket'\''s default",
  "proxyAddress": "string",
  "port": 0,
  "username": "string",
  "password": "string"
}'

curl -L -X POST 'https://CommandCenterHostName/commandcenter/api/V4/Storage/Cloud/:cloudStorageId/Bucket' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authtoken: <API_KEY_VALUE>' \
--data-raw '{
  "cloudType": "Alibaba Cloud Object Storage Service",
  "mediaAgent": {
    "id": 0,
    "name": "string"
  },
  "serviceHost": "oss.aliyuncs.com",
  "credentials": {
    "id": 0,
    "name": "string"
  },
  "bucket": "string",
  "storageClass": "Bucket'\''s default",
  "proxyAddress": "string",
  "port": 0,
  "username": "string",
  "password": "string"
}'

curl -L -X POST 'https://CommandCenterHostName/commandcenter/api/V4/Storage/Cloud/:cloudStorageId/Bucket' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authtoken: <API_KEY_VALUE>' \
--data-raw '{
  "cloudType": "Alibaba Cloud Object Storage Service",
  "mediaAgent": {
    "id": 0,
    "name": "string"
  },
  "serviceHost": "oss.aliyuncs.com",
  "credentials": {
    "id": 0,
    "name": "string"
  },
  "bucket": "string",
  "storageClass": "Bucket'\''s default",
  "proxyAddress": "string",
  "port": 0,
  "username": "string",
  "password": "string"
}'

curl -L -X POST 'https://CommandCenterHostName/commandcenter/api/V4/Storage/Cloud/:cloudStorageId/Bucket' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authtoken: <API_KEY_VALUE>' \
--data-raw '{
  "cloudType": "Alibaba Cloud Object Storage Service",
  "mediaAgent": {
    "id": 0,
    "name": "string"
  },
  "serviceHost": "oss.aliyuncs.com",
  "credentials": {
    "id": 0,
    "name": "string"
  },
  "bucket": "string",
  "storageClass": "Bucket'\''s default",
  "proxyAddress": "string",
  "port": 0,
  "username": "string",
  "password": "string"
}'

curl -L -X POST 'https://CommandCenterHostName/commandcenter/api/V4/Storage/Cloud/:cloudStorageId/Bucket' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authtoken: <API_KEY_VALUE>' \
--data-raw '{
  "cloudType": "Alibaba Cloud Object Storage Service",
  "mediaAgent": {
    "id": 0,
    "name": "string"
  },
  "serviceHost": "oss.aliyuncs.com",
  "credentials": {
    "id": 0,
    "name": "string"
  },
  "bucket": "string",
  "storageClass": "Bucket'\''s default",
  "proxyAddress": "string",
  "port": 0,
  "username": "string",
  "password": "string"
}'

curl -L -X POST 'https://CommandCenterHostName/commandcenter/api/V4/Storage/Cloud/:cloudStorageId/Bucket' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authtoken: <API_KEY_VALUE>' \
--data-raw '{
  "cloudType": "Alibaba Cloud Object Storage Service",
  "mediaAgent": {
    "id": 0,
    "name": "string"
  },
  "serviceHost": "oss.aliyuncs.com",
  "credentials": {
    "id": 0,
    "name": "string"
  },
  "bucket": "string",
  "storageClass": "Bucket'\''s default",
  "proxyAddress": "string",
  "port": 0,
  "username": "string",
  "password": "string"
}'