aws-sdk-ecr 1.79.0 → 1.80.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1a393d47f9c75a5481b325c4ac2cc96e54f0fcb734a405e38a916c7bf09074b6
-  data.tar.gz: 45f3908d24dc14f4127299fc2e3c7eece2fa6af2be353d17a407e9d2d79a206b
+  metadata.gz: 486c61d1d10d3e8ac8a0887a562ea17f5b5b4d57a77d3eb29a170e6035a0e1b9
+  data.tar.gz: c624b983398e842d6d6f5cd02b566b429ca6a381a447ae6c248d6ba75fd1ef81
 SHA512:
-  metadata.gz: 110c45269757aa566fab0dae2cfbd59e27d5e318c1f0410f367cfb686ff48a713cef65cd7a6711364e20b8c61476f78180e41c0a80d1e6b265a1b6414c3aa84c
-  data.tar.gz: b4206cdfe2f6e3460b249d8abe7de0902415a183f6be499ae884cfafa97fba9e96f1d0195b309cfb6daff4ed06c6eccca39e7fa1725f4f8adb7d39e816bb814e
+  metadata.gz: 9049d87ee2fd7ef6e6256f42bb6a75a4ffba2550e2f1f4585f28818f220344890b2bee192ae54890b81519a7945fe1954e883a28092e883e031185909364da68
+  data.tar.gz: a9504780fa21834e895c73b179b6594ace480482a127d7a17caab367d1d77577e5961c83de2d231a90ef554e08893ab12e4d9f548de2a6b4a9eb033764c98f92

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.80.0 (2024-08-05)
+------------------
+
+* Feature - Released two new APIs along with documentation updates. The GetAccountSetting API is used to view the current basic scan type version setting for your registry, while the PutAccountSetting API is used to update the basic scan type version for your registry.
+
 1.79.0 (2024-07-25)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.79.0
+1.80.0

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

@@ -1036,7 +1036,10 @@ module Aws::ECR
     #
     # @option params [String] :custom_role_arn
     #   The ARN of the role to be assumed by Amazon ECR. This role must be in
-    #   the same account as the registry that you are configuring.
+    #   the same account as the registry that you are configuring. Amazon ECR
+    #   will assume your supplied role when the customRoleArn is specified.
+    #   When this field isn't specified, Amazon ECR will use the
+    #   service-linked role for the repository creation template.
     #
     # @return [Types::CreateRepositoryCreationTemplateResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2074,6 +2077,36 @@ module Aws::ECR
       req.send_request(options)
     end
 
+    # Retrieves the basic scan type version name.
+    #
+    # @option params [required, String] :name
+    #   Basic scan type version name.
+    #
+    # @return [Types::GetAccountSettingResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetAccountSettingResponse#name #name} => String
+    #   * {Types::GetAccountSettingResponse#value #value} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_account_setting({
+    #     name: "AccountSettingName", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.name #=> String
+    #   resp.value #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/GetAccountSetting AWS API Documentation
+    #
+    # @overload get_account_setting(params = {})
+    # @param [Hash] params ({})
+    def get_account_setting(params = {}, options = {})
+      req = build_request(:get_account_setting, params)
+      req.send_request(options)
+    end
+
     # Retrieves an authorization token. An authorization token represents
     # your IAM authentication credentials and can be used to access any
     # Amazon ECR registry that your IAM principal has access to. The
@@ -2610,6 +2643,42 @@ module Aws::ECR
       req.send_request(options)
     end
 
+    # Allows you to change the basic scan type version by setting the `name`
+    # parameter to either `CLAIR` to `AWS_NATIVE`.
+    #
+    # @option params [required, String] :name
+    #   Basic scan type version name.
+    #
+    # @option params [required, String] :value
+    #   Setting value that determines what basic scan type is being used:
+    #   `AWS_NATIVE` or `CLAIR`.
+    #
+    # @return [Types::PutAccountSettingResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::PutAccountSettingResponse#name #name} => String
+    #   * {Types::PutAccountSettingResponse#value #value} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.put_account_setting({
+    #     name: "AccountSettingName", # required
+    #     value: "AccountSettingValue", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.name #=> String
+    #   resp.value #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/PutAccountSetting AWS API Documentation
+    #
+    # @overload put_account_setting(params = {})
+    # @param [Hash] params ({})
+    def put_account_setting(params = {}, options = {})
+      req = build_request(:put_account_setting, params)
+      req.send_request(options)
+    end
+
     # Creates or updates the image manifest and tags associated with an
     # image.
     #
@@ -3339,7 +3408,10 @@ module Aws::ECR
     #
     # @option params [String] :custom_role_arn
     #   The ARN of the role to be assumed by Amazon ECR. This role must be in
