Proton / Client / get_template_sync_status

get_template_sync_status#

Proton.Client.get_template_sync_status(**kwargs)#

Get the status of a template sync.

See also: AWS API Documentation

Request Syntax

response = client.get_template_sync_status(
    templateName='string',
    templateType='ENVIRONMENT'|'SERVICE',
    templateVersion='string'
)
Parameters:
  • templateName (string) –

    [REQUIRED]

    The template name.

  • templateType (string) –

    [REQUIRED]

    The template type.

  • templateVersion (string) –

    [REQUIRED]

    The template major version.

Return type:

dict

Returns:

Response Syntax

{
    'desiredState': {
        'branch': 'string',
        'directory': 'string',
        'repositoryName': 'string',
        'repositoryProvider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET',
        'sha': 'string'
    },
    'latestSuccessfulSync': {
        'events': [
            {
                'event': 'string',
                'externalId': 'string',
                'time': datetime(2015, 1, 1),
                'type': 'string'
            },
        ],
        'initialRevision': {
            'branch': 'string',
            'directory': 'string',
            'repositoryName': 'string',
            'repositoryProvider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET',
            'sha': 'string'
        },
        'startedAt': datetime(2015, 1, 1),
        'status': 'INITIATED'|'IN_PROGRESS'|'SUCCEEDED'|'FAILED',
        'target': 'string',
        'targetRevision': {
            'branch': 'string',
            'directory': 'string',
            'repositoryName': 'string',
            'repositoryProvider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET',
            'sha': 'string'
        }
    },
    'latestSync': {
        'events': [
            {
                'event': 'string',
                'externalId': 'string',
                'time': datetime(2015, 1, 1),
                'type': 'string'
            },
        ],
        'initialRevision': {
            'branch': 'string',
            'directory': 'string',
            'repositoryName': 'string',
            'repositoryProvider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET',
            'sha': 'string'
        },
        'startedAt': datetime(2015, 1, 1),
        'status': 'INITIATED'|'IN_PROGRESS'|'SUCCEEDED'|'FAILED',
        'target': 'string',
        'targetRevision': {
            'branch': 'string',
            'directory': 'string',
            'repositoryName': 'string',
            'repositoryProvider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET',
            'sha': 'string'
        }
    }
}

Response Structure

  • (dict) –

    • desiredState (dict) –

      The template sync desired state that’s returned by Proton.

      • branch (string) –

        The repository branch.

      • directory (string) –

        The repository directory changed by a commit and push that activated the sync attempt.

      • repositoryName (string) –

        The repository name.

      • repositoryProvider (string) –

        The repository provider.

      • sha (string) –

        The secure hash algorithm (SHA) hash for the revision.

    • latestSuccessfulSync (dict) –

      The details of the last successful sync that’s returned by Proton.

      • events (list) –

        An array of events with detail data.

        • (dict) –

          Detail data for a resource sync event.

          • event (string) –

            A resource sync event.

          • externalId (string) –

            The external ID for the event.

          • time (datetime) –

            The time when the event occurred.

          • type (string) –

            The type of event.

      • initialRevision (dict) –

        Detail data for the initial repository commit, path and push.

        • branch (string) –

          The repository branch.

        • directory (string) –

          The repository directory changed by a commit and push that activated the sync attempt.

        • repositoryName (string) –

          The repository name.

        • repositoryProvider (string) –

          The repository provider.

        • sha (string) –

          The secure hash algorithm (SHA) hash for the revision.

      • startedAt (datetime) –

        The time when the sync attempt started.

      • status (string) –

        The status of the sync attempt.

      • target (string) –

        The resource that is synced to.

      • targetRevision (dict) –

        Detail data for the target revision.

        • branch (string) –

          The repository branch.

        • directory (string) –

          The repository directory changed by a commit and push that activated the sync attempt.

        • repositoryName (string) –

          The repository name.

        • repositoryProvider (string) –

          The repository provider.

        • sha (string) –

          The secure hash algorithm (SHA) hash for the revision.

    • latestSync (dict) –

      The details of the last sync that’s returned by Proton.

      • events (list) –

        An array of events with detail data.

        • (dict) –

          Detail data for a resource sync event.

          • event (string) –

            A resource sync event.

          • externalId (string) –

            The external ID for the event.

          • time (datetime) –

            The time when the event occurred.

          • type (string) –

            The type of event.

      • initialRevision (dict) –

        Detail data for the initial repository commit, path and push.

        • branch (string) –

          The repository branch.

        • directory (string) –

          The repository directory changed by a commit and push that activated the sync attempt.

        • repositoryName (string) –

          The repository name.

        • repositoryProvider (string) –

          The repository provider.

        • sha (string) –

          The secure hash algorithm (SHA) hash for the revision.

      • startedAt (datetime) –

        The time when the sync attempt started.

      • status (string) –

        The status of the sync attempt.

      • target (string) –

        The resource that is synced to.

      • targetRevision (dict) –

        Detail data for the target revision.

        • branch (string) –

          The repository branch.

        • directory (string) –

          The repository directory changed by a commit and push that activated the sync attempt.

        • repositoryName (string) –

          The repository name.

        • repositoryProvider (string) –

          The repository provider.

        • sha (string) –

          The secure hash algorithm (SHA) hash for the revision.

Exceptions

  • Proton.Client.exceptions.ValidationException

  • Proton.Client.exceptions.AccessDeniedException

  • Proton.Client.exceptions.ThrottlingException

  • Proton.Client.exceptions.ResourceNotFoundException

  • Proton.Client.exceptions.InternalServerException