Fork me on GitHub

Module apigateway

@pulumi/aws > apigateway

Index

apigateway/account.ts apigateway/apiKey.ts apigateway/authorizer.ts apigateway/basePathMapping.ts apigateway/clientCertificate.ts apigateway/deployment.ts apigateway/documentationPart.ts apigateway/documentationVersion.ts apigateway/domainName.ts apigateway/getResource.ts apigateway/getRestApi.ts apigateway/integration.ts apigateway/integrationResponse.ts apigateway/method.ts apigateway/methodResponse.ts apigateway/methodSettings.ts apigateway/model.ts apigateway/requestValidator.ts apigateway/resource.ts apigateway/response.ts apigateway/restApi.ts apigateway/stage.ts apigateway/usagePlan.ts apigateway/usagePlanKey.ts apigateway/vpcLink.ts

class Account

Provides a settings of an API Gateway Account. Settings is applied region-wide per provider block.

-> Note: As there is no API method for deleting account settings or resetting it to defaults, destroying this resource will keep your account settings intact

constructor

new Account(name: string, args?: AccountArgs, opts?: pulumi.CustomResourceOptions)

Create a Account resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: AccountState): Account

Get an existing Account resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property cloudwatchRoleArn

public cloudwatchRoleArn: pulumi.Output<string | undefined>;

The ARN of an IAM role for CloudWatch (to allow logging & monitoring). See more in AWS Docs. Logging & monitoring can be enabled/disabled and otherwise tuned on the API Gateway Stage level.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property throttleSettings

public throttleSettings: pulumi.Output<{ ... }>;

Account-Level throttle settings. See exported fields below.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class ApiKey

Provides an API Gateway API Key.

~> Warning: Since the API Gateway usage plans feature was launched on August 11, 2016, usage plans are now required to associate an API key with an API stage.

constructor

new ApiKey(name: string, args?: ApiKeyArgs, opts?: pulumi.CustomResourceOptions)

Create a ApiKey resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: ApiKeyState): ApiKey

Get an existing ApiKey resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property createdDate

public createdDate: pulumi.Output<string>;

The creation date of the API key

property description

public description: pulumi.Output<string>;

The API key description. Defaults to “Managed by Terraform”.

property enabled

public enabled: pulumi.Output<boolean | undefined>;

Specifies whether the API key can be used by callers. Defaults to true.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property lastUpdatedDate

public lastUpdatedDate: pulumi.Output<string>;

The last update date of the API key

property name

public name: pulumi.Output<string>;

The name of the API key

property stageKeys

public stageKeys: pulumi.Output<{ ... }[] | undefined>;

A list of stage keys associated with the API key - see below

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

property value

public value: pulumi.Output<string>;

The value of the API key. If not specified, it will be automatically generated by AWS on creation.

class Authorizer

Provides an API Gateway Authorizer.

constructor

new Authorizer(name: string, args: AuthorizerArgs, opts?: pulumi.CustomResourceOptions)

Create a Authorizer resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: AuthorizerState): Authorizer

Get an existing Authorizer resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property authorizerCredentials

public authorizerCredentials: pulumi.Output<string | undefined>;

The credentials required for the authorizer. To specify an IAM Role for API Gateway to assume, use the IAM Role ARN.

property authorizerResultTtlInSeconds

public authorizerResultTtlInSeconds: pulumi.Output<number | undefined>;

The TTL of cached authorizer results in seconds. Defaults to 300.

property authorizerUri

public authorizerUri: pulumi.Output<string | undefined>;

The authorizer’s Uniform Resource Identifier (URI). This must be a well-formed Lambda function URI in the form of arn:aws:apigateway:{region}:lambda:path/{service_api}, e.g. arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:012345678912:function:my-function/invocations

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property identitySource

public identitySource: pulumi.Output<string | undefined>;

The source of the identity in an incoming request. Defaults to method.request.header.Authorization. For REQUEST type, this may be a comma-separated list of values, including headers, query string parameters and stage variables - e.g. "method.request.header.SomeHeaderName,method.request.querystring.SomeQueryStringName,stageVariables.SomeStageVariableName"

property identityValidationExpression

public identityValidationExpression: pulumi.Output<string | undefined>;

A validation expression for the incoming identity. For TOKEN type, this value should be a regular expression. The incoming token from the client is matched against this expression, and will proceed if the token matches. If the token doesn’t match, the client receives a 401 Unauthorized response.

property name

public name: pulumi.Output<string>;

The name of the authorizer

property providerArns

public providerArns: pulumi.Output<string[] | undefined>;

A list of the Amazon Cognito user pool ARNs. Each element is of this format: arn:aws:cognito-idp:{region}:{account_id}:userpool/{user_pool_id}.

property restApi

public restApi: pulumi.Output<RestApi>;

The ID of the associated REST API

property type

public type: pulumi.Output<string | undefined>;

The type of the authorizer. Possible values are TOKEN for a Lambda function using a single authorization token submitted in a custom header, REQUEST for a Lambda function using incoming request parameters, or COGNITO_USER_POOLS for using an Amazon Cognito user pool. Defaults to TOKEN.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class BasePathMapping

Connects a custom domain name registered via aws_api_gateway_domain_name with a deployed API so that its methods can be called via the custom domain name.

constructor

new BasePathMapping(name: string, args: BasePathMappingArgs, opts?: pulumi.CustomResourceOptions)

Create a BasePathMapping resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: BasePathMappingState): BasePathMapping

Get an existing BasePathMapping resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property basePath

public basePath: pulumi.Output<string | undefined>;

Path segment that must be prepended to the path when accessing the API via this mapping. If omitted, the API is exposed at the root of the given domain.

property domainName

public domainName: pulumi.Output<string>;

The already-registered domain name to connect the API to.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property restApi

public restApi: pulumi.Output<RestApi>;

The id of the API to connect.

property stageName

public stageName: pulumi.Output<string | undefined>;

The name of a specific deployment stage to expose at the given path. If omitted, callers may select any stage by including its name as a path element after the base path.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class ClientCertificate

Provides an API Gateway Client Certificate.

constructor

new ClientCertificate(name: string, args?: ClientCertificateArgs, opts?: pulumi.CustomResourceOptions)

Create a ClientCertificate resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: ClientCertificateState): ClientCertificate

Get an existing ClientCertificate resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property createdDate

public createdDate: pulumi.Output<string>;

The date when the client certificate was created.

property description

public description: pulumi.Output<string | undefined>;

The description of the client certificate.

property expirationDate

public expirationDate: pulumi.Output<string>;

The date when the client certificate will expire.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property pemEncodedCertificate

public pemEncodedCertificate: pulumi.Output<string>;

The PEM-encoded public key of the client certificate.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class Deployment

Provides an API Gateway Deployment.

-> Note: Depends on having aws_api_gateway_integration inside your rest api (which in turn depends on aws_api_gateway_method). To avoid race conditions you might need to add an explicit depends_on = ["aws_api_gateway_integration.name"].

constructor

new Deployment(name: string, args: DeploymentArgs, opts?: pulumi.CustomResourceOptions)

Create a Deployment resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: DeploymentState): Deployment

Get an existing Deployment resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property createdDate

public createdDate: pulumi.Output<string>;

The creation date of the deployment

property description

public description: pulumi.Output<string | undefined>;

The description of the deployment

property executionArn

public executionArn: pulumi.Output<string>;

The execution ARN to be used in lambda_permission’s source_arn when allowing API Gateway to invoke a Lambda function, e.g. arn:aws:execute-api:eu-west-2:123456789012:z4675bid1j/prod

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property invokeUrl

public invokeUrl: pulumi.Output<string>;

The URL to invoke the API pointing to the stage, e.g. https://z4675bid1j.execute-api.eu-west-2.amazonaws.com/prod

property restApi

public restApi: pulumi.Output<RestApi>;

The ID of the associated REST API

property stageDescription

public stageDescription: pulumi.Output<string | undefined>;

The description of the stage

property stageName

public stageName: pulumi.Output<string>;

The name of the stage. If the specified stage already exists, it will be updated to point to the new deployment. If the stage does not exist, a new one will be created and point to this deployment. Use "" to point at the default stage.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

property variables

public variables: pulumi.Output<{ ... } | undefined>;

A map that defines variables for the stage

class DocumentationPart

Provides a settings of an API Gateway Documentation Part.

constructor

new DocumentationPart(name: string, args: DocumentationPartArgs, opts?: pulumi.CustomResourceOptions)

Create a DocumentationPart resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: DocumentationPartState): DocumentationPart

Get an existing DocumentationPart resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property location

public location: pulumi.Output<{ ... }>;

The location of the targeted API entity of the to-be-created documentation part. See below.

property properties

public properties: pulumi.Output<string>;

A content map of API-specific key-value pairs describing the targeted API entity. The map must be encoded as a JSON string, e.g., “{ "description": "The API does …" }”. Only Swagger-compliant key-value pairs can be exported and, hence, published.

property restApiId

public restApiId: pulumi.Output<string>;

The ID of the associated Rest API

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class DocumentationVersion

Provides a resource to manage an API Gateway Documentation Version.

constructor

new DocumentationVersion(name: string, args: DocumentationVersionArgs, opts?: pulumi.CustomResourceOptions)

Create a DocumentationVersion resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: DocumentationVersionState): DocumentationVersion

Get an existing DocumentationVersion resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property description

public description: pulumi.Output<string | undefined>;

The description of the API documentation version.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property restApiId

public restApiId: pulumi.Output<string>;

The ID of the associated Rest API

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

property version

public version: pulumi.Output<string>;

The version identifier of the API documentation snapshot.

class DomainName

Registers a custom domain name for use with AWS API Gateway.

This resource just establishes ownership of and the TLS settings for a particular domain name. An API can be attached to a particular path under the registered domain name using the aws_api_gateway_base_path_mapping resource.

API Gateway domains can be defined as either ‘edge-optimized’ or ‘regional’. In an edge-optimized configuration, API Gateway internally creates and manages a CloudFront distribution to route requests on the given hostname. In addition to this resource it’s necessary to create a DNS record corresponding to the given domain name which is an alias (either Route53 alias or traditional CNAME) to the Cloudfront domain name exported in the cloudfront_domain_name attribute.