-    #   the same account as the registry that you are configuring.
+    #   the same account as the registry that you are configuring. Amazon ECR
+    #   will assume your supplied role when the customRoleArn is specified.
+    #   When this field isn't specified, Amazon ECR will use the
+    #   service-linked role for the repository creation template.
     #
     # @return [Types::UpdateRepositoryCreationTemplateResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3571,7 +3643,7 @@ module Aws::ECR
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-ecr'
-      context[:gem_version] = '1.79.0'
+      context[:gem_version] = '1.80.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -13,6 +13,8 @@ module Aws::ECR
 
     include Seahorse::Model
 
+    AccountSettingName = Shapes::StringShape.new(name: 'AccountSettingName')
+    AccountSettingValue = Shapes::StringShape.new(name: 'AccountSettingValue')
     Arch = Shapes::StringShape.new(name: 'Arch')
     Arn = Shapes::StringShape.new(name: 'Arn')
     Attribute = Shapes::StructureShape.new(name: 'Attribute')
@@ -96,6 +98,8 @@ module Aws::ECR
     FindingSeverity = Shapes::StringShape.new(name: 'FindingSeverity')
     FindingSeverityCounts = Shapes::MapShape.new(name: 'FindingSeverityCounts')
     ForceFlag = Shapes::BooleanShape.new(name: 'ForceFlag')
+    GetAccountSettingRequest = Shapes::StructureShape.new(name: 'GetAccountSettingRequest')
+    GetAccountSettingResponse = Shapes::StructureShape.new(name: 'GetAccountSettingResponse')
     GetAuthorizationTokenRegistryIdList = Shapes::ListShape.new(name: 'GetAuthorizationTokenRegistryIdList')
     GetAuthorizationTokenRequest = Shapes::StructureShape.new(name: 'GetAuthorizationTokenRequest')
     GetAuthorizationTokenResponse = Shapes::StructureShape.new(name: 'GetAuthorizationTokenResponse')
@@ -207,6 +211,8 @@ module Aws::ECR
     PullThroughCacheRuleRepositoryPrefix = Shapes::StringShape.new(name: 'PullThroughCacheRuleRepositoryPrefix')
     PullThroughCacheRuleRepositoryPrefixList = Shapes::ListShape.new(name: 'PullThroughCacheRuleRepositoryPrefixList')
     PushTimestamp = Shapes::TimestampShape.new(name: 'PushTimestamp')
+    PutAccountSettingRequest = Shapes::StructureShape.new(name: 'PutAccountSettingRequest')
+    PutAccountSettingResponse = Shapes::StructureShape.new(name: 'PutAccountSettingResponse')
     PutImageRequest = Shapes::StructureShape.new(name: 'PutImageRequest')
     PutImageResponse = Shapes::StructureShape.new(name: 'PutImageResponse')
     PutImageScanningConfigurationRequest = Shapes::StructureShape.new(name: 'PutImageScanningConfigurationRequest')
@@ -638,6 +644,13 @@ module Aws::ECR
     FindingSeverityCounts.key = Shapes::ShapeRef.new(shape: FindingSeverity)
     FindingSeverityCounts.value = Shapes::ShapeRef.new(shape: SeverityCount)
 
+    GetAccountSettingRequest.add_member(:name, Shapes::ShapeRef.new(shape: AccountSettingName, required: true, location_name: "name"))
+    GetAccountSettingRequest.struct_class = Types::GetAccountSettingRequest
+
+    GetAccountSettingResponse.add_member(:name, Shapes::ShapeRef.new(shape: AccountSettingName, location_name: "name"))
+    GetAccountSettingResponse.add_member(:value, Shapes::ShapeRef.new(shape: AccountSettingName, location_name: "value"))
+    GetAccountSettingResponse.struct_class = Types::GetAccountSettingResponse
+
     GetAuthorizationTokenRegistryIdList.member = Shapes::ShapeRef.new(shape: RegistryId)
 
     GetAuthorizationTokenRequest.add_member(:registry_ids, Shapes::ShapeRef.new(shape: GetAuthorizationTokenRegistryIdList, deprecated: true, location_name: "registryIds", metadata: {"deprecatedMessage"=>"This field is deprecated. The returned authorization token can be used to access any Amazon ECR registry that the IAM principal has access to, specifying a registry ID doesn't change the permissions scope of the authorization token."}))
@@ -934,6 +947,14 @@ module Aws::ECR
 
     PullThroughCacheRuleRepositoryPrefixList.member = Shapes::ShapeRef.new(shape: PullThroughCacheRuleRepositoryPrefix)
 
