CreateApiRequest (AWS Java SDK :: Services :: ApiGatewayV2 2.15.45 API)

java.lang.Object
- software.amazon.awssdk.core.SdkRequest
- - software.amazon.awssdk.awscore.AwsRequest
  - - software.amazon.awssdk.services.apigatewayv2.model.ApiGatewayV2Request
    - - software.amazon.awssdk.services.apigatewayv2.model.CreateApiRequest

All Implemented Interfaces:: SdkPojo, ToCopyableBuilder<CreateApiRequest.Builder,CreateApiRequest>

@Generated(value="software.amazon.awssdk:codegen")
public final class CreateApiRequest
extends ApiGatewayV2Request
implements ToCopyableBuilder<CreateApiRequest.Builder,CreateApiRequest>

Creates a new Api resource to represent an API.

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static interface CreateApiRequest.Builder

Nested Classes
Modifier and Type	Class and Description
`static interface`	`CreateApiRequest.Builder`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`String`	`apiKeySelectionExpression()` An API key selection expression.
`static CreateApiRequest.Builder`	`builder()`
`Cors`	`corsConfiguration()` A CORS configuration.
`String`	`credentialsArn()` This property is part of quick create.
`String`	`description()` The description of the API.
`Boolean`	`disableExecuteApiEndpoint()` Specifies whether clients can invoke your API by using the default execute-api endpoint.
`Boolean`	`disableSchemaValidation()` Avoid validating models when creating a deployment.
`boolean`	`equals(Object obj)`
`boolean`	`equalsBySdkFields(Object obj)`
`<T> Optional<T>`	`getValueForField(String fieldName, Class<T> clazz)`
`int`	`hashCode()`
`boolean`	`hasTags()` Returns true if the Tags property was specified by the sender (it may be empty), or false if the sender did not specify the value (it will be empty).
`String`	`name()` The name of the API.
`ProtocolType`	`protocolType()` The API protocol.
`String`	`protocolTypeAsString()` The API protocol.
`String`	`routeKey()` This property is part of quick create.
`String`	`routeSelectionExpression()` The route selection expression for the API.
`List<SdkField<?>>`	`sdkFields()`
`static Class<? extends CreateApiRequest.Builder>`	`serializableBuilderClass()`
`Map<String,String>`	`tags()` The collection of tags.
`String`	`target()` This property is part of quick create.
`CreateApiRequest.Builder`	`toBuilder()`
`String`	`toString()` Returns a string representation of this object.
`String`	`version()` A version identifier for the API.

Methods inherited from class software.amazon.awssdk.awscore.AwsRequest
overrideConfiguration

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy

- Method Detail
  - apiKeySelectionExpression
```
public String apiKeySelectionExpression()
```
    An API key selection expression. Supported only for WebSocket APIs. See API Key Selection Expressions.
    
    Returns:
    
    An API key selection expression. Supported only for WebSocket APIs. See API Key Selection Expressions.
  - corsConfiguration
```
public Cors corsConfiguration()
```
    A CORS configuration. Supported only for HTTP APIs. See Configuring CORS for more information.
    
    Returns:
    
    A CORS configuration. Supported only for HTTP APIs. See Configuring CORS for more information.
  - credentialsArn
