> **Experimental**
>
> `@aws-cdk/integ-tests-alpha` is an [**experimental**](/stability) (alpha) package: its API may change in any release, without a major version bump.
# HttpRequest

Request to the HttpCall resource.

- Stability: [Experimental](/cdk/api/stability.html)
- Source: [`lib/assertions/providers/lambda-handler/types.ts`](https://github.com/aws/aws-cdk/blob/v2.277.0/packages/@aws-cdk/integ-tests-alpha/lib/assertions/providers/lambda-handler/types.ts#L23)

## Example

TypeScript:

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import * as integ_tests_alpha from '@aws-cdk/integ-tests-alpha';
const httpRequest: integ_tests_alpha.HttpRequest = {
  parameters: {
    url: 'url',

    // the properties below are optional
    fetchOptions: {
      body: 'body',
      headers: {
        headersKey: 'headers',
      },
      method: 'method',
      port: 123,
    },
  },

  // the properties below are optional
  flattenResponse: 'flattenResponse',
};
```

Python:

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

http_request = integ_tests_alpha.HttpRequest(
    parameters=integ_tests_alpha.HttpRequestParameters(
        url="url",

        # the properties below are optional
        fetch_options=integ_tests_alpha.FetchOptions(
            body="body",
            headers={
                "headers_key": "headers"
            },
            method="method",
            port=123
        )
    ),

    # the properties below are optional
    flatten_response="flattenResponse"
)
```

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.integtests.alpha.*;

HttpRequest httpRequest = HttpRequest.builder()
        .parameters(HttpRequestParameters.builder()
                .url("url")

                // the properties below are optional
                .fetchOptions(FetchOptions.builder()
                        .body("body")
                        .headers(Map.of(
                                "headersKey", "headers"))
                        .method("method")
                        .port(123)
                        .build())
                .build())

        // the properties below are optional
        .flattenResponse("flattenResponse")
        .build();
```

C# / .NET:

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

var httpRequest = new HttpRequest {
    Parameters = new HttpRequestParameters {
        Url = "url",

        // the properties below are optional
        FetchOptions = new FetchOptions {
            Body = "body",
            Headers = new Dictionary<string, string> {
                { "headersKey", "headers" }
            },
            Method = "method",
            Port = 123
        }
    },

    // the properties below are optional
    FlattenResponse = "flattenResponse"
};
```

Golang:

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

httpRequest := &HttpRequest{
	Parameters: &HttpRequestParameters{
		Url: jsii.String("url"),

		// the properties below are optional
		FetchOptions: &FetchOptions{
			Body: jsii.String("body"),
			Headers: map[string]*string{
				"headersKey": jsii.String("headers"),
			},
			Method: jsii.String("method"),
			Port: jsii.Number(123),
		},
	},

	// the properties below are optional
	FlattenResponse: jsii.String("flattenResponse"),
}
```

## Properties

- `flattenResponse`: string = 'false' — Whether or not to flatten the response from the HTTP request.

  Valid values are 'true' or 'false' as strings

  Typically when using an HttpRequest you will be passing it as the
  `actual` value to an assertion provider so this would be set
  to 'false' (you want the actual response).

  If you are using the HttpRequest to perform more of a query to return
  a single value to use, then this should be set to 'true'.

- `parameters`: [HttpRequestParameters](/cdk/api/v2/docs/@aws-cdk_integ-tests-alpha.HttpRequestParameters.html) (required) — Parameters from the custom resource.
