Intercloud Fabric REST APIs for Providers details how Service Providers can consume the APIs available to integrate ICF solution with their Cloud Platforms or other systems of choice. It also explains what are the tools available to improve the integration experience, and how that fits into the overall Intercloud Fabric solution.

2. Intercloud Fabric REST
APIs for Providers
Paulo Renato, Technical Marketing Architect
prenato@cisco.com, @prenatos
DEVNET-­2009

3. © 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
• ICF Solution Overview
• ICF for Provider APIs Overview
• Conclusion
Agenda
3

4. © 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
Intercloud Fabric
Provider Platform
(ICFPP)
Intercloud Fabric
for Providers
Intercloud Fabric Secure Extender
(Secure Network Extension)
DC/Private
Cloud
Provider
Cloud
Cisco Intercloud Fabric Architectural Details
Intercloud
Switch
VM Manager
Intercloud
Fabric Services
Intercloud
Extender
Intercloud
Fabric Director
End User and IT Admin Portal
Workload and Fabric ManagementIT AdminsEnd Users
VM VM
VM VM
Intercloud Fabric
for Business

5. © 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
ICFPP Multi-­tier Topology
• High Availability
• Scalability
• Horizontal Scaling Approach
• Ability to deploy multiple ICFPP nodes
• Service Provider Load balancer distributes load
across ICFPPs
• Max: 4 service nodes and 2 DB nodes
• Up to 160 concurrent VM upload/download
• Synchronized database nodes
• Load Balancer: Least-­Connection with Session
Sticky
ICFPP
Service
Node
ICFPP
Database
Node
(Primary)
ICFPP
Database
Node
(Standby)
Load
Balancer
ICFPP
Service
Node
ICFPP
Service
Node
ICFPP
Service
Node
ICFPP Multi-­tier Topology
SP Choice

6. © 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
Cloud
API
Provider API
Southbound Cloud Adapter
VCD
Adapter
Open
Stack
Adapter
Cloud
stack
Adapter
Custom
Adapter
Core Logic Tenant DB
Custom
Adapter
ICFPP Architecture
Intercloud Fabric
Cloud API
Provider
Platform
Intercloud Fabric
Provider API
Intercloud Fabric Provider
Southbound Cloud Adapter
To Provider OSS / BSS
To Provider Cloud Platform
To Intercloud
Fabric for
Business

7. © 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
ICF Cloud APIs
Overview

8. © 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
Intercloud Fabric Provider Platform – Cloud API

