Table of Contents
APIGateway.Client¶A low-level client representing Amazon API Gateway:
client = session.create_client('apigateway')
These are the available methods:
can_paginate()create_api_key()create_authorizer()create_base_path_mapping()create_deployment()create_documentation_part()create_documentation_version()create_domain_name()create_model()create_request_validator()create_resource()create_rest_api()create_stage()create_usage_plan()create_usage_plan_key()delete_api_key()delete_authorizer()delete_base_path_mapping()delete_client_certificate()delete_deployment()delete_documentation_part()delete_documentation_version()delete_domain_name()delete_gateway_response()delete_integration()delete_integration_response()delete_method()delete_method_response()delete_model()delete_request_validator()delete_resource()delete_rest_api()delete_stage()delete_usage_plan()delete_usage_plan_key()flush_stage_authorizers_cache()flush_stage_cache()generate_client_certificate()generate_presigned_url()get_account()get_api_key()get_api_keys()get_authorizer()get_authorizers()get_base_path_mapping()get_base_path_mappings()get_client_certificate()get_client_certificates()get_deployment()get_deployments()get_documentation_part()get_documentation_parts()get_documentation_version()get_documentation_versions()get_domain_name()get_domain_names()get_export()get_gateway_response()get_gateway_responses()get_integration()get_integration_response()get_method()get_method_response()get_model()get_model_template()get_models()get_paginator()get_request_validator()get_request_validators()get_resource()get_resources()get_rest_api()get_rest_apis()get_sdk()get_sdk_type()get_sdk_types()get_stage()get_stages()get_usage()get_usage_plan()get_usage_plan_key()get_usage_plan_keys()get_usage_plans()get_waiter()import_api_keys()import_documentation_parts()import_rest_api()put_gateway_response()put_integration()put_integration_response()put_method()put_method_response()put_rest_api()test_invoke_authorizer()test_invoke_method()update_account()update_api_key()update_authorizer()update_base_path_mapping()update_client_certificate()update_deployment()update_documentation_part()update_documentation_version()update_domain_name()update_gateway_response()update_integration()update_integration_response()update_method()update_method_response()update_model()update_request_validator()update_resource()update_rest_api()update_stage()update_usage()update_usage_plan()can_paginate(operation_name)¶Check if an operation can be paginated.
| Parameters: | operation_name (string) – The operation name. This is the same name
as the method name on the client. For example, if the
method name is create_foo, and you’d normally invoke the
operation as client.create_foo(**kwargs), if the
create_foo operation can be paginated, you can use the
call client.get_paginator("create_foo"). |
|---|---|
| Returns: | True if the operation can be paginated,
False otherwise. |
create_api_key(**kwargs)¶Create an ApiKey resource.
See also: AWS API Documentation
Request Syntax
response = client.create_api_key(
name='string',
description='string',
enabled=True|False,
generateDistinctId=True|False,
value='string',
stageKeys=[
{
'restApiId': 'string',
'stageName': 'string'
},
],
customerId='string'
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'id': 'string',
'value': 'string',
'name': 'string',
'customerId': 'string',
'description': 'string',
'enabled': True|False,
'createdDate': datetime(2015, 1, 1),
'lastUpdatedDate': datetime(2015, 1, 1),
'stageKeys': [
'string',
]
}
Response Structure
|
Adds a new Authorizer resource to an existing RestApi resource.
See also: AWS API Documentation
Request Syntax
response = client.create_authorizer(
restApiId='string',
name='string',
type='TOKEN'|'COGNITO_USER_POOLS',
providerARNs=[
'string',
],
authType='string',
authorizerUri='string',
authorizerCredentials='string',
identitySource='string',
identityValidationExpression='string',
authorizerResultTtlInSeconds=123
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'id': 'string',
'name': 'string',
'type': 'TOKEN'|'COGNITO_USER_POOLS',
'providerARNs': [
'string',
],
'authType': 'string',
'authorizerUri': 'string',
'authorizerCredentials': 'string',
'identitySource': 'string',
'identityValidationExpression': 'string',
'authorizerResultTtlInSeconds': 123
}
Response Structure
|
create_base_path_mapping(**kwargs)¶Creates a new BasePathMapping resource.
See also: AWS API Documentation
Request Syntax
response = client.create_base_path_mapping(
domainName='string',
basePath='string',
restApiId='string',
stage='string'
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'basePath': 'string',
'restApiId': 'string',
'stage': 'string'
}
Response Structure
|
create_deployment(**kwargs)¶Creates a Deployment resource, which makes a specified RestApi callable over the internet.
See also: AWS API Documentation
Request Syntax
response = client.create_deployment(
restApiId='string',
stageName='string',
stageDescription='string',
description='string',
cacheClusterEnabled=True|False,
cacheClusterSize='0.5'|'1.6'|'6.1'|'13.5'|'28.4'|'58.2'|'118'|'237',
variables={
'string': 'string'
}
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'id': 'string',
'description': 'string',
'createdDate': datetime(2015, 1, 1),
'apiSummary': {
'string': {
'string': {
'authorizationType': 'string',
'apiKeyRequired': True|False
}
}
}
}
Response Structure
|
create_documentation_part(**kwargs)¶See also: AWS API Documentation
Request Syntax
response = client.create_documentation_part(
restApiId='string',
location={
'type': 'API'|'AUTHORIZER'|'MODEL'|'RESOURCE'|'METHOD'|'PATH_PARAMETER'|'QUERY_PARAMETER'|'REQUEST_HEADER'|'REQUEST_BODY'|'RESPONSE'|'RESPONSE_HEADER'|'RESPONSE_BODY',
'path': 'string',
'method': 'string',
'statusCode': 'string',
'name': 'string'
},
properties='string'
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'id': 'string',
'location': {
'type': 'API'|'AUTHORIZER'|'MODEL'|'RESOURCE'|'METHOD'|'PATH_PARAMETER'|'QUERY_PARAMETER'|'REQUEST_HEADER'|'REQUEST_BODY'|'RESPONSE'|'RESPONSE_HEADER'|'RESPONSE_BODY',
'path': 'string',
'method': 'string',
'statusCode': 'string',
'name': 'string'
},
'properties': 'string'
}
Response Structure
|
create_documentation_version(**kwargs)¶See also: AWS API Documentation
Request Syntax
response = client.create_documentation_version(
restApiId='string',
documentationVersion='string',
stageName='string',
description='string'
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'version': 'string',
'createdDate': datetime(2015, 1, 1),
'description': 'string'
}
Response Structure
|
create_domain_name(**kwargs)¶Creates a new domain name.
See also: AWS API Documentation
Request Syntax
response = client.create_domain_name(
domainName='string',
certificateName='string',
certificateBody='string',
certificatePrivateKey='string',
certificateChain='string',
certificateArn='string'
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'domainName': 'string',
'certificateName': 'string',
'certificateArn': 'string',
'certificateUploadDate': datetime(2015, 1, 1),
'distributionDomainName': 'string'
}
Response Structure
|
create_model(**kwargs)¶Adds a new Model resource to an existing RestApi resource.
See also: AWS API Documentation
Request Syntax
response = client.create_model(
restApiId='string',
name='string',
description='string',
schema='string',
contentType='string'
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'id': 'string',
'name': 'string',
'description': 'string',
'schema': 'string',
'contentType': 'string'
}
Response Structure
|
create_request_validator(**kwargs)¶Creates a ReqeustValidator of a given RestApi .
See also: AWS API Documentation
Request Syntax
response = client.create_request_validator(
restApiId='string',
name='string',
validateRequestBody=True|False,
validateRequestParameters=True|False
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'id': 'string',
'name': 'string',
'validateRequestBody': True|False,
'validateRequestParameters': True|False
}
Response Structure
|
create_resource(**kwargs)¶Creates a Resource resource.
See also: AWS API Documentation
Request Syntax
response = client.create_resource(
restApiId='string',
parentId='string',
pathPart='string'
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'id': 'string',
'parentId': 'string',
'pathPart': 'string',
'path': 'string',
'resourceMethods': {
'string': {
'httpMethod': 'string',
'authorizationType': 'string',
'authorizerId': 'string',
'apiKeyRequired': True|False,
'requestValidatorId': 'string',
'operationName': 'string',
'requestParameters': {
'string': True|False
},
'requestModels': {
'string': 'string'
},
'methodResponses': {
'string': {
'statusCode': 'string',
'responseParameters': {
'string': True|False
},
'responseModels': {
'string': 'string'
}
}
},
'methodIntegration': {
'type': 'HTTP'|'AWS'|'MOCK'|'HTTP_PROXY'|'AWS_PROXY',
'httpMethod': 'string',
'uri': 'string',
'credentials': 'string',
'requestParameters': {
'string': 'string'
},
'requestTemplates': {
'string': 'string'
},
'passthroughBehavior': 'string',
'contentHandling': 'CONVERT_TO_BINARY'|'CONVERT_TO_TEXT',
'cacheNamespace': 'string',
'cacheKeyParameters': [
'string',
],
'integrationResponses': {
'string': {
'statusCode': 'string',
'selectionPattern': 'string',
'responseParameters': {
'string': 'string'
},
'responseTemplates': {
'string': 'string'
},
'contentHandling': 'CONVERT_TO_BINARY'|'CONVERT_TO_TEXT'
}
}
}
}
}
}
Response Structure
|
create_rest_api(**kwargs)¶Creates a new RestApi resource.
See also: AWS API Documentation
Request Syntax
response = client.create_rest_api(
name='string',
description='string',
version='string',
cloneFrom='string',
binaryMediaTypes=[
'string',
]
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'id': 'string',
'name': 'string',
'description': 'string',
'createdDate': datetime(2015, 1, 1),
'version': 'string',
'warnings': [
'string',
],
'binaryMediaTypes': [
'string',
]
}
Response Structure
|
create_stage(**kwargs)¶Creates a new Stage resource that references a pre-existing Deployment for the API.
See also: AWS API Documentation
Request Syntax
response = client.create_stage(
restApiId='string',
stageName='string',
deploymentId='string',
description='string',
cacheClusterEnabled=True|False,
cacheClusterSize='0.5'|'1.6'|'6.1'|'13.5'|'28.4'|'58.2'|'118'|'237',
variables={
'string': 'string'
},
documentationVersion='string'
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'deploymentId': 'string',
'clientCertificateId': 'string',
'stageName': 'string',
'description': 'string',
'cacheClusterEnabled': True|False,
'cacheClusterSize': '0.5'|'1.6'|'6.1'|'13.5'|'28.4'|'58.2'|'118'|'237',
'cacheClusterStatus': 'CREATE_IN_PROGRESS'|'AVAILABLE'|'DELETE_IN_PROGRESS'|'NOT_AVAILABLE'|'FLUSH_IN_PROGRESS',
'methodSettings': {
'string': {
'metricsEnabled': True|False,
'loggingLevel': 'string',
'dataTraceEnabled': True|False,
'throttlingBurstLimit': 123,
'throttlingRateLimit': 123.0,
'cachingEnabled': True|False,
'cacheTtlInSeconds': 123,
'cacheDataEncrypted': True|False,
'requireAuthorizationForCacheControl': True|False,
'unauthorizedCacheControlHeaderStrategy': 'FAIL_WITH_403'|'SUCCEED_WITH_RESPONSE_HEADER'|'SUCCEED_WITHOUT_RESPONSE_HEADER'
}
},
'variables': {
'string': 'string'
},
'documentationVersion': 'string',
'createdDate': datetime(2015, 1, 1),
'lastUpdatedDate': datetime(2015, 1, 1)
}
Response Structure
|
create_usage_plan(**kwargs)¶Creates a usage plan with the throttle and quota limits, as well as the associated API stages, specified in the payload.
See also: AWS API Documentation
Request Syntax
response = client.create_usage_plan(
name='string',
description='string',
apiStages=[
{
'apiId': 'string',
'stage': 'string'
},
],
throttle={
'burstLimit': 123,
'rateLimit': 123.0
},
quota={
'limit': 123,
'offset': 123,
'period': 'DAY'|'WEEK'|'MONTH'
}
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'id': 'string',
'name': 'string',
'description': 'string',
'apiStages': [
{
'apiId': 'string',
'stage': 'string'
},
],
'throttle': {
'burstLimit': 123,
'rateLimit': 123.0
},
'quota': {
'limit': 123,
'offset': 123,
'period': 'DAY'|'WEEK'|'MONTH'
},
'productCode': 'string'
}
Response Structure
|
create_usage_plan_key(**kwargs)¶Creates a usage plan key for adding an existing API key to a usage plan.
See also: AWS API Documentation
Request Syntax
response = client.create_usage_plan_key(
usagePlanId='string',
keyId='string',
keyType='string'
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'id': 'string',
'type': 'string',
'value': 'string',
'name': 'string'
}
Response Structure
|
delete_api_key(**kwargs)¶Deletes the ApiKey resource.
See also: AWS API Documentation
Request Syntax
response = client.delete_api_key(
apiKey='string'
)
| Parameters: | apiKey (string) – [REQUIRED] The identifier of the ApiKey resource to be deleted. |
|---|---|
| Returns: | None |
Deletes an existing Authorizer resource.
See also: AWS API Documentation
Request Syntax
response = client.delete_authorizer(
restApiId='string',
authorizerId='string'
)
| Parameters: |
|
|---|---|
| Returns: | None |
delete_base_path_mapping(**kwargs)¶Deletes the BasePathMapping resource.
See also: AWS API Documentation
Request Syntax
response = client.delete_base_path_mapping(
domainName='string',
basePath='string'
)
| Parameters: |
|
|---|---|
| Returns: | None |
delete_client_certificate(**kwargs)¶Deletes the ClientCertificate resource.
See also: AWS API Documentation
Request Syntax
response = client.delete_client_certificate(
clientCertificateId='string'
)
| Parameters: | clientCertificateId (string) – [REQUIRED] The identifier of the ClientCertificate resource to be deleted. |
|---|---|
| Returns: | None |
delete_deployment(**kwargs)¶Deletes a Deployment resource. Deleting a deployment will only succeed if there are no Stage resources associated with it.
See also: AWS API Documentation
Request Syntax
response = client.delete_deployment(
restApiId='string',
deploymentId='string'
)
| Parameters: |
|
|---|---|
| Returns: | None |
delete_documentation_part(**kwargs)¶See also: AWS API Documentation
Request Syntax
response = client.delete_documentation_part(
restApiId='string',
documentationPartId='string'
)
| Parameters: |
|
|---|---|
| Returns: | None |
delete_documentation_version(**kwargs)¶See also: AWS API Documentation
Request Syntax
response = client.delete_documentation_version(
restApiId='string',
documentationVersion='string'
)
| Parameters: |
|
|---|---|
| Returns: | None |
delete_domain_name(**kwargs)¶Deletes the DomainName resource.
See also: AWS API Documentation
Request Syntax
response = client.delete_domain_name(
domainName='string'
)
| Parameters: | domainName (string) – [REQUIRED] The name of the DomainName resource to be deleted. |
|---|---|
| Returns: | None |
delete_gateway_response(**kwargs)¶Clears any customization of a GatewayResponse of a specified response type on the given RestApi and resets it with the default settings.
See also: AWS API Documentation
Request Syntax
response = client.delete_gateway_response(
restApiId='string',
responseType='DEFAULT_4XX'|'DEFAULT_5XX'|'RESOURCE_NOT_FOUND'|'UNAUTHORIZED'|'INVALID_API_KEY'|'ACCESS_DENIED'|'AUTHORIZER_FAILURE'|'AUTHORIZER_CONFIGURATION_ERROR'|'INVALID_SIGNATURE'|'EXPIRED_TOKEN'|'MISSING_AUTHENTICATION_TOKEN'|'INTEGRATION_FAILURE'|'INTEGRATION_TIMEOUT'|'API_CONFIGURATION_ERROR'|'UNSUPPORTED_MEDIA_TYPE'|'BAD_REQUEST_PARAMETERS'|'BAD_REQUEST_BODY'|'REQUEST_TOO_LARGE'|'THROTTLED'|'QUOTA_EXCEEDED'
)
| Parameters: |
|
|---|---|
| Returns: | None |
delete_integration(**kwargs)¶Represents a delete integration.
See also: AWS API Documentation
Request Syntax
response = client.delete_integration(
restApiId='string',
resourceId='string',
httpMethod='string'
)
| Parameters: |
|
|---|---|
| Returns: | None |
delete_integration_response(**kwargs)¶Represents a delete integration response.
See also: AWS API Documentation
Request Syntax
response = client.delete_integration_response(
restApiId='string',
resourceId='string',
httpMethod='string',
statusCode='string'
)
| Parameters: |
|
|---|---|
| Returns: | None |
delete_method(**kwargs)¶Deletes an existing Method resource.
See also: AWS API Documentation
Request Syntax
response = client.delete_method(
restApiId='string',
resourceId='string',
httpMethod='string'
)
| Parameters: |
|
|---|---|
| Returns: | None |
delete_method_response(**kwargs)¶Deletes an existing MethodResponse resource.
See also: AWS API Documentation
Request Syntax
response = client.delete_method_response(
restApiId='string',
resourceId='string',
httpMethod='string',
statusCode='string'
)
| Parameters: |
|
|---|---|
| Returns: | None |
delete_model(**kwargs)¶Deletes a model.
See also: AWS API Documentation
Request Syntax
response = client.delete_model(
restApiId='string',
modelName='string'
)
| Parameters: |
|
|---|---|
| Returns: | None |
delete_request_validator(**kwargs)¶Deletes a RequestValidator of a given RestApi .
See also: AWS API Documentation
Request Syntax
response = client.delete_request_validator(
restApiId='string',
requestValidatorId='string'
)
| Parameters: |
|
|---|---|
| Returns: | None |
delete_resource(**kwargs)¶Deletes a Resource resource.
See also: AWS API Documentation
Request Syntax
response = client.delete_resource(
restApiId='string',
resourceId='string'
)
| Parameters: |
|
|---|---|
| Returns: | None |
delete_rest_api(**kwargs)¶Deletes the specified API.
See also: AWS API Documentation
Request Syntax
response = client.delete_rest_api(
restApiId='string'
)
| Parameters: | restApiId (string) – [REQUIRED] The string identifier of the associated RestApi . |
|---|---|
| Returns: | None |
delete_stage(**kwargs)¶Deletes a Stage resource.
See also: AWS API Documentation
Request Syntax
response = client.delete_stage(
restApiId='string',
stageName='string'
)
| Parameters: |
|
|---|---|
| Returns: | None |
delete_usage_plan(**kwargs)¶Deletes a usage plan of a given plan Id.
See also: AWS API Documentation
Request Syntax
response = client.delete_usage_plan(
usagePlanId='string'
)
| Parameters: | usagePlanId (string) – [REQUIRED] The Id of the to-be-deleted usage plan. |
|---|---|
| Returns: | None |
delete_usage_plan_key(**kwargs)¶Deletes a usage plan key and remove the underlying API key from the associated usage plan.
See also: AWS API Documentation
Request Syntax
response = client.delete_usage_plan_key(
usagePlanId='string',
keyId='string'
)
| Parameters: |
|
|---|---|
| Returns: | None |
Flushes all authorizer cache entries on a stage.
See also: AWS API Documentation
Request Syntax
response = client.flush_stage_authorizers_cache(
restApiId='string',
stageName='string'
)
| Parameters: |
|
|---|---|
| Returns: | None |
flush_stage_cache(**kwargs)¶Flushes a stage’s cache.
See also: AWS API Documentation
Request Syntax
response = client.flush_stage_cache(
restApiId='string',
stageName='string'
)
| Parameters: |
|
|---|---|
| Returns: | None |
generate_client_certificate(**kwargs)¶Generates a ClientCertificate resource.
See also: AWS API Documentation
Request Syntax
response = client.generate_client_certificate(
description='string'
)
| Parameters: | description (string) – The description of the ClientCertificate . |
|---|---|
| Return type: | dict |
| Returns: | Response Syntax{
'clientCertificateId': 'string',
'description': 'string',
'pemEncodedCertificate': 'string',
'createdDate': datetime(2015, 1, 1),
'expirationDate': datetime(2015, 1, 1)
}
Response Structure
|
generate_presigned_url(ClientMethod, Params=None, ExpiresIn=3600, HttpMethod=None)¶Generate a presigned url given a client, its method, and arguments
| Parameters: |
|
|---|---|
| Returns: | The presigned url |
get_account()¶Gets information about the current Account resource.
See also: AWS API Documentation
Request Syntax
response = client.get_account()
| Return type: | dict |
|---|---|
| Returns: | Response Syntax{
'cloudwatchRoleArn': 'string',
'throttleSettings': {
'burstLimit': 123,
'rateLimit': 123.0
},
'features': [
'string',
],
'apiKeyVersion': 'string'
}
Response Structure
|
get_api_key(**kwargs)¶Gets information about the current ApiKey resource.
See also: AWS API Documentation
Request Syntax
response = client.get_api_key(
apiKey='string',
includeValue=True|False
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'id': 'string',
'value': 'string',
'name': 'string',
'customerId': 'string',
'description': 'string',
'enabled': True|False,
'createdDate': datetime(2015, 1, 1),
'lastUpdatedDate': datetime(2015, 1, 1),
'stageKeys': [
'string',
]
}
Response Structure
|
get_api_keys(**kwargs)¶Gets information about the current ApiKeys resource.
See also: AWS API Documentation
Request Syntax
response = client.get_api_keys(
position='string',
limit=123,
nameQuery='string',
customerId='string',
includeValues=True|False
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'warnings': [
'string',
],
'position': 'string',
'items': [
{
'id': 'string',
'value': 'string',
'name': 'string',
'customerId': 'string',
'description': 'string',
'enabled': True|False,
'createdDate': datetime(2015, 1, 1),
'lastUpdatedDate': datetime(2015, 1, 1),
'stageKeys': [
'string',
]
},
]
}
Response Structure
|
Describe an existing Authorizer resource.
See also: AWS API Documentation
Request Syntax
response = client.get_authorizer(
restApiId='string',
authorizerId='string'
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'id': 'string',
'name': 'string',
'type': 'TOKEN'|'COGNITO_USER_POOLS',
'providerARNs': [
'string',
],
'authType': 'string',
'authorizerUri': 'string',
'authorizerCredentials': 'string',
'identitySource': 'string',
'identityValidationExpression': 'string',
'authorizerResultTtlInSeconds': 123
}
Response Structure
|
Describe an existing Authorizers resource.
See also: AWS API Documentation
Request Syntax
response = client.get_authorizers(
restApiId='string',
position='string',
limit=123
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'position': 'string',
'items': [
{
'id': 'string',
'name': 'string',
'type': 'TOKEN'|'COGNITO_USER_POOLS',
'providerARNs': [
'string',
],
'authType': 'string',
'authorizerUri': 'string',
'authorizerCredentials': 'string',
'identitySource': 'string',
'identityValidationExpression': 'string',
'authorizerResultTtlInSeconds': 123
},
]
}
Response Structure
|
get_base_path_mapping(**kwargs)¶Describe a BasePathMapping resource.
See also: AWS API Documentation
Request Syntax
response = client.get_base_path_mapping(
domainName='string',
basePath='string'
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'basePath': 'string',
'restApiId': 'string',
'stage': 'string'
}
Response Structure
|
get_base_path_mappings(**kwargs)¶Represents a collection of BasePathMapping resources.
See also: AWS API Documentation
Request Syntax
response = client.get_base_path_mappings(
domainName='string',
position='string',
limit=123
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'position': 'string',
'items': [
{
'basePath': 'string',
'restApiId': 'string',
'stage': 'string'
},
]
}
Response Structure
|
get_client_certificate(**kwargs)¶Gets information about the current ClientCertificate resource.
See also: AWS API Documentation
Request Syntax
response = client.get_client_certificate(
clientCertificateId='string'
)
| Parameters: | clientCertificateId (string) – [REQUIRED] The identifier of the ClientCertificate resource to be described. |
|---|---|
| Return type: | dict |
| Returns: | Response Syntax{
'clientCertificateId': 'string',
'description': 'string',
'pemEncodedCertificate': 'string',
'createdDate': datetime(2015, 1, 1),
'expirationDate': datetime(2015, 1, 1)
}
Response Structure
|
get_client_certificates(**kwargs)¶Gets a collection of ClientCertificate resources.
See also: AWS API Documentation
Request Syntax
response = client.get_client_certificates(
position='string',
limit=123
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'position': 'string',
'items': [
{
'clientCertificateId': 'string',
'description': 'string',
'pemEncodedCertificate': 'string',
'createdDate': datetime(2015, 1, 1),
'expirationDate': datetime(2015, 1, 1)
},
]
}
Response Structure
|
get_deployment(**kwargs)¶Gets information about a Deployment resource.
See also: AWS API Documentation
Request Syntax
response = client.get_deployment(
restApiId='string',
deploymentId='string',
embed=[
'string',
]
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'id': 'string',
'description': 'string',
'createdDate': datetime(2015, 1, 1),
'apiSummary': {
'string': {
'string': {
'authorizationType': 'string',
'apiKeyRequired': True|False
}
}
}
}
Response Structure
|
get_deployments(**kwargs)¶Gets information about a Deployments collection.
See also: AWS API Documentation
Request Syntax
response = client.get_deployments(
restApiId='string',
position='string',
limit=123
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'position': 'string',
'items': [
{
'id': 'string',
'description': 'string',
'createdDate': datetime(2015, 1, 1),
'apiSummary': {
'string': {
'string': {
'authorizationType': 'string',
'apiKeyRequired': True|False
}
}
}
},
]
}
Response Structure
|
get_documentation_part(**kwargs)¶See also: AWS API Documentation
Request Syntax
response = client.get_documentation_part(
restApiId='string',
documentationPartId='string'
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'id': 'string',
'location': {
'type': 'API'|'AUTHORIZER'|'MODEL'|'RESOURCE'|'METHOD'|'PATH_PARAMETER'|'QUERY_PARAMETER'|'REQUEST_HEADER'|'REQUEST_BODY'|'RESPONSE'|'RESPONSE_HEADER'|'RESPONSE_BODY',
'path': 'string',
'method': 'string',
'statusCode': 'string',
'name': 'string'
},
'properties': 'string'
}
Response Structure
|
get_documentation_parts(**kwargs)¶See also: AWS API Documentation
Request Syntax
response = client.get_documentation_parts(
restApiId='string',
type='API'|'AUTHORIZER'|'MODEL'|'RESOURCE'|'METHOD'|'PATH_PARAMETER'|'QUERY_PARAMETER'|'REQUEST_HEADER'|'REQUEST_BODY'|'RESPONSE'|'RESPONSE_HEADER'|'RESPONSE_BODY',
nameQuery='string',
path='string',
position='string',
limit=123
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'position': 'string',
'items': [
{
'id': 'string',
'location': {
'type': 'API'|'AUTHORIZER'|'MODEL'|'RESOURCE'|'METHOD'|'PATH_PARAMETER'|'QUERY_PARAMETER'|'REQUEST_HEADER'|'REQUEST_BODY'|'RESPONSE'|'RESPONSE_HEADER'|'RESPONSE_BODY',
'path': 'string',
'method': 'string',
'statusCode': 'string',
'name': 'string'
},
'properties': 'string'
},
]
}
Response Structure
|
get_documentation_version(**kwargs)¶See also: AWS API Documentation
Request Syntax
response = client.get_documentation_version(
restApiId='string',
documentationVersion='string'
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'version': 'string',
'createdDate': datetime(2015, 1, 1),
'description': 'string'
}
Response Structure
|
get_documentation_versions(**kwargs)¶See also: AWS API Documentation
Request Syntax
response = client.get_documentation_versions(
restApiId='string',
position='string',
limit=123
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'position': 'string',
'items': [
{
'version': 'string',
'createdDate': datetime(2015, 1, 1),
'description': 'string'
},
]
}
Response Structure
|
get_domain_name(**kwargs)¶Represents a domain name that is contained in a simpler, more intuitive URL that can be called.
See also: AWS API Documentation
Request Syntax
response = client.get_domain_name(
domainName='string'
)
| Parameters: | domainName (string) – [REQUIRED] The name of the DomainName resource. |
|---|---|
| Return type: | dict |
| Returns: | Response Syntax{
'domainName': 'string',
'certificateName': 'string',
'certificateArn': 'string',
'certificateUploadDate': datetime(2015, 1, 1),
'distributionDomainName': 'string'
}
Response Structure
|
get_domain_names(**kwargs)¶Represents a collection of DomainName resources.
See also: AWS API Documentation
Request Syntax
response = client.get_domain_names(
position='string',
limit=123
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'position': 'string',
'items': [
{
'domainName': 'string',
'certificateName': 'string',
'certificateArn': 'string',
'certificateUploadDate': datetime(2015, 1, 1),
'distributionDomainName': 'string'
},
]
}
Response Structure
|
get_export(**kwargs)¶Exports a deployed version of a RestApi in a specified format.
See also: AWS API Documentation
Request Syntax
response = client.get_export(
restApiId='string',
stageName='string',
exportType='string',
parameters={
'string': 'string'
},
accepts='string'
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'contentType': 'string',
'contentDisposition': 'string',
'body': StreamingBody()
}
Response Structure
|
get_gateway_response(**kwargs)¶Gets a GatewayResponse of a specified response type on the given RestApi .
See also: AWS API Documentation
Request Syntax
response = client.get_gateway_response(
restApiId='string',
responseType='DEFAULT_4XX'|'DEFAULT_5XX'|'RESOURCE_NOT_FOUND'|'UNAUTHORIZED'|'INVALID_API_KEY'|'ACCESS_DENIED'|'AUTHORIZER_FAILURE'|'AUTHORIZER_CONFIGURATION_ERROR'|'INVALID_SIGNATURE'|'EXPIRED_TOKEN'|'MISSING_AUTHENTICATION_TOKEN'|'INTEGRATION_FAILURE'|'INTEGRATION_TIMEOUT'|'API_CONFIGURATION_ERROR'|'UNSUPPORTED_MEDIA_TYPE'|'BAD_REQUEST_PARAMETERS'|'BAD_REQUEST_BODY'|'REQUEST_TOO_LARGE'|'THROTTLED'|'QUOTA_EXCEEDED'
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'responseType': 'DEFAULT_4XX'|'DEFAULT_5XX'|'RESOURCE_NOT_FOUND'|'UNAUTHORIZED'|'INVALID_API_KEY'|'ACCESS_DENIED'|'AUTHORIZER_FAILURE'|'AUTHORIZER_CONFIGURATION_ERROR'|'INVALID_SIGNATURE'|'EXPIRED_TOKEN'|'MISSING_AUTHENTICATION_TOKEN'|'INTEGRATION_FAILURE'|'INTEGRATION_TIMEOUT'|'API_CONFIGURATION_ERROR'|'UNSUPPORTED_MEDIA_TYPE'|'BAD_REQUEST_PARAMETERS'|'BAD_REQUEST_BODY'|'REQUEST_TOO_LARGE'|'THROTTLED'|'QUOTA_EXCEEDED',
'statusCode': 'string',
'responseParameters': {
'string': 'string'
},
'responseTemplates': {
'string': 'string'
},
'defaultResponse': True|False
}
Response Structure
|
get_gateway_responses(**kwargs)¶Gets the GatewayResponses collection on the given RestApi . If an API developer has not added any definitions for gateway responses, the result will be the Amazon API Gateway-generated default GatewayResponses collection for the supported response types.
See also: AWS API Documentation
Request Syntax
response = client.get_gateway_responses(
restApiId='string',
position='string',
limit=123
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'position': 'string',
'items': [
{
'responseType': 'DEFAULT_4XX'|'DEFAULT_5XX'|'RESOURCE_NOT_FOUND'|'UNAUTHORIZED'|'INVALID_API_KEY'|'ACCESS_DENIED'|'AUTHORIZER_FAILURE'|'AUTHORIZER_CONFIGURATION_ERROR'|'INVALID_SIGNATURE'|'EXPIRED_TOKEN'|'MISSING_AUTHENTICATION_TOKEN'|'INTEGRATION_FAILURE'|'INTEGRATION_TIMEOUT'|'API_CONFIGURATION_ERROR'|'UNSUPPORTED_MEDIA_TYPE'|'BAD_REQUEST_PARAMETERS'|'BAD_REQUEST_BODY'|'REQUEST_TOO_LARGE'|'THROTTLED'|'QUOTA_EXCEEDED',
'statusCode': 'string',
'responseParameters': {
'string': 'string'
},
'responseTemplates': {
'string': 'string'
},
'defaultResponse': True|False
},
]
}
Response Structure
|
get_integration(**kwargs)¶Represents a get integration.
See also: AWS API Documentation
Request Syntax
response = client.get_integration(
restApiId='string',
resourceId='string',
httpMethod='string'
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'type': 'HTTP'|'AWS'|'MOCK'|'HTTP_PROXY'|'AWS_PROXY',
'httpMethod': 'string',
'uri': 'string',
'credentials': 'string',
'requestParameters': {
'string': 'string'
},
'requestTemplates': {
'string': 'string'
},
'passthroughBehavior': 'string',
'contentHandling': 'CONVERT_TO_BINARY'|'CONVERT_TO_TEXT',
'cacheNamespace': 'string',
'cacheKeyParameters': [
'string',
],
'integrationResponses': {
'string': {
'statusCode': 'string',
'selectionPattern': 'string',
'responseParameters': {
'string': 'string'
},
'responseTemplates': {
'string': 'string'
},
'contentHandling': 'CONVERT_TO_BINARY'|'CONVERT_TO_TEXT'
}
}
}
Response Structure
|
get_integration_response(**kwargs)¶Represents a get integration response.
See also: AWS API Documentation
Request Syntax
response = client.get_integration_response(
restApiId='string',
resourceId='string',
httpMethod='string',
statusCode='string'
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'statusCode': 'string',
'selectionPattern': 'string',
'responseParameters': {
'string': 'string'
},
'responseTemplates': {
'string': 'string'
},
'contentHandling': 'CONVERT_TO_BINARY'|'CONVERT_TO_TEXT'
}
Response Structure
|
get_method(**kwargs)¶Describe an existing Method resource.
See also: AWS API Documentation
Request Syntax
response = client.get_method(
restApiId='string',
resourceId='string',
httpMethod='string'
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'httpMethod': 'string',
'authorizationType': 'string',
'authorizerId': 'string',
'apiKeyRequired': True|False,
'requestValidatorId': 'string',
'operationName': 'string',
'requestParameters': {
'string': True|False
},
'requestModels': {
'string': 'string'
},
'methodResponses': {
'string': {
'statusCode': 'string',
'responseParameters': {
'string': True|False
},
'responseModels': {
'string': 'string'
}
}
},
'methodIntegration': {
'type': 'HTTP'|'AWS'|'MOCK'|'HTTP_PROXY'|'AWS_PROXY',
'httpMethod': 'string',
'uri': 'string',
'credentials': 'string',
'requestParameters': {
'string': 'string'
},
'requestTemplates': {
'string': 'string'
},
'passthroughBehavior': 'string',
'contentHandling': 'CONVERT_TO_BINARY'|'CONVERT_TO_TEXT',
'cacheNamespace': 'string',
'cacheKeyParameters': [
'string',
],
'integrationResponses': {
'string': {
'statusCode': 'string',
'selectionPattern': 'string',
'responseParameters': {
'string': 'string'
},
'responseTemplates': {
'string': 'string'
},
'contentHandling': 'CONVERT_TO_BINARY'|'CONVERT_TO_TEXT'
}
}
}
}
Response Structure
|
get_method_response(**kwargs)¶Describes a MethodResponse resource.
See also: AWS API Documentation
Request Syntax
response = client.get_method_response(
restApiId='string',
resourceId='string',
httpMethod='string',
statusCode='string'
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'statusCode': 'string',
'responseParameters': {
'string': True|False
},
'responseModels': {
'string': 'string'
}
}
Response Structure
|
get_model(**kwargs)¶Describes an existing model defined for a RestApi resource.
See also: AWS API Documentation
Request Syntax
response = client.get_model(
restApiId='string',
modelName='string',
flatten=True|False
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'id': 'string',
'name': 'string',
'description': 'string',
'schema': 'string',
'contentType': 'string'
}
Response Structure
|
get_model_template(**kwargs)¶Generates a sample mapping template that can be used to transform a payload into the structure of a model.
See also: AWS API Documentation
Request Syntax
response = client.get_model_template(
restApiId='string',
modelName='string'
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'value': 'string'
}
Response Structure
|
get_models(**kwargs)¶Describes existing Models defined for a RestApi resource.
See also: AWS API Documentation
Request Syntax
response = client.get_models(
restApiId='string',
position='string',
limit=123
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'position': 'string',
'items': [
{
'id': 'string',
'name': 'string',
'description': 'string',
'schema': 'string',
'contentType': 'string'
},
]
}
Response Structure
|
get_paginator(operation_name)¶Create a paginator for an operation.
| Parameters: | operation_name (string) – The operation name. This is the same name
as the method name on the client. For example, if the
method name is create_foo, and you’d normally invoke the
operation as client.create_foo(**kwargs), if the
create_foo operation can be paginated, you can use the
call client.get_paginator("create_foo"). |
|---|---|
| Raises: | OperationNotPageableError – Raised if the operation is not
pageable. You can use the client.can_paginate method to
check if an operation is pageable. |
| Return type: | L{botocore.paginate.Paginator} |
| Returns: | A paginator object. |
get_request_validator(**kwargs)¶Gets a RequestValidator of a given RestApi .
See also: AWS API Documentation
Request Syntax
response = client.get_request_validator(
restApiId='string',
requestValidatorId='string'
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'id': 'string',
'name': 'string',
'validateRequestBody': True|False,
'validateRequestParameters': True|False
}
Response Structure
|
get_request_validators(**kwargs)¶Gets the RequestValidators collection of a given RestApi .
See also: AWS API Documentation
Request Syntax
response = client.get_request_validators(
restApiId='string',
position='string',
limit=123
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'position': 'string',
'items': [
{
'id': 'string',
'name': 'string',
'validateRequestBody': True|False,
'validateRequestParameters': True|False
},
]
}
Response Structure
|
get_resource(**kwargs)¶Lists information about a resource.
See also: AWS API Documentation
Request Syntax
response = client.get_resource(
restApiId='string',
resourceId='string',
embed=[
'string',
]
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'id': 'string',
'parentId': 'string',
'pathPart': 'string',
'path': 'string',
'resourceMethods': {
'string': {
'httpMethod': 'string',
'authorizationType': 'string',
'authorizerId': 'string',
'apiKeyRequired': True|False,
'requestValidatorId': 'string',
'operationName': 'string',
'requestParameters': {
'string': True|False
},
'requestModels': {
'string': 'string'
},
'methodResponses': {
'string': {
'statusCode': 'string',
'responseParameters': {
'string': True|False
},
'responseModels': {
'string': 'string'
}
}
},
'methodIntegration': {
'type': 'HTTP'|'AWS'|'MOCK'|'HTTP_PROXY'|'AWS_PROXY',
'httpMethod': 'string',
'uri': 'string',
'credentials': 'string',
'requestParameters': {
'string': 'string'
},
'requestTemplates': {
'string': 'string'
},
'passthroughBehavior': 'string',
'contentHandling': 'CONVERT_TO_BINARY'|'CONVERT_TO_TEXT',
'cacheNamespace': 'string',
'cacheKeyParameters': [
'string',
],
'integrationResponses': {
'string': {
'statusCode': 'string',
'selectionPattern': 'string',
'responseParameters': {
'string': 'string'
},
'responseTemplates': {
'string': 'string'
},
'contentHandling': 'CONVERT_TO_BINARY'|'CONVERT_TO_TEXT'
}
}
}
}
}
}
Response Structure
|
get_resources(**kwargs)¶Lists information about a collection of Resource resources.
See also: AWS API Documentation
Request Syntax
response = client.get_resources(
restApiId='string',
position='string',
limit=123,
embed=[
'string',
]
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'position': 'string',
'items': [
{
'id': 'string',
'parentId': 'string',
'pathPart': 'string',
'path': 'string',
'resourceMethods': {
'string': {
'httpMethod': 'string',
'authorizationType': 'string',
'authorizerId': 'string',
'apiKeyRequired': True|False,
'requestValidatorId': 'string',
'operationName': 'string',
'requestParameters': {
'string': True|False
},
'requestModels': {
'string': 'string'
},
'methodResponses': {
'string': {
'statusCode': 'string',
'responseParameters': {
'string': True|False
},
'responseModels': {
'string': 'string'
}
}
},
'methodIntegration': {
'type': 'HTTP'|'AWS'|'MOCK'|'HTTP_PROXY'|'AWS_PROXY',
'httpMethod': 'string',
'uri': 'string',
'credentials': 'string',
'requestParameters': {
'string': 'string'
},
'requestTemplates': {
'string': 'string'
},
'passthroughBehavior': 'string',
'contentHandling': 'CONVERT_TO_BINARY'|'CONVERT_TO_TEXT',
'cacheNamespace': 'string',
'cacheKeyParameters': [
'string',
],
'integrationResponses': {
'string': {
'statusCode': 'string',
'selectionPattern': 'string',
'responseParameters': {
'string': 'string'
},
'responseTemplates': {
'string': 'string'
},
'contentHandling': 'CONVERT_TO_BINARY'|'CONVERT_TO_TEXT'
}
}
}
}
}
},
]
}
Response Structure
|
get_rest_api(**kwargs)¶Lists the RestApi resource in the collection.
See also: AWS API Documentation
Request Syntax
response = client.get_rest_api(
restApiId='string'
)
| Parameters: | restApiId (string) – [REQUIRED] The identifier of the RestApi resource. |
|---|---|
| Return type: | dict |
| Returns: | Response Syntax{
'id': 'string',
'name': 'string',
'description': 'string',
'createdDate': datetime(2015, 1, 1),
'version': 'string',
'warnings': [
'string',
],
'binaryMediaTypes': [
'string',
]
}
Response Structure
|
get_rest_apis(**kwargs)¶Lists the RestApis resources for your collection.
See also: AWS API Documentation
Request Syntax
response = client.get_rest_apis(
position='string',
limit=123
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'position': 'string',
'items': [
{
'id': 'string',
'name': 'string',
'description': 'string',
'createdDate': datetime(2015, 1, 1),
'version': 'string',
'warnings': [
'string',
],
'binaryMediaTypes': [
'string',
]
},
]
}
Response Structure
|
get_sdk(**kwargs)¶Generates a client SDK for a RestApi and Stage .
See also: AWS API Documentation
Request Syntax
response = client.get_sdk(
restApiId='string',
stageName='string',
sdkType='string',
parameters={
'string': 'string'
}
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'contentType': 'string',
'contentDisposition': 'string',
'body': StreamingBody()
}
Response Structure
|
get_sdk_type(**kwargs)¶See also: AWS API Documentation
Request Syntax
response = client.get_sdk_type(
id='string'
)
| Parameters: | id (string) – [REQUIRED] The identifier of the queried SdkType instance. |
|---|---|
| Return type: | dict |
| Returns: | Response Syntax{
'id': 'string',
'friendlyName': 'string',
'description': 'string',
'configurationProperties': [
{
'name': 'string',
'friendlyName': 'string',
'description': 'string',
'required': True|False,
'defaultValue': 'string'
},
]
}
Response Structure
|
get_sdk_types(**kwargs)¶See also: AWS API Documentation
Request Syntax
response = client.get_sdk_types(
position='string',
limit=123
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'position': 'string',
'items': [
{
'id': 'string',
'friendlyName': 'string',
'description': 'string',
'configurationProperties': [
{
'name': 'string',
'friendlyName': 'string',
'description': 'string',
'required': True|False,
'defaultValue': 'string'
},
]
},
]
}
Response Structure
|
get_stage(**kwargs)¶Gets information about a Stage resource.
See also: AWS API Documentation
Request Syntax
response = client.get_stage(
restApiId='string',
stageName='string'
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'deploymentId': 'string',
'clientCertificateId': 'string',
'stageName': 'string',
'description': 'string',
'cacheClusterEnabled': True|False,
'cacheClusterSize': '0.5'|'1.6'|'6.1'|'13.5'|'28.4'|'58.2'|'118'|'237',
'cacheClusterStatus': 'CREATE_IN_PROGRESS'|'AVAILABLE'|'DELETE_IN_PROGRESS'|'NOT_AVAILABLE'|'FLUSH_IN_PROGRESS',
'methodSettings': {
'string': {
'metricsEnabled': True|False,
'loggingLevel': 'string',
'dataTraceEnabled': True|False,
'throttlingBurstLimit': 123,
'throttlingRateLimit': 123.0,
'cachingEnabled': True|False,
'cacheTtlInSeconds': 123,
'cacheDataEncrypted': True|False,
'requireAuthorizationForCacheControl': True|False,
'unauthorizedCacheControlHeaderStrategy': 'FAIL_WITH_403'|'SUCCEED_WITH_RESPONSE_HEADER'|'SUCCEED_WITHOUT_RESPONSE_HEADER'
}
},
'variables': {
'string': 'string'
},
'documentationVersion': 'string',
'createdDate': datetime(2015, 1, 1),
'lastUpdatedDate': datetime(2015, 1, 1)
}
Response Structure
|
get_stages(**kwargs)¶Gets information about one or more Stage resources.
See also: AWS API Documentation
Request Syntax
response = client.get_stages(
restApiId='string',
deploymentId='string'
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'item': [
{
'deploymentId': 'string',
'clientCertificateId': 'string',
'stageName': 'string',
'description': 'string',
'cacheClusterEnabled': True|False,
'cacheClusterSize': '0.5'|'1.6'|'6.1'|'13.5'|'28.4'|'58.2'|'118'|'237',
'cacheClusterStatus': 'CREATE_IN_PROGRESS'|'AVAILABLE'|'DELETE_IN_PROGRESS'|'NOT_AVAILABLE'|'FLUSH_IN_PROGRESS',
'methodSettings': {
'string': {
'metricsEnabled': True|False,
'loggingLevel': 'string',
'dataTraceEnabled': True|False,
'throttlingBurstLimit': 123,
'throttlingRateLimit': 123.0,
'cachingEnabled': True|False,
'cacheTtlInSeconds': 123,
'cacheDataEncrypted': True|False,
'requireAuthorizationForCacheControl': True|False,
'unauthorizedCacheControlHeaderStrategy': 'FAIL_WITH_403'|'SUCCEED_WITH_RESPONSE_HEADER'|'SUCCEED_WITHOUT_RESPONSE_HEADER'
}
},
'variables': {
'string': 'string'
},
'documentationVersion': 'string',
'createdDate': datetime(2015, 1, 1),
'lastUpdatedDate': datetime(2015, 1, 1)
},
]
}
Response Structure
|
get_usage(**kwargs)¶Gets the usage data of a usage plan in a specified time interval.
See also: AWS API Documentation
Request Syntax
response = client.get_usage(
usagePlanId='string',
keyId='string',
startDate='string',
endDate='string',
position='string',
limit=123
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'usagePlanId': 'string',
'startDate': 'string',
'endDate': 'string',
'position': 'string',
'items': {
'string': [
[
123,
],
]
}
}
Response Structure
|
get_usage_plan(**kwargs)¶Gets a usage plan of a given plan identifier.
See also: AWS API Documentation
Request Syntax
response = client.get_usage_plan(
usagePlanId='string'
)
| Parameters: | usagePlanId (string) – [REQUIRED] The identifier of the UsagePlan resource to be retrieved. |
|---|---|
| Return type: | dict |
| Returns: | Response Syntax{
'id': 'string',
'name': 'string',
'description': 'string',
'apiStages': [
{
'apiId': 'string',
'stage': 'string'
},
],
'throttle': {
'burstLimit': 123,
'rateLimit': 123.0
},
'quota': {
'limit': 123,
'offset': 123,
'period': 'DAY'|'WEEK'|'MONTH'
},
'productCode': 'string'
}
Response Structure
|
get_usage_plan_key(**kwargs)¶Gets a usage plan key of a given key identifier.
See also: AWS API Documentation
Request Syntax
response = client.get_usage_plan_key(
usagePlanId='string',
keyId='string'
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'id': 'string',
'type': 'string',
'value': 'string',
'name': 'string'
}
Response Structure
|
get_usage_plan_keys(**kwargs)¶Gets all the usage plan keys representing the API keys added to a specified usage plan.
See also: AWS API Documentation
Request Syntax
response = client.get_usage_plan_keys(
usagePlanId='string',
position='string',
limit=123,
nameQuery='string'
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'position': 'string',
'items': [
{
'id': 'string',
'type': 'string',
'value': 'string',
'name': 'string'
},
]
}
Response Structure
|
get_usage_plans(**kwargs)¶Gets all the usage plans of the caller’s account.
See also: AWS API Documentation
Request Syntax
response = client.get_usage_plans(
position='string',
keyId='string',
limit=123
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'position': 'string',
'items': [
{
'id': 'string',
'name': 'string',
'description': 'string',
'apiStages': [
{
'apiId': 'string',
'stage': 'string'
},
],
'throttle': {
'burstLimit': 123,
'rateLimit': 123.0
},
'quota': {
'limit': 123,
'offset': 123,
'period': 'DAY'|'WEEK'|'MONTH'
},
'productCode': 'string'
},
]
}
Response Structure
|
get_waiter(waiter_name)¶import_api_keys(**kwargs)¶Import API keys from an external source, such as a CSV-formatted file.
See also: AWS API Documentation
Request Syntax
response = client.import_api_keys(
body=b'bytes'|file,
format='csv',
failOnWarnings=True|False
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'ids': [
'string',
],
'warnings': [
'string',
]
}
Response Structure
|
import_documentation_parts(**kwargs)¶See also: AWS API Documentation
Request Syntax
response = client.import_documentation_parts(
restApiId='string',
mode='merge'|'overwrite',
failOnWarnings=True|False,
body=b'bytes'|file
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'ids': [
'string',
],
'warnings': [
'string',
]
}
Response Structure
|
import_rest_api(**kwargs)¶A feature of the Amazon API Gateway control service for creating a new API from an external API definition file.
See also: AWS API Documentation
Request Syntax
response = client.import_rest_api(
failOnWarnings=True|False,
parameters={
'string': 'string'
},
body=b'bytes'|file
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'id': 'string',
'name': 'string',
'description': 'string',
'createdDate': datetime(2015, 1, 1),
'version': 'string',
'warnings': [
'string',
],
'binaryMediaTypes': [
'string',
]
}
Response Structure
|
put_gateway_response(**kwargs)¶Creates a customization of a GatewayResponse of a specified response type and status code on the given RestApi .
See also: AWS API Documentation
Request Syntax
response = client.put_gateway_response(
restApiId='string',
responseType='DEFAULT_4XX'|'DEFAULT_5XX'|'RESOURCE_NOT_FOUND'|'UNAUTHORIZED'|'INVALID_API_KEY'|'ACCESS_DENIED'|'AUTHORIZER_FAILURE'|'AUTHORIZER_CONFIGURATION_ERROR'|'INVALID_SIGNATURE'|'EXPIRED_TOKEN'|'MISSING_AUTHENTICATION_TOKEN'|'INTEGRATION_FAILURE'|'INTEGRATION_TIMEOUT'|'API_CONFIGURATION_ERROR'|'UNSUPPORTED_MEDIA_TYPE'|'BAD_REQUEST_PARAMETERS'|'BAD_REQUEST_BODY'|'REQUEST_TOO_LARGE'|'THROTTLED'|'QUOTA_EXCEEDED',
statusCode='string',
responseParameters={
'string': 'string'
},
responseTemplates={
'string': 'string'
}
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'responseType': 'DEFAULT_4XX'|'DEFAULT_5XX'|'RESOURCE_NOT_FOUND'|'UNAUTHORIZED'|'INVALID_API_KEY'|'ACCESS_DENIED'|'AUTHORIZER_FAILURE'|'AUTHORIZER_CONFIGURATION_ERROR'|'INVALID_SIGNATURE'|'EXPIRED_TOKEN'|'MISSING_AUTHENTICATION_TOKEN'|'INTEGRATION_FAILURE'|'INTEGRATION_TIMEOUT'|'API_CONFIGURATION_ERROR'|'UNSUPPORTED_MEDIA_TYPE'|'BAD_REQUEST_PARAMETERS'|'BAD_REQUEST_BODY'|'REQUEST_TOO_LARGE'|'THROTTLED'|'QUOTA_EXCEEDED',
'statusCode': 'string',
'responseParameters': {
'string': 'string'
},
'responseTemplates': {
'string': 'string'
},
'defaultResponse': True|False
}
Response Structure
|
put_integration(**kwargs)¶Sets up a method’s integration.
See also: AWS API Documentation
Request Syntax
response = client.put_integration(
restApiId='string',
resourceId='string',
httpMethod='string',
type='HTTP'|'AWS'|'MOCK'|'HTTP_PROXY'|'AWS_PROXY',
integrationHttpMethod='string',
uri='string',
credentials='string',
requestParameters={
'string': 'string'
},
requestTemplates={
'string': 'string'
},
passthroughBehavior='string',
cacheNamespace='string',
cacheKeyParameters=[
'string',
],
contentHandling='CONVERT_TO_BINARY'|'CONVERT_TO_TEXT'
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'type': 'HTTP'|'AWS'|'MOCK'|'HTTP_PROXY'|'AWS_PROXY',
'httpMethod': 'string',
'uri': 'string',
'credentials': 'string',
'requestParameters': {
'string': 'string'
},
'requestTemplates': {
'string': 'string'
},
'passthroughBehavior': 'string',
'contentHandling': 'CONVERT_TO_BINARY'|'CONVERT_TO_TEXT',
'cacheNamespace': 'string',
'cacheKeyParameters': [
'string',
],
'integrationResponses': {
'string': {
'statusCode': 'string',
'selectionPattern': 'string',
'responseParameters': {
'string': 'string'
},
'responseTemplates': {
'string': 'string'
},
'contentHandling': 'CONVERT_TO_BINARY'|'CONVERT_TO_TEXT'
}
}
}
Response Structure
|
put_integration_response(**kwargs)¶Represents a put integration.
See also: AWS API Documentation
Request Syntax
response = client.put_integration_response(
restApiId='string',
resourceId='string',
httpMethod='string',
statusCode='string',
selectionPattern='string',
responseParameters={
'string': 'string'
},
responseTemplates={
'string': 'string'
},
contentHandling='CONVERT_TO_BINARY'|'CONVERT_TO_TEXT'
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'statusCode': 'string',
'selectionPattern': 'string',
'responseParameters': {
'string': 'string'
},
'responseTemplates': {
'string': 'string'
},
'contentHandling': 'CONVERT_TO_BINARY'|'CONVERT_TO_TEXT'
}
Response Structure
|
put_method(**kwargs)¶Add a method to an existing Resource resource.
See also: AWS API Documentation
Request Syntax
response = client.put_method(
restApiId='string',
resourceId='string',
httpMethod='string',
authorizationType='string',
authorizerId='string',
apiKeyRequired=True|False,
operationName='string',
requestParameters={
'string': True|False
},
requestModels={
'string': 'string'
},
requestValidatorId='string'
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'httpMethod': 'string',
'authorizationType': 'string',
'authorizerId': 'string',
'apiKeyRequired': True|False,
'requestValidatorId': 'string',
'operationName': 'string',
'requestParameters': {
'string': True|False
},
'requestModels': {
'string': 'string'
},
'methodResponses': {
'string': {
'statusCode': 'string',
'responseParameters': {
'string': True|False
},
'responseModels': {
'string': 'string'
}
}
},
'methodIntegration': {
'type': 'HTTP'|'AWS'|'MOCK'|'HTTP_PROXY'|'AWS_PROXY',
'httpMethod': 'string',
'uri': 'string',
'credentials': 'string',
'requestParameters': {
'string': 'string'
},
'requestTemplates': {
'string': 'string'
},
'passthroughBehavior': 'string',
'contentHandling': 'CONVERT_TO_BINARY'|'CONVERT_TO_TEXT',
'cacheNamespace': 'string',
'cacheKeyParameters': [
'string',
],
'integrationResponses': {
'string': {
'statusCode': 'string',
'selectionPattern': 'string',
'responseParameters': {
'string': 'string'
},
'responseTemplates': {
'string': 'string'
},
'contentHandling': 'CONVERT_TO_BINARY'|'CONVERT_TO_TEXT'
}
}
}
}
Response Structure
|
put_method_response(**kwargs)¶Adds a MethodResponse to an existing Method resource.
See also: AWS API Documentation
Request Syntax
response = client.put_method_response(
restApiId='string',
resourceId='string',
httpMethod='string',
statusCode='string',
responseParameters={
'string': True|False
},
responseModels={
'string': 'string'
}
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'statusCode': 'string',
'responseParameters': {
'string': True|False
},
'responseModels': {
'string': 'string'
}
}
Response Structure
|
put_rest_api(**kwargs)¶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.
See also: AWS API Documentation
Request Syntax
response = client.put_rest_api(
restApiId='string',
mode='merge'|'overwrite',
failOnWarnings=True|False,
parameters={
'string': 'string'
},
body=b'bytes'|file
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'id': 'string',
'name': 'string',
'description': 'string',
'createdDate': datetime(2015, 1, 1),
'version': 'string',
'warnings': [
'string',
],
'binaryMediaTypes': [
'string',
]
}
Response Structure
|
Simulate the execution of an Authorizer in your RestApi with headers, parameters, and an incoming request body.
See also: AWS API Documentation
Request Syntax
response = client.test_invoke_authorizer(
restApiId='string',
authorizerId='string',
headers={
'string': 'string'
},
pathWithQueryString='string',
body='string',
stageVariables={
'string': 'string'
},
additionalContext={
'string': 'string'
}
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'clientStatus': 123,
'log': 'string',
'latency': 123,
'principalId': 'string',
'policy': 'string',
'authorization': {
'string': [
'string',
]
},
'claims': {
'string': 'string'
}
}
Response Structure
|
test_invoke_method(**kwargs)¶Simulate the execution of a Method in your RestApi with headers, parameters, and an incoming request body.
See also: AWS API Documentation
Request Syntax
response = client.test_invoke_method(
restApiId='string',
resourceId='string',
httpMethod='string',
pathWithQueryString='string',
body='string',
headers={
'string': 'string'
},
clientCertificateId='string',
stageVariables={
'string': 'string'
}
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'status': 123,
'body': 'string',
'headers': {
'string': 'string'
},
'log': 'string',
'latency': 123
}
Response Structure
|
update_account(**kwargs)¶Changes information about the current Account resource.
See also: AWS API Documentation
Request Syntax
response = client.update_account(
patchOperations=[
{
'op': 'add'|'remove'|'replace'|'move'|'copy'|'test',
'path': 'string',
'value': 'string',
'from': 'string'
},
]
)
| Parameters: | patchOperations (list) – A list of update operations to be applied to the specified resource and in the order specified in this list.
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax{
'cloudwatchRoleArn': 'string',
'throttleSettings': {
'burstLimit': 123,
'rateLimit': 123.0
},
'features': [
'string',
],
'apiKeyVersion': 'string'
}
Response Structure
|
update_api_key(**kwargs)¶Changes information about an ApiKey resource.
See also: AWS API Documentation
Request Syntax
response = client.update_api_key(
apiKey='string',
patchOperations=[
{
'op': 'add'|'remove'|'replace'|'move'|'copy'|'test',
'path': 'string',
'value': 'string',
'from': 'string'
},
]
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'id': 'string',
'value': 'string',
'name': 'string',
'customerId': 'string',
'description': 'string',
'enabled': True|False,
'createdDate': datetime(2015, 1, 1),
'lastUpdatedDate': datetime(2015, 1, 1),
'stageKeys': [
'string',
]
}
Response Structure
|
Updates an existing Authorizer resource.
See also: AWS API Documentation
Request Syntax
response = client.update_authorizer(
restApiId='string',
authorizerId='string',
patchOperations=[
{
'op': 'add'|'remove'|'replace'|'move'|'copy'|'test',
'path': 'string',
'value': 'string',
'from': 'string'
},
]
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'id': 'string',
'name': 'string',
'type': 'TOKEN'|'COGNITO_USER_POOLS',
'providerARNs': [
'string',
],
'authType': 'string',
'authorizerUri': 'string',
'authorizerCredentials': 'string',
'identitySource': 'string',
'identityValidationExpression': 'string',
'authorizerResultTtlInSeconds': 123
}
Response Structure
|
update_base_path_mapping(**kwargs)¶Changes information about the BasePathMapping resource.
See also: AWS API Documentation
Request Syntax
response = client.update_base_path_mapping(
domainName='string',
basePath='string',
patchOperations=[
{
'op': 'add'|'remove'|'replace'|'move'|'copy'|'test',
'path': 'string',
'value': 'string',
'from': 'string'
},
]
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'basePath': 'string',
'restApiId': 'string',
'stage': 'string'
}
Response Structure
|
update_client_certificate(**kwargs)¶Changes information about an ClientCertificate resource.
See also: AWS API Documentation
Request Syntax
response = client.update_client_certificate(
clientCertificateId='string',
patchOperations=[
{
'op': 'add'|'remove'|'replace'|'move'|'copy'|'test',
'path': 'string',
'value': 'string',
'from': 'string'
},
]
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'clientCertificateId': 'string',
'description': 'string',
'pemEncodedCertificate': 'string',
'createdDate': datetime(2015, 1, 1),
'expirationDate': datetime(2015, 1, 1)
}
Response Structure
|
update_deployment(**kwargs)¶Changes information about a Deployment resource.
See also: AWS API Documentation
Request Syntax
response = client.update_deployment(
restApiId='string',
deploymentId='string',
patchOperations=[
{
'op': 'add'|'remove'|'replace'|'move'|'copy'|'test',
'path': 'string',
'value': 'string',
'from': 'string'
},
]
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'id': 'string',
'description': 'string',
'createdDate': datetime(2015, 1, 1),
'apiSummary': {
'string': {
'string': {
'authorizationType': 'string',
'apiKeyRequired': True|False
}
}
}
}
Response Structure
|
update_documentation_part(**kwargs)¶See also: AWS API Documentation
Request Syntax
response = client.update_documentation_part(
restApiId='string',
documentationPartId='string',
patchOperations=[
{
'op': 'add'|'remove'|'replace'|'move'|'copy'|'test',
'path': 'string',
'value': 'string',
'from': 'string'
},
]
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'id': 'string',
'location': {
'type': 'API'|'AUTHORIZER'|'MODEL'|'RESOURCE'|'METHOD'|'PATH_PARAMETER'|'QUERY_PARAMETER'|'REQUEST_HEADER'|'REQUEST_BODY'|'RESPONSE'|'RESPONSE_HEADER'|'RESPONSE_BODY',
'path': 'string',
'method': 'string',
'statusCode': 'string',
'name': 'string'
},
'properties': 'string'
}
Response Structure
|
update_documentation_version(**kwargs)¶See also: AWS API Documentation
Request Syntax
response = client.update_documentation_version(
restApiId='string',
documentationVersion='string',
patchOperations=[
{
'op': 'add'|'remove'|'replace'|'move'|'copy'|'test',
'path': 'string',
'value': 'string',
'from': 'string'
},
]
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'version': 'string',
'createdDate': datetime(2015, 1, 1),
'description': 'string'
}
Response Structure
|
update_domain_name(**kwargs)¶Changes information about the DomainName resource.
See also: AWS API Documentation
Request Syntax
response = client.update_domain_name(
domainName='string',
patchOperations=[
{
'op': 'add'|'remove'|'replace'|'move'|'copy'|'test',
'path': 'string',
'value': 'string',
'from': 'string'
},
]
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'domainName': 'string',
'certificateName': 'string',
'certificateArn': 'string',
'certificateUploadDate': datetime(2015, 1, 1),
'distributionDomainName': 'string'
}
Response Structure
|
update_gateway_response(**kwargs)¶Updates a GatewayResponse of a specified response type on the given RestApi .
See also: AWS API Documentation
Request Syntax
response = client.update_gateway_response(
restApiId='string',
responseType='DEFAULT_4XX'|'DEFAULT_5XX'|'RESOURCE_NOT_FOUND'|'UNAUTHORIZED'|'INVALID_API_KEY'|'ACCESS_DENIED'|'AUTHORIZER_FAILURE'|'AUTHORIZER_CONFIGURATION_ERROR'|'INVALID_SIGNATURE'|'EXPIRED_TOKEN'|'MISSING_AUTHENTICATION_TOKEN'|'INTEGRATION_FAILURE'|'INTEGRATION_TIMEOUT'|'API_CONFIGURATION_ERROR'|'UNSUPPORTED_MEDIA_TYPE'|'BAD_REQUEST_PARAMETERS'|'BAD_REQUEST_BODY'|'REQUEST_TOO_LARGE'|'THROTTLED'|'QUOTA_EXCEEDED',
patchOperations=[
{
'op': 'add'|'remove'|'replace'|'move'|'copy'|'test',
'path': 'string',
'value': 'string',
'from': 'string'
},
]
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'responseType': 'DEFAULT_4XX'|'DEFAULT_5XX'|'RESOURCE_NOT_FOUND'|'UNAUTHORIZED'|'INVALID_API_KEY'|'ACCESS_DENIED'|'AUTHORIZER_FAILURE'|'AUTHORIZER_CONFIGURATION_ERROR'|'INVALID_SIGNATURE'|'EXPIRED_TOKEN'|'MISSING_AUTHENTICATION_TOKEN'|'INTEGRATION_FAILURE'|'INTEGRATION_TIMEOUT'|'API_CONFIGURATION_ERROR'|'UNSUPPORTED_MEDIA_TYPE'|'BAD_REQUEST_PARAMETERS'|'BAD_REQUEST_BODY'|'REQUEST_TOO_LARGE'|'THROTTLED'|'QUOTA_EXCEEDED',
'statusCode': 'string',
'responseParameters': {
'string': 'string'
},
'responseTemplates': {
'string': 'string'
},
'defaultResponse': True|False
}
Response Structure
|
update_integration(**kwargs)¶Represents an update integration.
See also: AWS API Documentation
Request Syntax
response = client.update_integration(
restApiId='string',
resourceId='string',
httpMethod='string',
patchOperations=[
{
'op': 'add'|'remove'|'replace'|'move'|'copy'|'test',
'path': 'string',
'value': 'string',
'from': 'string'
},
]
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'type': 'HTTP'|'AWS'|'MOCK'|'HTTP_PROXY'|'AWS_PROXY',
'httpMethod': 'string',
'uri': 'string',
'credentials': 'string',
'requestParameters': {
'string': 'string'
},
'requestTemplates': {
'string': 'string'
},
'passthroughBehavior': 'string',
'contentHandling': 'CONVERT_TO_BINARY'|'CONVERT_TO_TEXT',
'cacheNamespace': 'string',
'cacheKeyParameters': [
'string',
],
'integrationResponses': {
'string': {
'statusCode': 'string',
'selectionPattern': 'string',
'responseParameters': {
'string': 'string'
},
'responseTemplates': {
'string': 'string'
},
'contentHandling': 'CONVERT_TO_BINARY'|'CONVERT_TO_TEXT'
}
}
}
Response Structure
|
update_integration_response(**kwargs)¶Represents an update integration response.
See also: AWS API Documentation
Request Syntax
response = client.update_integration_response(
restApiId='string',
resourceId='string',
httpMethod='string',
statusCode='string',
patchOperations=[
{
'op': 'add'|'remove'|'replace'|'move'|'copy'|'test',
'path': 'string',
'value': 'string',
'from': 'string'
},
]
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'statusCode': 'string',
'selectionPattern': 'string',
'responseParameters': {
'string': 'string'
},
'responseTemplates': {
'string': 'string'
},
'contentHandling': 'CONVERT_TO_BINARY'|'CONVERT_TO_TEXT'
}
Response Structure
|
update_method(**kwargs)¶Updates an existing Method resource.
See also: AWS API Documentation
Request Syntax
response = client.update_method(
restApiId='string',
resourceId='string',
httpMethod='string',
patchOperations=[
{
'op': 'add'|'remove'|'replace'|'move'|'copy'|'test',
'path': 'string',
'value': 'string',
'from': 'string'
},
]
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'httpMethod': 'string',
'authorizationType': 'string',
'authorizerId': 'string',
'apiKeyRequired': True|False,
'requestValidatorId': 'string',
'operationName': 'string',
'requestParameters': {
'string': True|False
},
'requestModels': {
'string': 'string'
},
'methodResponses': {
'string': {
'statusCode': 'string',
'responseParameters': {
'string': True|False
},
'responseModels': {
'string': 'string'
}
}
},
'methodIntegration': {
'type': 'HTTP'|'AWS'|'MOCK'|'HTTP_PROXY'|'AWS_PROXY',
'httpMethod': 'string',
'uri': 'string',
'credentials': 'string',
'requestParameters': {
'string': 'string'
},
'requestTemplates': {
'string': 'string'
},
'passthroughBehavior': 'string',
'contentHandling': 'CONVERT_TO_BINARY'|'CONVERT_TO_TEXT',
'cacheNamespace': 'string',
'cacheKeyParameters': [
'string',
],
'integrationResponses': {
'string': {
'statusCode': 'string',
'selectionPattern': 'string',
'responseParameters': {
'string': 'string'
},
'responseTemplates': {
'string': 'string'
},
'contentHandling': 'CONVERT_TO_BINARY'|'CONVERT_TO_TEXT'
}
}
}
}
Response Structure
|
update_method_response(**kwargs)¶Updates an existing MethodResponse resource.
See also: AWS API Documentation
Request Syntax
response = client.update_method_response(
restApiId='string',
resourceId='string',
httpMethod='string',
statusCode='string',
patchOperations=[
{
'op': 'add'|'remove'|'replace'|'move'|'copy'|'test',
'path': 'string',
'value': 'string',
'from': 'string'
},
]
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'statusCode': 'string',
'responseParameters': {
'string': True|False
},
'responseModels': {
'string': 'string'
}
}
Response Structure
|
update_model(**kwargs)¶Changes information about a model.
See also: AWS API Documentation
Request Syntax
response = client.update_model(
restApiId='string',
modelName='string',
patchOperations=[
{
'op': 'add'|'remove'|'replace'|'move'|'copy'|'test',
'path': 'string',
'value': 'string',
'from': 'string'
},
]
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'id': 'string',
'name': 'string',
'description': 'string',
'schema': 'string',
'contentType': 'string'
}
Response Structure
|
update_request_validator(**kwargs)¶Updates a RequestValidator of a given RestApi .
See also: AWS API Documentation
Request Syntax
response = client.update_request_validator(
restApiId='string',
requestValidatorId='string',
patchOperations=[
{
'op': 'add'|'remove'|'replace'|'move'|'copy'|'test',
'path': 'string',
'value': 'string',
'from': 'string'
},
]
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'id': 'string',
'name': 'string',
'validateRequestBody': True|False,
'validateRequestParameters': True|False
}
Response Structure
|
update_resource(**kwargs)¶Changes information about a Resource resource.
See also: AWS API Documentation
Request Syntax
response = client.update_resource(
restApiId='string',
resourceId='string',
patchOperations=[
{
'op': 'add'|'remove'|'replace'|'move'|'copy'|'test',
'path': 'string',
'value': 'string',
'from': 'string'
},
]
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'id': 'string',
'parentId': 'string',
'pathPart': 'string',
'path': 'string',
'resourceMethods': {
'string': {
'httpMethod': 'string',
'authorizationType': 'string',
'authorizerId': 'string',
'apiKeyRequired': True|False,
'requestValidatorId': 'string',
'operationName': 'string',
'requestParameters': {
'string': True|False
},
'requestModels': {
'string': 'string'
},
'methodResponses': {
'string': {
'statusCode': 'string',
'responseParameters': {
'string': True|False
},
'responseModels': {
'string': 'string'
}
}
},
'methodIntegration': {
'type': 'HTTP'|'AWS'|'MOCK'|'HTTP_PROXY'|'AWS_PROXY',
'httpMethod': 'string',
'uri': 'string',
'credentials': 'string',
'requestParameters': {
'string': 'string'
},
'requestTemplates': {
'string': 'string'
},
'passthroughBehavior': 'string',
'contentHandling': 'CONVERT_TO_BINARY'|'CONVERT_TO_TEXT',
'cacheNamespace': 'string',
'cacheKeyParameters': [
'string',
],
'integrationResponses': {
'string': {
'statusCode': 'string',
'selectionPattern': 'string',
'responseParameters': {
'string': 'string'
},
'responseTemplates': {
'string': 'string'
},
'contentHandling': 'CONVERT_TO_BINARY'|'CONVERT_TO_TEXT'
}
}
}
}
}
}
Response Structure
|
update_rest_api(**kwargs)¶Changes information about the specified API.
See also: AWS API Documentation
Request Syntax
response = client.update_rest_api(
restApiId='string',
patchOperations=[
{
'op': 'add'|'remove'|'replace'|'move'|'copy'|'test',
'path': 'string',
'value': 'string',
'from': 'string'
},
]
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'id': 'string',
'name': 'string',
'description': 'string',
'createdDate': datetime(2015, 1, 1),
'version': 'string',
'warnings': [
'string',
],
'binaryMediaTypes': [
'string',
]
}
Response Structure
|
update_stage(**kwargs)¶Changes information about a Stage resource.
See also: AWS API Documentation
Request Syntax
response = client.update_stage(
restApiId='string',
stageName='string',
patchOperations=[
{
'op': 'add'|'remove'|'replace'|'move'|'copy'|'test',
'path': 'string',
'value': 'string',
'from': 'string'
},
]
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'deploymentId': 'string',
'clientCertificateId': 'string',
'stageName': 'string',
'description': 'string',
'cacheClusterEnabled': True|False,
'cacheClusterSize': '0.5'|'1.6'|'6.1'|'13.5'|'28.4'|'58.2'|'118'|'237',
'cacheClusterStatus': 'CREATE_IN_PROGRESS'|'AVAILABLE'|'DELETE_IN_PROGRESS'|'NOT_AVAILABLE'|'FLUSH_IN_PROGRESS',
'methodSettings': {
'string': {
'metricsEnabled': True|False,
'loggingLevel': 'string',
'dataTraceEnabled': True|False,
'throttlingBurstLimit': 123,
'throttlingRateLimit': 123.0,
'cachingEnabled': True|False,
'cacheTtlInSeconds': 123,
'cacheDataEncrypted': True|False,
'requireAuthorizationForCacheControl': True|False,
'unauthorizedCacheControlHeaderStrategy': 'FAIL_WITH_403'|'SUCCEED_WITH_RESPONSE_HEADER'|'SUCCEED_WITHOUT_RESPONSE_HEADER'
}
},
'variables': {
'string': 'string'
},
'documentationVersion': 'string',
'createdDate': datetime(2015, 1, 1),
'lastUpdatedDate': datetime(2015, 1, 1)
}
Response Structure
|
update_usage(**kwargs)¶Grants a temporary extension to the remaining quota of a usage plan associated with a specified API key.
See also: AWS API Documentation
Request Syntax
response = client.update_usage(
usagePlanId='string',
keyId='string',
patchOperations=[
{
'op': 'add'|'remove'|'replace'|'move'|'copy'|'test',
'path': 'string',
'value': 'string',
'from': 'string'
},
]
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'usagePlanId': 'string',
'startDate': 'string',
'endDate': 'string',
'position': 'string',
'items': {
'string': [
[
123,
],
]
}
}
Response Structure
|
update_usage_plan(**kwargs)¶Updates a usage plan of a given plan Id.
See also: AWS API Documentation
Request Syntax
response = client.update_usage_plan(
usagePlanId='string',
patchOperations=[
{
'op': 'add'|'remove'|'replace'|'move'|'copy'|'test',
'path': 'string',
'value': 'string',
'from': 'string'
},
]
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'id': 'string',
'name': 'string',
'description': 'string',
'apiStages': [
{
'apiId': 'string',
'stage': 'string'
},
],
'throttle': {
'burstLimit': 123,
'rateLimit': 123.0
},
'quota': {
'limit': 123,
'offset': 123,
'period': 'DAY'|'WEEK'|'MONTH'
},
'productCode': 'string'
}
Response Structure
|
The available paginators are:
APIGateway.Paginator.GetApiKeysAPIGateway.Paginator.GetBasePathMappingsAPIGateway.Paginator.GetClientCertificatesAPIGateway.Paginator.GetDeploymentsAPIGateway.Paginator.GetDomainNamesAPIGateway.Paginator.GetModelsAPIGateway.Paginator.GetResourcesAPIGateway.Paginator.GetRestApisAPIGateway.Paginator.GetUsageAPIGateway.Paginator.GetUsagePlanKeysAPIGateway.Paginator.GetUsagePlansAPIGateway.Paginator.GetApiKeys¶paginator = client.get_paginator('get_api_keys')
paginate(**kwargs)¶Creates an iterator that will paginate through responses from APIGateway.Client.get_api_keys().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
nameQuery='string',
customerId='string',
includeValues=True|False,
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'warnings': [
'string',
],
'items': [
{
'id': 'string',
'value': 'string',
'name': 'string',
'customerId': 'string',
'description': 'string',
'enabled': True|False,
'createdDate': datetime(2015, 1, 1),
'lastUpdatedDate': datetime(2015, 1, 1),
'stageKeys': [
'string',
]
},
],
'NextToken': 'string'
}
Response Structure
|
APIGateway.Paginator.GetBasePathMappings¶paginator = client.get_paginator('get_base_path_mappings')
paginate(**kwargs)¶Creates an iterator that will paginate through responses from APIGateway.Client.get_base_path_mappings().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
domainName='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'items': [
{
'basePath': 'string',
'restApiId': 'string',
'stage': 'string'
},
],
'NextToken': 'string'
}
Response Structure
|
APIGateway.Paginator.GetClientCertificates¶paginator = client.get_paginator('get_client_certificates')
paginate(**kwargs)¶Creates an iterator that will paginate through responses from APIGateway.Client.get_client_certificates().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
| Parameters: | PaginationConfig (dict) – A dictionary that provides parameters to control pagination.
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax{
'items': [
{
'clientCertificateId': 'string',
'description': 'string',
'pemEncodedCertificate': 'string',
'createdDate': datetime(2015, 1, 1),
'expirationDate': datetime(2015, 1, 1)
},
],
'NextToken': 'string'
}
Response Structure
|
APIGateway.Paginator.GetDeployments¶paginator = client.get_paginator('get_deployments')
paginate(**kwargs)¶Creates an iterator that will paginate through responses from APIGateway.Client.get_deployments().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
restApiId='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'items': [
{
'id': 'string',
'description': 'string',
'createdDate': datetime(2015, 1, 1),
'apiSummary': {
'string': {
'string': {
'authorizationType': 'string',
'apiKeyRequired': True|False
}
}
}
},
],
'NextToken': 'string'
}
Response Structure
|
APIGateway.Paginator.GetDomainNames¶paginator = client.get_paginator('get_domain_names')
paginate(**kwargs)¶Creates an iterator that will paginate through responses from APIGateway.Client.get_domain_names().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
| Parameters: | PaginationConfig (dict) – A dictionary that provides parameters to control pagination.
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax{
'items': [
{
'domainName': 'string',
'certificateName': 'string',
'certificateArn': 'string',
'certificateUploadDate': datetime(2015, 1, 1),
'distributionDomainName': 'string'
},
],
'NextToken': 'string'
}
Response Structure
|
APIGateway.Paginator.GetModels¶paginator = client.get_paginator('get_models')
paginate(**kwargs)¶Creates an iterator that will paginate through responses from APIGateway.Client.get_models().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
restApiId='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'items': [
{
'id': 'string',
'name': 'string',
'description': 'string',
'schema': 'string',
'contentType': 'string'
},
],
'NextToken': 'string'
}
Response Structure
|
APIGateway.Paginator.GetResources¶paginator = client.get_paginator('get_resources')
paginate(**kwargs)¶Creates an iterator that will paginate through responses from APIGateway.Client.get_resources().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
restApiId='string',
embed=[
'string',
],
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'items': [
{
'id': 'string',
'parentId': 'string',
'pathPart': 'string',
'path': 'string',
'resourceMethods': {
'string': {
'httpMethod': 'string',
'authorizationType': 'string',
'authorizerId': 'string',
'apiKeyRequired': True|False,
'requestValidatorId': 'string',
'operationName': 'string',
'requestParameters': {
'string': True|False
},
'requestModels': {
'string': 'string'
},
'methodResponses': {
'string': {
'statusCode': 'string',
'responseParameters': {
'string': True|False
},
'responseModels': {
'string': 'string'
}
}
},
'methodIntegration': {
'type': 'HTTP'|'AWS'|'MOCK'|'HTTP_PROXY'|'AWS_PROXY',
'httpMethod': 'string',
'uri': 'string',
'credentials': 'string',
'requestParameters': {
'string': 'string'
},
'requestTemplates': {
'string': 'string'
},
'passthroughBehavior': 'string',
'contentHandling': 'CONVERT_TO_BINARY'|'CONVERT_TO_TEXT',
'cacheNamespace': 'string',
'cacheKeyParameters': [
'string',
],
'integrationResponses': {
'string': {
'statusCode': 'string',
'selectionPattern': 'string',
'responseParameters': {
'string': 'string'
},
'responseTemplates': {
'string': 'string'
},
'contentHandling': 'CONVERT_TO_BINARY'|'CONVERT_TO_TEXT'
}
}
}
}
}
},
],
'NextToken': 'string'
}
Response Structure
|
APIGateway.Paginator.GetRestApis¶paginator = client.get_paginator('get_rest_apis')
paginate(**kwargs)¶Creates an iterator that will paginate through responses from APIGateway.Client.get_rest_apis().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
| Parameters: | PaginationConfig (dict) – A dictionary that provides parameters to control pagination.
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax{
'items': [
{
'id': 'string',
'name': 'string',
'description': 'string',
'createdDate': datetime(2015, 1, 1),
'version': 'string',
'warnings': [
'string',
],
'binaryMediaTypes': [
'string',
]
},
],
'NextToken': 'string'
}
Response Structure
|
APIGateway.Paginator.GetUsage¶paginator = client.get_paginator('get_usage')
paginate(**kwargs)¶Creates an iterator that will paginate through responses from APIGateway.Client.get_usage().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
usagePlanId='string',
keyId='string',
startDate='string',
endDate='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'usagePlanId': 'string',
'startDate': 'string',
'endDate': 'string',
'items': {
'string': [
[
123,
],
]
},
'NextToken': 'string'
}
Response Structure
|
APIGateway.Paginator.GetUsagePlanKeys¶paginator = client.get_paginator('get_usage_plan_keys')
paginate(**kwargs)¶Creates an iterator that will paginate through responses from APIGateway.Client.get_usage_plan_keys().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
usagePlanId='string',
nameQuery='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'items': [
{
'id': 'string',
'type': 'string',
'value': 'string',
'name': 'string'
},
],
'NextToken': 'string'
}
Response Structure
|
APIGateway.Paginator.GetUsagePlans¶paginator = client.get_paginator('get_usage_plans')
paginate(**kwargs)¶Creates an iterator that will paginate through responses from APIGateway.Client.get_usage_plans().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
keyId='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
| Parameters: |
|
|---|---|
| Return type: | dict |
| Returns: | Response Syntax {
'items': [
{
'id': 'string',
'name': 'string',
'description': 'string',
'apiStages': [
{
'apiId': 'string',
'stage': 'string'
},
],
'throttle': {
'burstLimit': 123,
'rateLimit': 123.0
},
'quota': {
'limit': 123,
'offset': 123,
'period': 'DAY'|'WEEK'|'MONTH'
},
'productCode': 'string'
},
],
'NextToken': 'string'
}
Response Structure
|