aws-sdk-codecommit 1.0.0.rc1 → 1.0.0.rc2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: 934b1e42b1198e74266c712e959edd4a773280d4
4
- data.tar.gz: 378170d9657c81278350464b5fad4d6ab55394ca
3
+ metadata.gz: 236e5ba573ce1bdce276943428ba031ffecabb21
4
+ data.tar.gz: 4da92a3e807c39af77b12c6bd0482e3ebf1a9dbf
5
5
  SHA512:
6
- metadata.gz: 155460e210b00cdbef0dc058dfaf319ce660fc59945ff8ba9891131133f2c07b7c59e2ec76fce96be4b2049e01b3917b40dda8ab85b75019dd8b2c41794ff773
7
- data.tar.gz: 57f3991729362e4a6007aa67facc87c45aa9b980e2b2dba43246bb3bd0ecccbdd4c00c6f60c344f9d20e1e75b6fe39bb17f882075ab5e3317f5211d3c30c2dfb
6
+ metadata.gz: 064bc952085e39b88658fcc9a7fb87af06050173191fdf10f54c19a6d77a60c682e5fd7f4304f2d7de45d4197434b34666172aed2587ca5717ef43a578cf63da
7
+ data.tar.gz: 171ddd00aa7f138b1714ab8a25eb2e5de8c0f789700235e189385070d8831a42f2f0f8080306ecd3ec9003c8eb764febf3667a9736bf356a9373c5300fe1bcbe
@@ -1,6 +1,6 @@
1
1
  # WARNING ABOUT GENERATED CODE
2
2
  #
3
- # This file is generated. See the contributing for info on making contributions:
3
+ # This file is generated. See the contributing guide for more information:
4
4
  # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
5
5
  #
6
6
  # WARNING ABOUT GENERATED CODE
@@ -1,6 +1,6 @@
1
1
  # WARNING ABOUT GENERATED CODE
2
2
  #
3
- # This file is generated. See the contributing for info on making contributions:
3
+ # This file is generated. See the contributing guide for more information:
4
4
  # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
5
5
  #
6
6
  # WARNING ABOUT GENERATED CODE
@@ -23,658 +23,859 @@ require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
23
23
 
24
24
  Aws::Plugins::GlobalConfiguration.add_identifier(:codecommit)
25
25
 
26
- module Aws
27
- module CodeCommit
28
- class Client < Seahorse::Client::Base
29
-
30
- include Aws::ClientStubs
31
-
32
- @identifier = :codecommit
33
-
34
- set_api(ClientApi::API)
35
-
36
- add_plugin(Seahorse::Client::Plugins::ContentLength)
37
- add_plugin(Aws::Plugins::CredentialsConfiguration)
38
- add_plugin(Aws::Plugins::Logging)
39
- add_plugin(Aws::Plugins::ParamConverter)
40
- add_plugin(Aws::Plugins::ParamValidator)
41
- add_plugin(Aws::Plugins::UserAgent)
42
- add_plugin(Aws::Plugins::HelpfulSocketErrors)
43
- add_plugin(Aws::Plugins::RetryErrors)
44
- add_plugin(Aws::Plugins::GlobalConfiguration)
45
- add_plugin(Aws::Plugins::RegionalEndpoint)
46
- add_plugin(Aws::Plugins::ResponsePaging)
47
- add_plugin(Aws::Plugins::StubResponses)
48
- add_plugin(Aws::Plugins::IdempotencyToken)
49
- add_plugin(Aws::Plugins::SignatureV4)
50
- add_plugin(Aws::Plugins::Protocols::JsonRpc)
51
-
52
- # @option options [required, Aws::CredentialProvider] :credentials
53
- # Your AWS credentials. This can be an instance of any one of the
54
- # following classes:
55
- #
56
- # * `Aws::Credentials` - Used for configuring static, non-refreshing
57
- # credentials.
58
- #
59
- # * `Aws::InstanceProfileCredentials` - Used for loading credentials
60
- # from an EC2 IMDS on an EC2 instance.
61
- #
62
- # * `Aws::SharedCredentials` - Used for loading credentials from a
63
- # shared file, such as `~/.aws/config`.
64
- #
65
- # * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
66
- #
67
- # When `:credentials` are not configured directly, the following
68
- # locations will be searched for credentials:
69
- #
70
- # * `Aws.config[:credentials]`
71
- # * The `:access_key_id`, `:secret_access_key`, and `:session_token` options.
72
- # * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
73
- # * `~/.aws/credentials`
74
- # * `~/.aws/config`
75
- # * EC2 IMDS instance profile - When used by default, the timeouts are
76
- # very aggressive. Construct and pass an instance of
77
- # `Aws::InstanceProfileCredentails` to enable retries and extended
78
- # timeouts.
79
- # @option options [required, String] :region
80
- # The AWS region to connect to. The configured `:region` is
81
- # used to determine the service `:endpoint`. When not passed,
82
- # a default `:region` is search for in the following locations:
83
- #
84
- # * `Aws.config[:region]`
85
- # * `ENV['AWS_REGION']`
86
- # * `ENV['AMAZON_REGION']`
87
- # * `ENV['AWS_DEFAULT_REGION']`
88
- # * `~/.aws/credentials`
89
- # * `~/.aws/config`
90
- # @option options [String] :access_key_id
91
- # @option options [Boolean] :convert_params (true)
92
- # When `true`, an attempt is made to coerce request parameters into
93
- # the required types.
94
- # @option options [String] :endpoint
95
- # The client endpoint is normally constructed from the `:region`
96
- # option. You should only configure an `:endpoint` when connecting
97
- # to test endpoints. This should be avalid HTTP(S) URI.
98
- # @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
99
- # The log formatter.
100
- # @option options [Symbol] :log_level (:info)
101
- # The log level to send messages to the `:logger` at.
102
- # @option options [Logger] :logger
103
- # The Logger instance to send log messages to. If this option
104
- # is not set, logging will be disabled.
105
- # @option options [String] :profile ("default")
106
- # Used when loading credentials from the shared credentials file
107
- # at HOME/.aws/credentials. When not specified, 'default' is used.
108
- # @option options [Integer] :retry_limit (3)
109
- # The maximum number of times to retry failed requests. Only
110
- # ~ 500 level server errors and certain ~ 400 level client errors
111
- # are retried. Generally, these are throttling errors, data
112
- # checksum errors, networking errors, timeout errors and auth
113
- # errors from expired credentials.
114
- # @option options [String] :secret_access_key
115
- # @option options [String] :session_token
116
- # @option options [Boolean] :simple_json (false)
117
- # Disables request parameter conversion, validation, and formatting.
118
- # Also disable response data type conversions. This option is useful
119
- # when you want to ensure the highest level of performance by
120
- # avoiding overhead of walking request parameters and response data
121
- # structures.
122
- #
123
- # When `:simple_json` is enabled, the request parameters hash must
124
- # be formatted exactly as the DynamoDB API expects.
125
- # @option options [Boolean] :stub_responses (false)
126
- # Causes the client to return stubbed responses. By default
127
- # fake responses are generated and returned. You can specify
128
- # the response data to return or errors to raise by calling
129
- # {ClientStubs#stub_responses}. See {ClientStubs} for more information.
130
- #
131
- # ** Please note ** When response stubbing is enabled, no HTTP
132
- # requests are made, and retries are disabled.
133
- # @option options [Boolean] :validate_params (true)
134
- # When `true`, request parameters are validated before
135
- # sending the request.
136
- def initialize(*args)
137
- super
138
- end
26
+ module Aws::CodeCommit
27
+ class Client < Seahorse::Client::Base
139
28
 
