List repositories

Use the commands in this topic to list repositories in an AWS account or domain.

List repositories in an AWS account

Use this command to list all of the repositories in your AWS account.

aws codeartifact list-repositories

Sample output:

{
    "repositories": [
        {
            "name": "repo1",
            "administratorAccount": "123456789012",
            "domainName": "my_domain",
            "domainOwner": "123456789012",
            "arn": "arn:aws:codeartifact:region-id:123456789012:repository/my_domain/repo1",
            "description": "Description of repo1"
        },
        {
            "name": "repo2",
            "administratorAccount": "123456789012",
            "domainName": "my_domain",
            "domainOwner": "123456789012",
            "arn": "arn:aws:codeartifact:region-id:123456789012:repository/my_domain/repo2",
            "description": "Description of repo2"    
            
        },
        {
            "name": "repo3",
            "administratorAccount": "123456789012",
            "domainName": "my_domain2",
            "domainOwner": "123456789012",
            "arn": "arn:aws:codeartifact:region-id:123456789012:repository/my_domain2/repo3",
            "description": "Description of repo3"
        }
    ]
}

You can paginate the response from list-repositories using the --max-results and --next-token parameters. For --max-results, specify an integer from 1 to 1000 to specify the number of results returned in a single page. Its default is 50. To return subsequent pages, run list-repositories again and pass the nextToken value received in the previous command output to --next-token. When the --next-token option is not used, the first page of results is always returned.

List repositories in the domain

Use list-repositories-in-domain to get a list of all the repositories in a domain.

aws codeartifact list-repositories-in-domain --domain my_domain --domain-owner 123456789012 --max-results 3

The output shows that some of the repositories are administered by different AWS accounts.

{
    "repositories": [
        {
            "name": "repo1",
            "administratorAccount": "123456789012",
            "domainName": "my_domain",
            "domainOwner": "111122223333",  
            "arn": "arn:aws:codeartifact:region-id:111122223333:repository/my_domain/repo1",
            "description": "Description of repo1"
        },
        {
            "name": "repo2",
            "administratorAccount": "444455556666",
            "domainName": "my_domain",
            "domainOwner": "111122223333",
            "arn": "arn:aws:codeartifact:region-id:111122223333:repository/my_domain/repo2",
            "description": "Description of repo2"            
        },
        {
            "name": "repo3",
            "administratorAccount": "444455556666",
            "domainName": "my_domain",
            "domainOwner": "111122223333",
            "arn": "arn:aws:codeartifact:region-id:111122223333:repository/my_domain/repo3",
            "description": "Description of repo3"            
        }
    ]
}

You can paginate the response from list-repositories-in-domain using the --max-results and --next-token parameters. For --max-results, specify an integer from 1 to 1000 to specify the number of results returned in a single page. Its default is 50. To return subsequent pages, run list-repositories-in-domain again and pass the nextToken value received in the previous command output to --next-token. When the --next-token option is not used, the first page of results is always returned.

To output the repository names in a more compact list, try the following command.

aws codeartifact list-repositories-in-domain --domain my_domain --domain-owner 111122223333 \
  --query 'repositories[*].[name]' --output text

Sample output:

repo1
repo2
repo3

The following example outputs the account ID in addition to the repository name.

aws codeartifact list-repositories-in-domain --domain my_domain --domain-owner 111122223333  \
  --query 'repositories[*].[name,administratorAccount]' --output text

Sample output:

repo1 710221105108
repo2 710221105108
repo3 532996949307

For more information about the --query parameter, see ListRepositories in the CodeArtifact API Reference.