@aws-sdk/client-codeartifact 3.533.0 → 3.539.0

package/README.md

@@ -13,9 +13,8 @@ public and CodeArtifact repositories. You can also create an upstream relationsh
 repository and another repository, which effectively merges their contents from the point of
 view of a package manager client. </p>
 <p>
-<b>CodeArtifact Components</b>
+<b>CodeArtifact concepts</b>
 </p>
-<p>Use the information in this guide to help you work with the following CodeArtifact components:</p>
 <ul>
 <li>
 <p>
@@ -29,7 +28,10 @@ repository exposes endpoints for fetching and publishing packages using tools li
 <code>mvn</code>
 </b>), Python CLIs (<b>
 <code>pip</code>
-</b> and <code>twine</code>), and NuGet CLIs (<code>nuget</code> and <code>dotnet</code>).</p>
+</b> and <code>twine</code>), NuGet CLIs (<code>nuget</code> and <code>dotnet</code>), and
+the Swift package manager (<b>
+<code>swift</code>
+</b>).</p>
 </li>
 <li>
 <p>
@@ -51,7 +53,7 @@ across their organization.</p>
 <li>
 <p>
 <b>Package</b>: A <i>package</i> is a bundle of software and the metadata required to
-resolve dependencies and install the software. CodeArtifact supports <a href="https://docs.aws.amazon.com/codeartifact/latest/ug/using-npm.html">npm</a>, <a href="https://docs.aws.amazon.com/codeartifact/latest/ug/using-python.html">PyPI</a>, <a href="https://docs.aws.amazon.com/codeartifact/latest/ug/using-maven">Maven</a>, and <a href="https://docs.aws.amazon.com/codeartifact/latest/ug/using-nuget">NuGet</a> package formats.</p>
+resolve dependencies and install the software. CodeArtifact supports <a href="https://docs.aws.amazon.com/codeartifact/latest/ug/using-npm.html">npm</a>, <a href="https://docs.aws.amazon.com/codeartifact/latest/ug/using-python.html">PyPI</a>, <a href="https://docs.aws.amazon.com/codeartifact/latest/ug/using-maven">Maven</a>, <a href="https://docs.aws.amazon.com/codeartifact/latest/ug/using-nuget">NuGet</a>, <a href="https://docs.aws.amazon.com/codeartifact/latest/ug/using-swift">Swift</a>, and <a href="https://docs.aws.amazon.com/codeartifact/latest/ug/using-generic">generic</a> package formats.</p>
 <p>In CodeArtifact, a package consists of:</p>
 <ul>
 <li>
@@ -72,6 +74,14 @@ popular npm package)</p>
 </li>
 <li>
 <p>
+<b>Package group</b>: A group of packages that match a specified definition. Package
+groups can be used to apply configuration to multiple packages that match a defined pattern using
+package format, package namespace, and package name. You can use package groups to more conveniently
+configure package origin controls for multiple packages. Package origin controls are used to block or allow ingestion or publishing
+of new package versions, which protects users from malicious actions known as dependency substitution attacks.</p>
+</li>
+<li>
+<p>
 <b>Package version</b>: A version of a package, such as <code>@types/node 12.6.9</code>. The version number
 format and semantics vary for different package formats. For example, npm package versions
 must conform to the <a href="https://semver.org/">Semantic Versioning
@@ -91,7 +101,9 @@ allows creating an upstream relationship between two repositories.</p>
 <code>.tgz</code> file or Maven POM and JAR files.</p>
 </li>
 </ul>
-<p>CodeArtifact supports these operations:</p>
+<p>
+<b>CodeArtifact supported API operations</b>
+</p>
 <ul>
 <li>
 <p>
@@ -106,7 +118,11 @@ repository to another repository in the same domain.</p>
 </li>
 <li>
 <p>
-<code>CreateDomain</code>: Creates a domain</p>
+<code>CreateDomain</code>: Creates a domain.</p>
+</li>
+<li>
+<p>
+<code>CreatePackageGroup</code>: Creates a package group.</p>
 </li>
 <li>
 <p>
