# QueryArgProfileConfigProperty

How CloudFront handles query arguments, including the profile paired with each one.

- Source: Generated at build time
- Type last changed: v2.275.0 · 26 Oct 2026

## Example

TypeScript:

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_cloudfront as cloudfront } from 'aws-cdk-lib';
const queryArgProfileConfigProperty: cloudfront.CfnFieldLevelEncryptionConfig.QueryArgProfileConfigProperty = {
  forwardWhenQueryArgProfileIsUnknown: false,
  queryArgProfiles: [{
    profileId: 'profileId',
    queryArg: 'queryArg',
  }],
};
```

Python:

```python
# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk import aws_cloudfront as cloudfront

query_arg_profile_config_property = cloudfront.CfnFieldLevelEncryptionConfig.QueryArgProfileConfigProperty(
    forward_when_query_arg_profile_is_unknown=False,
    query_arg_profiles=[cloudfront.CfnFieldLevelEncryptionConfig.QueryArgProfileProperty(
        profile_id="profileId",
        query_arg="queryArg"
    )]
)
```

Java:

```java
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import software.amazon.awscdk.services.cloudfront.*;

QueryArgProfileConfigProperty queryArgProfileConfigProperty = QueryArgProfileConfigProperty.builder()
        .forwardWhenQueryArgProfileIsUnknown(false)
        .queryArgProfiles(List.of(QueryArgProfileProperty.builder()
                .profileId("profileId")
                .queryArg("queryArg")
                .build()))
        .build();
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.Lib
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
using Amazon.CDK.AWS.CloudFront;

var queryArgProfileConfigProperty = new QueryArgProfileConfigProperty {
    ForwardWhenQueryArgProfileIsUnknown = false,
    QueryArgProfiles = new [] { new QueryArgProfileProperty {
        ProfileId = "profileId",
        QueryArg = "queryArg"
    } }
};
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import "github.com/aws/aws-cdk-go/awscdk"

queryArgProfileConfigProperty := &QueryArgProfileConfigProperty{
	ForwardWhenQueryArgProfileIsUnknown: jsii.Boolean(false),
	QueryArgProfiles: []interface{}{
		&QueryArgProfileProperty{
			ProfileId: jsii.String("profileId"),
			QueryArg: jsii.String("queryArg"),
		},
	},
}
```

## Properties

- `forwardWhenQueryArgProfileIsUnknown`: boolean | [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) (required) — Whether CloudFront forwards a request when the query argument names a profile that does not exist.

- `queryArgProfiles`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnFieldLevelEncryptionConfig.QueryArgProfileProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_cloudfront.CfnFieldLevelEncryptionConfig.QueryArgProfileProperty.html)[] (required) — The query arguments paired with a profile.

  Required because the service returns an empty list rather than preserving absence, so an omitted value cannot round-trip. An empty list is accepted and is preserved.
