Getting started with the IBM Graph API

To access the resources of IBM Storage Protect for Cloud by using the IBM Graph API, you must configure the app registration and grant the necessary permissions by using the following steps:

• Registering an app: Set up your app in IBM Storage Protect for Cloud.
• Permissions: Assign the appropriate permissions for your app.
• Authentication: Use the generated application (client) ID for secure access.

For a step-by-step guide on creating an app registration for API authentication, see Register an App for API Access.

To interact with resources, construct a request as follows:

{HTTP method} https://{dc}-graph.sp4c.storage-defender.ibm.com/{resource}?{query-parameters} 

After you make a request, a response is returned that includes:

• Status code: An HTTP status code that indicates success or failure.
• Response message: The data that you requested or the result of the operation. The response message can be empty for some operations.
• nextLink: If your request returns much data, you need to page through it by using the URL returned in nextLink.
• Response headers: Additional information about the response, such as the type of content that is returned and the request-ID that you can use to correlate the response to the request.

The API uses the HTTP methods to specify the action that is being performed on a request. The API supports the following method:

Method	Description
GET	Read data from a resource.
POST	Create data in a resource.
DELETE	Delete data from a resource.

HTTP status codes indicate the outcome of a request. Common codes include:

Code	Description
200	OK – The request was successful, and the response contains the requested data.
400	Bad Request – The request might not be processed due to invalid parameters.
500	Internal Server Error – An unexpected server error occurred.