Interface Api.Builder
-
- All Superinterfaces:
Buildable,CopyableBuilder<Api.Builder,Api>,SdkBuilder<Api.Builder,Api>,SdkPojo
- Enclosing class:
- Api
@Mutable @NotThreadSafe public static interface Api.Builder extends SdkPojo, CopyableBuilder<Api.Builder,Api>
-
-
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Modifier and Type Method Description Api.BuilderapiEndpoint(String apiEndpoint)The URI of the API, of the form {api-id}.execute-api.{region}.amazonaws.com.Api.BuilderapiGatewayManaged(Boolean apiGatewayManaged)Specifies whether an API is managed by API Gateway.Api.BuilderapiId(String apiId)The API ID.Api.BuilderapiKeySelectionExpression(String apiKeySelectionExpression)An API key selection expression.default Api.BuildercorsConfiguration(Consumer<Cors.Builder> corsConfiguration)A CORS configuration.Api.BuildercorsConfiguration(Cors corsConfiguration)A CORS configuration.Api.BuildercreatedDate(Instant createdDate)The timestamp when the API was created.Api.Builderdescription(String description)The description of the API.Api.BuilderdisableExecuteApiEndpoint(Boolean disableExecuteApiEndpoint)Specifies whether clients can invoke your API by using the default execute-api endpoint.Api.BuilderdisableSchemaValidation(Boolean disableSchemaValidation)Avoid validating models when creating a deployment.Api.BuilderimportInfo(String... importInfo)The validation information during API import.Api.BuilderimportInfo(Collection<String> importInfo)The validation information during API import.Api.BuilderipAddressType(String ipAddressType)The IP address types that can invoke the API.Api.BuilderipAddressType(IpAddressType ipAddressType)The IP address types that can invoke the API.Api.Buildername(String name)The name of the API.Api.BuilderprotocolType(String protocolType)The API protocol.Api.BuilderprotocolType(ProtocolType protocolType)The API protocol.Api.BuilderrouteSelectionExpression(String routeSelectionExpression)The route selection expression for the API.Api.Buildertags(Map<String,String> tags)A collection of tags associated with the API.Api.Builderversion(String version)A version identifier for the API.Api.Builderwarnings(String... warnings)The warning messages reported when failonwarnings is turned on during API import.Api.Builderwarnings(Collection<String> warnings)The warning messages reported when failonwarnings is turned on during API import.-
Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder
copy
-
Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder
applyMutation, build
-
Methods inherited from interface software.amazon.awssdk.core.SdkPojo
equalsBySdkFields, sdkFieldNameToField, sdkFields
-
-
-
-
Method Detail
-
apiEndpoint
Api.Builder apiEndpoint(String apiEndpoint)
The URI of the API, of the form {api-id}.execute-api.{region}.amazonaws.com. The stage name is typically appended to this URI to form a complete path to a deployed API stage.
- Parameters:
apiEndpoint- The URI of the API, of the form {api-id}.execute-api.{region}.amazonaws.com. The stage name is typically appended to this URI to form a complete path to a deployed API stage.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
apiGatewayManaged
Api.Builder apiGatewayManaged(Boolean apiGatewayManaged)
Specifies whether an API is managed by API Gateway. You can't update or delete a managed API by using API Gateway. A managed API can be deleted only through the tooling or service that created it.
- Parameters:
apiGatewayManaged- Specifies whether an API is managed by API Gateway. You can't update or delete a managed API by using API Gateway. A managed API can be deleted only through the tooling or service that created it.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
apiId
Api.Builder apiId(String apiId)
The API ID.
- Parameters:
apiId- The API ID.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
apiKeySelectionExpression
Api.Builder apiKeySelectionExpression(String apiKeySelectionExpression)
An API key selection expression. Supported only for WebSocket APIs. See API Key Selection Expressions.
- Parameters:
apiKeySelectionExpression- An API key selection expression. Supported only for WebSocket APIs. See API Key Selection Expressions.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
corsConfiguration
Api.Builder corsConfiguration(Cors corsConfiguration)
A CORS configuration. Supported only for HTTP APIs.
- Parameters:
corsConfiguration- A CORS configuration. Supported only for HTTP APIs.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
corsConfiguration
default Api.Builder corsConfiguration(Consumer<Cors.Builder> corsConfiguration)
A CORS configuration. Supported only for HTTP APIs.
This is a convenience method that creates an instance of theCors.Builderavoiding the need to create one manually viaCors.builder().When the
Consumercompletes,SdkBuilder.build()is called immediately and its result is passed tocorsConfiguration(Cors).- Parameters:
corsConfiguration- a consumer that will call methods onCors.Builder- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
corsConfiguration(Cors)
-
createdDate
Api.Builder createdDate(Instant createdDate)
The timestamp when the API was created.
- Parameters:
createdDate- The timestamp when the API was created.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
description
Api.Builder description(String description)
The description of the API.
- Parameters:
description- The description of the API.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
disableSchemaValidation
Api.Builder disableSchemaValidation(Boolean disableSchemaValidation)
Avoid validating models when creating a deployment. Supported only for WebSocket APIs.
- Parameters:
disableSchemaValidation- Avoid validating models when creating a deployment. Supported only for WebSocket APIs.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
disableExecuteApiEndpoint
Api.Builder disableExecuteApiEndpoint(Boolean disableExecuteApiEndpoint)
Specifies whether clients can invoke your API by using the default execute-api endpoint. By default, clients can invoke your API with the default https://{api_id}.execute-api.{region}.amazonaws.com endpoint. To require that clients use a custom domain name to invoke your API, disable the default endpoint.
- Parameters:
disableExecuteApiEndpoint- Specifies whether clients can invoke your API by using the default execute-api endpoint. By default, clients can invoke your API with the default https://{api_id}.execute-api.{region}.amazonaws.com endpoint. To require that clients use a custom domain name to invoke your API, disable the default endpoint.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
importInfo
Api.Builder importInfo(Collection<String> importInfo)
The validation information during API import. This may include particular properties of your OpenAPI definition which are ignored during import. Supported only for HTTP APIs.
- Parameters:
importInfo- The validation information during API import. This may include particular properties of your OpenAPI definition which are ignored during import. Supported only for HTTP APIs.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
importInfo
Api.Builder importInfo(String... importInfo)
The validation information during API import. This may include particular properties of your OpenAPI definition which are ignored during import. Supported only for HTTP APIs.
- Parameters:
importInfo- The validation information during API import. This may include particular properties of your OpenAPI definition which are ignored during import. Supported only for HTTP APIs.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
ipAddressType
Api.Builder ipAddressType(String ipAddressType)
The IP address types that can invoke the API.
- Parameters:
ipAddressType- The IP address types that can invoke the API.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
IpAddressType,IpAddressType
-
ipAddressType
Api.Builder ipAddressType(IpAddressType ipAddressType)
The IP address types that can invoke the API.
- Parameters:
ipAddressType- The IP address types that can invoke the API.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
IpAddressType,IpAddressType
-
name
Api.Builder name(String name)
The name of the API.
- Parameters:
name- The name of the API.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
protocolType
Api.Builder protocolType(String protocolType)
The API protocol.
- Parameters:
protocolType- The API protocol.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
ProtocolType,ProtocolType
-
protocolType
Api.Builder protocolType(ProtocolType protocolType)
The API protocol.
- Parameters:
protocolType- The API protocol.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
ProtocolType,ProtocolType
-
routeSelectionExpression
Api.Builder routeSelectionExpression(String routeSelectionExpression)
The route selection expression for the API. For HTTP APIs, the routeSelectionExpression must be ${request.method} ${request.path}. If not provided, this will be the default for HTTP APIs. This property is required for WebSocket APIs.
- Parameters:
routeSelectionExpression- The route selection expression for the API. For HTTP APIs, the routeSelectionExpression must be ${request.method} ${request.path}. If not provided, this will be the default for HTTP APIs. This property is required for WebSocket APIs.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
tags
Api.Builder tags(Map<String,String> tags)
A collection of tags associated with the API.
- Parameters:
tags- A collection of tags associated with the API.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
version
Api.Builder version(String version)
A version identifier for the API.
- Parameters:
version- A version identifier for the API.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
warnings
Api.Builder warnings(Collection<String> warnings)
The warning messages reported when failonwarnings is turned on during API import.
- Parameters:
warnings- The warning messages reported when failonwarnings is turned on during API import.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
warnings
Api.Builder warnings(String... warnings)
The warning messages reported when failonwarnings is turned on during API import.
- Parameters:
warnings- The warning messages reported when failonwarnings is turned on during API import.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-