associate_external_connection

associate_external_connection(**kwargs)

Adds an existing external connection to a repository. One external connection is allowed per repository.

Note

A repository can have one or more upstream repositories, or an external connection.

See also: AWS API Documentation

Request Syntax

response = client.associate_external_connection(
    domain='string',
    domainOwner='string',
    repository='string',
    externalConnection='string'
)
Parameters
  • domain (string) --

    [REQUIRED]

    The name of the domain that contains the repository.

  • domainOwner (string) -- The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.
  • repository (string) --

    [REQUIRED]

    The name of the repository to which the external connection is added.

  • externalConnection (string) --

    [REQUIRED]

    The name of the external connection to add to the repository. The following values are supported:

    • public:npmjs - for the npm public repository.
    • public:nuget-org - for the NuGet Gallery.
    • public:pypi - for the Python Package Index.
    • public:maven-central - for Maven Central.
    • public:maven-googleandroid - for the Google Android repository.
    • public:maven-gradleplugins - for the Gradle plugins repository.
    • public:maven-commonsware - for the CommonsWare Android repository.
Return type

dict

Returns

Response Syntax

{
    'repository': {
        'name': 'string',
        'administratorAccount': 'string',
        'domainName': 'string',
        'domainOwner': 'string',
        'arn': 'string',
        'description': 'string',
        'upstreams': [
            {
                'repositoryName': 'string'
            },
        ],
        'externalConnections': [
            {
                'externalConnectionName': 'string',
                'packageFormat': 'npm'|'pypi'|'maven'|'nuget',
                'status': 'Available'
            },
        ]
    }
}

Response Structure

  • (dict) --

    • repository (dict) --

      Information about the connected repository after processing the request.

      • name (string) --

        The name of the repository.

      • administratorAccount (string) --

        The 12-digit account number of the Amazon Web Services account that manages the repository.

      • domainName (string) --

        The name of the domain that contains the repository.

      • domainOwner (string) --

        The 12-digit account number of the Amazon Web Services account that owns the domain that contains the repository. It does not include dashes or spaces.

      • arn (string) --

        The Amazon Resource Name (ARN) of the repository.

      • description (string) --

        A text description of the repository.

      • upstreams (list) --

        A list of upstream repositories to associate with the repository. The order of the upstream repositories in the list determines their priority order when CodeArtifact looks for a requested package version. For more information, see Working with upstream repositories.

        • (dict) --

          Information about an upstream repository.

          • repositoryName (string) --

            The name of an upstream repository.

      • externalConnections (list) --

        An array of external connections associated with the repository.

        • (dict) --

          Contains information about the external connection of a repository.

          • externalConnectionName (string) --

            The name of the external connection associated with a repository.

          • packageFormat (string) --

            The package format associated with a repository's external connection. The valid package formats are:

            • npm : A Node Package Manager (npm) package.
            • pypi : A Python Package Index (PyPI) package.
            • maven : A Maven package that contains compiled code in a distributable format, such as a JAR file.
            • nuget : A NuGet package.
          • status (string) --

            The status of the external connection of a repository. There is one valid value, Available .

Exceptions

  • CodeArtifact.Client.exceptions.AccessDeniedException
  • CodeArtifact.Client.exceptions.ConflictException
  • CodeArtifact.Client.exceptions.InternalServerException
  • CodeArtifact.Client.exceptions.ResourceNotFoundException
  • CodeArtifact.Client.exceptions.ServiceQuotaExceededException
  • CodeArtifact.Client.exceptions.ThrottlingException
  • CodeArtifact.Client.exceptions.ValidationException