aws-sdk-codeartifact 1.23.0 → 1.25.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 74db9511dd83f3caab45bf95f79d0d6cdd3246fbdaa74159832baed182c4085e
-  data.tar.gz: 2d5b028aefa7864a3c43d5d98d97f0d2f1701cb698c8082096d8bc63bfe7abbb
+  metadata.gz: 04e4dc94c04a4a043e984f85a62de2b2d67c2e6e0ddfb39f9aaa49fa69e47534
+  data.tar.gz: a66c4173b0bc5995761ddffddb50d955b3aff65a827f7d33b5b2d9eaee411e5b
 SHA512:
-  metadata.gz: 7a366fd8f427b81f04f9ea367917e12ed628787f97f27b94cd376fa191fd987bcb49ee00524f49394a0f7f26610b6a4177472a32150eef419f818f79dd08bd0d
-  data.tar.gz: 465b8fedd422696205f383bb2254c786ae7b1e7b16a26e477608f9f93ae64b386356aceeb428f2293b05789db6a6619fa40189f9888870fdfc8564131f35bb21
+  metadata.gz: 96b11f28bef8a42bc5b7309afee06267a214cb527e0ca7885c5190113175c5edc088e443112e85cc15c290882d737b50a197c1e827896bf0a7ece24a8bb62373
+  data.tar.gz: 2da71734ebb24b998e59e9fe47f61308417468f8a55cf2cb6c29015eefe60a115db2567360fbc62cbb53d37b91645db9a50a2cb695f66783978887466deb9599

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.25.0 (2023-01-31)
+------------------
+
+* Feature - This release introduces a new DeletePackage API, which enables deletion of a package and all of its versions from a repository.
+
+1.24.0 (2023-01-19)
+------------------
+
+* Feature - Documentation updates for CodeArtifact
+
 1.23.0 (2023-01-18)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.23.0
+1.25.0

data/lib/aws-sdk-codeartifact/client.rb

@@ -392,6 +392,8 @@ module Aws::CodeArtifact
     #
     #   * `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.
@@ -802,6 +804,74 @@ module Aws::CodeArtifact
       req.send_request(options)
     end
 
