aws-sdk-ecr 1.19.0 → 1.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5f7a9992c7737549290a078d272e34e7d08f04c2
-  data.tar.gz: 92afd7667b520875b67ba3d6ae6dbe66e0bd2b0b
+  metadata.gz: 30dd8d05a59c1b04585970dd1ebce37935c1aca4
+  data.tar.gz: 7f1062d5f38f1bab4d3973fbdd9ec89f800c0f5c
 SHA512:
-  metadata.gz: bf36c012dac1dc9550df918bce620bb36a5c272c857d0b85a274339979d455281deb07f4a550cbf9d13fbf454f0b0421a9f07a324d9302011d188f0e80d177c7
-  data.tar.gz: 03c288b603250a3196e9cff69ac3cbd4f1278057bae015175d4973cc2f064299af776b542966d111de78bccb3eae7bdc30f18d906514a4627c76e5cab22578fd
+  metadata.gz: d0a98d5dc9f86f664f206e4f7554287ae9a6a81a58c2128c36038552cc7dc0e62ccc3a9801282f408ba064eb4085108f1ea3d3cc675a77f462fcdd4851552aee
+  data.tar.gz: f917bcc2c96334f0c9ccf60f902e12937afafceaafebbe8195e451f05df8704001ffed07ecabb4942a12b61b03fdb7e6b277a1d17b1f5c966683e0e6adf10674

data/lib/aws-sdk-ecr.rb

@@ -42,6 +42,6 @@ require_relative 'aws-sdk-ecr/customizations'
 # @service
 module Aws::ECR
 
-  GEM_VERSION = '1.19.0'
+  GEM_VERSION = '1.20.0'
 
 end

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

@@ -572,6 +572,18 @@ module Aws::ECR
     #   `project-a/nginx-web-app`).
     #
     # @option params [Array<Types::Tag>] :tags
+    #   The metadata that you apply to the repository to help you categorize
+    #   and organize them. Each tag consists of a key and an optional value,
+    #   both of which you define. Tag keys can have a maximum character length
+    #   of 128 characters, and tag values can have a maximum length of 256
+    #   characters.
+    #
+    # @option params [String] :image_tag_mutability
+    #   The tag mutability setting for the repository. If this parameter is
+    #   omitted, the default setting of `MUTABLE` will be used which will
+    #   allow image tags to be overwritten. If `IMMUTABLE` is specified, all
+    #   image tags within the repository will be immutable which will prevent
+    #   them from being overwritten.
     #
     # @return [Types::CreateRepositoryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -606,6 +618,7 @@ module Aws::ECR
     #         value: "TagValue",
     #       },
     #     ],
+    #     image_tag_mutability: "MUTABLE", # accepts MUTABLE, IMMUTABLE
     #   })
     #
     # @example Response structure
@@ -615,6 +628,7 @@ module Aws::ECR
     #   resp.repository.repository_name #=> String
     #   resp.repository.repository_uri #=> String
     #   resp.repository.created_at #=> Time
+    #   resp.repository.image_tag_mutability #=> String, one of "MUTABLE", "IMMUTABLE"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/CreateRepository AWS API Documentation
     #
@@ -718,6 +732,7 @@ module Aws::ECR
     #   resp.repository.repository_name #=> String
     #   resp.repository.repository_uri #=> String
     #   resp.repository.created_at #=> Time
+    #   resp.repository.image_tag_mutability #=> String, one of "MUTABLE", "IMMUTABLE"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/DeleteRepository AWS API Documentation
     #
@@ -800,7 +815,7 @@ module Aws::ECR
     #   registry, the default registry is assumed.
     #
     # @option params [required, String] :repository_name
-    #   A list of repositories to describe.
+    #   The repository that contains the images to describe.
     #
     # @option params [Array<Types::ImageIdentifier>] :image_ids
     #   The list of image IDs for the requested repository.
@@ -957,6 +972,7 @@ module Aws::ECR
     #   resp.repositories[0].repository_name #=> String
     #   resp.repositories[0].repository_uri #=> String
     #   resp.repositories[0].created_at #=> Time