@@ -127,6 +143,10 @@ repositories. </p>
 </li>
 <li>
 <p>
+<code>DeletePackageGroup</code>: Deletes a package group. Does not delete packages or package versions that are associated with a package group.</p>
+</li>
+<li>
+<p>
 <code>DeletePackageVersions</code>: 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.</p>
@@ -152,6 +172,11 @@ object that contains details about a package. </p>
 </li>
 <li>
 <p>
+<code>DescribePackageGroup</code>: Returns a <a href="https://docs.aws.amazon.com/codeartifact/latest/APIReference/API_PackageGroup.html">PackageGroup</a>
+object that contains details about a package group. </p>
+</li>
+<li>
+<p>
 <code>DescribePackageVersion</code>: Returns a <a href="https://docs.aws.amazon.com/codeartifact/latest/APIReference/API_PackageVersionDescription.html">PackageVersionDescription</a>
 object that contains details about a package version. </p>
 </li>
@@ -173,6 +198,10 @@ permanently removed from storage.</p>
 </li>
 <li>
 <p>
+<code>GetAssociatedPackageGroup</code>: Returns the most closely associated package group to the specified package.</p>
+</li>
+<li>
+<p>
 <code>GetAuthorizationToken</code>: 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.</p>
 </li>
@@ -197,6 +226,11 @@ package format:
 <ul>
 <li>
 <p>
+<code>generic</code>
+</p>
+</li>
+<li>
+<p>
 <code>maven</code>
 </p>
 </li>
@@ -215,6 +249,11 @@ package format:
 <code>pypi</code>
 </p>
 </li>
+<li>
+<p>
+<code>swift</code>
+</p>
+</li>
 </ul>
 </li>
 <li>
@@ -224,6 +263,14 @@ package format:
 </li>
 <li>
 <p>
+<code>ListAllowedRepositoriesForGroup</code>: Lists the allowed repositories for a package group that has origin configuration set to <code>ALLOW_SPECIFIC_REPOSITORIES</code>.</p>
+</li>
+<li>
+<p>
+<code>ListAssociatedPackages</code>: Returns a list of packages associated with the requested package group.</p>
+</li>
+<li>
+<p>
 <code>ListDomains</code>: Returns a list of <code>DomainSummary</code> objects. Each
 returned <code>DomainSummary</code> object contains information about a domain.</p>
 </li>
@@ -233,6 +280,10 @@ returned <code>DomainSummary</code> object contains information about a domain.<
 </li>
 <li>
 <p>
+<code>ListPackageGroups</code>: Returns a list of package groups in the requested domain.</p>
+</li>
+<li>
+<p>
 <code>ListPackageVersionAssets</code>: Lists the assets for a given package version.</p>
 </li>
 <li>
@@ -255,6 +306,10 @@ package in a repository.</p>
 </li>
 <li>
 <p>
+<code>ListSubPackageGroups</code>: Returns a list of direct children of the specified package group.</p>
+</li>
+<li>
+<p>
 <code>PublishPackageVersion</code>: Creates a new package version containing one or more assets.</p>
 </li>
 <li>
@@ -273,6 +328,14 @@ that specifies permissions to access it. </p>
 </li>
 <li>
 <p>
+<code>UpdatePackageGroup</code>: Updates a package group. This API cannot be used to update a package group's origin configuration or pattern.</p>
+</li>
+<li>
+<p>
+<code>UpdatePackageGroupOriginConfiguration</code>: Updates the package origin configuration for a package group.</p>
+</li>
+<li>
+<p>
 <code>UpdatePackageVersionsStatus</code>: Updates the status of one or more versions of a package.</p>
 </li>
 <li>
@@ -499,6 +562,14 @@ CreateDomain
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/codeartifact/command/CreateDomainCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/CreateDomainCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/CreateDomainCommandOutput/)
 