140
- # @!group API Operations
141
-
142
- # Returns information about one or more repositories.
143
- #
144
- # <note markdown="1">The description field for a repository accepts all HTML characters and
145
- # all valid Unicode characters. Applications that do not HTML-encode the
146
- # description and display it in a web page could expose users to
147
- # potentially malicious code. Make sure that you HTML-encode the
148
- # description field in any application that uses this API to display the
149
- # repository description on a web page.
150
- #
151
- # </note>
152
- # @option params [required, Array<String>] :repository_names
153
- # The names of the repositories to get information about.
154
- # @return [Types::BatchGetRepositoriesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
155
- #
156
- # * {Types::BatchGetRepositoriesOutput#repositories #repositories} => Array&lt;Types::RepositoryMetadata&gt;
157
- # * {Types::BatchGetRepositoriesOutput#repositories_not_found #repositoriesNotFound} => Array&lt;String&gt;
158
- #
159
- # @example Request syntax with placeholder values
160
- # resp = client.batch_get_repositories({
161
- # repository_names: ["RepositoryName"], # required
162
- # })
163
- #
164
- # @example Response structure
165
- # resp.repositories #=> Array
166
- # resp.repositories[0].account_id #=> String
167
- # resp.repositories[0].repository_id #=> String
168
- # resp.repositories[0].repository_name #=> String
169
- # resp.repositories[0].repository_description #=> String
170
- # resp.repositories[0].default_branch #=> String
171
- # resp.repositories[0].last_modified_date #=> Time
172
- # resp.repositories[0].creation_date #=> Time
173
- # resp.repositories[0].clone_url_http #=> String
174
- # resp.repositories[0].clone_url_ssh #=> String
175
- # resp.repositories[0].arn #=> String
176
- # resp.repositories_not_found #=> Array
177
- # resp.repositories_not_found[0] #=> String
178
- # @overload batch_get_repositories(params = {})
179
- # @param [Hash] params ({})
180
- def batch_get_repositories(params = {}, options = {})
181
- req = build_request(:batch_get_repositories, params)
182
- req.send_request(options)
183
- end
29
+ include Aws::ClientStubs
184
30
 
185
- # Creates a new branch in a repository and points the branch to a
186
- # commit.
187
- #
188
- # <note markdown="1">Calling the create branch operation does not set a repository's
189
- # default branch. To do this, call the update default branch operation.
190
- #
191
- # </note>
192
- # @option params [required, String] :repository_name
193
- # The name of the repository in which you want to create the new branch.
194
- # @option params [required, String] :branch_name
195
- # The name of the new branch to create.
196
- # @option params [required, String] :commit_id
197
- # The ID of the commit to point the new branch to.
198
- # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
199
- #
200
- # @example Request syntax with placeholder values
201
- # resp = client.create_branch({
202
- # repository_name: "RepositoryName", # required
203
- # branch_name: "BranchName", # required
204
- # commit_id: "CommitId", # required
205
- # })
206
- # @overload create_branch(params = {})
207
- # @param [Hash] params ({})
208
- def create_branch(params = {}, options = {})
209
- req = build_request(:create_branch, params)
210
- req.send_request(options)
211
- end
31
+ @identifier = :codecommit
212
32
 
213
- # Creates a new, empty repository.
214
- # @option params [required, String] :repository_name
215
- # The name of the new repository to be created.
216
- #
217
- # <note markdown="1">The repository name must be unique across the calling AWS account. In
218
- # addition, repository names are limited to 100 alphanumeric, dash, and
219
- # underscore characters, and cannot include certain characters. For a
220
- # full description of the limits on repository names, see [Limits][1] in
221
- # the AWS CodeCommit User Guide. The suffix ".git" is prohibited.
222
- #
223
- # </note>
224
- #
225
- #
226
- #
227
- # [1]: http://docs.aws.amazon.com/codecommit/latest/userguide/limits.html
228
- # @option params [String] :repository_description
229
- # A comment or description about the new repository.
230
- #
231
- # <note markdown="1">The description field for a repository accepts all HTML characters and
232
- # all valid Unicode characters. Applications that do not HTML-encode the
233
- # description and display it in a web page could expose users to
234
- # potentially malicious code. Make sure that you HTML-encode the
235
- # description field in any application that uses this API to display the
236
- # repository description on a web page.
237
- #
238
- # </note>
239
- # @return [Types::CreateRepositoryOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
240
- #
241
- # * {Types::CreateRepositoryOutput#repository_metadata #repositoryMetadata} => Types::RepositoryMetadata
242
- #
243
- # @example Request syntax with placeholder values
244
- # resp = client.create_repository({
245
- # repository_name: "RepositoryName", # required
246
- # repository_description: "RepositoryDescription",
247
- # })
248
- #
249
- # @example Response structure
250
- # resp.repository_metadata.account_id #=> String
251
- # resp.repository_metadata.repository_id #=> String
252
- # resp.repository_metadata.repository_name #=> String
253
- # resp.repository_metadata.repository_description #=> String
254
- # resp.repository_metadata.default_branch #=> String
255
- # resp.repository_metadata.last_modified_date #=> Time
256
- # resp.repository_metadata.creation_date #=> Time
257
- # resp.repository_metadata.clone_url_http #=> String
258
- # resp.repository_metadata.clone_url_ssh #=> String
259
- # resp.repository_metadata.arn #=> String
260
- # @overload create_repository(params = {})
261
- # @param [Hash] params ({})
262
- def create_repository(params = {}, options = {})
263
- req = build_request(:create_repository, params)
264
- req.send_request(options)
265
- end
33
+ set_api(ClientApi::API)
266
34
 
267
- # Deletes a repository. If a specified repository was already deleted, a
268
- # null repository ID will be returned.
269
- #
270
- # Deleting a repository also deletes all associated objects and
271
- # metadata. After a repository is deleted, all future push calls to the
272
- # deleted repository will fail.
273
- # @option params [required, String] :repository_name
274
- # The name of the repository to delete.
275
- # @return [Types::DeleteRepositoryOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
276
- #
277
- # * {Types::DeleteRepositoryOutput#repository_id #repositoryId} => String
278
- #
279
- # @example Request syntax with placeholder values
280
- # resp = client.delete_repository({
281
- # repository_name: "RepositoryName", # required
282
- # })
283
- #
284
- # @example Response structure
285
- # resp.repository_id #=> String
286
- # @overload delete_repository(params = {})
287
- # @param [Hash] params ({})
288
- def delete_repository(params = {}, options = {})
289
- req = build_request(:delete_repository, params)
290
- req.send_request(options)
291
- end
35
+ add_plugin(Seahorse::Client::Plugins::ContentLength)
36
+ add_plugin(Aws::Plugins::CredentialsConfiguration)
37
+ add_plugin(Aws::Plugins::Logging)
38
+ add_plugin(Aws::Plugins::ParamConverter)
39
+ add_plugin(Aws::Plugins::ParamValidator)
40
+ add_plugin(Aws::Plugins::UserAgent)
41
+ add_plugin(Aws::Plugins::HelpfulSocketErrors)
42
+ add_plugin(Aws::Plugins::RetryErrors)
43
+ add_plugin(Aws::Plugins::GlobalConfiguration)
44
+ add_plugin(Aws::Plugins::RegionalEndpoint)
45
+ add_plugin(Aws::Plugins::ResponsePaging)
46
+ add_plugin(Aws::Plugins::StubResponses)
47
+ add_plugin(Aws::Plugins::IdempotencyToken)
48
+ add_plugin(Aws::Plugins::SignatureV4)
49
+ add_plugin(Aws::Plugins::Protocols::JsonRpc)
292
50
 
