Skip to main content

objectives

Creates, updates, deletes, gets or lists an objectives resource.

Overview

Nameobjectives
TypeResource
Idaws.controlcatalog.objectives

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
arnstringThe Amazon Resource Name (ARN) that identifies the objective. (pattern: <code>arn:(aws(?:[-a-z]*)?):controlcatalog:::objective/[0-9a-z]+</code>)
create_timestring (date-time)The time when the objective was created.
descriptionstringThe description of the objective.
domainobjectThe domain that the objective belongs to.
last_update_timestring (date-time)The time when the objective was most recently updated.
namestringThe name of the objective.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_objectivesselectregionmaxResults, nextTokenReturns a paginated list of objectives from the Control Catalog. You can apply an optional filter to see the objectives that belong to a specific domain. If you don’t provide a filter, the operation returns all objectives.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
regionstringAWS region (default: us-east-1)
maxResultsintegerThe maximum number of results on a page or for an API request call.
nextTokenstringThe pagination token that's used to fetch the next set of results.

SELECT examples

Returns a paginated list of objectives from the Control Catalog. You can apply an optional filter to see the objectives that belong to a specific domain. If you don’t provide a filter, the operation returns all objectives.

SELECT
arn,
create_time,
description,
domain,
last_update_time,
name
FROM aws.controlcatalog.objectives
WHERE region = '{{ region }}' -- required
AND maxResults = '{{ maxResults }}'
AND nextToken = '{{ nextToken }}'
;