View Cloud Instance Types

Details

API Details
Name

View Cloud Instance Types

Description
MethodGET
URI
  • v1/tenants/tenantId/clouds/cloudId/regions/cloudRegionId/instanceTypes
  • v1/tenants/tenantId/clouds/cloudId/regions/cloudRegionId/instanceTypes/cloudInstanceTypeId
CloudCenter Release
  • Introduced in CloudCenter 4.0.
  • Enhanced in CloudCenter 4.2 to include the supportHardwareProvision and the  localStorageCount attributes.
  • The supportsCuda and cudaSupport attributes are deprecated in CloudCenter 4.7.2.
Notes
  • For additional context on <PORT> usage in the following example(s), see Base URI Format.
  • The CloudCenter GET APIs display up to 20 entities in the listing by default. If you have more than 20 entities in your resource listing, use the pagination query parameters to view them beyond the first 20 entities returned by default. See the CloudCenter API Overview > Pagination  section for additional context.
  • If you include a cloudInstanceTypeId to identify a cloud instance type, the response includes information for that cloud cloud instance type only.
ESB Header
  • action: get.tenants.tenantId.clouds.cloudId.regions.cloudRegionId.instanceTypes
  • action: get.tenants.tenantId.clouds.cloudId.regions.cloudRegionId.instanceTypes.
    cloudInstanceTypeId

Example 1 - All Instance Types