293
- # Returns information about a repository branch, including its name and
294
- # the last commit ID.
295
- # @option params [String] :repository_name
296
- # The name of the repository that contains the branch for which you want
297
- # to retrieve information.
298
- # @option params [String] :branch_name
299
- # The name of the branch for which you want to retrieve information.
300
- # @return [Types::GetBranchOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
301
- #
302
- # * {Types::GetBranchOutput#branch #branch} => Types::BranchInfo
303
- #
304
- # @example Request syntax with placeholder values
305
- # resp = client.get_branch({
306
- # repository_name: "RepositoryName",
307
- # branch_name: "BranchName",
308
- # })
309
- #
310
- # @example Response structure
311
- # resp.branch.branch_name #=> String
312
- # resp.branch.commit_id #=> String
313
- # @overload get_branch(params = {})
314
- # @param [Hash] params ({})
315
- def get_branch(params = {}, options = {})
316
- req = build_request(:get_branch, params)
317
- req.send_request(options)
318
- end
51
+ # @option options [required, Aws::CredentialProvider] :credentials
52
+ # Your AWS credentials. This can be an instance of any one of the
53
+ # following classes:
54
+ #
55
+ # * `Aws::Credentials` - Used for configuring static, non-refreshing
56
+ # credentials.
57
+ #
58
+ # * `Aws::InstanceProfileCredentials` - Used for loading credentials
59
+ # from an EC2 IMDS on an EC2 instance.
60
+ #
61
+ # * `Aws::SharedCredentials` - Used for loading credentials from a
62
+ # shared file, such as `~/.aws/config`.
63
+ #
64
+ # * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
65
+ #
66
+ # When `:credentials` are not configured directly, the following
67
+ # locations will be searched for credentials:
68
+ #
69
+ # * `Aws.config[:credentials]`
70
+ # * The `:access_key_id`, `:secret_access_key`, and `:session_token` options.
71
+ # * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
72
+ # * `~/.aws/credentials`
73
+ # * `~/.aws/config`
74
+ # * EC2 IMDS instance profile - When used by default, the timeouts are
75
+ # very aggressive. Construct and pass an instance of
76
+ # `Aws::InstanceProfileCredentails` to enable retries and extended
77
+ # timeouts.
78
+ #
79
+ # @option options [required, String] :region
80
+ # The AWS region to connect to. The configured `:region` is
81
+ # used to determine the service `:endpoint`. When not passed,
82
+ # a default `:region` is search for in the following locations:
83
+ #
84
+ # * `Aws.config[:region]`
85
+ # * `ENV['AWS_REGION']`
86
+ # * `ENV['AMAZON_REGION']`
87
+ # * `ENV['AWS_DEFAULT_REGION']`
88
+ # * `~/.aws/credentials`
89
+ # * `~/.aws/config`
90
+ #
91
+ # @option options [String] :access_key_id
92
+ #
93
+ # @option options [Boolean] :convert_params (true)
94
+ # When `true`, an attempt is made to coerce request parameters into
95
+ # the required types.
96
+ #
97
+ # @option options [String] :endpoint
98
+ # The client endpoint is normally constructed from the `:region`
99
+ # option. You should only configure an `:endpoint` when connecting
100
+ # to test endpoints. This should be avalid HTTP(S) URI.
101
+ #
102
+ # @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
103
+ # The log formatter.
104
+ #
105
+ # @option options [Symbol] :log_level (:info)
106
+ # The log level to send messages to the `:logger` at.
107
+ #
108
+ # @option options [Logger] :logger
109
+ # The Logger instance to send log messages to. If this option
110
+ # is not set, logging will be disabled.
111
+ #
112
+ # @option options [String] :profile ("default")
113
+ # Used when loading credentials from the shared credentials file
114
+ # at HOME/.aws/credentials. When not specified, 'default' is used.
115
+ #
116
+ # @option options [Integer] :retry_limit (3)
117
+ # The maximum number of times to retry failed requests. Only
118
+ # ~ 500 level server errors and certain ~ 400 level client errors
119
+ # are retried. Generally, these are throttling errors, data
120
+ # checksum errors, networking errors, timeout errors and auth
121
+ # errors from expired credentials.
122
+ #
123
+ # @option options [String] :secret_access_key
124
+ #
125
+ # @option options [String] :session_token
126
+ #
127
+ # @option options [Boolean] :simple_json (false)
128
+ # Disables request parameter conversion, validation, and formatting.
129
+ # Also disable response data type conversions. This option is useful
130
+ # when you want to ensure the highest level of performance by
131
+ # avoiding overhead of walking request parameters and response data
132
+ # structures.
133
+ #
134
+ # When `:simple_json` is enabled, the request parameters hash must
135
+ # be formatted exactly as the DynamoDB API expects.
136
+ #
137
+ # @option options [Boolean] :stub_responses (false)
138
+ # Causes the client to return stubbed responses. By default
139
+ # fake responses are generated and returned. You can specify
140
+ # the response data to return or errors to raise by calling
141
+ # {ClientStubs#stub_responses}. See {ClientStubs} for more information.
142
+ #
143
+ # ** Please note ** When response stubbing is enabled, no HTTP
144
+ # requests are made, and retries are disabled.
145
+ #
146
+ # @option options [Boolean] :validate_params (true)
147
+ # When `true`, request parameters are validated before
148
+ # sending the request.
149
+ #
150
+ def initialize(*args)
151
+ super
152
+ end
319
153
 
320
- # Returns information about a commit, including commit message and
321
- # committer information.
322
- # @option params [required, String] :repository_name
323
- # The name of the repository to which the commit was made.
324
- # @option params [required, String] :commit_id
325
- # The commit ID.
326
- # @return [Types::GetCommitOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
327
- #
328
- # * {Types::GetCommitOutput#commit #commit} => Types::Commit
329
- #
330
- # @example Request syntax with placeholder values
331
- # resp = client.get_commit({
332
- # repository_name: "RepositoryName", # required
333
- # commit_id: "ObjectId", # required
334
- # })
335
- #
336
- # @example Response structure
337
- # resp.commit.tree_id #=> String
338
- # resp.commit.parents #=> Array
339
- # resp.commit.parents[0] #=> String
340
- # resp.commit.message #=> String
341
- # resp.commit.author.name #=> String
342
- # resp.commit.author.email #=> String
343
- # resp.commit.author.date #=> String
344
- # resp.commit.committer.name #=> String
345
- # resp.commit.committer.email #=> String
346
- # resp.commit.committer.date #=> String
347
- # resp.commit.additional_data #=> String
348
- # @overload get_commit(params = {})
349
- # @param [Hash] params ({})
350
- def get_commit(params = {}, options = {})
351
- req = build_request(:get_commit, params)
352
- req.send_request(options)
353
- end
154
+ # @!group API Operations
354
155
 