+    PutAccountSettingRequest.add_member(:name, Shapes::ShapeRef.new(shape: AccountSettingName, required: true, location_name: "name"))
+    PutAccountSettingRequest.add_member(:value, Shapes::ShapeRef.new(shape: AccountSettingValue, required: true, location_name: "value"))
+    PutAccountSettingRequest.struct_class = Types::PutAccountSettingRequest
+
+    PutAccountSettingResponse.add_member(:name, Shapes::ShapeRef.new(shape: AccountSettingName, location_name: "name"))
+    PutAccountSettingResponse.add_member(:value, Shapes::ShapeRef.new(shape: AccountSettingValue, location_name: "value"))
+    PutAccountSettingResponse.struct_class = Types::PutAccountSettingResponse
+
     PutImageRequest.add_member(:registry_id, Shapes::ShapeRef.new(shape: RegistryId, location_name: "registryId"))
     PutImageRequest.add_member(:repository_name, Shapes::ShapeRef.new(shape: RepositoryName, required: true, location_name: "repositoryName"))
     PutImageRequest.add_member(:image_manifest, Shapes::ShapeRef.new(shape: ImageManifest, required: true, location_name: "imageManifest"))
@@ -1605,6 +1626,17 @@ module Aws::ECR
         )
       end)
 
+      api.add_operation(:get_account_setting, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetAccountSetting"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: GetAccountSettingRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetAccountSettingResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ServerException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+      end)
+
       api.add_operation(:get_authorization_token, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetAuthorizationToken"
         o.http_method = "POST"
@@ -1736,6 +1768,18 @@ module Aws::ECR
         o.errors << Shapes::ShapeRef.new(shape: ServerException)
       end)
 
+      api.add_operation(:put_account_setting, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "PutAccountSetting"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: PutAccountSettingRequest)
+        o.output = Shapes::ShapeRef.new(shape: PutAccountSettingResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ServerException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
+      end)
+
       api.add_operation(:put_image, Seahorse::Model::Operation.new.tap do |o|
         o.name = "PutImage"
         o.http_method = "POST"

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

@@ -306,6 +306,20 @@ module Aws::ECR
       end
     end
 
+    class GetAccountSetting
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::ECR::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 GetAuthorizationToken
       def self.build(context)
         unless context.config.regional_endpoint
@@ -446,6 +460,20 @@ module Aws::ECR
       end
     end
 
+    class PutAccountSetting
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::ECR::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 PutImage
       def self.build(context)
         unless context.config.regional_endpoint

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

@@ -100,6 +100,8 @@ module Aws::ECR
             Aws::ECR::Endpoints::DescribeRepositories.build(context)
           when :describe_repository_creation_templates
             Aws::ECR::Endpoints::DescribeRepositoryCreationTemplates.build(context)
+          when :get_account_setting
+            Aws::ECR::Endpoints::GetAccountSetting.build(context)
           when :get_authorization_token
             Aws::ECR::Endpoints::GetAuthorizationToken.build(context)
           when :get_download_url_for_layer
@@ -120,6 +122,8 @@ module Aws::ECR
             Aws::ECR::Endpoints::ListImages.build(context)
           when :list_tags_for_resource
             Aws::ECR::Endpoints::ListTagsForResource.build(context)
+          when :put_account_setting
+            Aws::ECR::Endpoints::PutAccountSetting.build(context)
           when :put_image
             Aws::ECR::Endpoints::PutImage.build(context)
           when :put_image_scanning_configuration

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

@@ -496,7 +496,10 @@ module Aws::ECR
     #
     # @!attribute [rw] custom_role_arn
     #   The ARN of the role to be assumed by Amazon ECR. This role must be
-    #   in the same account as the registry that you are configuring.
+    #   in the same account as the registry that you are configuring. Amazon
+    #   ECR will assume your supplied role when the customRoleArn is
+    #   specified. When this field isn't specified, Amazon ECR will use the
+    #   service-linked role for the repository creation template.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/CreateRepositoryCreationTemplateRequest AWS API Documentation
@@ -1592,6 +1595,36 @@ module Aws::ECR
       include Aws::Structure
     end
 
+    # @!attribute [rw] name
+    #   Basic scan type version name.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/GetAccountSettingRequest AWS API Documentation
+    #
+    class GetAccountSettingRequest < Struct.new(
+      :name)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] name
+    #   Retrieves the basic scan type version name.
+    #   @return [String]
+    #
+    # @!attribute [rw] value
+    #   Retrieves the value that specifies what basic scan type is being
+    #   used: `AWS_NATIVE` or `CLAIR`.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/GetAccountSettingResponse AWS API Documentation
+    #
+    class GetAccountSettingResponse < Struct.new(
+      :name,
+      :value)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] registry_ids
     #   A list of Amazon Web Services account IDs that are associated with
     #   the registries for which to get AuthorizationData objects. If you do
@@ -2927,6 +2960,41 @@ module Aws::ECR
       include Aws::Structure
     end
 