curl -k -X GET -H "Accept: application/json" -u cliqradmin:40E45DBE57E35ECB "https://<HOST>:<PORT>/v1/tenants/1/clouds/1/regions/1/instanceTypes"
 Response
{
    "resource": "https://<HOST>:<PORT>/v1/tenants/1/clouds/1/regions/1/instanceTypes",
    "size": 20,
    "pageNumber": 0,
    "totalElements": 60,
    "totalPages": 3,
    "cloudInstanceTypes": [
        {
            "id": "1",
            "resource": "https://<HOST>:<PORT>/v1/tenants/1/clouds/1/regions/1/instanceTypes/1",
            "perms": [],
            "name": "db.m2.xlarge",
            "description": "High-memory Extra Large DB Instance",
            "type": "db.m2.xlarge",
            "regionId": "1",
            "costPerHour": 0.555,
            "memorySize": 17100,
            "numOfCpus": 2,
            "numOfNics": 1,
            "localStorageCount": 1,
            "localStorageSize": 420,
            "supportsCuda": false,
            "supportsSsd": false,
            "supports32Bit": false,
            "supports64Bit": true,
            "supportsHardwareProvision": false
        },
        {
            "id": "2",
            "resource": "https://<HOST>:<PORT>/v1/tenants/1/clouds/1/regions/1/instanceTypes/2",
            "perms": [],
            "name": "m1.large",
            "description": "Large Instance",
            "type": "m1.large",
            "regionId": "1",
            "costPerHour": 0.175,
            "memorySize": 7500,
            "numOfCpus": 2,
            "numOfNics": 1,
            "localStorageCount": 1,
            "localStorageSize": 850,
            "supportsCuda": false,
            "supportsSsd": false,
            "supports32Bit": false,
            "supports64Bit": true,
            "supportsHardwareProvision": false
        },
        {
            "id": "3",
            "resource": "https://<HOST>:<PORT>/v1/tenants/1/clouds/1/regions/1/instanceTypes/3",
            "perms": [],
            "name": "c3.2xlarge",
            "description": "Compute Optimized - Current Generation(c3.2xlarge)",
            "type": "c3.2xlarge",
            "regionId": "1",
            "costPerHour": 0.42,
            "memorySize": 15000,
            "numOfCpus": 8,
            "numOfNics": 1,
            "localStorageCount": 2,
            "localStorageSize": 160,
            "supportsCuda": false,
            "supportsSsd": false,
            "supports32Bit": false,
            "supports64Bit": true,
            "supportsHardwareProvision": false
        },
        {
            "id": "4",
            "resource": "https://<HOST>:<PORT>/v1/tenants/1/clouds/1/regions/1/instanceTypes/4",
            "perms": [],
            "name": "c3.4xlarge",
            "description": "Compute Optimized - Current Generation(c3.4xlarge)",
            "type": "c3.4xlarge",
            "regionId": "1",
            "costPerHour": 0.84,
            "memorySize": 30000,
            "numOfCpus": 16,
            "numOfNics": 1,
            "localStorageCount": 2,
            "localStorageSize": 320,
            "supportsCuda": false,
            "supportsSsd": false,
            "supports32Bit": false,
            "supports64Bit": true,
            "supportsHardwareProvision": false
        },
        {
            "id": "5",
            "resource": "https://<HOST>:<PORT>/v1/tenants/1/clouds/1/regions/1/instanceTypes/5",
            "perms": [],
            "name": "cr1.8xlarge",
            "description": "High Memory Cluster Eight Extra Large Instance",
            "type": "cr1.8xlarge",
            "regionId": "1",
            "costPerHour": 3.5,
            "memorySize": 249856,
            "numOfCpus": 16,
            "numOfNics": 1,
            "localStorageCount": 1,
            "localStorageSize": 240,
            "supportsCuda": false,
            "supportsSsd": false,
            "supports32Bit": false,
            "supports64Bit": true,
            "supportsHardwareProvision": false
        },
        {
            "id": "6",
            "resource": "https://<HOST>:<PORT>/v1/tenants/1/clouds/1/regions/1/instanceTypes/6",
            "perms": [],
            "name": "m2.2xlarge",
            "description": "High-memory Double Extra Large Instance",
            "type": "m2.2xlarge",
            "regionId": "1",
            "costPerHour": 0.49,
            "memorySize": 34200,
            "numOfCpus": 4,
            "numOfNics": 1,
            "localStorageCount": 1,
            "localStorageSize": 850,
            "supportsCuda": false,
            "supportsSsd": false,
            "supports32Bit": false,
            "supports64Bit": true,
            "supportsHardwareProvision": false
        },
        {
            "id": "7",
            "resource": "https://<HOST>:<PORT>/v1/tenants/1/clouds/1/regions/1/instanceTypes/7",
            "perms": [],
            "name": "d2.2xlarge",
            "description": "Memory Optimized - Current Generation",
            "type": "d2.2xlarge",
            "regionId": "1",
            "costPerHour": 1.38,
            "memorySize": 62464,
            "numOfCpus": 8,
            "numOfNics": 1,
            "localStorageCount": 6,
            "localStorageSize": 12000,
            "supportsCuda": false,
            "supportsSsd": false,
            "supports32Bit": false,
            "supports64Bit": true,
            "supportsHardwareProvision": false
        },
        {
            "id": "8",
            "resource": "https://<HOST>:<PORT>/v1/tenants/1/clouds/1/regions/1/instanceTypes/8",
            "perms": [],
            "name": "r3.large",
            "description": "Memory Optimized - Current Generation",
            "type": "r3.large",
            "regionId": "1",
            "costPerHour": 0.175,
            "memorySize": 15360,
            "numOfCpus": 2,
            "numOfNics": 1,
            "localStorageCount": 1,
            "localStorageSize": 32,
            "supportsCuda": false,
            "supportsSsd": false,
            "supports32Bit": false,
            "supports64Bit": true,
            "supportsHardwareProvision": false
        },
        {
            "id": "9",
            "resource": "https://<HOST>:<PORT>/v1/tenants/1/clouds/1/regions/1/instanceTypes/9",
            "perms": [],
            "name": "db.m2.2xlarge",
            "description": "High-memory Double Extra Large DB Instance",
            "type": "db.m2.2xlarge",
            "regionId": "1",
            "costPerHour": 1.11,
            "memorySize": 34200,
            "numOfCpus": 4,
            "numOfNics": 1,
            "localStorageCount": 1,
            "localStorageSize": 850,
            "supportsCuda": false,
            "supportsSsd": false,
            "supports32Bit": false,
            "supports64Bit": true,
            "supportsHardwareProvision": false
        },
        {
            "id": "10",
            "resource": "https://<HOST>:<PORT>/v1/tenants/1/clouds/1/regions/1/instanceTypes/10",
            "perms": [],
            "name": "m3.large",
            "description": "General purpose(m3.large)",
            "type": "m3.large",
            "regionId": "1",
            "costPerHour": 0.14,
            "memorySize": 7680,
            "numOfCpus": 2,
            "numOfNics": 1,
            "localStorageCount": 1,
            "localStorageSize": 32,
            "supportsCuda": false,
            "supportsSsd": false,
            "supports32Bit": false,
            "supports64Bit": true,
            "supportsHardwareProvision": false
        },
        {
            "id": "11",
            "resource": "https://<HOST>:<PORT>/v1/tenants/1/clouds/1/regions/1/instanceTypes/11",
            "perms": [],
            "name": "db.m1.large",
            "description": "Large DB Instance",
            "type": "db.m1.large",
            "regionId": "1",
            "costPerHour": 0.32,
            "memorySize": 7500,
            "numOfCpus": 2,
            "numOfNics": 1,
            "localStorageCount": 1,
            "localStorageSize": 850,
            "supportsCuda": false,
            "supportsSsd": false,
            "supports32Bit": false,
            "supports64Bit": true,
            "supportsHardwareProvision": false
        },
        {
            "id": "12",
            "resource": "https://<HOST>:<PORT>/v1/tenants/1/clouds/1/regions/1/instanceTypes/12",
            "perms": [],
            "name": "c4.large",
            "description": "Compute Optimized - Current Generation",
            "type": "c4.large",
            "regionId": "1",
            "costPerHour": 0.116,
            "memorySize": 3840,
            "numOfCpus": 2,
            "numOfNics": 1,
            "localStorageCount": 1,
            "localStorageSize": 10,
            "supportsCuda": false,
            "supportsSsd": false,
            "supports32Bit": false,
            "supports64Bit": true,
            "supportsHardwareProvision": false
        },
        {
            "id": "13",
            "resource": "https://<HOST>:<PORT>/v1/tenants/1/clouds/1/regions/1/instanceTypes/13",
            "perms": [],
            "name": "hi1.4xlarge",
            "description": "High I/O Quadruple Extra Large Instance",
            "type": "hi1.4xlarge",
            "regionId": "1",
            "costPerHour": 3.1,
            "memorySize": 61952,
            "numOfCpus": 16,
            "numOfNics": 1,
            "localStorageCount": 1,
            "localStorageSize": 1024,
            "supportsCuda": false,
            "supportsSsd": false,
            "supports32Bit": false,
            "supports64Bit": true,
            "supportsHardwareProvision": false
        },
        {
            "id": "14",
            "resource": "https://<HOST>:<PORT>/v1/tenants/1/clouds/1/regions/1/instanceTypes/14",
            "perms": [],
            "name": "g2.2xlarge",
            "description": "Compute Optimized - Current Generation(g2.2xlarge)",
            "type": "g2.2xlarge",
            "regionId": "1",
            "costPerHour": 0.65,
            "memorySize": 15000,
            "numOfCpus": 8,
            "numOfNics": 1,
            "localStorageCount": 1,
            "localStorageSize": 60,
            "supportsCuda": false,
            "supportsSsd": false,
            "supports32Bit": false,
            "supports64Bit": true,
            "supportsHardwareProvision": false
        },
        {
            "id": "15",
            "resource": "https://c<HOST>:<PORT>/v1/tenants/1/clouds/1/regions/1/instanceTypes/15",
            "perms": [],
            "name": "m3.medium",
            "description": "General purpose(m3.medium)",
            "type": "m3.medium",
            "regionId": "1",
            "costPerHour": 0.07,
            "memorySize": 3840,
            "numOfCpus": 1,
            "numOfNics": 1,
            "localStorageCount": 1,
            "localStorageSize": 4,
            "supportsCuda": false,
            "supportsSsd": false,
            "supports32Bit": false,
            "supports64Bit": true,
            "supportsHardwareProvision": false
        },
        {
            "id": "16",
            "resource": "https://<HOST>:<PORT>/v1/tenants/1/clouds/1/regions/1/instanceTypes/16",
            "perms": [],
            "name": "db.t1.micro",
            "description": "Micro DB Instance",
            "type": "db.t1.micro",
            "regionId": "1",
            "costPerHour": 0.025,
            "memorySize": 613,
            "numOfCpus": 1,
            "numOfNics": 1,
            "localStorageCount": 1,
            "localStorageSize": 10,
            "supportsCuda": false,
            "supportsSsd": false,
            "supports32Bit": true,
            "supports64Bit": true,
            "supportsHardwareProvision": false
        },
        {
            "id": "17",
            "resource": "https://<HOST>:<PORT>/v1/tenants/1/clouds/1/regions/1/instanceTypes/17",
            "perms": [],
            "name": "db.m1.medium",
            "description": "Medium DB Instance",
            "type": "db.m1.medium",
            "regionId": "1",
            "costPerHour": 0.16,
            "memorySize": 3750,
            "numOfCpus": 1,
            "numOfNics": 1,
            "localStorageCount": 1,
            "localStorageSize": 410,
            "supportsCuda": false,
            "supportsSsd": false,
            "supports32Bit": true,
            "supports64Bit": true,
            "supportsHardwareProvision": false
        },
        {
            "id": "18",
            "resource": "https://<HOST>:<PORT>/v1/tenants/1/clouds/1/regions/1/instanceTypes/18",
            "perms": [],
            "name": "c3.xlarge",
            "description": "Compute Optimized - Current Generation(c3.xlarge)",
            "type": "c3.xlarge",
            "regionId": "1",
            "costPerHour": 0.21,
            "memorySize": 7500,
            "numOfCpus": 4,
            "numOfNics": 1,
            "localStorageCount": 2,
            "localStorageSize": 80,
            "supportsCuda": false,
            "supportsSsd": false,
            "supports32Bit": false,
            "supports64Bit": true,
            "supportsHardwareProvision": false
        },
        {
            "id": "19",
            "resource": "https://<HOST>:<PORT>/v1/tenants/1/clouds/1/regions/1/instanceTypes/19",
            "perms": [],
            "name": "m1.xlarge",
            "description": "Extra Large Instance",
            "type": "m1.xlarge",
            "regionId": "1",
            "costPerHour": 0.35,
            "memorySize": 15000,
            "numOfCpus": 4,
            "numOfNics": 1,
            "localStorageCount": 1,
            "localStorageSize": 1690,
            "supportsCuda": false,
            "supportsSsd": false,
            "supports32Bit": false,
            "supports64Bit": true,
            "supportsHardwareProvision": false
        },
        {
            "id": "20",
            "resource": "https://<HOST>:<PORT>/v1/tenants/1/clouds/1/regions/1/instanceTypes/20",
            "perms": [],
            "name": "m3.2xlarge",
            "description": "General purpose(m3.2xlarge)",
            "type": "m3.2xlarge",
            "regionId": "1",
            "costPerHour": 0.56,
            "memorySize": 30000,
            "numOfCpus": 8,
            "numOfNics": 1,
            "localStorageCount": 2,
            "localStorageSize": 80,
            "supportsCuda": false,
            "supportsSsd": false,
            "supports32Bit": false,
            "supports64Bit": true,
            "supportsHardwareProvision": false
        }
    ]
}

