@pulumi/aws-native
Version:
The Pulumi AWS Cloud Control Provider enables you to build, deploy, and manage [any AWS resource that's supported by the AWS Cloud Control API](https://github.com/pulumi/pulumi-aws-native/blob/master/provider/cmd/pulumi-gen-aws-native/supported-types.txt)
196 lines (195 loc) • 10.3 kB
TypeScript
import * as pulumi from "@pulumi/pulumi";
import * as inputs from "../types/input";
import * as outputs from "../types/output";
/**
* An example resource schema demonstrating some basic constructs and validation rules.
*/
export declare class Integration extends pulumi.CustomResource {
/**
* Get an existing Integration resource's state with the given name, ID, and optional extra
* properties used to qualify the lookup.
*
* @param name The _unique_ name of the resulting resource.
* @param id The _unique_ provider ID of the resource to lookup.
* @param opts Optional settings to control the behavior of the CustomResource.
*/
static get(name: string, id: pulumi.Input<pulumi.ID>, opts?: pulumi.CustomResourceOptions): Integration;
/**
* Returns true if the given object is an instance of Integration. This is designed to work even
* when multiple copies of the Pulumi SDK have been loaded into the same process.
*/
static isInstance(obj: any): obj is Integration;
/**
* The API identifier.
*/
readonly apiId: pulumi.Output<string>;
/**
* The ID of the VPC link for a private integration. Supported only for HTTP APIs.
*/
readonly connectionId: pulumi.Output<string | undefined>;
/**
* The type of the network connection to the integration endpoint. Specify INTERNET for connections through the public routable internet or VPC_LINK for private connections between API Gateway and resources in a VPC. The default value is INTERNET.
*/
readonly connectionType: pulumi.Output<string | undefined>;
/**
* Supported only for WebSocket APIs. Specifies how to handle response payload content type conversions. Supported values are CONVERT_TO_BINARY and CONVERT_TO_TEXT.
*/
readonly contentHandlingStrategy: pulumi.Output<string | undefined>;
/**
* Specifies the credentials required for the integration, if any. For AWS integrations, three options are available. To specify an IAM Role for API Gateway to assume, use the role's Amazon Resource Name (ARN). To require that the caller's identity be passed through from the request, specify the string arn:aws:iam::*:user/*. To use resource-based permissions on supported AWS services, don't specify this parameter.
*/
readonly credentialsArn: pulumi.Output<string | undefined>;
/**
* The description of the integration.
*/
readonly description: pulumi.Output<string | undefined>;
/**
* The integration ID.
*/
readonly integrationId: pulumi.Output<string>;
/**
* Specifies the integration's HTTP method type.
*/
readonly integrationMethod: pulumi.Output<string | undefined>;
/**
* Supported only for HTTP API AWS_PROXY integrations. Specifies the AWS service action to invoke.
*/
readonly integrationSubtype: pulumi.Output<string | undefined>;
/**
* The integration type of an integration.
*/
readonly integrationType: pulumi.Output<string>;
/**
* For a Lambda integration, specify the URI of a Lambda function. For an HTTP integration, specify a fully-qualified URL. For an HTTP API private integration, specify the ARN of an Application Load Balancer listener, Network Load Balancer listener, or AWS Cloud Map service.
*/
readonly integrationUri: pulumi.Output<string | undefined>;
/**
* Specifies the pass-through behavior for incoming requests based on the Content-Type header in the request, and the available mapping templates specified as the requestTemplates property on the Integration resource. There are three valid values: WHEN_NO_MATCH, WHEN_NO_TEMPLATES, and NEVER. Supported only for WebSocket APIs.
*/
readonly passthroughBehavior: pulumi.Output<string | undefined>;
/**
* Specifies the format of the payload sent to an integration. Required for HTTP APIs. For HTTP APIs, supported values for Lambda proxy integrations are 1.0 and 2.0 For all other integrations, 1.0 is the only supported value.
*/
readonly payloadFormatVersion: pulumi.Output<string | undefined>;
/**
* A key-value map specifying parameters.
*/
readonly requestParameters: pulumi.Output<{
[key: string]: string;
} | undefined>;
/**
* A map of Velocity templates that are applied on the request payload based on the value of the Content-Type header sent by the client.
*/
readonly requestTemplates: pulumi.Output<{
[key: string]: string;
} | undefined>;
/**
* Parameters that transform the HTTP response from a backend integration before returning the response to clients. Supported only for HTTP APIs.
*/
readonly responseParameters: pulumi.Output<{
[key: string]: outputs.apigatewayv2.IntegrationResponseParameterMap;
} | undefined>;
/**
* The template selection expression for the integration. Supported only for WebSocket APIs.
*/
readonly templateSelectionExpression: pulumi.Output<string | undefined>;
/**
* Custom timeout between 50 and 29000 milliseconds for WebSocket APIs and between 50 and 30000 milliseconds for HTTP APIs. The default timeout is 29 seconds for WebSocket APIs and 30 seconds for HTTP APIs.
*/
readonly timeoutInMillis: pulumi.Output<number | undefined>;
/**
* The TLS configuration for a private integration. If you specify a TLS configuration, private integration traffic uses the HTTPS protocol. Supported only for HTTP APIs.
*/
readonly tlsConfig: pulumi.Output<outputs.apigatewayv2.IntegrationTlsConfig | undefined>;
/**
* Create a Integration resource with the given unique name, arguments, and options.
*
* @param name The _unique_ name of the resource.
* @param args The arguments to use to populate this resource's properties.
* @param opts A bag of options that control this resource's behavior.
*/
constructor(name: string, args: IntegrationArgs, opts?: pulumi.CustomResourceOptions);
}
/**
* The set of arguments for constructing a Integration resource.
*/
export interface IntegrationArgs {
/**
* The API identifier.
*/
apiId: pulumi.Input<string>;
/**
* The ID of the VPC link for a private integration. Supported only for HTTP APIs.
*/
connectionId?: pulumi.Input<string>;
/**
* The type of the network connection to the integration endpoint. Specify INTERNET for connections through the public routable internet or VPC_LINK for private connections between API Gateway and resources in a VPC. The default value is INTERNET.
*/
connectionType?: pulumi.Input<string>;
/**
* Supported only for WebSocket APIs. Specifies how to handle response payload content type conversions. Supported values are CONVERT_TO_BINARY and CONVERT_TO_TEXT.
*/
contentHandlingStrategy?: pulumi.Input<string>;
/**
* Specifies the credentials required for the integration, if any. For AWS integrations, three options are available. To specify an IAM Role for API Gateway to assume, use the role's Amazon Resource Name (ARN). To require that the caller's identity be passed through from the request, specify the string arn:aws:iam::*:user/*. To use resource-based permissions on supported AWS services, don't specify this parameter.
*/
credentialsArn?: pulumi.Input<string>;
/**
* The description of the integration.
*/
description?: pulumi.Input<string>;
/**
* Specifies the integration's HTTP method type.
*/
integrationMethod?: pulumi.Input<string>;
/**
* Supported only for HTTP API AWS_PROXY integrations. Specifies the AWS service action to invoke.
*/
integrationSubtype?: pulumi.Input<string>;
/**
* The integration type of an integration.
*/
integrationType: pulumi.Input<string>;
/**
* For a Lambda integration, specify the URI of a Lambda function. For an HTTP integration, specify a fully-qualified URL. For an HTTP API private integration, specify the ARN of an Application Load Balancer listener, Network Load Balancer listener, or AWS Cloud Map service.
*/
integrationUri?: pulumi.Input<string>;
/**
* Specifies the pass-through behavior for incoming requests based on the Content-Type header in the request, and the available mapping templates specified as the requestTemplates property on the Integration resource. There are three valid values: WHEN_NO_MATCH, WHEN_NO_TEMPLATES, and NEVER. Supported only for WebSocket APIs.
*/
passthroughBehavior?: pulumi.Input<string>;
/**
* Specifies the format of the payload sent to an integration. Required for HTTP APIs. For HTTP APIs, supported values for Lambda proxy integrations are 1.0 and 2.0 For all other integrations, 1.0 is the only supported value.
*/
payloadFormatVersion?: pulumi.Input<string>;
/**
* A key-value map specifying parameters.
*/
requestParameters?: pulumi.Input<{
[key: string]: pulumi.Input<string>;
}>;
/**
* A map of Velocity templates that are applied on the request payload based on the value of the Content-Type header sent by the client.
*/
requestTemplates?: pulumi.Input<{
[key: string]: pulumi.Input<string>;
}>;
/**
* Parameters that transform the HTTP response from a backend integration before returning the response to clients. Supported only for HTTP APIs.
*/
responseParameters?: pulumi.Input<{
[key: string]: pulumi.Input<inputs.apigatewayv2.IntegrationResponseParameterMapArgs>;
}>;
/**
* The template selection expression for the integration. Supported only for WebSocket APIs.
*/
templateSelectionExpression?: pulumi.Input<string>;
/**
* Custom timeout between 50 and 29000 milliseconds for WebSocket APIs and between 50 and 30000 milliseconds for HTTP APIs. The default timeout is 29 seconds for WebSocket APIs and 30 seconds for HTTP APIs.
*/
timeoutInMillis?: pulumi.Input<number>;
/**
* The TLS configuration for a private integration. If you specify a TLS configuration, private integration traffic uses the HTTPS protocol. Supported only for HTTP APIs.
*/
tlsConfig?: pulumi.Input<inputs.apigatewayv2.IntegrationTlsConfigArgs>;
}