View a markdown version of this page

GetIntelligenceConfiguration - Amazon CloudWatch Omni

GetIntelligenceConfiguration

Retrieves the intelligence configuration for the calling account. Account is identified via FAS (caller identity). Returns the default configuration if none exists yet.

Response Elements

The following elements are returned by the service.

accountId

The AWS account ID this configuration applies to.

Type: String

Length Constraints: Fixed length of 12.

Pattern: [0-9]{12}

createdAt

ISO-8601 timestamp of initial creation.

Type: Timestamp

kmsKeyArn

The currently active KMS key ARN for customer-managed encryption, if configured.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 2048.

Pattern: arn:(aws|aws-cn|aws-us-gov):kms:[a-z0-9-]+:[0-9]{12}:key/(?:mrk-)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

updatedAt

ISO-8601 timestamp of the last update.

Type: Timestamp

Errors

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

AccessDeniedException

The caller is not authorized to perform this action.

HTTP Status Code: 403

InternalServerException

An unexpected error occurred while processing the request.

errorCode

The error code associated with the internal error.

HTTP Status Code: 500

ThrottlingException

The request was throttled due to exceeding the allowed request rate.

retryAfterSeconds

The number of seconds to wait before retrying the request. Not always present.

HTTP Status Code: 429

ValidationException

A parameter is specified incorrectly.

errorCode

The error code associated with the validation failure.

HTTP Status Code: 400

Examples

Retrieve the intelligence configuration

The following example retrieves the intelligence configuration for the calling account. The request carries no parameters; the account is taken from the caller identity. Payloads are shown as JSON; on the wire they are CBOR-encoded.

Sample Request

{}

Sample Response

{ "accountId": "123456789012", "createdAt": "2026-01-15T08:30:00Z", "kmsKeyArn": "arn:aws:kms:us-east-1:123456789012:key/1a2b3c4d-5e6f-4a3b-8c9d-0e1f2a3b4c5d", "updatedAt": "2026-09-16T12:00:00Z" }

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: