Proton / Client / get_service

get_service#

Proton.Client.get_service(**kwargs)#

Get detailed data for a service.

Request Syntax

response = client.get_service(
    name='string'
)

Parameters:

name (string) –

[REQUIRED]

The name of the service that you want to get the detailed data for.

Return type:

dict

Returns:

Response Syntax

{
    'service': {
        'arn': 'string',
        'branchName': 'string',
        'createdAt': datetime(2015, 1, 1),
        'description': 'string',
        'lastModifiedAt': datetime(2015, 1, 1),
        'name': 'string',
        'pipeline': {
            'arn': 'string',
            'createdAt': datetime(2015, 1, 1),
            'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED',
            'deploymentStatusMessage': 'string',
            'lastAttemptedDeploymentId': 'string',
            'lastDeploymentAttemptedAt': datetime(2015, 1, 1),
            'lastDeploymentSucceededAt': datetime(2015, 1, 1),
            'lastSucceededDeploymentId': 'string',
            'spec': 'string',
            'templateMajorVersion': 'string',
            'templateMinorVersion': 'string',
            'templateName': 'string'
        },
        'repositoryConnectionArn': 'string',
        'repositoryId': 'string',
        'spec': 'string',
        'status': 'CREATE_IN_PROGRESS'|'CREATE_FAILED_CLEANUP_IN_PROGRESS'|'CREATE_FAILED_CLEANUP_COMPLETE'|'CREATE_FAILED_CLEANUP_FAILED'|'CREATE_FAILED'|'ACTIVE'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'UPDATE_IN_PROGRESS'|'UPDATE_FAILED_CLEANUP_IN_PROGRESS'|'UPDATE_FAILED_CLEANUP_COMPLETE'|'UPDATE_FAILED_CLEANUP_FAILED'|'UPDATE_FAILED'|'UPDATE_COMPLETE_CLEANUP_FAILED',
        'statusMessage': 'string',
        'templateName': 'string'
    }
}

Response Structure

(dict) –
- service (dict) –
  
  The detailed data of the requested service.
  - arn (string) –
    
    The Amazon Resource Name (ARN) of the service.
  - branchName (string) –
    
    The name of the code repository branch that holds the code that’s deployed in Proton.
  - createdAt (datetime) –
    
    The time when the service was created.
  - description (string) –
    
    A description of the service.
  - lastModifiedAt (datetime) –
    
    The time when the service was last modified.
  - name (string) –
    
    The name of the service.
  - pipeline (dict) –
    
    The service pipeline detail data.
    - arn (string) –
      
      The Amazon Resource Name (ARN) of the service pipeline.
    - createdAt (datetime) –
      
      The time when the service pipeline was created.
    - deploymentStatus (string) –
      
      The deployment status of the service pipeline.
    - deploymentStatusMessage (string) –
      
      A service pipeline deployment status message.
    - lastAttemptedDeploymentId (string) –
      
      The ID of the last attempted deployment of this service pipeline.
    - lastDeploymentAttemptedAt (datetime) –
      
      The time when a deployment of the service pipeline was last attempted.
    - lastDeploymentSucceededAt (datetime) –
      
      The time when the service pipeline was last deployed successfully.
    - lastSucceededDeploymentId (string) –
      
      The ID of the last successful deployment of this service pipeline.
    - spec (string) –
      
      The service spec that was used to create the service pipeline.
    - templateMajorVersion (string) –
      
      The major version of the service template that was used to create the service pipeline.
    - templateMinorVersion (string) –
      
      The minor version of the service template that was used to create the service pipeline.
    - templateName (string) –
      
      The name of the service template that was used to create the service pipeline.
  - repositoryConnectionArn (string) –
    
    The Amazon Resource Name (ARN) of the repository connection. For more information, see Setting up an AWS CodeStar connection in the Proton User Guide.
  - repositoryId (string) –
    
    The ID of the source code repository.
  - spec (string) –
    
    The formatted specification that defines the service.
  - status (string) –
    
    The status of the service.
  - statusMessage (string) –
    
    A service status message.
  - templateName (string) –
    
    The name of the service template.

Exceptions

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