+</details>
+<details>
+<summary>
+CreatePackageGroup
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/codeartifact/command/CreatePackageGroupCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/CreatePackageGroupCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/CreatePackageGroupCommandOutput/)
+
 </details>
 <details>
 <summary>
@@ -531,6 +602,14 @@ DeletePackage
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/codeartifact/command/DeletePackageCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/DeletePackageCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/DeletePackageCommandOutput/)
 
+</details>
+<details>
+<summary>
+DeletePackageGroup
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/codeartifact/command/DeletePackageGroupCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/DeletePackageGroupCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/DeletePackageGroupCommandOutput/)
+
 </details>
 <details>
 <summary>
@@ -571,6 +650,14 @@ DescribePackage
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/codeartifact/command/DescribePackageCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/DescribePackageCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/DescribePackageCommandOutput/)
 
+</details>
+<details>
+<summary>
+DescribePackageGroup
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/codeartifact/command/DescribePackageGroupCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/DescribePackageGroupCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/DescribePackageGroupCommandOutput/)
+
 </details>
 <details>
 <summary>
@@ -603,6 +690,14 @@ DisposePackageVersions
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/codeartifact/command/DisposePackageVersionsCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/DisposePackageVersionsCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/DisposePackageVersionsCommandOutput/)
 
+</details>
+<details>
+<summary>
+GetAssociatedPackageGroup
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/codeartifact/command/GetAssociatedPackageGroupCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/GetAssociatedPackageGroupCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/GetAssociatedPackageGroupCommandOutput/)
+
 </details>
 <details>
 <summary>
@@ -651,6 +746,22 @@ GetRepositoryPermissionsPolicy
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/codeartifact/command/GetRepositoryPermissionsPolicyCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/GetRepositoryPermissionsPolicyCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/GetRepositoryPermissionsPolicyCommandOutput/)
 
+</details>
+<details>
+<summary>
+ListAllowedRepositoriesForGroup
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/codeartifact/command/ListAllowedRepositoriesForGroupCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/ListAllowedRepositoriesForGroupCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/ListAllowedRepositoriesForGroupCommandOutput/)
+
+</details>
+<details>
+<summary>
+ListAssociatedPackages
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/codeartifact/command/ListAssociatedPackagesCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/ListAssociatedPackagesCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/ListAssociatedPackagesCommandOutput/)
+
 </details>
 <details>
 <summary>
@@ -659,6 +770,14 @@ ListDomains
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/codeartifact/command/ListDomainsCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/ListDomainsCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/ListDomainsCommandOutput/)
 
+</details>
+<details>
+<summary>
+ListPackageGroups
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/codeartifact/command/ListPackageGroupsCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/ListPackageGroupsCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/ListPackageGroupsCommandOutput/)
+
 </details>
 <details>
 <summary>
@@ -707,6 +826,14 @@ ListRepositoriesInDomain
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/codeartifact/command/ListRepositoriesInDomainCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/ListRepositoriesInDomainCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/ListRepositoriesInDomainCommandOutput/)
 
+</details>
+<details>
+<summary>
+ListSubPackageGroups
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/codeartifact/command/ListSubPackageGroupsCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/ListSubPackageGroupsCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/ListSubPackageGroupsCommandOutput/)
+
 </details>
 <details>
 <summary>
@@ -763,6 +890,22 @@ UntagResource
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/codeartifact/command/UntagResourceCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/UntagResourceCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/UntagResourceCommandOutput/)
 
+</details>
+<details>
+<summary>
+UpdatePackageGroup
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/codeartifact/command/UpdatePackageGroupCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/UpdatePackageGroupCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/UpdatePackageGroupCommandOutput/)
+
+</details>
+<details>
+<summary>
+UpdatePackageGroupOriginConfiguration
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/codeartifact/command/UpdatePackageGroupOriginConfigurationCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/UpdatePackageGroupOriginConfigurationCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-codeartifact/Interface/UpdatePackageGroupOriginConfigurationCommandOutput/)
+
 </details>
 <details>
 <summary>