355
- # Returns information about a repository.
356
- #
357
- # <note markdown="1">The description field for a repository accepts all HTML characters and
358
- # all valid Unicode characters. Applications that do not HTML-encode the
359
- # description and display it in a web page could expose users to
360
- # potentially malicious code. Make sure that you HTML-encode the
361
- # description field in any application that uses this API to display the
362
- # repository description on a web page.
363
- #
364
- # </note>
365
- # @option params [required, String] :repository_name
366
- # The name of the repository to get information about.
367
- # @return [Types::GetRepositoryOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
368
- #
369
- # * {Types::GetRepositoryOutput#repository_metadata #repositoryMetadata} => Types::RepositoryMetadata
370
- #
371
- # @example Request syntax with placeholder values
372
- # resp = client.get_repository({
373
- # repository_name: "RepositoryName", # required
374
- # })
375
- #
376
- # @example Response structure
377
- # resp.repository_metadata.account_id #=> String
378
- # resp.repository_metadata.repository_id #=> String
379
- # resp.repository_metadata.repository_name #=> String
380
- # resp.repository_metadata.repository_description #=> String
381
- # resp.repository_metadata.default_branch #=> String
382
- # resp.repository_metadata.last_modified_date #=> Time
383
- # resp.repository_metadata.creation_date #=> Time
384
- # resp.repository_metadata.clone_url_http #=> String
385
- # resp.repository_metadata.clone_url_ssh #=> String
386
- # resp.repository_metadata.arn #=> String
387
- # @overload get_repository(params = {})
388
- # @param [Hash] params ({})
389
- def get_repository(params = {}, options = {})
390
- req = build_request(:get_repository, params)
391
- req.send_request(options)
392
- end
156
+ # Returns information about one or more repositories.
157
+ #
158
+ # <note markdown="1"> The description field for a repository accepts all HTML characters and
159
+ # all valid Unicode characters. Applications that do not HTML-encode the
160
+ # description and display it in a web page could expose users to
161
+ # potentially malicious code. Make sure that you HTML-encode the
162
+ # description field in any application that uses this API to display the
163
+ # repository description on a web page.
164
+ #
165
+ # </note>
166
+ #
167
+ # @option params [required, Array<String>] :repository_names
168
+ # The names of the repositories to get information about.
169
+ #
170
+ # @return [Types::BatchGetRepositoriesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
171
+ #
172
+ # * {Types::BatchGetRepositoriesOutput#repositories #repositories} => Array&lt;Types::RepositoryMetadata&gt;
173
+ # * {Types::BatchGetRepositoriesOutput#repositories_not_found #repositories_not_found} => Array&lt;String&gt;
174
+ #
175
+ # @example Request syntax with placeholder values
176
+ #
177
+ # resp = client.batch_get_repositories({
178
+ # repository_names: ["RepositoryName"], # required
179
+ # })
180
+ #
181
+ # @example Response structure
182
+ #
183
+ # resp.repositories #=> Array
184
+ # resp.repositories[0].account_id #=> String
185
+ # resp.repositories[0].repository_id #=> String
186
+ # resp.repositories[0].repository_name #=> String
187
+ # resp.repositories[0].repository_description #=> String
188
+ # resp.repositories[0].default_branch #=> String
189
+ # resp.repositories[0].last_modified_date #=> Time
190
+ # resp.repositories[0].creation_date #=> Time
191
+ # resp.repositories[0].clone_url_http #=> String
192
+ # resp.repositories[0].clone_url_ssh #=> String
193
+ # resp.repositories[0].arn #=> String
194
+ # resp.repositories_not_found #=> Array
195
+ # resp.repositories_not_found[0] #=> String
196
+ #
197
+ # @overload batch_get_repositories(params = {})
198
+ # @param [Hash] params ({})
199
+ def batch_get_repositories(params = {}, options = {})
200
+ req = build_request(:batch_get_repositories, params)
201
+ req.send_request(options)
202
+ end
393
203
 
394
- # Gets information about triggers configured for a repository.
395
- # @option params [String] :repository_name
396
- # The name of the repository for which the trigger is configured.
397
- # @return [Types::GetRepositoryTriggersOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
398
- #
399
- # * {Types::GetRepositoryTriggersOutput#configuration_id #configurationId} => String
400
- # * {Types::GetRepositoryTriggersOutput#triggers #triggers} => Array&lt;Types::RepositoryTrigger&gt;
401
- #
402
- # @example Request syntax with placeholder values
403
- # resp = client.get_repository_triggers({
404
- # repository_name: "RepositoryName",
405
- # })
406
- #
407
- # @example Response structure
408
- # resp.configuration_id #=> String
409
- # resp.triggers #=> Array
410
- # resp.triggers[0].name #=> String
411
- # resp.triggers[0].destination_arn #=> String
412
- # resp.triggers[0].custom_data #=> String
413
- # resp.triggers[0].branches #=> Array
414
- # resp.triggers[0].branches[0] #=> String
415
- # resp.triggers[0].events #=> Array
416
- # resp.triggers[0].events[0] #=> String, one of "all", "updateReference", "createReference", "deleteReference"
417
- # @overload get_repository_triggers(params = {})
418
- # @param [Hash] params ({})
419
- def get_repository_triggers(params = {}, options = {})
420
- req = build_request(:get_repository_triggers, params)
421
- req.send_request(options)
422
- end
204
+ # Creates a new branch in a repository and points the branch to a
205
+ # commit.
206
+ #
207
+ # <note markdown="1"> Calling the create branch operation does not set a repository's
208
+ # default branch. To do this, call the update default branch operation.
209
+ #
210
+ # </note>
211
+ #
212
+ # @option params [required, String] :repository_name
213
+ # The name of the repository in which you want to create the new branch.
214
+ #
215
+ # @option params [required, String] :branch_name
216
+ # The name of the new branch to create.
217
+ #
218
+ # @option params [required, String] :commit_id
219
+ # The ID of the commit to point the new branch to.
220
+ #
221
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
222
+ #
223
+ # @example Request syntax with placeholder values
224
+ #
225
+ # resp = client.create_branch({
226
+ # repository_name: "RepositoryName", # required
227
+ # branch_name: "BranchName", # required
228
+ # commit_id: "CommitId", # required
229
+ # })
230
+ #
231
+ # @overload create_branch(params = {})
232
+ # @param [Hash] params ({})
233
+ def create_branch(params = {}, options = {})
234
+ req = build_request(:create_branch, params)
235
+ req.send_request(options)
236
+ end
423
237
 
424
- # Gets information about one or more branches in a repository.
425
- # @option params [required, String] :repository_name
426
- # The name of the repository that contains the branches.
427
- # @option params [String] :next_token
428
- # An enumeration token that allows the operation to batch the results.
429
- # @return [Types::ListBranchesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
430
- #
431
- # * {Types::ListBranchesOutput#branches #branches} => Array&lt;String&gt;
432
- # * {Types::ListBranchesOutput#next_token #nextToken} => String
433
- #
434
- # @example Request syntax with placeholder values
435
- # resp = client.list_branches({
436
- # repository_name: "RepositoryName", # required
437
- # next_token: "NextToken",
438
- # })
439
- #
440
- # @example Response structure
441
- # resp.branches #=> Array
442
- # resp.branches[0] #=> String
443
- # resp.next_token #=> String
444
- # @overload list_branches(params = {})
445
- # @param [Hash] params ({})
446
- def list_branches(params = {}, options = {})
447
- req = build_request(:list_branches, params)
448
- req.send_request(options)
449
- end
238
+ # Creates a new, empty repository.
239
+ #
240
+ # @option params [required, String] :repository_name
241
+ # The name of the new repository to be created.
242
+ #
243
+ # <note markdown="1"> The repository name must be unique across the calling AWS account. In
244
+ # addition, repository names are limited to 100 alphanumeric, dash, and
245
+ # underscore characters, and cannot include certain characters. For a
246
+ # full description of the limits on repository names, see [Limits][1] in
247
+ # the AWS CodeCommit User Guide. The suffix ".git" is prohibited.
248
+ #
249
+ # </note>
250
+ #
251
+ #
252
+ #
253
+ # [1]: http://docs.aws.amazon.com/codecommit/latest/userguide/limits.html
254
+ #
255
+ # @option params [String] :repository_description
256
+ # A comment or description about the new repository.
257
+ #
258
+ # <note markdown="1"> The description field for a repository accepts all HTML characters and
259
+ # all valid Unicode characters. Applications that do not HTML-encode the
260
+ # description and display it in a web page could expose users to
261
+ # potentially malicious code. Make sure that you HTML-encode the
262
+ # description field in any application that uses this API to display the
263
+ # repository description on a web page.
264
+ #
265
+ # </note>
266
+ #
267
+ # @return [Types::CreateRepositoryOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
268
+ #
269
+ # * {Types::CreateRepositoryOutput#repository_metadata #repository_metadata} => Types::RepositoryMetadata
270
+ #
271
+ # @example Request syntax with placeholder values
272
+ #
273
+ # resp = client.create_repository({
274
+ # repository_name: "RepositoryName", # required
275
+ # repository_description: "RepositoryDescription",
276
+ # })
277
+ #
278
+ # @example Response structure
279
+ #
280
+ # resp.repository_metadata.account_id #=> String
281
+ # resp.repository_metadata.repository_id #=> String
282
+ # resp.repository_metadata.repository_name #=> String
283
+ # resp.repository_metadata.repository_description #=> String
284
+ # resp.repository_metadata.default_branch #=> String
285
+ # resp.repository_metadata.last_modified_date #=> Time
286
+ # resp.repository_metadata.creation_date #=> Time
287
+ # resp.repository_metadata.clone_url_http #=> String
288
+ # resp.repository_metadata.clone_url_ssh #=> String
289
+ # resp.repository_metadata.arn #=> String
290
+ #
291
+ # @overload create_repository(params = {})
292
+ # @param [Hash] params ({})
293
+ def create_repository(params = {}, options = {})
294
+ req = build_request(:create_repository, params)
295
+ req.send_request(options)
296
+ end
450
297
 
