API Examples
Configure8 API code examples
We prepared a git repository to show how to interact with the Configure8 public APIs. There are six different examples, each demonstrating a different aspect of the API.
To use these examples, you'll need Node.js installed on your machine. Once you have Node.js installed, you can clone this repository:
git clone https://github.com/Configure8inc/configure8examples.git
cd configure8examples
This repository contains five different examples. Each script has a function call at the end, where you need to replace the placeholders with your actual values.
This script demonstrates how to attach metadata to a service. Replace
"SERVICE_ID" and "YOUR_API_KEY" with your actual service ID and API key.You can run this script with the following command:
npm run pa:service:metadata
Upon successful execution, this script will output:
Metadata attached successfully
Now you can create a scorecard and use the pre-defined metadata tags to add some checks to your scorecard.
For creating a scorecard, please visit: https://app.configure8.io/scorecards/create
This script demonstrates how to create a new service. Replace
"YOUR_API_KEY" with your actual API key.You can run this script with the following command:
npm run pa:service:create
Upon successful execution, this script will output:
Service created successfully
Service ID: <service_id>
Service Name: <service_name>
Your service is available at: https://app.configure8.io/services/<service_id>/overview
This script demonstrates how to retrieve a scorecard. Replace
"SERVICE_ID", "SCORECARD_NAME", and "YOUR_API_KEY" with your actual service ID, scorecard name, and API key.You can run this script with the following command:
npm run pa:scorecard
Upon successful execution, this script will output the details of the scorecards that match the provided service ID and name.
This script demonstrates how to reevaluate a scorecard. Replace
"SCORECARD_ID" and "YOUR_API_KEY" with your actual scorecard ID and API key.You can run this script with the following command:
npm run pa:scorecard:re
Upon successful execution, this script will output:
Scorecard re-evaluation started successfully
For checking the status of the scorecard, please visit: https://app.configure8.io/scorecards/<scorecard_id>/overview
Also you can wait a couple of minutes and check the scorecard status by running npm run pa:scorecard:status
This script demonstrates how to check the status of a scorecard. Replace
"SCORECARD_ID" and "YOUR_API_KEY" with your actual scorecard ID and API key.You can run this script with the following command:
npm run pa:scorecard:status
Upon successful execution, this script will output the status of the specified scorecard.
This script retrieves relations from a remote API using HTTPS. It takes three parameters:
YOUR_API_KEY, SOURCE_ENTITY_ID, and TARGET_ENTITY_ID. You should replace these parameters with your actual API key, source entity ID, and target entity ID. Except for the API key, the other two parameters are optional. If you don't provide SOURCE_ENTITY_ID, the script will retrieve all relations for the specified target entity. If you don't provide TARGET_ENTITY_ID, the script will retrieve all relations for the specified source entity. If you don't provide either of these parameters, the script will retrieve all relations for all entities. Also, you can provide the pageSize and pageNumber (starts from 0) parameters to paginate the results.You can run this script with the following command:
npm run pa:catalog:relations
Upon successful execution, this script will output the relations that match the provided parameters.
This script demonstrates how to create new custom resources on mock data of VMware VMs. Replace
"YOUR_API_KEY" with your actual API key.You can run this script with the following command:
npm run pa:resource:create
Upon successful execution, this script will output similar result:
4 resources created successfully
0 resources failed to be created
vm-1 resource created successfully with id 2d5d44ee-9ac9-4056-ac8a-f85ff576454a
vm-2 resource created successfully with id 95c2de3f-4a93-41c4-abd4-1bc45e35b89e
vm-3 resource created successfully with id 065f9533-85e2-45e6-a93a-7e7a6e7bffaf
vm-4 resource created successfully with id d5afb2ba-7eb0-4096-afb9-43b1e7ef0375
Last modified 7d ago