In a regional configuration, API Gateway does not create a CloudFront distribution to route requests to the API, though a distribution can be created if needed. In either case, it is necessary to create a DNS record corresponding to the given domain name which is an alias (either Route53 alias or traditional CNAME) to the regional domain name exported in the regional_domain_name attribute.

~> Note: All arguments including the private key will be stored in the raw state as plain-text. Read more about sensitive data in state.

constructor

new DomainName(name: string, args: DomainNameArgs, opts?: pulumi.CustomResourceOptions)

Create a DomainName resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: DomainNameState): DomainName

Get an existing DomainName resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property certificateArn

public certificateArn: pulumi.Output<string | undefined>;

The ARN for an AWS-managed certificate. Used when an edge-optimized domain name is desired. Conflicts with certificate_name, certificate_body, certificate_chain, certificate_private_key, regional_certificate_arn, and regional_certificate_name.

property certificateBody

public certificateBody: pulumi.Output<string | undefined>;

The certificate issued for the domain name being registered, in PEM format. Only valid for EDGE endpoint configuration type. Conflicts with certificate_arn, regional_certificate_arn, and regional_certificate_name.

property certificateChain

public certificateChain: pulumi.Output<string | undefined>;

The certificate for the CA that issued the certificate, along with any intermediate CA certificates required to create an unbroken chain to a certificate trusted by the intended API clients. Only valid for EDGE endpoint configuration type. Conflicts with certificate_arn, regional_certificate_arn, and regional_certificate_name.

property certificateName

public certificateName: pulumi.Output<string | undefined>;

The unique name to use when registering this certificate as an IAM server certificate. Conflicts with certificate_arn, regional_certificate_arn, and regional_certificate_name. Required if certificate_arn is not set.

property certificatePrivateKey

public certificatePrivateKey: pulumi.Output<string | undefined>;

The private key associated with the domain certificate given in certificate_body. Only valid for EDGE endpoint configuration type. Conflicts with certificate_arn, regional_certificate_arn, and regional_certificate_name.

property certificateUploadDate

public certificateUploadDate: pulumi.Output<string>;

The upload date associated with the domain certificate.

property cloudfrontDomainName

public cloudfrontDomainName: pulumi.Output<string>;

The hostname created by Cloudfront to represent the distribution that implements this domain name mapping.

property cloudfrontZoneId

public cloudfrontZoneId: pulumi.Output<string>;

For convenience, the hosted zone ID (Z2FDTNDATAQYW2) that can be used to create a Route53 alias record for the distribution.

property domainName

public domainName: pulumi.Output<string>;

The fully-qualified domain name to register

property endpointConfiguration

public endpointConfiguration: pulumi.Output<{ ... }>;

Nested argument defining API endpoint configuration including endpoint type. Defined below.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property regionalCertificateArn

public regionalCertificateArn: pulumi.Output<string | undefined>;

The ARN for an AWS-managed certificate. Used when a regional domain name is desired. Conflicts with certificate_arn, certificate_name, certificate_body, certificate_chain, and certificate_private_key.

property regionalCertificateName

public regionalCertificateName: pulumi.Output<string | undefined>;

The user-friendly name of the certificate that will be used by regional endpoint for this domain name. Conflicts with certificate_arn, certificate_name, certificate_body, certificate_chain, and certificate_private_key.

property regionalDomainName

public regionalDomainName: pulumi.Output<string>;

The hostname for the custom domain’s regional endpoint.

property regionalZoneId

public regionalZoneId: pulumi.Output<string>;

The hosted zone ID that can be used to create a Route53 alias record for the regional endpoint.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class Integration

Provides an HTTP Method Integration for an API Gateway Integration.

constructor

new Integration(name: string, args: IntegrationArgs, opts?: pulumi.CustomResourceOptions)

Create a Integration resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: IntegrationState): Integration

Get an existing Integration resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property cacheKeyParameters

public cacheKeyParameters: pulumi.Output<string[] | undefined>;

A list of cache key parameters for the integration.

property cacheNamespace

public cacheNamespace: pulumi.Output<string>;

The integration’s cache namespace.

property connectionId

public connectionId: pulumi.Output<string | undefined>;

The id of the VpcLink used for the integration. Required if connection_type is VPC_LINK

property connectionType

public connectionType: pulumi.Output<string | undefined>;

The integration input’s connectionType. Valid values are INTERNET (default for connections through the public routable internet), and VPC_LINK (for private connections between API Gateway and a network load balancer in a VPC).

property contentHandling

public contentHandling: pulumi.Output<string | undefined>;

Specifies how to handle request payload content type conversions. Supported values are CONVERT_TO_BINARY and CONVERT_TO_TEXT. If this property is not defined, the request payload will be passed through from the method request to integration request without modification, provided that the passthroughBehaviors is configured to support payload pass-through.

property credentials

public credentials: pulumi.Output<string | undefined>;

The credentials required for the integration. For AWS integrations, 2 options are available. To specify an IAM Role for Amazon API Gateway to assume, use the role’s ARN. To require that the caller’s identity be passed through from the request, specify the string arn:aws:iam::\*:user/\*.

property httpMethod

public httpMethod: pulumi.Output<string>;

The HTTP method (GET, POST, PUT, DELETE, HEAD, OPTION, ANY) when calling the associated resource.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property integrationHttpMethod

public integrationHttpMethod: pulumi.Output<string | undefined>;

The integration HTTP method (GET, POST, PUT, DELETE, HEAD, OPTION) specifying how API Gateway will interact with the back end. Required if type is AWS, AWS_PROXY, HTTP or HTTP_PROXY. Not all methods are compatible with all AWS integrations. e.g. Lambda function can only be invoked via POST.

property passthroughBehavior

public passthroughBehavior: pulumi.Output<string>;

The integration passthrough behavior (WHEN_NO_MATCH, WHEN_NO_TEMPLATES, NEVER). Required if request_templates is used.

property requestParameters

public requestParameters: pulumi.Output<{ ... } | undefined>;

A map of request query string parameters and headers that should be passed to the backend responder. For example: request_parameters = { "integration.request.header.X-Some-Other-Header" = "method.request.header.X-Some-Header" }

property requestParametersInJson

public requestParametersInJson: pulumi.Output<string | undefined>;

Deprecated, use request_parameters instead.

property requestTemplates

public requestTemplates: pulumi.Output<{ ... } | undefined>;

A map of the integration’s request templates.

property resourceId

public resourceId: pulumi.Output<string>;

The API resource ID.

property restApi

public restApi: pulumi.Output<RestApi>;

The ID of the associated REST API.

property timeoutMilliseconds

public timeoutMilliseconds: pulumi.Output<number | undefined>;

Custom timeout between 50 and 29,000 milliseconds. The default value is 29,000 milliseconds.

property type

public type: pulumi.Output<string>;

The integration input’s type. Valid values are HTTP (for HTTP backends), MOCK (not calling any real backend), AWS (for AWS services), AWS_PROXY (for Lambda proxy integration) and HTTP_PROXY (for HTTP proxy integration). An HTTP or HTTP_PROXY integration with a connection_type of VPC_LINK is referred to as a private integration and uses a VpcLink to connect API Gateway to a network load balancer of a VPC.

property uri

public uri: pulumi.Output<string | undefined>;

The input’s URI (HTTP, AWS). Required if type is HTTP or AWS. For HTTP integrations, the URI must be a fully formed, encoded HTTP(S) URL according to the RFC-3986 specification . For AWS integrations, the URI should be of the form arn:aws:apigateway:{region}:{subdomain.service|service}:{path|action}/{service_api}. region, subdomain and service are used to determine the right endpoint. e.g. arn:aws:apigateway:eu-west-1:lambda:path/2015-03-31/functions/arn:aws:lambda:eu-west-1:012345678901:function:my-func/invocations

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class IntegrationResponse

Provides an HTTP Method Integration Response for an API Gateway Resource.

-> Note: Depends on having aws_api_gateway_integration inside your rest api. To ensure this you might need to add an explicit depends_on for clean runs.

constructor

new IntegrationResponse(name: string, args: IntegrationResponseArgs, opts?: pulumi.CustomResourceOptions)

Create a IntegrationResponse resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: IntegrationResponseState): IntegrationResponse

Get an existing IntegrationResponse resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property contentHandling

public contentHandling: pulumi.Output<string | undefined>;

Specifies how to handle request payload content type conversions. Supported values are CONVERT_TO_BINARY and CONVERT_TO_TEXT. If this property is not defined, the response payload will be passed through from the integration response to the method response without modification.

property httpMethod

public httpMethod: pulumi.Output<string>;

The HTTP method (GET, POST, PUT, DELETE, HEAD, OPTIONS, ANY)

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property resourceId

public resourceId: pulumi.Output<string>;

The API resource ID

property responseParameters

public responseParameters: pulumi.Output<{ ... } | undefined>;

A map of response parameters that can be read from the backend response. For example: response_parameters = { "method.response.header.X-Some-Header" = "integration.response.header.X-Some-Other-Header" },

property responseParametersInJson

public responseParametersInJson: pulumi.Output<string | undefined>;

Deprecated, use response_parameters instead.

property responseTemplates

public responseTemplates: pulumi.Output<{ ... } | undefined>;

A map specifying the templates used to transform the integration response body

property restApi

public restApi: pulumi.Output<RestApi>;

The ID of the associated REST API

property selectionPattern

public selectionPattern: pulumi.Output<string | undefined>;

Specifies the regular expression pattern used to choose an integration response based on the response from the backend. Setting this to - makes the integration the default one. If the backend is an AWS Lambda function, the AWS Lambda function error header is matched. For all other HTTP and AWS backends, the HTTP status code is matched.

property statusCode

public statusCode: pulumi.Output<string>;

The HTTP status code

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class Method

Provides a HTTP Method for an API Gateway Resource.

constructor

new Method(name: string, args: MethodArgs, opts?: pulumi.CustomResourceOptions)

Create a Method resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: MethodState): Method

Get an existing Method resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property apiKeyRequired

public apiKeyRequired: pulumi.Output<boolean | undefined>;

Specify if the method requires an API key

property authorization

public authorization: pulumi.Output<string>;

The type of authorization used for the method (NONE, CUSTOM, AWS_IAM, COGNITO_USER_POOLS)

property authorizationScopes

public authorizationScopes: pulumi.Output<string[] | undefined>;