+    # @!attribute [rw] name
+    #   Basic scan type version name.
+    #   @return [String]
+    #
+    # @!attribute [rw] value
+    #   Setting value that determines what basic scan type is being used:
+    #   `AWS_NATIVE` or `CLAIR`.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/PutAccountSettingRequest AWS API Documentation
+    #
+    class PutAccountSettingRequest < Struct.new(
+      :name,
+      :value)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] name
+    #   Retrieves the the basic scan type version name.
+    #   @return [String]
+    #
+    # @!attribute [rw] value
+    #   Retrieves the basic scan type value, either `AWS_NATIVE` or `-`.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/PutAccountSettingResponse AWS API Documentation
+    #
+    class PutAccountSettingResponse < Struct.new(
+      :name,
+      :value)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] registry_id
     #   The Amazon Web Services account ID associated with the registry that
     #   contains the repository in which to put the image. If you do not
@@ -3520,7 +3588,10 @@ module Aws::ECR
     #   @return [Array<String>]
     #
     # @!attribute [rw] custom_role_arn
-    #   The ARN of the role to be assumed by Amazon ECR.
+    #   The ARN of the role to be assumed by Amazon ECR. Amazon ECR will
+    #   assume your supplied role when the customRoleArn is specified. When
+    #   this field isn't specified, Amazon ECR will use the service-linked
+    #   role for the repository creation template.
     #   @return [String]
     #
     # @!attribute [rw] created_at
@@ -4292,7 +4363,10 @@ module Aws::ECR
     #
     # @!attribute [rw] custom_role_arn
     #   The ARN of the role to be assumed by Amazon ECR. This role must be
-    #   in the same account as the registry that you are configuring.
+    #   in the same account as the registry that you are configuring. Amazon
+    #   ECR will assume your supplied role when the customRoleArn is
+    #   specified. When this field isn't specified, Amazon ECR will use the
+    #   service-linked role for the repository creation template.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/UpdateRepositoryCreationTemplateRequest AWS API Documentation

data/lib/aws-sdk-ecr.rb

@@ -53,6 +53,6 @@ require_relative 'aws-sdk-ecr/customizations'
 # @!group service
 module Aws::ECR
 
-  GEM_VERSION = '1.79.0'
+  GEM_VERSION = '1.80.0'
 
 end

data/sig/client.rbs

@@ -411,6 +411,17 @@ module Aws
                                                   ) -> _DescribeRepositoryCreationTemplatesResponseSuccess
                                                 | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _DescribeRepositoryCreationTemplatesResponseSuccess
 
+      interface _GetAccountSettingResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::GetAccountSettingResponse]
+        def name: () -> ::String
+        def value: () -> ::String
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/ECR/Client.html#get_account_setting-instance_method
+      def get_account_setting: (
+                                 name: ::String
+                               ) -> _GetAccountSettingResponseSuccess
+                             | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetAccountSettingResponseSuccess
+
       interface _GetAuthorizationTokenResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::GetAuthorizationTokenResponse]
         def authorization_data: () -> ::Array[Types::AuthorizationData]
@@ -548,6 +559,18 @@ module Aws
                                   ) -> _ListTagsForResourceResponseSuccess
                                 | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListTagsForResourceResponseSuccess
 
+      interface _PutAccountSettingResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::PutAccountSettingResponse]
+        def name: () -> ::String
+        def value: () -> ::String
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/ECR/Client.html#put_account_setting-instance_method
+      def put_account_setting: (
+                                 name: ::String,
+                                 value: ::String
+                               ) -> _PutAccountSettingResponseSuccess
+                             | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _PutAccountSettingResponseSuccess
+
       interface _PutImageResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::PutImageResponse]
         def image: () -> Types::Image

data/sig/types.rbs

@@ -391,6 +391,17 @@ module Aws::ECR
       SENSITIVE: []
     end
 
+    class GetAccountSettingRequest
+      attr_accessor name: ::String
+      SENSITIVE: []
+    end
+
+    class GetAccountSettingResponse
+      attr_accessor name: ::String
+      attr_accessor value: ::String
+      SENSITIVE: []
+    end
+
     class GetAuthorizationTokenRequest
       attr_accessor registry_ids: ::Array[::String]
       SENSITIVE: []
@@ -767,6 +778,18 @@ module Aws::ECR
       SENSITIVE: []
     end
 
+    class PutAccountSettingRequest
+      attr_accessor name: ::String
+      attr_accessor value: ::String
+      SENSITIVE: []
+    end
+
+    class PutAccountSettingResponse
+      attr_accessor name: ::String
+      attr_accessor value: ::String
+      SENSITIVE: []
+    end
+
     class PutImageRequest
       attr_accessor registry_id: ::String
       attr_accessor repository_name: ::String

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-ecr
 version: !ruby/object:Gem::Version
-  version: 1.79.0
+  version: 1.80.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-07-25 00:00:00.000000000 Z
+date: 2024-08-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core