AWS Proton

{'filters': [{'key': 'name | deploymentStatus | templateName | serviceName | '
                     'deployedTemplateVersionStatus | environmentName | '
                     'lastDeploymentAttemptedAtBefore | '
                     'lastDeploymentAttemptedAtAfter | createdAtBefore | '
                     'createdAtAfter',
              'value': 'string'}],
 'sortBy': 'name | deploymentStatus | templateName | serviceName | '
           'environmentName | lastDeploymentAttemptedAt | createdAt',
 'sortOrder': 'ASCENDING | DESCENDING'}

List service instances with summary data. This action lists service instances of all services in the Amazon Web Services account.

See also: AWS API Documentation

Request Syntax

client.list_service_instances(
    filters=[
        {
            'key': 'name'|'deploymentStatus'|'templateName'|'serviceName'|'deployedTemplateVersionStatus'|'environmentName'|'lastDeploymentAttemptedAtBefore'|'lastDeploymentAttemptedAtAfter'|'createdAtBefore'|'createdAtAfter',
            'value': 'string'
        },
    ],
    maxResults=123,
    nextToken='string',
    serviceName='string',
    sortBy='name'|'deploymentStatus'|'templateName'|'serviceName'|'environmentName'|'lastDeploymentAttemptedAt'|'createdAt',
    sortOrder='ASCENDING'|'DESCENDING'
)

type filters:

list

param filters:

An array of filtering criteria that scope down the result list. By default, all service instances in the Amazon Web Services account are returned.

• (dict) --

  A filtering criterion to scope down the result list of the ListServiceInstances action.

  • key (string) --

    The name of a filtering criterion.

  • value (string) --

    A value to filter by.

    With the date/time keys ( *At{Before,After}), the value is a valid RFC 3339 string with no UTC offset and with an optional fractional precision (for example, 1985-04-12T23:20:50.52Z).

type maxResults:

integer

param maxResults:

The maximum number of service instances to list.

type nextToken:

string

param nextToken:

A token that indicates the location of the next service in the array of service instances, after the list of service instances that was previously requested.

type serviceName:

string

param serviceName:

The name of the service that the service instance belongs to.

type sortBy:

string

param sortBy:

The field that the result list is sorted by.

When you choose to sort by serviceName, service instances within each service are sorted by service instance name.

Default: serviceName

type sortOrder:

string

param sortOrder:

Result list sort order.

Default: ASCENDING

rtype:

dict

returns:

Response Syntax

{
    'nextToken': 'string',
    'serviceInstances': [
        {
            'arn': 'string',
            'createdAt': datetime(2015, 1, 1),
            'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED',
            'deploymentStatusMessage': 'string',
            'environmentName': 'string',
            'lastDeploymentAttemptedAt': datetime(2015, 1, 1),
            'lastDeploymentSucceededAt': datetime(2015, 1, 1),
            'name': 'string',
            'serviceName': 'string',
            'templateMajorVersion': 'string',
            'templateMinorVersion': 'string',
            'templateName': 'string'
        },
    ]
}

Response Structure

• (dict) --

  • nextToken (string) --

    A token that indicates the location of the next service instance in the array of service instances, after the current requested list of service instances.

  • serviceInstances (list) --

    An array of service instances with summary data.

    • (dict) --

      Summary data of an Proton service instance resource.

      • arn (string) --

        The Amazon Resource Name (ARN) of the service instance.

      • createdAt (datetime) --

        The time when the service instance was created.

      • deploymentStatus (string) --

        The service instance deployment status.

      • deploymentStatusMessage (string) --

        A service instance deployment status message.

      • environmentName (string) --

        The name of the environment that the service instance was deployed into.

      • lastDeploymentAttemptedAt (datetime) --

        The time when a deployment of the service was last attempted.

      • lastDeploymentSucceededAt (datetime) --

        The time when the service was last deployed successfully.

      • name (string) --

        The name of the service instance.

      • serviceName (string) --

        The name of the service that the service instance belongs to.

      • templateMajorVersion (string) --

        The service instance template major version.

      • templateMinorVersion (string) --

        The service instance template minor version.

      • templateName (string) --

        The name of the service template.