Example 2 - Instance Type with Specified ID

curl -k -X GET -H "Accept: application/json" -u cliqradmin:40E45DBE57E35ECB "https://<HOST>:<PORT>/v1/tenants/1/clouds/1/regions/1/instanceTypes/20"

 Response

{
    "id": "20",
    "resource": "https://<HOST>:<PORT>/v1/tenants/1/clouds/1/regions/1/instanceTypes/20",
    "perms": [],
    "name": "m3.2xlarge",
    "description": "General purpose(m3.2xlarge)",
    "type": "m3.2xlarge",
    "regionId": "1",
    "costPerHour": 0.56,
    "memorySize": 30000,
    "numOfCpus": 8,
    "numOfNics": 1,
    "localStorageCount": 2,
    "localStorageSize": 80,
    "supportsCuda": false,
    "supportsSsd": false,
    "supports32Bit": false,
    "supports64Bit": true,
    "supportsHardwareProvision": false
} 


Request Attributes

tenantId
  • DescriptionUnique, system-generated identifier for the tenant organization. A tenant admin must belong to this tenant to invoke any APIs for this tenant. See Add Sub-Tenants > Tenant ID and Tenant Name Dependency.

  • 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

cloudInstanceTypeId
  • Description: Unique, system-generated identifier for a cloud instance type (see Map Images)
  • Type: String