+    #   resp.repositories[0].image_tag_mutability #=> String, one of "MUTABLE", "IMMUTABLE"
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/DescribeRepositories AWS API Documentation
@@ -1488,12 +1504,58 @@ module Aws::ECR
       req.send_request(options)
     end
 
+    # Updates the image tag mutability settings for a repository.
+    #
+    # @option params [String] :registry_id
+    #   The AWS account ID associated with the registry that contains the
+    #   repository in which to update the image tag mutability settings. If
+    #   you do not specify a registry, the default registry is assumed.
+    #
+    # @option params [required, String] :repository_name
+    #   The name of the repository in which to update the image tag mutability
+    #   settings.
+    #
+    # @option params [required, String] :image_tag_mutability
+    #   The tag mutability setting for the repository. If `MUTABLE` is
+    #   specified, image tags can be overwritten. If `IMMUTABLE` is specified,
+    #   all image tags within the repository will be immutable which will
+    #   prevent them from being overwritten.
+    #
+    # @return [Types::PutImageTagMutabilityResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::PutImageTagMutabilityResponse#registry_id #registry_id} => String
+    #   * {Types::PutImageTagMutabilityResponse#repository_name #repository_name} => String
+    #   * {Types::PutImageTagMutabilityResponse#image_tag_mutability #image_tag_mutability} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.put_image_tag_mutability({
+    #     registry_id: "RegistryId",
+    #     repository_name: "RepositoryName", # required
+    #     image_tag_mutability: "MUTABLE", # required, accepts MUTABLE, IMMUTABLE
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.registry_id #=> String
+    #   resp.repository_name #=> String
+    #   resp.image_tag_mutability #=> String, one of "MUTABLE", "IMMUTABLE"
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/PutImageTagMutability AWS API Documentation
+    #
+    # @overload put_image_tag_mutability(params = {})
+    # @param [Hash] params ({})
+    def put_image_tag_mutability(params = {}, options = {})
+      req = build_request(:put_image_tag_mutability, params)
+      req.send_request(options)
+    end
+
     # Creates or updates a lifecycle policy. For information about lifecycle
     # policy syntax, see [Lifecycle Policy Template][1].
     #
     #
     #
-    # [1]: http://docs.aws.amazon.com/AmazonECR/latest/userguide/LifecyclePolicies.html
+    # [1]: https://docs.aws.amazon.com/AmazonECR/latest/userguide/LifecyclePolicies.html
     #
     # @option params [String] :registry_id
     #   The AWS account ID associated with the registry that contains the
@@ -1536,7 +1598,12 @@ module Aws::ECR
     end
 
     # Applies a repository policy on a specified repository to control
-    # access permissions.
+    # access permissions. For more information, see [Amazon ECR Repository
+    # Policies][1] in the *Amazon Elastic Container Registry User Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonECR/latest/userguide/RepositoryPolicies.html
     #
     # @option params [String] :registry_id
     #   The AWS account ID associated with the registry that contains the
@@ -1547,7 +1614,13 @@ module Aws::ECR
     #   The name of the repository to receive the policy.
     #
     # @option params [required, String] :policy_text
-    #   The JSON repository policy text to apply to the repository.
+    #   The JSON repository policy text to apply to the repository. For more
+    #   information, see [Amazon ECR Repository Policy Examples][1] in the
+    #   *Amazon Elastic Container Registry User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonECR/latest/userguide/RepositoryPolicyExamples.html
     #
     # @option params [Boolean] :force
     #   If the policy you are attempting to set on a repository policy would
@@ -1772,7 +1845,7 @@ module Aws::ECR
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-ecr'
-      context[:gem_version] = '1.19.0'
+      context[:gem_version] = '1.20.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -73,7 +73,9 @@ module Aws::ECR
     ImageNotFoundException = Shapes::StructureShape.new(name: 'ImageNotFoundException')
     ImageSizeInBytes = Shapes::IntegerShape.new(name: 'ImageSizeInBytes')
     ImageTag = Shapes::StringShape.new(name: 'ImageTag')
+    ImageTagAlreadyExistsException = Shapes::StructureShape.new(name: 'ImageTagAlreadyExistsException')
     ImageTagList = Shapes::ListShape.new(name: 'ImageTagList')