The authorization scopes used when the authorization is COGNITO_USER_POOLS

property authorizerId

public authorizerId: pulumi.Output<string | undefined>;

The authorizer id to be used when the authorization is CUSTOM or COGNITO_USER_POOLS

property httpMethod

public httpMethod: pulumi.Output<string>;

The HTTP Method (GET, POST, PUT, DELETE, HEAD, OPTIONS, ANY)

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property requestModels

public requestModels: pulumi.Output<{ ... } | undefined>;

A map of the API models used for the request’s content type where key is the content type (e.g. application/json) and value is either Error, Empty (built-in models) or aws_api_gateway_model’s name.

property requestParameters

public requestParameters: pulumi.Output<{ ... } | undefined>;

A map of request query string parameters and headers that should be passed to the integration. For example:

request_parameters = {
"method.request.header.X-Some-Header" = true,
"method.request.querystring.some-query-param"  = true,
}

would define that the header X-Some-Header and the query string some-query-param must be provided on the request, or

property requestParametersInJson

public requestParametersInJson: pulumi.Output<string | undefined>;

Deprecated, use request_parameters instead.

property requestValidatorId

public requestValidatorId: pulumi.Output<string | undefined>;

The ID of a aws_api_gateway_request_validator

property resourceId

public resourceId: pulumi.Output<string>;

The API resource ID

property restApi

public restApi: pulumi.Output<RestApi>;

The ID of the associated REST API

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class MethodResponse

Provides an HTTP Method Response for an API Gateway Resource.

constructor

new MethodResponse(name: string, args: MethodResponseArgs, opts?: pulumi.CustomResourceOptions)

Create a MethodResponse resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: MethodResponseState): MethodResponse

Get an existing MethodResponse resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property httpMethod

public httpMethod: pulumi.Output<string>;

The HTTP Method (GET, POST, PUT, DELETE, HEAD, OPTIONS, ANY)

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property resourceId

public resourceId: pulumi.Output<string>;

The API resource ID

property responseModels

public responseModels: pulumi.Output<{ ... } | undefined>;

A map of the API models used for the response’s content type

property responseParameters

public responseParameters: pulumi.Output<{ ... } | undefined>;

A map of response parameters that can be sent to the caller. For example: response_parameters = { "method.response.header.X-Some-Header" = true } would define that the header X-Some-Header can be provided on the response.

property responseParametersInJson

public responseParametersInJson: pulumi.Output<string | undefined>;

Deprecated, use response_parameters instead.

property restApi

public restApi: pulumi.Output<RestApi>;

The ID of the associated REST API

property statusCode

public statusCode: pulumi.Output<string>;

The HTTP status code

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class MethodSettings

Provides an API Gateway Method Settings, e.g. logging or monitoring.

constructor

new MethodSettings(name: string, args: MethodSettingsArgs, opts?: pulumi.CustomResourceOptions)

Create a MethodSettings resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: MethodSettingsState): MethodSettings

Get an existing MethodSettings resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property methodPath

public methodPath: pulumi.Output<string>;

Method path defined as {resource_path}/{http_method} for an individual method override, or *&#47;* for overriding all methods in the stage.

property restApi

public restApi: pulumi.Output<RestApi>;

The ID of the REST API

property settings

public settings: pulumi.Output<{ ... }>;

The settings block, see below.

property stageName

public stageName: pulumi.Output<string>;

The name of the stage

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class Model

Provides a Model for a API Gateway.

constructor

new Model(name: string, args: ModelArgs, opts?: pulumi.CustomResourceOptions)

Create a Model resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: ModelState): Model

Get an existing Model resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property contentType

public contentType: pulumi.Output<string>;

The content type of the model

property description

public description: pulumi.Output<string | undefined>;

The description of the model

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property name

public name: pulumi.Output<string>;

The name of the model

property restApi

public restApi: pulumi.Output<RestApi>;

The ID of the associated REST API

property schema

public schema: pulumi.Output<string | undefined>;

The schema of the model in a JSON form

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class RequestValidator

Manages an API Gateway Request Validator.

constructor

new RequestValidator(name: string, args: RequestValidatorArgs, opts?: pulumi.CustomResourceOptions)

Create a RequestValidator resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: RequestValidatorState): RequestValidator

Get an existing RequestValidator resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property name

public name: pulumi.Output<string>;

The name of the request validator

property restApi

public restApi: pulumi.Output<RestApi>;

The ID of the associated Rest API

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

property validateRequestBody

public validateRequestBody: pulumi.Output<boolean | undefined>;

Boolean whether to validate request body. Defaults to false.

property validateRequestParameters

public validateRequestParameters: pulumi.Output<boolean | undefined>;

Boolean whether to validate request parameters. Defaults to false.

class Resource

Provides an API Gateway Resource.

constructor

new Resource(name: string, args: ResourceArgs, opts?: pulumi.CustomResourceOptions)

Create a Resource resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: ResourceState): Resource

Get an existing Resource resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property parentId

public parentId: pulumi.Output<string>;

The ID of the parent API resource

property path

public path: pulumi.Output<string>;

The complete path for this API resource, including all parent paths.

property pathPart

public pathPart: pulumi.Output<string>;

The last path segment of this API resource.

property restApi

public restApi: pulumi.Output<RestApi>;

The ID of the associated REST API

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class Response

Provides an API Gateway Gateway Response for a REST API Gateway.

constructor

new Response(name: string, args: ResponseArgs, opts?: pulumi.CustomResourceOptions)

Create a Response resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: ResponseState): Response

Get an existing Response resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property responseParameters

public responseParameters: pulumi.Output<{ ... } | undefined>;

A map specifying the templates used to transform the response body.

property responseTemplates

public responseTemplates: pulumi.Output<{ ... } | undefined>;

A map specifying the parameters (paths, query strings and headers) of the Gateway Response.

property responseType

public responseType: pulumi.Output<string>;

The response type of the associated GatewayResponse.

property restApiId

public restApiId: pulumi.Output<string>;

The string identifier of the associated REST API.

property statusCode

public statusCode: pulumi.Output<string | undefined>;

The HTTP status code of the Gateway Response.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class RestApi

Provides an API Gateway REST API.

constructor

new RestApi(name: string, args?: RestApiArgs, opts?: pulumi.CustomResourceOptions)

Create a RestApi resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: RestApiState): RestApi

Get an existing RestApi resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property apiKeySource

public apiKeySource: pulumi.Output<string | undefined>;

The source of the API key for requests. Valid values are HEADER (default) and AUTHORIZER.

property binaryMediaTypes

public binaryMediaTypes: pulumi.Output<string[] | undefined>;

The list of binary media types supported by the RestApi. By default, the RestApi supports only UTF-8-encoded text payloads.

property body

public body: pulumi.Output<string | undefined>;

An OpenAPI specification that defines the set of routes and integrations to create as part of the REST API.

property createdDate

public createdDate: pulumi.Output<string>;

The creation date of the REST API

property description

public description: pulumi.Output<string | undefined>;

The description of the REST API

property endpointConfiguration

public endpointConfiguration: pulumi.Output<{ ... }>;

Nested argument defining API endpoint configuration including endpoint type. Defined below.

property executionArn

public executionArn: pulumi.Output<string>;

The execution ARN part to be used in lambda_permission’s source_arn when allowing API Gateway to invoke a Lambda function, e.g. arn:aws:execute-api:eu-west-2:123456789012:z4675bid1j, which can be concatenated with allowed stage, method and resource path.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property minimumCompressionSize

public minimumCompressionSize: pulumi.Output<number | undefined>;

Minimum response size to compress for the REST API. Integer between -1 and 10485760 (10MB). Setting a value greater than -1 will enable compression, -1 disables compression (default).

property name

public name: pulumi.Output<string>;

The name of the REST API

property policy

public policy: pulumi.Output<string | undefined>;

JSON formatted policy document that controls access to the API Gateway

property rootResourceId

public rootResourceId: pulumi.Output<string>;

The resource ID of the REST API’s root

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class Stage

Provides an API Gateway Stage.

constructor

new Stage(name: string, args: StageArgs, opts?: pulumi.CustomResourceOptions)

Create a Stage resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: StageState): Stage

Get an existing Stage resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property accessLogSettings

public accessLogSettings: pulumi.Output<{ ... } | undefined>;

Enables access logs for the API stage. Detailed below.

property cacheClusterEnabled

public cacheClusterEnabled: pulumi.Output<boolean | undefined>;

Specifies whether a cache cluster is enabled for the stage

property cacheClusterSize

public cacheClusterSize: pulumi.Output<string | undefined>;

The size of the cache cluster for the stage, if enabled. Allowed values include 0.5, 1.6, 6.1, 13.5, 28.4, 58.2, 118 and 237.

property clientCertificateId

public clientCertificateId: pulumi.Output<string | undefined>;

The identifier of a client certificate for the stage.

property deployment

public deployment: pulumi.Output<Deployment>;

The ID of the deployment that the stage points to

property description

public description: pulumi.Output<string | undefined>;

The description of the stage

property documentationVersion

public documentationVersion: pulumi.Output<string | undefined>;

The version of the associated API documentation

property executionArn

public executionArn: pulumi.Output<string>;

The execution ARN to be used in lambda_permission’s source_arn when allowing API Gateway to invoke a Lambda function, e.g. arn:aws:execute-api:eu-west-2:123456789012:z4675bid1j/prod

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property invokeUrl

public invokeUrl: pulumi.Output<string>;

The URL to invoke the API pointing to the stage, e.g. https://z4675bid1j.execute-api.eu-west-2.amazonaws.com/prod

property restApi

public restApi: pulumi.Output<RestApi>;

The ID of the associated REST API

property stageName

public stageName: pulumi.Output<string>;

The name of the stage

property tags

public tags: pulumi.Output<Tags | undefined>;

A mapping of tags to assign to the resource.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

property variables

public variables: pulumi.Output<{ ... } | undefined>;

A map that defines the stage variables

property xrayTracingEnabled

public xrayTracingEnabled: pulumi.Output<boolean | undefined>;

Whether active tracing with X-ray is enabled. Defaults to false.

class UsagePlan

Provides an API Gateway Usage Plan.

constructor

new UsagePlan(name: string, args?: UsagePlanArgs, opts?: pulumi.CustomResourceOptions)

