Interface ApiGatewayAsyncClient
- All Superinterfaces:
AutoCloseable,AwsClient,SdkAutoCloseable,SdkClient
builder() method.The asynchronous client performs non-blocking I/O when configured with any
SdkAsyncHttpClient supported in the SDK. However, full non-blocking is not guaranteed as the async client may
perform blocking calls in some cases such as credentials retrieval and endpoint discovery as part of the async API
call.
Amazon API Gateway helps developers deliver robust, secure, and scalable mobile and web application back ends. API Gateway allows developers to securely connect mobile and web applications to APIs that run on Lambda, Amazon EC2, or other publicly addressable web services that are hosted outside of AWS.
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final StringValue for looking up the service's metadata from theServiceMetadataProvider.static final String -
Method Summary
Modifier and TypeMethodDescriptionstatic ApiGatewayAsyncClientBuilderbuilder()Create a builder that can be used to configure and create aApiGatewayAsyncClient.static ApiGatewayAsyncClientcreate()Create aApiGatewayAsyncClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider.default CompletableFuture<CreateApiKeyResponse> Create an ApiKey resource.default CompletableFuture<CreateApiKeyResponse> createApiKey(Consumer<CreateApiKeyRequest.Builder> createApiKeyRequest) Create an ApiKey resource.default CompletableFuture<CreateApiKeyResponse> createApiKey(CreateApiKeyRequest createApiKeyRequest) Create an ApiKey resource.createAuthorizer(Consumer<CreateAuthorizerRequest.Builder> createAuthorizerRequest) Adds a new Authorizer resource to an existing RestApi resource.createAuthorizer(CreateAuthorizerRequest createAuthorizerRequest) Adds a new Authorizer resource to an existing RestApi resource.createBasePathMapping(Consumer<CreateBasePathMappingRequest.Builder> createBasePathMappingRequest) Creates a new BasePathMapping resource.createBasePathMapping(CreateBasePathMappingRequest createBasePathMappingRequest) Creates a new BasePathMapping resource.createDeployment(Consumer<CreateDeploymentRequest.Builder> createDeploymentRequest) Creates a Deployment resource, which makes a specified RestApi callable over the internet.createDeployment(CreateDeploymentRequest createDeploymentRequest) Creates a Deployment resource, which makes a specified RestApi callable over the internet.createDocumentationPart(Consumer<CreateDocumentationPartRequest.Builder> createDocumentationPartRequest) Creates a documentation part.createDocumentationPart(CreateDocumentationPartRequest createDocumentationPartRequest) Creates a documentation part.createDocumentationVersion(Consumer<CreateDocumentationVersionRequest.Builder> createDocumentationVersionRequest) Creates a documentation versioncreateDocumentationVersion(CreateDocumentationVersionRequest createDocumentationVersionRequest) Creates a documentation versioncreateDomainName(Consumer<CreateDomainNameRequest.Builder> createDomainNameRequest) Creates a new domain name.createDomainName(CreateDomainNameRequest createDomainNameRequest) Creates a new domain name.default CompletableFuture<CreateModelResponse> createModel(Consumer<CreateModelRequest.Builder> createModelRequest) Adds a new Model resource to an existing RestApi resource.default CompletableFuture<CreateModelResponse> createModel(CreateModelRequest createModelRequest) Adds a new Model resource to an existing RestApi resource.createRequestValidator(Consumer<CreateRequestValidatorRequest.Builder> createRequestValidatorRequest) Creates a RequestValidator of a given RestApi.createRequestValidator(CreateRequestValidatorRequest createRequestValidatorRequest) Creates a RequestValidator of a given RestApi.default CompletableFuture<CreateResourceResponse> createResource(Consumer<CreateResourceRequest.Builder> createResourceRequest) Creates a Resource resource.default CompletableFuture<CreateResourceResponse> createResource(CreateResourceRequest createResourceRequest) Creates a Resource resource.default CompletableFuture<CreateRestApiResponse> createRestApi(Consumer<CreateRestApiRequest.Builder> createRestApiRequest) Creates a new RestApi resource.default CompletableFuture<CreateRestApiResponse> createRestApi(CreateRestApiRequest createRestApiRequest) Creates a new RestApi resource.default CompletableFuture<CreateStageResponse> createStage(Consumer<CreateStageRequest.Builder> createStageRequest) Creates a new Stage resource that references a pre-existing Deployment for the API.default CompletableFuture<CreateStageResponse> createStage(CreateStageRequest createStageRequest) Creates a new Stage resource that references a pre-existing Deployment for the API.default CompletableFuture<CreateUsagePlanResponse> createUsagePlan(Consumer<CreateUsagePlanRequest.Builder> createUsagePlanRequest) Creates a usage plan with the throttle and quota limits, as well as the associated API stages, specified in the payload.default CompletableFuture<CreateUsagePlanResponse> createUsagePlan(CreateUsagePlanRequest createUsagePlanRequest) Creates a usage plan with the throttle and quota limits, as well as the associated API stages, specified in the payload.createUsagePlanKey(Consumer<CreateUsagePlanKeyRequest.Builder> createUsagePlanKeyRequest) Creates a usage plan key for adding an existing API key to a usage plan.createUsagePlanKey(CreateUsagePlanKeyRequest createUsagePlanKeyRequest) Creates a usage plan key for adding an existing API key to a usage plan.default CompletableFuture<CreateVpcLinkResponse> createVpcLink(Consumer<CreateVpcLinkRequest.Builder> createVpcLinkRequest) Creates a VPC link, under the caller's account in a selected region, in an asynchronous operation that typically takes 2-4 minutes to complete and become operational.default CompletableFuture<CreateVpcLinkResponse> createVpcLink(CreateVpcLinkRequest createVpcLinkRequest) Creates a VPC link, under the caller's account in a selected region, in an asynchronous operation that typically takes 2-4 minutes to complete and become operational.default CompletableFuture<DeleteApiKeyResponse> deleteApiKey(Consumer<DeleteApiKeyRequest.Builder> deleteApiKeyRequest) Deletes the ApiKey resource.default CompletableFuture<DeleteApiKeyResponse> deleteApiKey(DeleteApiKeyRequest deleteApiKeyRequest) Deletes the ApiKey resource.deleteAuthorizer(Consumer<DeleteAuthorizerRequest.Builder> deleteAuthorizerRequest) Deletes an existing Authorizer resource.deleteAuthorizer(DeleteAuthorizerRequest deleteAuthorizerRequest) Deletes an existing Authorizer resource.deleteBasePathMapping(Consumer<DeleteBasePathMappingRequest.Builder> deleteBasePathMappingRequest) Deletes the BasePathMapping resource.deleteBasePathMapping(DeleteBasePathMappingRequest deleteBasePathMappingRequest) Deletes the BasePathMapping resource.deleteClientCertificate(Consumer<DeleteClientCertificateRequest.Builder> deleteClientCertificateRequest) Deletes the ClientCertificate resource.deleteClientCertificate(DeleteClientCertificateRequest deleteClientCertificateRequest) Deletes the ClientCertificate resource.deleteDeployment(Consumer<DeleteDeploymentRequest.Builder> deleteDeploymentRequest) Deletes a Deployment resource.deleteDeployment(DeleteDeploymentRequest deleteDeploymentRequest) Deletes a Deployment resource.deleteDocumentationPart(Consumer<DeleteDocumentationPartRequest.Builder> deleteDocumentationPartRequest) Deletes a documentation partdeleteDocumentationPart(DeleteDocumentationPartRequest deleteDocumentationPartRequest) Deletes a documentation partdeleteDocumentationVersion(Consumer<DeleteDocumentationVersionRequest.Builder> deleteDocumentationVersionRequest) Deletes a documentation version.deleteDocumentationVersion(DeleteDocumentationVersionRequest deleteDocumentationVersionRequest) Deletes a documentation version.deleteDomainName(Consumer<DeleteDomainNameRequest.Builder> deleteDomainNameRequest) Deletes the DomainName resource.deleteDomainName(DeleteDomainNameRequest deleteDomainNameRequest) Deletes the DomainName resource.deleteGatewayResponse(Consumer<DeleteGatewayResponseRequest.Builder> deleteGatewayResponseRequest) Clears any customization of a GatewayResponse of a specified response type on the given RestApi and resets it with the default settings.deleteGatewayResponse(DeleteGatewayResponseRequest deleteGatewayResponseRequest) Clears any customization of a GatewayResponse of a specified response type on the given RestApi and resets it with the default settings.deleteIntegration(Consumer<DeleteIntegrationRequest.Builder> deleteIntegrationRequest) Represents a delete integration.deleteIntegration(DeleteIntegrationRequest deleteIntegrationRequest) Represents a delete integration.deleteIntegrationResponse(Consumer<DeleteIntegrationResponseRequest.Builder> deleteIntegrationResponseRequest) Represents a delete integration response.deleteIntegrationResponse(DeleteIntegrationResponseRequest deleteIntegrationResponseRequest) Represents a delete integration response.default CompletableFuture<DeleteMethodResponse> deleteMethod(Consumer<DeleteMethodRequest.Builder> deleteMethodRequest) Deletes an existing Method resource.default CompletableFuture<DeleteMethodResponse> deleteMethod(DeleteMethodRequest deleteMethodRequest) Deletes an existing Method resource.deleteMethodResponse(Consumer<DeleteMethodResponseRequest.Builder> deleteMethodResponseRequest) Deletes an existing MethodResponse resource.deleteMethodResponse(DeleteMethodResponseRequest deleteMethodResponseRequest) Deletes an existing MethodResponse resource.default CompletableFuture<DeleteModelResponse> deleteModel(Consumer<DeleteModelRequest.Builder> deleteModelRequest) Deletes a model.default CompletableFuture<DeleteModelResponse> deleteModel(DeleteModelRequest deleteModelRequest) Deletes a model.deleteRequestValidator(Consumer<DeleteRequestValidatorRequest.Builder> deleteRequestValidatorRequest) Deletes a RequestValidator of a given RestApi.deleteRequestValidator(DeleteRequestValidatorRequest deleteRequestValidatorRequest) Deletes a RequestValidator of a given RestApi.default CompletableFuture<DeleteResourceResponse> deleteResource(Consumer<DeleteResourceRequest.Builder> deleteResourceRequest) Deletes a Resource resource.default CompletableFuture<DeleteResourceResponse> deleteResource(DeleteResourceRequest deleteResourceRequest) Deletes a Resource resource.default CompletableFuture<DeleteRestApiResponse> deleteRestApi(Consumer<DeleteRestApiRequest.Builder> deleteRestApiRequest) Deletes the specified API.default CompletableFuture<DeleteRestApiResponse> deleteRestApi(DeleteRestApiRequest deleteRestApiRequest) Deletes the specified API.default CompletableFuture<DeleteStageResponse> deleteStage(Consumer<DeleteStageRequest.Builder> deleteStageRequest) Deletes a Stage resource.default CompletableFuture<DeleteStageResponse> deleteStage(DeleteStageRequest deleteStageRequest) Deletes a Stage resource.default CompletableFuture<DeleteUsagePlanResponse> deleteUsagePlan(Consumer<DeleteUsagePlanRequest.Builder> deleteUsagePlanRequest) Deletes a usage plan of a given plan Id.default CompletableFuture<DeleteUsagePlanResponse> deleteUsagePlan(DeleteUsagePlanRequest deleteUsagePlanRequest) Deletes a usage plan of a given plan Id.deleteUsagePlanKey(Consumer<DeleteUsagePlanKeyRequest.Builder> deleteUsagePlanKeyRequest) Deletes a usage plan key and remove the underlying API key from the associated usage plan.deleteUsagePlanKey(DeleteUsagePlanKeyRequest deleteUsagePlanKeyRequest) Deletes a usage plan key and remove the underlying API key from the associated usage plan.default CompletableFuture<DeleteVpcLinkResponse> deleteVpcLink(Consumer<DeleteVpcLinkRequest.Builder> deleteVpcLinkRequest) Deletes an existing VpcLink of a specified identifier.default CompletableFuture<DeleteVpcLinkResponse> deleteVpcLink(DeleteVpcLinkRequest deleteVpcLinkRequest) Deletes an existing VpcLink of a specified identifier.flushStageAuthorizersCache(Consumer<FlushStageAuthorizersCacheRequest.Builder> flushStageAuthorizersCacheRequest) Flushes all authorizer cache entries on a stage.flushStageAuthorizersCache(FlushStageAuthorizersCacheRequest flushStageAuthorizersCacheRequest) Flushes all authorizer cache entries on a stage.default CompletableFuture<FlushStageCacheResponse> flushStageCache(Consumer<FlushStageCacheRequest.Builder> flushStageCacheRequest) Flushes a stage's cache.default CompletableFuture<FlushStageCacheResponse> flushStageCache(FlushStageCacheRequest flushStageCacheRequest) Flushes a stage's cache.Generates a ClientCertificate resource.generateClientCertificate(Consumer<GenerateClientCertificateRequest.Builder> generateClientCertificateRequest) Generates a ClientCertificate resource.generateClientCertificate(GenerateClientCertificateRequest generateClientCertificateRequest) Generates a ClientCertificate resource.default CompletableFuture<GetAccountResponse> Gets information about the current Account resource.default CompletableFuture<GetAccountResponse> getAccount(Consumer<GetAccountRequest.Builder> getAccountRequest) Gets information about the current Account resource.default CompletableFuture<GetAccountResponse> getAccount(GetAccountRequest getAccountRequest) Gets information about the current Account resource.default CompletableFuture<GetApiKeyResponse> getApiKey(Consumer<GetApiKeyRequest.Builder> getApiKeyRequest) Gets information about the current ApiKey resource.default CompletableFuture<GetApiKeyResponse> getApiKey(GetApiKeyRequest getApiKeyRequest) Gets information about the current ApiKey resource.default CompletableFuture<GetApiKeysResponse> Gets information about the current ApiKeys resource.default CompletableFuture<GetApiKeysResponse> getApiKeys(Consumer<GetApiKeysRequest.Builder> getApiKeysRequest) Gets information about the current ApiKeys resource.default CompletableFuture<GetApiKeysResponse> getApiKeys(GetApiKeysRequest getApiKeysRequest) Gets information about the current ApiKeys resource.default GetApiKeysPublisherThis is a variant ofgetApiKeys(software.amazon.awssdk.services.apigateway.model.GetApiKeysRequest)operation.default GetApiKeysPublishergetApiKeysPaginator(Consumer<GetApiKeysRequest.Builder> getApiKeysRequest) This is a variant ofgetApiKeys(software.amazon.awssdk.services.apigateway.model.GetApiKeysRequest)operation.default GetApiKeysPublishergetApiKeysPaginator(GetApiKeysRequest getApiKeysRequest) This is a variant ofgetApiKeys(software.amazon.awssdk.services.apigateway.model.GetApiKeysRequest)operation.default CompletableFuture<GetAuthorizerResponse> getAuthorizer(Consumer<GetAuthorizerRequest.Builder> getAuthorizerRequest) Describe an existing Authorizer resource.default CompletableFuture<GetAuthorizerResponse> getAuthorizer(GetAuthorizerRequest getAuthorizerRequest) Describe an existing Authorizer resource.default CompletableFuture<GetAuthorizersResponse> getAuthorizers(Consumer<GetAuthorizersRequest.Builder> getAuthorizersRequest) Describe an existing Authorizers resource.default CompletableFuture<GetAuthorizersResponse> getAuthorizers(GetAuthorizersRequest getAuthorizersRequest) Describe an existing Authorizers resource.getBasePathMapping(Consumer<GetBasePathMappingRequest.Builder> getBasePathMappingRequest) Describe a BasePathMapping resource.getBasePathMapping(GetBasePathMappingRequest getBasePathMappingRequest) Describe a BasePathMapping resource.getBasePathMappings(Consumer<GetBasePathMappingsRequest.Builder> getBasePathMappingsRequest) Represents a collection of BasePathMapping resources.getBasePathMappings(GetBasePathMappingsRequest getBasePathMappingsRequest) Represents a collection of BasePathMapping resources.default GetBasePathMappingsPublishergetBasePathMappingsPaginator(Consumer<GetBasePathMappingsRequest.Builder> getBasePathMappingsRequest) This is a variant ofgetBasePathMappings(software.amazon.awssdk.services.apigateway.model.GetBasePathMappingsRequest)operation.default GetBasePathMappingsPublishergetBasePathMappingsPaginator(GetBasePathMappingsRequest getBasePathMappingsRequest) This is a variant ofgetBasePathMappings(software.amazon.awssdk.services.apigateway.model.GetBasePathMappingsRequest)operation.getClientCertificate(Consumer<GetClientCertificateRequest.Builder> getClientCertificateRequest) Gets information about the current ClientCertificate resource.getClientCertificate(GetClientCertificateRequest getClientCertificateRequest) Gets information about the current ClientCertificate resource.Gets a collection of ClientCertificate resources.getClientCertificates(Consumer<GetClientCertificatesRequest.Builder> getClientCertificatesRequest) Gets a collection of ClientCertificate resources.getClientCertificates(GetClientCertificatesRequest getClientCertificatesRequest) Gets a collection of ClientCertificate resources.default GetClientCertificatesPublisherThis is a variant ofgetClientCertificates(software.amazon.awssdk.services.apigateway.model.GetClientCertificatesRequest)operation.default GetClientCertificatesPublishergetClientCertificatesPaginator(Consumer<GetClientCertificatesRequest.Builder> getClientCertificatesRequest) This is a variant ofgetClientCertificates(software.amazon.awssdk.services.apigateway.model.GetClientCertificatesRequest)operation.default GetClientCertificatesPublishergetClientCertificatesPaginator(GetClientCertificatesRequest getClientCertificatesRequest) This is a variant ofgetClientCertificates(software.amazon.awssdk.services.apigateway.model.GetClientCertificatesRequest)operation.default CompletableFuture<GetDeploymentResponse> getDeployment(Consumer<GetDeploymentRequest.Builder> getDeploymentRequest) Gets information about a Deployment resource.default CompletableFuture<GetDeploymentResponse> getDeployment(GetDeploymentRequest getDeploymentRequest) Gets information about a Deployment resource.default CompletableFuture<GetDeploymentsResponse> getDeployments(Consumer<GetDeploymentsRequest.Builder> getDeploymentsRequest) Gets information about a Deployments collection.default CompletableFuture<GetDeploymentsResponse> getDeployments(GetDeploymentsRequest getDeploymentsRequest) Gets information about a Deployments collection.default GetDeploymentsPublishergetDeploymentsPaginator(Consumer<GetDeploymentsRequest.Builder> getDeploymentsRequest) This is a variant ofgetDeployments(software.amazon.awssdk.services.apigateway.model.GetDeploymentsRequest)operation.default GetDeploymentsPublishergetDeploymentsPaginator(GetDeploymentsRequest getDeploymentsRequest) This is a variant ofgetDeployments(software.amazon.awssdk.services.apigateway.model.GetDeploymentsRequest)operation.getDocumentationPart(Consumer<GetDocumentationPartRequest.Builder> getDocumentationPartRequest) Gets a documentation part.getDocumentationPart(GetDocumentationPartRequest getDocumentationPartRequest) Gets a documentation part.getDocumentationParts(Consumer<GetDocumentationPartsRequest.Builder> getDocumentationPartsRequest) Gets documentation parts.getDocumentationParts(GetDocumentationPartsRequest getDocumentationPartsRequest) Gets documentation parts.getDocumentationVersion(Consumer<GetDocumentationVersionRequest.Builder> getDocumentationVersionRequest) Gets a documentation version.getDocumentationVersion(GetDocumentationVersionRequest getDocumentationVersionRequest) Gets a documentation version.getDocumentationVersions(Consumer<GetDocumentationVersionsRequest.Builder> getDocumentationVersionsRequest) Gets documentation versions.getDocumentationVersions(GetDocumentationVersionsRequest getDocumentationVersionsRequest) Gets documentation versions.default CompletableFuture<GetDomainNameResponse> getDomainName(Consumer<GetDomainNameRequest.Builder> getDomainNameRequest) Represents a domain name that is contained in a simpler, more intuitive URL that can be called.default CompletableFuture<GetDomainNameResponse> getDomainName(GetDomainNameRequest getDomainNameRequest) Represents a domain name that is contained in a simpler, more intuitive URL that can be called.default CompletableFuture<GetDomainNamesResponse> Represents a collection of DomainName resources.default CompletableFuture<GetDomainNamesResponse> getDomainNames(Consumer<GetDomainNamesRequest.Builder> getDomainNamesRequest) Represents a collection of DomainName resources.default CompletableFuture<GetDomainNamesResponse> getDomainNames(GetDomainNamesRequest getDomainNamesRequest) Represents a collection of DomainName resources.default GetDomainNamesPublisherThis is a variant ofgetDomainNames(software.amazon.awssdk.services.apigateway.model.GetDomainNamesRequest)operation.default GetDomainNamesPublishergetDomainNamesPaginator(Consumer<GetDomainNamesRequest.Builder> getDomainNamesRequest) This is a variant ofgetDomainNames(software.amazon.awssdk.services.apigateway.model.GetDomainNamesRequest)operation.default GetDomainNamesPublishergetDomainNamesPaginator(GetDomainNamesRequest getDomainNamesRequest) This is a variant ofgetDomainNames(software.amazon.awssdk.services.apigateway.model.GetDomainNamesRequest)operation.default CompletableFuture<GetExportResponse> getExport(Consumer<GetExportRequest.Builder> getExportRequest) Exports a deployed version of a RestApi in a specified format.default CompletableFuture<GetExportResponse> getExport(GetExportRequest getExportRequest) Exports a deployed version of a RestApi in a specified format.getGatewayResponse(Consumer<GetGatewayResponseRequest.Builder> getGatewayResponseRequest) Gets a GatewayResponse of a specified response type on the given RestApi.getGatewayResponse(GetGatewayResponseRequest getGatewayResponseRequest) Gets a GatewayResponse of a specified response type on the given RestApi.getGatewayResponses(Consumer<GetGatewayResponsesRequest.Builder> getGatewayResponsesRequest) Gets the GatewayResponses collection on the given RestApi.getGatewayResponses(GetGatewayResponsesRequest getGatewayResponsesRequest) Gets the GatewayResponses collection on the given RestApi.default CompletableFuture<GetIntegrationResponse> getIntegration(Consumer<GetIntegrationRequest.Builder> getIntegrationRequest) Get the integration settings.default CompletableFuture<GetIntegrationResponse> getIntegration(GetIntegrationRequest getIntegrationRequest) Get the integration settings.getIntegrationResponse(Consumer<GetIntegrationResponseRequest.Builder> getIntegrationResponseRequest) Represents a get integration response.getIntegrationResponse(GetIntegrationResponseRequest getIntegrationResponseRequest) Represents a get integration response.default CompletableFuture<GetMethodResponse> getMethod(Consumer<GetMethodRequest.Builder> getMethodRequest) Describe an existing Method resource.default CompletableFuture<GetMethodResponse> getMethod(GetMethodRequest getMethodRequest) Describe an existing Method resource.getMethodResponse(Consumer<GetMethodResponseRequest.Builder> getMethodResponseRequest) Describes a MethodResponse resource.getMethodResponse(GetMethodResponseRequest getMethodResponseRequest) Describes a MethodResponse resource.default CompletableFuture<GetModelResponse> getModel(Consumer<GetModelRequest.Builder> getModelRequest) Describes an existing model defined for a RestApi resource.default CompletableFuture<GetModelResponse> getModel(GetModelRequest getModelRequest) Describes an existing model defined for a RestApi resource.default CompletableFuture<GetModelsResponse> getModels(Consumer<GetModelsRequest.Builder> getModelsRequest) Describes existing Models defined for a RestApi resource.default CompletableFuture<GetModelsResponse> getModels(GetModelsRequest getModelsRequest) Describes existing Models defined for a RestApi resource.default GetModelsPublishergetModelsPaginator(Consumer<GetModelsRequest.Builder> getModelsRequest) This is a variant ofgetModels(software.amazon.awssdk.services.apigateway.model.GetModelsRequest)operation.default GetModelsPublishergetModelsPaginator(GetModelsRequest getModelsRequest) This is a variant ofgetModels(software.amazon.awssdk.services.apigateway.model.GetModelsRequest)operation.getModelTemplate(Consumer<GetModelTemplateRequest.Builder> getModelTemplateRequest) Generates a sample mapping template that can be used to transform a payload into the structure of a model.getModelTemplate(GetModelTemplateRequest getModelTemplateRequest) Generates a sample mapping template that can be used to transform a payload into the structure of a model.getRequestValidator(Consumer<GetRequestValidatorRequest.Builder> getRequestValidatorRequest) Gets a RequestValidator of a given RestApi.getRequestValidator(GetRequestValidatorRequest getRequestValidatorRequest) Gets a RequestValidator of a given RestApi.getRequestValidators(Consumer<GetRequestValidatorsRequest.Builder> getRequestValidatorsRequest) Gets the RequestValidators collection of a given RestApi.getRequestValidators(GetRequestValidatorsRequest getRequestValidatorsRequest) Gets the RequestValidators collection of a given RestApi.default CompletableFuture<GetResourceResponse> getResource(Consumer<GetResourceRequest.Builder> getResourceRequest) Lists information about a resource.default CompletableFuture<GetResourceResponse> getResource(GetResourceRequest getResourceRequest) Lists information about a resource.default CompletableFuture<GetResourcesResponse> getResources(Consumer<GetResourcesRequest.Builder> getResourcesRequest) Lists information about a collection of Resource resources.default CompletableFuture<GetResourcesResponse> getResources(GetResourcesRequest getResourcesRequest) Lists information about a collection of Resource resources.default GetResourcesPublishergetResourcesPaginator(Consumer<GetResourcesRequest.Builder> getResourcesRequest) This is a variant ofgetResources(software.amazon.awssdk.services.apigateway.model.GetResourcesRequest)operation.default GetResourcesPublishergetResourcesPaginator(GetResourcesRequest getResourcesRequest) This is a variant ofgetResources(software.amazon.awssdk.services.apigateway.model.GetResourcesRequest)operation.default CompletableFuture<GetRestApiResponse> getRestApi(Consumer<GetRestApiRequest.Builder> getRestApiRequest) Lists the RestApi resource in the collection.default CompletableFuture<GetRestApiResponse> getRestApi(GetRestApiRequest getRestApiRequest) Lists the RestApi resource in the collection.default CompletableFuture<GetRestApisResponse> Lists the RestApis resources for your collection.default CompletableFuture<GetRestApisResponse> getRestApis(Consumer<GetRestApisRequest.Builder> getRestApisRequest) Lists the RestApis resources for your collection.default CompletableFuture<GetRestApisResponse> getRestApis(GetRestApisRequest getRestApisRequest) Lists the RestApis resources for your collection.default GetRestApisPublisherThis is a variant ofgetRestApis(software.amazon.awssdk.services.apigateway.model.GetRestApisRequest)operation.default GetRestApisPublishergetRestApisPaginator(Consumer<GetRestApisRequest.Builder> getRestApisRequest) This is a variant ofgetRestApis(software.amazon.awssdk.services.apigateway.model.GetRestApisRequest)operation.default GetRestApisPublishergetRestApisPaginator(GetRestApisRequest getRestApisRequest) This is a variant ofgetRestApis(software.amazon.awssdk.services.apigateway.model.GetRestApisRequest)operation.default CompletableFuture<GetSdkResponse> getSdk(Consumer<GetSdkRequest.Builder> getSdkRequest) Generates a client SDK for a RestApi and Stage.default CompletableFuture<GetSdkResponse> getSdk(GetSdkRequest getSdkRequest) Generates a client SDK for a RestApi and Stage.default CompletableFuture<GetSdkTypeResponse> getSdkType(Consumer<GetSdkTypeRequest.Builder> getSdkTypeRequest) Gets an SDK type.default CompletableFuture<GetSdkTypeResponse> getSdkType(GetSdkTypeRequest getSdkTypeRequest) Gets an SDK type.default CompletableFuture<GetSdkTypesResponse> Gets SDK typesdefault CompletableFuture<GetSdkTypesResponse> getSdkTypes(Consumer<GetSdkTypesRequest.Builder> getSdkTypesRequest) Gets SDK typesdefault CompletableFuture<GetSdkTypesResponse> getSdkTypes(GetSdkTypesRequest getSdkTypesRequest) Gets SDK typesdefault CompletableFuture<GetStageResponse> getStage(Consumer<GetStageRequest.Builder> getStageRequest) Gets information about a Stage resource.default CompletableFuture<GetStageResponse> getStage(GetStageRequest getStageRequest) Gets information about a Stage resource.default CompletableFuture<GetStagesResponse> getStages(Consumer<GetStagesRequest.Builder> getStagesRequest) Gets information about one or more Stage resources.default CompletableFuture<GetStagesResponse> getStages(GetStagesRequest getStagesRequest) Gets information about one or more Stage resources.default CompletableFuture<GetTagsResponse> getTags(Consumer<GetTagsRequest.Builder> getTagsRequest) Gets the Tags collection for a given resource.default CompletableFuture<GetTagsResponse> getTags(GetTagsRequest getTagsRequest) Gets the Tags collection for a given resource.default CompletableFuture<GetUsageResponse> getUsage(Consumer<GetUsageRequest.Builder> getUsageRequest) Gets the usage data of a usage plan in a specified time interval.default CompletableFuture<GetUsageResponse> getUsage(GetUsageRequest getUsageRequest) Gets the usage data of a usage plan in a specified time interval.default GetUsagePublishergetUsagePaginator(Consumer<GetUsageRequest.Builder> getUsageRequest) This is a variant ofgetUsage(software.amazon.awssdk.services.apigateway.model.GetUsageRequest)operation.default GetUsagePublishergetUsagePaginator(GetUsageRequest getUsageRequest) This is a variant ofgetUsage(software.amazon.awssdk.services.apigateway.model.GetUsageRequest)operation.default CompletableFuture<GetUsagePlanResponse> getUsagePlan(Consumer<GetUsagePlanRequest.Builder> getUsagePlanRequest) Gets a usage plan of a given plan identifier.default CompletableFuture<GetUsagePlanResponse> getUsagePlan(GetUsagePlanRequest getUsagePlanRequest) Gets a usage plan of a given plan identifier.default CompletableFuture<GetUsagePlanKeyResponse> getUsagePlanKey(Consumer<GetUsagePlanKeyRequest.Builder> getUsagePlanKeyRequest) Gets a usage plan key of a given key identifier.default CompletableFuture<GetUsagePlanKeyResponse> getUsagePlanKey(GetUsagePlanKeyRequest getUsagePlanKeyRequest) Gets a usage plan key of a given key identifier.getUsagePlanKeys(Consumer<GetUsagePlanKeysRequest.Builder> getUsagePlanKeysRequest) Gets all the usage plan keys representing the API keys added to a specified usage plan.getUsagePlanKeys(GetUsagePlanKeysRequest getUsagePlanKeysRequest) Gets all the usage plan keys representing the API keys added to a specified usage plan.default GetUsagePlanKeysPublishergetUsagePlanKeysPaginator(Consumer<GetUsagePlanKeysRequest.Builder> getUsagePlanKeysRequest) This is a variant ofgetUsagePlanKeys(software.amazon.awssdk.services.apigateway.model.GetUsagePlanKeysRequest)operation.default GetUsagePlanKeysPublishergetUsagePlanKeysPaginator(GetUsagePlanKeysRequest getUsagePlanKeysRequest) This is a variant ofgetUsagePlanKeys(software.amazon.awssdk.services.apigateway.model.GetUsagePlanKeysRequest)operation.default CompletableFuture<GetUsagePlansResponse> Gets all the usage plans of the caller's account.default CompletableFuture<GetUsagePlansResponse> getUsagePlans(Consumer<GetUsagePlansRequest.Builder> getUsagePlansRequest) Gets all the usage plans of the caller's account.default CompletableFuture<GetUsagePlansResponse> getUsagePlans(GetUsagePlansRequest getUsagePlansRequest) Gets all the usage plans of the caller's account.default GetUsagePlansPublisherThis is a variant ofgetUsagePlans(software.amazon.awssdk.services.apigateway.model.GetUsagePlansRequest)operation.default GetUsagePlansPublishergetUsagePlansPaginator(Consumer<GetUsagePlansRequest.Builder> getUsagePlansRequest) This is a variant ofgetUsagePlans(software.amazon.awssdk.services.apigateway.model.GetUsagePlansRequest)operation.default GetUsagePlansPublishergetUsagePlansPaginator(GetUsagePlansRequest getUsagePlansRequest) This is a variant ofgetUsagePlans(software.amazon.awssdk.services.apigateway.model.GetUsagePlansRequest)operation.default CompletableFuture<GetVpcLinkResponse> getVpcLink(Consumer<GetVpcLinkRequest.Builder> getVpcLinkRequest) Gets a specified VPC link under the caller's account in a region.default CompletableFuture<GetVpcLinkResponse> getVpcLink(GetVpcLinkRequest getVpcLinkRequest) Gets a specified VPC link under the caller's account in a region.default CompletableFuture<GetVpcLinksResponse> Gets the VpcLinks collection under the caller's account in a selected region.default CompletableFuture<GetVpcLinksResponse> getVpcLinks(Consumer<GetVpcLinksRequest.Builder> getVpcLinksRequest) Gets the VpcLinks collection under the caller's account in a selected region.default CompletableFuture<GetVpcLinksResponse> getVpcLinks(GetVpcLinksRequest getVpcLinksRequest) Gets the VpcLinks collection under the caller's account in a selected region.default GetVpcLinksPublisherThis is a variant ofgetVpcLinks(software.amazon.awssdk.services.apigateway.model.GetVpcLinksRequest)operation.default GetVpcLinksPublishergetVpcLinksPaginator(Consumer<GetVpcLinksRequest.Builder> getVpcLinksRequest) This is a variant ofgetVpcLinks(software.amazon.awssdk.services.apigateway.model.GetVpcLinksRequest)operation.default GetVpcLinksPublishergetVpcLinksPaginator(GetVpcLinksRequest getVpcLinksRequest) This is a variant ofgetVpcLinks(software.amazon.awssdk.services.apigateway.model.GetVpcLinksRequest)operation.default CompletableFuture<ImportApiKeysResponse> importApiKeys(Consumer<ImportApiKeysRequest.Builder> importApiKeysRequest) Import API keys from an external source, such as a CSV-formatted file.default CompletableFuture<ImportApiKeysResponse> importApiKeys(ImportApiKeysRequest importApiKeysRequest) Import API keys from an external source, such as a CSV-formatted file.importDocumentationParts(Consumer<ImportDocumentationPartsRequest.Builder> importDocumentationPartsRequest) Imports documentation partsimportDocumentationParts(ImportDocumentationPartsRequest importDocumentationPartsRequest) Imports documentation partsdefault CompletableFuture<ImportRestApiResponse> importRestApi(Consumer<ImportRestApiRequest.Builder> importRestApiRequest) A feature of the API Gateway control service for creating a new API from an external API definition file.default CompletableFuture<ImportRestApiResponse> importRestApi(ImportRestApiRequest importRestApiRequest) A feature of the API Gateway control service for creating a new API from an external API definition file.putGatewayResponse(Consumer<PutGatewayResponseRequest.Builder> putGatewayResponseRequest) Creates a customization of a GatewayResponse of a specified response type and status code on the given RestApi.putGatewayResponse(PutGatewayResponseRequest putGatewayResponseRequest) Creates a customization of a GatewayResponse of a specified response type and status code on the given RestApi.default CompletableFuture<PutIntegrationResponse> putIntegration(Consumer<PutIntegrationRequest.Builder> putIntegrationRequest) Sets up a method's integration.default CompletableFuture<PutIntegrationResponse> putIntegration(PutIntegrationRequest putIntegrationRequest) Sets up a method's integration.putIntegrationResponse(Consumer<PutIntegrationResponseRequest.Builder> putIntegrationResponseRequest) Represents a put integration.putIntegrationResponse(PutIntegrationResponseRequest putIntegrationResponseRequest) Represents a put integration.default CompletableFuture<PutMethodResponse> putMethod(Consumer<PutMethodRequest.Builder> putMethodRequest) Add a method to an existing Resource resource.default CompletableFuture<PutMethodResponse> putMethod(PutMethodRequest putMethodRequest) Add a method to an existing Resource resource.putMethodResponse(Consumer<PutMethodResponseRequest.Builder> putMethodResponseRequest) Adds a MethodResponse to an existing Method resource.putMethodResponse(PutMethodResponseRequest putMethodResponseRequest) Adds a MethodResponse to an existing Method resource.default CompletableFuture<PutRestApiResponse> putRestApi(Consumer<PutRestApiRequest.Builder> putRestApiRequest) A feature of the API Gateway control service for updating an existing API with an input of external API definitions.default CompletableFuture<PutRestApiResponse> putRestApi(PutRestApiRequest putRestApiRequest) A feature of the API Gateway control service for updating an existing API with an input of external API definitions.The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfigurationdefault CompletableFuture<TagResourceResponse> tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) Adds or updates a tag on a given resource.default CompletableFuture<TagResourceResponse> tagResource(TagResourceRequest tagResourceRequest) Adds or updates a tag on a given resource.testInvokeAuthorizer(Consumer<TestInvokeAuthorizerRequest.Builder> testInvokeAuthorizerRequest) Simulate the execution of an Authorizer in your RestApi with headers, parameters, and an incoming request body.testInvokeAuthorizer(TestInvokeAuthorizerRequest testInvokeAuthorizerRequest) Simulate the execution of an Authorizer in your RestApi with headers, parameters, and an incoming request body.testInvokeMethod(Consumer<TestInvokeMethodRequest.Builder> testInvokeMethodRequest) Simulate the invocation of a Method in your RestApi with headers, parameters, and an incoming request body.testInvokeMethod(TestInvokeMethodRequest testInvokeMethodRequest) Simulate the invocation of a Method in your RestApi with headers, parameters, and an incoming request body.default CompletableFuture<UntagResourceResponse> untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) Removes a tag from a given resource.default CompletableFuture<UntagResourceResponse> untagResource(UntagResourceRequest untagResourceRequest) Removes a tag from a given resource.default CompletableFuture<UpdateAccountResponse> updateAccount(Consumer<UpdateAccountRequest.Builder> updateAccountRequest) Changes information about the current Account resource.default CompletableFuture<UpdateAccountResponse> updateAccount(UpdateAccountRequest updateAccountRequest) Changes information about the current Account resource.default CompletableFuture<UpdateApiKeyResponse> updateApiKey(Consumer<UpdateApiKeyRequest.Builder> updateApiKeyRequest) Changes information about an ApiKey resource.default CompletableFuture<UpdateApiKeyResponse> updateApiKey(UpdateApiKeyRequest updateApiKeyRequest) Changes information about an ApiKey resource.updateAuthorizer(Consumer<UpdateAuthorizerRequest.Builder> updateAuthorizerRequest) Updates an existing Authorizer resource.updateAuthorizer(UpdateAuthorizerRequest updateAuthorizerRequest) Updates an existing Authorizer resource.updateBasePathMapping(Consumer<UpdateBasePathMappingRequest.Builder> updateBasePathMappingRequest) Changes information about the BasePathMapping resource.updateBasePathMapping(UpdateBasePathMappingRequest updateBasePathMappingRequest) Changes information about the BasePathMapping resource.updateClientCertificate(Consumer<UpdateClientCertificateRequest.Builder> updateClientCertificateRequest) Changes information about an ClientCertificate resource.updateClientCertificate(UpdateClientCertificateRequest updateClientCertificateRequest) Changes information about an ClientCertificate resource.updateDeployment(Consumer<UpdateDeploymentRequest.Builder> updateDeploymentRequest) Changes information about a Deployment resource.updateDeployment(UpdateDeploymentRequest updateDeploymentRequest) Changes information about a Deployment resource.updateDocumentationPart(Consumer<UpdateDocumentationPartRequest.Builder> updateDocumentationPartRequest) Updates a documentation part.updateDocumentationPart(UpdateDocumentationPartRequest updateDocumentationPartRequest) Updates a documentation part.updateDocumentationVersion(Consumer<UpdateDocumentationVersionRequest.Builder> updateDocumentationVersionRequest) Updates a documentation version.updateDocumentationVersion(UpdateDocumentationVersionRequest updateDocumentationVersionRequest) Updates a documentation version.updateDomainName(Consumer<UpdateDomainNameRequest.Builder> updateDomainNameRequest) Changes information about the DomainName resource.updateDomainName(UpdateDomainNameRequest updateDomainNameRequest) Changes information about the DomainName resource.updateGatewayResponse(Consumer<UpdateGatewayResponseRequest.Builder> updateGatewayResponseRequest) Updates a GatewayResponse of a specified response type on the given RestApi.updateGatewayResponse(UpdateGatewayResponseRequest updateGatewayResponseRequest) Updates a GatewayResponse of a specified response type on the given RestApi.updateIntegration(Consumer<UpdateIntegrationRequest.Builder> updateIntegrationRequest) Represents an update integration.updateIntegration(UpdateIntegrationRequest updateIntegrationRequest) Represents an update integration.updateIntegrationResponse(Consumer<UpdateIntegrationResponseRequest.Builder> updateIntegrationResponseRequest) Represents an update integration response.updateIntegrationResponse(UpdateIntegrationResponseRequest updateIntegrationResponseRequest) Represents an update integration response.default CompletableFuture<UpdateMethodResponse> updateMethod(Consumer<UpdateMethodRequest.Builder> updateMethodRequest) Updates an existing Method resource.default CompletableFuture<UpdateMethodResponse> updateMethod(UpdateMethodRequest updateMethodRequest) Updates an existing Method resource.updateMethodResponse(Consumer<UpdateMethodResponseRequest.Builder> updateMethodResponseRequest) Updates an existing MethodResponse resource.updateMethodResponse(UpdateMethodResponseRequest updateMethodResponseRequest) Updates an existing MethodResponse resource.default CompletableFuture<UpdateModelResponse> updateModel(Consumer<UpdateModelRequest.Builder> updateModelRequest) Changes information about a model.default CompletableFuture<UpdateModelResponse> updateModel(UpdateModelRequest updateModelRequest) Changes information about a model.updateRequestValidator(Consumer<UpdateRequestValidatorRequest.Builder> updateRequestValidatorRequest) Updates a RequestValidator of a given RestApi.updateRequestValidator(UpdateRequestValidatorRequest updateRequestValidatorRequest) Updates a RequestValidator of a given RestApi.default CompletableFuture<UpdateResourceResponse> updateResource(Consumer<UpdateResourceRequest.Builder> updateResourceRequest) Changes information about a Resource resource.default CompletableFuture<UpdateResourceResponse> updateResource(UpdateResourceRequest updateResourceRequest) Changes information about a Resource resource.default CompletableFuture<UpdateRestApiResponse> updateRestApi(Consumer<UpdateRestApiRequest.Builder> updateRestApiRequest) Changes information about the specified API.default CompletableFuture<UpdateRestApiResponse> updateRestApi(UpdateRestApiRequest updateRestApiRequest) Changes information about the specified API.default CompletableFuture<UpdateStageResponse> updateStage(Consumer<UpdateStageRequest.Builder> updateStageRequest) Changes information about a Stage resource.default CompletableFuture<UpdateStageResponse> updateStage(UpdateStageRequest updateStageRequest) Changes information about a Stage resource.default CompletableFuture<UpdateUsageResponse> updateUsage(Consumer<UpdateUsageRequest.Builder> updateUsageRequest) Grants a temporary extension to the remaining quota of a usage plan associated with a specified API key.default CompletableFuture<UpdateUsageResponse> updateUsage(UpdateUsageRequest updateUsageRequest) Grants a temporary extension to the remaining quota of a usage plan associated with a specified API key.default CompletableFuture<UpdateUsagePlanResponse> updateUsagePlan(Consumer<UpdateUsagePlanRequest.Builder> updateUsagePlanRequest) Updates a usage plan of a given plan Id.default CompletableFuture<UpdateUsagePlanResponse> updateUsagePlan(UpdateUsagePlanRequest updateUsagePlanRequest) Updates a usage plan of a given plan Id.default CompletableFuture<UpdateVpcLinkResponse> updateVpcLink(Consumer<UpdateVpcLinkRequest.Builder> updateVpcLinkRequest) Updates an existing VpcLink of a specified identifier.default CompletableFuture<UpdateVpcLinkResponse> updateVpcLink(UpdateVpcLinkRequest updateVpcLinkRequest) Updates an existing VpcLink of a specified identifier.Methods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable
closeMethods inherited from interface software.amazon.awssdk.core.SdkClient
serviceName
-
Field Details
-
SERVICE_NAME
- See Also:
-
SERVICE_METADATA_ID
Value for looking up the service's metadata from theServiceMetadataProvider.- See Also:
-
-
Method Details
-
createApiKey
default CompletableFuture<CreateApiKeyResponse> createApiKey(CreateApiKeyRequest createApiKeyRequest) Create an ApiKey resource.
- Parameters:
createApiKeyRequest- Request to create an ApiKey resource.- Returns:
- A Java Future containing the result of the CreateApiKey operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
createApiKey
default CompletableFuture<CreateApiKeyResponse> createApiKey(Consumer<CreateApiKeyRequest.Builder> createApiKeyRequest) Create an ApiKey resource.
This is a convenience which creates an instance of the
CreateApiKeyRequest.Builderavoiding the need to create one manually viaCreateApiKeyRequest.builder()- Parameters:
createApiKeyRequest- AConsumerthat will call methods onCreateApiKeyRequest.Builderto create a request. Request to create an ApiKey resource.- Returns:
- A Java Future containing the result of the CreateApiKey operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
createApiKey
Create an ApiKey resource.
- Returns:
- A Java Future containing the result of the CreateApiKey operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
createAuthorizer
default CompletableFuture<CreateAuthorizerResponse> createAuthorizer(CreateAuthorizerRequest createAuthorizerRequest) Adds a new Authorizer resource to an existing RestApi resource.
- Parameters:
createAuthorizerRequest- Request to add a new Authorizer to an existing RestApi resource.- Returns:
- A Java Future containing the result of the CreateAuthorizer operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
createAuthorizer
default CompletableFuture<CreateAuthorizerResponse> createAuthorizer(Consumer<CreateAuthorizerRequest.Builder> createAuthorizerRequest) Adds a new Authorizer resource to an existing RestApi resource.
This is a convenience which creates an instance of the
CreateAuthorizerRequest.Builderavoiding the need to create one manually viaCreateAuthorizerRequest.builder()- Parameters:
createAuthorizerRequest- AConsumerthat will call methods onCreateAuthorizerRequest.Builderto create a request. Request to add a new Authorizer to an existing RestApi resource.- Returns:
- A Java Future containing the result of the CreateAuthorizer operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
createBasePathMapping
default CompletableFuture<CreateBasePathMappingResponse> createBasePathMapping(CreateBasePathMappingRequest createBasePathMappingRequest) Creates a new BasePathMapping resource.
- Parameters:
createBasePathMappingRequest- Requests API Gateway to create a new BasePathMapping resource.- Returns:
- A Java Future containing the result of the CreateBasePathMapping operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
createBasePathMapping
default CompletableFuture<CreateBasePathMappingResponse> createBasePathMapping(Consumer<CreateBasePathMappingRequest.Builder> createBasePathMappingRequest) Creates a new BasePathMapping resource.
This is a convenience which creates an instance of the
CreateBasePathMappingRequest.Builderavoiding the need to create one manually viaCreateBasePathMappingRequest.builder()- Parameters:
createBasePathMappingRequest- AConsumerthat will call methods onCreateBasePathMappingRequest.Builderto create a request. Requests API Gateway to create a new BasePathMapping resource.- Returns:
- A Java Future containing the result of the CreateBasePathMapping operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
createDeployment
default CompletableFuture<CreateDeploymentResponse> createDeployment(CreateDeploymentRequest createDeploymentRequest) Creates a Deployment resource, which makes a specified RestApi callable over the internet.
- Parameters:
createDeploymentRequest- Requests API Gateway to create a Deployment resource.- Returns:
- A Java Future containing the result of the CreateDeployment operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- ServiceUnavailableException The requested service is not available. For details see the accompanying error message. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
createDeployment
default CompletableFuture<CreateDeploymentResponse> createDeployment(Consumer<CreateDeploymentRequest.Builder> createDeploymentRequest) Creates a Deployment resource, which makes a specified RestApi callable over the internet.
This is a convenience which creates an instance of the
CreateDeploymentRequest.Builderavoiding the need to create one manually viaCreateDeploymentRequest.builder()- Parameters:
createDeploymentRequest- AConsumerthat will call methods onCreateDeploymentRequest.Builderto create a request. Requests API Gateway to create a Deployment resource.- Returns:
- A Java Future containing the result of the CreateDeployment operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- ServiceUnavailableException The requested service is not available. For details see the accompanying error message. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
createDocumentationPart
default CompletableFuture<CreateDocumentationPartResponse> createDocumentationPart(CreateDocumentationPartRequest createDocumentationPartRequest) Creates a documentation part.
- Parameters:
createDocumentationPartRequest- Creates a new documentation part of a given API.- Returns:
- A Java Future containing the result of the CreateDocumentationPart operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
createDocumentationPart
default CompletableFuture<CreateDocumentationPartResponse> createDocumentationPart(Consumer<CreateDocumentationPartRequest.Builder> createDocumentationPartRequest) Creates a documentation part.
This is a convenience which creates an instance of the
CreateDocumentationPartRequest.Builderavoiding the need to create one manually viaCreateDocumentationPartRequest.builder()- Parameters:
createDocumentationPartRequest- AConsumerthat will call methods onCreateDocumentationPartRequest.Builderto create a request. Creates a new documentation part of a given API.- Returns:
- A Java Future containing the result of the CreateDocumentationPart operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
createDocumentationVersion
default CompletableFuture<CreateDocumentationVersionResponse> createDocumentationVersion(CreateDocumentationVersionRequest createDocumentationVersionRequest) Creates a documentation version
- Parameters:
createDocumentationVersionRequest- Creates a new documentation version of a given API.- Returns:
- A Java Future containing the result of the CreateDocumentationVersion operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
createDocumentationVersion
default CompletableFuture<CreateDocumentationVersionResponse> createDocumentationVersion(Consumer<CreateDocumentationVersionRequest.Builder> createDocumentationVersionRequest) Creates a documentation version
This is a convenience which creates an instance of the
CreateDocumentationVersionRequest.Builderavoiding the need to create one manually viaCreateDocumentationVersionRequest.builder()- Parameters:
createDocumentationVersionRequest- AConsumerthat will call methods onCreateDocumentationVersionRequest.Builderto create a request. Creates a new documentation version of a given API.- Returns:
- A Java Future containing the result of the CreateDocumentationVersion operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
createDomainName
default CompletableFuture<CreateDomainNameResponse> createDomainName(CreateDomainNameRequest createDomainNameRequest) Creates a new domain name.
- Parameters:
createDomainNameRequest- A request to create a new domain name.- Returns:
- A Java Future containing the result of the CreateDomainName operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
createDomainName
default CompletableFuture<CreateDomainNameResponse> createDomainName(Consumer<CreateDomainNameRequest.Builder> createDomainNameRequest) Creates a new domain name.
This is a convenience which creates an instance of the
CreateDomainNameRequest.Builderavoiding the need to create one manually viaCreateDomainNameRequest.builder()- Parameters:
createDomainNameRequest- AConsumerthat will call methods onCreateDomainNameRequest.Builderto create a request. A request to create a new domain name.- Returns:
- A Java Future containing the result of the CreateDomainName operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
createModel
Adds a new Model resource to an existing RestApi resource.
- Parameters:
createModelRequest- Request to add a new Model to an existing RestApi resource.- Returns:
- A Java Future containing the result of the CreateModel operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
createModel
default CompletableFuture<CreateModelResponse> createModel(Consumer<CreateModelRequest.Builder> createModelRequest) Adds a new Model resource to an existing RestApi resource.
This is a convenience which creates an instance of the
CreateModelRequest.Builderavoiding the need to create one manually viaCreateModelRequest.builder()- Parameters:
createModelRequest- AConsumerthat will call methods onCreateModelRequest.Builderto create a request. Request to add a new Model to an existing RestApi resource.- Returns:
- A Java Future containing the result of the CreateModel operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
createRequestValidator
default CompletableFuture<CreateRequestValidatorResponse> createRequestValidator(CreateRequestValidatorRequest createRequestValidatorRequest) Creates a RequestValidator of a given RestApi.
- Parameters:
createRequestValidatorRequest- Creates a RequestValidator of a given RestApi.- Returns:
- A Java Future containing the result of the CreateRequestValidator operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
createRequestValidator
default CompletableFuture<CreateRequestValidatorResponse> createRequestValidator(Consumer<CreateRequestValidatorRequest.Builder> createRequestValidatorRequest) Creates a RequestValidator of a given RestApi.
This is a convenience which creates an instance of the
CreateRequestValidatorRequest.Builderavoiding the need to create one manually viaCreateRequestValidatorRequest.builder()- Parameters:
createRequestValidatorRequest- AConsumerthat will call methods onCreateRequestValidatorRequest.Builderto create a request. Creates a RequestValidator of a given RestApi.- Returns:
- A Java Future containing the result of the CreateRequestValidator operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
createResource
default CompletableFuture<CreateResourceResponse> createResource(CreateResourceRequest createResourceRequest) Creates a Resource resource.
- Parameters:
createResourceRequest- Requests API Gateway to create a Resource resource.- Returns:
- A Java Future containing the result of the CreateResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
createResource
default CompletableFuture<CreateResourceResponse> createResource(Consumer<CreateResourceRequest.Builder> createResourceRequest) Creates a Resource resource.
This is a convenience which creates an instance of the
CreateResourceRequest.Builderavoiding the need to create one manually viaCreateResourceRequest.builder()- Parameters:
createResourceRequest- AConsumerthat will call methods onCreateResourceRequest.Builderto create a request. Requests API Gateway to create a Resource resource.- Returns:
- A Java Future containing the result of the CreateResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
createRestApi
default CompletableFuture<CreateRestApiResponse> createRestApi(CreateRestApiRequest createRestApiRequest) Creates a new RestApi resource.
- Parameters:
createRestApiRequest- The POST Request to add a new RestApi resource to your collection.- Returns:
- A Java Future containing the result of the CreateRestApi operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
createRestApi
default CompletableFuture<CreateRestApiResponse> createRestApi(Consumer<CreateRestApiRequest.Builder> createRestApiRequest) Creates a new RestApi resource.
This is a convenience which creates an instance of the
CreateRestApiRequest.Builderavoiding the need to create one manually viaCreateRestApiRequest.builder()- Parameters:
createRestApiRequest- AConsumerthat will call methods onCreateRestApiRequest.Builderto create a request. The POST Request to add a new RestApi resource to your collection.- Returns:
- A Java Future containing the result of the CreateRestApi operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
createStage
Creates a new Stage resource that references a pre-existing Deployment for the API.
- Parameters:
createStageRequest- Requests API Gateway to create a Stage resource.- Returns:
- A Java Future containing the result of the CreateStage operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- UnauthorizedException The request is denied because the caller has insufficient permissions.
- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
createStage
default CompletableFuture<CreateStageResponse> createStage(Consumer<CreateStageRequest.Builder> createStageRequest) Creates a new Stage resource that references a pre-existing Deployment for the API.
This is a convenience which creates an instance of the
CreateStageRequest.Builderavoiding the need to create one manually viaCreateStageRequest.builder()- Parameters:
createStageRequest- AConsumerthat will call methods onCreateStageRequest.Builderto create a request. Requests API Gateway to create a Stage resource.- Returns:
- A Java Future containing the result of the CreateStage operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- UnauthorizedException The request is denied because the caller has insufficient permissions.
- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
createUsagePlan
default CompletableFuture<CreateUsagePlanResponse> createUsagePlan(CreateUsagePlanRequest createUsagePlanRequest) Creates a usage plan with the throttle and quota limits, as well as the associated API stages, specified in the payload.
- Parameters:
createUsagePlanRequest- The POST request to create a usage plan with the name, description, throttle limits and quota limits, as well as the associated API stages, specified in the payload.- Returns:
- A Java Future containing the result of the CreateUsagePlan operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
createUsagePlan
default CompletableFuture<CreateUsagePlanResponse> createUsagePlan(Consumer<CreateUsagePlanRequest.Builder> createUsagePlanRequest) Creates a usage plan with the throttle and quota limits, as well as the associated API stages, specified in the payload.
This is a convenience which creates an instance of the
CreateUsagePlanRequest.Builderavoiding the need to create one manually viaCreateUsagePlanRequest.builder()- Parameters:
createUsagePlanRequest- AConsumerthat will call methods onCreateUsagePlanRequest.Builderto create a request. The POST request to create a usage plan with the name, description, throttle limits and quota limits, as well as the associated API stages, specified in the payload.- Returns:
- A Java Future containing the result of the CreateUsagePlan operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
createUsagePlanKey
default CompletableFuture<CreateUsagePlanKeyResponse> createUsagePlanKey(CreateUsagePlanKeyRequest createUsagePlanKeyRequest) Creates a usage plan key for adding an existing API key to a usage plan.
- Parameters:
createUsagePlanKeyRequest- The POST request to create a usage plan key for adding an existing API key to a usage plan.- Returns:
- A Java Future containing the result of the CreateUsagePlanKey operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
createUsagePlanKey
default CompletableFuture<CreateUsagePlanKeyResponse> createUsagePlanKey(Consumer<CreateUsagePlanKeyRequest.Builder> createUsagePlanKeyRequest) Creates a usage plan key for adding an existing API key to a usage plan.
This is a convenience which creates an instance of the
CreateUsagePlanKeyRequest.Builderavoiding the need to create one manually viaCreateUsagePlanKeyRequest.builder()- Parameters:
createUsagePlanKeyRequest- AConsumerthat will call methods onCreateUsagePlanKeyRequest.Builderto create a request. The POST request to create a usage plan key for adding an existing API key to a usage plan.- Returns:
- A Java Future containing the result of the CreateUsagePlanKey operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
createVpcLink
default CompletableFuture<CreateVpcLinkResponse> createVpcLink(CreateVpcLinkRequest createVpcLinkRequest) Creates a VPC link, under the caller's account in a selected region, in an asynchronous operation that typically takes 2-4 minutes to complete and become operational. The caller must have permissions to create and update VPC Endpoint services.
- Parameters:
createVpcLinkRequest- Creates a VPC link, under the caller's account in a selected region, in an asynchronous operation that typically takes 2-4 minutes to complete and become operational. The caller must have permissions to create and update VPC Endpoint services.- Returns:
- A Java Future containing the result of the CreateVpcLink operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
createVpcLink
default CompletableFuture<CreateVpcLinkResponse> createVpcLink(Consumer<CreateVpcLinkRequest.Builder> createVpcLinkRequest) Creates a VPC link, under the caller's account in a selected region, in an asynchronous operation that typically takes 2-4 minutes to complete and become operational. The caller must have permissions to create and update VPC Endpoint services.
This is a convenience which creates an instance of the
CreateVpcLinkRequest.Builderavoiding the need to create one manually viaCreateVpcLinkRequest.builder()- Parameters:
createVpcLinkRequest- AConsumerthat will call methods onCreateVpcLinkRequest.Builderto create a request. Creates a VPC link, under the caller's account in a selected region, in an asynchronous operation that typically takes 2-4 minutes to complete and become operational. The caller must have permissions to create and update VPC Endpoint services.- Returns:
- A Java Future containing the result of the CreateVpcLink operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteApiKey
default CompletableFuture<DeleteApiKeyResponse> deleteApiKey(DeleteApiKeyRequest deleteApiKeyRequest) Deletes the ApiKey resource.
- Parameters:
deleteApiKeyRequest- A request to delete the ApiKey resource.- Returns:
- A Java Future containing the result of the DeleteApiKey operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteApiKey
default CompletableFuture<DeleteApiKeyResponse> deleteApiKey(Consumer<DeleteApiKeyRequest.Builder> deleteApiKeyRequest) Deletes the ApiKey resource.
This is a convenience which creates an instance of the
DeleteApiKeyRequest.Builderavoiding the need to create one manually viaDeleteApiKeyRequest.builder()- Parameters:
deleteApiKeyRequest- AConsumerthat will call methods onDeleteApiKeyRequest.Builderto create a request. A request to delete the ApiKey resource.- Returns:
- A Java Future containing the result of the DeleteApiKey operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteAuthorizer
default CompletableFuture<DeleteAuthorizerResponse> deleteAuthorizer(DeleteAuthorizerRequest deleteAuthorizerRequest) Deletes an existing Authorizer resource.
- Parameters:
deleteAuthorizerRequest- Request to delete an existing Authorizer resource.- Returns:
- A Java Future containing the result of the DeleteAuthorizer operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteAuthorizer
default CompletableFuture<DeleteAuthorizerResponse> deleteAuthorizer(Consumer<DeleteAuthorizerRequest.Builder> deleteAuthorizerRequest) Deletes an existing Authorizer resource.
This is a convenience which creates an instance of the
DeleteAuthorizerRequest.Builderavoiding the need to create one manually viaDeleteAuthorizerRequest.builder()- Parameters:
deleteAuthorizerRequest- AConsumerthat will call methods onDeleteAuthorizerRequest.Builderto create a request. Request to delete an existing Authorizer resource.- Returns:
- A Java Future containing the result of the DeleteAuthorizer operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteBasePathMapping
default CompletableFuture<DeleteBasePathMappingResponse> deleteBasePathMapping(DeleteBasePathMappingRequest deleteBasePathMappingRequest) Deletes the BasePathMapping resource.
- Parameters:
deleteBasePathMappingRequest- A request to delete the BasePathMapping resource.- Returns:
- A Java Future containing the result of the DeleteBasePathMapping operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteBasePathMapping
default CompletableFuture<DeleteBasePathMappingResponse> deleteBasePathMapping(Consumer<DeleteBasePathMappingRequest.Builder> deleteBasePathMappingRequest) Deletes the BasePathMapping resource.
This is a convenience which creates an instance of the
DeleteBasePathMappingRequest.Builderavoiding the need to create one manually viaDeleteBasePathMappingRequest.builder()- Parameters:
deleteBasePathMappingRequest- AConsumerthat will call methods onDeleteBasePathMappingRequest.Builderto create a request. A request to delete the BasePathMapping resource.- Returns:
- A Java Future containing the result of the DeleteBasePathMapping operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteClientCertificate
default CompletableFuture<DeleteClientCertificateResponse> deleteClientCertificate(DeleteClientCertificateRequest deleteClientCertificateRequest) Deletes the ClientCertificate resource.
- Parameters:
deleteClientCertificateRequest- A request to delete the ClientCertificate resource.- Returns:
- A Java Future containing the result of the DeleteClientCertificate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteClientCertificate
default CompletableFuture<DeleteClientCertificateResponse> deleteClientCertificate(Consumer<DeleteClientCertificateRequest.Builder> deleteClientCertificateRequest) Deletes the ClientCertificate resource.
This is a convenience which creates an instance of the
DeleteClientCertificateRequest.Builderavoiding the need to create one manually viaDeleteClientCertificateRequest.builder()- Parameters:
deleteClientCertificateRequest- AConsumerthat will call methods onDeleteClientCertificateRequest.Builderto create a request. A request to delete the ClientCertificate resource.- Returns:
- A Java Future containing the result of the DeleteClientCertificate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteDeployment
default CompletableFuture<DeleteDeploymentResponse> deleteDeployment(DeleteDeploymentRequest deleteDeploymentRequest) Deletes a Deployment resource. Deleting a deployment will only succeed if there are no Stage resources associated with it.
- Parameters:
deleteDeploymentRequest- Requests API Gateway to delete a Deployment resource.- Returns:
- A Java Future containing the result of the DeleteDeployment operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteDeployment
default CompletableFuture<DeleteDeploymentResponse> deleteDeployment(Consumer<DeleteDeploymentRequest.Builder> deleteDeploymentRequest) Deletes a Deployment resource. Deleting a deployment will only succeed if there are no Stage resources associated with it.
This is a convenience which creates an instance of the
DeleteDeploymentRequest.Builderavoiding the need to create one manually viaDeleteDeploymentRequest.builder()- Parameters:
deleteDeploymentRequest- AConsumerthat will call methods onDeleteDeploymentRequest.Builderto create a request. Requests API Gateway to delete a Deployment resource.- Returns:
- A Java Future containing the result of the DeleteDeployment operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteDocumentationPart
default CompletableFuture<DeleteDocumentationPartResponse> deleteDocumentationPart(DeleteDocumentationPartRequest deleteDocumentationPartRequest) Deletes a documentation part
- Parameters:
deleteDocumentationPartRequest- Deletes an existing documentation part of an API.- Returns:
- A Java Future containing the result of the DeleteDocumentationPart operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteDocumentationPart
default CompletableFuture<DeleteDocumentationPartResponse> deleteDocumentationPart(Consumer<DeleteDocumentationPartRequest.Builder> deleteDocumentationPartRequest) Deletes a documentation part
This is a convenience which creates an instance of the
DeleteDocumentationPartRequest.Builderavoiding the need to create one manually viaDeleteDocumentationPartRequest.builder()- Parameters:
deleteDocumentationPartRequest- AConsumerthat will call methods onDeleteDocumentationPartRequest.Builderto create a request. Deletes an existing documentation part of an API.- Returns:
- A Java Future containing the result of the DeleteDocumentationPart operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteDocumentationVersion
default CompletableFuture<DeleteDocumentationVersionResponse> deleteDocumentationVersion(DeleteDocumentationVersionRequest deleteDocumentationVersionRequest) Deletes a documentation version.
- Parameters:
deleteDocumentationVersionRequest- Deletes an existing documentation version of an API.- Returns:
- A Java Future containing the result of the DeleteDocumentationVersion operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteDocumentationVersion
default CompletableFuture<DeleteDocumentationVersionResponse> deleteDocumentationVersion(Consumer<DeleteDocumentationVersionRequest.Builder> deleteDocumentationVersionRequest) Deletes a documentation version.
This is a convenience which creates an instance of the
DeleteDocumentationVersionRequest.Builderavoiding the need to create one manually viaDeleteDocumentationVersionRequest.builder()- Parameters:
deleteDocumentationVersionRequest- AConsumerthat will call methods onDeleteDocumentationVersionRequest.Builderto create a request. Deletes an existing documentation version of an API.- Returns:
- A Java Future containing the result of the DeleteDocumentationVersion operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteDomainName
default CompletableFuture<DeleteDomainNameResponse> deleteDomainName(DeleteDomainNameRequest deleteDomainNameRequest) Deletes the DomainName resource.
- Parameters:
deleteDomainNameRequest- A request to delete the DomainName resource.- Returns:
- A Java Future containing the result of the DeleteDomainName operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteDomainName
default CompletableFuture<DeleteDomainNameResponse> deleteDomainName(Consumer<DeleteDomainNameRequest.Builder> deleteDomainNameRequest) Deletes the DomainName resource.
This is a convenience which creates an instance of the
DeleteDomainNameRequest.Builderavoiding the need to create one manually viaDeleteDomainNameRequest.builder()- Parameters:
deleteDomainNameRequest- AConsumerthat will call methods onDeleteDomainNameRequest.Builderto create a request. A request to delete the DomainName resource.- Returns:
- A Java Future containing the result of the DeleteDomainName operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteGatewayResponse
default CompletableFuture<DeleteGatewayResponseResponse> deleteGatewayResponse(DeleteGatewayResponseRequest deleteGatewayResponseRequest) Clears any customization of a GatewayResponse of a specified response type on the given RestApi and resets it with the default settings.
- Parameters:
deleteGatewayResponseRequest- Clears any customization of a GatewayResponse of a specified response type on the given RestApi and resets it with the default settings.- Returns:
- A Java Future containing the result of the DeleteGatewayResponse operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteGatewayResponse
default CompletableFuture<DeleteGatewayResponseResponse> deleteGatewayResponse(Consumer<DeleteGatewayResponseRequest.Builder> deleteGatewayResponseRequest) Clears any customization of a GatewayResponse of a specified response type on the given RestApi and resets it with the default settings.
This is a convenience which creates an instance of the
DeleteGatewayResponseRequest.Builderavoiding the need to create one manually viaDeleteGatewayResponseRequest.builder()- Parameters:
deleteGatewayResponseRequest- AConsumerthat will call methods onDeleteGatewayResponseRequest.Builderto create a request. Clears any customization of a GatewayResponse of a specified response type on the given RestApi and resets it with the default settings.- Returns:
- A Java Future containing the result of the DeleteGatewayResponse operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteIntegration
default CompletableFuture<DeleteIntegrationResponse> deleteIntegration(DeleteIntegrationRequest deleteIntegrationRequest) Represents a delete integration.
- Parameters:
deleteIntegrationRequest- Represents a delete integration request.- Returns:
- A Java Future containing the result of the DeleteIntegration operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteIntegration
default CompletableFuture<DeleteIntegrationResponse> deleteIntegration(Consumer<DeleteIntegrationRequest.Builder> deleteIntegrationRequest) Represents a delete integration.
This is a convenience which creates an instance of the
DeleteIntegrationRequest.Builderavoiding the need to create one manually viaDeleteIntegrationRequest.builder()- Parameters:
deleteIntegrationRequest- AConsumerthat will call methods onDeleteIntegrationRequest.Builderto create a request. Represents a delete integration request.- Returns:
- A Java Future containing the result of the DeleteIntegration operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteIntegrationResponse
default CompletableFuture<DeleteIntegrationResponseResponse> deleteIntegrationResponse(DeleteIntegrationResponseRequest deleteIntegrationResponseRequest) Represents a delete integration response.
- Parameters:
deleteIntegrationResponseRequest- Represents a delete integration response request.- Returns:
- A Java Future containing the result of the DeleteIntegrationResponse operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteIntegrationResponse
default CompletableFuture<DeleteIntegrationResponseResponse> deleteIntegrationResponse(Consumer<DeleteIntegrationResponseRequest.Builder> deleteIntegrationResponseRequest) Represents a delete integration response.
This is a convenience which creates an instance of the
DeleteIntegrationResponseRequest.Builderavoiding the need to create one manually viaDeleteIntegrationResponseRequest.builder()- Parameters:
deleteIntegrationResponseRequest- AConsumerthat will call methods onDeleteIntegrationResponseRequest.Builderto create a request. Represents a delete integration response request.- Returns:
- A Java Future containing the result of the DeleteIntegrationResponse operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteMethod
default CompletableFuture<DeleteMethodResponse> deleteMethod(DeleteMethodRequest deleteMethodRequest) Deletes an existing Method resource.
- Parameters:
deleteMethodRequest- Request to delete an existing Method resource.- Returns:
- A Java Future containing the result of the DeleteMethod operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteMethod
default CompletableFuture<DeleteMethodResponse> deleteMethod(Consumer<DeleteMethodRequest.Builder> deleteMethodRequest) Deletes an existing Method resource.
This is a convenience which creates an instance of the
DeleteMethodRequest.Builderavoiding the need to create one manually viaDeleteMethodRequest.builder()- Parameters:
deleteMethodRequest- AConsumerthat will call methods onDeleteMethodRequest.Builderto create a request. Request to delete an existing Method resource.- Returns:
- A Java Future containing the result of the DeleteMethod operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteMethodResponse
default CompletableFuture<DeleteMethodResponseResponse> deleteMethodResponse(DeleteMethodResponseRequest deleteMethodResponseRequest) Deletes an existing MethodResponse resource.
- Parameters:
deleteMethodResponseRequest- A request to delete an existing MethodResponse resource.- Returns:
- A Java Future containing the result of the DeleteMethodResponse operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteMethodResponse
default CompletableFuture<DeleteMethodResponseResponse> deleteMethodResponse(Consumer<DeleteMethodResponseRequest.Builder> deleteMethodResponseRequest) Deletes an existing MethodResponse resource.
This is a convenience which creates an instance of the
DeleteMethodResponseRequest.Builderavoiding the need to create one manually viaDeleteMethodResponseRequest.builder()- Parameters:
deleteMethodResponseRequest- AConsumerthat will call methods onDeleteMethodResponseRequest.Builderto create a request. A request to delete an existing MethodResponse resource.- Returns:
- A Java Future containing the result of the DeleteMethodResponse operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteModel
Deletes a model.
- Parameters:
deleteModelRequest- Request to delete an existing model in an existing RestApi resource.- Returns:
- A Java Future containing the result of the DeleteModel operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteModel
default CompletableFuture<DeleteModelResponse> deleteModel(Consumer<DeleteModelRequest.Builder> deleteModelRequest) Deletes a model.
This is a convenience which creates an instance of the
DeleteModelRequest.Builderavoiding the need to create one manually viaDeleteModelRequest.builder()- Parameters:
deleteModelRequest- AConsumerthat will call methods onDeleteModelRequest.Builderto create a request. Request to delete an existing model in an existing RestApi resource.- Returns:
- A Java Future containing the result of the DeleteModel operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteRequestValidator
default CompletableFuture<DeleteRequestValidatorResponse> deleteRequestValidator(DeleteRequestValidatorRequest deleteRequestValidatorRequest) Deletes a RequestValidator of a given RestApi.
- Parameters:
deleteRequestValidatorRequest- Deletes a specified RequestValidator of a given RestApi.- Returns:
- A Java Future containing the result of the DeleteRequestValidator operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteRequestValidator
default CompletableFuture<DeleteRequestValidatorResponse> deleteRequestValidator(Consumer<DeleteRequestValidatorRequest.Builder> deleteRequestValidatorRequest) Deletes a RequestValidator of a given RestApi.
This is a convenience which creates an instance of the
DeleteRequestValidatorRequest.Builderavoiding the need to create one manually viaDeleteRequestValidatorRequest.builder()- Parameters:
deleteRequestValidatorRequest- AConsumerthat will call methods onDeleteRequestValidatorRequest.Builderto create a request. Deletes a specified RequestValidator of a given RestApi.- Returns:
- A Java Future containing the result of the DeleteRequestValidator operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteResource
default CompletableFuture<DeleteResourceResponse> deleteResource(DeleteResourceRequest deleteResourceRequest) Deletes a Resource resource.
- Parameters:
deleteResourceRequest- Request to delete a Resource.- Returns:
- A Java Future containing the result of the DeleteResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteResource
default CompletableFuture<DeleteResourceResponse> deleteResource(Consumer<DeleteResourceRequest.Builder> deleteResourceRequest) Deletes a Resource resource.
This is a convenience which creates an instance of the
DeleteResourceRequest.Builderavoiding the need to create one manually viaDeleteResourceRequest.builder()- Parameters:
deleteResourceRequest- AConsumerthat will call methods onDeleteResourceRequest.Builderto create a request. Request to delete a Resource.- Returns:
- A Java Future containing the result of the DeleteResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteRestApi
default CompletableFuture<DeleteRestApiResponse> deleteRestApi(DeleteRestApiRequest deleteRestApiRequest) Deletes the specified API.
- Parameters:
deleteRestApiRequest- Request to delete the specified API from your collection.- Returns:
- A Java Future containing the result of the DeleteRestApi operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteRestApi
default CompletableFuture<DeleteRestApiResponse> deleteRestApi(Consumer<DeleteRestApiRequest.Builder> deleteRestApiRequest) Deletes the specified API.
This is a convenience which creates an instance of the
DeleteRestApiRequest.Builderavoiding the need to create one manually viaDeleteRestApiRequest.builder()- Parameters:
deleteRestApiRequest- AConsumerthat will call methods onDeleteRestApiRequest.Builderto create a request. Request to delete the specified API from your collection.- Returns:
- A Java Future containing the result of the DeleteRestApi operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteStage
Deletes a Stage resource.
- Parameters:
deleteStageRequest- Requests API Gateway to delete a Stage resource.- Returns:
- A Java Future containing the result of the DeleteStage operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteStage
default CompletableFuture<DeleteStageResponse> deleteStage(Consumer<DeleteStageRequest.Builder> deleteStageRequest) Deletes a Stage resource.
This is a convenience which creates an instance of the
DeleteStageRequest.Builderavoiding the need to create one manually viaDeleteStageRequest.builder()- Parameters:
deleteStageRequest- AConsumerthat will call methods onDeleteStageRequest.Builderto create a request. Requests API Gateway to delete a Stage resource.- Returns:
- A Java Future containing the result of the DeleteStage operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteUsagePlan
default CompletableFuture<DeleteUsagePlanResponse> deleteUsagePlan(DeleteUsagePlanRequest deleteUsagePlanRequest) Deletes a usage plan of a given plan Id.
- Parameters:
deleteUsagePlanRequest- The DELETE request to delete a usage plan of a given plan Id.- Returns:
- A Java Future containing the result of the DeleteUsagePlan operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteUsagePlan
default CompletableFuture<DeleteUsagePlanResponse> deleteUsagePlan(Consumer<DeleteUsagePlanRequest.Builder> deleteUsagePlanRequest) Deletes a usage plan of a given plan Id.
This is a convenience which creates an instance of the
DeleteUsagePlanRequest.Builderavoiding the need to create one manually viaDeleteUsagePlanRequest.builder()- Parameters:
deleteUsagePlanRequest- AConsumerthat will call methods onDeleteUsagePlanRequest.Builderto create a request. The DELETE request to delete a usage plan of a given plan Id.- Returns:
- A Java Future containing the result of the DeleteUsagePlan operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteUsagePlanKey
default CompletableFuture<DeleteUsagePlanKeyResponse> deleteUsagePlanKey(DeleteUsagePlanKeyRequest deleteUsagePlanKeyRequest) Deletes a usage plan key and remove the underlying API key from the associated usage plan.
- Parameters:
deleteUsagePlanKeyRequest- The DELETE request to delete a usage plan key and remove the underlying API key from the associated usage plan.- Returns:
- A Java Future containing the result of the DeleteUsagePlanKey operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteUsagePlanKey
default CompletableFuture<DeleteUsagePlanKeyResponse> deleteUsagePlanKey(Consumer<DeleteUsagePlanKeyRequest.Builder> deleteUsagePlanKeyRequest) Deletes a usage plan key and remove the underlying API key from the associated usage plan.
This is a convenience which creates an instance of the
DeleteUsagePlanKeyRequest.Builderavoiding the need to create one manually viaDeleteUsagePlanKeyRequest.builder()- Parameters:
deleteUsagePlanKeyRequest- AConsumerthat will call methods onDeleteUsagePlanKeyRequest.Builderto create a request. The DELETE request to delete a usage plan key and remove the underlying API key from the associated usage plan.- Returns:
- A Java Future containing the result of the DeleteUsagePlanKey operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteVpcLink
default CompletableFuture<DeleteVpcLinkResponse> deleteVpcLink(DeleteVpcLinkRequest deleteVpcLinkRequest) Deletes an existing VpcLink of a specified identifier.
- Parameters:
deleteVpcLinkRequest- Deletes an existing VpcLink of a specified identifier.- Returns:
- A Java Future containing the result of the DeleteVpcLink operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
deleteVpcLink
default CompletableFuture<DeleteVpcLinkResponse> deleteVpcLink(Consumer<DeleteVpcLinkRequest.Builder> deleteVpcLinkRequest) Deletes an existing VpcLink of a specified identifier.
This is a convenience which creates an instance of the
DeleteVpcLinkRequest.Builderavoiding the need to create one manually viaDeleteVpcLinkRequest.builder()- Parameters:
deleteVpcLinkRequest- AConsumerthat will call methods onDeleteVpcLinkRequest.Builderto create a request. Deletes an existing VpcLink of a specified identifier.- Returns:
- A Java Future containing the result of the DeleteVpcLink operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
flushStageAuthorizersCache
default CompletableFuture<FlushStageAuthorizersCacheResponse> flushStageAuthorizersCache(FlushStageAuthorizersCacheRequest flushStageAuthorizersCacheRequest) Flushes all authorizer cache entries on a stage.
- Parameters:
flushStageAuthorizersCacheRequest- Request to flush authorizer cache entries on a specified stage.- Returns:
- A Java Future containing the result of the FlushStageAuthorizersCache operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
flushStageAuthorizersCache
default CompletableFuture<FlushStageAuthorizersCacheResponse> flushStageAuthorizersCache(Consumer<FlushStageAuthorizersCacheRequest.Builder> flushStageAuthorizersCacheRequest) Flushes all authorizer cache entries on a stage.
This is a convenience which creates an instance of the
FlushStageAuthorizersCacheRequest.Builderavoiding the need to create one manually viaFlushStageAuthorizersCacheRequest.builder()- Parameters:
flushStageAuthorizersCacheRequest- AConsumerthat will call methods onFlushStageAuthorizersCacheRequest.Builderto create a request. Request to flush authorizer cache entries on a specified stage.- Returns:
- A Java Future containing the result of the FlushStageAuthorizersCache operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
flushStageCache
default CompletableFuture<FlushStageCacheResponse> flushStageCache(FlushStageCacheRequest flushStageCacheRequest) Flushes a stage's cache.
- Parameters:
flushStageCacheRequest- Requests API Gateway to flush a stage's cache.- Returns:
- A Java Future containing the result of the FlushStageCache operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
flushStageCache
default CompletableFuture<FlushStageCacheResponse> flushStageCache(Consumer<FlushStageCacheRequest.Builder> flushStageCacheRequest) Flushes a stage's cache.
This is a convenience which creates an instance of the
FlushStageCacheRequest.Builderavoiding the need to create one manually viaFlushStageCacheRequest.builder()- Parameters:
flushStageCacheRequest- AConsumerthat will call methods onFlushStageCacheRequest.Builderto create a request. Requests API Gateway to flush a stage's cache.- Returns:
- A Java Future containing the result of the FlushStageCache operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
generateClientCertificate
default CompletableFuture<GenerateClientCertificateResponse> generateClientCertificate(GenerateClientCertificateRequest generateClientCertificateRequest) Generates a ClientCertificate resource.
- Parameters:
generateClientCertificateRequest- A request to generate a ClientCertificate resource.- Returns:
- A Java Future containing the result of the GenerateClientCertificate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
generateClientCertificate
default CompletableFuture<GenerateClientCertificateResponse> generateClientCertificate(Consumer<GenerateClientCertificateRequest.Builder> generateClientCertificateRequest) Generates a ClientCertificate resource.
This is a convenience which creates an instance of the
GenerateClientCertificateRequest.Builderavoiding the need to create one manually viaGenerateClientCertificateRequest.builder()- Parameters:
generateClientCertificateRequest- AConsumerthat will call methods onGenerateClientCertificateRequest.Builderto create a request. A request to generate a ClientCertificate resource.- Returns:
- A Java Future containing the result of the GenerateClientCertificate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
generateClientCertificate
Generates a ClientCertificate resource.
- Returns:
- A Java Future containing the result of the GenerateClientCertificate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getAccount
Gets information about the current Account resource.
- Parameters:
getAccountRequest- Requests API Gateway to get information about the current Account resource.- Returns:
- A Java Future containing the result of the GetAccount operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getAccount
default CompletableFuture<GetAccountResponse> getAccount(Consumer<GetAccountRequest.Builder> getAccountRequest) Gets information about the current Account resource.
This is a convenience which creates an instance of the
GetAccountRequest.Builderavoiding the need to create one manually viaGetAccountRequest.builder()- Parameters:
getAccountRequest- AConsumerthat will call methods onGetAccountRequest.Builderto create a request. Requests API Gateway to get information about the current Account resource.- Returns:
- A Java Future containing the result of the GetAccount operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getAccount
Gets information about the current Account resource.
- Returns:
- A Java Future containing the result of the GetAccount operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getApiKey
Gets information about the current ApiKey resource.
- Parameters:
getApiKeyRequest- A request to get information about the current ApiKey resource.- Returns:
- A Java Future containing the result of the GetApiKey operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getApiKey
default CompletableFuture<GetApiKeyResponse> getApiKey(Consumer<GetApiKeyRequest.Builder> getApiKeyRequest) Gets information about the current ApiKey resource.
This is a convenience which creates an instance of the
GetApiKeyRequest.Builderavoiding the need to create one manually viaGetApiKeyRequest.builder()- Parameters:
getApiKeyRequest- AConsumerthat will call methods onGetApiKeyRequest.Builderto create a request. A request to get information about the current ApiKey resource.- Returns:
- A Java Future containing the result of the GetApiKey operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getApiKeys
Gets information about the current ApiKeys resource.
- Parameters:
getApiKeysRequest- A request to get information about the current ApiKeys resource.- Returns:
- A Java Future containing the result of the GetApiKeys operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getApiKeys
default CompletableFuture<GetApiKeysResponse> getApiKeys(Consumer<GetApiKeysRequest.Builder> getApiKeysRequest) Gets information about the current ApiKeys resource.
This is a convenience which creates an instance of the
GetApiKeysRequest.Builderavoiding the need to create one manually viaGetApiKeysRequest.builder()- Parameters:
getApiKeysRequest- AConsumerthat will call methods onGetApiKeysRequest.Builderto create a request. A request to get information about the current ApiKeys resource.- Returns:
- A Java Future containing the result of the GetApiKeys operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getApiKeys
Gets information about the current ApiKeys resource.
- Returns:
- A Java Future containing the result of the GetApiKeys operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getApiKeysPaginator
This is a variant of
getApiKeys(software.amazon.awssdk.services.apigateway.model.GetApiKeysRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.apigateway.paginators.GetApiKeysPublisher publisher = client.getApiKeysPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.apigateway.paginators.GetApiKeysPublisher publisher = client.getApiKeysPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.apigateway.model.GetApiKeysResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.apigateway.model.GetApiKeysResponse response) { //... }; });Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getApiKeys(software.amazon.awssdk.services.apigateway.model.GetApiKeysRequest)operation.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getApiKeysPaginator
This is a variant of
getApiKeys(software.amazon.awssdk.services.apigateway.model.GetApiKeysRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.apigateway.paginators.GetApiKeysPublisher publisher = client.getApiKeysPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.apigateway.paginators.GetApiKeysPublisher publisher = client.getApiKeysPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.apigateway.model.GetApiKeysResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.apigateway.model.GetApiKeysResponse response) { //... }; });Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getApiKeys(software.amazon.awssdk.services.apigateway.model.GetApiKeysRequest)operation.- Parameters:
getApiKeysRequest- A request to get information about the current ApiKeys resource.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getApiKeysPaginator
default GetApiKeysPublisher getApiKeysPaginator(Consumer<GetApiKeysRequest.Builder> getApiKeysRequest) This is a variant of
getApiKeys(software.amazon.awssdk.services.apigateway.model.GetApiKeysRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.apigateway.paginators.GetApiKeysPublisher publisher = client.getApiKeysPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.apigateway.paginators.GetApiKeysPublisher publisher = client.getApiKeysPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.apigateway.model.GetApiKeysResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.apigateway.model.GetApiKeysResponse response) { //... }; });Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getApiKeys(software.amazon.awssdk.services.apigateway.model.GetApiKeysRequest)operation.
This is a convenience which creates an instance of the
GetApiKeysRequest.Builderavoiding the need to create one manually viaGetApiKeysRequest.builder()- Parameters:
getApiKeysRequest- AConsumerthat will call methods onGetApiKeysRequest.Builderto create a request. A request to get information about the current ApiKeys resource.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getAuthorizer
default CompletableFuture<GetAuthorizerResponse> getAuthorizer(GetAuthorizerRequest getAuthorizerRequest) Describe an existing Authorizer resource.
- Parameters:
getAuthorizerRequest- Request to describe an existing Authorizer resource.- Returns:
- A Java Future containing the result of the GetAuthorizer operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getAuthorizer
default CompletableFuture<GetAuthorizerResponse> getAuthorizer(Consumer<GetAuthorizerRequest.Builder> getAuthorizerRequest) Describe an existing Authorizer resource.
This is a convenience which creates an instance of the
GetAuthorizerRequest.Builderavoiding the need to create one manually viaGetAuthorizerRequest.builder()- Parameters:
getAuthorizerRequest- AConsumerthat will call methods onGetAuthorizerRequest.Builderto create a request. Request to describe an existing Authorizer resource.- Returns:
- A Java Future containing the result of the GetAuthorizer operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getAuthorizers
default CompletableFuture<GetAuthorizersResponse> getAuthorizers(GetAuthorizersRequest getAuthorizersRequest) Describe an existing Authorizers resource.
- Parameters:
getAuthorizersRequest- Request to describe an existing Authorizers resource.- Returns:
- A Java Future containing the result of the GetAuthorizers operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getAuthorizers
default CompletableFuture<GetAuthorizersResponse> getAuthorizers(Consumer<GetAuthorizersRequest.Builder> getAuthorizersRequest) Describe an existing Authorizers resource.
This is a convenience which creates an instance of the
GetAuthorizersRequest.Builderavoiding the need to create one manually viaGetAuthorizersRequest.builder()- Parameters:
getAuthorizersRequest- AConsumerthat will call methods onGetAuthorizersRequest.Builderto create a request. Request to describe an existing Authorizers resource.- Returns:
- A Java Future containing the result of the GetAuthorizers operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getBasePathMapping
default CompletableFuture<GetBasePathMappingResponse> getBasePathMapping(GetBasePathMappingRequest getBasePathMappingRequest) Describe a BasePathMapping resource.
- Parameters:
getBasePathMappingRequest- Request to describe a BasePathMapping resource.- Returns:
- A Java Future containing the result of the GetBasePathMapping operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getBasePathMapping
default CompletableFuture<GetBasePathMappingResponse> getBasePathMapping(Consumer<GetBasePathMappingRequest.Builder> getBasePathMappingRequest) Describe a BasePathMapping resource.
This is a convenience which creates an instance of the
GetBasePathMappingRequest.Builderavoiding the need to create one manually viaGetBasePathMappingRequest.builder()- Parameters:
getBasePathMappingRequest- AConsumerthat will call methods onGetBasePathMappingRequest.Builderto create a request. Request to describe a BasePathMapping resource.- Returns:
- A Java Future containing the result of the GetBasePathMapping operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getBasePathMappings
default CompletableFuture<GetBasePathMappingsResponse> getBasePathMappings(GetBasePathMappingsRequest getBasePathMappingsRequest) Represents a collection of BasePathMapping resources.
- Parameters:
getBasePathMappingsRequest- A request to get information about a collection of BasePathMapping resources.- Returns:
- A Java Future containing the result of the GetBasePathMappings operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getBasePathMappings
default CompletableFuture<GetBasePathMappingsResponse> getBasePathMappings(Consumer<GetBasePathMappingsRequest.Builder> getBasePathMappingsRequest) Represents a collection of BasePathMapping resources.
This is a convenience which creates an instance of the
GetBasePathMappingsRequest.Builderavoiding the need to create one manually viaGetBasePathMappingsRequest.builder()- Parameters:
getBasePathMappingsRequest- AConsumerthat will call methods onGetBasePathMappingsRequest.Builderto create a request. A request to get information about a collection of BasePathMapping resources.- Returns:
- A Java Future containing the result of the GetBasePathMappings operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getBasePathMappingsPaginator
default GetBasePathMappingsPublisher getBasePathMappingsPaginator(GetBasePathMappingsRequest getBasePathMappingsRequest) This is a variant of
getBasePathMappings(software.amazon.awssdk.services.apigateway.model.GetBasePathMappingsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.apigateway.paginators.GetBasePathMappingsPublisher publisher = client.getBasePathMappingsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.apigateway.paginators.GetBasePathMappingsPublisher publisher = client.getBasePathMappingsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.apigateway.model.GetBasePathMappingsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.apigateway.model.GetBasePathMappingsResponse response) { //... }; });Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getBasePathMappings(software.amazon.awssdk.services.apigateway.model.GetBasePathMappingsRequest)operation.- Parameters:
getBasePathMappingsRequest- A request to get information about a collection of BasePathMapping resources.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getBasePathMappingsPaginator
default GetBasePathMappingsPublisher getBasePathMappingsPaginator(Consumer<GetBasePathMappingsRequest.Builder> getBasePathMappingsRequest) This is a variant of
getBasePathMappings(software.amazon.awssdk.services.apigateway.model.GetBasePathMappingsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.apigateway.paginators.GetBasePathMappingsPublisher publisher = client.getBasePathMappingsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.apigateway.paginators.GetBasePathMappingsPublisher publisher = client.getBasePathMappingsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.apigateway.model.GetBasePathMappingsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.apigateway.model.GetBasePathMappingsResponse response) { //... }; });Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getBasePathMappings(software.amazon.awssdk.services.apigateway.model.GetBasePathMappingsRequest)operation.
This is a convenience which creates an instance of the
GetBasePathMappingsRequest.Builderavoiding the need to create one manually viaGetBasePathMappingsRequest.builder()- Parameters:
getBasePathMappingsRequest- AConsumerthat will call methods onGetBasePathMappingsRequest.Builderto create a request. A request to get information about a collection of BasePathMapping resources.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getClientCertificate
default CompletableFuture<GetClientCertificateResponse> getClientCertificate(GetClientCertificateRequest getClientCertificateRequest) Gets information about the current ClientCertificate resource.
- Parameters:
getClientCertificateRequest- A request to get information about the current ClientCertificate resource.- Returns:
- A Java Future containing the result of the GetClientCertificate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getClientCertificate
default CompletableFuture<GetClientCertificateResponse> getClientCertificate(Consumer<GetClientCertificateRequest.Builder> getClientCertificateRequest) Gets information about the current ClientCertificate resource.
This is a convenience which creates an instance of the
GetClientCertificateRequest.Builderavoiding the need to create one manually viaGetClientCertificateRequest.builder()- Parameters:
getClientCertificateRequest- AConsumerthat will call methods onGetClientCertificateRequest.Builderto create a request. A request to get information about the current ClientCertificate resource.- Returns:
- A Java Future containing the result of the GetClientCertificate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getClientCertificates
default CompletableFuture<GetClientCertificatesResponse> getClientCertificates(GetClientCertificatesRequest getClientCertificatesRequest) Gets a collection of ClientCertificate resources.
- Parameters:
getClientCertificatesRequest- A request to get information about a collection of ClientCertificate resources.- Returns:
- A Java Future containing the result of the GetClientCertificates operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getClientCertificates
default CompletableFuture<GetClientCertificatesResponse> getClientCertificates(Consumer<GetClientCertificatesRequest.Builder> getClientCertificatesRequest) Gets a collection of ClientCertificate resources.
This is a convenience which creates an instance of the
GetClientCertificatesRequest.Builderavoiding the need to create one manually viaGetClientCertificatesRequest.builder()- Parameters:
getClientCertificatesRequest- AConsumerthat will call methods onGetClientCertificatesRequest.Builderto create a request. A request to get information about a collection of ClientCertificate resources.- Returns:
- A Java Future containing the result of the GetClientCertificates operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getClientCertificates
Gets a collection of ClientCertificate resources.
- Returns:
- A Java Future containing the result of the GetClientCertificates operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getClientCertificatesPaginator
This is a variant of
getClientCertificates(software.amazon.awssdk.services.apigateway.model.GetClientCertificatesRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.apigateway.paginators.GetClientCertificatesPublisher publisher = client.getClientCertificatesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.apigateway.paginators.GetClientCertificatesPublisher publisher = client.getClientCertificatesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.apigateway.model.GetClientCertificatesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.apigateway.model.GetClientCertificatesResponse response) { //... }; });Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getClientCertificates(software.amazon.awssdk.services.apigateway.model.GetClientCertificatesRequest)operation.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getClientCertificatesPaginator
default GetClientCertificatesPublisher getClientCertificatesPaginator(GetClientCertificatesRequest getClientCertificatesRequest) This is a variant of
getClientCertificates(software.amazon.awssdk.services.apigateway.model.GetClientCertificatesRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.apigateway.paginators.GetClientCertificatesPublisher publisher = client.getClientCertificatesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.apigateway.paginators.GetClientCertificatesPublisher publisher = client.getClientCertificatesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.apigateway.model.GetClientCertificatesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.apigateway.model.GetClientCertificatesResponse response) { //... }; });Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getClientCertificates(software.amazon.awssdk.services.apigateway.model.GetClientCertificatesRequest)operation.- Parameters:
getClientCertificatesRequest- A request to get information about a collection of ClientCertificate resources.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getClientCertificatesPaginator
default GetClientCertificatesPublisher getClientCertificatesPaginator(Consumer<GetClientCertificatesRequest.Builder> getClientCertificatesRequest) This is a variant of
getClientCertificates(software.amazon.awssdk.services.apigateway.model.GetClientCertificatesRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.apigateway.paginators.GetClientCertificatesPublisher publisher = client.getClientCertificatesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.apigateway.paginators.GetClientCertificatesPublisher publisher = client.getClientCertificatesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.apigateway.model.GetClientCertificatesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.apigateway.model.GetClientCertificatesResponse response) { //... }; });Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getClientCertificates(software.amazon.awssdk.services.apigateway.model.GetClientCertificatesRequest)operation.
This is a convenience which creates an instance of the
GetClientCertificatesRequest.Builderavoiding the need to create one manually viaGetClientCertificatesRequest.builder()- Parameters:
getClientCertificatesRequest- AConsumerthat will call methods onGetClientCertificatesRequest.Builderto create a request. A request to get information about a collection of ClientCertificate resources.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getDeployment
default CompletableFuture<GetDeploymentResponse> getDeployment(GetDeploymentRequest getDeploymentRequest) Gets information about a Deployment resource.
- Parameters:
getDeploymentRequest- Requests API Gateway to get information about a Deployment resource.- Returns:
- A Java Future containing the result of the GetDeployment operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- ServiceUnavailableException The requested service is not available. For details see the accompanying error message. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getDeployment
default CompletableFuture<GetDeploymentResponse> getDeployment(Consumer<GetDeploymentRequest.Builder> getDeploymentRequest) Gets information about a Deployment resource.
This is a convenience which creates an instance of the
GetDeploymentRequest.Builderavoiding the need to create one manually viaGetDeploymentRequest.builder()- Parameters:
getDeploymentRequest- AConsumerthat will call methods onGetDeploymentRequest.Builderto create a request. Requests API Gateway to get information about a Deployment resource.- Returns:
- A Java Future containing the result of the GetDeployment operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- ServiceUnavailableException The requested service is not available. For details see the accompanying error message. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getDeployments
default CompletableFuture<GetDeploymentsResponse> getDeployments(GetDeploymentsRequest getDeploymentsRequest) Gets information about a Deployments collection.
- Parameters:
getDeploymentsRequest- Requests API Gateway to get information about a Deployments collection.- Returns:
- A Java Future containing the result of the GetDeployments operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- ServiceUnavailableException The requested service is not available. For details see the accompanying error message. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getDeployments
default CompletableFuture<GetDeploymentsResponse> getDeployments(Consumer<GetDeploymentsRequest.Builder> getDeploymentsRequest) Gets information about a Deployments collection.
This is a convenience which creates an instance of the
GetDeploymentsRequest.Builderavoiding the need to create one manually viaGetDeploymentsRequest.builder()- Parameters:
getDeploymentsRequest- AConsumerthat will call methods onGetDeploymentsRequest.Builderto create a request. Requests API Gateway to get information about a Deployments collection.- Returns:
- A Java Future containing the result of the GetDeployments operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- ServiceUnavailableException The requested service is not available. For details see the accompanying error message. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getDeploymentsPaginator
default GetDeploymentsPublisher getDeploymentsPaginator(GetDeploymentsRequest getDeploymentsRequest) This is a variant of
getDeployments(software.amazon.awssdk.services.apigateway.model.GetDeploymentsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.apigateway.paginators.GetDeploymentsPublisher publisher = client.getDeploymentsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.apigateway.paginators.GetDeploymentsPublisher publisher = client.getDeploymentsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.apigateway.model.GetDeploymentsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.apigateway.model.GetDeploymentsResponse response) { //... }; });Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getDeployments(software.amazon.awssdk.services.apigateway.model.GetDeploymentsRequest)operation.- Parameters:
getDeploymentsRequest- Requests API Gateway to get information about a Deployments collection.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- ServiceUnavailableException The requested service is not available. For details see the accompanying error message. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getDeploymentsPaginator
default GetDeploymentsPublisher getDeploymentsPaginator(Consumer<GetDeploymentsRequest.Builder> getDeploymentsRequest) This is a variant of
getDeployments(software.amazon.awssdk.services.apigateway.model.GetDeploymentsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.apigateway.paginators.GetDeploymentsPublisher publisher = client.getDeploymentsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.apigateway.paginators.GetDeploymentsPublisher publisher = client.getDeploymentsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.apigateway.model.GetDeploymentsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.apigateway.model.GetDeploymentsResponse response) { //... }; });Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getDeployments(software.amazon.awssdk.services.apigateway.model.GetDeploymentsRequest)operation.
This is a convenience which creates an instance of the
GetDeploymentsRequest.Builderavoiding the need to create one manually viaGetDeploymentsRequest.builder()- Parameters:
getDeploymentsRequest- AConsumerthat will call methods onGetDeploymentsRequest.Builderto create a request. Requests API Gateway to get information about a Deployments collection.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- ServiceUnavailableException The requested service is not available. For details see the accompanying error message. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getDocumentationPart
default CompletableFuture<GetDocumentationPartResponse> getDocumentationPart(GetDocumentationPartRequest getDocumentationPartRequest) Gets a documentation part.
- Parameters:
getDocumentationPartRequest- Gets a specified documentation part of a given API.- Returns:
- A Java Future containing the result of the GetDocumentationPart operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getDocumentationPart
default CompletableFuture<GetDocumentationPartResponse> getDocumentationPart(Consumer<GetDocumentationPartRequest.Builder> getDocumentationPartRequest) Gets a documentation part.
This is a convenience which creates an instance of the
GetDocumentationPartRequest.Builderavoiding the need to create one manually viaGetDocumentationPartRequest.builder()- Parameters:
getDocumentationPartRequest- AConsumerthat will call methods onGetDocumentationPartRequest.Builderto create a request. Gets a specified documentation part of a given API.- Returns:
- A Java Future containing the result of the GetDocumentationPart operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getDocumentationParts
default CompletableFuture<GetDocumentationPartsResponse> getDocumentationParts(GetDocumentationPartsRequest getDocumentationPartsRequest) Gets documentation parts.
- Parameters:
getDocumentationPartsRequest- Gets the documentation parts of an API. The result may be filtered by the type, name, or path of API entities (targets).- Returns:
- A Java Future containing the result of the GetDocumentationParts operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getDocumentationParts
default CompletableFuture<GetDocumentationPartsResponse> getDocumentationParts(Consumer<GetDocumentationPartsRequest.Builder> getDocumentationPartsRequest) Gets documentation parts.
This is a convenience which creates an instance of the
GetDocumentationPartsRequest.Builderavoiding the need to create one manually viaGetDocumentationPartsRequest.builder()- Parameters:
getDocumentationPartsRequest- AConsumerthat will call methods onGetDocumentationPartsRequest.Builderto create a request. Gets the documentation parts of an API. The result may be filtered by the type, name, or path of API entities (targets).- Returns:
- A Java Future containing the result of the GetDocumentationParts operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getDocumentationVersion
default CompletableFuture<GetDocumentationVersionResponse> getDocumentationVersion(GetDocumentationVersionRequest getDocumentationVersionRequest) Gets a documentation version.
- Parameters:
getDocumentationVersionRequest- Gets a documentation snapshot of an API.- Returns:
- A Java Future containing the result of the GetDocumentationVersion operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getDocumentationVersion
default CompletableFuture<GetDocumentationVersionResponse> getDocumentationVersion(Consumer<GetDocumentationVersionRequest.Builder> getDocumentationVersionRequest) Gets a documentation version.
This is a convenience which creates an instance of the
GetDocumentationVersionRequest.Builderavoiding the need to create one manually viaGetDocumentationVersionRequest.builder()- Parameters:
getDocumentationVersionRequest- AConsumerthat will call methods onGetDocumentationVersionRequest.Builderto create a request. Gets a documentation snapshot of an API.- Returns:
- A Java Future containing the result of the GetDocumentationVersion operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getDocumentationVersions
default CompletableFuture<GetDocumentationVersionsResponse> getDocumentationVersions(GetDocumentationVersionsRequest getDocumentationVersionsRequest) Gets documentation versions.
- Parameters:
getDocumentationVersionsRequest- Gets the documentation versions of an API.- Returns:
- A Java Future containing the result of the GetDocumentationVersions operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getDocumentationVersions
default CompletableFuture<GetDocumentationVersionsResponse> getDocumentationVersions(Consumer<GetDocumentationVersionsRequest.Builder> getDocumentationVersionsRequest) Gets documentation versions.
This is a convenience which creates an instance of the
GetDocumentationVersionsRequest.Builderavoiding the need to create one manually viaGetDocumentationVersionsRequest.builder()- Parameters:
getDocumentationVersionsRequest- AConsumerthat will call methods onGetDocumentationVersionsRequest.Builderto create a request. Gets the documentation versions of an API.- Returns:
- A Java Future containing the result of the GetDocumentationVersions operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getDomainName
default CompletableFuture<GetDomainNameResponse> getDomainName(GetDomainNameRequest getDomainNameRequest) Represents a domain name that is contained in a simpler, more intuitive URL that can be called.
- Parameters:
getDomainNameRequest- Request to get the name of a DomainName resource.- Returns:
- A Java Future containing the result of the GetDomainName operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getDomainName
default CompletableFuture<GetDomainNameResponse> getDomainName(Consumer<GetDomainNameRequest.Builder> getDomainNameRequest) Represents a domain name that is contained in a simpler, more intuitive URL that can be called.
This is a convenience which creates an instance of the
GetDomainNameRequest.Builderavoiding the need to create one manually viaGetDomainNameRequest.builder()- Parameters:
getDomainNameRequest- AConsumerthat will call methods onGetDomainNameRequest.Builderto create a request. Request to get the name of a DomainName resource.- Returns:
- A Java Future containing the result of the GetDomainName operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getDomainNames
default CompletableFuture<GetDomainNamesResponse> getDomainNames(GetDomainNamesRequest getDomainNamesRequest) Represents a collection of DomainName resources.
- Parameters:
getDomainNamesRequest- Request to describe a collection of DomainName resources.- Returns:
- A Java Future containing the result of the GetDomainNames operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getDomainNames
default CompletableFuture<GetDomainNamesResponse> getDomainNames(Consumer<GetDomainNamesRequest.Builder> getDomainNamesRequest) Represents a collection of DomainName resources.
This is a convenience which creates an instance of the
GetDomainNamesRequest.Builderavoiding the need to create one manually viaGetDomainNamesRequest.builder()- Parameters:
getDomainNamesRequest- AConsumerthat will call methods onGetDomainNamesRequest.Builderto create a request. Request to describe a collection of DomainName resources.- Returns:
- A Java Future containing the result of the GetDomainNames operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getDomainNames
Represents a collection of DomainName resources.
- Returns:
- A Java Future containing the result of the GetDomainNames operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getDomainNamesPaginator
This is a variant of
getDomainNames(software.amazon.awssdk.services.apigateway.model.GetDomainNamesRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.apigateway.paginators.GetDomainNamesPublisher publisher = client.getDomainNamesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.apigateway.paginators.GetDomainNamesPublisher publisher = client.getDomainNamesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.apigateway.model.GetDomainNamesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.apigateway.model.GetDomainNamesResponse response) { //... }; });Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getDomainNames(software.amazon.awssdk.services.apigateway.model.GetDomainNamesRequest)operation.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getDomainNamesPaginator
default GetDomainNamesPublisher getDomainNamesPaginator(GetDomainNamesRequest getDomainNamesRequest) This is a variant of
getDomainNames(software.amazon.awssdk.services.apigateway.model.GetDomainNamesRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.apigateway.paginators.GetDomainNamesPublisher publisher = client.getDomainNamesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.apigateway.paginators.GetDomainNamesPublisher publisher = client.getDomainNamesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.apigateway.model.GetDomainNamesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.apigateway.model.GetDomainNamesResponse response) { //... }; });Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getDomainNames(software.amazon.awssdk.services.apigateway.model.GetDomainNamesRequest)operation.- Parameters:
getDomainNamesRequest- Request to describe a collection of DomainName resources.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getDomainNamesPaginator
default GetDomainNamesPublisher getDomainNamesPaginator(Consumer<GetDomainNamesRequest.Builder> getDomainNamesRequest) This is a variant of
getDomainNames(software.amazon.awssdk.services.apigateway.model.GetDomainNamesRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.apigateway.paginators.GetDomainNamesPublisher publisher = client.getDomainNamesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.apigateway.paginators.GetDomainNamesPublisher publisher = client.getDomainNamesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.apigateway.model.GetDomainNamesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.apigateway.model.GetDomainNamesResponse response) { //... }; });Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getDomainNames(software.amazon.awssdk.services.apigateway.model.GetDomainNamesRequest)operation.
This is a convenience which creates an instance of the
GetDomainNamesRequest.Builderavoiding the need to create one manually viaGetDomainNamesRequest.builder()- Parameters:
getDomainNamesRequest- AConsumerthat will call methods onGetDomainNamesRequest.Builderto create a request. Request to describe a collection of DomainName resources.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getExport
Exports a deployed version of a RestApi in a specified format.
- Parameters:
getExportRequest- Request a new export of a RestApi for a particular Stage.- Returns:
- A Java Future containing the result of the GetExport operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getExport
default CompletableFuture<GetExportResponse> getExport(Consumer<GetExportRequest.Builder> getExportRequest) Exports a deployed version of a RestApi in a specified format.
This is a convenience which creates an instance of the
GetExportRequest.Builderavoiding the need to create one manually viaGetExportRequest.builder()- Parameters:
getExportRequest- AConsumerthat will call methods onGetExportRequest.Builderto create a request. Request a new export of a RestApi for a particular Stage.- Returns:
- A Java Future containing the result of the GetExport operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getGatewayResponse
default CompletableFuture<GetGatewayResponseResponse> getGatewayResponse(GetGatewayResponseRequest getGatewayResponseRequest) Gets a GatewayResponse of a specified response type on the given RestApi.
- Parameters:
getGatewayResponseRequest- Gets a GatewayResponse of a specified response type on the given RestApi.- Returns:
- A Java Future containing the result of the GetGatewayResponse operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getGatewayResponse
default CompletableFuture<GetGatewayResponseResponse> getGatewayResponse(Consumer<GetGatewayResponseRequest.Builder> getGatewayResponseRequest) Gets a GatewayResponse of a specified response type on the given RestApi.
This is a convenience which creates an instance of the
GetGatewayResponseRequest.Builderavoiding the need to create one manually viaGetGatewayResponseRequest.builder()- Parameters:
getGatewayResponseRequest- AConsumerthat will call methods onGetGatewayResponseRequest.Builderto create a request. Gets a GatewayResponse of a specified response type on the given RestApi.- Returns:
- A Java Future containing the result of the GetGatewayResponse operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getGatewayResponses
default CompletableFuture<GetGatewayResponsesResponse> getGatewayResponses(GetGatewayResponsesRequest getGatewayResponsesRequest) Gets the GatewayResponses collection on the given RestApi. If an API developer has not added any definitions for gateway responses, the result will be the API Gateway-generated default GatewayResponses collection for the supported response types.
- Parameters:
getGatewayResponsesRequest- Gets the GatewayResponses collection on the given RestApi. If an API developer has not added any definitions for gateway responses, the result will be the API Gateway-generated default GatewayResponses collection for the supported response types.- Returns:
- A Java Future containing the result of the GetGatewayResponses operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getGatewayResponses
default CompletableFuture<GetGatewayResponsesResponse> getGatewayResponses(Consumer<GetGatewayResponsesRequest.Builder> getGatewayResponsesRequest) Gets the GatewayResponses collection on the given RestApi. If an API developer has not added any definitions for gateway responses, the result will be the API Gateway-generated default GatewayResponses collection for the supported response types.
This is a convenience which creates an instance of the
GetGatewayResponsesRequest.Builderavoiding the need to create one manually viaGetGatewayResponsesRequest.builder()- Parameters:
getGatewayResponsesRequest- AConsumerthat will call methods onGetGatewayResponsesRequest.Builderto create a request. Gets the GatewayResponses collection on the given RestApi. If an API developer has not added any definitions for gateway responses, the result will be the API Gateway-generated default GatewayResponses collection for the supported response types.- Returns:
- A Java Future containing the result of the GetGatewayResponses operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getIntegration
default CompletableFuture<GetIntegrationResponse> getIntegration(GetIntegrationRequest getIntegrationRequest) Get the integration settings.
- Parameters:
getIntegrationRequest- Represents a request to get the integration configuration.- Returns:
- A Java Future containing the result of the GetIntegration operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getIntegration
default CompletableFuture<GetIntegrationResponse> getIntegration(Consumer<GetIntegrationRequest.Builder> getIntegrationRequest) Get the integration settings.
This is a convenience which creates an instance of the
GetIntegrationRequest.Builderavoiding the need to create one manually viaGetIntegrationRequest.builder()- Parameters:
getIntegrationRequest- AConsumerthat will call methods onGetIntegrationRequest.Builderto create a request. Represents a request to get the integration configuration.- Returns:
- A Java Future containing the result of the GetIntegration operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getIntegrationResponse
default CompletableFuture<GetIntegrationResponseResponse> getIntegrationResponse(GetIntegrationResponseRequest getIntegrationResponseRequest) Represents a get integration response.
- Parameters:
getIntegrationResponseRequest- Represents a get integration response request.- Returns:
- A Java Future containing the result of the GetIntegrationResponse operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getIntegrationResponse
default CompletableFuture<GetIntegrationResponseResponse> getIntegrationResponse(Consumer<GetIntegrationResponseRequest.Builder> getIntegrationResponseRequest) Represents a get integration response.
This is a convenience which creates an instance of the
GetIntegrationResponseRequest.Builderavoiding the need to create one manually viaGetIntegrationResponseRequest.builder()- Parameters:
getIntegrationResponseRequest- AConsumerthat will call methods onGetIntegrationResponseRequest.Builderto create a request. Represents a get integration response request.- Returns:
- A Java Future containing the result of the GetIntegrationResponse operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getMethod
Describe an existing Method resource.
- Parameters:
getMethodRequest- Request to describe an existing Method resource.- Returns:
- A Java Future containing the result of the GetMethod operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getMethod
default CompletableFuture<GetMethodResponse> getMethod(Consumer<GetMethodRequest.Builder> getMethodRequest) Describe an existing Method resource.
This is a convenience which creates an instance of the
GetMethodRequest.Builderavoiding the need to create one manually viaGetMethodRequest.builder()- Parameters:
getMethodRequest- AConsumerthat will call methods onGetMethodRequest.Builderto create a request. Request to describe an existing Method resource.- Returns:
- A Java Future containing the result of the GetMethod operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getMethodResponse
default CompletableFuture<GetMethodResponseResponse> getMethodResponse(GetMethodResponseRequest getMethodResponseRequest) Describes a MethodResponse resource.
- Parameters:
getMethodResponseRequest- Request to describe a MethodResponse resource.- Returns:
- A Java Future containing the result of the GetMethodResponse operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getMethodResponse
default CompletableFuture<GetMethodResponseResponse> getMethodResponse(Consumer<GetMethodResponseRequest.Builder> getMethodResponseRequest) Describes a MethodResponse resource.
This is a convenience which creates an instance of the
GetMethodResponseRequest.Builderavoiding the need to create one manually viaGetMethodResponseRequest.builder()- Parameters:
getMethodResponseRequest- AConsumerthat will call methods onGetMethodResponseRequest.Builderto create a request. Request to describe a MethodResponse resource.- Returns:
- A Java Future containing the result of the GetMethodResponse operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getModel
Describes an existing model defined for a RestApi resource.
- Parameters:
getModelRequest- Request to list information about a model in an existing RestApi resource.- Returns:
- A Java Future containing the result of the GetModel operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getModel
default CompletableFuture<GetModelResponse> getModel(Consumer<GetModelRequest.Builder> getModelRequest) Describes an existing model defined for a RestApi resource.
This is a convenience which creates an instance of the
GetModelRequest.Builderavoiding the need to create one manually viaGetModelRequest.builder()- Parameters:
getModelRequest- AConsumerthat will call methods onGetModelRequest.Builderto create a request. Request to list information about a model in an existing RestApi resource.- Returns:
- A Java Future containing the result of the GetModel operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getModelTemplate
default CompletableFuture<GetModelTemplateResponse> getModelTemplate(GetModelTemplateRequest getModelTemplateRequest) Generates a sample mapping template that can be used to transform a payload into the structure of a model.
- Parameters:
getModelTemplateRequest- Request to generate a sample mapping template used to transform the payload.- Returns:
- A Java Future containing the result of the GetModelTemplate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getModelTemplate
default CompletableFuture<GetModelTemplateResponse> getModelTemplate(Consumer<GetModelTemplateRequest.Builder> getModelTemplateRequest) Generates a sample mapping template that can be used to transform a payload into the structure of a model.
This is a convenience which creates an instance of the
GetModelTemplateRequest.Builderavoiding the need to create one manually viaGetModelTemplateRequest.builder()- Parameters:
getModelTemplateRequest- AConsumerthat will call methods onGetModelTemplateRequest.Builderto create a request. Request to generate a sample mapping template used to transform the payload.- Returns:
- A Java Future containing the result of the GetModelTemplate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getModels
Describes existing Models defined for a RestApi resource.
- Parameters:
getModelsRequest- Request to list existing Models defined for a RestApi resource.- Returns:
- A Java Future containing the result of the GetModels operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getModels
default CompletableFuture<GetModelsResponse> getModels(Consumer<GetModelsRequest.Builder> getModelsRequest) Describes existing Models defined for a RestApi resource.
This is a convenience which creates an instance of the
GetModelsRequest.Builderavoiding the need to create one manually viaGetModelsRequest.builder()- Parameters:
getModelsRequest- AConsumerthat will call methods onGetModelsRequest.Builderto create a request. Request to list existing Models defined for a RestApi resource.- Returns:
- A Java Future containing the result of the GetModels operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getModelsPaginator
This is a variant of
getModels(software.amazon.awssdk.services.apigateway.model.GetModelsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.apigateway.paginators.GetModelsPublisher publisher = client.getModelsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.apigateway.paginators.GetModelsPublisher publisher = client.getModelsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.apigateway.model.GetModelsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.apigateway.model.GetModelsResponse response) { //... }; });Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getModels(software.amazon.awssdk.services.apigateway.model.GetModelsRequest)operation.- Parameters:
getModelsRequest- Request to list existing Models defined for a RestApi resource.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getModelsPaginator
This is a variant of
getModels(software.amazon.awssdk.services.apigateway.model.GetModelsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.apigateway.paginators.GetModelsPublisher publisher = client.getModelsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.apigateway.paginators.GetModelsPublisher publisher = client.getModelsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.apigateway.model.GetModelsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.apigateway.model.GetModelsResponse response) { //... }; });Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getModels(software.amazon.awssdk.services.apigateway.model.GetModelsRequest)operation.
This is a convenience which creates an instance of the
GetModelsRequest.Builderavoiding the need to create one manually viaGetModelsRequest.builder()- Parameters:
getModelsRequest- AConsumerthat will call methods onGetModelsRequest.Builderto create a request. Request to list existing Models defined for a RestApi resource.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getRequestValidator
default CompletableFuture<GetRequestValidatorResponse> getRequestValidator(GetRequestValidatorRequest getRequestValidatorRequest) Gets a RequestValidator of a given RestApi.
- Parameters:
getRequestValidatorRequest- Gets a RequestValidator of a given RestApi.- Returns:
- A Java Future containing the result of the GetRequestValidator operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getRequestValidator
default CompletableFuture<GetRequestValidatorResponse> getRequestValidator(Consumer<GetRequestValidatorRequest.Builder> getRequestValidatorRequest) Gets a RequestValidator of a given RestApi.
This is a convenience which creates an instance of the
GetRequestValidatorRequest.Builderavoiding the need to create one manually viaGetRequestValidatorRequest.builder()- Parameters:
getRequestValidatorRequest- AConsumerthat will call methods onGetRequestValidatorRequest.Builderto create a request. Gets a RequestValidator of a given RestApi.- Returns:
- A Java Future containing the result of the GetRequestValidator operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getRequestValidators
default CompletableFuture<GetRequestValidatorsResponse> getRequestValidators(GetRequestValidatorsRequest getRequestValidatorsRequest) Gets the RequestValidators collection of a given RestApi.
- Parameters:
getRequestValidatorsRequest- Gets the RequestValidators collection of a given RestApi.- Returns:
- A Java Future containing the result of the GetRequestValidators operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getRequestValidators
default CompletableFuture<GetRequestValidatorsResponse> getRequestValidators(Consumer<GetRequestValidatorsRequest.Builder> getRequestValidatorsRequest) Gets the RequestValidators collection of a given RestApi.
This is a convenience which creates an instance of the
GetRequestValidatorsRequest.Builderavoiding the need to create one manually viaGetRequestValidatorsRequest.builder()- Parameters:
getRequestValidatorsRequest- AConsumerthat will call methods onGetRequestValidatorsRequest.Builderto create a request. Gets the RequestValidators collection of a given RestApi.- Returns:
- A Java Future containing the result of the GetRequestValidators operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getResource
Lists information about a resource.
- Parameters:
getResourceRequest- Request to list information about a resource.- Returns:
- A Java Future containing the result of the GetResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getResource
default CompletableFuture<GetResourceResponse> getResource(Consumer<GetResourceRequest.Builder> getResourceRequest) Lists information about a resource.
This is a convenience which creates an instance of the
GetResourceRequest.Builderavoiding the need to create one manually viaGetResourceRequest.builder()- Parameters:
getResourceRequest- AConsumerthat will call methods onGetResourceRequest.Builderto create a request. Request to list information about a resource.- Returns:
- A Java Future containing the result of the GetResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getResources
default CompletableFuture<GetResourcesResponse> getResources(GetResourcesRequest getResourcesRequest) Lists information about a collection of Resource resources.
- Parameters:
getResourcesRequest- Request to list information about a collection of resources.- Returns:
- A Java Future containing the result of the GetResources operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getResources
default CompletableFuture<GetResourcesResponse> getResources(Consumer<GetResourcesRequest.Builder> getResourcesRequest) Lists information about a collection of Resource resources.
This is a convenience which creates an instance of the
GetResourcesRequest.Builderavoiding the need to create one manually viaGetResourcesRequest.builder()- Parameters:
getResourcesRequest- AConsumerthat will call methods onGetResourcesRequest.Builderto create a request. Request to list information about a collection of resources.- Returns:
- A Java Future containing the result of the GetResources operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getResourcesPaginator
This is a variant of
getResources(software.amazon.awssdk.services.apigateway.model.GetResourcesRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.apigateway.paginators.GetResourcesPublisher publisher = client.getResourcesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.apigateway.paginators.GetResourcesPublisher publisher = client.getResourcesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.apigateway.model.GetResourcesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.apigateway.model.GetResourcesResponse response) { //... }; });Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getResources(software.amazon.awssdk.services.apigateway.model.GetResourcesRequest)operation.- Parameters:
getResourcesRequest- Request to list information about a collection of resources.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getResourcesPaginator
default GetResourcesPublisher getResourcesPaginator(Consumer<GetResourcesRequest.Builder> getResourcesRequest) This is a variant of
getResources(software.amazon.awssdk.services.apigateway.model.GetResourcesRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.apigateway.paginators.GetResourcesPublisher publisher = client.getResourcesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.apigateway.paginators.GetResourcesPublisher publisher = client.getResourcesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.apigateway.model.GetResourcesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.apigateway.model.GetResourcesResponse response) { //... }; });Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getResources(software.amazon.awssdk.services.apigateway.model.GetResourcesRequest)operation.
This is a convenience which creates an instance of the
GetResourcesRequest.Builderavoiding the need to create one manually viaGetResourcesRequest.builder()- Parameters:
getResourcesRequest- AConsumerthat will call methods onGetResourcesRequest.Builderto create a request. Request to list information about a collection of resources.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getRestApi
Lists the RestApi resource in the collection.
- Parameters:
getRestApiRequest- The GET request to list an existing RestApi defined for your collection.- Returns:
- A Java Future containing the result of the GetRestApi operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getRestApi
default CompletableFuture<GetRestApiResponse> getRestApi(Consumer<GetRestApiRequest.Builder> getRestApiRequest) Lists the RestApi resource in the collection.
This is a convenience which creates an instance of the
GetRestApiRequest.Builderavoiding the need to create one manually viaGetRestApiRequest.builder()- Parameters:
getRestApiRequest- AConsumerthat will call methods onGetRestApiRequest.Builderto create a request. The GET request to list an existing RestApi defined for your collection.- Returns:
- A Java Future containing the result of the GetRestApi operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getRestApis
Lists the RestApis resources for your collection.
- Parameters:
getRestApisRequest- The GET request to list existing RestApis defined for your collection.- Returns:
- A Java Future containing the result of the GetRestApis operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getRestApis
default CompletableFuture<GetRestApisResponse> getRestApis(Consumer<GetRestApisRequest.Builder> getRestApisRequest) Lists the RestApis resources for your collection.
This is a convenience which creates an instance of the
GetRestApisRequest.Builderavoiding the need to create one manually viaGetRestApisRequest.builder()- Parameters:
getRestApisRequest- AConsumerthat will call methods onGetRestApisRequest.Builderto create a request. The GET request to list existing RestApis defined for your collection.- Returns:
- A Java Future containing the result of the GetRestApis operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getRestApis
Lists the RestApis resources for your collection.
- Returns:
- A Java Future containing the result of the GetRestApis operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getRestApisPaginator
This is a variant of
getRestApis(software.amazon.awssdk.services.apigateway.model.GetRestApisRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.apigateway.paginators.GetRestApisPublisher publisher = client.getRestApisPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.apigateway.paginators.GetRestApisPublisher publisher = client.getRestApisPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.apigateway.model.GetRestApisResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.apigateway.model.GetRestApisResponse response) { //... }; });Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getRestApis(software.amazon.awssdk.services.apigateway.model.GetRestApisRequest)operation.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getRestApisPaginator
This is a variant of
getRestApis(software.amazon.awssdk.services.apigateway.model.GetRestApisRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.apigateway.paginators.GetRestApisPublisher publisher = client.getRestApisPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.apigateway.paginators.GetRestApisPublisher publisher = client.getRestApisPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.apigateway.model.GetRestApisResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.apigateway.model.GetRestApisResponse response) { //... }; });Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getRestApis(software.amazon.awssdk.services.apigateway.model.GetRestApisRequest)operation.- Parameters:
getRestApisRequest- The GET request to list existing RestApis defined for your collection.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getRestApisPaginator
default GetRestApisPublisher getRestApisPaginator(Consumer<GetRestApisRequest.Builder> getRestApisRequest) This is a variant of
getRestApis(software.amazon.awssdk.services.apigateway.model.GetRestApisRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.apigateway.paginators.GetRestApisPublisher publisher = client.getRestApisPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.apigateway.paginators.GetRestApisPublisher publisher = client.getRestApisPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.apigateway.model.GetRestApisResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.apigateway.model.GetRestApisResponse response) { //... }; });Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getRestApis(software.amazon.awssdk.services.apigateway.model.GetRestApisRequest)operation.
This is a convenience which creates an instance of the
GetRestApisRequest.Builderavoiding the need to create one manually viaGetRestApisRequest.builder()- Parameters:
getRestApisRequest- AConsumerthat will call methods onGetRestApisRequest.Builderto create a request. The GET request to list existing RestApis defined for your collection.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getSdk
Generates a client SDK for a RestApi and Stage.
- Parameters:
getSdkRequest- Request a new generated client SDK for a RestApi and Stage.- Returns:
- A Java Future containing the result of the GetSdk operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getSdk
Generates a client SDK for a RestApi and Stage.
This is a convenience which creates an instance of the
GetSdkRequest.Builderavoiding the need to create one manually viaGetSdkRequest.builder()- Parameters:
getSdkRequest- AConsumerthat will call methods onGetSdkRequest.Builderto create a request. Request a new generated client SDK for a RestApi and Stage.- Returns:
- A Java Future containing the result of the GetSdk operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getSdkType
Gets an SDK type.
- Parameters:
getSdkTypeRequest- Get an SdkType instance.- Returns:
- A Java Future containing the result of the GetSdkType operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getSdkType
default CompletableFuture<GetSdkTypeResponse> getSdkType(Consumer<GetSdkTypeRequest.Builder> getSdkTypeRequest) Gets an SDK type.
This is a convenience which creates an instance of the
GetSdkTypeRequest.Builderavoiding the need to create one manually viaGetSdkTypeRequest.builder()- Parameters:
getSdkTypeRequest- AConsumerthat will call methods onGetSdkTypeRequest.Builderto create a request. Get an SdkType instance.- Returns:
- A Java Future containing the result of the GetSdkType operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getSdkTypes
Gets SDK types
- Parameters:
getSdkTypesRequest- Get the SdkTypes collection.- Returns:
- A Java Future containing the result of the GetSdkTypes operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getSdkTypes
default CompletableFuture<GetSdkTypesResponse> getSdkTypes(Consumer<GetSdkTypesRequest.Builder> getSdkTypesRequest) Gets SDK types
This is a convenience which creates an instance of the
GetSdkTypesRequest.Builderavoiding the need to create one manually viaGetSdkTypesRequest.builder()- Parameters:
getSdkTypesRequest- AConsumerthat will call methods onGetSdkTypesRequest.Builderto create a request. Get the SdkTypes collection.- Returns:
- A Java Future containing the result of the GetSdkTypes operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getSdkTypes
Gets SDK types
- Returns:
- A Java Future containing the result of the GetSdkTypes operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getStage
Gets information about a Stage resource.
- Parameters:
getStageRequest- Requests API Gateway to get information about a Stage resource.- Returns:
- A Java Future containing the result of the GetStage operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getStage
default CompletableFuture<GetStageResponse> getStage(Consumer<GetStageRequest.Builder> getStageRequest) Gets information about a Stage resource.
This is a convenience which creates an instance of the
GetStageRequest.Builderavoiding the need to create one manually viaGetStageRequest.builder()- Parameters:
getStageRequest- AConsumerthat will call methods onGetStageRequest.Builderto create a request. Requests API Gateway to get information about a Stage resource.- Returns:
- A Java Future containing the result of the GetStage operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getStages
Gets information about one or more Stage resources.
- Parameters:
getStagesRequest- Requests API Gateway to get information about one or more Stage resources.- Returns:
- A Java Future containing the result of the GetStages operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getStages
default CompletableFuture<GetStagesResponse> getStages(Consumer<GetStagesRequest.Builder> getStagesRequest) Gets information about one or more Stage resources.
This is a convenience which creates an instance of the
GetStagesRequest.Builderavoiding the need to create one manually viaGetStagesRequest.builder()- Parameters:
getStagesRequest- AConsumerthat will call methods onGetStagesRequest.Builderto create a request. Requests API Gateway to get information about one or more Stage resources.- Returns:
- A Java Future containing the result of the GetStages operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getTags
Gets the Tags collection for a given resource.
- Parameters:
getTagsRequest- Gets the Tags collection for a given resource.- Returns:
- A Java Future containing the result of the GetTags operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getTags
Gets the Tags collection for a given resource.
This is a convenience which creates an instance of the
GetTagsRequest.Builderavoiding the need to create one manually viaGetTagsRequest.builder()- Parameters:
getTagsRequest- AConsumerthat will call methods onGetTagsRequest.Builderto create a request. Gets the Tags collection for a given resource.- Returns:
- A Java Future containing the result of the GetTags operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getUsage
Gets the usage data of a usage plan in a specified time interval.
- Parameters:
getUsageRequest- The GET request to get the usage data of a usage plan in a specified time interval.- Returns:
- A Java Future containing the result of the GetUsage operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getUsage
default CompletableFuture<GetUsageResponse> getUsage(Consumer<GetUsageRequest.Builder> getUsageRequest) Gets the usage data of a usage plan in a specified time interval.
This is a convenience which creates an instance of the
GetUsageRequest.Builderavoiding the need to create one manually viaGetUsageRequest.builder()- Parameters:
getUsageRequest- AConsumerthat will call methods onGetUsageRequest.Builderto create a request. The GET request to get the usage data of a usage plan in a specified time interval.- Returns:
- A Java Future containing the result of the GetUsage operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getUsagePaginator
This is a variant of
getUsage(software.amazon.awssdk.services.apigateway.model.GetUsageRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.apigateway.paginators.GetUsagePublisher publisher = client.getUsagePaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.apigateway.paginators.GetUsagePublisher publisher = client.getUsagePaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.apigateway.model.GetUsageResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.apigateway.model.GetUsageResponse response) { //... }; });Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getUsage(software.amazon.awssdk.services.apigateway.model.GetUsageRequest)operation.- Parameters:
getUsageRequest- The GET request to get the usage data of a usage plan in a specified time interval.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getUsagePaginator
This is a variant of
getUsage(software.amazon.awssdk.services.apigateway.model.GetUsageRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.apigateway.paginators.GetUsagePublisher publisher = client.getUsagePaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.apigateway.paginators.GetUsagePublisher publisher = client.getUsagePaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.apigateway.model.GetUsageResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.apigateway.model.GetUsageResponse response) { //... }; });Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getUsage(software.amazon.awssdk.services.apigateway.model.GetUsageRequest)operation.
This is a convenience which creates an instance of the
GetUsageRequest.Builderavoiding the need to create one manually viaGetUsageRequest.builder()- Parameters:
getUsageRequest- AConsumerthat will call methods onGetUsageRequest.Builderto create a request. The GET request to get the usage data of a usage plan in a specified time interval.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getUsagePlan
default CompletableFuture<GetUsagePlanResponse> getUsagePlan(GetUsagePlanRequest getUsagePlanRequest) Gets a usage plan of a given plan identifier.
- Parameters:
getUsagePlanRequest- The GET request to get a usage plan of a given plan identifier.- Returns:
- A Java Future containing the result of the GetUsagePlan operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getUsagePlan
default CompletableFuture<GetUsagePlanResponse> getUsagePlan(Consumer<GetUsagePlanRequest.Builder> getUsagePlanRequest) Gets a usage plan of a given plan identifier.
This is a convenience which creates an instance of the
GetUsagePlanRequest.Builderavoiding the need to create one manually viaGetUsagePlanRequest.builder()- Parameters:
getUsagePlanRequest- AConsumerthat will call methods onGetUsagePlanRequest.Builderto create a request. The GET request to get a usage plan of a given plan identifier.- Returns:
- A Java Future containing the result of the GetUsagePlan operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getUsagePlanKey
default CompletableFuture<GetUsagePlanKeyResponse> getUsagePlanKey(GetUsagePlanKeyRequest getUsagePlanKeyRequest) Gets a usage plan key of a given key identifier.
- Parameters:
getUsagePlanKeyRequest- The GET request to get a usage plan key of a given key identifier.- Returns:
- A Java Future containing the result of the GetUsagePlanKey operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getUsagePlanKey
default CompletableFuture<GetUsagePlanKeyResponse> getUsagePlanKey(Consumer<GetUsagePlanKeyRequest.Builder> getUsagePlanKeyRequest) Gets a usage plan key of a given key identifier.
This is a convenience which creates an instance of the
GetUsagePlanKeyRequest.Builderavoiding the need to create one manually viaGetUsagePlanKeyRequest.builder()- Parameters:
getUsagePlanKeyRequest- AConsumerthat will call methods onGetUsagePlanKeyRequest.Builderto create a request. The GET request to get a usage plan key of a given key identifier.- Returns:
- A Java Future containing the result of the GetUsagePlanKey operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getUsagePlanKeys
default CompletableFuture<GetUsagePlanKeysResponse> getUsagePlanKeys(GetUsagePlanKeysRequest getUsagePlanKeysRequest) Gets all the usage plan keys representing the API keys added to a specified usage plan.
- Parameters:
getUsagePlanKeysRequest- The GET request to get all the usage plan keys representing the API keys added to a specified usage plan.- Returns:
- A Java Future containing the result of the GetUsagePlanKeys operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getUsagePlanKeys
default CompletableFuture<GetUsagePlanKeysResponse> getUsagePlanKeys(Consumer<GetUsagePlanKeysRequest.Builder> getUsagePlanKeysRequest) Gets all the usage plan keys representing the API keys added to a specified usage plan.
This is a convenience which creates an instance of the
GetUsagePlanKeysRequest.Builderavoiding the need to create one manually viaGetUsagePlanKeysRequest.builder()- Parameters:
getUsagePlanKeysRequest- AConsumerthat will call methods onGetUsagePlanKeysRequest.Builderto create a request. The GET request to get all the usage plan keys representing the API keys added to a specified usage plan.- Returns:
- A Java Future containing the result of the GetUsagePlanKeys operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getUsagePlanKeysPaginator
default GetUsagePlanKeysPublisher getUsagePlanKeysPaginator(GetUsagePlanKeysRequest getUsagePlanKeysRequest) This is a variant of
getUsagePlanKeys(software.amazon.awssdk.services.apigateway.model.GetUsagePlanKeysRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.apigateway.paginators.GetUsagePlanKeysPublisher publisher = client.getUsagePlanKeysPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.apigateway.paginators.GetUsagePlanKeysPublisher publisher = client.getUsagePlanKeysPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.apigateway.model.GetUsagePlanKeysResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.apigateway.model.GetUsagePlanKeysResponse response) { //... }; });Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getUsagePlanKeys(software.amazon.awssdk.services.apigateway.model.GetUsagePlanKeysRequest)operation.- Parameters:
getUsagePlanKeysRequest- The GET request to get all the usage plan keys representing the API keys added to a specified usage plan.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getUsagePlanKeysPaginator
default GetUsagePlanKeysPublisher getUsagePlanKeysPaginator(Consumer<GetUsagePlanKeysRequest.Builder> getUsagePlanKeysRequest) This is a variant of
getUsagePlanKeys(software.amazon.awssdk.services.apigateway.model.GetUsagePlanKeysRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.apigateway.paginators.GetUsagePlanKeysPublisher publisher = client.getUsagePlanKeysPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.apigateway.paginators.GetUsagePlanKeysPublisher publisher = client.getUsagePlanKeysPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.apigateway.model.GetUsagePlanKeysResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.apigateway.model.GetUsagePlanKeysResponse response) { //... }; });Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getUsagePlanKeys(software.amazon.awssdk.services.apigateway.model.GetUsagePlanKeysRequest)operation.
This is a convenience which creates an instance of the
GetUsagePlanKeysRequest.Builderavoiding the need to create one manually viaGetUsagePlanKeysRequest.builder()- Parameters:
getUsagePlanKeysRequest- AConsumerthat will call methods onGetUsagePlanKeysRequest.Builderto create a request. The GET request to get all the usage plan keys representing the API keys added to a specified usage plan.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getUsagePlans
default CompletableFuture<GetUsagePlansResponse> getUsagePlans(GetUsagePlansRequest getUsagePlansRequest) Gets all the usage plans of the caller's account.
- Parameters:
getUsagePlansRequest- The GET request to get all the usage plans of the caller's account.- Returns:
- A Java Future containing the result of the GetUsagePlans operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getUsagePlans
default CompletableFuture<GetUsagePlansResponse> getUsagePlans(Consumer<GetUsagePlansRequest.Builder> getUsagePlansRequest) Gets all the usage plans of the caller's account.
This is a convenience which creates an instance of the
GetUsagePlansRequest.Builderavoiding the need to create one manually viaGetUsagePlansRequest.builder()- Parameters:
getUsagePlansRequest- AConsumerthat will call methods onGetUsagePlansRequest.Builderto create a request. The GET request to get all the usage plans of the caller's account.- Returns:
- A Java Future containing the result of the GetUsagePlans operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getUsagePlans
Gets all the usage plans of the caller's account.
- Returns:
- A Java Future containing the result of the GetUsagePlans operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getUsagePlansPaginator
This is a variant of
getUsagePlans(software.amazon.awssdk.services.apigateway.model.GetUsagePlansRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.apigateway.paginators.GetUsagePlansPublisher publisher = client.getUsagePlansPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.apigateway.paginators.GetUsagePlansPublisher publisher = client.getUsagePlansPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.apigateway.model.GetUsagePlansResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.apigateway.model.GetUsagePlansResponse response) { //... }; });Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getUsagePlans(software.amazon.awssdk.services.apigateway.model.GetUsagePlansRequest)operation.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getUsagePlansPaginator
This is a variant of
getUsagePlans(software.amazon.awssdk.services.apigateway.model.GetUsagePlansRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.apigateway.paginators.GetUsagePlansPublisher publisher = client.getUsagePlansPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.apigateway.paginators.GetUsagePlansPublisher publisher = client.getUsagePlansPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.apigateway.model.GetUsagePlansResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.apigateway.model.GetUsagePlansResponse response) { //... }; });Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getUsagePlans(software.amazon.awssdk.services.apigateway.model.GetUsagePlansRequest)operation.- Parameters:
getUsagePlansRequest- The GET request to get all the usage plans of the caller's account.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getUsagePlansPaginator
default GetUsagePlansPublisher getUsagePlansPaginator(Consumer<GetUsagePlansRequest.Builder> getUsagePlansRequest) This is a variant of
getUsagePlans(software.amazon.awssdk.services.apigateway.model.GetUsagePlansRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.apigateway.paginators.GetUsagePlansPublisher publisher = client.getUsagePlansPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.apigateway.paginators.GetUsagePlansPublisher publisher = client.getUsagePlansPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.apigateway.model.GetUsagePlansResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.apigateway.model.GetUsagePlansResponse response) { //... }; });Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getUsagePlans(software.amazon.awssdk.services.apigateway.model.GetUsagePlansRequest)operation.
This is a convenience which creates an instance of the
GetUsagePlansRequest.Builderavoiding the need to create one manually viaGetUsagePlansRequest.builder()- Parameters:
getUsagePlansRequest- AConsumerthat will call methods onGetUsagePlansRequest.Builderto create a request. The GET request to get all the usage plans of the caller's account.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getVpcLink
Gets a specified VPC link under the caller's account in a region.
- Parameters:
getVpcLinkRequest- Gets a specified VPC link under the caller's account in a region.- Returns:
- A Java Future containing the result of the GetVpcLink operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getVpcLink
default CompletableFuture<GetVpcLinkResponse> getVpcLink(Consumer<GetVpcLinkRequest.Builder> getVpcLinkRequest) Gets a specified VPC link under the caller's account in a region.
This is a convenience which creates an instance of the
GetVpcLinkRequest.Builderavoiding the need to create one manually viaGetVpcLinkRequest.builder()- Parameters:
getVpcLinkRequest- AConsumerthat will call methods onGetVpcLinkRequest.Builderto create a request. Gets a specified VPC link under the caller's account in a region.- Returns:
- A Java Future containing the result of the GetVpcLink operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getVpcLinks
Gets the VpcLinks collection under the caller's account in a selected region.
- Parameters:
getVpcLinksRequest- Gets the VpcLinks collection under the caller's account in a selected region.- Returns:
- A Java Future containing the result of the GetVpcLinks operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getVpcLinks
default CompletableFuture<GetVpcLinksResponse> getVpcLinks(Consumer<GetVpcLinksRequest.Builder> getVpcLinksRequest) Gets the VpcLinks collection under the caller's account in a selected region.
This is a convenience which creates an instance of the
GetVpcLinksRequest.Builderavoiding the need to create one manually viaGetVpcLinksRequest.builder()- Parameters:
getVpcLinksRequest- AConsumerthat will call methods onGetVpcLinksRequest.Builderto create a request. Gets the VpcLinks collection under the caller's account in a selected region.- Returns:
- A Java Future containing the result of the GetVpcLinks operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getVpcLinks
Gets the VpcLinks collection under the caller's account in a selected region.
- Returns:
- A Java Future containing the result of the GetVpcLinks operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getVpcLinksPaginator
This is a variant of
getVpcLinks(software.amazon.awssdk.services.apigateway.model.GetVpcLinksRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.apigateway.paginators.GetVpcLinksPublisher publisher = client.getVpcLinksPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.apigateway.paginators.GetVpcLinksPublisher publisher = client.getVpcLinksPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.apigateway.model.GetVpcLinksResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.apigateway.model.GetVpcLinksResponse response) { //... }; });Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getVpcLinks(software.amazon.awssdk.services.apigateway.model.GetVpcLinksRequest)operation.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getVpcLinksPaginator
This is a variant of
getVpcLinks(software.amazon.awssdk.services.apigateway.model.GetVpcLinksRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.apigateway.paginators.GetVpcLinksPublisher publisher = client.getVpcLinksPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.apigateway.paginators.GetVpcLinksPublisher publisher = client.getVpcLinksPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.apigateway.model.GetVpcLinksResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.apigateway.model.GetVpcLinksResponse response) { //... }; });Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getVpcLinks(software.amazon.awssdk.services.apigateway.model.GetVpcLinksRequest)operation.- Parameters:
getVpcLinksRequest- Gets the VpcLinks collection under the caller's account in a selected region.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
getVpcLinksPaginator
default GetVpcLinksPublisher getVpcLinksPaginator(Consumer<GetVpcLinksRequest.Builder> getVpcLinksRequest) This is a variant of
getVpcLinks(software.amazon.awssdk.services.apigateway.model.GetVpcLinksRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.apigateway.paginators.GetVpcLinksPublisher publisher = client.getVpcLinksPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.apigateway.paginators.GetVpcLinksPublisher publisher = client.getVpcLinksPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.apigateway.model.GetVpcLinksResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.apigateway.model.GetVpcLinksResponse response) { //... }; });Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getVpcLinks(software.amazon.awssdk.services.apigateway.model.GetVpcLinksRequest)operation.
This is a convenience which creates an instance of the
GetVpcLinksRequest.Builderavoiding the need to create one manually viaGetVpcLinksRequest.builder()- Parameters:
getVpcLinksRequest- AConsumerthat will call methods onGetVpcLinksRequest.Builderto create a request. Gets the VpcLinks collection under the caller's account in a selected region.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
importApiKeys
default CompletableFuture<ImportApiKeysResponse> importApiKeys(ImportApiKeysRequest importApiKeysRequest) Import API keys from an external source, such as a CSV-formatted file.
- Parameters:
importApiKeysRequest- The POST request to import API keys from an external source, such as a CSV-formatted file.- Returns:
- A Java Future containing the result of the ImportApiKeys operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
importApiKeys
default CompletableFuture<ImportApiKeysResponse> importApiKeys(Consumer<ImportApiKeysRequest.Builder> importApiKeysRequest) Import API keys from an external source, such as a CSV-formatted file.
This is a convenience which creates an instance of the
ImportApiKeysRequest.Builderavoiding the need to create one manually viaImportApiKeysRequest.builder()- Parameters:
importApiKeysRequest- AConsumerthat will call methods onImportApiKeysRequest.Builderto create a request. The POST request to import API keys from an external source, such as a CSV-formatted file.- Returns:
- A Java Future containing the result of the ImportApiKeys operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
importDocumentationParts
default CompletableFuture<ImportDocumentationPartsResponse> importDocumentationParts(ImportDocumentationPartsRequest importDocumentationPartsRequest) Imports documentation parts
- Parameters:
importDocumentationPartsRequest- Import documentation parts from an external (e.g., OpenAPI) definition file.- Returns:
- A Java Future containing the result of the ImportDocumentationParts operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
importDocumentationParts
default CompletableFuture<ImportDocumentationPartsResponse> importDocumentationParts(Consumer<ImportDocumentationPartsRequest.Builder> importDocumentationPartsRequest) Imports documentation parts
This is a convenience which creates an instance of the
ImportDocumentationPartsRequest.Builderavoiding the need to create one manually viaImportDocumentationPartsRequest.builder()- Parameters:
importDocumentationPartsRequest- AConsumerthat will call methods onImportDocumentationPartsRequest.Builderto create a request. Import documentation parts from an external (e.g., OpenAPI) definition file.- Returns:
- A Java Future containing the result of the ImportDocumentationParts operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
importRestApi
default CompletableFuture<ImportRestApiResponse> importRestApi(ImportRestApiRequest importRestApiRequest) A feature of the API Gateway control service for creating a new API from an external API definition file.
- Parameters:
importRestApiRequest- A POST request to import an API to API Gateway using an input of an API definition file.- Returns:
- A Java Future containing the result of the ImportRestApi operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
importRestApi
default CompletableFuture<ImportRestApiResponse> importRestApi(Consumer<ImportRestApiRequest.Builder> importRestApiRequest) A feature of the API Gateway control service for creating a new API from an external API definition file.
This is a convenience which creates an instance of the
ImportRestApiRequest.Builderavoiding the need to create one manually viaImportRestApiRequest.builder()- Parameters:
importRestApiRequest- AConsumerthat will call methods onImportRestApiRequest.Builderto create a request. A POST request to import an API to API Gateway using an input of an API definition file.- Returns:
- A Java Future containing the result of the ImportRestApi operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
putGatewayResponse
default CompletableFuture<PutGatewayResponseResponse> putGatewayResponse(PutGatewayResponseRequest putGatewayResponseRequest) Creates a customization of a GatewayResponse of a specified response type and status code on the given RestApi.
- Parameters:
putGatewayResponseRequest- Creates a customization of a GatewayResponse of a specified response type and status code on the given RestApi.- Returns:
- A Java Future containing the result of the PutGatewayResponse operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
putGatewayResponse
default CompletableFuture<PutGatewayResponseResponse> putGatewayResponse(Consumer<PutGatewayResponseRequest.Builder> putGatewayResponseRequest) Creates a customization of a GatewayResponse of a specified response type and status code on the given RestApi.
This is a convenience which creates an instance of the
PutGatewayResponseRequest.Builderavoiding the need to create one manually viaPutGatewayResponseRequest.builder()- Parameters:
putGatewayResponseRequest- AConsumerthat will call methods onPutGatewayResponseRequest.Builderto create a request. Creates a customization of a GatewayResponse of a specified response type and status code on the given RestApi.- Returns:
- A Java Future containing the result of the PutGatewayResponse operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
putIntegration
default CompletableFuture<PutIntegrationResponse> putIntegration(PutIntegrationRequest putIntegrationRequest) Sets up a method's integration.
- Parameters:
putIntegrationRequest- Sets up a method's integration.- Returns:
- A Java Future containing the result of the PutIntegration operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
putIntegration
default CompletableFuture<PutIntegrationResponse> putIntegration(Consumer<PutIntegrationRequest.Builder> putIntegrationRequest) Sets up a method's integration.
This is a convenience which creates an instance of the
PutIntegrationRequest.Builderavoiding the need to create one manually viaPutIntegrationRequest.builder()- Parameters:
putIntegrationRequest- AConsumerthat will call methods onPutIntegrationRequest.Builderto create a request. Sets up a method's integration.- Returns:
- A Java Future containing the result of the PutIntegration operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
putIntegrationResponse
default CompletableFuture<PutIntegrationResponseResponse> putIntegrationResponse(PutIntegrationResponseRequest putIntegrationResponseRequest) Represents a put integration.
- Parameters:
putIntegrationResponseRequest- Represents a put integration response request.- Returns:
- A Java Future containing the result of the PutIntegrationResponse operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
putIntegrationResponse
default CompletableFuture<PutIntegrationResponseResponse> putIntegrationResponse(Consumer<PutIntegrationResponseRequest.Builder> putIntegrationResponseRequest) Represents a put integration.
This is a convenience which creates an instance of the
PutIntegrationResponseRequest.Builderavoiding the need to create one manually viaPutIntegrationResponseRequest.builder()- Parameters:
putIntegrationResponseRequest- AConsumerthat will call methods onPutIntegrationResponseRequest.Builderto create a request. Represents a put integration response request.- Returns:
- A Java Future containing the result of the PutIntegrationResponse operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
putMethod
Add a method to an existing Resource resource.
- Parameters:
putMethodRequest- Request to add a method to an existing Resource resource.- Returns:
- A Java Future containing the result of the PutMethod operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
putMethod
default CompletableFuture<PutMethodResponse> putMethod(Consumer<PutMethodRequest.Builder> putMethodRequest) Add a method to an existing Resource resource.
This is a convenience which creates an instance of the
PutMethodRequest.Builderavoiding the need to create one manually viaPutMethodRequest.builder()- Parameters:
putMethodRequest- AConsumerthat will call methods onPutMethodRequest.Builderto create a request. Request to add a method to an existing Resource resource.- Returns:
- A Java Future containing the result of the PutMethod operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
putMethodResponse
default CompletableFuture<PutMethodResponseResponse> putMethodResponse(PutMethodResponseRequest putMethodResponseRequest) Adds a MethodResponse to an existing Method resource.
- Parameters:
putMethodResponseRequest- Request to add a MethodResponse to an existing Method resource.- Returns:
- A Java Future containing the result of the PutMethodResponse operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
putMethodResponse
default CompletableFuture<PutMethodResponseResponse> putMethodResponse(Consumer<PutMethodResponseRequest.Builder> putMethodResponseRequest) Adds a MethodResponse to an existing Method resource.
This is a convenience which creates an instance of the
PutMethodResponseRequest.Builderavoiding the need to create one manually viaPutMethodResponseRequest.builder()- Parameters:
putMethodResponseRequest- AConsumerthat will call methods onPutMethodResponseRequest.Builderto create a request. Request to add a MethodResponse to an existing Method resource.- Returns:
- A Java Future containing the result of the PutMethodResponse operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
putRestApi
A feature of the API Gateway control service for updating an existing API with an input of external API definitions. The update can take the form of merging the supplied definition into the existing API or overwriting the existing API.
- Parameters:
putRestApiRequest- A PUT request to update an existing API, with external API definitions specified as the request body.- Returns:
- A Java Future containing the result of the PutRestApi operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
putRestApi
default CompletableFuture<PutRestApiResponse> putRestApi(Consumer<PutRestApiRequest.Builder> putRestApiRequest) A feature of the API Gateway control service for updating an existing API with an input of external API definitions. The update can take the form of merging the supplied definition into the existing API or overwriting the existing API.
This is a convenience which creates an instance of the
PutRestApiRequest.Builderavoiding the need to create one manually viaPutRestApiRequest.builder()- Parameters:
putRestApiRequest- AConsumerthat will call methods onPutRestApiRequest.Builderto create a request. A PUT request to update an existing API, with external API definitions specified as the request body.- Returns:
- A Java Future containing the result of the PutRestApi operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
tagResource
Adds or updates a tag on a given resource.
- Parameters:
tagResourceRequest- Adds or updates a tag on a given resource.- Returns:
- A Java Future containing the result of the TagResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
tagResource
default CompletableFuture<TagResourceResponse> tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) Adds or updates a tag on a given resource.
This is a convenience which creates an instance of the
TagResourceRequest.Builderavoiding the need to create one manually viaTagResourceRequest.builder()- Parameters:
tagResourceRequest- AConsumerthat will call methods onTagResourceRequest.Builderto create a request. Adds or updates a tag on a given resource.- Returns:
- A Java Future containing the result of the TagResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
testInvokeAuthorizer
default CompletableFuture<TestInvokeAuthorizerResponse> testInvokeAuthorizer(TestInvokeAuthorizerRequest testInvokeAuthorizerRequest) Simulate the execution of an Authorizer in your RestApi with headers, parameters, and an incoming request body.
- Parameters:
testInvokeAuthorizerRequest- Make a request to simulate the invocation of an Authorizer.- Returns:
- A Java Future containing the result of the TestInvokeAuthorizer operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
testInvokeAuthorizer
default CompletableFuture<TestInvokeAuthorizerResponse> testInvokeAuthorizer(Consumer<TestInvokeAuthorizerRequest.Builder> testInvokeAuthorizerRequest) Simulate the execution of an Authorizer in your RestApi with headers, parameters, and an incoming request body.
This is a convenience which creates an instance of the
TestInvokeAuthorizerRequest.Builderavoiding the need to create one manually viaTestInvokeAuthorizerRequest.builder()- Parameters:
testInvokeAuthorizerRequest- AConsumerthat will call methods onTestInvokeAuthorizerRequest.Builderto create a request. Make a request to simulate the invocation of an Authorizer.- Returns:
- A Java Future containing the result of the TestInvokeAuthorizer operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
testInvokeMethod
default CompletableFuture<TestInvokeMethodResponse> testInvokeMethod(TestInvokeMethodRequest testInvokeMethodRequest) Simulate the invocation of a Method in your RestApi with headers, parameters, and an incoming request body.
- Parameters:
testInvokeMethodRequest- Make a request to simulate the invocation of a Method.- Returns:
- A Java Future containing the result of the TestInvokeMethod operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
testInvokeMethod
default CompletableFuture<TestInvokeMethodResponse> testInvokeMethod(Consumer<TestInvokeMethodRequest.Builder> testInvokeMethodRequest) Simulate the invocation of a Method in your RestApi with headers, parameters, and an incoming request body.
This is a convenience which creates an instance of the
TestInvokeMethodRequest.Builderavoiding the need to create one manually viaTestInvokeMethodRequest.builder()- Parameters:
testInvokeMethodRequest- AConsumerthat will call methods onTestInvokeMethodRequest.Builderto create a request. Make a request to simulate the invocation of a Method.- Returns:
- A Java Future containing the result of the TestInvokeMethod operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
untagResource
default CompletableFuture<UntagResourceResponse> untagResource(UntagResourceRequest untagResourceRequest) Removes a tag from a given resource.
- Parameters:
untagResourceRequest- Removes a tag from a given resource.- Returns:
- A Java Future containing the result of the UntagResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
untagResource
default CompletableFuture<UntagResourceResponse> untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) Removes a tag from a given resource.
This is a convenience which creates an instance of the
UntagResourceRequest.Builderavoiding the need to create one manually viaUntagResourceRequest.builder()- Parameters:
untagResourceRequest- AConsumerthat will call methods onUntagResourceRequest.Builderto create a request. Removes a tag from a given resource.- Returns:
- A Java Future containing the result of the UntagResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateAccount
default CompletableFuture<UpdateAccountResponse> updateAccount(UpdateAccountRequest updateAccountRequest) Changes information about the current Account resource.
- Parameters:
updateAccountRequest- Requests API Gateway to change information about the current Account resource.- Returns:
- A Java Future containing the result of the UpdateAccount operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateAccount
default CompletableFuture<UpdateAccountResponse> updateAccount(Consumer<UpdateAccountRequest.Builder> updateAccountRequest) Changes information about the current Account resource.
This is a convenience which creates an instance of the
UpdateAccountRequest.Builderavoiding the need to create one manually viaUpdateAccountRequest.builder()- Parameters:
updateAccountRequest- AConsumerthat will call methods onUpdateAccountRequest.Builderto create a request. Requests API Gateway to change information about the current Account resource.- Returns:
- A Java Future containing the result of the UpdateAccount operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateApiKey
default CompletableFuture<UpdateApiKeyResponse> updateApiKey(UpdateApiKeyRequest updateApiKeyRequest) Changes information about an ApiKey resource.
- Parameters:
updateApiKeyRequest- A request to change information about an ApiKey resource.- Returns:
- A Java Future containing the result of the UpdateApiKey operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateApiKey
default CompletableFuture<UpdateApiKeyResponse> updateApiKey(Consumer<UpdateApiKeyRequest.Builder> updateApiKeyRequest) Changes information about an ApiKey resource.
This is a convenience which creates an instance of the
UpdateApiKeyRequest.Builderavoiding the need to create one manually viaUpdateApiKeyRequest.builder()- Parameters:
updateApiKeyRequest- AConsumerthat will call methods onUpdateApiKeyRequest.Builderto create a request. A request to change information about an ApiKey resource.- Returns:
- A Java Future containing the result of the UpdateApiKey operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateAuthorizer
default CompletableFuture<UpdateAuthorizerResponse> updateAuthorizer(UpdateAuthorizerRequest updateAuthorizerRequest) Updates an existing Authorizer resource.
- Parameters:
updateAuthorizerRequest- Request to update an existing Authorizer resource.- Returns:
- A Java Future containing the result of the UpdateAuthorizer operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateAuthorizer
default CompletableFuture<UpdateAuthorizerResponse> updateAuthorizer(Consumer<UpdateAuthorizerRequest.Builder> updateAuthorizerRequest) Updates an existing Authorizer resource.
This is a convenience which creates an instance of the
UpdateAuthorizerRequest.Builderavoiding the need to create one manually viaUpdateAuthorizerRequest.builder()- Parameters:
updateAuthorizerRequest- AConsumerthat will call methods onUpdateAuthorizerRequest.Builderto create a request. Request to update an existing Authorizer resource.- Returns:
- A Java Future containing the result of the UpdateAuthorizer operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateBasePathMapping
default CompletableFuture<UpdateBasePathMappingResponse> updateBasePathMapping(UpdateBasePathMappingRequest updateBasePathMappingRequest) Changes information about the BasePathMapping resource.
- Parameters:
updateBasePathMappingRequest- A request to change information about the BasePathMapping resource.- Returns:
- A Java Future containing the result of the UpdateBasePathMapping operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateBasePathMapping
default CompletableFuture<UpdateBasePathMappingResponse> updateBasePathMapping(Consumer<UpdateBasePathMappingRequest.Builder> updateBasePathMappingRequest) Changes information about the BasePathMapping resource.
This is a convenience which creates an instance of the
UpdateBasePathMappingRequest.Builderavoiding the need to create one manually viaUpdateBasePathMappingRequest.builder()- Parameters:
updateBasePathMappingRequest- AConsumerthat will call methods onUpdateBasePathMappingRequest.Builderto create a request. A request to change information about the BasePathMapping resource.- Returns:
- A Java Future containing the result of the UpdateBasePathMapping operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateClientCertificate
default CompletableFuture<UpdateClientCertificateResponse> updateClientCertificate(UpdateClientCertificateRequest updateClientCertificateRequest) Changes information about an ClientCertificate resource.
- Parameters:
updateClientCertificateRequest- A request to change information about an ClientCertificate resource.- Returns:
- A Java Future containing the result of the UpdateClientCertificate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateClientCertificate
default CompletableFuture<UpdateClientCertificateResponse> updateClientCertificate(Consumer<UpdateClientCertificateRequest.Builder> updateClientCertificateRequest) Changes information about an ClientCertificate resource.
This is a convenience which creates an instance of the
UpdateClientCertificateRequest.Builderavoiding the need to create one manually viaUpdateClientCertificateRequest.builder()- Parameters:
updateClientCertificateRequest- AConsumerthat will call methods onUpdateClientCertificateRequest.Builderto create a request. A request to change information about an ClientCertificate resource.- Returns:
- A Java Future containing the result of the UpdateClientCertificate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateDeployment
default CompletableFuture<UpdateDeploymentResponse> updateDeployment(UpdateDeploymentRequest updateDeploymentRequest) Changes information about a Deployment resource.
- Parameters:
updateDeploymentRequest- Requests API Gateway to change information about a Deployment resource.- Returns:
- A Java Future containing the result of the UpdateDeployment operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- ServiceUnavailableException The requested service is not available. For details see the accompanying error message. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateDeployment
default CompletableFuture<UpdateDeploymentResponse> updateDeployment(Consumer<UpdateDeploymentRequest.Builder> updateDeploymentRequest) Changes information about a Deployment resource.
This is a convenience which creates an instance of the
UpdateDeploymentRequest.Builderavoiding the need to create one manually viaUpdateDeploymentRequest.builder()- Parameters:
updateDeploymentRequest- AConsumerthat will call methods onUpdateDeploymentRequest.Builderto create a request. Requests API Gateway to change information about a Deployment resource.- Returns:
- A Java Future containing the result of the UpdateDeployment operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- ServiceUnavailableException The requested service is not available. For details see the accompanying error message. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateDocumentationPart
default CompletableFuture<UpdateDocumentationPartResponse> updateDocumentationPart(UpdateDocumentationPartRequest updateDocumentationPartRequest) Updates a documentation part.
- Parameters:
updateDocumentationPartRequest- Updates an existing documentation part of a given API.- Returns:
- A Java Future containing the result of the UpdateDocumentationPart operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateDocumentationPart
default CompletableFuture<UpdateDocumentationPartResponse> updateDocumentationPart(Consumer<UpdateDocumentationPartRequest.Builder> updateDocumentationPartRequest) Updates a documentation part.
This is a convenience which creates an instance of the
UpdateDocumentationPartRequest.Builderavoiding the need to create one manually viaUpdateDocumentationPartRequest.builder()- Parameters:
updateDocumentationPartRequest- AConsumerthat will call methods onUpdateDocumentationPartRequest.Builderto create a request. Updates an existing documentation part of a given API.- Returns:
- A Java Future containing the result of the UpdateDocumentationPart operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateDocumentationVersion
default CompletableFuture<UpdateDocumentationVersionResponse> updateDocumentationVersion(UpdateDocumentationVersionRequest updateDocumentationVersionRequest) Updates a documentation version.
- Parameters:
updateDocumentationVersionRequest- Updates an existing documentation version of an API.- Returns:
- A Java Future containing the result of the UpdateDocumentationVersion operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateDocumentationVersion
default CompletableFuture<UpdateDocumentationVersionResponse> updateDocumentationVersion(Consumer<UpdateDocumentationVersionRequest.Builder> updateDocumentationVersionRequest) Updates a documentation version.
This is a convenience which creates an instance of the
UpdateDocumentationVersionRequest.Builderavoiding the need to create one manually viaUpdateDocumentationVersionRequest.builder()- Parameters:
updateDocumentationVersionRequest- AConsumerthat will call methods onUpdateDocumentationVersionRequest.Builderto create a request. Updates an existing documentation version of an API.- Returns:
- A Java Future containing the result of the UpdateDocumentationVersion operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateDomainName
default CompletableFuture<UpdateDomainNameResponse> updateDomainName(UpdateDomainNameRequest updateDomainNameRequest) Changes information about the DomainName resource.
- Parameters:
updateDomainNameRequest- A request to change information about the DomainName resource.- Returns:
- A Java Future containing the result of the UpdateDomainName operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateDomainName
default CompletableFuture<UpdateDomainNameResponse> updateDomainName(Consumer<UpdateDomainNameRequest.Builder> updateDomainNameRequest) Changes information about the DomainName resource.
This is a convenience which creates an instance of the
UpdateDomainNameRequest.Builderavoiding the need to create one manually viaUpdateDomainNameRequest.builder()- Parameters:
updateDomainNameRequest- AConsumerthat will call methods onUpdateDomainNameRequest.Builderto create a request. A request to change information about the DomainName resource.- Returns:
- A Java Future containing the result of the UpdateDomainName operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateGatewayResponse
default CompletableFuture<UpdateGatewayResponseResponse> updateGatewayResponse(UpdateGatewayResponseRequest updateGatewayResponseRequest) Updates a GatewayResponse of a specified response type on the given RestApi.
- Parameters:
updateGatewayResponseRequest- Updates a GatewayResponse of a specified response type on the given RestApi.- Returns:
- A Java Future containing the result of the UpdateGatewayResponse operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateGatewayResponse
default CompletableFuture<UpdateGatewayResponseResponse> updateGatewayResponse(Consumer<UpdateGatewayResponseRequest.Builder> updateGatewayResponseRequest) Updates a GatewayResponse of a specified response type on the given RestApi.
This is a convenience which creates an instance of the
UpdateGatewayResponseRequest.Builderavoiding the need to create one manually viaUpdateGatewayResponseRequest.builder()- Parameters:
updateGatewayResponseRequest- AConsumerthat will call methods onUpdateGatewayResponseRequest.Builderto create a request. Updates a GatewayResponse of a specified response type on the given RestApi.- Returns:
- A Java Future containing the result of the UpdateGatewayResponse operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateIntegration
default CompletableFuture<UpdateIntegrationResponse> updateIntegration(UpdateIntegrationRequest updateIntegrationRequest) Represents an update integration.
- Parameters:
updateIntegrationRequest- Represents an update integration request.- Returns:
- A Java Future containing the result of the UpdateIntegration operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateIntegration
default CompletableFuture<UpdateIntegrationResponse> updateIntegration(Consumer<UpdateIntegrationRequest.Builder> updateIntegrationRequest) Represents an update integration.
This is a convenience which creates an instance of the
UpdateIntegrationRequest.Builderavoiding the need to create one manually viaUpdateIntegrationRequest.builder()- Parameters:
updateIntegrationRequest- AConsumerthat will call methods onUpdateIntegrationRequest.Builderto create a request. Represents an update integration request.- Returns:
- A Java Future containing the result of the UpdateIntegration operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateIntegrationResponse
default CompletableFuture<UpdateIntegrationResponseResponse> updateIntegrationResponse(UpdateIntegrationResponseRequest updateIntegrationResponseRequest) Represents an update integration response.
- Parameters:
updateIntegrationResponseRequest- Represents an update integration response request.- Returns:
- A Java Future containing the result of the UpdateIntegrationResponse operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateIntegrationResponse
default CompletableFuture<UpdateIntegrationResponseResponse> updateIntegrationResponse(Consumer<UpdateIntegrationResponseRequest.Builder> updateIntegrationResponseRequest) Represents an update integration response.
This is a convenience which creates an instance of the
UpdateIntegrationResponseRequest.Builderavoiding the need to create one manually viaUpdateIntegrationResponseRequest.builder()- Parameters:
updateIntegrationResponseRequest- AConsumerthat will call methods onUpdateIntegrationResponseRequest.Builderto create a request. Represents an update integration response request.- Returns:
- A Java Future containing the result of the UpdateIntegrationResponse operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateMethod
default CompletableFuture<UpdateMethodResponse> updateMethod(UpdateMethodRequest updateMethodRequest) Updates an existing Method resource.
- Parameters:
updateMethodRequest- Request to update an existing Method resource.- Returns:
- A Java Future containing the result of the UpdateMethod operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateMethod
default CompletableFuture<UpdateMethodResponse> updateMethod(Consumer<UpdateMethodRequest.Builder> updateMethodRequest) Updates an existing Method resource.
This is a convenience which creates an instance of the
UpdateMethodRequest.Builderavoiding the need to create one manually viaUpdateMethodRequest.builder()- Parameters:
updateMethodRequest- AConsumerthat will call methods onUpdateMethodRequest.Builderto create a request. Request to update an existing Method resource.- Returns:
- A Java Future containing the result of the UpdateMethod operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateMethodResponse
default CompletableFuture<UpdateMethodResponseResponse> updateMethodResponse(UpdateMethodResponseRequest updateMethodResponseRequest) Updates an existing MethodResponse resource.
- Parameters:
updateMethodResponseRequest- A request to update an existing MethodResponse resource.- Returns:
- A Java Future containing the result of the UpdateMethodResponse operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateMethodResponse
default CompletableFuture<UpdateMethodResponseResponse> updateMethodResponse(Consumer<UpdateMethodResponseRequest.Builder> updateMethodResponseRequest) Updates an existing MethodResponse resource.
This is a convenience which creates an instance of the
UpdateMethodResponseRequest.Builderavoiding the need to create one manually viaUpdateMethodResponseRequest.builder()- Parameters:
updateMethodResponseRequest- AConsumerthat will call methods onUpdateMethodResponseRequest.Builderto create a request. A request to update an existing MethodResponse resource.- Returns:
- A Java Future containing the result of the UpdateMethodResponse operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateModel
Changes information about a model. The maximum size of the model is 400 KB.
- Parameters:
updateModelRequest- Request to update an existing model in an existing RestApi resource.- Returns:
- A Java Future containing the result of the UpdateModel operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateModel
default CompletableFuture<UpdateModelResponse> updateModel(Consumer<UpdateModelRequest.Builder> updateModelRequest) Changes information about a model. The maximum size of the model is 400 KB.
This is a convenience which creates an instance of the
UpdateModelRequest.Builderavoiding the need to create one manually viaUpdateModelRequest.builder()- Parameters:
updateModelRequest- AConsumerthat will call methods onUpdateModelRequest.Builderto create a request. Request to update an existing model in an existing RestApi resource.- Returns:
- A Java Future containing the result of the UpdateModel operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateRequestValidator
default CompletableFuture<UpdateRequestValidatorResponse> updateRequestValidator(UpdateRequestValidatorRequest updateRequestValidatorRequest) Updates a RequestValidator of a given RestApi.
- Parameters:
updateRequestValidatorRequest- Updates a RequestValidator of a given RestApi.- Returns:
- A Java Future containing the result of the UpdateRequestValidator operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateRequestValidator
default CompletableFuture<UpdateRequestValidatorResponse> updateRequestValidator(Consumer<UpdateRequestValidatorRequest.Builder> updateRequestValidatorRequest) Updates a RequestValidator of a given RestApi.
This is a convenience which creates an instance of the
UpdateRequestValidatorRequest.Builderavoiding the need to create one manually viaUpdateRequestValidatorRequest.builder()- Parameters:
updateRequestValidatorRequest- AConsumerthat will call methods onUpdateRequestValidatorRequest.Builderto create a request. Updates a RequestValidator of a given RestApi.- Returns:
- A Java Future containing the result of the UpdateRequestValidator operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateResource
default CompletableFuture<UpdateResourceResponse> updateResource(UpdateResourceRequest updateResourceRequest) Changes information about a Resource resource.
- Parameters:
updateResourceRequest- Request to change information about a Resource resource.- Returns:
- A Java Future containing the result of the UpdateResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateResource
default CompletableFuture<UpdateResourceResponse> updateResource(Consumer<UpdateResourceRequest.Builder> updateResourceRequest) Changes information about a Resource resource.
This is a convenience which creates an instance of the
UpdateResourceRequest.Builderavoiding the need to create one manually viaUpdateResourceRequest.builder()- Parameters:
updateResourceRequest- AConsumerthat will call methods onUpdateResourceRequest.Builderto create a request. Request to change information about a Resource resource.- Returns:
- A Java Future containing the result of the UpdateResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- UnauthorizedException The request is denied because the caller has insufficient permissions.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateRestApi
default CompletableFuture<UpdateRestApiResponse> updateRestApi(UpdateRestApiRequest updateRestApiRequest) Changes information about the specified API.
- Parameters:
updateRestApiRequest- Request to update an existing RestApi resource in your collection.- Returns:
- A Java Future containing the result of the UpdateRestApi operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateRestApi
default CompletableFuture<UpdateRestApiResponse> updateRestApi(Consumer<UpdateRestApiRequest.Builder> updateRestApiRequest) Changes information about the specified API.
This is a convenience which creates an instance of the
UpdateRestApiRequest.Builderavoiding the need to create one manually viaUpdateRestApiRequest.builder()- Parameters:
updateRestApiRequest- AConsumerthat will call methods onUpdateRestApiRequest.Builderto create a request. Request to update an existing RestApi resource in your collection.- Returns:
- A Java Future containing the result of the UpdateRestApi operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateStage
Changes information about a Stage resource.
- Parameters:
updateStageRequest- Requests API Gateway to change information about a Stage resource.- Returns:
- A Java Future containing the result of the UpdateStage operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateStage
default CompletableFuture<UpdateStageResponse> updateStage(Consumer<UpdateStageRequest.Builder> updateStageRequest) Changes information about a Stage resource.
This is a convenience which creates an instance of the
UpdateStageRequest.Builderavoiding the need to create one manually viaUpdateStageRequest.builder()- Parameters:
updateStageRequest- AConsumerthat will call methods onUpdateStageRequest.Builderto create a request. Requests API Gateway to change information about a Stage resource.- Returns:
- A Java Future containing the result of the UpdateStage operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateUsage
Grants a temporary extension to the remaining quota of a usage plan associated with a specified API key.
- Parameters:
updateUsageRequest- The PATCH request to grant a temporary extension to the remaining quota of a usage plan associated with a specified API key.- Returns:
- A Java Future containing the result of the UpdateUsage operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateUsage
default CompletableFuture<UpdateUsageResponse> updateUsage(Consumer<UpdateUsageRequest.Builder> updateUsageRequest) Grants a temporary extension to the remaining quota of a usage plan associated with a specified API key.
This is a convenience which creates an instance of the
UpdateUsageRequest.Builderavoiding the need to create one manually viaUpdateUsageRequest.builder()- Parameters:
updateUsageRequest- AConsumerthat will call methods onUpdateUsageRequest.Builderto create a request. The PATCH request to grant a temporary extension to the remaining quota of a usage plan associated with a specified API key.- Returns:
- A Java Future containing the result of the UpdateUsage operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateUsagePlan
default CompletableFuture<UpdateUsagePlanResponse> updateUsagePlan(UpdateUsagePlanRequest updateUsagePlanRequest) Updates a usage plan of a given plan Id.
- Parameters:
updateUsagePlanRequest- The PATCH request to update a usage plan of a given plan Id.- Returns:
- A Java Future containing the result of the UpdateUsagePlan operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateUsagePlan
default CompletableFuture<UpdateUsagePlanResponse> updateUsagePlan(Consumer<UpdateUsagePlanRequest.Builder> updateUsagePlanRequest) Updates a usage plan of a given plan Id.
This is a convenience which creates an instance of the
UpdateUsagePlanRequest.Builderavoiding the need to create one manually viaUpdateUsagePlanRequest.builder()- Parameters:
updateUsagePlanRequest- AConsumerthat will call methods onUpdateUsagePlanRequest.Builderto create a request. The PATCH request to update a usage plan of a given plan Id.- Returns:
- A Java Future containing the result of the UpdateUsagePlan operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateVpcLink
default CompletableFuture<UpdateVpcLinkResponse> updateVpcLink(UpdateVpcLinkRequest updateVpcLinkRequest) Updates an existing VpcLink of a specified identifier.
- Parameters:
updateVpcLinkRequest- Updates an existing VpcLink of a specified identifier.- Returns:
- A Java Future containing the result of the UpdateVpcLink operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
updateVpcLink
default CompletableFuture<UpdateVpcLinkResponse> updateVpcLink(Consumer<UpdateVpcLinkRequest.Builder> updateVpcLinkRequest) Updates an existing VpcLink of a specified identifier.
This is a convenience which creates an instance of the
UpdateVpcLinkRequest.Builderavoiding the need to create one manually viaUpdateVpcLinkRequest.builder()- Parameters:
updateVpcLinkRequest- AConsumerthat will call methods onUpdateVpcLinkRequest.Builderto create a request. Updates an existing VpcLink of a specified identifier.- Returns:
- A Java Future containing the result of the UpdateVpcLink operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- BadRequestException The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.
- ConflictException The request configuration has conflicts. For details, see the accompanying error message.
- LimitExceededException The request exceeded the rate limit. Retry after the specified time period.
- NotFoundException The requested resource is not found. Make sure that the request URI is correct.
- UnauthorizedException The request is denied because the caller has insufficient permissions.
- TooManyRequestsException The request has reached its throttling limit. Retry after the specified time period.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- ApiGatewayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
-
serviceClientConfiguration
Description copied from interface:SdkClientThe SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration- Specified by:
serviceClientConfigurationin interfaceAwsClient- Specified by:
serviceClientConfigurationin interfaceSdkClient- Returns:
- SdkServiceClientConfiguration
-
create
Create aApiGatewayAsyncClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider. -
builder
Create a builder that can be used to configure and create aApiGatewayAsyncClient.
-