+    ImageTagMutability = Shapes::StringShape.new(name: 'ImageTagMutability')
     InitiateLayerUploadRequest = Shapes::StructureShape.new(name: 'InitiateLayerUploadRequest')
     InitiateLayerUploadResponse = Shapes::StructureShape.new(name: 'InitiateLayerUploadResponse')
     InvalidLayerException = Shapes::StructureShape.new(name: 'InvalidLayerException')
@@ -122,6 +124,8 @@ module Aws::ECR
     PushTimestamp = Shapes::TimestampShape.new(name: 'PushTimestamp')
     PutImageRequest = Shapes::StructureShape.new(name: 'PutImageRequest')
     PutImageResponse = Shapes::StructureShape.new(name: 'PutImageResponse')
+    PutImageTagMutabilityRequest = Shapes::StructureShape.new(name: 'PutImageTagMutabilityRequest')
+    PutImageTagMutabilityResponse = Shapes::StructureShape.new(name: 'PutImageTagMutabilityResponse')
     PutLifecyclePolicyRequest = Shapes::StructureShape.new(name: 'PutLifecyclePolicyRequest')
     PutLifecyclePolicyResponse = Shapes::StructureShape.new(name: 'PutLifecyclePolicyResponse')
     RegistryId = Shapes::StringShape.new(name: 'RegistryId')
@@ -207,6 +211,7 @@ module Aws::ECR
 
     CreateRepositoryRequest.add_member(:repository_name, Shapes::ShapeRef.new(shape: RepositoryName, required: true, location_name: "repositoryName"))
     CreateRepositoryRequest.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "tags"))
+    CreateRepositoryRequest.add_member(:image_tag_mutability, Shapes::ShapeRef.new(shape: ImageTagMutability, location_name: "imageTagMutability"))
     CreateRepositoryRequest.struct_class = Types::CreateRepositoryRequest
 
     CreateRepositoryResponse.add_member(:repository, Shapes::ShapeRef.new(shape: Repository, location_name: "repository"))
@@ -357,6 +362,9 @@ module Aws::ECR
     ImageNotFoundException.add_member(:message, Shapes::ShapeRef.new(shape: ExceptionMessage, location_name: "message"))
     ImageNotFoundException.struct_class = Types::ImageNotFoundException
 
+    ImageTagAlreadyExistsException.add_member(:message, Shapes::ShapeRef.new(shape: ExceptionMessage, location_name: "message"))
+    ImageTagAlreadyExistsException.struct_class = Types::ImageTagAlreadyExistsException
+
     ImageTagList.member = Shapes::ShapeRef.new(shape: ImageTag)
 
     InitiateLayerUploadRequest.add_member(:registry_id, Shapes::ShapeRef.new(shape: RegistryId, location_name: "registryId"))
@@ -473,6 +481,16 @@ module Aws::ECR
     PutImageResponse.add_member(:image, Shapes::ShapeRef.new(shape: Image, location_name: "image"))
     PutImageResponse.struct_class = Types::PutImageResponse
 
+    PutImageTagMutabilityRequest.add_member(:registry_id, Shapes::ShapeRef.new(shape: RegistryId, location_name: "registryId"))
+    PutImageTagMutabilityRequest.add_member(:repository_name, Shapes::ShapeRef.new(shape: RepositoryName, required: true, location_name: "repositoryName"))
+    PutImageTagMutabilityRequest.add_member(:image_tag_mutability, Shapes::ShapeRef.new(shape: ImageTagMutability, required: true, location_name: "imageTagMutability"))
+    PutImageTagMutabilityRequest.struct_class = Types::PutImageTagMutabilityRequest
+
+    PutImageTagMutabilityResponse.add_member(:registry_id, Shapes::ShapeRef.new(shape: RegistryId, location_name: "registryId"))
+    PutImageTagMutabilityResponse.add_member(:repository_name, Shapes::ShapeRef.new(shape: RepositoryName, location_name: "repositoryName"))
+    PutImageTagMutabilityResponse.add_member(:image_tag_mutability, Shapes::ShapeRef.new(shape: ImageTagMutability, location_name: "imageTagMutability"))
+    PutImageTagMutabilityResponse.struct_class = Types::PutImageTagMutabilityResponse
+
     PutLifecyclePolicyRequest.add_member(:registry_id, Shapes::ShapeRef.new(shape: RegistryId, location_name: "registryId"))
     PutLifecyclePolicyRequest.add_member(:repository_name, Shapes::ShapeRef.new(shape: RepositoryName, required: true, location_name: "repositoryName"))
     PutLifecyclePolicyRequest.add_member(:lifecycle_policy_text, Shapes::ShapeRef.new(shape: LifecyclePolicyText, required: true, location_name: "lifecyclePolicyText"))