Create a UsagePlan resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: UsagePlanState): UsagePlan

Get an existing UsagePlan resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property apiStages

public apiStages: pulumi.Output<{ ... }[] | undefined>;

The associated API stages of the usage plan.

property description

public description: pulumi.Output<string | undefined>;

The description of a usage plan.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property name

public name: pulumi.Output<string>;

The name of the usage plan.

property productCode

public productCode: pulumi.Output<string | undefined>;

The AWS Markeplace product identifier to associate with the usage plan as a SaaS product on AWS Marketplace.

property quotaSettings

public quotaSettings: pulumi.Output<{ ... } | undefined>;

The quota settings of the usage plan.

property throttleSettings

public throttleSettings: pulumi.Output<{ ... } | undefined>;

The throttling limits of the usage plan.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class UsagePlanKey

Provides an API Gateway Usage Plan Key.

constructor

new UsagePlanKey(name: string, args: UsagePlanKeyArgs, opts?: pulumi.CustomResourceOptions)

Create a UsagePlanKey resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: UsagePlanKeyState): UsagePlanKey

Get an existing UsagePlanKey resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property keyId

public keyId: pulumi.Output<string>;

The identifier of the API key resource.

property keyType

public keyType: pulumi.Output<string>;

The type of the API key resource. Currently, the valid key type is API_KEY.

property name

public name: pulumi.Output<string>;

The name of a usage plan key.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

property usagePlanId

public usagePlanId: pulumi.Output<string>;

The Id of the usage plan resource representing to associate the key to.

property value

public value: pulumi.Output<string>;

The value of a usage plan key.

Provides an API Gateway VPC Link.

constructor

new VpcLink(name: string, args: VpcLinkArgs, opts?: pulumi.CustomResourceOptions)

Create a VpcLink resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: VpcLinkState): VpcLink

Get an existing VpcLink resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property description

public description: pulumi.Output<string | undefined>;

The description of the VPC link.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property name

public name: pulumi.Output<string>;

The name used to label and identify the VPC link.

property targetArn

public targetArn: pulumi.Output<string>;

The list of network load balancer arns in the VPC targeted by the VPC link. Currently AWS only supports 1 target.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

function getResource

getResource(args: GetResourceArgs, opts?: pulumi.InvokeOptions): Promise<GetResourceResult>

Use this data source to get the id of a Resource in API Gateway. To fetch the Resource, you must provide the REST API id as well as the full path.

function getRestApi

getRestApi(args: GetRestApiArgs, opts?: pulumi.InvokeOptions): Promise<GetRestApiResult>

Use this data source to get the id and root_resource_id of a REST API in API Gateway. To fetch the REST API you must provide a name to match against. As there is no unique name constraint on REST APIs this data source will error if there is more than one match.

interface AccountArgs

The set of arguments for constructing a Account resource.

property cloudwatchRoleArn

cloudwatchRoleArn?: pulumi.Input<string>;

The ARN of an IAM role for CloudWatch (to allow logging & monitoring). See more in AWS Docs. Logging & monitoring can be enabled/disabled and otherwise tuned on the API Gateway Stage level.

interface AccountState

Input properties used for looking up and filtering Account resources.

property cloudwatchRoleArn

cloudwatchRoleArn?: pulumi.Input<string>;

The ARN of an IAM role for CloudWatch (to allow logging & monitoring). See more in AWS Docs. Logging & monitoring can be enabled/disabled and otherwise tuned on the API Gateway Stage level.

property throttleSettings

throttleSettings?: pulumi.Input<{ ... }>;

Account-Level throttle settings. See exported fields below.

interface ApiKeyArgs

The set of arguments for constructing a ApiKey resource.

property description

description?: pulumi.Input<string>;

The API key description. Defaults to “Managed by Terraform”.

property enabled

enabled?: pulumi.Input<boolean>;

Specifies whether the API key can be used by callers. Defaults to true.

property name

name?: pulumi.Input<string>;

The name of the API key

property stageKeys

stageKeys?: pulumi.Input<pulumi.Input<{ ... }>[]>;

A list of stage keys associated with the API key - see below

property value

value?: pulumi.Input<string>;

The value of the API key. If not specified, it will be automatically generated by AWS on creation.

interface ApiKeyState

Input properties used for looking up and filtering ApiKey resources.

property createdDate

createdDate?: pulumi.Input<string>;

The creation date of the API key

property description

description?: pulumi.Input<string>;

The API key description. Defaults to “Managed by Terraform”.

property enabled

enabled?: pulumi.Input<boolean>;

Specifies whether the API key can be used by callers. Defaults to true.

property lastUpdatedDate

lastUpdatedDate?: pulumi.Input<string>;

The last update date of the API key

property name

name?: pulumi.Input<string>;

The name of the API key

property stageKeys

stageKeys?: pulumi.Input<pulumi.Input<{ ... }>[]>;

A list of stage keys associated with the API key - see below

property value

value?: pulumi.Input<string>;

The value of the API key. If not specified, it will be automatically generated by AWS on creation.

interface AuthorizerArgs

The set of arguments for constructing a Authorizer resource.

property authorizerCredentials

authorizerCredentials?: pulumi.Input<string>;

The credentials required for the authorizer. To specify an IAM Role for API Gateway to assume, use the IAM Role ARN.

property authorizerResultTtlInSeconds

authorizerResultTtlInSeconds?: pulumi.Input<number>;

The TTL of cached authorizer results in seconds. Defaults to 300.

property authorizerUri

authorizerUri?: pulumi.Input<string>;

The authorizer’s Uniform Resource Identifier (URI). This must be a well-formed Lambda function URI in the form of arn:aws:apigateway:{region}:lambda:path/{service_api}, e.g. arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:012345678912:function:my-function/invocations

property identitySource

identitySource?: pulumi.Input<string>;

The source of the identity in an incoming request. Defaults to method.request.header.Authorization. For REQUEST type, this may be a comma-separated list of values, including headers, query string parameters and stage variables - e.g. "method.request.header.SomeHeaderName,method.request.querystring.SomeQueryStringName,stageVariables.SomeStageVariableName"

property identityValidationExpression

identityValidationExpression?: pulumi.Input<string>;

A validation expression for the incoming identity. For TOKEN type, this value should be a regular expression. The incoming token from the client is matched against this expression, and will proceed if the token matches. If the token doesn’t match, the client receives a 401 Unauthorized response.

property name

name?: pulumi.Input<string>;

The name of the authorizer

property providerArns

providerArns?: pulumi.Input<pulumi.Input<string>[]>;

A list of the Amazon Cognito user pool ARNs. Each element is of this format: arn:aws:cognito-idp:{region}:{account_id}:userpool/{user_pool_id}.

property restApi

restApi: pulumi.Input<RestApi>;

The ID of the associated REST API

property type

type?: pulumi.Input<string>;

The type of the authorizer. Possible values are TOKEN for a Lambda function using a single authorization token submitted in a custom header, REQUEST for a Lambda function using incoming request parameters, or COGNITO_USER_POOLS for using an Amazon Cognito user pool. Defaults to TOKEN.

interface AuthorizerState

Input properties used for looking up and filtering Authorizer resources.

property authorizerCredentials

authorizerCredentials?: pulumi.Input<string>;

The credentials required for the authorizer. To specify an IAM Role for API Gateway to assume, use the IAM Role ARN.

property authorizerResultTtlInSeconds

authorizerResultTtlInSeconds?: pulumi.Input<number>;

The TTL of cached authorizer results in seconds. Defaults to 300.

property authorizerUri

authorizerUri?: pulumi.Input<string>;

The authorizer’s Uniform Resource Identifier (URI). This must be a well-formed Lambda function URI in the form of arn:aws:apigateway:{region}:lambda:path/{service_api}, e.g. arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:012345678912:function:my-function/invocations

property identitySource

identitySource?: pulumi.Input<string>;

The source of the identity in an incoming request. Defaults to method.request.header.Authorization. For REQUEST type, this may be a comma-separated list of values, including headers, query string parameters and stage variables - e.g. "method.request.header.SomeHeaderName,method.request.querystring.SomeQueryStringName,stageVariables.SomeStageVariableName"

property identityValidationExpression

identityValidationExpression?: pulumi.Input<string>;

A validation expression for the incoming identity. For TOKEN type, this value should be a regular expression. The incoming token from the client is matched against this expression, and will proceed if the token matches. If the token doesn’t match, the client receives a 401 Unauthorized response.

property name

name?: pulumi.Input<string>;

The name of the authorizer

property providerArns

providerArns?: pulumi.Input<pulumi.Input<string>[]>;

A list of the Amazon Cognito user pool ARNs. Each element is of this format: arn:aws:cognito-idp:{region}:{account_id}:userpool/{user_pool_id}.

property restApi

restApi?: pulumi.Input<RestApi>;

The ID of the associated REST API

property type

type?: pulumi.Input<string>;

The type of the authorizer. Possible values are TOKEN for a Lambda function using a single authorization token submitted in a custom header, REQUEST for a Lambda function using incoming request parameters, or COGNITO_USER_POOLS for using an Amazon Cognito user pool. Defaults to TOKEN.

interface BasePathMappingArgs

The set of arguments for constructing a BasePathMapping resource.

property basePath

basePath?: pulumi.Input<string>;

Path segment that must be prepended to the path when accessing the API via this mapping. If omitted, the API is exposed at the root of the given domain.

property domainName

domainName: pulumi.Input<string>;

The already-registered domain name to connect the API to.

property restApi

restApi: pulumi.Input<RestApi>;

The id of the API to connect.

property stageName

stageName?: pulumi.Input<string>;

The name of a specific deployment stage to expose at the given path. If omitted, callers may select any stage by including its name as a path element after the base path.

interface BasePathMappingState

Input properties used for looking up and filtering BasePathMapping resources.

property basePath

basePath?: pulumi.Input<string>;

Path segment that must be prepended to the path when accessing the API via this mapping. If omitted, the API is exposed at the root of the given domain.

property domainName

domainName?: pulumi.Input<string>;

The already-registered domain name to connect the API to.

property restApi

restApi?: pulumi.Input<RestApi>;

The id of the API to connect.

property stageName

stageName?: pulumi.Input<string>;

