Skip to main content

customer_agreements

Creates, updates, deletes, gets or lists a customer_agreements resource.

Overview

Namecustomer_agreements
TypeResource
Idaws.artifact.customer_agreements

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringIdentifier of the customer-agreement resource. (pattern: <code>customer-agreement-[a-zA-Z0-9]{16}</code>)
namestringName of the customer-agreement resource. (pattern: <code>[^<>]*</code>)
acceptance_termsarrayTerms required to accept the agreement resource.
agreement_arnstringARN of the agreement resource the customer-agreement resource represents. (pattern: <code>[^<>]*</code>)
arnstringARN of the customer-agreement resource. (pattern: <code>[^<>]*</code>)
aws_account_idstringAWS account Id that owns the resource. (pattern: <code>[a-zA-Z0-9_-\s]*</code>)
descriptionstringDescription of the resource. (pattern: <code>[^<>]*</code>)
effective_endstring (date-time)Timestamp indicating when the agreement was terminated.
effective_startstring (date-time)Timestamp indicating when the agreement became effective.
organization_arnstringARN of the organization that owns the resource. (pattern: <code>[^<>]*</code>)
statestringState of the resource. (ACTIVE, CUSTOMER_TERMINATED, AWS_TERMINATED)
terminate_termsarrayTerms required to terminate the customer-agreement resource.
type_stringType of the customer-agreement resource. (CUSTOM, DEFAULT, MODIFIED)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_customer_agreementsselectregionmaxResults, nextTokenList active customer-agreements applicable to calling identity.

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)
maxResultsintegerMaximum number of resources to return in the paginated response.
nextTokenstringPagination token to request the next page of resources.

SELECT examples

List active customer-agreements applicable to calling identity.

SELECT
id,
name,
acceptance_terms,
agreement_arn,
arn,
aws_account_id,
description,
effective_end,
effective_start,
organization_arn,
state,
terminate_terms,
type_
FROM aws.artifact.customer_agreements
WHERE region = '{{ region }}' -- required
AND maxResults = '{{ maxResults }}'
AND nextToken = '{{ nextToken }}'
;