models.apigateway-2015-07-09-model.json Maven / Gradle / Ivy
Show all versions of aws-java-sdk-api-gateway Show documentation
{
"version":"2.0",
"metadata":{
"apiVersion":"2015-07-09",
"endpointPrefix":"apigateway",
"protocol":"rest-json",
"serviceFullName":"Amazon API Gateway",
"signatureVersion":"v4"
},
"operations":{
"CreateApiKey":{
"name":"CreateApiKey",
"http":{
"method":"POST",
"requestUri":"/apikeys",
"responseCode":201
},
"input":{"shape":"CreateApiKeyRequest"},
"output":{"shape":"ApiKey"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"},
{"shape":"LimitExceededException"},
{"shape":"BadRequestException"}
],
"documentation":"Create an ApiKey resource.
"
},
"CreateAuthorizer":{
"name":"CreateAuthorizer",
"http":{
"method":"POST",
"requestUri":"/restapis/{restapi_id}/authorizers",
"responseCode":201
},
"input":{"shape":"CreateAuthorizerRequest"},
"output":{"shape":"Authorizer"},
"errors":[
{"shape":"BadRequestException"},
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"LimitExceededException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Adds a new Authorizer resource to an existing RestApi resource.
"
},
"CreateBasePathMapping":{
"name":"CreateBasePathMapping",
"http":{
"method":"POST",
"requestUri":"/domainnames/{domain_name}/basepathmappings",
"responseCode":201
},
"input":{"shape":"CreateBasePathMappingRequest"},
"output":{"shape":"BasePathMapping"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"ConflictException"},
{"shape":"BadRequestException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Creates a new BasePathMapping resource.
"
},
"CreateDeployment":{
"name":"CreateDeployment",
"http":{
"method":"POST",
"requestUri":"/restapis/{restapi_id}/deployments",
"responseCode":201
},
"input":{"shape":"CreateDeploymentRequest"},
"output":{"shape":"Deployment"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"BadRequestException"},
{"shape":"NotFoundException"},
{"shape":"ConflictException"},
{"shape":"LimitExceededException"},
{"shape":"TooManyRequestsException"},
{"shape":"ServiceUnavailableException"}
],
"documentation":"Creates a Deployment resource, which makes a specified RestApi callable over the internet.
"
},
"CreateDomainName":{
"name":"CreateDomainName",
"http":{
"method":"POST",
"requestUri":"/domainnames",
"responseCode":201
},
"input":{"shape":"CreateDomainNameRequest"},
"output":{"shape":"DomainName"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"BadRequestException"},
{"shape":"ConflictException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Creates a new domain name.
"
},
"CreateModel":{
"name":"CreateModel",
"http":{
"method":"POST",
"requestUri":"/restapis/{restapi_id}/models",
"responseCode":201
},
"input":{"shape":"CreateModelRequest"},
"output":{"shape":"Model"},
"errors":[
{"shape":"BadRequestException"},
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"ConflictException"},
{"shape":"LimitExceededException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Adds a new Model resource to an existing RestApi resource.
"
},
"CreateResource":{
"name":"CreateResource",
"http":{
"method":"POST",
"requestUri":"/restapis/{restapi_id}/resources/{parent_id}",
"responseCode":201
},
"input":{"shape":"CreateResourceRequest"},
"output":{"shape":"Resource"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"ConflictException"},
{"shape":"LimitExceededException"},
{"shape":"BadRequestException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Creates a Resource resource.
"
},
"CreateRestApi":{
"name":"CreateRestApi",
"http":{
"method":"POST",
"requestUri":"/restapis",
"responseCode":201
},
"input":{"shape":"CreateRestApiRequest"},
"output":{"shape":"RestApi"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"LimitExceededException"},
{"shape":"BadRequestException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Creates a new RestApi resource.
"
},
"CreateStage":{
"name":"CreateStage",
"http":{
"method":"POST",
"requestUri":"/restapis/{restapi_id}/stages",
"responseCode":201
},
"input":{"shape":"CreateStageRequest"},
"output":{"shape":"Stage"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"BadRequestException"},
{"shape":"NotFoundException"},
{"shape":"ConflictException"},
{"shape":"LimitExceededException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Creates a new Stage resource that references a pre-existing Deployment for the API.
"
},
"DeleteApiKey":{
"name":"DeleteApiKey",
"http":{
"method":"DELETE",
"requestUri":"/apikeys/{api_Key}",
"responseCode":202
},
"input":{"shape":"DeleteApiKeyRequest"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Deletes the ApiKey resource.
"
},
"DeleteAuthorizer":{
"name":"DeleteAuthorizer",
"http":{
"method":"DELETE",
"requestUri":"/restapis/{restapi_id}/authorizers/{authorizer_id}",
"responseCode":202
},
"input":{"shape":"DeleteAuthorizerRequest"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"},
{"shape":"BadRequestException"},
{"shape":"ConflictException"}
],
"documentation":"Deletes an existing Authorizer resource.
"
},
"DeleteBasePathMapping":{
"name":"DeleteBasePathMapping",
"http":{
"method":"DELETE",
"requestUri":"/domainnames/{domain_name}/basepathmappings/{base_path}",
"responseCode":202
},
"input":{"shape":"DeleteBasePathMappingRequest"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Deletes the BasePathMapping resource.
"
},
"DeleteClientCertificate":{
"name":"DeleteClientCertificate",
"http":{
"method":"DELETE",
"requestUri":"/clientcertificates/{clientcertificate_id}",
"responseCode":202
},
"input":{"shape":"DeleteClientCertificateRequest"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"TooManyRequestsException"},
{"shape":"BadRequestException"},
{"shape":"NotFoundException"}
],
"documentation":"Deletes the ClientCertificate resource.
"
},
"DeleteDeployment":{
"name":"DeleteDeployment",
"http":{
"method":"DELETE",
"requestUri":"/restapis/{restapi_id}/deployments/{deployment_id}",
"responseCode":202
},
"input":{"shape":"DeleteDeploymentRequest"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"BadRequestException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Deletes a Deployment resource. Deleting a deployment will only succeed if there are no Stage resources associated with it.
"
},
"DeleteDomainName":{
"name":"DeleteDomainName",
"http":{
"method":"DELETE",
"requestUri":"/domainnames/{domain_name}",
"responseCode":202
},
"input":{"shape":"DeleteDomainNameRequest"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Deletes the DomainName resource.
"
},
"DeleteIntegration":{
"name":"DeleteIntegration",
"http":{
"method":"DELETE",
"requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/integration",
"responseCode":204
},
"input":{"shape":"DeleteIntegrationRequest"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Represents a delete integration.
"
},
"DeleteIntegrationResponse":{
"name":"DeleteIntegrationResponse",
"http":{
"method":"DELETE",
"requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/integration/responses/{status_code}",
"responseCode":204
},
"input":{"shape":"DeleteIntegrationResponseRequest"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"},
{"shape":"BadRequestException"}
],
"documentation":"Represents a delete integration response.
"
},
"DeleteMethod":{
"name":"DeleteMethod",
"http":{
"method":"DELETE",
"requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}",
"responseCode":204
},
"input":{"shape":"DeleteMethodRequest"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Deletes an existing Method resource.
"
},
"DeleteMethodResponse":{
"name":"DeleteMethodResponse",
"http":{
"method":"DELETE",
"requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/responses/{status_code}",
"responseCode":204
},
"input":{"shape":"DeleteMethodResponseRequest"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"},
{"shape":"BadRequestException"}
],
"documentation":"Deletes an existing MethodResponse resource.
"
},
"DeleteModel":{
"name":"DeleteModel",
"http":{
"method":"DELETE",
"requestUri":"/restapis/{restapi_id}/models/{model_name}",
"responseCode":202
},
"input":{"shape":"DeleteModelRequest"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"},
{"shape":"BadRequestException"},
{"shape":"ConflictException"}
],
"documentation":"Deletes a model.
"
},
"DeleteResource":{
"name":"DeleteResource",
"http":{
"method":"DELETE",
"requestUri":"/restapis/{restapi_id}/resources/{resource_id}",
"responseCode":202
},
"input":{"shape":"DeleteResourceRequest"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"BadRequestException"},
{"shape":"ConflictException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Deletes a Resource resource.
"
},
"DeleteRestApi":{
"name":"DeleteRestApi",
"http":{
"method":"DELETE",
"requestUri":"/restapis/{restapi_id}",
"responseCode":202
},
"input":{"shape":"DeleteRestApiRequest"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"},
{"shape":"BadRequestException"}
],
"documentation":"Deletes the specified API.
"
},
"DeleteStage":{
"name":"DeleteStage",
"http":{
"method":"DELETE",
"requestUri":"/restapis/{restapi_id}/stages/{stage_name}",
"responseCode":202
},
"input":{"shape":"DeleteStageRequest"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"},
{"shape":"BadRequestException"}
],
"documentation":"Deletes a Stage resource.
"
},
"FlushStageAuthorizersCache":{
"name":"FlushStageAuthorizersCache",
"http":{
"method":"DELETE",
"requestUri":"/restapis/{restapi_id}/stages/{stage_name}/cache/authorizers",
"responseCode":202
},
"input":{"shape":"FlushStageAuthorizersCacheRequest"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"BadRequestException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Flushes all authorizer cache entries on a stage.
"
},
"FlushStageCache":{
"name":"FlushStageCache",
"http":{
"method":"DELETE",
"requestUri":"/restapis/{restapi_id}/stages/{stage_name}/cache/data",
"responseCode":202
},
"input":{"shape":"FlushStageCacheRequest"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"BadRequestException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Flushes a stage's cache.
"
},
"GenerateClientCertificate":{
"name":"GenerateClientCertificate",
"http":{
"method":"POST",
"requestUri":"/clientcertificates",
"responseCode":201
},
"input":{"shape":"GenerateClientCertificateRequest"},
"output":{"shape":"ClientCertificate"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"TooManyRequestsException"},
{"shape":"LimitExceededException"}
],
"documentation":"Generates a ClientCertificate resource.
"
},
"GetAccount":{
"name":"GetAccount",
"http":{
"method":"GET",
"requestUri":"/account"
},
"input":{"shape":"GetAccountRequest"},
"output":{"shape":"Account"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Gets information about the current Account resource.
"
},
"GetApiKey":{
"name":"GetApiKey",
"http":{
"method":"GET",
"requestUri":"/apikeys/{api_Key}"
},
"input":{"shape":"GetApiKeyRequest"},
"output":{"shape":"ApiKey"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Gets information about the current ApiKey resource.
"
},
"GetApiKeys":{
"name":"GetApiKeys",
"http":{
"method":"GET",
"requestUri":"/apikeys"
},
"input":{"shape":"GetApiKeysRequest"},
"output":{"shape":"ApiKeys"},
"errors":[
{"shape":"BadRequestException"},
{"shape":"UnauthorizedException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Gets information about the current ApiKeys resource.
"
},
"GetAuthorizer":{
"name":"GetAuthorizer",
"http":{
"method":"GET",
"requestUri":"/restapis/{restapi_id}/authorizers/{authorizer_id}"
},
"input":{"shape":"GetAuthorizerRequest"},
"output":{"shape":"Authorizer"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Describe an existing Authorizer resource.
"
},
"GetAuthorizers":{
"name":"GetAuthorizers",
"http":{
"method":"GET",
"requestUri":"/restapis/{restapi_id}/authorizers"
},
"input":{"shape":"GetAuthorizersRequest"},
"output":{"shape":"Authorizers"},
"errors":[
{"shape":"BadRequestException"},
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Describe an existing Authorizers resource.
"
},
"GetBasePathMapping":{
"name":"GetBasePathMapping",
"http":{
"method":"GET",
"requestUri":"/domainnames/{domain_name}/basepathmappings/{base_path}"
},
"input":{"shape":"GetBasePathMappingRequest"},
"output":{"shape":"BasePathMapping"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Describe a BasePathMapping resource.
"
},
"GetBasePathMappings":{
"name":"GetBasePathMappings",
"http":{
"method":"GET",
"requestUri":"/domainnames/{domain_name}/basepathmappings"
},
"input":{"shape":"GetBasePathMappingsRequest"},
"output":{"shape":"BasePathMappings"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Represents a collection of BasePathMapping resources.
"
},
"GetClientCertificate":{
"name":"GetClientCertificate",
"http":{
"method":"GET",
"requestUri":"/clientcertificates/{clientcertificate_id}"
},
"input":{"shape":"GetClientCertificateRequest"},
"output":{"shape":"ClientCertificate"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Gets information about the current ClientCertificate resource.
"
},
"GetClientCertificates":{
"name":"GetClientCertificates",
"http":{
"method":"GET",
"requestUri":"/clientcertificates"
},
"input":{"shape":"GetClientCertificatesRequest"},
"output":{"shape":"ClientCertificates"},
"errors":[
{"shape":"BadRequestException"},
{"shape":"UnauthorizedException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Gets a collection of ClientCertificate resources.
"
},
"GetDeployment":{
"name":"GetDeployment",
"http":{
"method":"GET",
"requestUri":"/restapis/{restapi_id}/deployments/{deployment_id}"
},
"input":{"shape":"GetDeploymentRequest"},
"output":{"shape":"Deployment"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"},
{"shape":"ServiceUnavailableException"}
],
"documentation":"Gets information about a Deployment resource.
"
},
"GetDeployments":{
"name":"GetDeployments",
"http":{
"method":"GET",
"requestUri":"/restapis/{restapi_id}/deployments"
},
"input":{"shape":"GetDeploymentsRequest"},
"output":{"shape":"Deployments"},
"errors":[
{"shape":"BadRequestException"},
{"shape":"UnauthorizedException"},
{"shape":"TooManyRequestsException"},
{"shape":"ServiceUnavailableException"}
],
"documentation":"Gets information about a Deployments collection.
"
},
"GetDomainName":{
"name":"GetDomainName",
"http":{
"method":"GET",
"requestUri":"/domainnames/{domain_name}"
},
"input":{"shape":"GetDomainNameRequest"},
"output":{"shape":"DomainName"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"ServiceUnavailableException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Represents a domain name that is contained in a simpler, more intuitive URL that can be called.
"
},
"GetDomainNames":{
"name":"GetDomainNames",
"http":{
"method":"GET",
"requestUri":"/domainnames"
},
"input":{"shape":"GetDomainNamesRequest"},
"output":{"shape":"DomainNames"},
"errors":[
{"shape":"BadRequestException"},
{"shape":"UnauthorizedException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Represents a collection of DomainName resources.
"
},
"GetExport":{
"name":"GetExport",
"http":{
"method":"GET",
"requestUri":"/restapis/{restapi_id}/stages/{stage_name}/exports/{export_type}",
"responseCode":200
},
"input":{"shape":"GetExportRequest"},
"output":{"shape":"ExportResponse"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"BadRequestException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Exports a deployed version of a RestApi in a specified format.
"
},
"GetIntegration":{
"name":"GetIntegration",
"http":{
"method":"GET",
"requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/integration"
},
"input":{"shape":"GetIntegrationRequest"},
"output":{"shape":"Integration"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Represents a get integration.
"
},
"GetIntegrationResponse":{
"name":"GetIntegrationResponse",
"http":{
"method":"GET",
"requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/integration/responses/{status_code}"
},
"input":{"shape":"GetIntegrationResponseRequest"},
"output":{"shape":"IntegrationResponse"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Represents a get integration response.
"
},
"GetMethod":{
"name":"GetMethod",
"http":{
"method":"GET",
"requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}"
},
"input":{"shape":"GetMethodRequest"},
"output":{"shape":"Method"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Describe an existing Method resource.
"
},
"GetMethodResponse":{
"name":"GetMethodResponse",
"http":{
"method":"GET",
"requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/responses/{status_code}"
},
"input":{"shape":"GetMethodResponseRequest"},
"output":{"shape":"MethodResponse"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Describes a MethodResponse resource.
"
},
"GetModel":{
"name":"GetModel",
"http":{
"method":"GET",
"requestUri":"/restapis/{restapi_id}/models/{model_name}"
},
"input":{"shape":"GetModelRequest"},
"output":{"shape":"Model"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Describes an existing model defined for a RestApi resource.
"
},
"GetModelTemplate":{
"name":"GetModelTemplate",
"http":{
"method":"GET",
"requestUri":"/restapis/{restapi_id}/models/{model_name}/default_template"
},
"input":{"shape":"GetModelTemplateRequest"},
"output":{"shape":"Template"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"BadRequestException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Generates a sample mapping template that can be used to transform a payload into the structure of a model.
"
},
"GetModels":{
"name":"GetModels",
"http":{
"method":"GET",
"requestUri":"/restapis/{restapi_id}/models"
},
"input":{"shape":"GetModelsRequest"},
"output":{"shape":"Models"},
"errors":[
{"shape":"BadRequestException"},
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Describes existing Models defined for a RestApi resource.
"
},
"GetResource":{
"name":"GetResource",
"http":{
"method":"GET",
"requestUri":"/restapis/{restapi_id}/resources/{resource_id}"
},
"input":{"shape":"GetResourceRequest"},
"output":{"shape":"Resource"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Lists information about a resource.
"
},
"GetResources":{
"name":"GetResources",
"http":{
"method":"GET",
"requestUri":"/restapis/{restapi_id}/resources"
},
"input":{"shape":"GetResourcesRequest"},
"output":{"shape":"Resources"},
"errors":[
{"shape":"BadRequestException"},
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Lists information about a collection of Resource resources.
"
},
"GetRestApi":{
"name":"GetRestApi",
"http":{
"method":"GET",
"requestUri":"/restapis/{restapi_id}"
},
"input":{"shape":"GetRestApiRequest"},
"output":{"shape":"RestApi"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Lists the RestApi resource in the collection.
"
},
"GetRestApis":{
"name":"GetRestApis",
"http":{
"method":"GET",
"requestUri":"/restapis"
},
"input":{"shape":"GetRestApisRequest"},
"output":{"shape":"RestApis"},
"errors":[
{"shape":"BadRequestException"},
{"shape":"UnauthorizedException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Lists the RestApis resources for your collection.
"
},
"GetSdk":{
"name":"GetSdk",
"http":{
"method":"GET",
"requestUri":"/restapis/{restapi_id}/stages/{stage_name}/sdks/{sdk_type}",
"responseCode":200
},
"input":{"shape":"GetSdkRequest"},
"output":{"shape":"SdkResponse"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"BadRequestException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Generates a client SDK for a RestApi and Stage.
"
},
"GetStage":{
"name":"GetStage",
"http":{
"method":"GET",
"requestUri":"/restapis/{restapi_id}/stages/{stage_name}"
},
"input":{"shape":"GetStageRequest"},
"output":{"shape":"Stage"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Gets information about a Stage resource.
"
},
"GetStages":{
"name":"GetStages",
"http":{
"method":"GET",
"requestUri":"/restapis/{restapi_id}/stages"
},
"input":{"shape":"GetStagesRequest"},
"output":{"shape":"Stages"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Gets information about one or more Stage resources.
"
},
"ImportRestApi":{
"name":"ImportRestApi",
"http":{
"method":"POST",
"requestUri":"/restapis?mode=import",
"responseCode":201
},
"input":{"shape":"ImportRestApiRequest"},
"output":{"shape":"RestApi"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"LimitExceededException"},
{"shape":"BadRequestException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"A feature of the Amazon API Gateway control service for creating a new API from an external API definition file.
"
},
"PutIntegration":{
"name":"PutIntegration",
"http":{
"method":"PUT",
"requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/integration",
"responseCode":201
},
"input":{"shape":"PutIntegrationRequest"},
"output":{"shape":"Integration"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"BadRequestException"},
{"shape":"ConflictException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Represents a put integration.
"
},
"PutIntegrationResponse":{
"name":"PutIntegrationResponse",
"http":{
"method":"PUT",
"requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/integration/responses/{status_code}",
"responseCode":201
},
"input":{"shape":"PutIntegrationResponseRequest"},
"output":{"shape":"IntegrationResponse"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"LimitExceededException"},
{"shape":"BadRequestException"},
{"shape":"TooManyRequestsException"},
{"shape":"ConflictException"}
],
"documentation":"Represents a put integration.
"
},
"PutMethod":{
"name":"PutMethod",
"http":{
"method":"PUT",
"requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}",
"responseCode":201
},
"input":{"shape":"PutMethodRequest"},
"output":{"shape":"Method"},
"errors":[
{"shape":"BadRequestException"},
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"ConflictException"},
{"shape":"LimitExceededException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Add a method to an existing Resource resource.
"
},
"PutMethodResponse":{
"name":"PutMethodResponse",
"http":{
"method":"PUT",
"requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/responses/{status_code}",
"responseCode":201
},
"input":{"shape":"PutMethodResponseRequest"},
"output":{"shape":"MethodResponse"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"ConflictException"},
{"shape":"LimitExceededException"},
{"shape":"BadRequestException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Adds a MethodResponse to an existing Method resource.
"
},
"PutRestApi":{
"name":"PutRestApi",
"http":{
"method":"PUT",
"requestUri":"/restapis/{restapi_id}"
},
"input":{"shape":"PutRestApiRequest"},
"output":{"shape":"RestApi"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"LimitExceededException"},
{"shape":"NotFoundException"},
{"shape":"BadRequestException"},
{"shape":"TooManyRequestsException"},
{"shape":"ConflictException"}
],
"documentation":"A feature of the Amazon 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.
"
},
"TestInvokeAuthorizer":{
"name":"TestInvokeAuthorizer",
"http":{
"method":"POST",
"requestUri":"/restapis/{restapi_id}/authorizers/{authorizer_id}"
},
"input":{"shape":"TestInvokeAuthorizerRequest"},
"output":{"shape":"TestInvokeAuthorizerResponse"},
"errors":[
{"shape":"BadRequestException"},
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Simulate the execution of an Authorizer in your RestApi with headers, parameters, and an incoming request body.
"
},
"TestInvokeMethod":{
"name":"TestInvokeMethod",
"http":{
"method":"POST",
"requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}"
},
"input":{"shape":"TestInvokeMethodRequest"},
"output":{"shape":"TestInvokeMethodResponse"},
"errors":[
{"shape":"BadRequestException"},
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Simulate the execution of a Method in your RestApi with headers, parameters, and an incoming request body.
"
},
"UpdateAccount":{
"name":"UpdateAccount",
"http":{
"method":"PATCH",
"requestUri":"/account"
},
"input":{"shape":"UpdateAccountRequest"},
"output":{"shape":"Account"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"BadRequestException"},
{"shape":"NotFoundException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Changes information about the current Account resource.
"
},
"UpdateApiKey":{
"name":"UpdateApiKey",
"http":{
"method":"PATCH",
"requestUri":"/apikeys/{api_Key}"
},
"input":{"shape":"UpdateApiKeyRequest"},
"output":{"shape":"ApiKey"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"BadRequestException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Changes information about an ApiKey resource.
"
},
"UpdateAuthorizer":{
"name":"UpdateAuthorizer",
"http":{
"method":"PATCH",
"requestUri":"/restapis/{restapi_id}/authorizers/{authorizer_id}"
},
"input":{"shape":"UpdateAuthorizerRequest"},
"output":{"shape":"Authorizer"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"BadRequestException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Updates an existing Authorizer resource.
"
},
"UpdateBasePathMapping":{
"name":"UpdateBasePathMapping",
"http":{
"method":"PATCH",
"requestUri":"/domainnames/{domain_name}/basepathmappings/{base_path}"
},
"input":{"shape":"UpdateBasePathMappingRequest"},
"output":{"shape":"BasePathMapping"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"ConflictException"},
{"shape":"BadRequestException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Changes information about the BasePathMapping resource.
"
},
"UpdateClientCertificate":{
"name":"UpdateClientCertificate",
"http":{
"method":"PATCH",
"requestUri":"/clientcertificates/{clientcertificate_id}"
},
"input":{"shape":"UpdateClientCertificateRequest"},
"output":{"shape":"ClientCertificate"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"TooManyRequestsException"},
{"shape":"BadRequestException"},
{"shape":"NotFoundException"}
],
"documentation":"Changes information about an ClientCertificate resource.
"
},
"UpdateDeployment":{
"name":"UpdateDeployment",
"http":{
"method":"PATCH",
"requestUri":"/restapis/{restapi_id}/deployments/{deployment_id}"
},
"input":{"shape":"UpdateDeploymentRequest"},
"output":{"shape":"Deployment"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"BadRequestException"},
{"shape":"TooManyRequestsException"},
{"shape":"ServiceUnavailableException"}
],
"documentation":"Changes information about a Deployment resource.
"
},
"UpdateDomainName":{
"name":"UpdateDomainName",
"http":{
"method":"PATCH",
"requestUri":"/domainnames/{domain_name}"
},
"input":{"shape":"UpdateDomainNameRequest"},
"output":{"shape":"DomainName"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"BadRequestException"},
{"shape":"ConflictException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Changes information about the DomainName resource.
"
},
"UpdateIntegration":{
"name":"UpdateIntegration",
"http":{
"method":"PATCH",
"requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/integration"
},
"input":{"shape":"UpdateIntegrationRequest"},
"output":{"shape":"Integration"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"BadRequestException"},
{"shape":"TooManyRequestsException"},
{"shape":"ConflictException"}
],
"documentation":"Represents an update integration.
"
},
"UpdateIntegrationResponse":{
"name":"UpdateIntegrationResponse",
"http":{
"method":"PATCH",
"requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/integration/responses/{status_code}"
},
"input":{"shape":"UpdateIntegrationResponseRequest"},
"output":{"shape":"IntegrationResponse"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"ConflictException"},
{"shape":"BadRequestException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Represents an update integration response.
"
},
"UpdateMethod":{
"name":"UpdateMethod",
"http":{
"method":"PATCH",
"requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}"
},
"input":{"shape":"UpdateMethodRequest"},
"output":{"shape":"Method"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"BadRequestException"},
{"shape":"ConflictException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Updates an existing Method resource.
"
},
"UpdateMethodResponse":{
"name":"UpdateMethodResponse",
"http":{
"method":"PATCH",
"requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/responses/{status_code}",
"responseCode":201
},
"input":{"shape":"UpdateMethodResponseRequest"},
"output":{"shape":"MethodResponse"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"ConflictException"},
{"shape":"LimitExceededException"},
{"shape":"BadRequestException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Updates an existing MethodResponse resource.
"
},
"UpdateModel":{
"name":"UpdateModel",
"http":{
"method":"PATCH",
"requestUri":"/restapis/{restapi_id}/models/{model_name}"
},
"input":{"shape":"UpdateModelRequest"},
"output":{"shape":"Model"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"BadRequestException"},
{"shape":"ConflictException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Changes information about a model.
"
},
"UpdateResource":{
"name":"UpdateResource",
"http":{
"method":"PATCH",
"requestUri":"/restapis/{restapi_id}/resources/{resource_id}"
},
"input":{"shape":"UpdateResourceRequest"},
"output":{"shape":"Resource"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"ConflictException"},
{"shape":"BadRequestException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Changes information about a Resource resource.
"
},
"UpdateRestApi":{
"name":"UpdateRestApi",
"http":{
"method":"PATCH",
"requestUri":"/restapis/{restapi_id}"
},
"input":{"shape":"UpdateRestApiRequest"},
"output":{"shape":"RestApi"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"ConflictException"},
{"shape":"BadRequestException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Changes information about the specified API.
"
},
"UpdateStage":{
"name":"UpdateStage",
"http":{
"method":"PATCH",
"requestUri":"/restapis/{restapi_id}/stages/{stage_name}"
},
"input":{"shape":"UpdateStageRequest"},
"output":{"shape":"Stage"},
"errors":[
{"shape":"UnauthorizedException"},
{"shape":"NotFoundException"},
{"shape":"ConflictException"},
{"shape":"BadRequestException"},
{"shape":"TooManyRequestsException"}
],
"documentation":"Changes information about a Stage resource.
"
}
},
"shapes":{
"Account":{
"type":"structure",
"members":{
"cloudwatchRoleArn":{
"shape":"String",
"documentation":"Specifies the Amazon resource name (ARN) of an Amazon CloudWatch role for the current Account resource.
"
},
"throttleSettings":{
"shape":"ThrottleSettings",
"documentation":"Specifies the application programming interface (API) throttle settings for the current Account resource.
"
}
},
"documentation":"Represents an AWS account that is associated with Amazon API Gateway.
"
},
"ApiKey":{
"type":"structure",
"members":{
"id":{
"shape":"String",
"documentation":"The identifier of the API Key.
"
},
"name":{
"shape":"String",
"documentation":"The name of the API Key.
"
},
"description":{
"shape":"String",
"documentation":"The description of the API Key.
"
},
"enabled":{
"shape":"Boolean",
"documentation":"Specifies whether the API Key can be used by callers.
"
},
"stageKeys":{
"shape":"ListOfString",
"documentation":"A list of Stage resources that are associated with the ApiKey resource.
"
},
"createdDate":{
"shape":"Timestamp",
"documentation":"The date when the API Key was created, in ISO 8601 format.
"
},
"lastUpdatedDate":{
"shape":"Timestamp",
"documentation":"When the API Key was last updated, in ISO 8601 format.
"
}
},
"documentation":"A resource that can be distributed to callers for executing Method resources that require an API key. API keys can be mapped to any Stage on any RestApi, which indicates that the callers with the API key can make requests to that stage.
"
},
"ApiKeys":{
"type":"structure",
"members":{
"position":{"shape":"String"},
"items":{
"shape":"ListOfApiKey",
"documentation":"The current page of any ApiKey resources in the collection of ApiKey resources.
",
"locationName":"item"
}
},
"documentation":"Represents a collection of ApiKey resources.
"
},
"Authorizer":{
"type":"structure",
"members":{
"id":{
"shape":"String",
"documentation":"The identifier for the authorizer resource.
"
},
"name":{
"shape":"String",
"documentation":"[Required] The name of the authorizer.
"
},
"type":{
"shape":"AuthorizerType",
"documentation":"[Required] The type of the authorizer. Currently, the only valid type is TOKEN.
"
},
"providerARNs":{"shape":"ListOfARNs"},
"authType":{
"shape":"String",
"documentation":"Optional customer-defined field, used in Swagger imports/exports. Has no functional impact.
"
},
"authorizerUri":{
"shape":"String",
"documentation":"[Required] Specifies the authorizer's Uniform Resource Identifier (URI). For TOKEN authorizers, this must be a well-formed Lambda function URI. The URI should be of the form arn:aws:apigateway:{region}:lambda:path/{service_api}. Region is used to determine the right endpoint. In this case, path is used to indicate that the remaining substring in the URI should be treated as the path to the resource, including the initial /. For Lambda functions, this is usually of the form /2015-03-31/functions/[FunctionARN]/invocations
"
},
"authorizerCredentials":{
"shape":"String",
"documentation":"Specifies the credentials required for the authorizer, if any. Two options are available. To specify an IAM Role for Amazon API Gateway to assume, use the role's Amazon Resource Name (ARN). To use resource-based permissions on the Lambda function, specify null.
"
},
"identitySource":{
"shape":"String",
"documentation":"[Required] The source of the identity in an incoming request. For TOKEN authorizers, this value is a mapping expression with the same syntax as integration parameter mappings. The only valid source for tokens is 'header', so the expression should match 'method.request.header.[headerName]'. The value of the header '[headerName]' will be interpreted as the incoming token.
"
},
"identityValidationExpression":{
"shape":"String",
"documentation":"A validation expression for the incoming identity. For TOKEN authorizers, this value should be a regular expression. The incoming token from the client is matched against this expression, and will proceed if the token matches. If the token doesn't match, the client receives a 401 Unauthorized response.
"
},
"authorizerResultTtlInSeconds":{
"shape":"NullableInteger",
"documentation":"The TTL in seconds of cached authorizer results. If greater than 0, API Gateway will cache authorizer responses. If this field is not set, the default value is 300. The maximum value is 3600, or 1 hour.
"
}
},
"documentation":"Represents an authorization layer for methods. If enabled on a method, API Gateway will activate the authorizer when a client calls the method.
"
},
"AuthorizerType":{
"type":"string",
"documentation":"The authorizer type. Only current value is TOKEN.
",
"enum":[
"TOKEN",
"COGNITO_USER_POOLS"
]
},
"Authorizers":{
"type":"structure",
"members":{
"position":{"shape":"String"},
"items":{
"shape":"ListOfAuthorizer",
"documentation":"Gets the current list of Authorizer resources in the collection.
",
"locationName":"item"
}
},
"documentation":"Represents a collection of Authorizer resources.
"
},
"BadRequestException":{
"type":"structure",
"members":{
"message":{"shape":"String"}
},
"error":{"httpStatusCode":400},
"exception":true
},
"BasePathMapping":{
"type":"structure",
"members":{
"basePath":{
"shape":"String",
"documentation":"The base path name that callers of the API must provide as part of the URL after the domain name.
"
},
"restApiId":{
"shape":"String",
"documentation":"The name of the API.
"
},
"stage":{
"shape":"String",
"documentation":"The name of the API's stage.
"
}
},
"documentation":"Represents the base path that callers of the API that must provide as part of the URL after the domain name.
"
},
"BasePathMappings":{
"type":"structure",
"members":{
"position":{"shape":"String"},
"items":{
"shape":"ListOfBasePathMapping",
"documentation":"The current page of any BasePathMapping resources in the collection of base path mapping resources.
",
"locationName":"item"
}
},
"documentation":"Represents a collection of BasePathMapping resources.
"
},
"Blob":{"type":"blob"},
"Boolean":{"type":"boolean"},
"CacheClusterSize":{
"type":"string",
"documentation":"Returns the size of the CacheCluster.
",
"enum":[
"0.5",
"1.6",
"6.1",
"13.5",
"28.4",
"58.2",
"118",
"237"
]
},
"CacheClusterStatus":{
"type":"string",
"documentation":"Returns the status of the CacheCluster.
",
"enum":[
"CREATE_IN_PROGRESS",
"AVAILABLE",
"DELETE_IN_PROGRESS",
"NOT_AVAILABLE",
"FLUSH_IN_PROGRESS"
]
},
"ClientCertificate":{
"type":"structure",
"members":{
"clientCertificateId":{
"shape":"String",
"documentation":"The identifier of the Client Certificate.
"
},
"description":{
"shape":"String",
"documentation":"The description of the Client Certificate.
"
},
"pemEncodedCertificate":{
"shape":"String",
"documentation":"The PEM-encoded public key of the Client Certificate, that can be used to configure certificate authentication in the integration endpoint .
"
},
"createdDate":{
"shape":"Timestamp",
"documentation":"The date when the Client Certificate was created, in ISO 8601 format.
"
},
"expirationDate":{
"shape":"Timestamp",
"documentation":"The date when the Client Certificate will expire, in ISO 8601 format.
"
}
},
"documentation":"Represents a Client Certificate used to configure client-side SSL authentication while sending requests to the integration endpoint.
"
},
"ClientCertificates":{
"type":"structure",
"members":{
"position":{"shape":"String"},
"items":{
"shape":"ListOfClientCertificate",
"documentation":"The current page of any ClientCertificate resources in the collection of ClientCertificate resources.
",
"locationName":"item"
}
},
"documentation":"Represents a collection of ClientCertificate resources.
"
},
"ConflictException":{
"type":"structure",
"members":{
"message":{"shape":"String"}
},
"error":{"httpStatusCode":409},
"exception":true
},
"CreateApiKeyRequest":{
"type":"structure",
"members":{
"name":{
"shape":"String",
"documentation":"The name of the ApiKey.
"
},
"description":{
"shape":"String",
"documentation":"The description of the ApiKey.
"
},
"enabled":{
"shape":"Boolean",
"documentation":"Specifies whether the ApiKey can be used by callers.
"
},
"stageKeys":{
"shape":"ListOfStageKeys",
"documentation":"Specifies whether the ApiKey can be used by callers.
"
}
},
"documentation":"Request to create an ApiKey resource.
"
},
"CreateAuthorizerRequest":{
"type":"structure",
"required":[
"restApiId",
"name",
"type",
"identitySource"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The RestApi identifier under which the Authorizer will be created.
",
"location":"uri",
"locationName":"restapi_id"
},
"name":{
"shape":"String",
"documentation":"[Required] The name of the authorizer.
"
},
"type":{
"shape":"AuthorizerType",
"documentation":"[Required] The type of the authorizer.
"
},
"providerARNs":{"shape":"ListOfARNs"},
"authType":{
"shape":"String",
"documentation":"Optional customer-defined field, used in Swagger imports/exports. Has no functional impact.
"
},
"authorizerUri":{
"shape":"String",
"documentation":"[Required] Specifies the authorizer's Uniform Resource Identifier (URI).
"
},
"authorizerCredentials":{
"shape":"String",
"documentation":"Specifies the credentials required for the authorizer, if any.
"
},
"identitySource":{
"shape":"String",
"documentation":"[Required] The source of the identity in an incoming request.
"
},
"identityValidationExpression":{
"shape":"String",
"documentation":"A validation expression for the incoming identity.
"
},
"authorizerResultTtlInSeconds":{
"shape":"NullableInteger",
"documentation":"The TTL of cached authorizer results.
"
}
},
"documentation":"Request to add a new Authorizer to an existing RestApi resource.
"
},
"CreateBasePathMappingRequest":{
"type":"structure",
"required":[
"domainName",
"restApiId"
],
"members":{
"domainName":{
"shape":"String",
"documentation":"The domain name of the BasePathMapping resource to create.
",
"location":"uri",
"locationName":"domain_name"
},
"basePath":{
"shape":"String",
"documentation":"The base path name that callers of the API must provide as part of the URL after the domain name. This value must be unique for all of the mappings across a single API. Leave this blank if you do not want callers to specify a base path name after the domain name.
"
},
"restApiId":{
"shape":"String",
"documentation":"The name of the API that you want to apply this mapping to.
"
},
"stage":{
"shape":"String",
"documentation":"The name of the API's stage that you want to use for this mapping. Leave this blank if you do not want callers to explicitly specify the stage name after any base path name.
"
}
},
"documentation":"Requests Amazon API Gateway to create a new BasePathMapping resource.
"
},
"CreateDeploymentRequest":{
"type":"structure",
"required":[
"restApiId",
"stageName"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The RestApi resource identifier for the Deployment resource to create.
",
"location":"uri",
"locationName":"restapi_id"
},
"stageName":{
"shape":"String",
"documentation":"The name of the Stage resource for the Deployment resource to create.
"
},
"stageDescription":{
"shape":"String",
"documentation":"The description of the Stage resource for the Deployment resource to create.
"
},
"description":{
"shape":"String",
"documentation":"The description for the Deployment resource to create.
"
},
"cacheClusterEnabled":{
"shape":"NullableBoolean",
"documentation":"Enables a cache cluster for the Stage resource specified in the input.
"
},
"cacheClusterSize":{
"shape":"CacheClusterSize",
"documentation":"Specifies the cache cluster size for the Stage resource specified in the input, if a cache cluster is enabled.
"
},
"variables":{
"shape":"MapOfStringToString",
"documentation":"A map that defines the stage variables for the Stage resource that is associated with the new deployment. Variable names can have alphanumeric characters, and the values must match [A-Za-z0-9-._~:/?#&=,]+.
"
}
},
"documentation":"Requests Amazon API Gateway to create a Deployment resource.
"
},
"CreateDomainNameRequest":{
"type":"structure",
"required":[
"domainName",
"certificateName",
"certificateBody",
"certificatePrivateKey",
"certificateChain"
],
"members":{
"domainName":{
"shape":"String",
"documentation":"The name of the DomainName resource.
"
},
"certificateName":{
"shape":"String",
"documentation":"The name of the certificate.
"
},
"certificateBody":{
"shape":"String",
"documentation":"The body of the server certificate provided by your certificate authority.
"
},
"certificatePrivateKey":{
"shape":"String",
"documentation":"Your certificate's private key.
"
},
"certificateChain":{
"shape":"String",
"documentation":"The intermediate certificates and optionally the root certificate, one after the other without any blank lines. If you include the root certificate, your certificate chain must start with intermediate certificates and end with the root certificate. Use the intermediate certificates that were provided by your certificate authority. Do not include any intermediaries that are not in the chain of trust path.
"
}
},
"documentation":"A request to create a new domain name.
"
},
"CreateModelRequest":{
"type":"structure",
"required":[
"restApiId",
"name",
"contentType"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The RestApi identifier under which the Model will be created.
",
"location":"uri",
"locationName":"restapi_id"
},
"name":{
"shape":"String",
"documentation":"The name of the model.
"
},
"description":{
"shape":"String",
"documentation":"The description of the model.
"
},
"schema":{
"shape":"String",
"documentation":"The schema for the model. For application/json models, this should be JSON-schema draft v4 model.
"
},
"contentType":{
"shape":"String",
"documentation":"The content-type for the model.
"
}
},
"documentation":"Request to add a new Model to an existing RestApi resource.
"
},
"CreateResourceRequest":{
"type":"structure",
"required":[
"restApiId",
"parentId",
"pathPart"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The identifier of the RestApi for the resource.
",
"location":"uri",
"locationName":"restapi_id"
},
"parentId":{
"shape":"String",
"documentation":"The parent resource's identifier.
",
"location":"uri",
"locationName":"parent_id"
},
"pathPart":{
"shape":"String",
"documentation":"The last path segment for this resource.
"
}
},
"documentation":"Requests Amazon API Gateway to create a Resource resource.
"
},
"CreateRestApiRequest":{
"type":"structure",
"required":["name"],
"members":{
"name":{
"shape":"String",
"documentation":"The name of the RestApi.
"
},
"description":{
"shape":"String",
"documentation":"The description of the RestApi.
"
},
"cloneFrom":{
"shape":"String",
"documentation":"The Id of the RestApi that you want to clone from.
"
}
},
"documentation":"The POST Request to add a new RestApi resource to your collection.
"
},
"CreateStageRequest":{
"type":"structure",
"required":[
"restApiId",
"stageName",
"deploymentId"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The identifier of the RestApi resource for the Stage resource to create.
",
"location":"uri",
"locationName":"restapi_id"
},
"stageName":{
"shape":"String",
"documentation":"The name for the Stage resource.
"
},
"deploymentId":{
"shape":"String",
"documentation":"The identifier of the Deployment resource for the Stage resource.
"
},
"description":{
"shape":"String",
"documentation":"The description of the Stage resource.
"
},
"cacheClusterEnabled":{
"shape":"Boolean",
"documentation":"Whether cache clustering is enabled for the stage.
"
},
"cacheClusterSize":{
"shape":"CacheClusterSize",
"documentation":"The stage's cache cluster size.
"
},
"variables":{
"shape":"MapOfStringToString",
"documentation":"A map that defines the stage variables for the new Stage resource. Variable names can have alphanumeric characters, and the values must match [A-Za-z0-9-._~:/?#&=,]+.
"
}
},
"documentation":"Requests Amazon API Gateway to create a Stage resource.
"
},
"DeleteApiKeyRequest":{
"type":"structure",
"required":["apiKey"],
"members":{
"apiKey":{
"shape":"String",
"documentation":"The identifier of the ApiKey resource to be deleted.
",
"location":"uri",
"locationName":"api_Key"
}
},
"documentation":"A request to delete the ApiKey resource.
"
},
"DeleteAuthorizerRequest":{
"type":"structure",
"required":[
"restApiId",
"authorizerId"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The RestApi identifier for the Authorizer resource.
",
"location":"uri",
"locationName":"restapi_id"
},
"authorizerId":{
"shape":"String",
"documentation":"The identifier of the Authorizer resource.
",
"location":"uri",
"locationName":"authorizer_id"
}
},
"documentation":"Request to delete an existing Authorizer resource.
"
},
"DeleteBasePathMappingRequest":{
"type":"structure",
"required":[
"domainName",
"basePath"
],
"members":{
"domainName":{
"shape":"String",
"documentation":"The domain name of the BasePathMapping resource to delete.
",
"location":"uri",
"locationName":"domain_name"
},
"basePath":{
"shape":"String",
"documentation":"The base path name of the BasePathMapping resource to delete.
",
"location":"uri",
"locationName":"base_path"
}
},
"documentation":"A request to delete the BasePathMapping resource.
"
},
"DeleteClientCertificateRequest":{
"type":"structure",
"required":["clientCertificateId"],
"members":{
"clientCertificateId":{
"shape":"String",
"documentation":"The identifier of the ClientCertificate resource to be deleted.
",
"location":"uri",
"locationName":"clientcertificate_id"
}
},
"documentation":"A request to delete the ClientCertificate resource.
"
},
"DeleteDeploymentRequest":{
"type":"structure",
"required":[
"restApiId",
"deploymentId"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The identifier of the RestApi resource for the Deployment resource to delete.
",
"location":"uri",
"locationName":"restapi_id"
},
"deploymentId":{
"shape":"String",
"documentation":"The identifier of the Deployment resource to delete.
",
"location":"uri",
"locationName":"deployment_id"
}
},
"documentation":"Requests Amazon API Gateway to delete a Deployment resource.
"
},
"DeleteDomainNameRequest":{
"type":"structure",
"required":["domainName"],
"members":{
"domainName":{
"shape":"String",
"documentation":"The name of the DomainName resource to be deleted.
",
"location":"uri",
"locationName":"domain_name"
}
},
"documentation":"A request to delete the DomainName resource.
"
},
"DeleteIntegrationRequest":{
"type":"structure",
"required":[
"restApiId",
"resourceId",
"httpMethod"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"Specifies a delete integration request's API identifier.
",
"location":"uri",
"locationName":"restapi_id"
},
"resourceId":{
"shape":"String",
"documentation":"Specifies a delete integration request's resource identifier.
",
"location":"uri",
"locationName":"resource_id"
},
"httpMethod":{
"shape":"String",
"documentation":"Specifies a delete integration request's HTTP method.
",
"location":"uri",
"locationName":"http_method"
}
},
"documentation":"Represents a delete integration request.
"
},
"DeleteIntegrationResponseRequest":{
"type":"structure",
"required":[
"restApiId",
"resourceId",
"httpMethod",
"statusCode"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"Specifies a delete integration response request's API identifier.
",
"location":"uri",
"locationName":"restapi_id"
},
"resourceId":{
"shape":"String",
"documentation":"Specifies a delete integration response request's resource identifier.
",
"location":"uri",
"locationName":"resource_id"
},
"httpMethod":{
"shape":"String",
"documentation":"Specifies a delete integration response request's HTTP method.
",
"location":"uri",
"locationName":"http_method"
},
"statusCode":{
"shape":"StatusCode",
"documentation":"Specifies a delete integration response request's status code.
",
"location":"uri",
"locationName":"status_code"
}
},
"documentation":"Represents a delete integration response request.
"
},
"DeleteMethodRequest":{
"type":"structure",
"required":[
"restApiId",
"resourceId",
"httpMethod"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The RestApi identifier for the Method resource.
",
"location":"uri",
"locationName":"restapi_id"
},
"resourceId":{
"shape":"String",
"documentation":"The Resource identifier for the Method resource.
",
"location":"uri",
"locationName":"resource_id"
},
"httpMethod":{
"shape":"String",
"documentation":"The HTTP verb that identifies the Method resource.
",
"location":"uri",
"locationName":"http_method"
}
},
"documentation":"Request to delete an existing Method resource.
"
},
"DeleteMethodResponseRequest":{
"type":"structure",
"required":[
"restApiId",
"resourceId",
"httpMethod",
"statusCode"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The RestApi identifier for the MethodResponse resource.
",
"location":"uri",
"locationName":"restapi_id"
},
"resourceId":{
"shape":"String",
"documentation":"The Resource identifier for the MethodResponse resource.
",
"location":"uri",
"locationName":"resource_id"
},
"httpMethod":{
"shape":"String",
"documentation":"The HTTP verb identifier for the parent Method resource.
",
"location":"uri",
"locationName":"http_method"
},
"statusCode":{
"shape":"StatusCode",
"documentation":"The status code identifier for the MethodResponse resource.
",
"location":"uri",
"locationName":"status_code"
}
},
"documentation":"A request to delete an existing MethodResponse resource.
"
},
"DeleteModelRequest":{
"type":"structure",
"required":[
"restApiId",
"modelName"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The RestApi under which the model will be deleted.
",
"location":"uri",
"locationName":"restapi_id"
},
"modelName":{
"shape":"String",
"documentation":"The name of the model to delete.
",
"location":"uri",
"locationName":"model_name"
}
},
"documentation":"Request to delete an existing model in an existing RestApi resource.
"
},
"DeleteResourceRequest":{
"type":"structure",
"required":[
"restApiId",
"resourceId"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The RestApi identifier for the Resource resource.
",
"location":"uri",
"locationName":"restapi_id"
},
"resourceId":{
"shape":"String",
"documentation":"The identifier of the Resource resource.
",
"location":"uri",
"locationName":"resource_id"
}
},
"documentation":"Request to delete a Resource.
"
},
"DeleteRestApiRequest":{
"type":"structure",
"required":["restApiId"],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The ID of the RestApi you want to delete.
",
"location":"uri",
"locationName":"restapi_id"
}
},
"documentation":"Request to delete the specified API from your collection.
"
},
"DeleteStageRequest":{
"type":"structure",
"required":[
"restApiId",
"stageName"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The identifier of the RestApi resource for the Stage resource to delete.
",
"location":"uri",
"locationName":"restapi_id"
},
"stageName":{
"shape":"String",
"documentation":"The name of the Stage resource to delete.
",
"location":"uri",
"locationName":"stage_name"
}
},
"documentation":"Requests Amazon API Gateway to delete a Stage resource.
"
},
"Deployment":{
"type":"structure",
"members":{
"id":{
"shape":"String",
"documentation":"The identifier for the deployment resource.
"
},
"description":{
"shape":"String",
"documentation":"The description for the deployment resource.
"
},
"createdDate":{
"shape":"Timestamp",
"documentation":"The date and time that the deployment resource was created.
"
},
"apiSummary":{
"shape":"PathToMapOfMethodSnapshot",
"documentation":"Gets a summary of the RestApi at the date and time that the deployment resource was created.
"
}
},
"documentation":"An immutable representation of a RestApi resource that can be called by users using Stages. A deployment must be associated with a Stage for it to be callable over the Internet.
"
},
"Deployments":{
"type":"structure",
"members":{
"position":{"shape":"String"},
"items":{
"shape":"ListOfDeployment",
"documentation":"The current page of any Deployment resources in the collection of deployment resources.
",
"locationName":"item"
}
},
"documentation":"Represents a collection resource that contains zero or more references to your existing deployments, and links that guide you on ways to interact with your collection. The collection offers a paginated view of the contained deployments.
"
},
"DomainName":{
"type":"structure",
"members":{
"domainName":{
"shape":"String",
"documentation":"The name of the DomainName resource.
"
},
"certificateName":{
"shape":"String",
"documentation":"The name of the certificate.
"
},
"certificateUploadDate":{
"shape":"Timestamp",
"documentation":"The date when the certificate was uploaded, in ISO 8601 format.
"
},
"distributionDomainName":{
"shape":"String",
"documentation":"The domain name of the Amazon CloudFront distribution. For more information, see the Amazon CloudFront documentation.
"
}
},
"documentation":"Represents a domain name that is contained in a simpler, more intuitive URL that can be called.
"
},
"DomainNames":{
"type":"structure",
"members":{
"position":{"shape":"String"},
"items":{
"shape":"ListOfDomainName",
"documentation":"The current page of any DomainName resources in the collection of DomainName resources.
",
"locationName":"item"
}
},
"documentation":"Represents a collection of DomainName resources.
"
},
"Double":{"type":"double"},
"ExportResponse":{
"type":"structure",
"members":{
"contentType":{
"shape":"String",
"documentation":"The content-type header value in the HTTP response. This will correspond to a valid 'accept' type in the request.
",
"location":"header",
"locationName":"Content-Type"
},
"contentDisposition":{
"shape":"String",
"documentation":"The content-disposition header value in the HTTP reseponse.
",
"location":"header",
"locationName":"Content-Disposition"
},
"body":{
"shape":"Blob",
"documentation":"The binary blob response to GetExport, which contains the export.
"
}
},
"documentation":"The binary blob response to GetExport, which contains the generated SDK.
",
"payload":"body"
},
"FlushStageAuthorizersCacheRequest":{
"type":"structure",
"required":[
"restApiId",
"stageName"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The API identifier of the stage to flush.
",
"location":"uri",
"locationName":"restapi_id"
},
"stageName":{
"shape":"String",
"documentation":"The name of the stage to flush.
",
"location":"uri",
"locationName":"stage_name"
}
},
"documentation":"Request to flush authorizer cache entries on a specified stage.
"
},
"FlushStageCacheRequest":{
"type":"structure",
"required":[
"restApiId",
"stageName"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The API identifier of the stage to flush its cache.
",
"location":"uri",
"locationName":"restapi_id"
},
"stageName":{
"shape":"String",
"documentation":"The name of the stage to flush its cache.
",
"location":"uri",
"locationName":"stage_name"
}
},
"documentation":"Requests Amazon API Gateway to flush a stage's cache.
"
},
"GenerateClientCertificateRequest":{
"type":"structure",
"members":{
"description":{
"shape":"String",
"documentation":"The description of the ClientCertificate.
"
}
},
"documentation":"A request to generate a ClientCertificate resource.
"
},
"GetAccountRequest":{
"type":"structure",
"members":{
},
"documentation":"Requests Amazon API Gateway to get information about the current Account resource.
"
},
"GetApiKeyRequest":{
"type":"structure",
"required":["apiKey"],
"members":{
"apiKey":{
"shape":"String",
"documentation":"The identifier of the ApiKey resource.
",
"location":"uri",
"locationName":"api_Key"
}
},
"documentation":"A request to get information about the current ApiKey resource.
"
},
"GetApiKeysRequest":{
"type":"structure",
"members":{
"position":{
"shape":"String",
"documentation":"The position of the current ApiKeys resource to get information about.
",
"location":"querystring",
"locationName":"position"
},
"limit":{
"shape":"NullableInteger",
"documentation":"The maximum number of ApiKeys to get information about.
",
"location":"querystring",
"locationName":"limit"
}
},
"documentation":"A request to get information about the current ApiKeys resource.
"
},
"GetAuthorizerRequest":{
"type":"structure",
"required":[
"restApiId",
"authorizerId"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The RestApi identifier for the Authorizer resource.
",
"location":"uri",
"locationName":"restapi_id"
},
"authorizerId":{
"shape":"String",
"documentation":"The identifier of the Authorizer resource.
",
"location":"uri",
"locationName":"authorizer_id"
}
},
"documentation":"Request to describe an existing Authorizer resource.
"
},
"GetAuthorizersRequest":{
"type":"structure",
"required":["restApiId"],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The RestApi identifier for the Authorizers resource.
",
"location":"uri",
"locationName":"restapi_id"
},
"position":{
"shape":"String",
"documentation":"If not all Authorizer resources in the response were present, the position will specificy where to start the next page of results.
",
"location":"querystring",
"locationName":"position"
},
"limit":{
"shape":"NullableInteger",
"documentation":"Limit the number of Authorizer resources in the response.
",
"location":"querystring",
"locationName":"limit"
}
},
"documentation":"Request to describe an existing Authorizers resource.
"
},
"GetBasePathMappingRequest":{
"type":"structure",
"required":[
"domainName",
"basePath"
],
"members":{
"domainName":{
"shape":"String",
"documentation":"The domain name of the BasePathMapping resource to be described.
",
"location":"uri",
"locationName":"domain_name"
},
"basePath":{
"shape":"String",
"documentation":"The base path name that callers of the API must provide as part of the URL after the domain name. This value must be unique for all of the mappings across a single API. Leave this blank if you do not want callers to specify any base path name after the domain name.
",
"location":"uri",
"locationName":"base_path"
}
},
"documentation":"Request to describe a BasePathMapping resource.
"
},
"GetBasePathMappingsRequest":{
"type":"structure",
"required":["domainName"],
"members":{
"domainName":{
"shape":"String",
"documentation":"The domain name of a BasePathMapping resource.
",
"location":"uri",
"locationName":"domain_name"
},
"position":{
"shape":"String",
"documentation":"The position of the current BasePathMapping resource in the collection to get information about.
",
"location":"querystring",
"locationName":"position"
},
"limit":{
"shape":"NullableInteger",
"documentation":"The maximum number of BasePathMapping resources in the collection to get information about. The default limit is 25. It should be an integer between 1 - 500.
",
"location":"querystring",
"locationName":"limit"
}
},
"documentation":"A request to get information about a collection of BasePathMapping resources.
"
},
"GetClientCertificateRequest":{
"type":"structure",
"required":["clientCertificateId"],
"members":{
"clientCertificateId":{
"shape":"String",
"documentation":"The identifier of the ClientCertificate resource to be described.
",
"location":"uri",
"locationName":"clientcertificate_id"
}
},
"documentation":"A request to get information about the current ClientCertificate resource.
"
},
"GetClientCertificatesRequest":{
"type":"structure",
"members":{
"position":{
"shape":"String",
"documentation":"The position of the current ClientCertificate resource in the collection to get information about.
",
"location":"querystring",
"locationName":"position"
},
"limit":{
"shape":"NullableInteger",
"documentation":"The maximum number of ClientCertificate resources in the collection to get information about. The default limit is 25. It should be an integer between 1 - 500.
",
"location":"querystring",
"locationName":"limit"
}
},
"documentation":"A request to get information about a collection of ClientCertificate resources.
"
},
"GetDeploymentRequest":{
"type":"structure",
"required":[
"restApiId",
"deploymentId"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The identifier of the RestApi resource for the Deployment resource to get information about.
",
"location":"uri",
"locationName":"restapi_id"
},
"deploymentId":{
"shape":"String",
"documentation":"The identifier of the Deployment resource to get information about.
",
"location":"uri",
"locationName":"deployment_id"
}
},
"documentation":"Requests Amazon API Gateway to get information about a Deployment resource.
"
},
"GetDeploymentsRequest":{
"type":"structure",
"required":["restApiId"],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The identifier of the RestApi resource for the collection of Deployment resources to get information about.
",
"location":"uri",
"locationName":"restapi_id"
},
"position":{
"shape":"String",
"documentation":"The position of the current Deployment resource in the collection to get information about.
",
"location":"querystring",
"locationName":"position"
},
"limit":{
"shape":"NullableInteger",
"documentation":"The maximum number of Deployment resources in the collection to get information about. The default limit is 25. It should be an integer between 1 - 500.
",
"location":"querystring",
"locationName":"limit"
}
},
"documentation":"Requests Amazon API Gateway to get information about a Deployments collection.
"
},
"GetDomainNameRequest":{
"type":"structure",
"required":["domainName"],
"members":{
"domainName":{
"shape":"String",
"documentation":"The name of the DomainName resource.
",
"location":"uri",
"locationName":"domain_name"
}
},
"documentation":"Request to get the name of a DomainName resource.
"
},
"GetDomainNamesRequest":{
"type":"structure",
"members":{
"position":{
"shape":"String",
"documentation":"The position of the current domain names to get information about.
",
"location":"querystring",
"locationName":"position"
},
"limit":{
"shape":"NullableInteger",
"documentation":"The maximum number of DomainName resources in the collection to get information about. The default limit is 25. It should be an integer between 1 - 500.
",
"location":"querystring",
"locationName":"limit"
}
},
"documentation":"Request to describe a collection of DomainName resources.
"
},
"GetExportRequest":{
"type":"structure",
"required":[
"restApiId",
"stageName",
"exportType"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The identifier of the RestApi to be exported.
",
"location":"uri",
"locationName":"restapi_id"
},
"stageName":{
"shape":"String",
"documentation":"The name of the Stage that will be exported.
",
"location":"uri",
"locationName":"stage_name"
},
"exportType":{
"shape":"String",
"documentation":"The type of export. Currently only 'swagger' is supported.
",
"location":"uri",
"locationName":"export_type"
},
"parameters":{
"shape":"MapOfStringToString",
"documentation":"A key-value map of query string parameters that specify properties of the export, depending on the requested exportType. For exportType 'swagger', any combination of the following parameters are supported: 'integrations' will export x-amazon-apigateway-integration extensions 'authorizers' will export x-amazon-apigateway-authorizer extensions 'postman' will export with Postman extensions, allowing for import to the Postman tool
",
"location":"querystring"
},
"accepts":{
"shape":"String",
"documentation":"The content-type of the export, for example 'application/json'. Currently 'application/json' and 'application/yaml' are supported for exportType 'swagger'. Should be specifed in the 'Accept' header for direct API requests.
",
"location":"header",
"locationName":"Accept"
}
},
"documentation":"Request a new export of a RestApi for a particular Stage.
"
},
"GetIntegrationRequest":{
"type":"structure",
"required":[
"restApiId",
"resourceId",
"httpMethod"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"Specifies a get integration request's API identifier.
",
"location":"uri",
"locationName":"restapi_id"
},
"resourceId":{
"shape":"String",
"documentation":"Specifies a get integration request's resource identifier
",
"location":"uri",
"locationName":"resource_id"
},
"httpMethod":{
"shape":"String",
"documentation":"Specifies a get integration request's HTTP method.
",
"location":"uri",
"locationName":"http_method"
}
},
"documentation":"Represents a get integration request.
"
},
"GetIntegrationResponseRequest":{
"type":"structure",
"required":[
"restApiId",
"resourceId",
"httpMethod",
"statusCode"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"Specifies a get integration response request's API identifier.
",
"location":"uri",
"locationName":"restapi_id"
},
"resourceId":{
"shape":"String",
"documentation":"Specifies a get integration response request's resource identifier.
",
"location":"uri",
"locationName":"resource_id"
},
"httpMethod":{
"shape":"String",
"documentation":"Specifies a get integration response request's HTTP method.
",
"location":"uri",
"locationName":"http_method"
},
"statusCode":{
"shape":"StatusCode",
"documentation":"Specifies a get integration response request's status code.
",
"location":"uri",
"locationName":"status_code"
}
},
"documentation":"Represents a get integration response request.
"
},
"GetMethodRequest":{
"type":"structure",
"required":[
"restApiId",
"resourceId",
"httpMethod"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The RestApi identifier for the Method resource.
",
"location":"uri",
"locationName":"restapi_id"
},
"resourceId":{
"shape":"String",
"documentation":"The Resource identifier for the Method resource.
",
"location":"uri",
"locationName":"resource_id"
},
"httpMethod":{
"shape":"String",
"documentation":"Specifies the put method request's HTTP method type.
",
"location":"uri",
"locationName":"http_method"
}
},
"documentation":"Request to describe an existing Method resource.
"
},
"GetMethodResponseRequest":{
"type":"structure",
"required":[
"restApiId",
"resourceId",
"httpMethod",
"statusCode"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The RestApi identifier for the MethodResponse resource.
",
"location":"uri",
"locationName":"restapi_id"
},
"resourceId":{
"shape":"String",
"documentation":"The Resource identifier for the MethodResponse resource.
",
"location":"uri",
"locationName":"resource_id"
},
"httpMethod":{
"shape":"String",
"documentation":"The HTTP verb identifier for the parent Method resource.
",
"location":"uri",
"locationName":"http_method"
},
"statusCode":{
"shape":"StatusCode",
"documentation":"The status code identifier for the MethodResponse resource.
",
"location":"uri",
"locationName":"status_code"
}
},
"documentation":"Request to describe a MethodResponse resource.
"
},
"GetModelRequest":{
"type":"structure",
"required":[
"restApiId",
"modelName"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The RestApi identifier under which the Model exists.
",
"location":"uri",
"locationName":"restapi_id"
},
"modelName":{
"shape":"String",
"documentation":"The name of the model as an identifier.
",
"location":"uri",
"locationName":"model_name"
},
"flatten":{
"shape":"Boolean",
"documentation":"Resolves all external model references and returns a flattened model schema.
",
"location":"querystring",
"locationName":"flatten"
}
},
"documentation":"Request to list information about a model in an existing RestApi resource.
"
},
"GetModelTemplateRequest":{
"type":"structure",
"required":[
"restApiId",
"modelName"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The ID of the RestApi under which the model exists.
",
"location":"uri",
"locationName":"restapi_id"
},
"modelName":{
"shape":"String",
"documentation":"The name of the model for which to generate a template.
",
"location":"uri",
"locationName":"model_name"
}
},
"documentation":"Request to generate a sample mapping template used to transform the payload.
"
},
"GetModelsRequest":{
"type":"structure",
"required":["restApiId"],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The RestApi identifier.
",
"location":"uri",
"locationName":"restapi_id"
},
"position":{
"shape":"String",
"documentation":"The position of the next set of results in the Models resource to get information about.
",
"location":"querystring",
"locationName":"position"
},
"limit":{
"shape":"NullableInteger",
"documentation":"The maximum number of models in the collection to get information about. The default limit is 25. It should be an integer between 1 - 500.
",
"location":"querystring",
"locationName":"limit"
}
},
"documentation":"Request to list existing Models defined for a RestApi resource.
"
},
"GetResourceRequest":{
"type":"structure",
"required":[
"restApiId",
"resourceId"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The RestApi identifier for the resource.
",
"location":"uri",
"locationName":"restapi_id"
},
"resourceId":{
"shape":"String",
"documentation":"The identifier for the Resource resource.
",
"location":"uri",
"locationName":"resource_id"
}
},
"documentation":"Request to list information about a resource.
"
},
"GetResourcesRequest":{
"type":"structure",
"required":["restApiId"],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The RestApi identifier for the Resource.
",
"location":"uri",
"locationName":"restapi_id"
},
"position":{
"shape":"String",
"documentation":"The position of the next set of results in the current Resources resource to get information about.
",
"location":"querystring",
"locationName":"position"
},
"limit":{
"shape":"NullableInteger",
"documentation":"The maximum number of Resource resources in the collection to get information about. The default limit is 25. It should be an integer between 1 - 500.
",
"location":"querystring",
"locationName":"limit"
}
},
"documentation":"Request to list information about a collection of resources.
"
},
"GetRestApiRequest":{
"type":"structure",
"required":["restApiId"],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The identifier of the RestApi resource.
",
"location":"uri",
"locationName":"restapi_id"
}
},
"documentation":"The GET request to list an existing RestApi defined for your collection.
"
},
"GetRestApisRequest":{
"type":"structure",
"members":{
"position":{
"shape":"String",
"documentation":"The position of the current RestApis resource in the collection to get information about.
",
"location":"querystring",
"locationName":"position"
},
"limit":{
"shape":"NullableInteger",
"documentation":"The maximum number of RestApi resources in the collection to get information about. The default limit is 25. It should be an integer between 1 - 500.
",
"location":"querystring",
"locationName":"limit"
}
},
"documentation":"The GET request to list existing RestApis defined for your collection.
"
},
"GetSdkRequest":{
"type":"structure",
"required":[
"restApiId",
"stageName",
"sdkType"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The identifier of the RestApi that the SDK will use.
",
"location":"uri",
"locationName":"restapi_id"
},
"stageName":{
"shape":"String",
"documentation":"The name of the Stage that the SDK will use.
",
"location":"uri",
"locationName":"stage_name"
},
"sdkType":{
"shape":"String",
"documentation":"The language for the generated SDK. Currently javascript, android, and objectivec (for iOS) are supported.
",
"location":"uri",
"locationName":"sdk_type"
},
"parameters":{
"shape":"MapOfStringToString",
"documentation":"A key-value map of query string parameters that specify properties of the SDK, depending on the requested sdkType. For sdkType 'objectivec', a parameter named \"classPrefix\" is required. For sdkType 'android', parameters named \"groupId\", \"artifactId\", \"artifactVersion\", and \"invokerPackage\" are required.
",
"location":"querystring"
}
},
"documentation":"Request a new generated client SDK for a RestApi and Stage.
"
},
"GetStageRequest":{
"type":"structure",
"required":[
"restApiId",
"stageName"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The identifier of the RestApi resource for the Stage resource to get information about.
",
"location":"uri",
"locationName":"restapi_id"
},
"stageName":{
"shape":"String",
"documentation":"The name of the Stage resource to get information about.
",
"location":"uri",
"locationName":"stage_name"
}
},
"documentation":"Requests Amazon API Gateway to get information about a Stage resource.
"
},
"GetStagesRequest":{
"type":"structure",
"required":["restApiId"],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The stages' API identifiers.
",
"location":"uri",
"locationName":"restapi_id"
},
"deploymentId":{
"shape":"String",
"documentation":"The stages' deployment identifiers.
",
"location":"querystring",
"locationName":"deploymentId"
}
},
"documentation":"Requests Amazon API Gateway to get information about one or more Stage resources.
"
},
"ImportRestApiRequest":{
"type":"structure",
"required":["body"],
"members":{
"failOnWarnings":{
"shape":"Boolean",
"documentation":"A query parameter to indicate whether to rollback the API creation (true) or not (false) when a warning is encountered. The default value is false.
",
"location":"querystring",
"locationName":"failonwarnings"
},
"parameters":{
"shape":"MapOfStringToString",
"documentation":"Custom header parameters as part of the request.
",
"location":"querystring"
},
"body":{
"shape":"Blob",
"documentation":"The POST request body containing external API definitions. Currently, only Swagger definition JSON files are supported.
"
}
},
"documentation":"A POST request to import an API to Amazon API Gateway using an input of an API definition file.
",
"payload":"body"
},
"Integer":{"type":"integer"},
"Integration":{
"type":"structure",
"members":{
"type":{
"shape":"IntegrationType",
"documentation":"Specifies the integration's type. The valid value is HTTP, AWS, or MOCK.
"
},
"httpMethod":{
"shape":"String",
"documentation":"Specifies the integration's HTTP method type.
"
},
"uri":{
"shape":"String",
"documentation":"Specifies the integration's Uniform Resource Identifier (URI). For HTTP integrations, the URI must be a fully formed, encoded HTTP(S) URL according to the RFC-3986 specification. For AWS integrations, the URI should be of the form arn:aws:apigateway:{region}:{subdomain.service|service}:{path|action}/{service_api}. Region, subdomain and service are used to determine the right endpoint. For AWS services that use the Action= query string parameter, service_api should be a valid action for the desired service. For RESTful AWS service APIs, path is used to indicate that the remaining substring in the URI should be treated as the path to the resource, including the initial /.
"
},
"credentials":{
"shape":"String",
"documentation":"Specifies the credentials required for the integration, if any. For AWS integrations, three options are available. To specify an IAM Role for Amazon API Gateway to assume, use the role's Amazon Resource Name (ARN). To require that the caller's identity be passed through from the request, specify the string arn:aws:iam::\\*:user/\\*. To use resource-based permissions on supported AWS services, specify null.
"
},
"requestParameters":{
"shape":"MapOfStringToString",
"documentation":"Represents requests parameters that are sent with the backend request. Request parameters are represented as a key/value map, with a destination as the key and a source as the value. A source must match an existing method request parameter, or a static value. Static values must be enclosed with single quotes, and be pre-encoded based on their destination in the request. The destination must match the pattern integration.request.{location}.{name}, where location is either querystring, path, or header. name must be a valid, unique parameter name.
"
},
"requestTemplates":{
"shape":"MapOfStringToString",
"documentation":"Represents a map of Velocity templates that are applied on the request payload based on the value of the Content-Type header sent by the client. The content type value is the key in this map, and the template (as a String) is the value.
"
},
"passthroughBehavior":{
"shape":"String",
"documentation":"Specifies the pass-through behavior for incoming requests based on the Content-Type header in the request, and the available requestTemplates defined on the Integration. There are three valid values: WHEN_NO_MATCH, WHEN_NO_TEMPLATES, and NEVER.
WHEN_NO_MATCH passes the request body for unmapped content types through to the Integration backend without transformation.
NEVER rejects unmapped content types with an HTTP 415 'Unsupported Media Type' response.
WHEN_NO_TEMPLATES will allow pass-through when the Integration has NO content types mapped to templates. However if there is at least one content type defined, unmapped content types will be rejected with the same 415 response.
"
},
"cacheNamespace":{
"shape":"String",
"documentation":"Specifies the integration's cache namespace.
"
},
"cacheKeyParameters":{
"shape":"ListOfString",
"documentation":"Specifies the integration's cache key parameters.
"
},
"integrationResponses":{
"shape":"MapOfIntegrationResponse",
"documentation":"Specifies the integration's responses.
"
}
},
"documentation":"Represents a HTTP, AWS, or Mock integration.
"
},
"IntegrationResponse":{
"type":"structure",
"members":{
"statusCode":{
"shape":"StatusCode",
"documentation":"Specifies the status code that is used to map the integration response to an existing MethodResponse.
"
},
"selectionPattern":{
"shape":"String",
"documentation":"Specifies the regular expression (regex) pattern used to choose an integration response based on the response from the backend. If the backend is an AWS Lambda function, the AWS Lambda function error header is matched. For all other HTTP and AWS backends, the HTTP status code is matched.
"
},
"responseParameters":{
"shape":"MapOfStringToString",
"documentation":"Represents response parameters that can be read from the backend response. Response parameters are represented as a key/value map, with a destination as the key and a source as the value. A destination must match an existing response parameter in the MethodResponse. The source can be a header from the backend response, or a static value. Static values are specified using enclosing single quotes, and backend response headers can be read using the pattern integration.response.header.{name}.
"
},
"responseTemplates":{
"shape":"MapOfStringToString",
"documentation":"Specifies the templates used to transform the integration response body. Response templates are represented as a key/value map, with a content-type as the key and a template as the value.
"
}
},
"documentation":"Represents an integration response. The status code must map to an existing MethodResponse, and parameters and templates can be used to transform the backend response.
"
},
"IntegrationType":{
"type":"string",
"documentation":"The integration type. The valid value is HTTP, AWS, or MOCK.
",
"enum":[
"HTTP",
"AWS",
"MOCK"
]
},
"LimitExceededException":{
"type":"structure",
"members":{
"retryAfterSeconds":{
"shape":"String",
"location":"header",
"locationName":"Retry-After"
},
"message":{"shape":"String"}
},
"error":{"httpStatusCode":429},
"exception":true
},
"ListOfARNs":{
"type":"list",
"member":{"shape":"ProviderARN"}
},
"ListOfApiKey":{
"type":"list",
"member":{"shape":"ApiKey"}
},
"ListOfAuthorizer":{
"type":"list",
"member":{"shape":"Authorizer"}
},
"ListOfBasePathMapping":{
"type":"list",
"member":{"shape":"BasePathMapping"}
},
"ListOfClientCertificate":{
"type":"list",
"member":{"shape":"ClientCertificate"}
},
"ListOfDeployment":{
"type":"list",
"member":{"shape":"Deployment"}
},
"ListOfDomainName":{
"type":"list",
"member":{"shape":"DomainName"}
},
"ListOfModel":{
"type":"list",
"member":{"shape":"Model"}
},
"ListOfPatchOperation":{
"type":"list",
"member":{"shape":"PatchOperation"},
"documentation":"A list of operations describing the updates to apply to the specified resource. The patches are applied in the order specified in the list."
},
"ListOfResource":{
"type":"list",
"member":{"shape":"Resource"}
},
"ListOfRestApi":{
"type":"list",
"member":{"shape":"RestApi"}
},
"ListOfStage":{
"type":"list",
"member":{"shape":"Stage"}
},
"ListOfStageKeys":{
"type":"list",
"member":{"shape":"StageKey"}
},
"ListOfString":{
"type":"list",
"member":{"shape":"String"}
},
"Long":{"type":"long"},
"MapOfHeaderValues":{
"type":"map",
"key":{"shape":"String"},
"value":{"shape":"String"}
},
"MapOfIntegrationResponse":{
"type":"map",
"key":{"shape":"String"},
"value":{"shape":"IntegrationResponse"}
},
"MapOfMethod":{
"type":"map",
"key":{"shape":"String"},
"value":{"shape":"Method"}
},
"MapOfMethodResponse":{
"type":"map",
"key":{"shape":"String"},
"value":{"shape":"MethodResponse"}
},
"MapOfMethodSettings":{
"type":"map",
"key":{"shape":"String"},
"value":{"shape":"MethodSetting"}
},
"MapOfMethodSnapshot":{
"type":"map",
"key":{"shape":"String"},
"value":{"shape":"MethodSnapshot"}
},
"MapOfStringToBoolean":{
"type":"map",
"key":{"shape":"String"},
"value":{"shape":"NullableBoolean"}
},
"MapOfStringToList":{
"type":"map",
"key":{"shape":"String"},
"value":{"shape":"ListOfString"}
},
"MapOfStringToString":{
"type":"map",
"key":{"shape":"String"},
"value":{"shape":"String"}
},
"Method":{
"type":"structure",
"members":{
"httpMethod":{
"shape":"String",
"documentation":"The HTTP method.
"
},
"authorizationType":{
"shape":"String",
"documentation":"The method's authorization type.
"
},
"authorizerId":{
"shape":"String",
"documentation":"Specifies the identifier of an Authorizer to use on this Method. The authorizationType must be CUSTOM.
"
},
"apiKeyRequired":{
"shape":"NullableBoolean",
"documentation":"Specifies whether the method requires a valid ApiKey.
"
},
"requestParameters":{
"shape":"MapOfStringToBoolean",
"documentation":"Represents request parameters that can be accepted by Amazon API Gateway. Request parameters are represented as a key/value map, with a source as the key and a Boolean flag as the value. The Boolean flag is used to specify whether the parameter is required. A source must match the pattern method.request.{location}.{name}, where location is either querystring, path, or header. name is a valid, unique parameter name. Sources specified here are available to the integration for mapping to integration request parameters or templates.
"
},
"requestModels":{
"shape":"MapOfStringToString",
"documentation":"Specifies the Model resources used for the request's content type. Request models are represented as a key/value map, with a content type as the key and a Model name as the value.
"
},
"methodResponses":{
"shape":"MapOfMethodResponse",
"documentation":"Represents available responses that can be sent to the caller. Method responses are represented as a key/value map, with an HTTP status code as the key and a MethodResponse as the value. The status codes are available for the Integration responses to map to.
"
},
"methodIntegration":{
"shape":"Integration",
"documentation":"The method's integration.
"
}
},
"documentation":"Represents a method.
"
},
"MethodResponse":{
"type":"structure",
"members":{
"statusCode":{
"shape":"StatusCode",
"documentation":"The method response's status code.
"
},
"responseParameters":{
"shape":"MapOfStringToBoolean",
"documentation":"Represents response parameters that can be sent back to the caller by Amazon API Gateway. Response parameters are represented as a key/value map, with a destination as the key and a boolean flag as the value, which is used to specify whether the parameter is required. A destination must match the pattern method.response.header.{name}, where name is a valid, unique header name. Destinations specified here are available to the integration for mapping from integration response parameters.
"
},
"responseModels":{
"shape":"MapOfStringToString",
"documentation":"Specifies the Model resources used for the response's content-type. Response models are represented as a key/value map, with a content-type as the key and a Model name as the value.
"
}
},
"documentation":"Represents a method response. Amazon API Gateway sends back the status code to the caller as the HTTP status code. Parameters and models can be used to transform the response from the method's integration.
"
},
"MethodSetting":{
"type":"structure",
"members":{
"metricsEnabled":{
"shape":"Boolean",
"documentation":"Specifies whether Amazon CloudWatch metrics are enabled for this method. The PATCH path for this setting is /{method_setting_key}/metrics/enabled, and the value is a Boolean.
"
},
"loggingLevel":{
"shape":"String",
"documentation":"Specifies the logging level for this method, which effects the log entries pushed to Amazon CloudWatch Logs. The PATCH path for this setting is /{method_setting_key}/logging/loglevel, and the available levels are OFF, ERROR, and INFO.
"
},
"dataTraceEnabled":{
"shape":"Boolean",
"documentation":"Specifies the whether data trace logging is enabled for this method, which effects the log entries pushed to Amazon CloudWatch Logs. The PATCH path for this setting is /{method_setting_key}/logging/dataTrace, and the value is a Boolean.
"
},
"throttlingBurstLimit":{
"shape":"Integer",
"documentation":"Specifies the throttling burst limit. The PATCH path for this setting is /{method_setting_key}/throttling/burstLimit, and the value is an integer.
"
},
"throttlingRateLimit":{
"shape":"Double",
"documentation":"Specifies the throttling rate limit. The PATCH path for this setting is /{method_setting_key}/throttling/rateLimit, and the value is a double.
"
},
"cachingEnabled":{
"shape":"Boolean",
"documentation":"Specifies whether responses should be cached and returned for requests. A cache cluster must be enabled on the stage for responses to be cached. The PATCH path for this setting is /{method_setting_key}/caching/enabled, and the value is a Boolean.
"
},
"cacheTtlInSeconds":{
"shape":"Integer",
"documentation":"Specifies the time to live (TTL) in seconds, for cached responses. The higher a the TTL, the longer the response will be cached. The PATCH path for this setting is /{method_setting_key}/caching/ttlInSeconds, and the value is an integer.
"
},
"cacheDataEncrypted":{
"shape":"Boolean",
"documentation":"Specifies whether the cached responses are encrypted. The PATCH path for this setting is /{method_setting_key}/caching/dataEncrypted, and the value is a Boolean.
"
},
"requireAuthorizationForCacheControl":{
"shape":"Boolean",
"documentation":"Specifies whether authorization is required for a cache invalidation request. The PATCH path for this setting is /{method_setting_key}/caching/requireAuthorizationForCacheControl, and the value is a Boolean.
"
},
"unauthorizedCacheControlHeaderStrategy":{
"shape":"UnauthorizedCacheControlHeaderStrategy",
"documentation":"Specifies the strategy on how to handle the unauthorized requests for cache invalidation. The PATCH path for this setting is /{method_setting_key}/caching/unauthorizedCacheControlHeaderStrategy, and the available values are FAIL_WITH_403, SUCCEED_WITH_RESPONSE_HEADER, SUCCEED_WITHOUT_RESPONSE_HEADER.
"
}
},
"documentation":"Specifies the method setting properties.
"
},
"MethodSnapshot":{
"type":"structure",
"members":{
"authorizationType":{
"shape":"String",
"documentation":"Specifies the type of authorization used for the method.
"
},
"apiKeyRequired":{
"shape":"Boolean",
"documentation":"Specifies whether the method requires a valid ApiKey.
"
}
},
"documentation":"Represents a summary of a Method resource, given a particular date and time.
"
},
"Model":{
"type":"structure",
"members":{
"id":{
"shape":"String",
"documentation":"The identifier for the model resource.
"
},
"name":{
"shape":"String",
"documentation":"The name of the model.
"
},
"description":{
"shape":"String",
"documentation":"The description of the model.
"
},
"schema":{
"shape":"String",
"documentation":"The schema for the model. For application/json models, this should be JSON-schema draft v4 model.
"
},
"contentType":{
"shape":"String",
"documentation":"The content-type for the model.
"
}
},
"documentation":"Represents the structure of a request or response payload for a method.
"
},
"Models":{
"type":"structure",
"members":{
"position":{"shape":"String"},
"items":{
"shape":"ListOfModel",
"documentation":"Gets the current Model resource in the collection.
",
"locationName":"item"
}
},
"documentation":"Represents a collection of Model resources.
"
},
"NotFoundException":{
"type":"structure",
"members":{
"message":{"shape":"String"}
},
"error":{"httpStatusCode":404},
"exception":true
},
"NullableBoolean":{"type":"boolean"},
"NullableInteger":{"type":"integer"},
"PatchOperation":{
"type":"structure",
"members":{
"op":{
"shape":"op",
"documentation":"A patch operation whose value indicates the operation to perform. Its value MUST be one of \"add\", \"remove\", \"replace\", \"move\", \"copy\", or \"test\"; other values are errors.
"
},
"path":{
"shape":"String",
"documentation":"Operation objects MUST have exactly one \"path\" member. That member's value is a string containing a `JSON-Pointer` value that references a location within the target document (the \"target location\") where the operation is performed.
"
},
"value":{
"shape":"String",
"documentation":"The actual value content.
"
},
"from":{
"shape":"String",
"documentation":"The \"move\" and \"copy\" operation object MUST contain a \"from\" member, which is a string containing a JSON Pointer value that references the location in the target document to move the value from.
"
}
},
"documentation":"A single patch operation to apply to the specified resource. Please refer to http://tools.ietf.org/html/rfc6902#section-4 for an explanation of how each operation is used."
},
"PathToMapOfMethodSnapshot":{
"type":"map",
"key":{"shape":"String"},
"value":{"shape":"MapOfMethodSnapshot"}
},
"ProviderARN":{"type":"string"},
"PutIntegrationRequest":{
"type":"structure",
"required":[
"restApiId",
"resourceId",
"httpMethod",
"type"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"Specifies a put integration request's API identifier.
",
"location":"uri",
"locationName":"restapi_id"
},
"resourceId":{
"shape":"String",
"documentation":"Specifies a put integration request's resource ID.
",
"location":"uri",
"locationName":"resource_id"
},
"httpMethod":{
"shape":"String",
"documentation":"Specifies a put integration request's HTTP method.
",
"location":"uri",
"locationName":"http_method"
},
"type":{
"shape":"IntegrationType",
"documentation":"Specifies a put integration input's type.
"
},
"integrationHttpMethod":{
"shape":"String",
"documentation":"Specifies a put integration HTTP method. When the integration type is HTTP or AWS, this field is required.
",
"locationName":"httpMethod"
},
"uri":{
"shape":"String",
"documentation":"Specifies a put integration input's Uniform Resource Identifier (URI). When the integration type is HTTP or AWS, this field is required. For integration with Lambda as an AWS service proxy, this value is of the 'arn:aws:apigateway:<region>:lambda:path/2015-03-31/functions/<functionArn>/invocations' format.
"
},
"credentials":{
"shape":"String",
"documentation":"Specifies whether credentials are required for a put integration.
"
},
"requestParameters":{
"shape":"MapOfStringToString",
"documentation":"Represents request parameters that are sent with the backend request. Request parameters are represented as a key/value map, with a destination as the key and a source as the value. A source must match an existing method request parameter, or a static value. Static values must be enclosed with single quotes, and be pre-encoded based on their destination in the request. The destination must match the pattern integration.request.{location}.{name}, where location is either querystring, path, or header. name must be a valid, unique parameter name.
"
},
"requestTemplates":{
"shape":"MapOfStringToString",
"documentation":"Represents a map of Velocity templates that are applied on the request payload based on the value of the Content-Type header sent by the client. The content type value is the key in this map, and the template (as a String) is the value.
"
},
"passthroughBehavior":{
"shape":"String",
"documentation":"Specifies the pass-through behavior for incoming requests based on the Content-Type header in the request, and the available requestTemplates defined on the Integration. There are three valid values: WHEN_NO_MATCH, WHEN_NO_TEMPLATES, and NEVER.
WHEN_NO_MATCH passes the request body for unmapped content types through to the Integration backend without transformation.
NEVER rejects unmapped content types with an HTTP 415 'Unsupported Media Type' response.
WHEN_NO_TEMPLATES will allow pass-through when the Integration has NO content types mapped to templates. However if there is at least one content type defined, unmapped content types will be rejected with the same 415 response.
"
},
"cacheNamespace":{
"shape":"String",
"documentation":"Specifies a put integration input's cache namespace.
"
},
"cacheKeyParameters":{
"shape":"ListOfString",
"documentation":"Specifies a put integration input's cache key parameters.
"
}
},
"documentation":"Represents a put integration request.
"
},
"PutIntegrationResponseRequest":{
"type":"structure",
"required":[
"restApiId",
"resourceId",
"httpMethod",
"statusCode"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"Specifies a put integration response request's API identifier.
",
"location":"uri",
"locationName":"restapi_id"
},
"resourceId":{
"shape":"String",
"documentation":"Specifies a put integration response request's resource identifier.
",
"location":"uri",
"locationName":"resource_id"
},
"httpMethod":{
"shape":"String",
"documentation":"Specifies a put integration response request's HTTP method.
",
"location":"uri",
"locationName":"http_method"
},
"statusCode":{
"shape":"StatusCode",
"documentation":"Specifies the status code that is used to map the integration response to an existing MethodResponse.
",
"location":"uri",
"locationName":"status_code"
},
"selectionPattern":{
"shape":"String",
"documentation":"Specifies the selection pattern of a put integration response.
"
},
"responseParameters":{
"shape":"MapOfStringToString",
"documentation":"Represents response parameters that can be read from the backend response. Response parameters are represented as a key/value map, with a destination as the key and a source as the value. A destination must match an existing response parameter in the Method. The source can be a header from the backend response, or a static value. Static values are specified using enclosing single quotes, and backend response headers can be read using the pattern integration.response.header.{name}.
"
},
"responseTemplates":{
"shape":"MapOfStringToString",
"documentation":"Specifies a put integration response's templates.
"
}
},
"documentation":"Represents a put integration response request.
"
},
"PutMethodRequest":{
"type":"structure",
"required":[
"restApiId",
"resourceId",
"httpMethod",
"authorizationType"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The RestApi identifier for the new Method resource.
",
"location":"uri",
"locationName":"restapi_id"
},
"resourceId":{
"shape":"String",
"documentation":"The Resource identifier for the new Method resource.
",
"location":"uri",
"locationName":"resource_id"
},
"httpMethod":{
"shape":"String",
"documentation":"Specifies the put method request's HTTP method type.
",
"location":"uri",
"locationName":"http_method"
},
"authorizationType":{
"shape":"String",
"documentation":"Specifies the type of authorization used for the method.
"
},
"authorizerId":{
"shape":"String",
"documentation":"Specifies the identifier of an Authorizer to use on this Method, if the type is CUSTOM.
"
},
"apiKeyRequired":{
"shape":"Boolean",
"documentation":"Specifies whether the method required a valid ApiKey.
"
},
"requestParameters":{
"shape":"MapOfStringToBoolean",
"documentation":"Represents requests parameters that are sent with the backend request. Request parameters are represented as a key/value map, with a destination as the key and a source as the value. A source must match an existing method request parameter, or a static value. Static values must be enclosed with single quotes, and be pre-encoded based on their destination in the request. The destination must match the pattern integration.request.{location}.{name}, where location is either querystring, path, or header. name must be a valid, unique parameter name.
"
},
"requestModels":{
"shape":"MapOfStringToString",
"documentation":"Specifies the Model resources used for the request's content type. Request models are represented as a key/value map, with a content type as the key and a Model name as the value.
"
}
},
"documentation":"Request to add a method to an existing Resource resource.
"
},
"PutMethodResponseRequest":{
"type":"structure",
"required":[
"restApiId",
"resourceId",
"httpMethod",
"statusCode"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The RestApi identifier for the Method resource.
",
"location":"uri",
"locationName":"restapi_id"
},
"resourceId":{
"shape":"String",
"documentation":"The Resource identifier for the Method resource.
",
"location":"uri",
"locationName":"resource_id"
},
"httpMethod":{
"shape":"String",
"documentation":"The HTTP verb that identifies the Method resource.
",
"location":"uri",
"locationName":"http_method"
},
"statusCode":{
"shape":"StatusCode",
"documentation":"The method response's status code.
",
"location":"uri",
"locationName":"status_code"
},
"responseParameters":{
"shape":"MapOfStringToBoolean",
"documentation":"Represents response parameters that can be sent back to the caller by Amazon API Gateway. Response parameters are represented as a key/value map, with a destination as the key and a Boolean flag as the value. The Boolean flag is used to specify whether the parameter is required. A destination must match the pattern method.response.header.{name}, where name is a valid, unique header name. Destinations specified here are available to the integration for mapping from integration response parameters.
"
},
"responseModels":{
"shape":"MapOfStringToString",
"documentation":"Specifies the Model resources used for the response's content type. Response models are represented as a key/value map, with a content type as the key and a Model name as the value.
"
}
},
"documentation":"Request to add a MethodResponse to an existing Method resource.
"
},
"PutMode":{
"type":"string",
"enum":[
"merge",
"overwrite"
]
},
"PutRestApiRequest":{
"type":"structure",
"required":[
"restApiId",
"body"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The identifier of the RestApi to be updated.
",
"location":"uri",
"locationName":"restapi_id"
},
"mode":{
"shape":"PutMode",
"documentation":"The mode query parameter to specify the update mode. Valid values are \"merge\" and \"overwrite\". By default, the update mode is \"merge\".
",
"location":"querystring",
"locationName":"mode"
},
"failOnWarnings":{
"shape":"Boolean",
"documentation":"A query parameter to indicate whether to rollback the API update (true) or not (false) when a warning is encountered. The default value is false.
",
"location":"querystring",
"locationName":"failonwarnings"
},
"parameters":{
"shape":"MapOfStringToString",
"documentation":"Custom headers supplied as part of the request.
",
"location":"querystring"
},
"body":{
"shape":"Blob",
"documentation":"The PUT request body containing external API definitions. Currently, only Swagger definition JSON files are supported.
"
}
},
"documentation":"A PUT request to update an existing API, with external API definitions specified as the request body.
",
"payload":"body"
},
"Resource":{
"type":"structure",
"members":{
"id":{
"shape":"String",
"documentation":"The resource's identifier.
"
},
"parentId":{
"shape":"String",
"documentation":"The parent resource's identifier.
"
},
"pathPart":{
"shape":"String",
"documentation":"The last path segment for this resource.
"
},
"path":{
"shape":"String",
"documentation":"The full path for this resource.
"
},
"resourceMethods":{
"shape":"MapOfMethod",
"documentation":"Map of methods for this resource, which is included only if the request uses the embed query option.
"
}
},
"documentation":"Represents a resource.
"
},
"Resources":{
"type":"structure",
"members":{
"position":{"shape":"String"},
"items":{
"shape":"ListOfResource",
"documentation":"Gets the current Resource resource in the collection.
",
"locationName":"item"
}
},
"documentation":"Represents a collection of Resource resources.
"
},
"RestApi":{
"type":"structure",
"members":{
"id":{
"shape":"String",
"documentation":"The API's identifier. This identifier is unique across all of your APIs in Amazon API Gateway.
"
},
"name":{
"shape":"String",
"documentation":"The API's name.
"
},
"description":{
"shape":"String",
"documentation":"The API's description.
"
},
"createdDate":{
"shape":"Timestamp",
"documentation":"The date when the API was created, in ISO 8601 format.
"
},
"warnings":{"shape":"ListOfString"}
},
"documentation":"Represents a REST API.
"
},
"RestApis":{
"type":"structure",
"members":{
"position":{"shape":"String"},
"items":{
"shape":"ListOfRestApi",
"documentation":"An array of links to the current page of RestApi resources.
",
"locationName":"item"
}
},
"documentation":"Contains references to your APIs and links that guide you in ways to interact with your collection. A collection offers a paginated view of your APIs.
"
},
"SdkResponse":{
"type":"structure",
"members":{
"contentType":{
"shape":"String",
"documentation":"The content-type header value in the HTTP response.
",
"location":"header",
"locationName":"Content-Type"
},
"contentDisposition":{
"shape":"String",
"documentation":"The content-disposition header value in the HTTP reseponse.
",
"location":"header",
"locationName":"Content-Disposition"
},
"body":{
"shape":"Blob",
"documentation":"The binary blob response to GetSdk, which contains the generated SDK.
"
}
},
"documentation":"The binary blob response to GetSdk, which contains the generated SDK.
",
"payload":"body"
},
"ServiceUnavailableException":{
"type":"structure",
"members":{
"retryAfterSeconds":{
"shape":"String",
"location":"header",
"locationName":"Retry-After"
},
"message":{"shape":"String"}
},
"error":{"httpStatusCode":503},
"exception":true,
"fault":true
},
"Stage":{
"type":"structure",
"members":{
"deploymentId":{
"shape":"String",
"documentation":"The identifier of the Deployment that the stage points to.
"
},
"clientCertificateId":{"shape":"String"},
"stageName":{
"shape":"String",
"documentation":"The name of the stage is the first path segment in the Uniform Resource Identifier (URI) of a call to Amazon API Gateway.
"
},
"description":{
"shape":"String",
"documentation":"The stage's description.
"
},
"cacheClusterEnabled":{
"shape":"Boolean",
"documentation":"Specifies whether a cache cluster is enabled for the stage.
"
},
"cacheClusterSize":{
"shape":"CacheClusterSize",
"documentation":"The size of the cache cluster for the stage, if enabled.
"
},
"cacheClusterStatus":{
"shape":"CacheClusterStatus",
"documentation":"The status of the cache cluster for the stage, if enabled.
"
},
"methodSettings":{
"shape":"MapOfMethodSettings",
"documentation":"A map that defines the method settings for a Stage resource. Keys are defined as {resource_path}/{http_method} for an individual method override, or \\*/\\* for the settings applied to all methods in the stage.
"
},
"variables":{
"shape":"MapOfStringToString",
"documentation":"A map that defines the stage variables for a Stage resource. Variable names can have alphanumeric characters, and the values must match [A-Za-z0-9-._~:/?#&=,]+.
"
},
"createdDate":{
"shape":"Timestamp",
"documentation":"The date and time that the stage was created, in ISO 8601 format.
"
},
"lastUpdatedDate":{
"shape":"Timestamp",
"documentation":"The date and time that information about the stage was last updated, in ISO 8601 format.
"
}
},
"documentation":"Represents a unique identifier for a version of a deployed RestApi that is callable by users.
"
},
"StageKey":{
"type":"structure",
"members":{
"restApiId":{
"shape":"String",
"documentation":"A list of Stage resources that are associated with the ApiKey resource.
"
},
"stageName":{
"shape":"String",
"documentation":"The stage name in the RestApi that the stage key references.
"
}
},
"documentation":"A reference to a unique stage identified in the format {restApiId}/{stage}.
"
},
"Stages":{
"type":"structure",
"members":{
"item":{
"shape":"ListOfStage",
"documentation":"An individual Stage resource.
"
}
},
"documentation":"A list of Stage resource that are associated with the ApiKey resource.
"
},
"StatusCode":{
"type":"string",
"documentation":"The status code.
",
"pattern":"[1-5]\\d\\d"
},
"String":{"type":"string"},
"Template":{
"type":"structure",
"members":{
"value":{
"shape":"String",
"documentation":"The Apache Velocity Template Language (VTL) template content used for the template resource.
"
}
},
"documentation":"Represents a mapping template used to transform a payload.
"
},
"TestInvokeAuthorizerRequest":{
"type":"structure",
"required":[
"restApiId",
"authorizerId"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"Specifies a test invoke authorizer request's RestApi identifier.
",
"location":"uri",
"locationName":"restapi_id"
},
"authorizerId":{
"shape":"String",
"documentation":"Specifies a test invoke authorizer request's Authorizer ID.
",
"location":"uri",
"locationName":"authorizer_id"
},
"headers":{
"shape":"MapOfHeaderValues",
"documentation":"[Required] A key-value map of headers to simulate an incoming invocation request. This is where the incoming authorization token, or identity source, should be specified.
"
},
"pathWithQueryString":{
"shape":"String",
"documentation":"[Optional] The URI path, including query string, of the simulated invocation request. Use this to specify path parameters and query string parameters.
"
},
"body":{
"shape":"String",
"documentation":"[Optional] The simulated request body of an incoming invocation request.
"
},
"stageVariables":{
"shape":"MapOfStringToString",
"documentation":"A key-value map of stage variables to simulate an invocation on a deployed Stage.
"
},
"additionalContext":{
"shape":"MapOfStringToString",
"documentation":"[Optional] A key-value map of additional context variables.
"
}
},
"documentation":"Make a request to simulate the execution of an Authorizer.
"
},
"TestInvokeAuthorizerResponse":{
"type":"structure",
"members":{
"clientStatus":{
"shape":"Integer",
"documentation":"The HTTP status code that the client would have received. Value is 0 if the authorizer succeeded.
"
},
"log":{
"shape":"String",
"documentation":"The Amazon API Gateway execution log for the test authorizer request.
"
},
"latency":{
"shape":"Long",
"documentation":"The execution latency of the test authorizer request
"
},
"principalId":{
"shape":"String",
"documentation":"The principal identity returned by the Authorizer
"
},
"policy":{
"shape":"String",
"documentation":"The policy JSON document returned by the Authorizer
"
},
"authorization":{"shape":"MapOfStringToList"},
"claims":{"shape":"MapOfStringToString"}
},
"documentation":"Represents the response of the test invoke request in for a custom Authorizer
"
},
"TestInvokeMethodRequest":{
"type":"structure",
"required":[
"restApiId",
"resourceId",
"httpMethod"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"Specifies a test invoke method request's API identifier.
",
"location":"uri",
"locationName":"restapi_id"
},
"resourceId":{
"shape":"String",
"documentation":"Specifies a test invoke method request's resource ID.
",
"location":"uri",
"locationName":"resource_id"
},
"httpMethod":{
"shape":"String",
"documentation":"Specifies a test invoke method request's HTTP method.
",
"location":"uri",
"locationName":"http_method"
},
"pathWithQueryString":{
"shape":"String",
"documentation":"The URI path, including query string, of the simulated invocation request. Use this to specify path parameters and query string parameters.
"
},
"body":{
"shape":"String",
"documentation":"The simulated request body of an incoming invocation request.
"
},
"headers":{
"shape":"MapOfHeaderValues",
"documentation":"A key-value map of headers to simulate an incoming invocation request.
"
},
"clientCertificateId":{
"shape":"String",
"documentation":"A ClientCertificate identifier to use in the test invocation. API Gateway will use use the certificate when making the HTTPS request to the defined backend endpoint.
"
},
"stageVariables":{
"shape":"MapOfStringToString",
"documentation":"A key-value map of stage variables to simulate an invocation on a deployed Stage.
"
}
},
"documentation":"Make a request to simulate the execution of a Method.
"
},
"TestInvokeMethodResponse":{
"type":"structure",
"members":{
"status":{
"shape":"Integer",
"documentation":"The HTTP status code.
"
},
"body":{
"shape":"String",
"documentation":"The body of HTTP response.
"
},
"headers":{
"shape":"MapOfHeaderValues",
"documentation":"The headers of HTTP response.
"
},
"log":{
"shape":"String",
"documentation":"The Amazon API Gateway execution log for the test invoke request.
"
},
"latency":{
"shape":"Long",
"documentation":"The execution latency of the test invoke request.
"
}
},
"documentation":"Represents the response of the test invoke request in HTTP method.
"
},
"ThrottleSettings":{
"type":"structure",
"members":{
"burstLimit":{
"shape":"Integer",
"documentation":"Returns the burstLimit when ThrottleSettings is called.
"
},
"rateLimit":{
"shape":"Double",
"documentation":"Returns the rateLimit when ThrottleSettings is called.
"
}
},
"documentation":"Returns the throttle settings.
"
},
"Timestamp":{"type":"timestamp"},
"TooManyRequestsException":{
"type":"structure",
"members":{
"retryAfterSeconds":{
"shape":"String",
"location":"header",
"locationName":"Retry-After"
},
"message":{"shape":"String"}
},
"error":{"httpStatusCode":429},
"exception":true
},
"UnauthorizedCacheControlHeaderStrategy":{
"type":"string",
"enum":[
"FAIL_WITH_403",
"SUCCEED_WITH_RESPONSE_HEADER",
"SUCCEED_WITHOUT_RESPONSE_HEADER"
]
},
"UnauthorizedException":{
"type":"structure",
"members":{
"message":{"shape":"String"}
},
"error":{"httpStatusCode":401},
"exception":true
},
"UpdateAccountRequest":{
"type":"structure",
"members":{
"patchOperations":{
"shape":"ListOfPatchOperation",
"documentation":"A list of operations describing the updates to apply to the specified resource. The patches are applied in the order specified in the list.
"
}
},
"documentation":"Requests Amazon API Gateway to change information about the current Account resource.
"
},
"UpdateApiKeyRequest":{
"type":"structure",
"required":["apiKey"],
"members":{
"apiKey":{
"shape":"String",
"documentation":"The identifier of the ApiKey resource to be updated.
",
"location":"uri",
"locationName":"api_Key"
},
"patchOperations":{
"shape":"ListOfPatchOperation",
"documentation":"A list of operations describing the updates to apply to the specified resource. The patches are applied in the order specified in the list.
"
}
},
"documentation":"A request to change information about an ApiKey resource.
"
},
"UpdateAuthorizerRequest":{
"type":"structure",
"required":[
"restApiId",
"authorizerId"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The RestApi identifier for the Authorizer resource.
",
"location":"uri",
"locationName":"restapi_id"
},
"authorizerId":{
"shape":"String",
"documentation":"The identifier of the Authorizer resource.
",
"location":"uri",
"locationName":"authorizer_id"
},
"patchOperations":{
"shape":"ListOfPatchOperation",
"documentation":"A list of operations describing the updates to apply to the specified resource. The patches are applied in the order specified in the list.
"
}
},
"documentation":"Request to update an existing Authorizer resource.
"
},
"UpdateBasePathMappingRequest":{
"type":"structure",
"required":[
"domainName",
"basePath"
],
"members":{
"domainName":{
"shape":"String",
"documentation":"The domain name of the BasePathMapping resource to change.
",
"location":"uri",
"locationName":"domain_name"
},
"basePath":{
"shape":"String",
"documentation":"The base path of the BasePathMapping resource to change.
",
"location":"uri",
"locationName":"base_path"
},
"patchOperations":{
"shape":"ListOfPatchOperation",
"documentation":"A list of operations describing the updates to apply to the specified resource. The patches are applied in the order specified in the list.
"
}
},
"documentation":"A request to change information about the BasePathMapping resource.
"
},
"UpdateClientCertificateRequest":{
"type":"structure",
"required":["clientCertificateId"],
"members":{
"clientCertificateId":{
"shape":"String",
"documentation":"The identifier of the ClientCertificate resource to be updated.
",
"location":"uri",
"locationName":"clientcertificate_id"
},
"patchOperations":{
"shape":"ListOfPatchOperation",
"documentation":"A list of operations describing the updates to apply to the specified resource. The patches are applied in the order specified in the list.
"
}
},
"documentation":"A request to change information about an ClientCertificate resource.
"
},
"UpdateDeploymentRequest":{
"type":"structure",
"required":[
"restApiId",
"deploymentId"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The replacement identifier of the RestApi resource for the Deployment resource to change information about.
",
"location":"uri",
"locationName":"restapi_id"
},
"deploymentId":{
"shape":"String",
"documentation":"The replacment identifier for the Deployment resource to change information about.
",
"location":"uri",
"locationName":"deployment_id"
},
"patchOperations":{
"shape":"ListOfPatchOperation",
"documentation":"A list of operations describing the updates to apply to the specified resource. The patches are applied in the order specified in the list.
"
}
},
"documentation":"Requests Amazon API Gateway to change information about a Deployment resource.
"
},
"UpdateDomainNameRequest":{
"type":"structure",
"required":["domainName"],
"members":{
"domainName":{
"shape":"String",
"documentation":"The name of the DomainName resource to be changed.
",
"location":"uri",
"locationName":"domain_name"
},
"patchOperations":{
"shape":"ListOfPatchOperation",
"documentation":"A list of operations describing the updates to apply to the specified resource. The patches are applied in the order specified in the list.
"
}
},
"documentation":"A request to change information about the DomainName resource.
"
},
"UpdateIntegrationRequest":{
"type":"structure",
"required":[
"restApiId",
"resourceId",
"httpMethod"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"Represents an update integration request's API identifier.
",
"location":"uri",
"locationName":"restapi_id"
},
"resourceId":{
"shape":"String",
"documentation":"Represents an update integration request's resource identifier.
",
"location":"uri",
"locationName":"resource_id"
},
"httpMethod":{
"shape":"String",
"documentation":"Represents an update integration request's HTTP method.
",
"location":"uri",
"locationName":"http_method"
},
"patchOperations":{
"shape":"ListOfPatchOperation",
"documentation":"A list of operations describing the updates to apply to the specified resource. The patches are applied in the order specified in the list.
"
}
},
"documentation":"Represents an update integration request.
"
},
"UpdateIntegrationResponseRequest":{
"type":"structure",
"required":[
"restApiId",
"resourceId",
"httpMethod",
"statusCode"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"Specifies an update integration response request's API identifier.
",
"location":"uri",
"locationName":"restapi_id"
},
"resourceId":{
"shape":"String",
"documentation":"Specifies an update integration response request's resource identifier.
",
"location":"uri",
"locationName":"resource_id"
},
"httpMethod":{
"shape":"String",
"documentation":"Specifies an update integration response request's HTTP method.
",
"location":"uri",
"locationName":"http_method"
},
"statusCode":{
"shape":"StatusCode",
"documentation":"Specifies an update integration response request's status code.
",
"location":"uri",
"locationName":"status_code"
},
"patchOperations":{
"shape":"ListOfPatchOperation",
"documentation":"A list of operations describing the updates to apply to the specified resource. The patches are applied in the order specified in the list.
"
}
},
"documentation":"Represents an update integration response request.
"
},
"UpdateMethodRequest":{
"type":"structure",
"required":[
"restApiId",
"resourceId",
"httpMethod"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The RestApi identifier for the Method resource.
",
"location":"uri",
"locationName":"restapi_id"
},
"resourceId":{
"shape":"String",
"documentation":"The Resource identifier for the Method resource.
",
"location":"uri",
"locationName":"resource_id"
},
"httpMethod":{
"shape":"String",
"documentation":"The HTTP verb that identifies the Method resource.
",
"location":"uri",
"locationName":"http_method"
},
"patchOperations":{
"shape":"ListOfPatchOperation",
"documentation":"A list of operations describing the updates to apply to the specified resource. The patches are applied in the order specified in the list.
"
}
},
"documentation":"Request to update an existing Method resource.
"
},
"UpdateMethodResponseRequest":{
"type":"structure",
"required":[
"restApiId",
"resourceId",
"httpMethod",
"statusCode"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The RestApi identifier for the MethodResponse resource.
",
"location":"uri",
"locationName":"restapi_id"
},
"resourceId":{
"shape":"String",
"documentation":"The Resource identifier for the MethodResponse resource.
",
"location":"uri",
"locationName":"resource_id"
},
"httpMethod":{
"shape":"String",
"documentation":"The HTTP verb identifier for the parent Method resource.
",
"location":"uri",
"locationName":"http_method"
},
"statusCode":{
"shape":"StatusCode",
"documentation":"The status code identifier for the MethodResponse resource.
",
"location":"uri",
"locationName":"status_code"
},
"patchOperations":{
"shape":"ListOfPatchOperation",
"documentation":"A list of operations describing the updates to apply to the specified resource. The patches are applied in the order specified in the list.
"
}
},
"documentation":"A request to update an existing MethodResponse resource.
"
},
"UpdateModelRequest":{
"type":"structure",
"required":[
"restApiId",
"modelName"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The RestApi identifier under which the model exists.
",
"location":"uri",
"locationName":"restapi_id"
},
"modelName":{
"shape":"String",
"documentation":"The name of the model to update.
",
"location":"uri",
"locationName":"model_name"
},
"patchOperations":{
"shape":"ListOfPatchOperation",
"documentation":"A list of operations describing the updates to apply to the specified resource. The patches are applied in the order specified in the list.
"
}
},
"documentation":"Request to update an existing model in an existing RestApi resource.
"
},
"UpdateResourceRequest":{
"type":"structure",
"required":[
"restApiId",
"resourceId"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The RestApi identifier for the Resource resource.
",
"location":"uri",
"locationName":"restapi_id"
},
"resourceId":{
"shape":"String",
"documentation":"The identifier of the Resource resource.
",
"location":"uri",
"locationName":"resource_id"
},
"patchOperations":{
"shape":"ListOfPatchOperation",
"documentation":"A list of operations describing the updates to apply to the specified resource. The patches are applied in the order specified in the list.
"
}
},
"documentation":"Request to change information about a Resource resource.
"
},
"UpdateRestApiRequest":{
"type":"structure",
"required":["restApiId"],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The ID of the RestApi you want to update.
",
"location":"uri",
"locationName":"restapi_id"
},
"patchOperations":{
"shape":"ListOfPatchOperation",
"documentation":"A list of operations describing the updates to apply to the specified resource. The patches are applied in the order specified in the list.
"
}
},
"documentation":"Request to update an existing RestApi resource in your collection.
"
},
"UpdateStageRequest":{
"type":"structure",
"required":[
"restApiId",
"stageName"
],
"members":{
"restApiId":{
"shape":"String",
"documentation":"The identifier of the RestApi resource for the Stage resource to change information about.
",
"location":"uri",
"locationName":"restapi_id"
},
"stageName":{
"shape":"String",
"documentation":"The name of the Stage resource to change information about.
",
"location":"uri",
"locationName":"stage_name"
},
"patchOperations":{
"shape":"ListOfPatchOperation",
"documentation":"A list of operations describing the updates to apply to the specified resource. The patches are applied in the order specified in the list.
"
}
},
"documentation":"Requests Amazon API Gateway to change information about a Stage resource.
"
},
"op":{
"type":"string",
"enum":[
"add",
"remove",
"replace",
"move",
"copy",
"test"
]
}
},
"documentation":"Amazon API Gateway Amazon API Gateway helps developers deliver robust, secure and scalable mobile and web application backends. Amazon API Gateway allows developers to securely connect mobile and web applications to APIs that run on AWS Lambda, Amazon EC2, or other publicly addressable web services that are hosted outside of AWS.
"
}