The name of a specific deployment stage to expose at the given path. If omitted, callers may select any stage by including its name as a path element after the base path.

interface ClientCertificateArgs

The set of arguments for constructing a ClientCertificate resource.

property description

description?: pulumi.Input<string>;

The description of the client certificate.

interface ClientCertificateState

Input properties used for looking up and filtering ClientCertificate resources.

property createdDate

createdDate?: pulumi.Input<string>;

The date when the client certificate was created.

property description

description?: pulumi.Input<string>;

The description of the client certificate.

property expirationDate

expirationDate?: pulumi.Input<string>;

The date when the client certificate will expire.

property pemEncodedCertificate

pemEncodedCertificate?: pulumi.Input<string>;

The PEM-encoded public key of the client certificate.

interface DeploymentArgs

The set of arguments for constructing a Deployment resource.

property description

description?: pulumi.Input<string>;

The description of the deployment

property restApi

restApi: pulumi.Input<RestApi>;

The ID of the associated REST API

property stageDescription

stageDescription?: pulumi.Input<string>;

The description of the stage

property stageName

stageName: pulumi.Input<string>;

The name of the stage. If the specified stage already exists, it will be updated to point to the new deployment. If the stage does not exist, a new one will be created and point to this deployment. Use "" to point at the default stage.

property variables

variables?: pulumi.Input<{ ... }>;

A map that defines variables for the stage

interface DeploymentState

Input properties used for looking up and filtering Deployment resources.

property createdDate

createdDate?: pulumi.Input<string>;

The creation date of the deployment

property description

description?: pulumi.Input<string>;

The description of the deployment

property executionArn

executionArn?: pulumi.Input<string>;

The execution ARN to be used in lambda_permission’s source_arn when allowing API Gateway to invoke a Lambda function, e.g. arn:aws:execute-api:eu-west-2:123456789012:z4675bid1j/prod

property invokeUrl

invokeUrl?: pulumi.Input<string>;

The URL to invoke the API pointing to the stage, e.g. https://z4675bid1j.execute-api.eu-west-2.amazonaws.com/prod

property restApi

restApi?: pulumi.Input<RestApi>;

The ID of the associated REST API

property stageDescription

stageDescription?: pulumi.Input<string>;

The description of the stage

property stageName

stageName?: pulumi.Input<string>;

The name of the stage. If the specified stage already exists, it will be updated to point to the new deployment. If the stage does not exist, a new one will be created and point to this deployment. Use "" to point at the default stage.

property variables

variables?: pulumi.Input<{ ... }>;

A map that defines variables for the stage

interface DocumentationPartArgs

The set of arguments for constructing a DocumentationPart resource.

property location

location: pulumi.Input<{ ... }>;

The location of the targeted API entity of the to-be-created documentation part. See below.

property properties

properties: pulumi.Input<string>;

A content map of API-specific key-value pairs describing the targeted API entity. The map must be encoded as a JSON string, e.g., “{ "description": "The API does …" }”. Only Swagger-compliant key-value pairs can be exported and, hence, published.

property restApiId

restApiId: pulumi.Input<string>;

The ID of the associated Rest API

interface DocumentationPartState

Input properties used for looking up and filtering DocumentationPart resources.

property location

location?: pulumi.Input<{ ... }>;

The location of the targeted API entity of the to-be-created documentation part. See below.

property properties

properties?: pulumi.Input<string>;

A content map of API-specific key-value pairs describing the targeted API entity. The map must be encoded as a JSON string, e.g., “{ "description": "The API does …" }”. Only Swagger-compliant key-value pairs can be exported and, hence, published.

property restApiId

restApiId?: pulumi.Input<string>;

The ID of the associated Rest API

interface DocumentationVersionArgs

The set of arguments for constructing a DocumentationVersion resource.

property description

description?: pulumi.Input<string>;

The description of the API documentation version.

property restApiId

restApiId: pulumi.Input<string>;

The ID of the associated Rest API

property version

version: pulumi.Input<string>;

The version identifier of the API documentation snapshot.

interface DocumentationVersionState

Input properties used for looking up and filtering DocumentationVersion resources.

property description

description?: pulumi.Input<string>;

The description of the API documentation version.

property restApiId

restApiId?: pulumi.Input<string>;

The ID of the associated Rest API

property version

version?: pulumi.Input<string>;

The version identifier of the API documentation snapshot.

interface DomainNameArgs

The set of arguments for constructing a DomainName resource.

property certificateArn

certificateArn?: pulumi.Input<string>;

The ARN for an AWS-managed certificate. Used when an edge-optimized domain name is desired. Conflicts with certificate_name, certificate_body, certificate_chain, certificate_private_key, regional_certificate_arn, and regional_certificate_name.

property certificateBody

certificateBody?: pulumi.Input<string>;

The certificate issued for the domain name being registered, in PEM format. Only valid for EDGE endpoint configuration type. Conflicts with certificate_arn, regional_certificate_arn, and regional_certificate_name.

property certificateChain

certificateChain?: pulumi.Input<string>;

The certificate for the CA that issued the certificate, along with any intermediate CA certificates required to create an unbroken chain to a certificate trusted by the intended API clients. Only valid for EDGE endpoint configuration type. Conflicts with certificate_arn, regional_certificate_arn, and regional_certificate_name.

property certificateName

certificateName?: pulumi.Input<string>;

The unique name to use when registering this certificate as an IAM server certificate. Conflicts with certificate_arn, regional_certificate_arn, and regional_certificate_name. Required if certificate_arn is not set.

property certificatePrivateKey

certificatePrivateKey?: pulumi.Input<string>;

The private key associated with the domain certificate given in certificate_body. Only valid for EDGE endpoint configuration type. Conflicts with certificate_arn, regional_certificate_arn, and regional_certificate_name.

property domainName

domainName: pulumi.Input<string>;

The fully-qualified domain name to register

property endpointConfiguration

endpointConfiguration?: pulumi.Input<{ ... }>;

Nested argument defining API endpoint configuration including endpoint type. Defined below.

property regionalCertificateArn

regionalCertificateArn?: pulumi.Input<string>;

The ARN for an AWS-managed certificate. Used when a regional domain name is desired. Conflicts with certificate_arn, certificate_name, certificate_body, certificate_chain, and certificate_private_key.

property regionalCertificateName

regionalCertificateName?: pulumi.Input<string>;

The user-friendly name of the certificate that will be used by regional endpoint for this domain name. Conflicts with certificate_arn, certificate_name, certificate_body, certificate_chain, and certificate_private_key.

interface DomainNameState

Input properties used for looking up and filtering DomainName resources.

property certificateArn

certificateArn?: pulumi.Input<string>;

The ARN for an AWS-managed certificate. Used when an edge-optimized domain name is desired. Conflicts with certificate_name, certificate_body, certificate_chain, certificate_private_key, regional_certificate_arn, and regional_certificate_name.

property certificateBody

certificateBody?: pulumi.Input<string>;

The certificate issued for the domain name being registered, in PEM format. Only valid for EDGE endpoint configuration type. Conflicts with certificate_arn, regional_certificate_arn, and regional_certificate_name.

property certificateChain

certificateChain?: pulumi.Input<string>;

The certificate for the CA that issued the certificate, along with any intermediate CA certificates required to create an unbroken chain to a certificate trusted by the intended API clients. Only valid for EDGE endpoint configuration type. Conflicts with certificate_arn, regional_certificate_arn, and regional_certificate_name.

property certificateName

certificateName?: pulumi.Input<string>;

The unique name to use when registering this certificate as an IAM server certificate. Conflicts with certificate_arn, regional_certificate_arn, and regional_certificate_name. Required if certificate_arn is not set.

property certificatePrivateKey

certificatePrivateKey?: pulumi.Input<string>;

The private key associated with the domain certificate given in certificate_body. Only valid for EDGE endpoint configuration type. Conflicts with certificate_arn, regional_certificate_arn, and regional_certificate_name.

property certificateUploadDate

certificateUploadDate?: pulumi.Input<string>;

The upload date associated with the domain certificate.

property cloudfrontDomainName

cloudfrontDomainName?: pulumi.Input<string>;

The hostname created by Cloudfront to represent the distribution that implements this domain name mapping.

property cloudfrontZoneId

cloudfrontZoneId?: pulumi.Input<string>;

For convenience, the hosted zone ID (Z2FDTNDATAQYW2) that can be used to create a Route53 alias record for the distribution.

property domainName

domainName?: pulumi.Input<string>;

The fully-qualified domain name to register

property endpointConfiguration

endpointConfiguration?: pulumi.Input<{ ... }>;

Nested argument defining API endpoint configuration including endpoint type. Defined below.

property regionalCertificateArn

regionalCertificateArn?: pulumi.Input<string>;

The ARN for an AWS-managed certificate. Used when a regional domain name is desired. Conflicts with certificate_arn, certificate_name, certificate_body, certificate_chain, and certificate_private_key.

property regionalCertificateName

regionalCertificateName?: pulumi.Input<string>;

The user-friendly name of the certificate that will be used by regional endpoint for this domain name. Conflicts with certificate_arn, certificate_name, certificate_body, certificate_chain, and certificate_private_key.

property regionalDomainName

regionalDomainName?: pulumi.Input<string>;

The hostname for the custom domain’s regional endpoint.

property regionalZoneId

regionalZoneId?: pulumi.Input<string>;

The hosted zone ID that can be used to create a Route53 alias record for the regional endpoint.

interface GetResourceArgs

A collection of arguments for invoking getResource.

property path

path: string;

The full path of the resource. If no path is found, an error will be returned.

property restApiId

restApiId: string;

The REST API id that owns the resource. If no REST API is found, an error will be returned.

interface GetResourceResult

A collection of values returned by getResource.

property id

id: string;

id is the provider-assigned unique ID for this managed resource.

property parentId

parentId: string;

Set to the ID of the parent Resource.

property pathPart

pathPart: string;

Set to the path relative to the parent Resource.

interface GetRestApiArgs

A collection of arguments for invoking getRestApi.

property name

name: string;

The name of the REST API to look up. If no REST API is found with this name, an error will be returned. If multiple REST APIs are found with this name, an error will be returned.

interface GetRestApiResult

A collection of values returned by getRestApi.

property id

id: string;

id is the provider-assigned unique ID for this managed resource.

property rootResourceId

