salt.modules.boto_apigateway module

Connection module for Amazon APIGateway

configuration:

This module accepts explicit Lambda credentials but can also utilize IAM roles assigned to the instance trough Instance Profiles. Dynamic credentials are then automatically obtained from AWS API and no further configuration is necessary. More Information available at:

http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html

If IAM roles are not used you need to specify them either in a pillar or in the minion's config file:

apigateway.keyid: GKTADJGHEIQSXMKKRBJ08H
apigateway.key: askdjghsdfjkghWupUjasdflkdfklgjsdfjajkghs

A region may also be specified in the configuration:

apigateway.region: us-west-2

If a region is not specified, the default is us-east-1.

It's also possible to specify key, keyid and region via a profile, either as a passed in dict, or as a string to pull from pillars or minion config:

myprofile:
    keyid: GKTADJGHEIQSXMKKRBJ08H
    key: askdjghsdfjkghWupUjasdflkdfklgjsdfjajkghs
    region: us-west-2

Changed in version 2015.8.0: All methods now return a dictionary. Create and delete methods return:

created: true

or

created: false
error:
  message: error message

Request methods (e.g., describe_apigateway) return:

apigateway:
  - {...}
  - {...}

or

error:
  message: error message
depends:boto3
salt.modules.boto_apigateway.activate_api_deployment(restApiId, stageName, deploymentId, region=None, key=None, keyid=None, profile=None)

Activates previously deployed deployment for a given stage

CLI Example:

salt myminion boto_apigateway.activate_api_deployent restApiId stagename deploymentId
salt.modules.boto_apigateway.api_exists(name, description=None, region=None, key=None, keyid=None, profile=None)

Check to see if the given Rest API Name and optionlly description exists.

CLI Example:

salt myminion boto_apigateway.exists myapi_name
salt.modules.boto_apigateway.api_model_exists(restApiId, modelName, region=None, key=None, keyid=None, profile=None)

Check to see if the given modelName exists in the given restApiId

CLI Example:

salt myminion boto_apigateway.api_model_exists restApiId modelName
salt.modules.boto_apigateway.associate_api_key_stagekeys(apiKey, stagekeyslist, region=None, key=None, keyid=None, profile=None)

associate the given stagekeyslist to the given apiKey.

CLI Example:

salt.modules.boto_apigateway.create_api(name, description, cloneFrom=None, region=None, key=None, keyid=None, profile=None)

Create a new REST API Service with the given name

Returns {created: True} if the rest api was created and returns {created: False} if the rest api was not created.

CLI Example:

salt myminion boto_apigateway.create_api myapi_name api_description
salt.modules.boto_apigateway.create_api_deployment(restApiId, stageName, stageDescription='', description='', cacheClusterEnabled=False, cacheClusterSize='0.5', variables=None, region=None, key=None, keyid=None, profile=None)

Creates a new API deployment.

CLI Example:

salt myminion boto_apigateway.create_api_deployent restApiId stagename stageDescription=''              description='' cacheClusterEnabled=True|False cacheClusterSize=0.5 variables='{"name": "value"}'
salt.modules.boto_apigateway.create_api_integration(restApiId, resourcePath, httpMethod, integrationType, integrationHttpMethod, uri, credentials, requestParameters=None, requestTemplates=None, region=None, key=None, keyid=None, profile=None)

Creates an integration for a given method in a given API. If integrationType is MOCK, uri and credential parameters will be ignored.

uri is in the form of (substitute APIGATEWAY_REGION and LAMBDA_FUNC_ARN) "arn:aws:apigateway:APIGATEWAY_REGION:lambda:path/2015-03-31/functions/LAMBDA_FUNC_ARN/invocations"

credentials is in the form of an iam role name or role arn.

CLI Example:

salt myminion boto_apigateway.create_api_integration restApiId resourcePath httpMethod                              integrationType integrationHttpMethod uri credentials ['{}' ['{}']]
salt.modules.boto_apigateway.create_api_integration_response(restApiId, resourcePath, httpMethod, statusCode, selectionPattern, responseParameters=None, responseTemplates=None, region=None, key=None, keyid=None, profile=None)