Required

Response Attributes

resource
  • Description: Unique URL to access this resource.
  • Type: String
See pageResource or Pagination for additional context
cloudInstanceTypes
  • Description: Identifies details about each cloud instance type
  • Type: Array of cloudInstanceTypes

    id
    • DescriptionUnique, system-generated identifier for this CloudCenter Resource.

    • Type: String

    resource
    • Description: Unique URL to access this resource.
    • Type: String
    perms (click for additional details)
    name
    • DescriptionThe name assigned for this CloudCenter ResourceValid characters are letters, numbers, underscores, and spaces.

    • Type: String

    description
    • DescriptionA brief description for this CloudCenter Resource.

    • Type: String
    type
    • DescriptionThe type of resource
    • Type: String
    regionId
    • DescriptionUnique, system-generated identifier for the cloud region 
    • Type: String
    costPerHour
    • Description:  The dollar price per hour to use this service. Only the user who created this service (service owner) can set this value (once) for all users using this service.
    • Type: Float
    memorySize
    • DescriptionThe RAM size in MB for this Instance Type (see Map Images)
    • Type: Integer
    numOfCpus
    • DescriptionThe number of CPUs for this instance type or cloud Image. This attribute is the same as the minNumberOfCpus attribute.
    • Type: Integer
    numOfNics
    • Description: The number of Network Interface Cards (NICs) attached to this instance type or cloud image.

    • Type: Integer
    localStorageSize
    • Description: The local storage size in GB
    • Type: Integer
    supportsCuda (deprecated)
    • Description: Indicates whether CUDA is supported for this instance type. This attribute is the same as the cudaSupport attribute

    • Type: Boolean
      • true = CUDA is supported for this instance type
      • false = CUDA is not supported for this instance type
    supportsSsd
    • Description: Indicates whether SSD is supported for this instance type. This attribute is the same as the ssdSupport attribute.

    • Type: Boolean

      • true = SSD is supported for this instance type
      • false = SSD is not supported for this instance type
    supports32Bit
    • Description: Indicates whether 32-bit architecture is supported for this instance type

      • true = 32-bit architecture is supported for this instance type
      • false = 32-bit architecture is not supported for this instance type
    • Type: Boolean
    supports64Bit
    • Description: Indicates whether 64-bit architecture is supported for this instance type

      • true = 64-bit architecture is supported for this instance type
      • false = 64-bit architecture is not supported for this instance type
    • Type: Boolean
    localStorageCount
    • Description: Enables a user to specify the number of additional instance stores (instance storage) that can attached to the Application VM. AWS use this concept of Instance Storage and CloudCenter enables users to create these additional stores using this attribute:
      • Default = 0
      • Minimum = 1
      • Maximum = 24
    • Type: Integer
    supportsHardwareProvision 
    • Description: Identifies if hardware provisioning is supported (see Provision Bare Metal Hardware Servers for additional context:
      • true = Supports hardware provisioning
      • false = Does not support hardware provisioning
    • Type: Boolean