451
- # Gets information about one or more repositories.
452
- # @option params [String] :next_token
453
- # An enumeration token that allows the operation to batch the results of
454
- # the operation. Batch sizes are 1,000 for list repository operations.
455
- # When the client sends the token back to AWS CodeCommit, another page
456
- # of 1,000 records is retrieved.
457
- # @option params [String] :sort_by
458
- # The criteria used to sort the results of a list repositories
459
- # operation.
460
- # @option params [String] :order
461
- # The order in which to sort the results of a list repositories
462
- # operation.
463
- # @return [Types::ListRepositoriesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
464
- #
465
- # * {Types::ListRepositoriesOutput#repositories #repositories} => Array&lt;Types::RepositoryNameIdPair&gt;
466
- # * {Types::ListRepositoriesOutput#next_token #nextToken} => String
467
- #
468
- # @example Request syntax with placeholder values
469
- # resp = client.list_repositories({
470
- # next_token: "NextToken",
471
- # sort_by: "repositoryName", # accepts repositoryName, lastModifiedDate
472
- # order: "ascending", # accepts ascending, descending
473
- # })
474
- #
475
- # @example Response structure
476
- # resp.repositories #=> Array
477
- # resp.repositories[0].repository_name #=> String
478
- # resp.repositories[0].repository_id #=> String
479
- # resp.next_token #=> String
480
- # @overload list_repositories(params = {})
481
- # @param [Hash] params ({})
482
- def list_repositories(params = {}, options = {})
483
- req = build_request(:list_repositories, params)
484
- req.send_request(options)
485
- end
298
+ # Deletes a repository. If a specified repository was already deleted, a
299
+ # null repository ID will be returned.
300
+ #
301
+ # Deleting a repository also deletes all associated objects and
302
+ # metadata. After a repository is deleted, all future push calls to the
303
+ # deleted repository will fail.
304
+ #
305
+ # @option params [required, String] :repository_name
306
+ # The name of the repository to delete.
307
+ #
308
+ # @return [Types::DeleteRepositoryOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
309
+ #
310
+ # * {Types::DeleteRepositoryOutput#repository_id #repository_id} => String
311
+ #
312
+ # @example Request syntax with placeholder values
313
+ #
314
+ # resp = client.delete_repository({
315
+ # repository_name: "RepositoryName", # required
316
+ # })
317
+ #
318
+ # @example Response structure
319
+ #
320
+ # resp.repository_id #=> String
321
+ #
322
+ # @overload delete_repository(params = {})
323
+ # @param [Hash] params ({})
324
+ def delete_repository(params = {}, options = {})
325
+ req = build_request(:delete_repository, params)
326
+ req.send_request(options)
327
+ end
486
328
 
487
- # Replaces all triggers for a repository. This can be used to create or
488
- # delete triggers.
489
- # @option params [String] :repository_name
490
- # The name of the repository where you want to create or update the
491
- # trigger.
492
- # @option params [Array<Types::RepositoryTrigger>] :triggers
493
- # The JSON block of configuration information for each trigger.
494
- # @return [Types::PutRepositoryTriggersOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
495
- #
496
- # * {Types::PutRepositoryTriggersOutput#configuration_id #configurationId} => String
497
- #
498
- # @example Request syntax with placeholder values
499
- # resp = client.put_repository_triggers({
500
- # repository_name: "RepositoryName",
501
- # triggers: [
502
- # {
503
- # name: "RepositoryTriggerName",
504
- # destination_arn: "Arn",
505
- # custom_data: "RepositoryTriggerCustomData",
506
- # branches: ["BranchName"],
507
- # events: ["all"], # accepts all, updateReference, createReference, deleteReference
508
- # },
509
- # ],
510
- # })
511
- #
512
- # @example Response structure
513
- # resp.configuration_id #=> String
514
- # @overload put_repository_triggers(params = {})
515
- # @param [Hash] params ({})
516
- def put_repository_triggers(params = {}, options = {})
517
- req = build_request(:put_repository_triggers, params)
518
- req.send_request(options)
519
- end
329
+ # Returns the base-64 encoded content of an individual blob within a
330
+ # repository.
331
+ #
332
+ # @option params [required, String] :repository_name
333
+ # The name of the repository that contains the blob.
334
+ #
335
+ # @option params [required, String] :blob_id
336
+ # The ID of the blob, which is its SHA-1 pointer.
337
+ #
338
+ # @return [Types::GetBlobOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
339
+ #
340
+ # * {Types::GetBlobOutput#content #content} => String
341
+ #
342
+ # @example Request syntax with placeholder values
343
+ #
344
+ # resp = client.get_blob({
345
+ # repository_name: "RepositoryName", # required
346
+ # blob_id: "ObjectId", # required
347
+ # })
348
+ #
349
+ # @example Response structure
350
+ #
351
+ # resp.content #=> String
352
+ #
353
+ # @overload get_blob(params = {})
354
+ # @param [Hash] params ({})
355
+ def get_blob(params = {}, options = {})
356
+ req = build_request(:get_blob, params)
357
+ req.send_request(options)
358
+ end
520
359
 
521
- # Tests the functionality of repository triggers by sending information
522
- # to the trigger target. If real data is available in the repository,
523
- # the test will send data from the last commit. If no data is available,
524
- # sample data will be generated.
525
- # @option params [String] :repository_name
526
- # The name of the repository in which to test the triggers.
527
- # @option params [Array<Types::RepositoryTrigger>] :triggers
528
- # The list of triggers to test.
529
- # @return [Types::TestRepositoryTriggersOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
530
- #
531
- # * {Types::TestRepositoryTriggersOutput#successful_executions #successfulExecutions} => Array&lt;String&gt;
532
- # * {Types::TestRepositoryTriggersOutput#failed_executions #failedExecutions} => Array&lt;Types::RepositoryTriggerExecutionFailure&gt;
533
- #
534
- # @example Request syntax with placeholder values
535
- # resp = client.test_repository_triggers({
536
- # repository_name: "RepositoryName",
537
- # triggers: [
538
- # {
539
- # name: "RepositoryTriggerName",
540
- # destination_arn: "Arn",
541
- # custom_data: "RepositoryTriggerCustomData",
542
- # branches: ["BranchName"],
543
- # events: ["all"], # accepts all, updateReference, createReference, deleteReference
544
- # },
545
- # ],
546
- # })
547
- #
548
- # @example Response structure
549
- # resp.successful_executions #=> Array
550
- # resp.successful_executions[0] #=> String
551
- # resp.failed_executions #=> Array
552
- # resp.failed_executions[0].trigger #=> String
553
- # resp.failed_executions[0].failure_message #=> String
554
- # @overload test_repository_triggers(params = {})
555
- # @param [Hash] params ({})
556
- def test_repository_triggers(params = {}, options = {})
557
- req = build_request(:test_repository_triggers, params)
558
- req.send_request(options)
559
- end
360
+ # Returns information about a repository branch, including its name and
361
+ # the last commit ID.
362
+ #
363
+ # @option params [String] :repository_name
364
+ # The name of the repository that contains the branch for which you want
365
+ # to retrieve information.
366
+ #
367
+ # @option params [String] :branch_name
368
+ # The name of the branch for which you want to retrieve information.
369
+ #
370
+ # @return [Types::GetBranchOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
371
+ #
372
+ # * {Types::GetBranchOutput#branch #branch} => Types::BranchInfo
373
+ #
374
+ # @example Request syntax with placeholder values
375
+ #
376
+ # resp = client.get_branch({
377
+ # repository_name: "RepositoryName",
378
+ # branch_name: "BranchName",
379
+ # })
380
+ #
381
+ # @example Response structure
382
+ #
383
+ # resp.branch.branch_name #=> String
384
+ # resp.branch.commit_id #=> String
385
+ #
386
+ # @overload get_branch(params = {})
387
+ # @param [Hash] params ({})
388
+ def get_branch(params = {}, options = {})
389
+ req = build_request(:get_branch, params)
390
+ req.send_request(options)
391
+ end
560
392
 
