CliQr is now part of Cisco Learn More About Cisco

Create Contract

Details

API Details
Name

Create Contract

Description

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

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

Example

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

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

length
  • DescriptionThe length of the contract (Contract Period). See Financial Overview for additional context.
  • Type: Integer
terms
  • DescriptionThe text of this contract
  • Type: String
discountRate
  • Description: Discount rate applied to this contract. Provides users an incentive to sign a longer contract. Typically, a longer contract length has a deeper discount rate. This discount is applied to a plan's base one-time fee, annual fee, bundle price, and monthly subscription fee, but not the overage and storage fees.
  • Type: Decimal

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

length
  • DescriptionThe length of the contract (Contract Period). See Financial Overview for additional context.
  • Type: Integer

Required

terms
  • DescriptionThe text of this contract
  • Type: String

Required

discountRate
  • Description: Discount rate applied to this contract. Provides users an incentive to sign a longer contract. Typically, a longer contract length has a deeper discount rate. This discount is applied to a plan's base one-time fee, annual fee, bundle price, and monthly subscription fee, but not the overage and storage fees.
  • Type: Decimal

Required

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