def get_deployments(restApiId=None, position=None, limit=None):
    """
    Gets information about a  Deployments collection.
    See also: AWS API Documentation
    
    
    :example: response = client.get_deployments(
        restApiId='string',
        position='string',
        limit=123
    )
    
    
    :type restApiId: string
    :param restApiId: [REQUIRED]
            The identifier of the RestApi resource for the collection of Deployment resources to get information about.
            

    :type position: string
    :param position: The current pagination position in the paged result set.

    :type limit: integer
    :param limit: The maximum number of returned results per page. The value is 25 by default and could be between 1 - 500.

    :rtype: dict
    :return: {
        'position': 'string',
        'items': [
            {
                'id': 'string',
                'description': 'string',
                'createdDate': datetime(2015, 1, 1),
                'apiSummary': {
                    'string': {
                        'string': {
                            'authorizationType': 'string',
                            'apiKeyRequired': True|False
                        }
                    }
                }
            },
        ]
    }
    
    
    """
    pass