561
- # Sets or changes the default branch name for the specified repository.
562
- #
563
- # <note markdown="1">If you use this operation to change the default branch name to the
564
- # current default branch name, a success message is returned even though
565
- # the default branch did not change.
566
- #
567
- # </note>
568
- # @option params [required, String] :repository_name
569
- # The name of the repository to set or change the default branch for.
570
- # @option params [required, String] :default_branch_name
571
- # The name of the branch to set as the default.
572
- # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
573
- #
574
- # @example Request syntax with placeholder values
575
- # resp = client.update_default_branch({
576
- # repository_name: "RepositoryName", # required
577
- # default_branch_name: "BranchName", # required
578
- # })
579
- # @overload update_default_branch(params = {})
580
- # @param [Hash] params ({})
581
- def update_default_branch(params = {}, options = {})
582
- req = build_request(:update_default_branch, params)
583
- req.send_request(options)
584
- end
393
+ # Returns information about a commit, including commit message and
394
+ # committer information.
395
+ #
396
+ # @option params [required, String] :repository_name
397
+ # The name of the repository to which the commit was made.
398
+ #
399
+ # @option params [required, String] :commit_id
400
+ # The commit ID.
401
+ #
402
+ # @return [Types::GetCommitOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
403
+ #
404
+ # * {Types::GetCommitOutput#commit #commit} => Types::Commit
405
+ #
406
+ # @example Request syntax with placeholder values
407
+ #
408
+ # resp = client.get_commit({
409
+ # repository_name: "RepositoryName", # required
410
+ # commit_id: "ObjectId", # required
411
+ # })
412
+ #
413
+ # @example Response structure
414
+ #
415
+ # resp.commit.tree_id #=> String
416
+ # resp.commit.parents #=> Array
417
+ # resp.commit.parents[0] #=> String
418
+ # resp.commit.message #=> String
419
+ # resp.commit.author.name #=> String
420
+ # resp.commit.author.email #=> String
421
+ # resp.commit.author.date #=> String
422
+ # resp.commit.committer.name #=> String
423
+ # resp.commit.committer.email #=> String
424
+ # resp.commit.committer.date #=> String
425
+ # resp.commit.additional_data #=> String
426
+ #
427
+ # @overload get_commit(params = {})
428
+ # @param [Hash] params ({})
429
+ def get_commit(params = {}, options = {})
430
+ req = build_request(:get_commit, params)
431
+ req.send_request(options)
432
+ end
585
433
 
586
- # Sets or changes the comment or description for a repository.
587
- #
588
- # <note markdown="1">The description field for a repository accepts all HTML characters and
589
- # all valid Unicode characters. Applications that do not HTML-encode the
590
- # description and display it in a web page could expose users to
591
- # potentially malicious code. Make sure that you HTML-encode the
592
- # description field in any application that uses this API to display the
593
- # repository description on a web page.
594
- #
595
- # </note>
596
- # @option params [required, String] :repository_name
597
- # The name of the repository to set or change the comment or description
598
- # for.
599
- # @option params [String] :repository_description
600
- # The new comment or description for the specified repository.
601
- # Repository descriptions are limited to 1,000 characters.
602
- # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
603
- #
604
- # @example Request syntax with placeholder values
605
- # resp = client.update_repository_description({
606
- # repository_name: "RepositoryName", # required
607
- # repository_description: "RepositoryDescription",
608
- # })
609
- # @overload update_repository_description(params = {})
610
- # @param [Hash] params ({})
611
- def update_repository_description(params = {}, options = {})
612
- req = build_request(:update_repository_description, params)
613
- req.send_request(options)
614
- end
434
+ # Returns information about the differences in a valid commit specifier
435
+ # (such as a branch, tag, HEAD, commit ID or other fully qualified
436
+ # reference). Results can be limited to a specified path.
437
+ #
438
+ # @option params [required, String] :repository_name
439
+ # The name of the repository where you want to get differences.
440
+ #
441
+ # @option params [String] :before_commit_specifier
442
+ # The branch, tag, HEAD, or other fully qualified reference used to
443
+ # identify a commit. For example, the full commit ID. Optional. If not
444
+ # specified, all changes prior to the `afterCommitSpecifier` value will
445
+ # be shown. If you do not use `beforeCommitSpecifier` in your request,
446
+ # consider limiting the results with `maxResults`.
447
+ #
448
+ # @option params [required, String] :after_commit_specifier
449
+ # The branch, tag, HEAD, or other fully qualified reference used to
450
+ # identify a commit.
451
+ #
452
+ # @option params [String] :before_path
453
+ # The file path in which to check for differences. Limits the results to
454
+ # this path. Can also be used to specify the previous name of a
455
+ # directory or folder. If `beforePath` and `afterPath` are not
456
+ # specified, differences will be shown for all paths.
457
+ #
458
+ # @option params [String] :after_path
459
+ # The file path in which to check differences. Limits the results to
460
+ # this path. Can also be used to specify the changed name of a directory
461
+ # or folder, if it has changed. If not specified, differences will be
462
+ # shown for all paths.
463
+ #
464
+ # @option params [Integer] :max_results
465
+ # A non-negative integer used to limit the number of returned results.
466
+ #
467
+ # @option params [String] :next_token
468
+ # An enumeration token that when provided in a request, returns the next
469
+ # batch of the results.
470
+ #
471
+ # @return [Types::GetDifferencesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
472
+ #
473
+ # * {Types::GetDifferencesOutput#differences #differences} => Array&lt;Types::Difference&gt;
474
+ # * {Types::GetDifferencesOutput#next_token #next_token} => String
475
+ #
476
+ # @example Request syntax with placeholder values
477
+ #
478
+ # resp = client.get_differences({
479
+ # repository_name: "RepositoryName", # required
480
+ # before_commit_specifier: "CommitName",
481
+ # after_commit_specifier: "CommitName", # required
482
+ # before_path: "Path",
483
+ # after_path: "Path",
484
+ # max_results: 1,
485
+ # next_token: "NextToken",
486
+ # })
487
+ #
488
+ # @example Response structure
489
+ #
490
+ # resp.differences #=> Array
491
+ # resp.differences[0].before_blob.blob_id #=> String
492
+ # resp.differences[0].before_blob.path #=> String
493
+ # resp.differences[0].before_blob.mode #=> String
494
+ # resp.differences[0].after_blob.blob_id #=> String
495
+ # resp.differences[0].after_blob.path #=> String
496
+ # resp.differences[0].after_blob.mode #=> String
497
+ # resp.differences[0].change_type #=> String, one of "A", "M", "D"
498
+ # resp.next_token #=> String
499
+ #
500
+ # @overload get_differences(params = {})
501
+ # @param [Hash] params ({})
502
+ def get_differences(params = {}, options = {})
503
+ req = build_request(:get_differences, params)
504
+ req.send_request(options)
505
+ end
615
506
 
