GetBaseline

Retrieve details about an existing Baseline resource by specifying its identifier. For usage examples, see the AWS Control Tower User Guide.

Request Syntax


POST /get-baseline HTTP/1.1
Content-type: application/json

{
   "baselineIdentifier": "string"
}

The request does not use any URI parameters.

The request accepts the following data in JSON format.

The ARN of the Baseline resource to be retrieved.

Type: String

Pattern: ^arn:[a-z-]+:controltower:[a-z0-9-]*:[0-9]{0,12}:baseline/[A-Z0-9]{16}$

Required: Yes


HTTP/1.1 200
Content-type: application/json

{
   "arn": "string",
   "description": "string",
   "name": "string"
}

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

arn

The baseline ARN.

Type: String

Pattern: ^arn:[a-z-]+:controltower:[a-z0-9-]*:[0-9]{0,12}:baseline/[A-Z0-9]{16}$

A description of the baseline.

Type: String

A user-friendly name for the baseline.

Type: String

For information about the errors that are common to all actions, see Common Errors.

AccessDeniedException

You do not have sufficient access to perform this action.

HTTP Status Code: 403

InternalServerException

An unexpected error occurred during processing of a request.

HTTP Status Code: 500

ResourceNotFoundException

The request references a resource that does not exist.

HTTP Status Code: 404

ThrottlingException

The request was denied due to request throttling.

HTTP Status Code: 429

ValidationException

The input does not satisfy the constraints specified by an AWS service.

HTTP Status Code: 400