Known Issue API Overview

Known Issues are faults, defects, or availability-related issues in Google Cloud or Amazon Web Services that may be impacting the performance or availability of your applications. You can access known issues on the Known Issues page, accessible via the left-hand navigation bar in the CMP as described here

The Known Issues API helps you programmatically obtain your DoiT International cloud provider Known Issues for supported assets such as Google Cloud or Amazon Web Services with an easy-to-use RESTful API.

👍

API Reference

The Known Issues API reference is available at https://developer.doit.com/reference/known-issues

📘

Required Permissions

No permission is required to access Known Issues API

Known Issues API has the following methods:

knownIssues.list

The knownIssues.list method provides a list of all historical and active Known Issues as explained in Manage Known Issues section.

You can filter the list by using one or more of the following parameters:

Sample knownIssues.list Request to list all active Known Issues for Google Cloud:

curl --location --request GET 'https://api.doit.com/core/v1/knownissues?filter=status:active|platform:google-cloud' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer your-api-key' \
--data-raw ''

📘

your-api-key

Always replace "your-api-key" with your actual API key as explained at Getting Started

Sample knownIssues.list Response:

{
	"pageToken": "",
	"knownIssues": [
		{
			"id": "NfSBW5YyXjEO3RWlSAC7",
			"date": 1600886599000000,
			"platform": "google-cloud",
			"product": "Cloud Logging",
			"title": "Google Cloud issue [ONGOING]: Cloud Logging - Alert #169253182",
			"status": "active"
		}
	]
}

knownIssues.get

Gets the full details of the individual Known Issue using the issue id. Please note, the issue id is not the same id as reported by the cloud provider.

Sample knownIssues.get Request

curl --location --request GET 'https://api.doit.com/core/v1/knownissues/wByTuKs4Oo2MHHzLwHCA' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer your-api-key' \
--data-raw ''

📘

your-api-key

Always replace "your-api-key" with your actual API key as explained at Getting Started

Sample knownIssues.get Response:

{
	"id": "wByTuKs4Oo2MHHzLwHCA",
	"date": 1606648783,
	"platform": "amazon-web-services",
	"product": "Ec2",
	"title": "Aws Ec2 Operational Issue",
	"status": "archived",
	"summary": "Network Connectivity",
	"description": "[09:07 PM PST] Between 4:59 AM and 11:25 AM KST, a small number of instances experienced connectivity issues in a single Availability Zone in the AP-NORTHEAST-2 Region",
	"symptoms": "",
	"workaroud": ""
}

Response Body
If successful, the response body contains an instance of Known Issue

{
	"id": string,
	"date": number,
	"platform": string,
	"product": string,
	"title": string,
	"status": string,
	"summary": string,
	"symptoms": string,
	"workaroud": string
}

Response Body Fields