View linked repository data - AWS Proton

View linked repository data

You can list and view linked repository details using the console or the AWS CLI. For repository links that are used to sync git repositories with AWS Proton, you can retrieve repository sync definition and status using the AWS CLI.

AWS Management Console

List and view linked repository details using the AWS Proton console.

  1. To list of your linked repositories, choose Repositories in the navigation pane.

  2. To view detail data, choose the name of a repository.

AWS CLI

List your linked repositories.

Run the following command:

$ aws proton list-repositories

Response:

{
    "repositories": [
        {
            "arn": "arn:aws:proton:region-id:123456789012:repository/github:myrepos/templates",
            "name": "myrepos/templates",
            "provider": "GITHUB"
        },
        {
            "arn": "arn:aws:proton:region-id:123456789012:repository/github:myrepos/environments",
            "name": "myrepos/environments",
            "provider": "GITHUB"
        }
    ]
}

View the details of a linked repository.

Run the following command:

$ aws proton get-repository \
    --name myrepos/templates \
    --provider "GITHUB"

Response:

{
    "repository": {
        "arn": "arn:aws:proton:region-id:123456789012:repository/github:myrepos/templates",
        "name": "myrepos/templates",
        "provider": "GITHUB"
    }
}

List your synced repositories.

The following example lists repositories that you configured for template sync.

Run the following command:

$ aws proton list-repository-sync-definitions \
    --branch "main" \
    --repository-name myrepos/templates \
    --repository-provider "GITHUB" \
    --sync-type "TEMPLATE_SYNC"

View repository sync status.

The following example retrieves sync status of a template sync repository.

Run the following command:

$ aws proton get-repository-sync-status \
    --branch "main" \
    --repository-name myrepos/templates \
    --repository-provider "GITHUB" \
    --sync-type "TEMPLATE_SYNC"

Response:

{
    "latestSync": {
        "events": [
            {
                "event": "Clone started",
                "time": "2021-11-21T00:26:35.883000+00:00",
                "type": "CLONE_STARTED"
            },
            {
                "event": "Updated configuration",
                "time": "2021-11-21T00:26:41.894000+00:00",
                "type": "CONFIG_UPDATED"
            },
            {
                "event": "Starting syncs for commit 62c03ff86eEXAMPLE1111111",
                "externalId": "62c03ff86eEXAMPLE1111111",
                "time": "2021-11-21T00:26:44.861000+00:00",
                "type": "STARTING_SYNC"
            }
        ],
        "startedAt": "2021-11-21T00:26:29.728000+00:00",
        "status": "SUCCEEDED"
    }
}