2022/11/16 - AWS Proton - 1 updated api methods
Changes Add support for sorting and filtering in ListServiceInstances
{'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' )
list
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 ).
integer
The maximum number of service instances to list.
string
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.
string
The name of the service that the service instance belongs to.
string
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
string
Result list sort order.
Default: ASCENDING
dict
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.