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: