Skip to content

AWS Config

Protocol: JSON 1.1 (X-Amz-Target: StarlingDoveService.*) Endpoint: POST http://localhost:4566/

Supported Actions

Config Rules

Action Description
PutConfigRule Create or update a config rule (full rule shape round-trips: description, scope, source details, input parameters, execution frequency, evaluation modes)
DeleteConfigRule Delete a config rule and its evaluation results
DescribeConfigRules List config rules, optionally filtered by name, paginated via NextToken
DescribeConfigRuleEvaluationStatus Get evaluation status for config rules
StartConfigRulesEvaluation Trigger evaluation for config rules

Compliance & Evaluations

Action Description
PutEvaluations Report evaluation results for a config rule (supports TestMode)
PutExternalEvaluation Report a single external evaluation for a config rule
DeleteEvaluationResults Delete all evaluation results for a config rule
DescribeComplianceByConfigRule Get rule-level compliance aggregated from reported evaluations
DescribeComplianceByResource Get resource-level compliance aggregated across rules
GetComplianceDetailsByConfigRule List the evaluation results recorded for a rule
GetComplianceDetailsByResource List the evaluation results recorded for a resource
GetComplianceSummaryByConfigRule Count compliant and non-compliant rules
GetComplianceSummaryByResourceType Count compliant and non-compliant resources, grouped by type

Configuration Recorder

Action Description
PutConfigurationRecorder Create or update a configuration recorder
DescribeConfigurationRecorders List configuration recorders
DeleteConfigurationRecorder Delete a configuration recorder
StartConfigurationRecorder Start recording configuration changes
StopConfigurationRecorder Stop recording configuration changes
DescribeConfigurationRecorderStatus Get the status of configuration recorders. Whether a recorder is recording, and when it last started and stopped, persist with the recorder, so a started recorder is still recording after a restart

DescribeConfigurationRecorders and DescribeConfigurationRecorderStatus accept at most one entry in ConfigurationRecorderNames. More than one entry returns HTTP 400 ValidationException, including repeated names and requests made before any recorder exists. An omitted or empty list selects all recorders; one unknown name returns NoSuchConfigurationRecorderException.

Delivery Channel

Action Description
PutDeliveryChannel Create or update a delivery channel
DescribeDeliveryChannels List delivery channels
DeleteDeliveryChannel Delete a delivery channel (fails while the recorder is running)

Retention Configuration

Action Description
PutRetentionConfiguration Set the retention period (30-2557 days)
DescribeRetentionConfigurations List retention configurations
DeleteRetentionConfiguration Delete the retention configuration

Conformance Packs

Action Description
PutConformancePack Create or update a conformance pack
DeleteConformancePack Delete a conformance pack
DescribeConformancePacks List conformance packs, paginated via Limit/NextToken
DescribeConformancePackStatus Get the deployment status of conformance packs

Aggregation Authorizations

Action Description
PutAggregationAuthorization Authorize an account and region to aggregate this account's Config data
DescribeAggregationAuthorizations List aggregation authorizations, paginated via Limit/NextToken
DeleteAggregationAuthorization Revoke an aggregation authorization

Tagging

Action Description
TagResource Add tags to a Config resource
UntagResource Remove tags from a Config resource
ListTagsForResource List tags on a Config resource

Configuration

Variable Default Description
FLOCI_SERVICES_CONFIGSERVICE_ENABLED true Enable or disable the service

Examples

export AWS_ENDPOINT_URL=http://localhost:4566

# Create a config rule
aws configservice put-config-rule --config-rule '{
  "ConfigRuleName": "s3-bucket-versioning",
  "Description": "Checks that versioning is enabled",
  "Scope": {"ComplianceResourceTypes": ["AWS::S3::Bucket"]},
  "Source": {
    "Owner": "AWS",
    "SourceIdentifier": "S3_BUCKET_VERSIONING_ENABLED"
  }
}'

# List config rules
aws configservice describe-config-rules

# Report evaluation results (the ResultToken is the rule name, see Deviations)
aws configservice put-evaluations \
  --result-token s3-bucket-versioning \
  --evaluations '[{
    "ComplianceResourceType": "AWS::S3::Bucket",
    "ComplianceResourceId": "my-bucket",
    "ComplianceType": "NON_COMPLIANT",
    "Annotation": "Versioning is suspended",
    "OrderingTimestamp": 1700000000.0
  }]'

