View Cloud Providers

Details

API DetailsRelease-Specific Information
CloudCenter Platform 4xCloudCenter Suite 5x
NameView Cloud Providers
Description

Displays cloud capability information for all cloud providers or for a specified cloud provider

Allowed Role(s)

WM_USER, WM_ADMIN

MethodGET
URI
  • v1/cloudProviders
  • v1/cloudProviders/cloudProviderName
  • cloudcenter-cloud-setup/api/v1/cloudProviders
  • cloudcenter-cloud-setup/api/v1/cloudProviders/cloudProviderName
Sample Request
curl -k -X GET -H "Accept: application/json" -u cloudcenteradmin:40E45DBE57E35ECB "https://<HOST>:<PORT>/v1/cloudProviders"
curl -k -X GET -H "Accept: application/json" -u cloudcenteradmin:40E45DBE57E35ECB "https://<HOST>:<PORT>/cloudcenter-cloud-setup/api/v1/cloudProviders"
Release

Introduced in CloudCenter 4.8.1

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.
  • These API settings are ignored when deploying on other clouds as it is only supported for the following clouds:

    • Amazon
    • VMware with ACI extension enabled
    • AzureRM
    • OpenStack 
    • Alibaba
Back To LinksCloudCenter Platform 4x APIWorkload Manager API

ESB Header

  • action: get.cloudProviders
  • action: get.cloudProviders.cloudProviderName

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

Not applicable

Sample Response 1: All Cloud Providers

{
   "cloudProviders":[
      {
         "name":"Amazon",
         "cloudFeatureUsages":[
            {
               "cloudFeature":{
                  "featureName":"APP_PROFILE_TIER_FIREWALL",
                  "description":"Per-tier firewall rule defined in App Profile",
                  "featureType":"SECURITY"
               },
               "usageOptions":[

               ]
            },
            {
               "cloudFeature":{
                  "featureName":"DEFAULT_USER_SEC_GROUP",
                  "description":"To communicate between VMs launched by user",
                  "featureType":"SECURITY"
               },
               "usageOptions":[

               ]
            },
            {
               "cloudFeature":{
                  "featureName":"SECURITY_PROFILE",
                  "description":"Per tier or deploy security profile support",
                  "featureType":"SECURITY"
               },
               "usageOptions":[

               ]
            },
            {
               "cloudFeature":{
                  "featureName":"TENANT_LEVEL_FIREWALL",
                  "description":"Per user firewall rules at tenant level",
                  "featureType":"SECURITY"
               },
               "usageOptions":[

               ]
            }
         ]
      },
      {
         "name":"Azure",
         "cloudFeatureUsages":[

         ]
      },
      {
         "name":"Vmware",
         "cloudFeatureUsages":[
            {
               "cloudFeature":{
                  "featureName":"SECURITY_PROFILE",
                  "description":"Per tier or depl security profile support",
                  "featureType":"SECURITY"
               },
               "usageOptions":[
                  {
                     "associatedFeature":{
                        "featureName":"ACI_EXTENSION",
                        "description":"ACI extension.",
                        "featureType":"SECURITY"
                     },
                     "mandatory":true
                  }
               ]
            },
            {
               "cloudFeature":{
                  "featureName":"APP_PROFILE_TIER_FIREWALL",
                  "description":"Per tier firewall rules in AppProfile.",
                  "featureType":"SECURITY"
               },
               "usageOptions":[
                  {
                     "associatedFeature":{
                        "featureName":"ACI_EXTENSION",
                        "description":"ACI extension.",
                        "featureType":"SECURITY"
                     },
                     "mandatory":true
                  }
               ]
            },
            {
               "cloudFeature":{
                  "featureName":"MICROSEGMENTATION",
                  "description":"Limit to one-way south-bound comm bet tiers",
                  "featureType":"SECURITY"
               },
               "usageOptions":[
                  {
                     "associatedFeature":{
                        "featureName":"ACI_EXTENSION",
                        "description":"ACI extension.",
                        "featureType":"SECURITY"
                     },
                     "mandatory":true
                  }
               ]
            }
         ]
      },
      {
         "name":"AzureRM",
         "cloudFeatureUsages":[
            {
               "cloudFeature":{
                  "featureName":"SECURITY_PROFILE",
                  "description":"Per tier or depl security profile support",
                  "featureType":"SECURITY"
               },
               "usageOptions":[

               ]
            },
            {
               "cloudFeature":{
                  "featureName":"TENANT_LEVEL_FIREWALL",
                  "description":"Per user firewall rules at tenant level",
                  "featureType":"SECURITY"
               },
               "usageOptions":[

               ]
            },
            {
               "cloudFeature":{
                  "featureName":"APP_PROFILE_TIER_FIREWALL",
                  "description":"Per tier firewall rules in App Profile",
                  "featureType":"SECURITY"
               },
               "usageOptions":[

               ]
            }
         ]
      },
      {
         "name":"AzurePack",
         "cloudFeatureUsages":[

         ]
      },
      {
         "name":"Openstack",
         "cloudFeatureUsages":[
            {
               "cloudFeature":{
                  "featureName":"DEFAULT_USER_SEC_GROUP",
                  "description":"Allows user-launched VM communication",
                  "featureType":"SECURITY"
               },
               "usageOptions":[

               ]
            },
            {
               "cloudFeature":{
                  "featureName":"APP_PROFILE_TIER_FIREWALL",
                  "description":"Per tier firewall rules in App Profile",
                  "featureType":"SECURITY"
               },
               "usageOptions":[

               ]
            },
            {
               "cloudFeature":{
                  "featureName":"TENANT_LEVEL_FIREWALL",
                  "description":"Per user firewall rules at tenant level",
                  "featureType":"SECURITY"
               },
               "usageOptions":[

               ]
            },
            {
               "cloudFeature":{
                  "featureName":"SECURITY_PROFILE",
                  "description":"Per tier or depl security profile support",
                  "featureType":"SECURITY"
               },
               "usageOptions":[

               ]
            }
         ]
      },
      {
         "name":"Vcd",
         "cloudFeatureUsages":[

         ]
      },
      {
         "name":"Google",
         "cloudFeatureUsages":[
            {
               "cloudFeature":{
                  "featureName":"APP_PROFILE_TIER_FIREWALL",
                  "description":"Per tier firewall rules in App Profile",
                  "featureType":"SECURITY"
               },
               "usageOptions":[

               ]
            },
            {
               "cloudFeature":{
                  "featureName":"TENANT_LEVEL_FIREWALL",
                  "description":"Per user firewall rules at tenant level",
                  "featureType":"SECURITY"
               },
               "usageOptions":[

               ]
            },
            {
               "cloudFeature":{
                  "featureName":"DEFAULT_USER_SEC_GROUP",
                  "description":"For user-launched VM communication",
                  "featureType":"SECURITY"
               },
               "usageOptions":[

               ]
            }
         ]
      },
      {
         "name":"Alibaba",
         "cloudFeatureUsages":[
            {
               "cloudFeature":{
                  "featureName":"SECURITY_PROFILE",
                  "description":"Per tier or depl security profile support",
                  "featureType":"SECURITY"
               },
               "usageOptions":[

               ]
            },
            {
               "cloudFeature":{
                  "featureName":"TENANT_LEVEL_FIREWALL",
                  "description":"Per user firewall rules at tenant level",
                  "featureType":"SECURITY"
               },
               "usageOptions":[

               ]
            },
            {
               "cloudFeature":{
                  "featureName":"APP_PROFILE_TIER_FIREWALL",
                  "description":"Per tier firewall rules in App Profile",
                  "featureType":"SECURITY"
               },
               "usageOptions":[

               ]
            }
         ]
      },
      {
         "name":"Opsource",
         "cloudFeatureUsages":[
            {
               "cloudFeature":{
                  "featureName":"APP_PROFILE_TIER_FIREWALL",
                  "description":"Per tier firewall rules in App Profile",
                  "featureType":"SECURITY"
               },
               "usageOptions":[

               ]
            }
         ]
      },
      {
         "name":"SoftLayer",
         "cloudFeatureUsages":[

         ]
      },
      {
         "name":"CiscoUCSD",
         "cloudFeatureUsages":[

         ]
      }
   ]
}