rootResourceId: string;

Set to the ID of the API Gateway Resource on the found REST API where the route matches ‘/’.

interface IntegrationArgs

The set of arguments for constructing a Integration resource.

property cacheKeyParameters

cacheKeyParameters?: pulumi.Input<pulumi.Input<string>[]>;

A list of cache key parameters for the integration.

property cacheNamespace

cacheNamespace?: pulumi.Input<string>;

The integration’s cache namespace.

property connectionId

connectionId?: pulumi.Input<string>;

The id of the VpcLink used for the integration. Required if connection_type is VPC_LINK

property connectionType

connectionType?: pulumi.Input<string>;

The integration input’s connectionType. Valid values are INTERNET (default for connections through the public routable internet), and VPC_LINK (for private connections between API Gateway and a network load balancer in a VPC).

property contentHandling

contentHandling?: pulumi.Input<string>;

Specifies how to handle request payload content type conversions. Supported values are CONVERT_TO_BINARY and CONVERT_TO_TEXT. If this property is not defined, the request payload will be passed through from the method request to integration request without modification, provided that the passthroughBehaviors is configured to support payload pass-through.

property credentials

credentials?: pulumi.Input<string>;

The credentials required for the integration. For AWS integrations, 2 options are available. To specify an IAM Role for Amazon API Gateway to assume, use the role’s ARN. To require that the caller’s identity be passed through from the request, specify the string arn:aws:iam::\*:user/\*.

property httpMethod

httpMethod: pulumi.Input<string>;

The HTTP method (GET, POST, PUT, DELETE, HEAD, OPTION, ANY) when calling the associated resource.

property integrationHttpMethod

integrationHttpMethod?: pulumi.Input<string>;

The integration HTTP method (GET, POST, PUT, DELETE, HEAD, OPTION) specifying how API Gateway will interact with the back end. Required if type is AWS, AWS_PROXY, HTTP or HTTP_PROXY. Not all methods are compatible with all AWS integrations. e.g. Lambda function can only be invoked via POST.

property passthroughBehavior

passthroughBehavior?: pulumi.Input<string>;

The integration passthrough behavior (WHEN_NO_MATCH, WHEN_NO_TEMPLATES, NEVER). Required if request_templates is used.

property requestParameters

requestParameters?: pulumi.Input<{ ... }>;

A map of request query string parameters and headers that should be passed to the backend responder. For example: request_parameters = { "integration.request.header.X-Some-Other-Header" = "method.request.header.X-Some-Header" }

property requestParametersInJson

requestParametersInJson?: pulumi.Input<string>;

Deprecated, use request_parameters instead.

property requestTemplates

requestTemplates?: pulumi.Input<{ ... }>;

A map of the integration’s request templates.

property resourceId

resourceId: pulumi.Input<string>;

The API resource ID.

property restApi

restApi: pulumi.Input<RestApi>;

The ID of the associated REST API.

property timeoutMilliseconds

timeoutMilliseconds?: pulumi.Input<number>;

Custom timeout between 50 and 29,000 milliseconds. The default value is 29,000 milliseconds.

property type

type: pulumi.Input<string>;

The integration input’s type. Valid values are HTTP (for HTTP backends), MOCK (not calling any real backend), AWS (for AWS services), AWS_PROXY (for Lambda proxy integration) and HTTP_PROXY (for HTTP proxy integration). An HTTP or HTTP_PROXY integration with a connection_type of VPC_LINK is referred to as a private integration and uses a VpcLink to connect API Gateway to a network load balancer of a VPC.

property uri

uri?: pulumi.Input<string>;

The input’s URI (HTTP, AWS). Required if type is HTTP or AWS. For HTTP integrations, the URI must be a fully formed, encoded HTTP(S) URL according to the RFC-3986 specification . For AWS integrations, the URI should be of the form arn:aws:apigateway:{region}:{subdomain.service|service}:{path|action}/{service_api}. region, subdomain and service are used to determine the right endpoint. e.g. arn:aws:apigateway:eu-west-1:lambda:path/2015-03-31/functions/arn:aws:lambda:eu-west-1:012345678901:function:my-func/invocations

interface IntegrationResponseArgs

The set of arguments for constructing a IntegrationResponse resource.

property contentHandling

contentHandling?: pulumi.Input<string>;

Specifies how to handle request payload content type conversions. Supported values are CONVERT_TO_BINARY and CONVERT_TO_TEXT. If this property is not defined, the response payload will be passed through from the integration response to the method response without modification.

property httpMethod

httpMethod: pulumi.Input<string>;

The HTTP method (GET, POST, PUT, DELETE, HEAD, OPTIONS, ANY)

property resourceId

resourceId: pulumi.Input<string>;

The API resource ID

property responseParameters

responseParameters?: pulumi.Input<{ ... }>;

A map of response parameters that can be read from the backend response. For example: response_parameters = { "method.response.header.X-Some-Header" = "integration.response.header.X-Some-Other-Header" },

property responseParametersInJson

responseParametersInJson?: pulumi.Input<string>;

Deprecated, use response_parameters instead.

property responseTemplates

responseTemplates?: pulumi.Input<{ ... }>;

A map specifying the templates used to transform the integration response body

property restApi

restApi: pulumi.Input<RestApi>;

The ID of the associated REST API

property selectionPattern

selectionPattern?: pulumi.Input<string>;

Specifies the regular expression pattern used to choose an integration response based on the response from the backend. Setting this to - makes the integration the default one. If the backend is an AWS Lambda function, the AWS Lambda function error header is matched. For all other HTTP and AWS backends, the HTTP status code is matched.

property statusCode

statusCode: pulumi.Input<string>;

The HTTP status code

interface IntegrationResponseState

Input properties used for looking up and filtering IntegrationResponse resources.

property contentHandling

contentHandling?: pulumi.Input<string>;

Specifies how to handle request payload content type conversions. Supported values are CONVERT_TO_BINARY and CONVERT_TO_TEXT. If this property is not defined, the response payload will be passed through from the integration response to the method response without modification.

property httpMethod

httpMethod?: pulumi.Input<string>;

The HTTP method (GET, POST, PUT, DELETE, HEAD, OPTIONS, ANY)

property resourceId

resourceId?: pulumi.Input<string>;

The API resource ID

property responseParameters

responseParameters?: pulumi.Input<{ ... }>;

A map of response parameters that can be read from the backend response. For example: response_parameters = { "method.response.header.X-Some-Header" = "integration.response.header.X-Some-Other-Header" },

property responseParametersInJson

responseParametersInJson?: pulumi.Input<string>;

Deprecated, use response_parameters instead.

property responseTemplates

responseTemplates?: pulumi.Input<{ ... }>;

A map specifying the templates used to transform the integration response body

property restApi

restApi?: pulumi.Input<RestApi>;

The ID of the associated REST API

property selectionPattern

selectionPattern?: pulumi.Input<string>;

Specifies the regular expression pattern used to choose an integration response based on the response from the backend. Setting this to - makes the integration the default one. If the backend is an AWS Lambda function, the AWS Lambda function error header is matched. For all other HTTP and AWS backends, the HTTP status code is matched.

property statusCode

statusCode?: pulumi.Input<string>;

The HTTP status code

interface IntegrationState

Input properties used for looking up and filtering Integration resources.

property cacheKeyParameters

cacheKeyParameters?: pulumi.Input<pulumi.Input<string>[]>;

A list of cache key parameters for the integration.

property cacheNamespace

cacheNamespace?: pulumi.Input<string>;

The integration’s cache namespace.

property connectionId

connectionId?: pulumi.Input<string>;

The id of the VpcLink used for the integration. Required if connection_type is VPC_LINK

property connectionType

connectionType?: pulumi.Input<string>;

The integration input’s connectionType. Valid values are INTERNET (default for connections through the public routable internet), and VPC_LINK (for private connections between API Gateway and a network load balancer in a VPC).

property contentHandling

contentHandling?: pulumi.Input<string>;

Specifies how to handle request payload content type conversions. Supported values are CONVERT_TO_BINARY and CONVERT_TO_TEXT. If this property is not defined, the request payload will be passed through from the method request to integration request without modification, provided that the passthroughBehaviors is configured to support payload pass-through.

property credentials

credentials?: pulumi.Input<string>;

The credentials required for the integration. For AWS integrations, 2 options are available. To specify an IAM Role for Amazon API Gateway to assume, use the role’s ARN. To require that the caller’s identity be passed through from the request, specify the string arn:aws:iam::\*:user/\*.

property httpMethod

httpMethod?: pulumi.Input<string>;

The HTTP method (GET, POST, PUT, DELETE, HEAD, OPTION, ANY) when calling the associated resource.

property integrationHttpMethod

integrationHttpMethod?: pulumi.Input<string>;

The integration HTTP method (GET, POST, PUT, DELETE, HEAD, OPTION) specifying how API Gateway will interact with the back end. Required if type is AWS, AWS_PROXY, HTTP or HTTP_PROXY. Not all methods are compatible with all AWS integrations. e.g. Lambda function can only be invoked via POST.

property passthroughBehavior

passthroughBehavior?: pulumi.Input<string>;

The integration passthrough behavior (WHEN_NO_MATCH, WHEN_NO_TEMPLATES, NEVER). Required if request_templates is used.

property requestParameters

requestParameters?: pulumi.Input<{ ... }>;

A map of request query string parameters and headers that should be passed to the backend responder. For example: request_parameters = { "integration.request.header.X-Some-Other-Header" = "method.request.header.X-Some-Header" }

property requestParametersInJson

requestParametersInJson?: pulumi.Input<string>;

Deprecated, use request_parameters instead.

property requestTemplates

requestTemplates?: pulumi.Input<{ ... }>;

A map of the integration’s request templates.

property resourceId

resourceId?: pulumi.Input<string>;

The API resource ID.

property restApi

restApi?: pulumi.Input<RestApi>;

The ID of the associated REST API.

property timeoutMilliseconds

timeoutMilliseconds?: pulumi.Input<number>;

Custom timeout between 50 and 29,000 milliseconds. The default value is 29,000 milliseconds.

property type

type?: pulumi.Input<string>;

