amazonka-apigatewayv2-2.0: Amazon ApiGatewayV2 SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.ApiGatewayV2.ImportApi

Description

Imports an API.

Synopsis

Creating a Request

data ImportApi Source #

See: newImportApi smart constructor.

Constructors

ImportApi' 

Fields

  • basepath :: Maybe Text

    Specifies how to interpret the base path of the API during import. Valid values are ignore, prepend, and split. The default value is ignore. To learn more, see Set the OpenAPI basePath Property. Supported only for HTTP APIs.

  • failOnWarnings :: Maybe Bool

    Specifies whether to rollback the API creation when a warning is encountered. By default, API creation continues if a warning is encountered.

  • body :: Text

    The OpenAPI definition. Supported only for HTTP APIs.

Instances

Instances details
ToJSON ImportApi Source # 
Instance details

Defined in Amazonka.ApiGatewayV2.ImportApi

ToHeaders ImportApi Source # 
Instance details

Defined in Amazonka.ApiGatewayV2.ImportApi

Methods

toHeaders :: ImportApi -> [Header] #

ToPath ImportApi Source # 
Instance details

Defined in Amazonka.ApiGatewayV2.ImportApi

ToQuery ImportApi Source # 
Instance details

Defined in Amazonka.ApiGatewayV2.ImportApi

AWSRequest ImportApi Source # 
Instance details

Defined in Amazonka.ApiGatewayV2.ImportApi

Associated Types

type AWSResponse ImportApi #

Generic ImportApi Source # 
Instance details

Defined in Amazonka.ApiGatewayV2.ImportApi

Associated Types

type Rep ImportApi :: Type -> Type #

Read ImportApi Source # 
Instance details

Defined in Amazonka.ApiGatewayV2.ImportApi

Show ImportApi Source # 
Instance details

Defined in Amazonka.ApiGatewayV2.ImportApi

NFData ImportApi Source # 
Instance details

Defined in Amazonka.ApiGatewayV2.ImportApi

Methods

rnf :: ImportApi -> () #

Eq ImportApi Source # 
Instance details

Defined in Amazonka.ApiGatewayV2.ImportApi

Hashable ImportApi Source # 
Instance details

Defined in Amazonka.ApiGatewayV2.ImportApi

type AWSResponse ImportApi Source # 
Instance details

Defined in Amazonka.ApiGatewayV2.ImportApi

type Rep ImportApi Source # 
Instance details

Defined in Amazonka.ApiGatewayV2.ImportApi

type Rep ImportApi = D1 ('MetaData "ImportApi" "Amazonka.ApiGatewayV2.ImportApi" "amazonka-apigatewayv2-2.0-4MZ8oueToeLOWomgegceF" 'False) (C1 ('MetaCons "ImportApi'" 'PrefixI 'True) (S1 ('MetaSel ('Just "basepath") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "failOnWarnings") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :*: S1 ('MetaSel ('Just "body") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text))))

newImportApi Source #

Create a value of ImportApi with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:basepath:ImportApi', importApi_basepath - Specifies how to interpret the base path of the API during import. Valid values are ignore, prepend, and split. The default value is ignore. To learn more, see Set the OpenAPI basePath Property. Supported only for HTTP APIs.

$sel:failOnWarnings:ImportApi', importApi_failOnWarnings - Specifies whether to rollback the API creation when a warning is encountered. By default, API creation continues if a warning is encountered.

$sel:body:ImportApi', importApi_body - The OpenAPI definition. Supported only for HTTP APIs.

Request Lenses

importApi_basepath :: Lens' ImportApi (Maybe Text) Source #

Specifies how to interpret the base path of the API during import. Valid values are ignore, prepend, and split. The default value is ignore. To learn more, see Set the OpenAPI basePath Property. Supported only for HTTP APIs.

importApi_failOnWarnings :: Lens' ImportApi (Maybe Bool) Source #

Specifies whether to rollback the API creation when a warning is encountered. By default, API creation continues if a warning is encountered.

importApi_body :: Lens' ImportApi Text Source #

The OpenAPI definition. Supported only for HTTP APIs.

Destructuring the Response

data ImportApiResponse Source #

See: newImportApiResponse smart constructor.

Constructors

ImportApiResponse' 

Fields

  • apiEndpoint :: Maybe Text

    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.

  • apiGatewayManaged :: Maybe Bool

    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.

  • apiId :: Maybe Text

    The API ID.

  • apiKeySelectionExpression :: Maybe Text

    An API key selection expression. Supported only for WebSocket APIs. See API Key Selection Expressions.

  • corsConfiguration :: Maybe Cors

    A CORS configuration. Supported only for HTTP APIs.

  • createdDate :: Maybe ISO8601

    The timestamp when the API was created.

  • description :: Maybe Text

    The description of the API.

  • disableExecuteApiEndpoint :: Maybe Bool

    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.

  • disableSchemaValidation :: Maybe Bool

    Avoid validating models when creating a deployment. Supported only for WebSocket APIs.

  • importInfo :: Maybe [Text]

    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.

  • name :: Maybe Text

    The name of the API.

  • protocolType :: Maybe ProtocolType

    The API protocol.

  • routeSelectionExpression :: Maybe Text

    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.

  • tags :: Maybe (HashMap Text Text)

    A collection of tags associated with the API.

  • version :: Maybe Text

    A version identifier for the API.

  • warnings :: Maybe [Text]

    The warning messages reported when failonwarnings is turned on during API import.

  • httpStatus :: Int

    The response's http status code.

Instances

Instances details
Generic ImportApiResponse Source # 
Instance details

Defined in Amazonka.ApiGatewayV2.ImportApi

Associated Types

type Rep ImportApiResponse :: Type -> Type #

Read ImportApiResponse Source # 
Instance details

Defined in Amazonka.ApiGatewayV2.ImportApi

Show ImportApiResponse Source # 
Instance details

Defined in Amazonka.ApiGatewayV2.ImportApi

NFData ImportApiResponse Source # 
Instance details

Defined in Amazonka.ApiGatewayV2.ImportApi

Methods

rnf :: ImportApiResponse -> () #

Eq ImportApiResponse Source # 
Instance details

Defined in Amazonka.ApiGatewayV2.ImportApi

type Rep ImportApiResponse Source # 
Instance details

Defined in Amazonka.ApiGatewayV2.ImportApi

type Rep ImportApiResponse = D1 ('MetaData "ImportApiResponse" "Amazonka.ApiGatewayV2.ImportApi" "amazonka-apigatewayv2-2.0-4MZ8oueToeLOWomgegceF" 'False) (C1 ('MetaCons "ImportApiResponse'" 'PrefixI 'True) ((((S1 ('MetaSel ('Just "apiEndpoint") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "apiGatewayManaged") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool))) :*: (S1 ('MetaSel ('Just "apiId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "apiKeySelectionExpression") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)))) :*: ((S1 ('MetaSel ('Just "corsConfiguration") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Cors)) :*: S1 ('MetaSel ('Just "createdDate") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ISO8601))) :*: (S1 ('MetaSel ('Just "description") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "disableExecuteApiEndpoint") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool))))) :*: (((S1 ('MetaSel ('Just "disableSchemaValidation") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :*: S1 ('MetaSel ('Just "importInfo") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Text]))) :*: (S1 ('MetaSel ('Just "name") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "protocolType") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ProtocolType)))) :*: ((S1 ('MetaSel ('Just "routeSelectionExpression") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "tags") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe (HashMap Text Text)))) :*: (S1 ('MetaSel ('Just "version") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "warnings") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Text])) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))))))