# Rule compliance now reflects the reported evaluations
aws configservice describe-compliance-by-config-rule \
  --config-rule-names s3-bucket-versioning

# Inspect per-resource evaluation results
aws configservice get-compliance-details-by-config-rule \
  --config-rule-name s3-bucket-versioning

# Set the retention period
aws configservice put-retention-configuration --retention-period-in-days 365

# Create a configuration recorder
aws configservice put-configuration-recorder --configuration-recorder '{
  "name": "default",
  "roleARN": "arn:aws:iam::012345678901:role/config-role",
  "recordingGroup": {
    "allSupported": true,
    "includeGlobalResourceTypes": true
  }
}'

# Start recording
aws configservice start-configuration-recorder --configuration-recorder-name default

# Check recorder status
aws configservice describe-configuration-recorder-status

# Create a conformance pack
aws configservice put-conformance-pack \
  --conformance-pack-name my-pack \
  --template-body "Resources: {}"

# List conformance packs
aws configservice describe-conformance-packs

# Authorize another account to aggregate this account's data
aws configservice put-aggregation-authorization \
  --authorized-account-id 111122223333 \
  --authorized-aws-region eu-west-1

# List aggregation authorizations
aws configservice describe-aggregation-authorizations

# Tag a resource
aws configservice tag-resource \
  --resource-arn arn:aws:config:us-east-1:000000000000:config-rule/config-rule-abc123 \
  --tags Key=env,Value=dev

# Delete a config rule
aws configservice delete-config-rule --config-rule-name s3-bucket-versioning

Deviations

Note

Compliance is driven entirely by evaluations reported through PutEvaluations and PutExternalEvaluation — Floci does not record resource configurations or run rule evaluations itself. Until an evaluation is reported, compliance returns INSUFFICIENT_DATA.

  • ResultToken: real AWS hands custom rules an opaque token inside the evaluation event. Floci has no evaluation event, so PutEvaluations expects the config rule name as the token (a <rule-name>:<suffix> form is also accepted).
  • StartConfigRulesEvaluation marks the rule as invoked but does not call the rule's Lambda function.
  • FirstActivatedTime and invocation timestamps are runtime state and are not persisted across restarts.
  • DescribeConfigRules and DescribeComplianceByConfigRule use a fixed page size of 25.
  • Configuration recorders and delivery channels are stored and validated, but no configuration items or snapshots are produced.
  • Conformance pack status is always CREATE_SUCCESSFUL; pack templates are stored, not evaluated.
  • PutAggregationAuthorization records the authorization and returns its ARN, but no data is aggregated: configuration aggregators are not emulated. DeleteAggregationAuthorization on an authorization that does not exist succeeds, because the Config API models no "not found" error for that operation.
  • TagResource, UntagResource and ListTagsForResource answer ResourceNotFoundException for a config rule, conformance pack, aggregation authorization or configuration recorder ARN that does not name an existing resource in the caller's account and region. ARNs of resource kinds Floci does not model (configuration aggregators, stored queries, organization rules and packs) are accepted without an existence check.
  • PutConfigRule applies its Tags only when it creates the rule; a later PutConfigRule for the same rule leaves its tags unchanged, as AWS documents. Use TagResource and UntagResource to change them. DeleteConfigRule drops the rule's tags. PutConfigurationRecorder and DeleteConfigurationRecorder do the same for the recorder.
  • Every request is checked by RequestConstraintCheck against the types, required members, bounds, patterns and enums generated from botocore's AWS Config service model. tools/aws/regen_config_shapes.py vendors every operation's input constraints; make aws-data-sync regenerates them and make aws-data-check checks for drift. A violation answers ValidationException, or InvalidLimitException for a Limit out of range where the operation models that error, in Floci's own wording. CloudFormation checks an AWS::Config::ConfigRule against PutConfigRule's constraints the same way, so a property outside them fails the resource with that message.
  • PutConfigRule, PutAggregationAuthorization and PutConfigurationRecorder reject more than 50 Tags, a Key outside 1-128 characters or a Value over 256 characters with ValidationException, and a tag without a Key with the operation's modelled error (InvalidParameterValueException for the first two). They store nothing. A tag with no Value is stored with an empty value.