CodeArtifact / Client / associate_external_connection

associate_external_connection

CodeArtifact.Client.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.

  • public:maven-clojars - for the Clojars 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'|'generic',
                'status': 'Available'
            },
        ],
        'createdTime': datetime(2015, 1, 1)
    }
}

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.

    • createdTime (datetime) –

      A timestamp that represents the date and time the repository was created.

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