@@ -488,6 +506,7 @@ module Aws::ECR
     Repository.add_member(:repository_name, Shapes::ShapeRef.new(shape: RepositoryName, location_name: "repositoryName"))
     Repository.add_member(:repository_uri, Shapes::ShapeRef.new(shape: Url, location_name: "repositoryUri"))
     Repository.add_member(:created_at, Shapes::ShapeRef.new(shape: CreationTimestamp, location_name: "createdAt"))
+    Repository.add_member(:image_tag_mutability, Shapes::ShapeRef.new(shape: ImageTagMutability, location_name: "imageTagMutability"))
     Repository.struct_class = Types::Repository
 
     RepositoryAlreadyExistsException.add_member(:message, Shapes::ShapeRef.new(shape: ExceptionMessage, location_name: "message"))
@@ -835,6 +854,18 @@ module Aws::ECR
         o.errors << Shapes::ShapeRef.new(shape: ImageAlreadyExistsException)
         o.errors << Shapes::ShapeRef.new(shape: LayersNotFoundException)
         o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: ImageTagAlreadyExistsException)
+      end)
+
+      api.add_operation(:put_image_tag_mutability, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "PutImageTagMutability"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: PutImageTagMutabilityRequest)
+        o.output = Shapes::ShapeRef.new(shape: PutImageTagMutabilityResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ServerException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o.errors << Shapes::ShapeRef.new(shape: RepositoryNotFoundException)
       end)
 
       api.add_operation(:put_lifecycle_policy, Seahorse::Model::Operation.new.tap do |o|

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

@@ -58,6 +58,22 @@ module Aws::ECR
 
     end
 
+    class ImageTagAlreadyExistsException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::ECR::Types::ImageTagAlreadyExistsException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+
+      # @return [String]
+      def message
+        @message || @data[:message]
+      end
+
+    end
+
     class InvalidLayerException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context

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

@@ -288,6 +288,7 @@ module Aws::ECR
     #             value: "TagValue",
     #           },
     #         ],
+    #         image_tag_mutability: "MUTABLE", # accepts MUTABLE, IMMUTABLE
     #       }
     #
     # @!attribute [rw] repository_name
@@ -298,13 +299,27 @@ module Aws::ECR
     #   @return [String]
     #
     # @!attribute [rw] tags
+    #   The metadata that you apply to the repository to help you categorize
+    #   and organize them. Each tag consists of a key and an optional value,
+    #   both of which you define. Tag keys can have a maximum character
+    #   length of 128 characters, and tag values can have a maximum length
+    #   of 256 characters.
     #   @return [Array<Types::Tag>]
     #
+    # @!attribute [rw] image_tag_mutability
+    #   The tag mutability setting for the repository. If this parameter is
+    #   omitted, the default setting of `MUTABLE` will be used which will
+    #   allow image tags to be overwritten. If `IMMUTABLE` is specified, all
+    #   image tags within the repository will be immutable which will
+    #   prevent them from being overwritten.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/CreateRepositoryRequest AWS API Documentation
     #
     class CreateRepositoryRequest < Struct.new(
       :repository_name,
-      :tags)
+      :tags,
+      :image_tag_mutability)
       include Aws::Structure
     end
 
@@ -509,7 +524,7 @@ module Aws::ECR
     #   @return [String]
     #
     # @!attribute [rw] repository_name
-    #   A list of repositories to describe.
+    #   The repository that contains the images to describe.
     #   @return [String]
     #
     # @!attribute [rw] image_ids