newImportApiResponse Source #

Create a value of ImportApiResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

ImportApiResponse, importApiResponse_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.

ImportApiResponse, importApiResponse_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.

ImportApiResponse, importApiResponse_apiId - The API ID.

ImportApiResponse, importApiResponse_apiKeySelectionExpression - An API key selection expression. Supported only for WebSocket APIs. See API Key Selection Expressions.

ImportApiResponse, importApiResponse_corsConfiguration - A CORS configuration. Supported only for HTTP APIs.

ImportApiResponse, importApiResponse_createdDate - The timestamp when the API was created.

ImportApiResponse, importApiResponse_description - The description of the API.

ImportApiResponse, importApiResponse_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.

ImportApiResponse, importApiResponse_disableSchemaValidation - Avoid validating models when creating a deployment. Supported only for WebSocket APIs.

ImportApiResponse, importApiResponse_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.

ImportApiResponse, importApiResponse_name - The name of the API.

ImportApiResponse, importApiResponse_protocolType - The API protocol.

ImportApiResponse, importApiResponse_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.

ImportApiResponse, importApiResponse_tags - A collection of tags associated with the API.

ImportApiResponse, importApiResponse_version - A version identifier for the API.

ImportApiResponse, importApiResponse_warnings - The warning messages reported when failonwarnings is turned on during API import.

$sel:httpStatus:ImportApiResponse', importApiResponse_httpStatus - The response's http status code.

Response Lenses

importApiResponse_apiEndpoint :: Lens' ImportApiResponse (Maybe Text) Source #

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.

importApiResponse_apiGatewayManaged :: Lens' ImportApiResponse (Maybe Bool) Source #

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.

importApiResponse_apiKeySelectionExpression :: Lens' ImportApiResponse (Maybe Text) Source #

An API key selection expression. Supported only for WebSocket APIs. See API Key Selection Expressions.

importApiResponse_corsConfiguration :: Lens' ImportApiResponse (Maybe Cors) Source #

A CORS configuration. Supported only for HTTP APIs.

importApiResponse_createdDate :: Lens' ImportApiResponse (Maybe UTCTime) Source #

The timestamp when the API was created.

importApiResponse_disableExecuteApiEndpoint :: Lens' ImportApiResponse (Maybe Bool) Source #

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.

importApiResponse_disableSchemaValidation :: Lens' ImportApiResponse (Maybe Bool) Source #

Avoid validating models when creating a deployment. Supported only for WebSocket APIs.

importApiResponse_importInfo :: Lens' ImportApiResponse (Maybe [Text]) Source #

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.

importApiResponse_routeSelectionExpression :: Lens' ImportApiResponse (Maybe Text) Source #

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.

importApiResponse_tags :: Lens' ImportApiResponse (Maybe (HashMap Text Text)) Source #

A collection of tags associated with the API.

importApiResponse_version :: Lens' ImportApiResponse (Maybe Text) Source #

A version identifier for the API.

importApiResponse_warnings :: Lens' ImportApiResponse (Maybe [Text]) Source #

The warning messages reported when failonwarnings is turned on during API import.

importApiResponse_httpStatus :: Lens' ImportApiResponse Int Source #

The response's http status code.