616
- # Renames a repository. The repository name must be unique across the
617
- # calling AWS account. In addition, repository names are limited to 100
618
- # alphanumeric, dash, and underscore characters, and cannot include
619
- # certain characters. The suffix ".git" is prohibited. For a full
620
- # description of the limits on repository names, see [Limits][1] in the
621
- # AWS CodeCommit User Guide.
622
- #
623
- #
624
- #
625
- # [1]: http://docs.aws.amazon.com/codecommit/latest/userguide/limits.html
626
- # @option params [required, String] :old_name
627
- # The existing name of the repository.
628
- # @option params [required, String] :new_name
629
- # The new name for the repository.
630
- # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
631
- #
632
- # @example Request syntax with placeholder values
633
- # resp = client.update_repository_name({
634
- # old_name: "RepositoryName", # required
635
- # new_name: "RepositoryName", # required
636
- # })
637
- # @overload update_repository_name(params = {})
638
- # @param [Hash] params ({})
639
- def update_repository_name(params = {}, options = {})
640
- req = build_request(:update_repository_name, params)
641
- req.send_request(options)
642
- end
507
+ # Returns information about a repository.
508
+ #
509
+ # <note markdown="1"> The description field for a repository accepts all HTML characters and
510
+ # all valid Unicode characters. Applications that do not HTML-encode the
511
+ # description and display it in a web page could expose users to
512
+ # potentially malicious code. Make sure that you HTML-encode the
513
+ # description field in any application that uses this API to display the
514
+ # repository description on a web page.
515
+ #
516
+ # </note>
517
+ #
518
+ # @option params [required, String] :repository_name
519
+ # The name of the repository to get information about.
520
+ #
521
+ # @return [Types::GetRepositoryOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
522
+ #
523
+ # * {Types::GetRepositoryOutput#repository_metadata #repository_metadata} => Types::RepositoryMetadata
524
+ #
525
+ # @example Request syntax with placeholder values
526
+ #
527
+ # resp = client.get_repository({
528
+ # repository_name: "RepositoryName", # required
529
+ # })
530
+ #
531
+ # @example Response structure
532
+ #
533
+ # resp.repository_metadata.account_id #=> String
534
+ # resp.repository_metadata.repository_id #=> String
535
+ # resp.repository_metadata.repository_name #=> String
536
+ # resp.repository_metadata.repository_description #=> String
537
+ # resp.repository_metadata.default_branch #=> String
538
+ # resp.repository_metadata.last_modified_date #=> Time
539
+ # resp.repository_metadata.creation_date #=> Time
540
+ # resp.repository_metadata.clone_url_http #=> String
541
+ # resp.repository_metadata.clone_url_ssh #=> String
542
+ # resp.repository_metadata.arn #=> String
543
+ #
544
+ # @overload get_repository(params = {})
545
+ # @param [Hash] params ({})
546
+ def get_repository(params = {}, options = {})
547
+ req = build_request(:get_repository, params)
548
+ req.send_request(options)
549
+ end
643
550
 
644
- # @!endgroup
551
+ # Gets information about triggers configured for a repository.
552
+ #
553
+ # @option params [required, String] :repository_name
554
+ # The name of the repository for which the trigger is configured.
555
+ #
556
+ # @return [Types::GetRepositoryTriggersOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
557
+ #
558
+ # * {Types::GetRepositoryTriggersOutput#configuration_id #configuration_id} => String
559
+ # * {Types::GetRepositoryTriggersOutput#triggers #triggers} => Array&lt;Types::RepositoryTrigger&gt;
560
+ #
561
+ # @example Request syntax with placeholder values
562
+ #
563
+ # resp = client.get_repository_triggers({
564
+ # repository_name: "RepositoryName", # required
565
+ # })
566
+ #
567
+ # @example Response structure
568
+ #
569
+ # resp.configuration_id #=> String
570
+ # resp.triggers #=> Array
571
+ # resp.triggers[0].name #=> String
572
+ # resp.triggers[0].destination_arn #=> String
573
+ # resp.triggers[0].custom_data #=> String
574
+ # resp.triggers[0].branches #=> Array
575
+ # resp.triggers[0].branches[0] #=> String
576
+ # resp.triggers[0].events #=> Array
577
+ # resp.triggers[0].events[0] #=> String, one of "all", "updateReference", "createReference", "deleteReference"
578
+ #
579
+ # @overload get_repository_triggers(params = {})
580
+ # @param [Hash] params ({})
581
+ def get_repository_triggers(params = {}, options = {})
582
+ req = build_request(:get_repository_triggers, params)
583
+ req.send_request(options)
584
+ end
645
585
 
646
- # @param params ({})
647
- # @api private
648
- def build_request(operation_name, params = {})
649
- handlers = @handlers.for(operation_name)
650
- context = Seahorse::Client::RequestContext.new(
651
- operation_name: operation_name,
652
- operation: config.api.operation(operation_name),
653
- client: self,
654
- params: params,
655
- config: config)
656
- context[:gem_name] = 'aws-sdk-codecommit'
657
- context[:gem_version] = '1.0.0.rc1'
658
- Seahorse::Client::Request.new(handlers, context)
659
- end
586
+ # Gets information about one or more branches in a repository.
587
+ #
588
+ # @option params [required, String] :repository_name
589
+ # The name of the repository that contains the branches.
590
+ #
591
+ # @option params [String] :next_token
592
+ # An enumeration token that allows the operation to batch the results.
593
+ #
594
+ # @return [Types::ListBranchesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
595
+ #
596
+ # * {Types::ListBranchesOutput#branches #branches} => Array&lt;String&gt;
597
+ # * {Types::ListBranchesOutput#next_token #next_token} => String
598
+ #
599
+ # @example Request syntax with placeholder values
600
+ #
601
+ # resp = client.list_branches({
602
+ # repository_name: "RepositoryName", # required
603
+ # next_token: "NextToken",
604
+ # })
605
+ #
606
+ # @example Response structure
607
+ #
608
+ # resp.branches #=> Array
609
+ # resp.branches[0] #=> String
610
+ # resp.next_token #=> String
611
+ #
612
+ # @overload list_branches(params = {})
613
+ # @param [Hash] params ({})
614
+ def list_branches(params = {}, options = {})
615
+ req = build_request(:list_branches, params)
616
+ req.send_request(options)
617
+ end
660
618
 
661
- # @api private
662
- # @deprecated
663
- def waiter_names
664
- []
665
- end
619
+ # Gets information about one or more repositories.
620
+ #
621
+ # @option params [String] :next_token
622
+ # An enumeration token that allows the operation to batch the results of
623
+ # the operation. Batch sizes are 1,000 for list repository operations.
624
+ # When the client sends the token back to AWS CodeCommit, another page
625
+ # of 1,000 records is retrieved.
626
+ #
627
+ # @option params [String] :sort_by
628
+ # The criteria used to sort the results of a list repositories
629
+ # operation.
630
+ #
631
+ # @option params [String] :order
632
+ # The order in which to sort the results of a list repositories
633
+ # operation.
634
+ #
635
+ # @return [Types::ListRepositoriesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
636
+ #
637
+ # * {Types::ListRepositoriesOutput#repositories #repositories} => Array&lt;Types::RepositoryNameIdPair&gt;
638
+ # * {Types::ListRepositoriesOutput#next_token #next_token} => String
639
+ #
640
+ # @example Request syntax with placeholder values
641
+ #
642
+ # resp = client.list_repositories({
643
+ # next_token: "NextToken",
644
+ # sort_by: "repositoryName", # accepts repositoryName, lastModifiedDate
645
+ # order: "ascending", # accepts ascending, descending
646
+ # })
647
+ #
648
+ # @example Response structure
649
+ #
650
+ # resp.repositories #=> Array
651
+ # resp.repositories[0].repository_name #=> String
652
+ # resp.repositories[0].repository_id #=> String
653
+ # resp.next_token #=> String
654
+ #
655
+ # @overload list_repositories(params = {})
656
+ # @param [Hash] params ({})
657
+ def list_repositories(params = {}, options = {})
658
+ req = build_request(:list_repositories, params)
659
+ req.send_request(options)
660
+ end
661
+
662
+ # Replaces all triggers for a repository. This can be used to create or
663
+ # delete triggers.
664
+ #
665
+ # @option params [required, String] :repository_name
666
+ # The name of the repository where you want to create or update the
667
+ # trigger.
668
+ #
669
+ # @option params [required, Array<Types::RepositoryTrigger>] :triggers
670
+ # The JSON block of configuration information for each trigger.
671
+ #
672
+ # @return [Types::PutRepositoryTriggersOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
673
+ #
674
+ # * {Types::PutRepositoryTriggersOutput#configuration_id #configuration_id} => String
675
+ #
676
+ # @example Request syntax with placeholder values
677
+ #
678
+ # resp = client.put_repository_triggers({
679
+ # repository_name: "RepositoryName", # required
680
+ # triggers: [ # required
681
+ # {
682
+ # name: "RepositoryTriggerName", # required
683
+ # destination_arn: "Arn", # required
684
+ # custom_data: "RepositoryTriggerCustomData",
685
+ # branches: ["BranchName"],
686
+ # events: ["all"], # required, accepts all, updateReference, createReference, deleteReference
687
+ # },
688
+ # ],
689
+ # })
690
+ #
691
+ # @example Response structure
692
+ #
693
+ # resp.configuration_id #=> String
694
+ #
695
+ # @overload put_repository_triggers(params = {})
696
+ # @param [Hash] params ({})
697
+ def put_repository_triggers(params = {}, options = {})
698
+ req = build_request(:put_repository_triggers, params)
699
+ req.send_request(options)
700
+ end
666
701
 