Example 2: Specific Cloud Provider

curl -k -X GET -H "Accept: application/json" -u cloudcenteradmin:40E45DBE57E35ECB "https://<HOST>:<PORT>/v1/cloudProviders/Amazon"

Response

{
   "name":"Amazon",
   "cloudFeatureUsages":[
      {
         "cloudFeature":{
            "featureName":"SECURITY_PROFILE",
            "description":"Per tier or depl security profile support",
            "featureType":"SECURITY"
         },
         "usageOptions":[

         ]
      },
      {
         "cloudFeature":{
            "featureName":"TENANT_LEVEL_FIREWALL",
            "description":"Per user firewall rules defined at tenant level",
            "featureType":"SECURITY"
         },
         "usageOptions":[

         ]
      },
      {
         "cloudFeature":{
            "featureName":"APP_PROFILE_TIER_FIREWALL",
            "description":"Per tier firewall rules in App Profile",
            "featureType":"SECURITY"
         },
         "usageOptions":[

         ]
      },
      {
         "cloudFeature":{
            "featureName":"DEFAULT_USER_SEC_GROUP",
            "description":"For user-launched VM communication",
            "featureType":"SECURITY"
         },
         "usageOptions":[

         ]
      }
   ]
}

Request Attributes

None

Response Attributes

cloudProviders
  • Description: Identifies cloud provider capabilities based on the cloud settings as
  • Type: Sequence of cloud provider details

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

    • Type: String

    cloudFeatureUsages
    • Description: Identifies the usage details for the configured cloud

    • Type: Sequence of configured cloud features

      cloudFeature
      • Description:Identifies the details for the configured cloud feature.

      • Type: Sequence of cloud feature details

        featureName
        • Description: The user-assigned name for the configured cloud provider property.
        • Type: String

        description
        • DescriptionA brief description for this CloudCenter Resource.

        • Type: String

        featureType
        • Description: Identifies the type of cloud infrastructure and services for the configured cloud provider property.

        • Type: Enumeration

          EnumerationDescription
          COMPUTEThis is a placeholder for future improvements.
          STORAGEThis is a placeholder for future improvements.
          NETWORKThis is a placeholder for future improvements.
          IMAGEThis is a placeholder for future improvements.
          SECURITYThis is a placeholder for future improvements.

      usageOption
      • Description: Identifies the cloud features associated with the cloud provider.

      • Type: Sequence of cloud features

        associatedFeature
        • Description:Identifies the details for the associated cloud feature.

        • Type: Sequence of cloud feature details

          featureName
          • Description: The user-assigned name for the configured cloud provider property.
          • Type: String

          description
          • DescriptionA brief description for this CloudCenter Resource.

          • Type: String

          featureType
          • Description: Identifies the type of cloud infrastructure and services for the configured cloud provider property.

          • Type: Enumeration

            EnumerationDescription
            COMPUTEThis is a placeholder for future improvements.
            STORAGEThis is a placeholder for future improvements.
            NETWORKThis is a placeholder for future improvements.
            IMAGEThis is a placeholder for future improvements.
            SECURITYThis is a placeholder for future improvements.

        mandatory
        • Description: Identifies if a value is required.
        • Type: Boolean
          • true = Required.
          • false = Not required (default)




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