```
public String credentialsArn()
```
    This property is part of quick create. It specifies the credentials required for the integration, if any. For a Lambda integration, three options are available. To specify an IAM Role for API Gateway to assume, use the role's Amazon Resource Name (ARN). To require that the caller's identity be passed through from the request, specify arn:aws:iam::*:user/*. To use resource-based permissions on supported AWS services, specify null. Currently, this property is not used for HTTP integrations. Supported only for HTTP APIs.
    
    Returns:
    
    This property is part of quick create. It specifies the credentials required for the integration, if any. For a Lambda integration, three options are available. To specify an IAM Role for API Gateway to assume, use the role's Amazon Resource Name (ARN). To require that the caller's identity be passed through from the request, specify arn:aws:iam::*:user/*. To use resource-based permissions on supported AWS services, specify null. Currently, this property is not used for HTTP integrations. Supported only for HTTP APIs.
  - description
```
public String description()
```
    The description of the API.
    
    Returns:
    
    The description of the API.
  - disableSchemaValidation
```
public Boolean disableSchemaValidation()
```
    Avoid validating models when creating a deployment. Supported only for WebSocket APIs.
    
    Returns:
    
    Avoid validating models when creating a deployment. Supported only for WebSocket APIs.
  - disableExecuteApiEndpoint
```
public 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.
    
    Returns:
    
    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.
  - name
```
public String name()
```
    The name of the API.
    
    Returns:
    
    The name of the API.
  - protocolType
```
public ProtocolType protocolType()
```
    The API protocol.
    
    If the service returns an enum value that is not available in the current SDK version, protocolType will return ProtocolType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from protocolTypeAsString().
    
    Returns:
    
    The API protocol.
    
    See Also:
    
    ProtocolType
  - protocolTypeAsString
```
public String protocolTypeAsString()
```
    The API protocol.
    
    If the service returns an enum value that is not available in the current SDK version, protocolType will return ProtocolType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from protocolTypeAsString().
    
    Returns:
    
    The API protocol.
    
    See Also:
    
    ProtocolType
  - routeKey
```
public String routeKey()
```
    This property is part of quick create. If you don't specify a routeKey, a default route of $default is created. The $default route acts as a catch-all for any request made to your API, for a particular stage. The $default route key can't be modified. You can add routes after creating the API, and you can update the route keys of additional routes. Supported only for HTTP APIs.
    
    Returns:
    
    This property is part of quick create. If you don't specify a routeKey, a default route of $default is created. The $default route acts as a catch-all for any request made to your API, for a particular stage. The $default route key can't be modified. You can add routes after creating the API, and you can update the route keys of additional routes. Supported only for HTTP APIs.
  - routeSelectionExpression
```
public 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.
    
    Returns:
    
    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.
  - hasTags
```
public boolean hasTags()
```
    Returns true if the Tags property was specified by the sender (it may be empty), or false if the sender did not specify the value (it will be empty). For responses returned by the SDK, the sender is the AWS service.
  - tags
```
public Map<String,String> tags()
```
    The collection of tags. Each tag element is associated with a given resource.
    
    Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
    
    You can use hasTags() to see if a value was sent in this field.
    
    Returns:
    
    The collection of tags. Each tag element is associated with a given resource.
  - target
```
public String target()
```
    This property is part of quick create. Quick create produces an API with an integration, a default catch-all route, and a default stage which is configured to automatically deploy changes. For HTTP integrations, specify a fully qualified URL. For Lambda integrations, specify a function ARN. The type of the integration will be HTTP_PROXY or AWS_PROXY, respectively. Supported only for HTTP APIs.
    
    Returns:
    
    This property is part of quick create. Quick create produces an API with an integration, a default catch-all route, and a default stage which is configured to automatically deploy changes. For HTTP integrations, specify a fully qualified URL. For Lambda integrations, specify a function ARN. The type of the integration will be HTTP_PROXY or AWS_PROXY, respectively. Supported only for HTTP APIs.
  - version
```
public String version()
```
    A version identifier for the API.
    
    Returns:
    
    A version identifier for the API.
  - toBuilder
```
public CreateApiRequest.Builder toBuilder()
```
    Specified by:
    
    toBuilder in interface ToCopyableBuilder<CreateApiRequest.Builder,CreateApiRequest>
    
    Specified by:
    
    toBuilder in class ApiGatewayV2Request
  - builder
```
public static CreateApiRequest.Builder builder()
```
  - serializableBuilderClass
```
public static Class<? extends CreateApiRequest.Builder> serializableBuilderClass()
```
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class AwsRequest
  - equals
```
public boolean equals(Object obj)
```
    Overrides:
    
    equals in class AwsRequest
  - equalsBySdkFields
```
public boolean equalsBySdkFields(Object obj)
```
    Specified by:
    
    equalsBySdkFields in interface SdkPojo
  - toString
```
public String toString()
```
    Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
    
    Overrides:
    
    toString in class Object
  - getValueForField
```
public <T> Optional<T> getValueForField(String fieldName,
                                        Class<T> clazz)
```
    Overrides:
    
    getValueForField in class SdkRequest
  - sdkFields
```
public List<SdkField<?>> sdkFields()
```
    Specified by:
    
    sdkFields in interface SdkPojo

Class CreateApiRequest

Nested Class Summary

Method Summary

Methods inherited from class software.amazon.awssdk.awscore.AwsRequest

Methods inherited from class java.lang.Object

Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder

Method Detail

apiKeySelectionExpression

corsConfiguration

credentialsArn

description

disableSchemaValidation

disableExecuteApiEndpoint

name

protocolType

protocolTypeAsString

routeKey

routeSelectionExpression

hasTags

tags

target

version

toBuilder

builder

serializableBuilderClass

hashCode

equals

equalsBySdkFields

toString

getValueForField

sdkFields