CliQr is now part of Cisco Learn More About Cisco

Create Bundle

Details

API Details
Name

Create Bundle

Description

Creates a new bundle and enables the Tenant Administrator Tasks to grant specific access to users assigned this bundle.

MethodPOST
URIv1/tenants/tenantId/bundles
CloudCenter ReleaseIntroduced in CloudCenter 4.0.
Notes
ESB Headeraction: create.tenants.tenantId.bundles

Example

curl -k -X POST -H "Accept: application/json" -H "Content-Type: application/json" -u cliqradmin:40E45DBE57E35ECB "https://<HOST>:<PORT>/v1/tenants/5/bundles"

Request Body

 

Response

 

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
name
  • DescriptionThe name assigned for this CloudCenter ResourceValid characters are letters, numbers, underscores, and spaces.

  • Type: String

bundleType
  • Description: Type type of bundle for this user or tenant. See Financial Overview and Permission Control for additional content. 
  • Type: Enumeration

    EnumerationDescription
    TIME_BUNDLETime-based VM hours bundle example: Default. The 250 hours sign up offered through the CloudCenter Marketplace that includes the management fee at no additional cost. Typically, new users try out this bundle before their admin assigns them to a plan or before the user converts to a subscription plan.
    BUDGET_BUNDLEBudget-based $ limit bundle example: With a budget limit of $100, you can run applications until this amount is consumed. If your tenant admins set a management fee (for example, $0.10 per hour), then this amount is deducted from the $100 limit. Any additional cloud cost is also deducted from the $100 limit.

limit
price
  • DescriptionThe base price for this bundle or plan. Required in the request only for the monthlyLimit plans:
    • UNLIMITED_PLAN
    • VM_HOUR_SUBSCRIPTION_PLAN
    • VM_SUBSCRIPTION_PLAN
    • For the remaining prepaid plan type (TIME_BUNDLE_PREPAID_PLAN and BUDGET_BUNDLE_PREPAID_PLAN), the value defaults to 0
  • Type: Float
expirationDate
  • DescriptionA period starting from the date of purchase or a fixed expiration date.
  • Type: Long

Response Attributes

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

Required

description
  • DescriptionA brief description for this CloudCenter Resource.

  • Type: String

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

bundleType
  • Description: Type type of bundle for this user or tenant. See Financial Overview and Permission Control for additional content. 
  • Type: Enumeration

    EnumerationDescription
    TIME_BUNDLETime-based VM hours bundle example: Default. The 250 hours sign up offered through the CloudCenter Marketplace that includes the management fee at no additional cost. Typically, new users try out this bundle before their admin assigns them to a plan or before the user converts to a subscription plan.
    BUDGET_BUNDLEBudget-based $ limit bundle example: With a budget limit of $100, you can run applications until this amount is consumed. If your tenant admins set a management fee (for example, $0.10 per hour), then this amount is deducted from the $100 limit. Any additional cloud cost is also deducted from the $100 limit.

Required

limit

price
  • DescriptionThe base price for this bundle or plan. Required in the request only for the monthlyLimit plans:
    • UNLIMITED_PLAN
    • VM_HOUR_SUBSCRIPTION_PLAN
    • VM_SUBSCRIPTION_PLAN
    • For the remaining prepaid plan type (TIME_BUNDLE_PREPAID_PLAN and BUDGET_BUNDLE_PREPAID_PLAN), the value defaults to 0
  • Type: Float

Required

expirationDate
  • DescriptionA period starting from the date of purchase or a fixed expiration date.
  • Type: Long

Required

expirationMonths
  • Description: Number of months that a plan is active
  • Type: Integer

publishedAppIds
  • DescriptionUnique, system-generated identifier for applications published to the Marketplace
  • Type: Array of strings

disabled
  • Description: Indicates whether this resource is disabled.
    • True = resource is disabled
    • false = resource is not disabled
  • Type: Boolean
showOnlyToAdmin
  • Description: Indicates whether this resource is visible only to an administrator.
    • true = visibility of the resource is restricted to an administrator
    • false = visibility of the resource is not restricted to an administrator
  • Type: Boolean
numberOfUsers
  • Description: Number of users that are currently using this resource
  • Type: Long