The integration input’s type. Valid values are HTTP (for HTTP backends), MOCK (not calling any real backend), AWS (for AWS services), AWS_PROXY (for Lambda proxy integration) and HTTP_PROXY (for HTTP proxy integration). An HTTP or HTTP_PROXY integration with a connection_type of VPC_LINK is referred to as a private integration and uses a VpcLink to connect API Gateway to a network load balancer of a VPC.

property uri

uri?: pulumi.Input<string>;

The input’s URI (HTTP, AWS). Required if type is HTTP or AWS. For HTTP integrations, the URI must be a fully formed, encoded HTTP(S) URL according to the RFC-3986 specification . For AWS integrations, the URI should be of the form arn:aws:apigateway:{region}:{subdomain.service|service}:{path|action}/{service_api}. region, subdomain and service are used to determine the right endpoint. e.g. arn:aws:apigateway:eu-west-1:lambda:path/2015-03-31/functions/arn:aws:lambda:eu-west-1:012345678901:function:my-func/invocations

interface MethodArgs

The set of arguments for constructing a Method resource.

property apiKeyRequired

apiKeyRequired?: pulumi.Input<boolean>;

Specify if the method requires an API key

property authorization

authorization: pulumi.Input<string>;

The type of authorization used for the method (NONE, CUSTOM, AWS_IAM, COGNITO_USER_POOLS)

property authorizationScopes

authorizationScopes?: pulumi.Input<pulumi.Input<string>[]>;

The authorization scopes used when the authorization is COGNITO_USER_POOLS

property authorizerId

authorizerId?: pulumi.Input<string>;

The authorizer id to be used when the authorization is CUSTOM or COGNITO_USER_POOLS

property httpMethod

httpMethod: pulumi.Input<string>;

The HTTP Method (GET, POST, PUT, DELETE, HEAD, OPTIONS, ANY)

property requestModels

requestModels?: pulumi.Input<{ ... }>;

A map of the API models used for the request’s content type where key is the content type (e.g. application/json) and value is either Error, Empty (built-in models) or aws_api_gateway_model’s name.

property requestParameters

requestParameters?: pulumi.Input<{ ... }>;

A map of request query string parameters and headers that should be passed to the integration. For example:

request_parameters = {
"method.request.header.X-Some-Header" = true,
"method.request.querystring.some-query-param"  = true,
}

would define that the header X-Some-Header and the query string some-query-param must be provided on the request, or

property requestParametersInJson

requestParametersInJson?: pulumi.Input<string>;

Deprecated, use request_parameters instead.

property requestValidatorId

requestValidatorId?: pulumi.Input<string>;

The ID of a aws_api_gateway_request_validator

property resourceId

resourceId: pulumi.Input<string>;

The API resource ID

property restApi

restApi: pulumi.Input<RestApi>;

The ID of the associated REST API

interface MethodResponseArgs

The set of arguments for constructing a MethodResponse resource.

property httpMethod

httpMethod: pulumi.Input<string>;

The HTTP Method (GET, POST, PUT, DELETE, HEAD, OPTIONS, ANY)

property resourceId

resourceId: pulumi.Input<string>;

The API resource ID

property responseModels

responseModels?: pulumi.Input<{ ... }>;

A map of the API models used for the response’s content type

property responseParameters

responseParameters?: pulumi.Input<{ ... }>;

A map of response parameters that can be sent to the caller. For example: response_parameters = { "method.response.header.X-Some-Header" = true } would define that the header X-Some-Header can be provided on the response.

property responseParametersInJson

responseParametersInJson?: pulumi.Input<string>;

Deprecated, use response_parameters instead.

property restApi

restApi: pulumi.Input<RestApi>;

The ID of the associated REST API

property statusCode

statusCode: pulumi.Input<string>;

The HTTP status code

interface MethodResponseState

Input properties used for looking up and filtering MethodResponse resources.

property httpMethod

httpMethod?: pulumi.Input<string>;

The HTTP Method (GET, POST, PUT, DELETE, HEAD, OPTIONS, ANY)

property resourceId

resourceId?: pulumi.Input<string>;

The API resource ID

property responseModels

responseModels?: pulumi.Input<{ ... }>;

A map of the API models used for the response’s content type

property responseParameters

responseParameters?: pulumi.Input<{ ... }>;

A map of response parameters that can be sent to the caller. For example: response_parameters = { "method.response.header.X-Some-Header" = true } would define that the header X-Some-Header can be provided on the response.

property responseParametersInJson

responseParametersInJson?: pulumi.Input<string>;

Deprecated, use response_parameters instead.

property restApi

restApi?: pulumi.Input<RestApi>;

The ID of the associated REST API

property statusCode

statusCode?: pulumi.Input<string>;

The HTTP status code

interface MethodSettingsArgs

The set of arguments for constructing a MethodSettings resource.

property methodPath

methodPath: pulumi.Input<string>;

Method path defined as {resource_path}/{http_method} for an individual method override, or *&#47;* for overriding all methods in the stage.

property restApi

restApi: pulumi.Input<RestApi>;

The ID of the REST API

property settings

settings: pulumi.Input<{ ... }>;

The settings block, see below.

property stageName

stageName: pulumi.Input<string>;

The name of the stage

interface MethodSettingsState

Input properties used for looking up and filtering MethodSettings resources.

property methodPath

methodPath?: pulumi.Input<string>;

Method path defined as {resource_path}/{http_method} for an individual method override, or *&#47;* for overriding all methods in the stage.

property restApi

restApi?: pulumi.Input<RestApi>;

The ID of the REST API

property settings

settings?: pulumi.Input<{ ... }>;

The settings block, see below.

property stageName

stageName?: pulumi.Input<string>;

The name of the stage

interface MethodState

Input properties used for looking up and filtering Method resources.

property apiKeyRequired

apiKeyRequired?: pulumi.Input<boolean>;

Specify if the method requires an API key

property authorization

authorization?: pulumi.Input<string>;

The type of authorization used for the method (NONE, CUSTOM, AWS_IAM, COGNITO_USER_POOLS)

property authorizationScopes

authorizationScopes?: pulumi.Input<pulumi.Input<string>[]>;

The authorization scopes used when the authorization is COGNITO_USER_POOLS

property authorizerId

authorizerId?: pulumi.Input<string>;

The authorizer id to be used when the authorization is CUSTOM or COGNITO_USER_POOLS

property httpMethod

httpMethod?: pulumi.Input<string>;

The HTTP Method (GET, POST, PUT, DELETE, HEAD, OPTIONS, ANY)

property requestModels

requestModels?: pulumi.Input<{ ... }>;

A map of the API models used for the request’s content type where key is the content type (e.g. application/json) and value is either Error, Empty (built-in models) or aws_api_gateway_model’s name.

property requestParameters

requestParameters?: pulumi.Input<{ ... }>;

A map of request query string parameters and headers that should be passed to the integration. For example:

request_parameters = {
"method.request.header.X-Some-Header" = true,
"method.request.querystring.some-query-param"  = true,
}

would define that the header X-Some-Header and the query string some-query-param must be provided on the request, or

property requestParametersInJson

requestParametersInJson?: pulumi.Input<string>;

Deprecated, use request_parameters instead.

property requestValidatorId

requestValidatorId?: pulumi.Input<string>;

The ID of a aws_api_gateway_request_validator

property resourceId

resourceId?: pulumi.Input<string>;

The API resource ID

property restApi

restApi?: pulumi.Input<RestApi>;

The ID of the associated REST API

interface ModelArgs

The set of arguments for constructing a Model resource.

property contentType

contentType: pulumi.Input<string>;

The content type of the model

property description

description?: pulumi.Input<string>;

The description of the model

property name

name?: pulumi.Input<string>;

The name of the model

property restApi

restApi: pulumi.Input<RestApi>;

The ID of the associated REST API

property schema

schema?: pulumi.Input<string>;

The schema of the model in a JSON form

interface ModelState

Input properties used for looking up and filtering Model resources.

property contentType

contentType?: pulumi.Input<string>;

The content type of the model

property description

description?: pulumi.Input<string>;

The description of the model

property name

name?: pulumi.Input<string>;

The name of the model

property restApi

restApi?: pulumi.Input<RestApi>;

The ID of the associated REST API

property schema

schema?: pulumi.Input<string>;

The schema of the model in a JSON form

interface RequestValidatorArgs

The set of arguments for constructing a RequestValidator resource.

property name

name?: pulumi.Input<string>;

The name of the request validator

property restApi

restApi: pulumi.Input<RestApi>;

The ID of the associated Rest API

property validateRequestBody

validateRequestBody?: pulumi.Input<boolean>;

Boolean whether to validate request body. Defaults to false.

property validateRequestParameters

validateRequestParameters?: pulumi.Input<boolean>;

Boolean whether to validate request parameters. Defaults to false.

interface RequestValidatorState

Input properties used for looking up and filtering RequestValidator resources.

property name

name?: pulumi.Input<string>;

The name of the request validator

property restApi

restApi?: pulumi.Input<RestApi>;

The ID of the associated Rest API

property validateRequestBody

validateRequestBody?: pulumi.Input<boolean>;

Boolean whether to validate request body. Defaults to false.

property validateRequestParameters

validateRequestParameters?: pulumi.Input<boolean>;

Boolean whether to validate request parameters. Defaults to false.

interface ResourceArgs

The set of arguments for constructing a Resource resource.

property parentId

parentId: pulumi.Input<string>;

The ID of the parent API resource

property pathPart

pathPart: pulumi.Input<string>;

The last path segment of this API resource.

property restApi

restApi: pulumi.Input<RestApi>;

The ID of the associated REST API

interface ResourceState

Input properties used for looking up and filtering Resource resources.

property parentId

parentId?: pulumi.Input<string>;

The ID of the parent API resource

property path

path?: pulumi.Input<string>;

The complete path for this API resource, including all parent paths.

property pathPart

pathPart?: pulumi.Input<string>;

The last path segment of this API resource.

property restApi

restApi?: pulumi.Input<RestApi>;

The ID of the associated REST API

interface ResponseArgs

The set of arguments for constructing a Response resource.

property responseParameters

responseParameters?: pulumi.Input<{ ... }>;

A map specifying the templates used to transform the response body.

property responseTemplates

responseTemplates?: pulumi.Input<{ ... }>;

A map specifying the parameters (paths, query strings and headers) of the Gateway Response.

property responseType

responseType: pulumi.Input<string>;

