Select your cookie preferences

We use cookies and similar tools to enhance your experience, provide our services, deliver relevant advertising, and make improvements. Approved third parties also use these tools to help us deliver advertising and provide certain site features.

get_deployments

get_deployments(**kwargs)

Gets the Deployments for an API.

See also: AWS API Documentation

Request Syntax

response = client.get_deployments(
    ApiId='string',
    MaxResults='string',
    NextToken='string'
)
Parameters
  • ApiId (string) --

    [REQUIRED]

    The API identifier.

  • MaxResults (string) -- The maximum number of elements to be returned for this resource.
  • NextToken (string) -- The next page of elements from this collection. Not valid for the last element of the collection.
Return type

dict

Returns

Response Syntax

{
    'Items': [
        {
            'AutoDeployed': True|False,
            'CreatedDate': datetime(2015, 1, 1),
            'DeploymentId': 'string',
            'DeploymentStatus': 'PENDING'|'FAILED'|'DEPLOYED',
            'DeploymentStatusMessage': 'string',
            'Description': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    Success

    • Items (list) --

      The elements from this collection.

      • (dict) --

        An immutable representation of an API that can be called by users. A Deployment must be associated with a Stage for it to be callable over the internet.

        • AutoDeployed (boolean) --

          Specifies whether a deployment was automatically released.

        • CreatedDate (datetime) --

          The date and time when the Deployment resource was created.

        • DeploymentId (string) --

          The identifier for the deployment.

        • DeploymentStatus (string) --

          The status of the deployment: PENDING, FAILED, or SUCCEEDED.

        • DeploymentStatusMessage (string) --

          May contain additional feedback on the status of an API deployment.

        • Description (string) --

          The description for the deployment.

    • NextToken (string) --

      The next page of elements from this collection. Not valid for the last element of the collection.

Exceptions

  • ApiGatewayV2.Client.exceptions.NotFoundException
  • ApiGatewayV2.Client.exceptions.TooManyRequestsException
  • ApiGatewayV2.Client.exceptions.BadRequestException