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.

list_components

list_components(**kwargs)

List components with summary data. You can filter the result list by environment, service, or a single service instance.

For more information about components, see Proton components in the Proton User Guide .

See also: AWS API Documentation

Request Syntax

response = client.list_components(
    environmentName='string',
    maxResults=123,
    nextToken='string',
    serviceInstanceName='string',
    serviceName='string'
)
Parameters
  • environmentName (string) -- The name of an environment for result list filtering. Proton returns components associated with the environment or attached to service instances running in it.
  • maxResults (integer) -- The maximum number of components to list.
  • nextToken (string) -- A token that indicates the location of the next component in the array of components, after the list of components that was previously requested.
  • serviceInstanceName (string) -- The name of a service instance for result list filtering. Proton returns the component attached to the service instance, if any.
  • serviceName (string) -- The name of a service for result list filtering. Proton returns components attached to service instances of the service.
Return type

dict

Returns

Response Syntax

{
    'components': [
        {
            '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),
            'lastModifiedAt': datetime(2015, 1, 1),
            'name': 'string',
            'serviceInstanceName': 'string',
            'serviceName': 'string'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • components (list) --

      An array of components with summary data.

      • (dict) --

        Summary data of an Proton component resource.

        For more information about components, see Proton components in the Proton User Guide .

        • arn (string) --

          The Amazon Resource Name (ARN) of the component.

        • createdAt (datetime) --

          The time when the component was created.

        • deploymentStatus (string) --

          The component deployment status.

        • deploymentStatusMessage (string) --

          The message associated with the component deployment status.

        • environmentName (string) --

          The name of the Proton environment that this component is associated with.

        • lastDeploymentAttemptedAt (datetime) --

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

        • lastDeploymentSucceededAt (datetime) --

          The time when the component was last deployed successfully.

        • lastModifiedAt (datetime) --

          The time when the component was last modified.

        • name (string) --

          The name of the component.

        • serviceInstanceName (string) --

          The name of the service instance that this component is attached to. Provided when a component is attached to a service instance.

        • serviceName (string) --

          The name of the service that serviceInstanceName is associated with. Provided when a component is attached to a service instance.

    • nextToken (string) --

      A token that indicates the location of the next component in the array of components, after the current requested list of components.

Exceptions

  • Proton.Client.exceptions.ValidationException
  • Proton.Client.exceptions.AccessDeniedException
  • Proton.Client.exceptions.ThrottlingException
  • Proton.Client.exceptions.InternalServerException