Creates an integration response for a given method in a given API

CLI Example:

salt myminion boto_apigateway.create_api_integration_response restApiId resourcePath httpMethod                             statusCode selectionPattern ['{}' ['{}']]
salt.modules.boto_apigateway.create_api_key(name, description, enabled=True, stageKeys=None, region=None, key=None, keyid=None, profile=None)

Create an API key given name and description.

An optional enabled argument can be provided. If provided, the valid values are True|False. This argument defaults to True.

An optional stageKeys argument can be provided in the form of list of dictionary with 'restApiId' and 'stageName' as keys.

CLI Example:

salt myminion boto_apigateway.create_api_key name description

salt myminion boto_apigateway.create_api_key name description enabled=False

salt myminion boto_apigateway.create_api_key name description              stageKeys='[{"restApiId": "id", "stageName": "stagename"}]'
salt.modules.boto_apigateway.create_api_method(restApiId, resourcePath, httpMethod, authorizationType, apiKeyRequired=False, requestParameters=None, requestModels=None, region=None, key=None, keyid=None, profile=None)

Creates API method for a resource in the given API

CLI Example:

salt myminion boto_apigateway.create_api_method restApiId resourcePath, httpMethod, authorizationType,             apiKeyRequired=False, requestParameters='{"name", "value"}', requestModels='{"content-type", "value"}'
salt.modules.boto_apigateway.create_api_method_response(restApiId, resourcePath, httpMethod, statusCode, responseParameters=None, responseModels=None, region=None, key=None, keyid=None, profile=None)

Create API method response for a method on a given resource in the given API

CLI Example:

salt myminion boto_apigateway.create_api_method_response restApiId resourcePath httpMethod                statusCode responseParameters='{"name", "True|False"}' responseModels='{"content-type", "model"}'
salt.modules.boto_apigateway.create_api_model(restApiId, modelName, modelDescription, schema, contentType='application/json', region=None, key=None, keyid=None, profile=None)

Create a new model in a given API with a given schema, currently only contentType supported is 'application/json'

CLI Example:

salt myminion boto_apigateway.create_api_model restApiId modelName modelDescription '<schema>' 'content-type'
salt.modules.boto_apigateway.create_api_resources(restApiId, path, region=None, key=None, keyid=None, profile=None)

Given rest api id, and an absolute resource path, create all the resources and return all resources in the resourcepath, returns False on failure.

CLI Example:

salt myminion boto_apigateway.create_api_resources myapi_id resource_path
salt.modules.boto_apigateway.create_api_stage(restApiId, stageName, deploymentId, description='', cacheClusterEnabled=False, cacheClusterSize='0.5', variables=None, region=None, key=None, keyid=None, profile=None)

Creates a new API stage for a given restApiId and deploymentId.

CLI Example:

salt myminion boto_apigateway.create_api_stage restApiId stagename deploymentId             description='' cacheClusterEnabled=True|False cacheClusterSize='0.5' variables='{"name": "value"}'
salt.modules.boto_apigateway.delete_api(name, description=None, region=None, key=None, keyid=None, profile=None)

Delete all REST API Service with the given name and an optional API description

Returns {deleted: True, count: deleted_count} if apis were deleted, and returns {deleted: False} if error or not found.

CLI Example:

salt myminion boto_apigateway.delete_api myapi_name

salt myminion boto_apigateway.delete_api myapi_name description='api description'
salt.modules.boto_apigateway.delete_api_deployment(restApiId, deploymentId, region=None, key=None, keyid=None, profile=None)

Deletes API deployment for a given restApiId and deploymentID

CLI Example:

salt myminion boto_apigateway.delete_api_deployent restApiId deploymentId
salt.modules.boto_apigateway.delete_api_integration(restApiId, resourcePath, httpMethod, region=None, key=None, keyid=None, profile=None)

Deletes an integration for a given method in a given API

CLI Example:

salt myminion boto_apigateway.delete_api_integration restApiId resourcePath httpMethod
salt.modules.boto_apigateway.delete_api_integration_response(restApiId, resourcePath, httpMethod, statusCode, region=None, key=None, keyid=None, profile=None)