+    # Deletes a package and all associated package versions. A deleted
+    # package cannot be restored. To delete one or more package versions,
+    # use the [DeletePackageVersions][1] API.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/codeartifact/latest/APIReference/API_DeletePackageVersions.html
+    #
+    # @option params [required, String] :domain
+    #   The name of the domain that contains the package to delete.
+    #
+    # @option params [String] :domain_owner
+    #   The 12-digit account number of the Amazon Web Services account that
+    #   owns the domain. It does not include dashes or spaces.
+    #
+    # @option params [required, String] :repository
+    #   The name of the repository that contains the package to delete.
+    #
+    # @option params [required, String] :format
+    #   The format of the requested package to delete.
+    #
+    # @option params [String] :namespace
+    #   The namespace of the package to delete. The package component that
+    #   specifies its namespace depends on its type. For example:
+    #
+    #   * The namespace of a Maven package is its `groupId`. The namespace is
+    #     required when deleting Maven package versions.
+    #
+    #   * The namespace of an npm package is its `scope`.
+    #
+    #   * Python and NuGet packages do not contain corresponding components,
+    #     packages of those formats do not have a namespace.
+    #
+    # @option params [required, String] :package
+    #   The name of the package to delete.
+    #
+    # @return [Types::DeletePackageResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DeletePackageResult#deleted_package #deleted_package} => Types::PackageSummary
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_package({
+    #     domain: "DomainName", # required
+    #     domain_owner: "AccountId",
+    #     repository: "RepositoryName", # required
+    #     format: "npm", # required, accepts npm, pypi, maven, nuget
+    #     namespace: "PackageNamespace",
+    #     package: "PackageName", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.deleted_package.format #=> String, one of "npm", "pypi", "maven", "nuget"
+    #   resp.deleted_package.namespace #=> String
+    #   resp.deleted_package.package #=> String
+    #   resp.deleted_package.origin_configuration.restrictions.publish #=> String, one of "ALLOW", "BLOCK"
+    #   resp.deleted_package.origin_configuration.restrictions.upstream #=> String, one of "ALLOW", "BLOCK"
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/codeartifact-2018-09-22/DeletePackage AWS API Documentation
+    #
+    # @overload delete_package(params = {})
+    # @param [Hash] params ({})
+    def delete_package(params = {}, options = {})
+      req = build_request(:delete_package, params)
+      req.send_request(options)
+    end
+
     # Deletes one or more versions of a package. A deleted package version
     # cannot be restored in your repository. If you want to remove a package
     # version from your repository and be able to restore it later, set its
@@ -1594,10 +1664,7 @@ module Aws::CodeArtifact
       req.send_request(options, &block)
     end
 
-    # Gets the readme file or descriptive text for a package version. For
-    # packages that do not contain a readme file, CodeArtifact extracts a
-    # description from a metadata file. For example, from the
-    # `<description>` element in the `pom.xml` file of a Maven package.
+    # Gets the readme file or descriptive text for a package version.
     #
     # The returned text might contain formatting. For example, it might
     # contain formatting for Markdown or reStructuredText.
@@ -1618,6 +1685,11 @@ module Aws::CodeArtifact
     #   A format that specifies the type of the package version with the
     #   requested readme file.
     #
+    #   <note markdown="1"> Although `maven` is listed as a valid value, CodeArtifact does not
+    #   support displaying readme files for Maven packages.
+    #
+    #    </note>
+    #
     # @option params [String] :namespace
     #   The namespace of the package version with the requested readme file.
     #   The package version component that specifies its namespace depends on
@@ -2018,7 +2090,9 @@ module Aws::CodeArtifact
     end
 
     # Returns a list of [PackageVersionSummary][1] objects for package
-    # versions in a repository that match the request parameters.
+    # versions in a repository that match the request parameters. Package
+    # versions of all statuses will be returned by default when calling
+    # `list-package-versions` with no `--status` parameter.
     #
     #
     #
@@ -2836,7 +2910,7 @@ module Aws::CodeArtifact
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-codeartifact'
-      context[:gem_version] = '1.23.0'
+      context[:gem_version] = '1.25.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-codeartifact/client_api.rb

@@ -38,6 +38,8 @@ module Aws::CodeArtifact
     DeleteDomainPermissionsPolicyResult = Shapes::StructureShape.new(name: 'DeleteDomainPermissionsPolicyResult')
     DeleteDomainRequest = Shapes::StructureShape.new(name: 'DeleteDomainRequest')
     DeleteDomainResult = Shapes::StructureShape.new(name: 'DeleteDomainResult')
+    DeletePackageRequest = Shapes::StructureShape.new(name: 'DeletePackageRequest')
+    DeletePackageResult = Shapes::StructureShape.new(name: 'DeletePackageResult')
     DeletePackageVersionsRequest = Shapes::StructureShape.new(name: 'DeletePackageVersionsRequest')
     DeletePackageVersionsResult = Shapes::StructureShape.new(name: 'DeletePackageVersionsResult')
     DeleteRepositoryPermissionsPolicyRequest = Shapes::StructureShape.new(name: 'DeleteRepositoryPermissionsPolicyRequest')
@@ -256,6 +258,17 @@ module Aws::CodeArtifact
     DeleteDomainResult.add_member(:domain, Shapes::ShapeRef.new(shape: DomainDescription, location_name: "domain"))
     DeleteDomainResult.struct_class = Types::DeleteDomainResult
 
+    DeletePackageRequest.add_member(:domain, Shapes::ShapeRef.new(shape: DomainName, required: true, location: "querystring", location_name: "domain"))
+    DeletePackageRequest.add_member(:domain_owner, Shapes::ShapeRef.new(shape: AccountId, location: "querystring", location_name: "domain-owner"))
+    DeletePackageRequest.add_member(:repository, Shapes::ShapeRef.new(shape: RepositoryName, required: true, location: "querystring", location_name: "repository"))
+    DeletePackageRequest.add_member(:format, Shapes::ShapeRef.new(shape: PackageFormat, required: true, location: "querystring", location_name: "format"))
+    DeletePackageRequest.add_member(:namespace, Shapes::ShapeRef.new(shape: PackageNamespace, location: "querystring", location_name: "namespace"))
+    DeletePackageRequest.add_member(:package, Shapes::ShapeRef.new(shape: PackageName, required: true, location: "querystring", location_name: "package"))
+    DeletePackageRequest.struct_class = Types::DeletePackageRequest
+
+    DeletePackageResult.add_member(:deleted_package, Shapes::ShapeRef.new(shape: PackageSummary, location_name: "deletedPackage"))
+    DeletePackageResult.struct_class = Types::DeletePackageResult
+
     DeletePackageVersionsRequest.add_member(:domain, Shapes::ShapeRef.new(shape: DomainName, required: true, location: "querystring", location_name: "domain"))
     DeletePackageVersionsRequest.add_member(:domain_owner, Shapes::ShapeRef.new(shape: AccountId, location: "querystring", location_name: "domain-owner"))
     DeletePackageVersionsRequest.add_member(:repository, Shapes::ShapeRef.new(shape: RepositoryName, required: true, location: "querystring", location_name: "repository"))
@@ -880,6 +893,20 @@ module Aws::CodeArtifact
         o.errors << Shapes::ShapeRef.new(shape: ValidationException)
       end)
 
+      api.add_operation(:delete_package, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "DeletePackage"
+        o.http_method = "DELETE"
+        o.http_request_uri = "/v1/package"
+        o.input = Shapes::ShapeRef.new(shape: DeletePackageRequest)
+        o.output = Shapes::ShapeRef.new(shape: DeletePackageResult)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: ConflictException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+      end)
+
       api.add_operation(:delete_package_versions, Seahorse::Model::Operation.new.tap do |o|
         o.name = "DeletePackageVersions"
         o.http_method = "POST"

data/lib/aws-sdk-codeartifact/endpoint_parameters.rb

@@ -50,6 +50,9 @@ module Aws::CodeArtifact
 
     def initialize(options = {})
       self[:region] = options[:region]
+      if self[:region].nil?
+        raise ArgumentError, "Missing required EndpointParameter: :region"
+      end
       self[:use_dual_stack] = options[:use_dual_stack]
       self[:use_dual_stack] = false if self[:use_dual_stack].nil?
       if self[:use_dual_stack].nil?

data/lib/aws-sdk-codeartifact/endpoint_provider.rb

@@ -15,7 +15,7 @@ module Aws::CodeArtifact
       use_fips = parameters.use_fips
       endpoint = parameters.endpoint
       if (partition_result = Aws::Endpoints::Matchers.aws_partition(region))
-        if Aws::Endpoints::Matchers.set?(endpoint) && (url = Aws::Endpoints::Matchers.parse_url(endpoint))
+        if Aws::Endpoints::Matchers.set?(endpoint)
           if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
             raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
           end

data/lib/aws-sdk-codeartifact/endpoints.rb

@@ -95,6 +95,20 @@ module Aws::CodeArtifact
       end
     end
 
+    class DeletePackage
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::CodeArtifact::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
     class DeletePackageVersions
       def self.build(context)
         unless context.config.regional_endpoint

data/lib/aws-sdk-codeartifact/plugins/endpoints.rb

@@ -68,6 +68,8 @@ module Aws::CodeArtifact
             Aws::CodeArtifact::Endpoints::DeleteDomain.build(context)
           when :delete_domain_permissions_policy
             Aws::CodeArtifact::Endpoints::DeleteDomainPermissionsPolicy.build(context)
+          when :delete_package
+            Aws::CodeArtifact::Endpoints::DeletePackage.build(context)
           when :delete_package_versions
             Aws::CodeArtifact::Endpoints::DeletePackageVersions.build(context)
           when :delete_repository

data/lib/aws-sdk-codeartifact/types.rb

@@ -68,6 +68,8 @@ module Aws::CodeArtifact
     #
     #   * `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.
@@ -445,6 +447,65 @@ module Aws::CodeArtifact
       include Aws::Structure
     end
 
+    # @!attribute [rw] domain
+    #   The name of the domain that contains the package to delete.
+    #   @return [String]
+    #
+    # @!attribute [rw] domain_owner
+    #   The 12-digit account number of the Amazon Web Services account that
+    #   owns the domain. It does not include dashes or spaces.
+    #   @return [String]
+    #
+    # @!attribute [rw] repository
+    #   The name of the repository that contains the package to delete.
+    #   @return [String]
+    #
+    # @!attribute [rw] format
+    #   The format of the requested package to delete.
+    #   @return [String]
+    #
+    # @!attribute [rw] namespace
+    #   The namespace of the package to delete. The package component that
+    #   specifies its namespace depends on its type. For example:
+    #
+    #   * The namespace of a Maven package is its `groupId`. The namespace
+    #     is required when deleting Maven package versions.
+    #
+    #   * The namespace of an npm package is its `scope`.
+    #
+    #   * Python and NuGet packages do not contain corresponding components,
+    #     packages of those formats do not have a namespace.
+    #   @return [String]
+    #
+    # @!attribute [rw] package
+    #   The name of the package to delete.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/codeartifact-2018-09-22/DeletePackageRequest AWS API Documentation
+    #
+    class DeletePackageRequest < Struct.new(
+      :domain,
+      :domain_owner,
+      :repository,
+      :format,
+      :namespace,
+      :package)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] deleted_package
+    #   Details about a package, including its format, namespace, and name.
+    #   @return [Types::PackageSummary]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/codeartifact-2018-09-22/DeletePackageResult AWS API Documentation
+    #
+    class DeletePackageResult < Struct.new(
+      :deleted_package)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] domain
     #   The name of the domain that contains the package to delete.
     #   @return [String]
@@ -1283,6 +1344,11 @@ module Aws::CodeArtifact
     # @!attribute [rw] format
     #   A format that specifies the type of the package version with the
     #   requested readme file.
+    #
+    #   <note markdown="1"> Although `maven` is listed as a valid value, CodeArtifact does not
+    #   support displaying readme files for Maven packages.
+    #
+    #    </note>
     #   @return [String]
     #
     # @!attribute [rw] namespace
@@ -2272,12 +2338,6 @@ module Aws::CodeArtifact
     end
 
     # Details about a package, including its format, namespace, and name.
-    # The [ListPackages][1] operation returns a list of `PackageSummary`
-    # objects.
-    #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/codeartifact/latest/APIReference/API_ListPackages.html
     #
     # @!attribute [rw] format
     #   The format of the package.

data/lib/aws-sdk-codeartifact.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-codeartifact/customizations'
 # @!group service
 module Aws::CodeArtifact
 
-  GEM_VERSION = '1.23.0'
+  GEM_VERSION = '1.25.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-codeartifact
 version: !ruby/object:Gem::Version
-  version: 1.23.0
+  version: 1.25.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-01-18 00:00:00.000000000 Z
+date: 2023-01-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core