9. © 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
ICFPP à Cloud Platform: Image Upload with HTTP Pull Model
ICFPP
Appliance
Intercloud
Fabric for
Business
POST Image API Request
Resp (COMPLETE, Image ID)
Cloud Platform APICloud API
Upload Image API Request
(Image ID, Image binary …)
Cloud
Platform
Resp (COMPLETE)
Resp (IS_NOT_READY, Job ID)
Register Template API Request
(Template ID, Image URL path e.g. http://<image-­path>)
GET Template API Request
(Template ID, Polling Status)
Resp (COMPLETE, Template ID)
HTTP GET http://<image-­path>
HTTP Response + Image Binary
Resp (IS_READY, Job ID)
Asynchronous Polling Job Status API Request
(Job ID)
POST Template API Request
(Image ID, Polling Status)
Resp (COMPLETE, Template ID)
HTTP Chunked Encoding Transfer

10. © 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
ICF Provider APIs
Overview

11. © 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
Intercloud Fabric Provider Platform – Provider API

12. © 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
Cloud Platform Instance Provisioning API
Cloud Platform Instance Provisioning Input Parameters:
• Instance Name – An unique name that identifies a cloud instance
• Adapter Type – Type of cloud adapter;; valid values are ”CUSTOM" or ”CISCO“, where “CUSTOM” specifies the adapter is a third party
developed plugin, and ”CISCO” specifies the adapter is part of the existing Cisco delivery.
• Module Name – An unique string that maps a cloud adapter plugin module to a given Cloud Adapter.
• Platform URI/IP-­addr – Either a URI or IP address to reach the cloud platform server.
Name Input
Parameters
Output
Parameters
Descriptions
POST /capi/v1/cloudinstances Instance Name,
Adapter Type,
Module Name,
Platform URI/IP
Status as CREATED with
cloudId
Add a Cloud Platform Instance to ICFPP
DELETE
/capi/v1/cloudinstances/{cloudId}
Status as DELETED or
error
Delete a Cloud Platform Instance from ICFPP
PUT /capi/v1/cloudinstances/{cloudId} Status as UPDATED Update the Platform IP/URL for a previously
provisioned cloud instance

13. © 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
Tenant/User Provisioning API
Tenant Provisioning API Input Parameters:
• Tenant Name – Name or identity that SP cloud platform uses to identify a tenant
• Cloud Platform Instance – Cloud Platform Instance Name
• Org Name – Name of the org associated with the tenant. This can be ignored if the provided does not have a concept of an org (like VCD).
• Resource Limit – Currently we support setting the maximum number of VMs per tenant.
• Parameter List – It will allow API user to pass additional parameter
• Accounts – Array of User Account records associated with tenant org. Each of the Account records consists of :
v Username – User Name
v Password – User Credential (Optional)
v Secret key – Additional User Credential (Optional)
Name Input
Parameters
Output
Parameters
Descriptions
POST /capi/v1/tenants Tenant Name, Cloud Platform
Instance,OrgName, Resource Limit,
Account Records [ ]
ACTIVE or Error code Add a Tenant and relevant User Account to
ICFPP
DELETE
/capi/v1/tenants/{tenantId}
None DELETED or Error code Delete a Tenant from ICFPP
UPDATE
/capi/v1/tenants/{tenantId}
Can update the apikey and secret
key.
ACTIVE or Error code Update certain attributes of an account
DELETE
/capi/v1/tenants/{tenantId}/purge
None PURGED or Error code Purge an existing tenant.

14. © 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
Tenant/User Query API
Name Input
Parameters
Output
Parameters
Descriptions
GET /capi/v1/tenants/{tenantId} None Tenants , Accounts Tenant and List of Accounts
GET
/capi/v1/tenants/{tenantId}/detail
s
None Tenants, Accounts, All VM
details
List of Tenants, Accounts and VMs
GET /capi/v1/tenants None All Tenants, All accounts List of Tenants, Accounts and server statistics
GET /capi/v1/servers/{serverId} None Details regarding a VM

15. © 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
ICFPP Monitoring
Name Input
Parameters
Output
Parameters
Descriptions
GET
/capi/v1/logs/current
None Zipped file with current logs Returns current ICFPP application and web-­
server logs
GET
/capi/v1/logs/all
None Zipped file with all logs Returns all ICFPP logs
POST
/capi/v1/syslogconfig
Enabled true/false, log level, host,
port, protocol for Primary and
Secondary Server
Syslog server configuration Post remote syslog config
GET
/capi/v1/syslogconfig
None Syslog configuration Get syslog config

16. © 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
Demo
16

17. © 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
Southbound Cloud
Adapter Overview

18. © 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
Custom1
Cloud Platform
ICFPP Cloud Adapter Programming Model
Cloud Adapter
Based on
“custom1.jar” file
Mgmt
Session
Virtual
machine
VPC Template Service
Network/
Security
Intercloud Cloud API
Development
SP Admin
GUIWeb/HTTPS Interface
Cloud Platform Instance
Core Application Logic
Southbound Cloud Adapter Interface
Tenant Provisioning
Cloud
Adapter
Developer
New Plugin
.jar file (e.g.
custom1.jar)
Custom1 Cloud API
Cloud Platform Instance
• Instance ID
• Cloud Type (e.g. Custom)
• Cloud Module (e.g. “custom1”)
• Cloud Platform IP-­addr
A new cloud platform adapter can be
developed in the following steps:
• Develop a cloud adapter plug-­in
code and load it into the ICFPP
system.
• Configure a Cloud Platform
Instance and associate it with the
plug-­in module (e.g. custom1.jar)
• Provision tenants with Tenant On-­
board API and associate them with
a targeted cloud instance.
• Tenant Identity
• Cloud Instance ID
• Tenant Credential (e.g. Uname +
Password, or Access keys)
Tenant Record
From Intercloud
Fabric Director
1
2
34
5

19. © 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
Cisco ICFPP SDK
• Sample Code:
• Adapter Example (Java code)
• Test Harness (Test suite for API level testing of ICFPP)
• Documentation:
• ICFPP Adapter Development Guide
• ICFPP Architecture Document
• ICFPP SP Integration REST API
• ICFPP Installation Guide
• ICFPP Release Notes
• ICFPP OVA
• ICFB Bundle (during engagement)

20. © 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
References
• Cisco ICFPP Administrator Guide
• Southbound Cloud Adapter Framework
• Cisco Intercloud Fabric Provider Platform Adapter Developer Guide

21. © 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
Key Takeaways
• ICFPP concept and architecture is simple
• ICFPP Creates Cloud API uniformity for different Providers
• ICFPP Cloud Adapter supports OpenStack, Cloudstack and vCD (Beta) out-­of-­
box integration
• Cisco gives customer an SDK to develop custom Cloud Adapter for ICFPP to
integrate with any Cloud Management Platform
• ICFPP will differentiate Cisco Powered Providers from other clouds
• Roadmap to include bare-­metal workloads, tither storage integration etc.

22. © 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
Intercloud Fabric @ CiscoLive San Diego
Breakouts
TECCLD-­3001 Sun 8:00 4 hrs 16B Mezz Intercloud Fabric Technical Deepdive
PSOCLD-­1001 Mon 11:00 60 min 14B Mezz Hybrid Cloud with Intercloud Fabric
PSODCT-­1009 Mon 2:00 60 min 14B Mezz Hybrid Clouds: Integrating the Enterprise Data Center and Public Cloud
BRKCLD-­2003 Wed 8:00 2 hrs 7A Upper Building Hybrid Cloud Applications with Intercloud Fabric
BRKCLD-­1828 Thu 8:00 90 min 25C Upper Designing Hybrid Cloud operations with ServiceGrid and Intercloud Fabric
DevNet
DEVNET-­1008 Mon 9:00 30 min Devnet Theater Private or Public or Hybrid ? Which Cloud Should I choose?
DEVNET-­1120 Mon 1:00 60 min Devnet Classrm #2 Intercloud Fabric -­ AWS and Azure Account Setup and Utilization
DEVNET-­1128 Mon 2:00 30 min Devnet Classrm #2 Cisco Intercloud Fabric NB APIs for Business
DEVNET-­1009 Tue 9:00 30 min Devnet Theater Cisco Intercloud Fabric for Business, Helping Enterprises Move to Hybrid!
DEVNET-­2009 Wed 12:00 30 min Devnet Classrm #2 Intercloud Fabric REST APIs for Providers
World of Solutions Learning Labs Table Topics Meet the Engineer
ICF in Hybrid
Cloud
Mon 12:00
Table #11
Wed 11:30
Table #13
Building Hybrid
Cloud Apps with
ICF
Tue 11:30
Table # 11
Wed 11:30
Table #10
Talk to an ICF
Expert @ ‘The Hub’
Ground Level
See ICF in action with 3-­tier
hybrid cloud application
‘Cloud’ Booth in WoS, Ground
Level
Hands on with ICF:
‘Intercloud Fabric Learning Lab’
‘DevNet Zone’ Ground Level
cisco.com/go/intercloudfabric Th
e
im

23. © 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
Participate in the “My Favorite Speaker” Contest
• Promote your favorite speaker through Twitter and you could win $200 of Cisco
Press products (@CiscoPress)
• Send a tweet and include
• Your favorite speaker’s Twitter handle @prenatos
• Two hashtags: #CLUS #MyFavoriteSpeaker
• You can submit an entry for more than one of your “favorite” speakers
• Don’t forget to follow @CiscoLive and @CiscoPress
• View the official rules at http://bit.ly/CLUSwin
Promote Your Favorite Speaker and You Could Be a Winner
23

24. © 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
Complete Your Online Session Evaluation
Don’t forget: Cisco Live sessions will be available
for viewing on-­demand after the event at
CiscoLive.com/Online
• Give us your feedback to be
entered into a Daily Survey
Drawing. A daily winner
will receive a $750 Amazon
gift card.
• Complete your session surveys
though the Cisco Live mobile
app or your computer on
Cisco Live Connect.
24

25. Thank you
© 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID 25