Deletes an integration response for a given method in a given API

CLI Example:

salt myminion boto_apigateway.delete_api_integration_response restApiId resourcePath httpMethod statusCode
salt.modules.boto_apigateway.delete_api_key(apiKey, region=None, key=None, keyid=None, profile=None)

Deletes a given apiKey

CLI Example:

salt.modules.boto_apigateway.delete_api_method(restApiId, resourcePath, httpMethod, region=None, key=None, keyid=None, profile=None)

Delete API method for a resource in the given API

CLI Example:

salt myminion boto_apigateway.delete_api_method restApiId resourcePath httpMethod
salt.modules.boto_apigateway.delete_api_method_response(restApiId, resourcePath, httpMethod, statusCode, region=None, key=None, keyid=None, profile=None)

Delete API method response for a resource in the given API

CLI Example:

salt myminion boto_apigateway.delete_api_method_response restApiId resourcePath httpMethod statusCode
salt.modules.boto_apigateway.delete_api_model(restApiId, modelName, region=None, key=None, keyid=None, profile=None)

Delete a model identified by name in a given API

CLI Example:

salt myminion boto_apigateway.delete_api_model restApiId modelName
salt.modules.boto_apigateway.delete_api_resources(restApiId, path, region=None, key=None, keyid=None, profile=None)

Given restApiId and an absolute resource path, delete the resources starting from the absoluate resource path. If resourcepath is the root resource '/', the function will return False. Returns False on failure.

CLI Example:

salt myminion boto_apigateway.delete_api_resources myapi_id, resource_path
salt.modules.boto_apigateway.delete_api_stage(restApiId, stageName, region=None, key=None, keyid=None, profile=None)

Deletes stage identified by stageName from API identified by restApiId

CLI Example:

salt myminion boto_apigateway.delete_api_stage restApiId stageName
salt.modules.boto_apigateway.describe_api_deployment(restApiId, deploymentId, region=None, key=None, keyid=None, profile=None)

Get API deployment for a given restApiId and deploymentId.

CLI Example:

salt myminion boto_apigateway.describe_api_deployent restApiId deploymentId
salt.modules.boto_apigateway.describe_api_deployments(restApiId, region=None, key=None, keyid=None, profile=None)

Gets information about the defined API Deployments. Return list of api deployments.

CLI Example:

salt myminion boto_apigateway.describe_api_deployments restApiId
salt.modules.boto_apigateway.describe_api_integration(restApiId, resourcePath, httpMethod, region=None, key=None, keyid=None, profile=None)

Get an integration for a given method in a given API

CLI Example:

salt myminion boto_apigateway.describe_api_integration restApiId resourcePath httpMethod
salt.modules.boto_apigateway.describe_api_integration_response(restApiId, resourcePath, httpMethod, statusCode, region=None, key=None, keyid=None, profile=None)

Get an integration response for a given method in a given API

CLI Example:

salt myminion boto_apigateway.describe_api_integration_response restApiId resourcePath httpMethod statusCode
salt.modules.boto_apigateway.describe_api_key(apiKey, region=None, key=None, keyid=None, profile=None)

Gets info about the given api key

CLI Example:

salt myminion boto_apigateway.describe_api_key apigw_api_key
salt.modules.boto_apigateway.describe_api_keys(region=None, key=None, keyid=None, profile=None)

Gets information about the defined API Keys. Return list of apiKeys.

CLI Example:

salt myminion boto_apigateway.describe_api_keys
salt.modules.boto_apigateway.describe_api_method(restApiId, resourcePath, httpMethod, region=None, key=None, keyid=None, profile=None)

Get API method for a resource in the given API

CLI Example:

salt myminion boto_apigateway.describe_api_method restApiId resourcePath httpMethod
salt.modules.boto_apigateway.describe_api_method_response(restApiId, resourcePath, httpMethod, statusCode, region=None, key=None, keyid=None, profile=None)

Get API method response for a resource in the given API

CLI Example:

salt myminion boto_apigateway.describe_api_method_response restApiId resourcePath httpMethod statusCode
salt.modules.boto_apigateway.describe_api_model(restApiId, modelName, flatten=True, region=None, key=None, keyid=None, profile=None)

