Getting started

HPE GreenLake cloud is a secure, cloud-based platform that allows you to view and control your hybrid cloud estate. HPE GreenLake cloud APIs are a set of RESTful APIs that enable programmatic access to the diverse services offered on the platform. These APIs allow you to automate the management of resources, integrate with third-party tools, and enhance your workflow efficiency by interacting with the platform's infrastructure.

This page explains how developers can get started using the HPE GreenLake Developer Portal.

Prerequisites for using HPE GreenLake APIs

To use the APIs, you need:

• An active HPE GreenLake account. See Creating an HPE account.
• Access to the HPE GreenLake APIs. See Requesting access to HPE GreenLake APIs.
• A Personal API client, including a client ID and secret key. See Creating a Personal API client for details on this process.
• An access token to include in the headers of your API requests. See Generating an access token for details on this process.
• Knowledge of RESTful API principles.
• A development environment with tools to make HTTP requests, such as cURL, Postman, or a programming language like Python.

Creating an HPE account

Your HPE Account is the identity and access management infrastructure service for HPE customers and partners. It provides a consistent identity and access experience between all HPE applications with centralized user registration, profile management, authentication services (including MFA), and support for third party IdPs (Identity Providers) / SSO (Single Sign On).

1. To create an HPE account, click Login.
2. Click Sign Up at the bottom of the page. The Create an HPE Account page appears.
3. Provide the following account information:
   • Email —The email address for your account.
   • Password —A password for accessing your account.
   • First Name/Last Name —Your first and last name.
   • Organization Information —The name and address details of your business.
   • Language — Select your preferred language.
   • Time Zone — Select your time zone.
   • Phone Number — Enter your phone number.
4. Select your contact preferences.
5. Acknowledge the HPE Terms of Use by selecting the check box.
6. Click Create Account. A verification email sent message appears.
7. Verify your email address and activate your new HPE account using the link provided in the email.

Signing in to HPE GreenLake

After creating your HPE account, you can log in to the platform with the credentials that you provided when you created the account.

1. Go to HPE GreenLake.
2. Enter your login credentials. The Welcome to HPE GreenLake page appears. Here, you can create a new workspace or sign in to an existing workspace.

Roles and permissions hierarchy

Some content on the portal can be made completely private, or it can be visible to a restricted group (for example: partners, developers, or administrators).

User roles allow users to access the restricted content. The portal comes with the following roles:

1. Public
2. Partner

Public

1. Guest — Every visitor will have this role with a single permission to read all public content on the portal.
2. Authenticated-User — Every logged in user will have this role.

Partner

Users with the Partner role can access restricted content that is specific to a Partner.

Discover and try the APIs

To find APIs, browse the service catalog or use the search function.

1. Login to the HPE GreenLake Developer Portal.
2. There are three ways to find APIs:
   • Click Services > and select a service from the navigation menu.
   • Enter the name of an API into the search. The results for your search appear beneath the search bar.
   • Navigate to Service > Overview to view a catalog of available APIs along with a description.
3. Click API reference from the service documentation and navigate to an API request. Use the Try It option to experiment with the APIs directly within the platform. This tool allows you to make API calls to understand their behavior and validate their responses.

Requesting access to HPE GreenLake APIs

You must create a support request to get access to HPE GreenLake APIs.

1. While logged in to HPE GreenLake, click Help & Support.
2. In the Help section, select HPE GreenLake.
3. In the Support section, click Create New Case.
4. Fill in the requested details.
   • Enter your name, company name, email, and phone number.
   • Choose your preferred contact method, either email or phone.
   • In Support Issue Details, in What do you need help with?, choose Workspace, User, Onboarding.
   • Choose HPE GreenLake Platform APIs Onboarding .
   • Provide the workspace ID. To find your workspace ID, go to HPE GreenLake cloud, click the workspace menu, and select Manage Workspace.
   • (Optional) In Can you give us more details?, you can:
     • Enter additional details in the text box.
     • Upload a supporting document by clicking Select File.
5. Click Submit . A ticket is created with HPE GreenLake support, and they will respond within 24 hours.

Next steps

Find out how to get authenticated and browse the API catalog.