/* * Copyright 2018-2023 Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with * the License. A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR * CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions * and limitations under the License. */ /** *

* CodeArtifact is a fully managed artifact repository compatible with language-native package managers and build tools * such as npm, Apache Maven, pip, and dotnet. You can use CodeArtifact to share packages with development teams and * pull packages. Packages can be pulled from both public and CodeArtifact repositories. You can also create an upstream * relationship between a CodeArtifact repository and another repository, which effectively merges their contents from * the point of view of a package manager client. *

* CodeArtifact Components *

* Use the information in this guide to help you work with the following CodeArtifact components: *

*
* Repository: A CodeArtifact repository contains a set of package * versions, each of which maps to a set of assets, or files. Repositories are polyglot, so a single repository can * contain packages of any supported type. Each repository exposes endpoints for fetching and publishing packages using * tools like the npm CLI, the Maven CLI ( mvn ), Python CLIs ( * pip and twine), and NuGet CLIs (nuget and dotnet). *
*
*
* Domain: Repositories are aggregated into a higher-level entity known as a domain. All package assets * and metadata are stored in the domain, but are consumed through repositories. A given package asset, such as a Maven * JAR file, is stored once per domain, no matter how many repositories it's present in. All of the assets and metadata * in a domain are encrypted with the same customer master key (CMK) stored in Key Management Service (KMS). *
*
* Each repository is a member of a single domain and can't be moved to a different domain. *
*
* The domain allows organizational policy to be applied across multiple repositories, such as which accounts can access * repositories in the domain, and which public repositories can be used as sources of packages. *
*
* Although an organization can have multiple domains, we recommend a single production domain that contains all * published artifacts so that teams can find and share packages across their organization. *
*
*
* Package: A package is a bundle of software and the metadata required to resolve dependencies and * install the software. CodeArtifact supports npm, PyPI, Maven, and NuGet package formats. *
*
* In CodeArtifact, a package consists of: *
*
- *
  * A name (for example, webpack is the name of a popular npm package) *
  *
- *
  * An optional namespace (for example, @types in @types/node) *
  *
- *
  * A set of versions (for example, 1.0.0, 1.0.1, 1.0.2, etc.) *
  *
- *
  * Package-level metadata (for example, npm tags) *
  *
*
*
* Package version: A version of a package, such as @types/node 12.6.9. The version number format * and semantics vary for different package formats. For example, npm package versions must conform to the Semantic Versioning specification. In CodeArtifact, a package version consists of the * version identifier, metadata at the package version level, and a set of assets. *
*
*
* Upstream repository: One repository is upstream of another when the package versions in it can be * accessed from the repository endpoint of the downstream repository, effectively merging the contents of the two * repositories from the point of view of a client. CodeArtifact allows creating an upstream relationship between two * repositories. *
*
*
* Asset: An individual file stored in CodeArtifact associated with a package version, such as an npm * .tgz file or Maven POM and JAR files. *
*

* CodeArtifact supports these operations: *

*
* AssociateExternalConnection: Adds an existing external connection to a repository. *
*
*
* CopyPackageVersions: Copies package versions from one repository to another repository in the same * domain. *
*
*
* CreateDomain: Creates a domain *
*
*
* CreateRepository: Creates a CodeArtifact repository in a domain. *
*
*
* DeleteDomain: Deletes a domain. You cannot delete a domain that contains repositories. *
*
*
* DeleteDomainPermissionsPolicy: Deletes the resource policy that is set on a domain. *
*
*
* DeletePackage: Deletes a package and all associated package versions. *
*
*
* DeletePackageVersions: Deletes versions of a package. After a package has been deleted, it can be * republished, but its assets and metadata cannot be restored because they have been permanently removed from storage. *
*
*
* DeleteRepository: Deletes a repository. *
*
*
* DeleteRepositoryPermissionsPolicy: Deletes the resource policy that is set on a repository. *
*
*
* DescribeDomain: Returns a DomainDescription object that contains information about the * requested domain. *
*
*
* DescribePackage: Returns a PackageDescription object that contains details about a package. *
*
*
* DescribePackageVersion: Returns a PackageVersionDescription object that contains details about a package version. *
*
*
* DescribeRepository: Returns a RepositoryDescription object that contains detailed * information about the requested repository. *
*
*
* DisposePackageVersions: Disposes versions of a package. A package version with the status * Disposed cannot be restored because they have been permanently removed from storage. *
*
*
* DisassociateExternalConnection: Removes an existing external connection from a repository. *
*
*
* GetAuthorizationToken: Generates a temporary authorization token for accessing repositories in the * domain. The token expires the authorization period has passed. The default authorization period is 12 hours and can * be customized to any length with a maximum of 12 hours. *
*
*
* GetDomainPermissionsPolicy: Returns the policy of a resource that is attached to the specified domain. *
*
*
* GetPackageVersionAsset: Returns the contents of an asset that is in a package version. *
*
*
* GetPackageVersionReadme: Gets the readme file or descriptive text for a package version. *
*
*
* GetRepositoryEndpoint: Returns the endpoint of a repository for a specific package format. A repository * has one endpoint for each package format: *
*
- *
  * maven *
  *
- *
  * npm *
  *
- *
  * nuget *
  *
- *
  * pypi *
  *
*
*
* GetRepositoryPermissionsPolicy: Returns the resource policy that is set on a repository. *
*
*
* ListDomains: Returns a list of DomainSummary objects. Each returned * DomainSummary object contains information about a domain. *
*
*
* ListPackages: Lists the packages in a repository. *
*
*
* ListPackageVersionAssets: Lists the assets for a given package version. *
*
*
* ListPackageVersionDependencies: Returns a list of the direct dependencies for a package version. *
*
*
* ListPackageVersions: Returns a list of package versions for a specified package in a repository. *
*
*
* ListRepositories: Returns a list of repositories owned by the Amazon Web Services account that called * this method. *
*
*
* ListRepositoriesInDomain: Returns a list of the repositories in a domain. *
*
*
* PublishPackageVersion: Creates a new package version containing one or more assets. *
*
*
* PutDomainPermissionsPolicy: Attaches a resource policy to a domain. *
*
*
* PutPackageOriginConfiguration: Sets the package origin configuration for a package, which determine how * new versions of the package can be added to a specific repository. *
*
*
* PutRepositoryPermissionsPolicy: Sets the resource policy on a repository that specifies permissions to * access it. *
*
*
* UpdatePackageVersionsStatus: Updates the status of one or more versions of a package. *
*
*
* UpdateRepository: Updates the properties of a repository. *
*

*/ package com.amazonaws.services.codeartifact;