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.

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'
            },
        ]
    }
}

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