@@ -1121,6 +1136,19 @@ module Aws::ECR
       include Aws::Structure
     end
 
+    # The specified image is tagged with a tag that already exists. The
+    # repository is configured for tag immutability.
+    #
+    # @!attribute [rw] message
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/ImageTagAlreadyExistsException AWS API Documentation
+    #
+    class ImageTagAlreadyExistsException < Struct.new(
+      :message)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass InitiateLayerUploadRequest
     #   data as a hash:
     #
@@ -1474,7 +1502,7 @@ module Aws::ECR
     #
     #
     #
-    # [1]: http://docs.aws.amazon.com/AmazonECR/latest/userguide/service_limits.html
+    # [1]: https://docs.aws.amazon.com/AmazonECR/latest/userguide/service_limits.html
     #
     # @!attribute [rw] message
     #   The error message associated with the exception.
@@ -1673,6 +1701,63 @@ module Aws::ECR
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass PutImageTagMutabilityRequest
+    #   data as a hash:
+    #
+    #       {
+    #         registry_id: "RegistryId",
+    #         repository_name: "RepositoryName", # required
+    #         image_tag_mutability: "MUTABLE", # required, accepts MUTABLE, IMMUTABLE
+    #       }
+    #
+    # @!attribute [rw] registry_id
+    #   The AWS account ID associated with the registry that contains the
+    #   repository in which to update the image tag mutability settings. If
+    #   you do not specify a registry, the default registry is assumed.
+    #   @return [String]
+    #
+    # @!attribute [rw] repository_name
+    #   The name of the repository in which to update the image tag
+    #   mutability settings.
+    #   @return [String]
+    #
+    # @!attribute [rw] image_tag_mutability
+    #   The tag mutability setting for the repository. If `MUTABLE` is
+    #   specified, image tags can be overwritten. If `IMMUTABLE` is
+    #   specified, all image tags within the repository will be immutable
+    #   which will prevent them from being overwritten.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/PutImageTagMutabilityRequest AWS API Documentation
+    #
+    class PutImageTagMutabilityRequest < Struct.new(
+      :registry_id,
+      :repository_name,
+      :image_tag_mutability)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] registry_id
+    #   The registry ID associated with the request.
+    #   @return [String]
+    #
+    # @!attribute [rw] repository_name
+    #   The repository name associated with the request.
+    #   @return [String]
+    #
+    # @!attribute [rw] image_tag_mutability
+    #   The image tag mutability setting for the repository.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/PutImageTagMutabilityResponse AWS API Documentation
+    #
+    class PutImageTagMutabilityResponse < Struct.new(
+      :registry_id,
+      :repository_name,
+      :image_tag_mutability)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass PutLifecyclePolicyRequest
     #   data as a hash:
     #
@@ -1755,6 +1840,10 @@ module Aws::ECR
     #   was created.
     #   @return [Time]
     #
+    # @!attribute [rw] image_tag_mutability
+    #   The tag mutability setting for the repository.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/Repository AWS API Documentation
     #
     class Repository < Struct.new(
@@ -1762,7 +1851,8 @@ module Aws::ECR
       :registry_id,
       :repository_name,
       :repository_uri,
-      :created_at)
+      :created_at,
+      :image_tag_mutability)
       include Aws::Structure
     end
 
@@ -1857,7 +1947,13 @@ module Aws::ECR
     #   @return [String]
     #
     # @!attribute [rw] policy_text
-    #   The JSON repository policy text to apply to the repository.
+    #   The JSON repository policy text to apply to the repository. For more
+    #   information, see [Amazon ECR Repository Policy Examples][1] in the
+    #   *Amazon Elastic Container Registry User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonECR/latest/userguide/RepositoryPolicyExamples.html
     #   @return [String]
     #
     # @!attribute [rw] force

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-ecr
 version: !ruby/object:Gem::Version
-  version: 1.19.0
+  version: 1.20.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-07-01 00:00:00.000000000 Z
+date: 2019-07-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.58.0
+        version: 3.61.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.58.0
+        version: 3.61.1
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement