lib/aws-sdk-ecr/client.rb in aws-sdk-ecr-1.9.0 vs lib/aws-sdk-ecr/client.rb in aws-sdk-ecr-1.10.0

- old
+ new

@@ -520,10 +520,12 @@ # The name to use for the repository. The repository name may be # specified on its own (such as `nginx-web-app`) or it can be prepended # with a namespace to group the repository into a category (such as # `project-a/nginx-web-app`). # + # @option params [Array<Types::Tag>] :tags + # # @return [Types::CreateRepositoryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::CreateRepositoryResponse#repository #repository} => Types::Repository # # @@ -547,10 +549,16 @@ # # @example Request syntax with placeholder values # # resp = client.create_repository({ # repository_name: "RepositoryName", # required + # tags: [ + # { + # key: "TagKey", + # value: "TagValue", + # }, + # ], # }) # # @example Response structure # # resp.repository.repository_arn #=> String @@ -741,12 +749,11 @@ # The AWS account ID associated with the registry that contains the # repository in which to describe images. If you do not specify a # registry, the default registry is assumed. # # @option params [required, String] :repository_name - # A list of repositories to describe. If this parameter is omitted, then - # all repositories in a registry are described. + # A list of repositories to describe. # # @option params [Array<Types::ImageIdentifier>] :image_ids # The list of image IDs for the requested repository. # # @option params [String] :next_token @@ -761,11 +768,11 @@ # The maximum number of repository results returned by `DescribeImages` # in paginated output. When this parameter is used, `DescribeImages` # only returns `maxResults` results in a single page along with a # `nextToken` response element. The remaining results of the initial # request can be seen by sending another `DescribeImages` request with - # the returned `nextToken` value. This value can be between 1 and 100. + # the returned `nextToken` value. This value can be between 1 and 1000. # If this parameter is not used, then `DescribeImages` returns up to 100 # results and a `nextToken` value, if applicable. This option cannot be # used when you specify images with `imageIds`. # # @option params [Types::DescribeImagesFilter] :filter @@ -789,11 +796,11 @@ # }, # ], # next_token: "NextToken", # max_results: 1, # filter: { - # tag_status: "TAGGED", # accepts TAGGED, UNTAGGED + # tag_status: "TAGGED", # accepts TAGGED, UNTAGGED, ANY # }, # }) # # @example Response structure # @@ -847,11 +854,11 @@ # `DescribeRepositories` in paginated output. When this parameter is # used, `DescribeRepositories` only returns `maxResults` results in a # single page along with a `nextToken` response element. The remaining # results of the initial request can be seen by sending another # `DescribeRepositories` request with the returned `nextToken` value. - # This value can be between 1 and 100. If this parameter is not used, + # This value can be between 1 and 1000. If this parameter is not used, # then `DescribeRepositories` returns up to 100 results and a # `nextToken` value, if applicable. This option cannot be used when you # specify repositories with `repositoryNames`. # # @return [Types::DescribeRepositoriesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods: @@ -1090,11 +1097,11 @@ # parameter is used, `GetLifecyclePolicyPreviewRequest` only returns
 # `maxResults` results in a single page along with a `nextToken`
 # response element. The remaining results of the initial request can be # seen by sending
 another `GetLifecyclePolicyPreviewRequest` request # with the returned `nextToken`
 value. This value can be between 1 and - # 100. If this
 parameter is not used, then + # 1000. If this
 parameter is not used, then # `GetLifecyclePolicyPreviewRequest` returns up to
 100 results and a # `nextToken` value, if
 applicable. This option cannot be used when you # specify images with `imageIds`. # # @option params [Types::LifecyclePolicyPreviewFilter] :filter @@ -1123,11 +1130,11 @@ # }, # ], # next_token: "NextToken", # max_results: 1, # filter: { - # tag_status: "TAGGED", # accepts TAGGED, UNTAGGED + # tag_status: "TAGGED", # accepts TAGGED, UNTAGGED, ANY # }, # }) # # @example Response structure # @@ -1284,11 +1291,11 @@ # The maximum number of image results returned by `ListImages` in # paginated output. When this parameter is used, `ListImages` only # returns `maxResults` results in a single page along with a `nextToken` # response element. The remaining results of the initial request can be # seen by sending another `ListImages` request with the returned - # `nextToken` value. This value can be between 1 and 100. If this + # `nextToken` value. This value can be between 1 and 1000. If this # parameter is not used, then `ListImages` returns up to 100 results and # a `nextToken` value, if applicable. # # @option params [Types::ListImagesFilter] :filter # The filter key and value with which to filter your `ListImages` @@ -1324,11 +1331,11 @@ # registry_id: "RegistryId", # repository_name: "RepositoryName", # required # next_token: "NextToken", # max_results: 1, # filter: { - # tag_status: "TAGGED", # accepts TAGGED, UNTAGGED + # tag_status: "TAGGED", # accepts TAGGED, UNTAGGED, ANY # }, # }) # # @example Response structure # @@ -1344,10 +1351,42 @@ def list_images(params = {}, options = {}) req = build_request(:list_images, params) req.send_request(options) end + # List the tags for an Amazon ECR resource. + # + # @option params [required, String] :resource_arn + # The Amazon Resource Name (ARN) that identifies the resource for which + # to list the tags. Currently, the only supported resource is an Amazon + # ECR repository. + # + # @return [Types::ListTagsForResourceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods: + # + # * {Types::ListTagsForResourceResponse#tags #tags} => Array&lt;Types::Tag&gt; + # + # @example Request syntax with placeholder values + # + # resp = client.list_tags_for_resource({ + # resource_arn: "Arn", # required + # }) + # + # @example Response structure + # + # resp.tags #=> Array + # resp.tags[0].key #=> String + # resp.tags[0].value #=> String + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/ListTagsForResource AWS API Documentation + # + # @overload list_tags_for_resource(params = {}) + # @param [Hash] params ({}) + def list_tags_for_resource(params = {}, options = {}) + req = build_request(:list_tags_for_resource, params) + req.send_request(options) + end + # Creates or updates the image manifest and tags associated with an # image. # # <note markdown="1"> This operation is used by the Amazon ECR proxy, and it is not intended # for general use by customers for pulling and pushing images. In most @@ -1541,10 +1580,75 @@ def start_lifecycle_policy_preview(params = {}, options = {}) req = build_request(:start_lifecycle_policy_preview, params) req.send_request(options) end + # Adds specified tags to a resource with the specified ARN. Existing + # tags on a resource are not changed if they are not specified in the + # request parameters. + # + # @option params [required, String] :resource_arn + # The Amazon Resource Name (ARN) of the the resource to which to add + # tags. Currently, the only supported resource is an Amazon ECR + # repository. + # + # @option params [required, Array<Types::Tag>] :tags + # The tags to add to the resource. A tag is an array of key-value pairs. + # Tag keys can have a maximum character length of 128 characters, and + # tag values can have a maximum length of 256 characters. + # + # @return [Struct] Returns an empty {Seahorse::Client::Response response}. + # + # @example Request syntax with placeholder values + # + # resp = client.tag_resource({ + # resource_arn: "Arn", # required + # tags: [ # required + # { + # key: "TagKey", + # value: "TagValue", + # }, + # ], + # }) + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/TagResource AWS API Documentation + # + # @overload tag_resource(params = {}) + # @param [Hash] params ({}) + def tag_resource(params = {}, options = {}) + req = build_request(:tag_resource, params) + req.send_request(options) + end + + # Deletes specified tags from a resource. + # + # @option params [required, String] :resource_arn + # The Amazon Resource Name (ARN) of the resource from which to remove + # tags. Currently, the only supported resource is an Amazon ECR + # repository. + # + # @option params [required, Array<String>] :tag_keys + # The keys of the tags to be removed. + # + # @return [Struct] Returns an empty {Seahorse::Client::Response response}. + # + # @example Request syntax with placeholder values + # + # resp = client.untag_resource({ + # resource_arn: "Arn", # required + # tag_keys: ["TagKey"], # required + # }) + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/UntagResource AWS API Documentation + # + # @overload untag_resource(params = {}) + # @param [Hash] params ({}) + def untag_resource(params = {}, options = {}) + req = build_request(:untag_resource, params) + req.send_request(options) + end + # Uploads an image layer part to Amazon ECR. # # <note markdown="1"> This operation is used by the Amazon ECR proxy, and it is not intended # for general use by customers for pulling and pushing images. In most # cases, you should use the `docker` CLI to pull, tag, and push images. @@ -1617,10 +1721,10 @@ operation: config.api.operation(operation_name), client: self, params: params, config: config) context[:gem_name] = 'aws-sdk-ecr' - context[:gem_version] = '1.9.0' + context[:gem_version] = '1.10.0' Seahorse::Client::Request.new(handlers, context) end # @api private # @deprecated