Get a model by name for a given API

CLI Example:

salt myminion boto_apigateway.describe_api_model restApiId modelName [True]
salt.modules.boto_apigateway.describe_api_models(restApiId, region=None, key=None, keyid=None, profile=None)

Get all models for a given API

CLI Example:

salt myminion boto_apigateway.describe_api_models restApiId
salt.modules.boto_apigateway.describe_api_resource(restApiId, path, region=None, key=None, keyid=None, profile=None)

Given rest api id, and an absolute resource path, returns the resource id for the given path.

CLI Example:

salt myminion boto_apigateway.describe_api_resource myapi_id resource_path
salt.modules.boto_apigateway.describe_api_resource_method(restApiId, resourcePath, httpMethod, region=None, key=None, keyid=None, profile=None)

Given rest api id, resource path, and http method (must be one of DELETE, GET, HEAD, OPTIONS, PATCH, POST, PUT), return the method for the api/resource path if defined. Return False if method is not defined.

CLI Example:

salt myminion boto_apigateway.describe_api_resource_method myapi_id resource_path httpmethod
salt.modules.boto_apigateway.describe_api_resources(restApiId, region=None, key=None, keyid=None, profile=None)

Given rest api id, return all resources for this api.

CLI Example:

salt myminion boto_apigateway.describe_api_resources myapi_id
salt.modules.boto_apigateway.describe_api_stage(restApiId, stageName, region=None, key=None, keyid=None, profile=None)

Get API stage for a given apiID and stage name

CLI Example:

salt myminion boto_apigateway.describe_api_stage restApiId stageName
salt.modules.boto_apigateway.describe_api_stages(restApiId, deploymentId, region=None, key=None, keyid=None, profile=None)

Get all API stages for a given apiID and deploymentID

CLI Example:

salt myminion boto_apigateway.describe_api_stages restApiId deploymentId
salt.modules.boto_apigateway.describe_apis(name=None, description=None, region=None, key=None, keyid=None, profile=None)

Returns all rest apis in the defined region. If optional parameter name is included, returns all rest apis matching the name in the defined region.

CLI Example:

salt myminion boto_apigateway.describe_apis

salt myminion boto_apigateway.describe_apis name='api name'

salt myminion boto_apigateway.describe_apis name='api name' description='desc str'
salt.modules.boto_apigateway.disable_api_key(apiKey, region=None, key=None, keyid=None, profile=None)

disable the given apiKey.

CLI Example:

salt.modules.boto_apigateway.disassociate_api_key_stagekeys(apiKey, stagekeyslist, region=None, key=None, keyid=None, profile=None)

disassociate the given stagekeyslist to the given apiKey.

CLI Example:

salt.modules.boto_apigateway.enable_api_key(apiKey, region=None, key=None, keyid=None, profile=None)

enable the given apiKey.

CLI Example:

salt.modules.boto_apigateway.flush_api_stage_cache(restApiId, stageName, region=None, key=None, keyid=None, profile=None)

Flushes cache for the stage identified by stageName from API identified by restApiId

CLI Example:

salt myminion boto_apigateway.flush_api_stage_cache restApiId stageName
salt.modules.boto_apigateway.overwrite_api_stage_variables(restApiId, stageName, variables, region=None, key=None, keyid=None, profile=None)

Overwrite the stage variables for the given restApiId and stage name with the given variables, variables must be in the form of a dictionary. Overwrite will always remove all the existing stage variables associated with the given restApiId and stage name, follow by the adding of all the variables specified in the variables dictionary

CLI Example:

salt myminion boto_apigateway.overwrite_api_stage_variables restApiId stageName variables='{"name": "value"}'
salt.modules.boto_apigateway.update_api_key_description(apiKey, description, region=None, key=None, keyid=None, profile=None)

update the given apiKey with the given description.

CLI Example:

salt.modules.boto_apigateway.update_api_model_schema(restApiId, modelName, schema, region=None, key=None, keyid=None, profile=None)

update the schema (in python dictionary format) for the given model in the given restApiId

CLI Example: