Create Cloud Storage Type

Details

API DetailsRelease-Specific Information
CloudCenter Platform 4xCloudCenter Suite 5x
NameCreate Cloud Storage Type
Description

Creates a new storage type for the specified cloud region

Allowed Role(s)

WM_USER, WM_ADMIN

MethodPOST
URI

v1/tenants/tenantId/clouds/cloudId/regions/cloudRegionId/storageTypes

cloudcenter-cloud-setup/api/v1/tenants/tenantId/clouds/cloudId/regions/cloudRegionId/storageTypes

Sample Request
curl -k -X POST -H "Accept: application/json" -H "Content-Type: application/json" -u cliqradmin:40E45DBE57E35ECB "https://<HOST>:<PORT>/v1/tenants/1/clouds/1/regions/1/storageTypes"
curl -k -X POST -H "Accept: application/json" -H "Content-Type: application/json" -u cliqradmin:40E45DBE57E35ECB "https://<HOST>:<PORT>/cloudcenter-cloud-setup/api/v1/tenants/1/clouds/1/regions/1/storageTypes"
Release
  • Introduced in CloudCenter 4.7.0
  • Updated in CloudCenter 4.8.2 to have configurable values for minVolumeSize and maxVolumeSize

Modified in CloudCenter Suite 5.0.0

Notes
  • Only resource owners and users with WRITE perms can view all the fields for this resource.

  • Other users can only view common fields like name, description, and so forth. See Permission Control for additional context.

  • At least one valid entry in the storage attribute is required for this API call to succeed.
  • The id attribute is required for each cloudStorageType listed in the mappings array.
Back To LinksCloudCenter Platform 4x APIWorkload Manager API

ESB Header

action: create.tenants.tenantId.clouds.cloudId.regions.cloudRegionId.storageTypes

See the Enterprise Service Bus (ESB) section for additional context.

Not applicable

Sample Request Body

{
  "type": "st3",
  "name": "Storage Type 01",
  "description": "Storage Type 01",
  "costPerMonth": 1.32,
  "minVolumeSize": 1,
  "maxVolumeSize": 1600,
  "provisionedIOPS" : true,
  "maxIOPS": 1000,
  "iopsCostPerMonth": 0.34,
  "maxThroughput": 100,
  "regionId": 1
}

Response

{
    "id": "5",
    "resource": "https://<HOST>:<PORT>/v1/tenants/1/clouds/1/region/1/storageTypes/5",
    "name": "Storage Type 01",
    "description": "Storage Type 01",
    "type": "st3",
    "regionId": "1",
    "costPerMonth": 1.32,
    "minVolumeSize": 1,
    "maxVolumeSize": 1600,
    "maxIOPS": 1000,
    "maxThroughput": 100,
    "provisionedIOPS": true,
    "iopsCostPerMonth": 0.34
}


Request Attributes

tenantId

  • Description: Unique, system-generated identifier for the tenant organization. A tenant admin must belong to this tenant to invoke any APIs for this tenant. See the Tenant ID and Tenant Name Dependency section for the relevant release for additional context.

  • Type: String

Required

cloudId

  • Description: Unique, system-generated identifier for a cloud representation (see View Deployment Environments for additional details)

  • Type: String

Required

cloudRegionId
  • Description: Unique, system-generated identifier for a cloud region
  • Type: String

Required

type
  • Description: The type of resource
  • Type: String
name

  • Description: The name assigned for this CloudCenter Resource. Valid characters are letters, numbers, underscores, and spaces.

  • Type: String

description

  • Description: A brief description for this CloudCenter Resource.

  • Type: String
 costPerMonth 
  • Description: Identifies the monthly billing cost for the storage type.
  • Type: Float
minVolumeSize
  • Description: Identifies the minimum supported volume size for the storage type. The minimum acceptable storage size when configuring this attribute is 1GB.
  • Type: Integer
maxVolumeSize
  • Description: Identifies the maximum supported volume size for the storage type. The maximum acceptable storage size when configuring this attribute is 4TB.
  • Type: Integer
provisionedIOPS
  • Description: Identifies if the storage type supports IOPS.
  • Type: Boolean
    • true = The storage type supports IOPS.
    • false = Default. The storage type does not support IOPS.
maxIOPS
  • Description: Identifies the maximum number of Input/Output Operations Per Second (allowed IOPS limit). If provisionedIOPS = true, then you must provide this limit for the storage type.
  • Type: Integer
 iopsCostPerMonth  
  • Description: Identifies the monthly billing IOPS cost for the storage type. Storage has two costs associated with it:
    • The storage size cost
    • The IOPS dependency cost — if provisionedIOPS = true, then based on the provisioned IOPS cost is calculated.
  • Type: Float
maxThroughput
  • Description: Identifies maximum throughput rate for the storage device. It is a property of the storage type and is not used in the storage cost calculation.
  • Type: Integer

Response Attributes

id

  • Description: Unique, system-generated identifier for this CloudCenter Resource.

  • Type: String

resource
  • Description: Unique URL to access this resource.
  • Type: String
name

  • Description: The name assigned for this CloudCenter Resource. Valid characters are letters, numbers, underscores, and spaces.

  • Type: String

description

  • Description: A brief description for this CloudCenter Resource.

  • Type: String
type
  • Description: The type of resource
  • Type: String
regionId

  • Description: Unique, system-generated identifier for the cloud region 

  • Type: String

 costPerMonth 
  • Description: Identifies the monthly billing cost for the storage type.
  • Type: Float
minVolumeSize
  • Description: Identifies the minimum supported volume size for the storage type. The minimum acceptable storage size when configuring this attribute is 1GB.
  • Type: Integer
maxVolumeSize
  • Description: Identifies the maximum supported volume size for the storage type. The maximum acceptable storage size when configuring this attribute is 4TB.
  • Type: Integer
maxIOPS
  • Description: Identifies the maximum number of Input/Output Operations Per Second (allowed IOPS limit). If provisionedIOPS = true, then you must provide this limit for the storage type.
  • Type: Integer
maxThroughput
  • Description: Identifies maximum throughput rate for the storage device. It is a property of the storage type and is not used in the storage cost calculation.
  • Type: Integer
provisionedIOPS
  • Description: Identifies if the storage type supports IOPS.
  • Type: Boolean
    • true = The storage type supports IOPS.
    • false = Default. The storage type does not support IOPS.
 iopsCostPerMonth  
  • Description: Identifies the monthly billing IOPS cost for the storage type. Storage has two costs associated with it:
    • The storage size cost
    • The IOPS dependency cost — if provisionedIOPS = true, then based on the provisioned IOPS cost is calculated.
  • Type: Float


© 2017-2019 Cisco Systems, Inc. All rights reserved