CliQr is now part of Cisco Learn More About Cisco

View Cloud Properties


API Details

View Cloud Properties

DescriptionDisplays information about cloud properties for the specified region.
  • v1/cloudProperties/regionName
  • v1/cloudProperties/regionName?propertyType=propertyType&depEnv=depEnvId&cloudAccount=cloudAccountid
  • v1/cloudProperties/cloudType?propertyType=AccessKeyPairs&depEnv=depEnvId&TenantId=TenantId
CloudCenter Release
  • Introduced in CloudCenter 4.0.
  • Enhanced in CloudCenter 4.1.1 to include the TenantName and TenantId attributes (see OpenStack Configurations for additional context).
  • Enhanced in CloudCenter 4.7.2 to include the Google Cloud Platform Network and AvailableNetworks options in the propertyType attribute.
  • 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.
  • You can display information for a specific property, deployment environment, and account by including the propertyType, depEnv, and/or cloudAccount query parameters with this API.
ESB Header
  • action: get.cloudProperties.regionName
  • action: get.cloudProperties.regionName
  • action: get.cloudProperties.cloudType
    actionparam: propertyType=AccessKeyPairs&depEnv=depEnvId&TenantId=TenantId

Example 1 – depEnv and cloudAccount

curl -k -X GET -H "Accept: application/json" -u cliqradmin:40E45DBE57E35ECB "https://<HOST>:<PORT>/v1/cloudProperties/OpenStack-V-Cloud-Region?propertyType=AvailableNetworks&depEnv=1" 



The response for the View Deployment Environments API provides the cloudID and the depEnvId details as shown in the following example.


Example 2 – AccessKeyPairs and TenantId

curl -k -X GET -H "Accept: application/json" -u cliqradmin:40E45DBE57E35ECB "https://<HOST>:<PORT>/v1/cloudProperties/openstack-regionOne?propertyType=AccessKeyPairs&depEnv=1&TenantId=aa1130285af84becbe0bb4ba8e6b5d62" 



Request Attributes

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

  • Type: String

Unique identifier for this cloud representation


When you see the cloudType attribute, use the regionName attribute instead.


  • Description: The cloud property type for this deployment environment:
    • EC2:

      • AvailabilityZone

      • Vpc

      • Subnet

      • AccountAttributes

    • Azure

      • VirtualNetwork

      • StorageAccount

      • AffinityGroup

    • Google

      • LaunchZone

      • Network
      • AvailableNetworks
    • Generic properties

      • AvailableNetworks: Provides the relevant network identifiers so it/they can be provided to NICs during the job submission process.

      • PrivateFixedIPAllocationStrategies: Provides the right allocation options to network interfaces during the job submission process. See IP Allocation Mode for additional details.

      • PrivatePublicIPPairSupport: Identifies if a cloud supports the Private IP - Public IP pair up. If this property is supported, you can have the Public IP attached to any NIC. 

      • InstanceTypes: Identifies the instance types supported by the cloud account.   

      • ImagesIdentifies images accessible by the cloud account.

  • Type: String

  • DescriptionUnique, system-generated identifier for the deployment environment. See Deployment Environments for additional details. This attribute is the same as the environmentId attribute.
  • Type: String
  • Description: Unique, system-generated identifier for the cloudAccount
  • Type: String
  • Description: Identifies the network topology for various clouds for OpenStack project information. The network topology of each cloud tenants varies. To differentiate between each cloud tenant, append the OpenStack project information (TenantName or the TenantId) in the cloud properties to retrieve the available networks. If you do not specify any network for a NIC, the CloudCenter platform automatically picks either the specified default network or any network available (for that tenant) for the deployment. See OpenStack Configurations for additional context.
  • Type: String

Response Attributes

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

  • Type: String
  • Description: Unique URL to access this resource
  • Type: String
perms (click for additional information)
  • Description: Indicates the set value for this property
  • Type: Float
  • DescriptionThe type of resource
  • Type: String
  • DescriptionUnique, system-generated identifier for a cloud specific property.
    • For allocation strategies, CloudCenter provides the refId  (based on DHCP, static IP, and so forth) and the refId inherits the same value.
    • For networks, the cloud provides the refId (for example, a unique network Identifier).
  • Type: String
  • Description: Information about the cloud property
  • Type: Array of name-value pairs

    • DescriptionThe name assigned for this CloudCenter ResourceValid characters are letters, numbers, underscores, and spaces.

    • Type: String

    • Description: Indicates the set value for this property
    • Type: Float

  • Description: Additional properties for this resource
  • TypeName-Value Pair (array)
  • Description: Total number of records that any list page should contain. The default is: 

    • v1 APIs = 20 records

    • v2 APIs:

      • Prior to 4.8.0: All elements are returned and the page value is ignored.

      • Effective 4.8.0: 50 records
  • Type: Integer