667
- class << self
702
+ # Tests the functionality of repository triggers by sending information
703
+ # to the trigger target. If real data is available in the repository,
704
+ # the test will send data from the last commit. If no data is available,
705
+ # sample data will be generated.
706
+ #
707
+ # @option params [required, String] :repository_name
708
+ # The name of the repository in which to test the triggers.
709
+ #
710
+ # @option params [required, Array<Types::RepositoryTrigger>] :triggers
711
+ # The list of triggers to test.
712
+ #
713
+ # @return [Types::TestRepositoryTriggersOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
714
+ #
715
+ # * {Types::TestRepositoryTriggersOutput#successful_executions #successful_executions} => Array&lt;String&gt;
716
+ # * {Types::TestRepositoryTriggersOutput#failed_executions #failed_executions} => Array&lt;Types::RepositoryTriggerExecutionFailure&gt;
717
+ #
718
+ # @example Request syntax with placeholder values
719
+ #
720
+ # resp = client.test_repository_triggers({
721
+ # repository_name: "RepositoryName", # required
722
+ # triggers: [ # required
723
+ # {
724
+ # name: "RepositoryTriggerName", # required
725
+ # destination_arn: "Arn", # required
726
+ # custom_data: "RepositoryTriggerCustomData",
727
+ # branches: ["BranchName"],
728
+ # events: ["all"], # required, accepts all, updateReference, createReference, deleteReference
729
+ # },
730
+ # ],
731
+ # })
732
+ #
733
+ # @example Response structure
734
+ #
735
+ # resp.successful_executions #=> Array
736
+ # resp.successful_executions[0] #=> String
737
+ # resp.failed_executions #=> Array
738
+ # resp.failed_executions[0].trigger #=> String
739
+ # resp.failed_executions[0].failure_message #=> String
740
+ #
741
+ # @overload test_repository_triggers(params = {})
742
+ # @param [Hash] params ({})
743
+ def test_repository_triggers(params = {}, options = {})
744
+ req = build_request(:test_repository_triggers, params)
745
+ req.send_request(options)
746
+ end
668
747
 
669
- # @api private
670
- attr_reader :identifier
748
+ # Sets or changes the default branch name for the specified repository.
749
+ #
750
+ # <note markdown="1"> If you use this operation to change the default branch name to the
751
+ # current default branch name, a success message is returned even though
752
+ # the default branch did not change.
753
+ #
754
+ # </note>
755
+ #
756
+ # @option params [required, String] :repository_name
757
+ # The name of the repository to set or change the default branch for.
758
+ #
759
+ # @option params [required, String] :default_branch_name
760
+ # The name of the branch to set as the default.
761
+ #
762
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
763
+ #
764
+ # @example Request syntax with placeholder values
765
+ #
766
+ # resp = client.update_default_branch({
767
+ # repository_name: "RepositoryName", # required
768
+ # default_branch_name: "BranchName", # required
769
+ # })
770
+ #
771
+ # @overload update_default_branch(params = {})
772
+ # @param [Hash] params ({})
773
+ def update_default_branch(params = {}, options = {})
774
+ req = build_request(:update_default_branch, params)
775
+ req.send_request(options)
776
+ end
671
777
 
672
- # @api private
673
- def errors_module
674
- Errors
675
- end
778
+ # Sets or changes the comment or description for a repository.
779
+ #
780
+ # <note markdown="1"> The description field for a repository accepts all HTML characters and
781
+ # all valid Unicode characters. Applications that do not HTML-encode the
782
+ # description and display it in a web page could expose users to
783
+ # potentially malicious code. Make sure that you HTML-encode the
784
+ # description field in any application that uses this API to display the
785
+ # repository description on a web page.
786
+ #
787
+ # </note>
788
+ #
789
+ # @option params [required, String] :repository_name
790
+ # The name of the repository to set or change the comment or description
791
+ # for.
792
+ #
793
+ # @option params [String] :repository_description
794
+ # The new comment or description for the specified repository.
795
+ # Repository descriptions are limited to 1,000 characters.
796
+ #
797
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
798
+ #
799
+ # @example Request syntax with placeholder values
800
+ #
801
+ # resp = client.update_repository_description({
802
+ # repository_name: "RepositoryName", # required
803
+ # repository_description: "RepositoryDescription",
804
+ # })
805
+ #
806
+ # @overload update_repository_description(params = {})
807
+ # @param [Hash] params ({})
808
+ def update_repository_description(params = {}, options = {})
809
+ req = build_request(:update_repository_description, params)
810
+ req.send_request(options)
811
+ end
676
812
 
813
+ # Renames a repository. The repository name must be unique across the
814
+ # calling AWS account. In addition, repository names are limited to 100
815
+ # alphanumeric, dash, and underscore characters, and cannot include
816
+ # certain characters. The suffix ".git" is prohibited. For a full
817
+ # description of the limits on repository names, see [Limits][1] in the
818
+ # AWS CodeCommit User Guide.
819
+ #
820
+ #
821
+ #
822
+ # [1]: http://docs.aws.amazon.com/codecommit/latest/userguide/limits.html
823
+ #
824
+ # @option params [required, String] :old_name
825
+ # The existing name of the repository.
826
+ #
827
+ # @option params [required, String] :new_name
828
+ # The new name for the repository.
829
+ #
830
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
831
+ #
832
+ # @example Request syntax with placeholder values
833
+ #
834
+ # resp = client.update_repository_name({
835
+ # old_name: "RepositoryName", # required
836
+ # new_name: "RepositoryName", # required
837
+ # })
838
+ #
839
+ # @overload update_repository_name(params = {})
840
+ # @param [Hash] params ({})
841
+ def update_repository_name(params = {}, options = {})
842
+ req = build_request(:update_repository_name, params)
843
+ req.send_request(options)
844
+ end
845
+
846
+ # @!endgroup
847
+
848
+ # @param params ({})
849
+ # @api private
850
+ def build_request(operation_name, params = {})
851
+ handlers = @handlers.for(operation_name)
852
+ context = Seahorse::Client::RequestContext.new(
853
+ operation_name: operation_name,
854
+ operation: config.api.operation(operation_name),
855
+ client: self,
856
+ params: params,
857
+ config: config)
858
+ context[:gem_name] = 'aws-sdk-codecommit'
859
+ context[:gem_version] = '1.0.0.rc1'
860
+ Seahorse::Client::Request.new(handlers, context)
861
+ end
862
+
863
+ # @api private
864
+ # @deprecated
865
+ def waiter_names
866
+ []
867
+ end
868
+
869
+ class << self
870
+
871
+ # @api private
872
+ attr_reader :identifier
873
+
874
+ # @api private
875
+ def errors_module
876
+ Errors
677
877
  end
878
+
678
879
  end
679
880
  end
680
881
  end