The response type of the associated GatewayResponse.

property restApiId

restApiId: pulumi.Input<string>;

The string identifier of the associated REST API.

property statusCode

statusCode?: pulumi.Input<string>;

The HTTP status code of the Gateway Response.

interface ResponseState

Input properties used for looking up and filtering Response resources.

property responseParameters

responseParameters?: pulumi.Input<{ ... }>;

A map specifying the templates used to transform the response body.

property responseTemplates

responseTemplates?: pulumi.Input<{ ... }>;

A map specifying the parameters (paths, query strings and headers) of the Gateway Response.

property responseType

responseType?: pulumi.Input<string>;

The response type of the associated GatewayResponse.

property restApiId

restApiId?: pulumi.Input<string>;

The string identifier of the associated REST API.

property statusCode

statusCode?: pulumi.Input<string>;

The HTTP status code of the Gateway Response.

interface RestApiArgs

The set of arguments for constructing a RestApi resource.

property apiKeySource

apiKeySource?: pulumi.Input<string>;

The source of the API key for requests. Valid values are HEADER (default) and AUTHORIZER.

property binaryMediaTypes

binaryMediaTypes?: pulumi.Input<pulumi.Input<string>[]>;

The list of binary media types supported by the RestApi. By default, the RestApi supports only UTF-8-encoded text payloads.

property body

body?: pulumi.Input<string>;

An OpenAPI specification that defines the set of routes and integrations to create as part of the REST API.

property description

description?: pulumi.Input<string>;

The description of the REST API

property endpointConfiguration

endpointConfiguration?: pulumi.Input<{ ... }>;

Nested argument defining API endpoint configuration including endpoint type. Defined below.

property minimumCompressionSize

minimumCompressionSize?: pulumi.Input<number>;

Minimum response size to compress for the REST API. Integer between -1 and 10485760 (10MB). Setting a value greater than -1 will enable compression, -1 disables compression (default).

property name

name?: pulumi.Input<string>;

The name of the REST API

property policy

policy?: pulumi.Input<string>;

JSON formatted policy document that controls access to the API Gateway

interface RestApiState

Input properties used for looking up and filtering RestApi resources.

property apiKeySource

apiKeySource?: pulumi.Input<string>;

The source of the API key for requests. Valid values are HEADER (default) and AUTHORIZER.

property binaryMediaTypes

binaryMediaTypes?: pulumi.Input<pulumi.Input<string>[]>;

The list of binary media types supported by the RestApi. By default, the RestApi supports only UTF-8-encoded text payloads.

property body

body?: pulumi.Input<string>;

An OpenAPI specification that defines the set of routes and integrations to create as part of the REST API.

property createdDate

createdDate?: pulumi.Input<string>;

The creation date of the REST API

property description

description?: pulumi.Input<string>;

The description of the REST API

property endpointConfiguration

endpointConfiguration?: pulumi.Input<{ ... }>;

Nested argument defining API endpoint configuration including endpoint type. Defined below.

property executionArn

executionArn?: pulumi.Input<string>;

The execution ARN part to be used in lambda_permission’s source_arn when allowing API Gateway to invoke a Lambda function, e.g. arn:aws:execute-api:eu-west-2:123456789012:z4675bid1j, which can be concatenated with allowed stage, method and resource path.

property minimumCompressionSize

minimumCompressionSize?: pulumi.Input<number>;

Minimum response size to compress for the REST API. Integer between -1 and 10485760 (10MB). Setting a value greater than -1 will enable compression, -1 disables compression (default).

property name

name?: pulumi.Input<string>;

The name of the REST API

property policy

policy?: pulumi.Input<string>;

JSON formatted policy document that controls access to the API Gateway

property rootResourceId

rootResourceId?: pulumi.Input<string>;

The resource ID of the REST API’s root

interface StageArgs

The set of arguments for constructing a Stage resource.

property accessLogSettings

accessLogSettings?: pulumi.Input<{ ... }>;

Enables access logs for the API stage. Detailed below.

property cacheClusterEnabled

cacheClusterEnabled?: pulumi.Input<boolean>;

Specifies whether a cache cluster is enabled for the stage

property cacheClusterSize

cacheClusterSize?: pulumi.Input<string>;

The size of the cache cluster for the stage, if enabled. Allowed values include 0.5, 1.6, 6.1, 13.5, 28.4, 58.2, 118 and 237.

property clientCertificateId

clientCertificateId?: pulumi.Input<string>;

The identifier of a client certificate for the stage.

property deployment

deployment: pulumi.Input<Deployment>;

The ID of the deployment that the stage points to

property description

description?: pulumi.Input<string>;

The description of the stage

property documentationVersion

documentationVersion?: pulumi.Input<string>;

The version of the associated API documentation

property restApi

restApi: pulumi.Input<RestApi>;

The ID of the associated REST API

property stageName

stageName: pulumi.Input<string>;

The name of the stage

property tags

tags?: pulumi.Input<Tags>;

A mapping of tags to assign to the resource.

property variables

variables?: pulumi.Input<{ ... }>;

A map that defines the stage variables

property xrayTracingEnabled

xrayTracingEnabled?: pulumi.Input<boolean>;

Whether active tracing with X-ray is enabled. Defaults to false.

interface StageState

Input properties used for looking up and filtering Stage resources.

property accessLogSettings

accessLogSettings?: pulumi.Input<{ ... }>;

Enables access logs for the API stage. Detailed below.

property cacheClusterEnabled

cacheClusterEnabled?: pulumi.Input<boolean>;

Specifies whether a cache cluster is enabled for the stage

property cacheClusterSize

cacheClusterSize?: pulumi.Input<string>;

The size of the cache cluster for the stage, if enabled. Allowed values include 0.5, 1.6, 6.1, 13.5, 28.4, 58.2, 118 and 237.

property clientCertificateId

clientCertificateId?: pulumi.Input<string>;

The identifier of a client certificate for the stage.

property deployment

deployment?: pulumi.Input<Deployment>;

The ID of the deployment that the stage points to

property description

description?: pulumi.Input<string>;

The description of the stage

property documentationVersion

documentationVersion?: pulumi.Input<string>;

The version of the associated API documentation

property executionArn

executionArn?: pulumi.Input<string>;

The execution ARN to be used in lambda_permission’s source_arn when allowing API Gateway to invoke a Lambda function, e.g. arn:aws:execute-api:eu-west-2:123456789012:z4675bid1j/prod

property invokeUrl

invokeUrl?: pulumi.Input<string>;

The URL to invoke the API pointing to the stage, e.g. https://z4675bid1j.execute-api.eu-west-2.amazonaws.com/prod

property restApi

restApi?: pulumi.Input<RestApi>;

The ID of the associated REST API

property stageName

stageName?: pulumi.Input<string>;

The name of the stage

property tags

tags?: pulumi.Input<Tags>;

A mapping of tags to assign to the resource.

property variables

variables?: pulumi.Input<{ ... }>;

A map that defines the stage variables

property xrayTracingEnabled

xrayTracingEnabled?: pulumi.Input<boolean>;

Whether active tracing with X-ray is enabled. Defaults to false.

interface UsagePlanArgs

The set of arguments for constructing a UsagePlan resource.

property apiStages

apiStages?: pulumi.Input<pulumi.Input<{ ... }>[]>;

The associated API stages of the usage plan.

property description

description?: pulumi.Input<string>;

The description of a usage plan.

property name

name?: pulumi.Input<string>;

The name of the usage plan.

property productCode

productCode?: pulumi.Input<string>;

The AWS Markeplace product identifier to associate with the usage plan as a SaaS product on AWS Marketplace.

property quotaSettings

quotaSettings?: pulumi.Input<{ ... }>;

The quota settings of the usage plan.

property throttleSettings

throttleSettings?: pulumi.Input<{ ... }>;

The throttling limits of the usage plan.

interface UsagePlanKeyArgs

The set of arguments for constructing a UsagePlanKey resource.

property keyId

keyId: pulumi.Input<string>;

The identifier of the API key resource.

property keyType

keyType: pulumi.Input<string>;

The type of the API key resource. Currently, the valid key type is API_KEY.

property usagePlanId

usagePlanId: pulumi.Input<string>;

The Id of the usage plan resource representing to associate the key to.

interface UsagePlanKeyState

Input properties used for looking up and filtering UsagePlanKey resources.

property keyId

keyId?: pulumi.Input<string>;

The identifier of the API key resource.

property keyType

keyType?: pulumi.Input<string>;

The type of the API key resource. Currently, the valid key type is API_KEY.

property name

name?: pulumi.Input<string>;

The name of a usage plan key.

property usagePlanId

usagePlanId?: pulumi.Input<string>;

The Id of the usage plan resource representing to associate the key to.

property value

value?: pulumi.Input<string>;

The value of a usage plan key.

interface UsagePlanState

Input properties used for looking up and filtering UsagePlan resources.

property apiStages

apiStages?: pulumi.Input<pulumi.Input<{ ... }>[]>;

The associated API stages of the usage plan.

property description

description?: pulumi.Input<string>;

The description of a usage plan.

property name

name?: pulumi.Input<string>;

The name of the usage plan.

property productCode

productCode?: pulumi.Input<string>;

The AWS Markeplace product identifier to associate with the usage plan as a SaaS product on AWS Marketplace.

property quotaSettings

quotaSettings?: pulumi.Input<{ ... }>;

The quota settings of the usage plan.

property throttleSettings

throttleSettings?: pulumi.Input<{ ... }>;

The throttling limits of the usage plan.

interface VpcLinkArgs

The set of arguments for constructing a VpcLink resource.

property description

description?: pulumi.Input<string>;

The description of the VPC link.

property name

name?: pulumi.Input<string>;

The name used to label and identify the VPC link.

property targetArn

targetArn: pulumi.Input<string>;

The list of network load balancer arns in the VPC targeted by the VPC link. Currently AWS only supports 1 target.

interface VpcLinkState

Input properties used for looking up and filtering VpcLink resources.

property description

description?: pulumi.Input<string>;

The description of the VPC link.

property name

name?: pulumi.Input<string>;

The name used to label and identify the VPC link.

property targetArn

targetArn?: pulumi.Input<string>;

The list of network load balancer arns in the VPC targeted by the VPC link. Currently AWS only supports 1 target.