HP CloudSystem Foundation Quick Start Guide

HP Cloud Service Automation

For the Windows ® and Linux operating systems

Software Version: 4.00

APIQuick Start

Document Release Date: January 2014

Software Release Date: January 2014

Legal Notices

Warranty

The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.

The information contained herein is subject to change without notice.

Restricted Rights Legend

Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.

Trademark Notices

Adobe™ is a trademark of Adobe Systems Incorporated.

Microsoft® and Windows® are U.S. registered trademarks of Microsoft Corporation.

Oracle and Java are registered trademarks of Oracle and/or its affiliates.

RED HAT READY™ Logo and RED HAT CERTIFIED PARTNER™ Logo are trademarks of Red Hat, Inc.

HP Cloud Service Automation (4.00) Page 2 of 20

Documentation Updates

The title page of this document contains the following identifying information:

l Software Version number, which indicates the software version.

l Document Release Date, which changes each time the document is updated.

l Software Release Date, which indicates the release date of this version of the software.

To check for recent updates or to verify that you are using the most recent edition of a document, go to:

http://h20230.www2.hp.com/selfsolve/manuals

This site requires that you register for an HP Passport and sign in. To register for an HP Passport ID, go to:

http://h20229.www2.hp.com/passport-registration.html

Or click the New users - please register link on the HP Passport login page.

You will also receive updated or new editions if you subscribe to the appropriate product support service. Contact your HP sales representative for details.

HP Cloud Service Automation (4.00) Page 3 of 20

Support

Visit the HP Software Support Online web site at:

http://www.hp.com/go/hpsoftwaresupport

This web site provides contact information and details about the products, services, and support that HP Software offers.

HP Software online support provides customer self-solve capabilities. It provides a fast and efficient way to access interactive technical support tools needed to manage your business. As a valued support customer, you can benefit by using the support web site to:

l Search for knowledge documents of interest

l Submit and track support cases and enhancement requests

l Download software patches

l Manage support contracts

l Look up HP support contacts

l Review information about available services

l Enter into discussions with other software customers

l Research and register for software training

Most of the support areas require that you register as an HP Passport user and sign in. Many also require a support contract. To register for an HP Passport ID, go to:

http://h20229.www2.hp.com/passport-registration.html

To find more information about access levels, go to:

http://h20230.www2.hp.com/new_access_levels.jsp

HP Cloud Service Automation (4.00) Page 4 of 20

Contents 5

Introduction 5

What is HP Cloud Service Automation? 6

HP Cloud Service Automation API Documentation Overview 6

Consumption API Overview 6

Legacy API Overview 8

Deciding which API to use 8

HP Cloud Service Automation API calls 8

Consumption API 8

Legacy CSA 3.x API 9

Retrieving Information from HPCSA 4.00 using RESTful calls 10

Communication with CSA 10

Executing RESTful calls 13

Exercising APIcalls using an HTTPClient 13

Exercising Consumption API calls using the interactive content 15

Making API calls from an application 18

We appreciate your feedback! 19

Introduction

Welcome to HP Cloud Service Automation (HP CSA) API Quick Start. HP CSA orchestrates the deployment of infrastructure compute resources and complex multi-tier application architectures. The Cloud Service Management Console provides for the overall administration and configuration of the Cloud Service Automation system. For application developers, HP CSA provides a REST (REpresentational State Transfer) Application Programming Interface (API) that allows you to interact programmatically with many of the capabilities that HP CSA offers through the Cloud Service Management Console and the Marketplace Portal.

This API Quick Start is designed to help you learn the API by introducing the HP CSA capabilities that can be accessed programmatically, how to access them, and walking through several examples. This guide assumes that you:

1. Understand how to use a RESTful API. See http://en.wikipedia.org/wiki/Representational_ state_transfer for general REST information.

HP Cloud Service Automation (4.00) Page 5 of 20

APIQuick Start Contents

2. Have installed and set up HP Cloud Service Automation, following the instructions in theHP

Cloud Service Automation Installation Guide and the HP Cloud Service Automation Configuration Guide.

What is HP Cloud Service Automation?

HP Cloud Service Automation (HP CSA) is a unique platform that orchestrates the deployment of compute and infrastructure resources and of complex multi-tier application architectures. HP CSA integrates and leverages the strengths of several HP datacenter management and automation products, adding resource management, service offering design, and a customer portal to create a comprehensive service automation solution.

The HP CSA subscription, service design and resource utilization capabilities address three key challenges:

l The Marketplace Portal provides a customer interface for requesting new cloud services and for

monitoring and managing existing services, with subscription pricing to meet your business requirements.

l The HP CSA graphical service design and content portability tools simplify developing,

leveraging, and sharing an array of service offerings that can be tailored to your customers’ needs.

l The HP CSA lifecycle framework and resource utilization features ease the complexity of

mapping your cloud fulfillment infrastructure into reusable, automated resource offerings for ontime and on-budget delivery.

For further information about HP CSA concepts, see the HP Cloud Service Automation Concepts

Guide. For information about the HP CSA management console, see the HP Cloud Service Management Console Help.

HP Cloud Service Automation API Documentation Overview

CSA 4.00 exposes subscription, service and resource information through RESTful API calls.You can exercise all CSA RESTful API calls programmatically and from an HTTP client. You'll find more information on HTTP clients in "Retrieving Information from HPCSA 4.00 using RESTful

calls" on page 10.

Consumption API Overview

HP Cloud Service Automation 4.00 introduced a set of RESTful API calls as well as a framework for describing, producing, consuming and exercising these RESTfulservices. In addition to providing reference API documentation, this content provides an interactive environment where you can exercise API calls and view the response from your server. This set of API calls is referred to as the Consumption API.

HP Cloud Service Automation (4.00)Page 6 of 20

+ 14 hidden pages