aws-sdk-lambda 1.37.0 → 1.42.0

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
- SHA1:
3
- metadata.gz: 70fca6432323fba75c3b10ece938651fe10c2590
4
- data.tar.gz: bddc6ed974a292177bc06664c276f5cab8a739af
2
+ SHA256:
3
+ metadata.gz: b2ed053bee369181c0006a9a33b4aebfac1c58232e0089b8c47d620d28bb2e3f
4
+ data.tar.gz: 8059c3bde6615757a1e948dcab837b319b91a9c715d23a3d71a65e92d3bd550f
5
5
  SHA512:
6
- metadata.gz: e6a9708a5bb475c87b4dd2f89195d874b35af3128dbc37bb395e707bef21bbfe6ea30b4e2ed4ae2f38b5b4b5e361412110576325017796dfc5403c4ea674ac13
7
- data.tar.gz: 1c3925bd8042184c8b9af6d4ab3778efbd90cd2e83e7dc76d806a46cfa2f5a4eed739207222b40db72161bfc3dcd115fb493dac3066d2b16db53c4e7a5247553
6
+ metadata.gz: 13d664300a1dc629d0be849713e0ebef6795f0a46497d91933f5756b01ceca9662ac782beefa774cd9771447456c7ccc461eeefd7774c9fbc556f38dc6b6db72
7
+ data.tar.gz: f2fd2ccb0f600f45be40fc63c03194c28ee7bf02dd7f1139746853aa71d95e9aaa5c1c9f62ee3e8f9248713ff293199c6acbb92a119a3c7889b7d41a8bf35fd9
@@ -46,6 +46,6 @@ require_relative 'aws-sdk-lambda/customizations'
46
46
  # @service
47
47
  module Aws::Lambda
48
48
 
49
- GEM_VERSION = '1.37.0'
49
+ GEM_VERSION = '1.42.0'
50
50
 
51
51
  end
@@ -32,11 +32,11 @@ Aws::Plugins::GlobalConfiguration.add_identifier(:lambda)
32
32
  module Aws::Lambda
33
33
  # An API client for Lambda. To construct a client, you need to configure a `:region` and `:credentials`.
34
34
  #
35
- # client = Aws::Lambda::Client.new(
36
- # region: region_name,
37
- # credentials: credentials,
38
- # # ...
39
- # )
35
+ # client = Aws::Lambda::Client.new(
36
+ # region: region_name,
37
+ # credentials: credentials,
38
+ # # ...
39
+ # )
40
40
  #
41
41
  # For details on configuring region and credentials see
42
42
  # the [developer guide](/sdk-for-ruby/v3/developer-guide/setup-config.html).
@@ -105,7 +105,7 @@ module Aws::Lambda
105
105
  # @option options [required, String] :region
106
106
  # The AWS region to connect to. The configured `:region` is
107
107
  # used to determine the service `:endpoint`. When not passed,
108
- # a default `:region` is search for in the following locations:
108
+ # a default `:region` is searched for in the following locations:
109
109
  #
110
110
  # * `Aws.config[:region]`
111
111
  # * `ENV['AWS_REGION']`
@@ -161,7 +161,7 @@ module Aws::Lambda
161
161
  # @option options [String] :endpoint
162
162
  # The client endpoint is normally constructed from the `:region`
163
163
  # option. You should only configure an `:endpoint` when connecting
164
- # to test endpoints. This should be avalid HTTP(S) URI.
164
+ # to test endpoints. This should be a valid HTTP(S) URI.
165
165
  #
166
166
  # @option options [Integer] :endpoint_cache_max_entries (1000)
167
167
  # Used for the maximum size limit of the LRU cache storing endpoints data
@@ -176,7 +176,7 @@ module Aws::Lambda
176
176
  # requests fetching endpoints information. Defaults to 60 sec.
177
177
  #
178
178
  # @option options [Boolean] :endpoint_discovery (false)
179
- # When set to `true`, endpoint discovery will be enabled for operations when available. Defaults to `false`.
179
+ # When set to `true`, endpoint discovery will be enabled for operations when available.
180
180
  #
181
181
  # @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
182
182
  # The log formatter.
@@ -229,15 +229,19 @@ module Aws::Lambda
229
229
  #
230
230
  # @option options [String] :retry_mode ("legacy")
231
231
  # Specifies which retry algorithm to use. Values are:
232
- # * `legacy` - The pre-existing retry behavior. This is default value if
233
- # no retry mode is provided.
234
- # * `standard` - A standardized set of retry rules across the AWS SDKs.
235
- # This includes support for retry quotas, which limit the number of
236
- # unsuccessful retries a client can make.
237
- # * `adaptive` - An experimental retry mode that includes all the
238
- # functionality of `standard` mode along with automatic client side
239
- # throttling. This is a provisional mode that may change behavior
240
- # in the future.
232
+ #
233
+ # * `legacy` - The pre-existing retry behavior. This is default value if
234
+ # no retry mode is provided.
235
+ #
236
+ # * `standard` - A standardized set of retry rules across the AWS SDKs.
237
+ # This includes support for retry quotas, which limit the number of
238
+ # unsuccessful retries a client can make.
239
+ #
240
+ # * `adaptive` - An experimental retry mode that includes all the
241
+ # functionality of `standard` mode along with automatic client side
242
+ # throttling. This is a provisional mode that may change behavior
243
+ # in the future.
244
+ #
241
245
  #
242
246
  # @option options [String] :secret_access_key
243
247
  #
@@ -265,8 +269,7 @@ module Aws::Lambda
265
269
  #
266
270
  # @option options [Integer] :http_read_timeout (60) The default
267
271
  # number of seconds to wait for response data. This value can
268
- # safely be set
269
- # per-request on the session yielded by {#session_for}.
272
+ # safely be set per-request on the session.
270
273
  #
271
274
  # @option options [Float] :http_idle_timeout (5) The number of
272
275
  # seconds a connection is allowed to sit idle before it is
@@ -278,7 +281,7 @@ module Aws::Lambda
278
281
  # request body. This option has no effect unless the request has
279
282
  # "Expect" header set to "100-continue". Defaults to `nil` which
280
283
  # disables this behaviour. This value can safely be set per
281
- # request on the session yielded by {#session_for}.
284
+ # request on the session.
282
285
  #
283
286
  # @option options [Boolean] :http_wire_trace (false) When `true`,
284
287
  # HTTP debug output will be sent to the `:logger`.
@@ -348,6 +351,25 @@ module Aws::Lambda
348
351
  # * {Types::AddLayerVersionPermissionResponse#statement #statement} => String
349
352
  # * {Types::AddLayerVersionPermissionResponse#revision_id #revision_id} => String
350
353
  #
354
+ #
355
+ # @example Example: To add permissions to a layer version
356
+ #
357
+ # # The following example grants permission for the account 223456789012 to use version 1 of a layer named my-layer.
358
+ #
359
+ # resp = client.add_layer_version_permission({
360
+ # action: "lambda:GetLayerVersion",
361
+ # layer_name: "my-layer",
362
+ # principal: "223456789012",
363
+ # statement_id: "xaccount",
364
+ # version_number: 1,
365
+ # })
366
+ #
367
+ # resp.to_h outputs the following:
368
+ # {
369
+ # revision_id: "35d87451-f796-4a3f-a618-95a3671b0a0c",
370
+ # statement: "{\"Sid\":\"xaccount\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::223456789012:root\"},\"Action\":\"lambda:GetLayerVersion\",\"Resource\":\"arn:aws:lambda:us-east-2:123456789012:layer:my-layer:1\"}",
371
+ # }
372
+ #
351
373
  # @example Request syntax with placeholder values
352
374
  #
353
375
  # resp = client.add_layer_version_permission({
@@ -383,11 +405,11 @@ module Aws::Lambda
383
405
  # To grant permission to another account, specify the account ID as the
384
406
  # `Principal`. For AWS services, the principal is a domain-style
385
407
  # identifier defined by the service, like `s3.amazonaws.com` or
386
- # `sns.amazonaws.com`. For AWS services, you can also specify the ARN or
387
- # owning account of the associated resource as the `SourceArn` or
388
- # `SourceAccount`. If you grant permission to a service principal
389
- # without specifying the source, other accounts could potentially
390
- # configure resources in their account to invoke your Lambda function.
408
+ # `sns.amazonaws.com`. For AWS services, you can also specify the ARN of
409
+ # the associated resource as the `SourceArn`. If you grant permission to
410
+ # a service principal without specifying the source, other accounts
411
+ # could potentially configure resources in their account to invoke your
412
+ # Lambda function.
391
413
  #
392
414
  # This action adds a statement to a resource-based permissions policy
393
415
  # for the function. For more information about function policies, see
@@ -432,12 +454,10 @@ module Aws::Lambda
432
454
  # function. For example, an Amazon S3 bucket or Amazon SNS topic.
433
455
  #
434
456
  # @option params [String] :source_account
435
- # For AWS services, the ID of the account that owns the resource. Use
436
- # this instead of `SourceArn` to grant permission to resources that are
437
- # owned by another account (for example, all of an account's Amazon S3
438
- # buckets). Or use it together with `SourceArn` to ensure that the
439
- # resource is owned by the specified account. For example, an Amazon S3
440
- # bucket could be deleted by its owner and recreated by another account.
457
+ # For Amazon S3, the ID of the account that owns the resource. Use this
458
+ # together with `SourceArn` to ensure that the resource is owned by the
459
+ # specified account. It is possible for an Amazon S3 bucket to be
460
+ # deleted by its owner and recreated by another account.
441
461
  #
442
462
  # @option params [String] :event_source_token
443
463
  # For Alexa Smart Home functions, a token that must be supplied by the
@@ -457,22 +477,39 @@ module Aws::Lambda
457
477
  # * {Types::AddPermissionResponse#statement #statement} => String
458
478
  #
459
479
  #
460
- # @example Example: add-permission
480
+ # @example Example: To grant Amazon S3 permission to invoke a function
461
481
  #
462
- # # This example adds a permission for an S3 bucket to invoke a Lambda function.
482
+ # # The following example adds permission for Amazon S3 to invoke a Lambda function named my-function for notifications from
483
+ # # a bucket named my-bucket-1xpuxmplzrlbh in account 123456789012.
463
484
  #
464
485
  # resp = client.add_permission({
465
486
  # action: "lambda:InvokeFunction",
466
- # function_name: "MyFunction",
487
+ # function_name: "my-function",
467
488
  # principal: "s3.amazonaws.com",
468
489
  # source_account: "123456789012",
469
- # source_arn: "arn:aws:s3:::examplebucket/*",
470
- # statement_id: "ID-1",
490
+ # source_arn: "arn:aws:s3:::my-bucket-1xpuxmplzrlbh/*",
491
+ # statement_id: "s3",
492
+ # })
493
+ #
494
+ # resp.to_h outputs the following:
495
+ # {
496
+ # statement: "{\"Sid\":\"s3\",\"Effect\":\"Allow\",\"Principal\":{\"Service\":\"s3.amazonaws.com\"},\"Action\":\"lambda:InvokeFunction\",\"Resource\":\"arn:aws:lambda:us-east-2:123456789012:function:my-function\",\"Condition\":{\"StringEquals\":{\"AWS:SourceAccount\":\"123456789012\"},\"ArnLike\":{\"AWS:SourceArn\":\"arn:aws:s3:::my-bucket-1xpuxmplzrlbh\"}}}",
497
+ # }
498
+ #
499
+ # @example Example: To grant another account permission to invoke a function
500
+ #
501
+ # # The following example adds permission for account 223456789012 invoke a Lambda function named my-function.
502
+ #
503
+ # resp = client.add_permission({
504
+ # action: "lambda:InvokeFunction",
505
+ # function_name: "my-function",
506
+ # principal: "223456789012",
507
+ # statement_id: "xaccount",
471
508
  # })
472
509
  #
473
510
  # resp.to_h outputs the following:
474
511
  # {
475
- # statement: "ID-1",
512
+ # statement: "{\"Sid\":\"xaccount\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::223456789012:root\"},\"Action\":\"lambda:InvokeFunction\",\"Resource\":\"arn:aws:lambda:us-east-2:123456789012:function:my-function\"}",
476
513
  # }
477
514
  #
478
515
  # @example Request syntax with placeholder values
@@ -554,6 +591,27 @@ module Aws::Lambda
554
591
  # * {Types::AliasConfiguration#routing_config #routing_config} => Types::AliasRoutingConfiguration
555
592
  # * {Types::AliasConfiguration#revision_id #revision_id} => String
556
593
  #
594
+ #
595
+ # @example Example: To create an alias for a Lambda function
596
+ #
597
+ # # The following example creates an alias named LIVE that points to version 1 of the my-function Lambda function.
598
+ #
599
+ # resp = client.create_alias({
600
+ # description: "alias for live version of function",
601
+ # function_name: "my-function",
602
+ # function_version: "1",
603
+ # name: "LIVE",
604
+ # })
605
+ #
606
+ # resp.to_h outputs the following:
607
+ # {
608
+ # alias_arn: "arn:aws:lambda:us-east-2:123456789012:function:my-function:LIVE",
609
+ # description: "alias for live version of function",
610
+ # function_version: "1",
611
+ # name: "LIVE",
612
+ # revision_id: "873282ed-xmpl-4dc8-a069-d0c647e470c6",
613
+ # }
614
+ #
557
615
  # @example Request syntax with placeholder values
558
616
  #
559
617
  # resp = client.create_alias({
@@ -663,8 +721,8 @@ module Aws::Lambda
663
721
  # * **Amazon Simple Queue Service** - Default 10. Max 10.
664
722
  #
665
723
  # @option params [Integer] :maximum_batching_window_in_seconds
666
- # The maximum amount of time to gather records before invoking the
667
- # function, in seconds.
724
+ # (Streams) The maximum amount of time to gather records before invoking
725
+ # the function, in seconds.
668
726
  #
669
727
  # @option params [Integer] :parallelization_factor
670
728
  # (Streams) The number of batches to process from each shard
@@ -712,6 +770,28 @@ module Aws::Lambda
712
770
  # * {Types::EventSourceMappingConfiguration#bisect_batch_on_function_error #bisect_batch_on_function_error} => Boolean
713
771
  # * {Types::EventSourceMappingConfiguration#maximum_retry_attempts #maximum_retry_attempts} => Integer
714
772
  #
773
+ #
774
+ # @example Example: To create a mapping between an event source and an AWS Lambda function
775
+ #
776
+ # # The following example creates a mapping between an SQS queue and the my-function Lambda function.
777
+ #
778
+ # resp = client.create_event_source_mapping({
779
+ # batch_size: 5,
780
+ # event_source_arn: "arn:aws:sqs:us-west-2:123456789012:my-queue",
781
+ # function_name: "my-function",
782
+ # })
783
+ #
784
+ # resp.to_h outputs the following:
785
+ # {
786
+ # batch_size: 5,
787
+ # event_source_arn: "arn:aws:sqs:us-west-2:123456789012:my-queue",
788
+ # function_arn: "arn:aws:lambda:us-west-2:123456789012:function:my-function",
789
+ # last_modified: Time.parse(1569284520.333),
790
+ # state: "Creating",
791
+ # state_transition_reason: "USER_INITIATED",
792
+ # uuid: "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
793
+ # }
794
+ #
715
795
  # @example Request syntax with placeholder values
716
796
  #
717
797
  # resp = client.create_event_source_mapping({
@@ -941,48 +1021,73 @@ module Aws::Lambda
941
1021
  # * {Types::FunctionConfiguration#last_update_status_reason_code #last_update_status_reason_code} => String
942
1022
  #
943
1023
  #
944
- # @example Example: create-function
1024
+ # @example Example: To create a function
945
1025
  #
946
- # # This example creates a Lambda function.
1026
+ # # The following example creates a function with a deployment package in Amazon S3 and enables X-Ray tracing and
1027
+ # # environment variable encryption.
947
1028
  #
948
1029
  # resp = client.create_function({
949
1030
  # code: {
1031
+ # s3_bucket: "my-bucket-1xpuxmplzrlbh",
1032
+ # s3_key: "function.zip",
950
1033
  # },
951
- # description: "",
952
- # function_name: "MyFunction",
953
- # handler: "souce_file.handler_name", # is of the form of the name of your source file and then name of your function handler
954
- # memory_size: 128,
1034
+ # description: "Process image objects from Amazon S3.",
1035
+ # environment: {
1036
+ # variables: {
1037
+ # "BUCKET" => "my-bucket-1xpuxmplzrlbh",
1038
+ # "PREFIX" => "inbound",
1039
+ # },
1040
+ # },
1041
+ # function_name: "my-function",
1042
+ # handler: "index.handler",
1043
+ # kms_key_arn: "arn:aws:kms:us-west-2:123456789012:key/b0844d6c-xmpl-4463-97a4-d49f50839966",
1044
+ # memory_size: 256,
955
1045
  # publish: true,
956
- # role: "arn:aws:iam::123456789012:role/service-role/role-name", # replace with the actual arn of the execution role you created
1046
+ # role: "arn:aws:iam::123456789012:role/lambda-role",
957
1047
  # runtime: "nodejs12.x",
1048
+ # tags: {
1049
+ # "DEPARTMENT" => "Assets",
1050
+ # },
958
1051
  # timeout: 15,
959
- # vpc_config: {
1052
+ # tracing_config: {
1053
+ # mode: "Active",
960
1054
  # },
961
1055
  # })
962
1056
  #
963
1057
  # resp.to_h outputs the following:
964
1058
  # {
965
- # code_sha_256: "",
966
- # code_size: 123,
967
- # description: "",
968
- # function_arn: "arn:aws:lambda:us-west-2:123456789012:function:MyFunction",
969
- # function_name: "MyFunction",
970
- # handler: "source_file.handler_name",
971
- # last_modified: Time.parse("2016-11-21T19:49:20.006+0000"),
972
- # memory_size: 128,
973
- # role: "arn:aws:iam::123456789012:role/service-role/role-name",
1059
+ # code_sha_256: "YFgDgEKG3ugvF1+pX64gV6tu9qNuIYNUdgJm8nCxsm4=",
1060
+ # code_size: 5797206,
1061
+ # description: "Process image objects from Amazon S3.",
1062
+ # environment: {
1063
+ # variables: {
1064
+ # "BUCKET" => "my-bucket-1xpuxmplzrlbh",
1065
+ # "PREFIX" => "inbound",
1066
+ # },
1067
+ # },
1068
+ # function_arn: "arn:aws:lambda:us-west-2:123456789012:function:my-function",
1069
+ # function_name: "my-function",
1070
+ # handler: "index.handler",
1071
+ # kms_key_arn: "arn:aws:kms:us-west-2:123456789012:key/b0844d6c-xmpl-4463-97a4-d49f50839966",
1072
+ # last_modified: Time.parse("2020-04-10T19:06:32.563+0000"),
1073
+ # last_update_status: "Successful",
1074
+ # memory_size: 256,
1075
+ # revision_id: "b75dcd81-xmpl-48a8-a75a-93ba8b5b9727",
1076
+ # role: "arn:aws:iam::123456789012:role/lambda-role",
974
1077
  # runtime: "nodejs12.x",
975
- # timeout: 123,
976
- # version: "1",
977
- # vpc_config: {
1078
+ # state: "Active",
1079
+ # timeout: 15,
1080
+ # tracing_config: {
1081
+ # mode: "Active",
978
1082
  # },
1083
+ # version: "1",
979
1084
  # }
980
1085
  #
981
1086
  # @example Request syntax with placeholder values
982
1087
  #
983
1088
  # resp = client.create_function({
984
1089
  # function_name: "FunctionName", # required
985
- # runtime: "nodejs", # required, accepts nodejs, nodejs4.3, nodejs6.10, nodejs8.10, nodejs10.x, nodejs12.x, java8, java11, python2.7, python3.6, python3.7, python3.8, dotnetcore1.0, dotnetcore2.0, dotnetcore2.1, nodejs4.3-edge, go1.x, ruby2.5, ruby2.7, provided
1090
+ # runtime: "nodejs", # required, accepts nodejs, nodejs4.3, nodejs6.10, nodejs8.10, nodejs10.x, nodejs12.x, java8, java11, python2.7, python3.6, python3.7, python3.8, dotnetcore1.0, dotnetcore2.0, dotnetcore2.1, dotnetcore3.1, nodejs4.3-edge, go1.x, ruby2.5, ruby2.7, provided
986
1091
  # role: "RoleArn", # required
987
1092
  # handler: "Handler", # required
988
1093
  # code: { # required
@@ -1021,7 +1126,7 @@ module Aws::Lambda
1021
1126
  #
1022
1127
  # resp.function_name #=> String
1023
1128
  # resp.function_arn #=> String
1024
- # resp.runtime #=> String, one of "nodejs", "nodejs4.3", "nodejs6.10", "nodejs8.10", "nodejs10.x", "nodejs12.x", "java8", "java11", "python2.7", "python3.6", "python3.7", "python3.8", "dotnetcore1.0", "dotnetcore2.0", "dotnetcore2.1", "nodejs4.3-edge", "go1.x", "ruby2.5", "ruby2.7", "provided"
1129
+ # resp.runtime #=> String, one of "nodejs", "nodejs4.3", "nodejs6.10", "nodejs8.10", "nodejs10.x", "nodejs12.x", "java8", "java11", "python2.7", "python3.6", "python3.7", "python3.8", "dotnetcore1.0", "dotnetcore2.0", "dotnetcore2.1", "dotnetcore3.1", "nodejs4.3-edge", "go1.x", "ruby2.5", "ruby2.7", "provided"
1025
1130
  # resp.role #=> String
1026
1131
  # resp.handler #=> String
1027
1132
  # resp.code_size #=> Integer
@@ -1093,11 +1198,11 @@ module Aws::Lambda
1093
1198
  #
1094
1199
  # @example Example: To delete a Lambda function alias
1095
1200
  #
1096
- # # This operation deletes a Lambda function alias
1201
+ # # The following example deletes an alias named BLUE from a function named my-function
1097
1202
  #
1098
1203
  # resp = client.delete_alias({
1099
- # function_name: "myFunction",
1100
- # name: "alias",
1204
+ # function_name: "my-function",
1205
+ # name: "BLUE",
1101
1206
  # })
1102
1207
  #
1103
1208
  # @example Request syntax with placeholder values
@@ -1149,22 +1254,21 @@ module Aws::Lambda
1149
1254
  #
1150
1255
  # @example Example: To delete a Lambda function event source mapping
1151
1256
  #
1152
- # # This operation deletes a Lambda function event source mapping
1257
+ # # The following example deletes an event source mapping. To get a mapping's UUID, use ListEventSourceMappings.
1153
1258
  #
1154
1259
  # resp = client.delete_event_source_mapping({
1155
- # uuid: "12345kxodurf3443",
1260
+ # uuid: "14e0db71-xmpl-4eb5-b481-8945cf9d10c2",
1156
1261
  # })
1157
1262
  #
1158
1263
  # resp.to_h outputs the following:
1159
1264
  # {
1160
- # batch_size: 123,
1161
- # event_source_arn: "arn:aws:s3:::examplebucket/*",
1162
- # function_arn: "arn:aws:lambda:us-west-2:123456789012:function:myFunction",
1163
- # last_modified: Time.parse("2016-11-21T19:49:20.006+0000"),
1164
- # last_processing_result: "",
1165
- # state: "",
1166
- # state_transition_reason: "",
1167
- # uuid: "12345kxodurf3443",
1265
+ # batch_size: 5,
1266
+ # event_source_arn: "arn:aws:sqs:us-west-2:123456789012:my-queue",
1267
+ # function_arn: "arn:aws:lambda:us-east-2:123456789012:function:my-function",
1268
+ # last_modified: Time.parse("${timestamp}"),
1269
+ # state: "Enabled",
1270
+ # state_transition_reason: "USER_INITIATED",
1271
+ # uuid: "14e0db71-xmpl-4eb5-b481-8945cf9d10c2",
1168
1272
  # }
1169
1273
  #
1170
1274
  # @example Request syntax with placeholder values
@@ -1233,12 +1337,12 @@ module Aws::Lambda
1233
1337
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1234
1338
  #
1235
1339
  #
1236
- # @example Example: To delete a Lambda function
1340
+ # @example Example: To delete a version of a Lambda function
1237
1341
  #
1238
- # # This operation deletes a Lambda function
1342
+ # # The following example deletes version 1 of a Lambda function named my-function.
1239
1343
  #
1240
1344
  # resp = client.delete_function({
1241
- # function_name: "myFunction",
1345
+ # function_name: "my-function",
1242
1346
  # qualifier: "1",
1243
1347
  # })
1244
1348
  #
@@ -1277,6 +1381,15 @@ module Aws::Lambda
1277
1381
  #
1278
1382
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1279
1383
  #
1384
+ #
1385
+ # @example Example: To remove the reserved concurrent execution limit from a function
1386
+ #
1387
+ # # The following example deletes the reserved concurrent execution limit from a function named my-function.
1388
+ #
1389
+ # resp = client.delete_function_concurrency({
1390
+ # function_name: "my-function",
1391
+ # })
1392
+ #
1280
1393
  # @example Request syntax with placeholder values
1281
1394
  #
1282
1395
  # resp = client.delete_function_concurrency({
@@ -1320,6 +1433,17 @@ module Aws::Lambda
1320
1433
  #
1321
1434
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1322
1435
  #
1436
+ #
1437
+ # @example Example: To delete an asynchronous invocation configuration
1438
+ #
1439
+ # # The following example deletes the asynchronous invocation configuration for the GREEN alias of a function named
1440
+ # # my-function.
1441
+ #
1442
+ # resp = client.delete_function_event_invoke_config({
1443
+ # function_name: "my-function",
1444
+ # qualifier: "GREEN",
1445
+ # })
1446
+ #
1323
1447
  # @example Request syntax with placeholder values
1324
1448
  #
1325
1449
  # resp = client.delete_function_event_invoke_config({
@@ -1352,6 +1476,16 @@ module Aws::Lambda
1352
1476
  #
1353
1477
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1354
1478
  #
1479
+ #
1480
+ # @example Example: To delete a version of a Lambda layer
1481
+ #
1482
+ # # The following example deletes version 2 of a layer named my-layer.
1483
+ #
1484
+ # resp = client.delete_layer_version({
1485
+ # layer_name: "my-layer",
1486
+ # version_number: 2,
1487
+ # })
1488
+ #
1355
1489
  # @example Request syntax with placeholder values
1356
1490
  #
1357
1491
  # resp = client.delete_layer_version({
@@ -1390,6 +1524,17 @@ module Aws::Lambda
1390
1524
  #
1391
1525
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1392
1526
  #
1527
+ #
1528
+ # @example Example: To delete a provisioned concurrency configuration
1529
+ #
1530
+ # # The following example deletes the provisioned concurrency configuration for the GREEN alias of a function named
1531
+ # # my-function.
1532
+ #
1533
+ # resp = client.delete_provisioned_concurrency_config({
1534
+ # function_name: "my-function",
1535
+ # qualifier: "GREEN",
1536
+ # })
1537
+ #
1393
1538
  # @example Request syntax with placeholder values
1394
1539
  #
1395
1540
  # resp = client.delete_provisioned_concurrency_config({
@@ -1419,9 +1564,9 @@ module Aws::Lambda
1419
1564
  # * {Types::GetAccountSettingsResponse#account_usage #account_usage} => Types::AccountUsage
1420
1565
  #
1421
1566
  #
1422
- # @example Example: To retrieves a Lambda customer's account settings
1567
+ # @example Example: To get account settings
1423
1568
  #
1424
- # # This operation retrieves a Lambda customer's account settings
1569
+ # # This operation takes no parameters and returns details about storage and concurrency quotas in the current Region.
1425
1570
  #
1426
1571
  # resp = client.get_account_settings({
1427
1572
  # })
@@ -1429,8 +1574,15 @@ module Aws::Lambda
1429
1574
  # resp.to_h outputs the following:
1430
1575
  # {
1431
1576
  # account_limit: {
1577
+ # code_size_unzipped: 262144000,
1578
+ # code_size_zipped: 52428800,
1579
+ # concurrent_executions: 1000,
1580
+ # total_code_size: 80530636800,
1581
+ # unreserved_concurrent_executions: 1000,
1432
1582
  # },
1433
1583
  # account_usage: {
1584
+ # function_count: 4,
1585
+ # total_code_size: 9426,
1434
1586
  # },
1435
1587
  # }
1436
1588
  #
@@ -1487,21 +1639,22 @@ module Aws::Lambda
1487
1639
  # * {Types::AliasConfiguration#revision_id #revision_id} => String
1488
1640
  #
1489
1641
  #
1490
- # @example Example: To retrieve a Lambda function alias
1642
+ # @example Example: To get a Lambda function alias
1491
1643
  #
1492
- # # This operation retrieves a Lambda function alias
1644
+ # # The following example returns details about an alias named BLUE for a function named my-function
1493
1645
  #
1494
1646
  # resp = client.get_alias({
1495
- # function_name: "myFunction",
1496
- # name: "myFunctionAlias",
1647
+ # function_name: "my-function",
1648
+ # name: "BLUE",
1497
1649
  # })
1498
1650
  #
1499
1651
  # resp.to_h outputs the following:
1500
1652
  # {
1501
- # alias_arn: "arn:aws:lambda:us-west-2:123456789012:function:myFunctionAlias",
1502
- # description: "",
1503
- # function_version: "1",
1504
- # name: "myFunctionAlias",
1653
+ # alias_arn: "arn:aws:lambda:us-west-2:123456789012:function:my-function:BLUE",
1654
+ # description: "Production environment BLUE.",
1655
+ # function_version: "3",
1656
+ # name: "BLUE",
1657
+ # revision_id: "594f41fb-xmpl-4c20-95c7-6ca5f2a92c93",
1505
1658
  # }
1506
1659
  #
1507
1660
  # @example Request syntax with placeholder values
@@ -1554,24 +1707,30 @@ module Aws::Lambda
1554
1707
  # * {Types::EventSourceMappingConfiguration#maximum_retry_attempts #maximum_retry_attempts} => Integer
1555
1708
  #
1556
1709
  #
1557
- # @example Example: To retrieve a Lambda function's event source mapping
1710
+ # @example Example: To get a Lambda function's event source mapping
1558
1711
  #
1559
- # # This operation retrieves a Lambda function's event source mapping
1712
+ # # The following example returns details about an event source mapping. To get a mapping's UUID, use
1713
+ # # ListEventSourceMappings.
1560
1714
  #
1561
1715
  # resp = client.get_event_source_mapping({
1562
- # uuid: "123489-xxxxx-kdla8d89d7",
1716
+ # uuid: "14e0db71-xmpl-4eb5-b481-8945cf9d10c2",
1563
1717
  # })
1564
1718
  #
1565
1719
  # resp.to_h outputs the following:
1566
1720
  # {
1567
- # batch_size: 123,
1568
- # event_source_arn: "arn:aws:iam::123456789012:eventsource",
1569
- # function_arn: "arn:aws:lambda:us-west-2:123456789012:function:myFunction",
1570
- # last_modified: Time.parse("2016-11-21T19:49:20.006+0000"),
1571
- # last_processing_result: "",
1572
- # state: "",
1573
- # state_transition_reason: "",
1574
- # uuid: "123489-xxxxx-kdla8d89d7",
1721
+ # batch_size: 500,
1722
+ # bisect_batch_on_function_error: false,
1723
+ # destination_config: {
1724
+ # },
1725
+ # event_source_arn: "arn:aws:sqs:us-east-2:123456789012:mySQSqueue",
1726
+ # function_arn: "arn:aws:lambda:us-east-2:123456789012:function:myFunction",
1727
+ # last_modified: Time.parse("${timestamp}"),
1728
+ # last_processing_result: "No records processed",
1729
+ # maximum_record_age_in_seconds: 604800,
1730
+ # maximum_retry_attempts: 10000,
1731
+ # state: "Creating",
1732
+ # state_transition_reason: "User action",
1733
+ # uuid: "14e0db71-xmpl-4eb5-b481-8945cf9d10c2",
1575
1734
  # }
1576
1735
  #
1577
1736
  # @example Request syntax with placeholder values
@@ -1641,45 +1800,50 @@ module Aws::Lambda
1641
1800
  # * {Types::GetFunctionResponse#concurrency #concurrency} => Types::Concurrency
1642
1801
  #
1643
1802
  #
1644
- # @example Example: To retrieve a Lambda function's event source mapping
1803
+ # @example Example: To get a Lambda function
1645
1804
  #
1646
- # # This operation retrieves a Lambda function's event source mapping
1805
+ # # The following example returns code and configuration details for version 1 of a function named my-function.
1647
1806
  #
1648
1807
  # resp = client.get_function({
1649
- # function_name: "myFunction",
1808
+ # function_name: "my-function",
1650
1809
  # qualifier: "1",
1651
1810
  # })
1652
1811
  #
1653
1812
  # resp.to_h outputs the following:
1654
1813
  # {
1655
1814
  # code: {
1656
- # location: "somelocation",
1815
+ # location: "https://awslambda-us-west-2-tasks.s3.us-west-2.amazonaws.com/snapshots/123456789012/my-function-e7d9d1ed-xmpl-4f79-904a-4b87f2681f30?versionId=sH3TQwBOaUy...",
1657
1816
  # repository_type: "S3",
1658
1817
  # },
1659
1818
  # configuration: {
1660
- # code_sha_256: "LQT+0DHxxxxcfwLyQjzoEFKZtdqQjHXanlSdfXBlEW0VA=",
1661
- # code_size: 262,
1662
- # description: "A starter AWS Lambda function.",
1819
+ # code_sha_256: "YFgDgEKG3ugvF1+pX64gV6tu9qNuIYNUdgJm8nCxsm4=",
1820
+ # code_size: 5797206,
1821
+ # description: "Process image objects from Amazon S3.",
1663
1822
  # environment: {
1664
1823
  # variables: {
1665
- # "S3_BUCKET" => "test",
1824
+ # "BUCKET" => "my-bucket-1xpuxmplzrlbh",
1825
+ # "PREFIX" => "inbound",
1666
1826
  # },
1667
1827
  # },
1668
- # function_arn: "arn:aws:lambda:us-west-2:123456789012:function:myFunction",
1669
- # function_name: "myFunction",
1828
+ # function_arn: "arn:aws:lambda:us-west-2:123456789012:function:my-function",
1829
+ # function_name: "my-function",
1670
1830
  # handler: "index.handler",
1671
- # last_modified: Time.parse("2016-11-21T19:49:20.006+0000"),
1672
- # memory_size: 128,
1673
- # role: "arn:aws:iam::123456789012:role/lambda_basic_execution",
1831
+ # kms_key_arn: "arn:aws:kms:us-west-2:123456789012:key/b0844d6c-xmpl-4463-97a4-d49f50839966",
1832
+ # last_modified: Time.parse("2020-04-10T19:06:32.563+0000"),
1833
+ # last_update_status: "Successful",
1834
+ # memory_size: 256,
1835
+ # revision_id: "b75dcd81-xmpl-48a8-a75a-93ba8b5b9727",
1836
+ # role: "arn:aws:iam::123456789012:role/lambda-role",
1674
1837
  # runtime: "nodejs12.x",
1675
- # timeout: 3,
1676
- # version: "$LATEST",
1677
- # vpc_config: {
1678
- # security_group_ids: [
1679
- # ],
1680
- # subnet_ids: [
1681
- # ],
1838
+ # state: "Active",
1839
+ # timeout: 15,
1840
+ # tracing_config: {
1841
+ # mode: "Active",
1682
1842
  # },
1843
+ # version: "$LATEST",
1844
+ # },
1845
+ # tags: {
1846
+ # "DEPARTMENT" => "Assets",
1683
1847
  # },
1684
1848
  # }
1685
1849
  #
@@ -1694,7 +1858,7 @@ module Aws::Lambda
1694
1858
  #
1695
1859
  # resp.configuration.function_name #=> String
1696
1860
  # resp.configuration.function_arn #=> String
1697
- # resp.configuration.runtime #=> String, one of "nodejs", "nodejs4.3", "nodejs6.10", "nodejs8.10", "nodejs10.x", "nodejs12.x", "java8", "java11", "python2.7", "python3.6", "python3.7", "python3.8", "dotnetcore1.0", "dotnetcore2.0", "dotnetcore2.1", "nodejs4.3-edge", "go1.x", "ruby2.5", "ruby2.7", "provided"
1861
+ # resp.configuration.runtime #=> String, one of "nodejs", "nodejs4.3", "nodejs6.10", "nodejs8.10", "nodejs10.x", "nodejs12.x", "java8", "java11", "python2.7", "python3.6", "python3.7", "python3.8", "dotnetcore1.0", "dotnetcore2.0", "dotnetcore2.1", "dotnetcore3.1", "nodejs4.3-edge", "go1.x", "ruby2.5", "ruby2.7", "provided"
1698
1862
  # resp.configuration.role #=> String
1699
1863
  # resp.configuration.handler #=> String
1700
1864
  # resp.configuration.code_size #=> Integer
@@ -1733,6 +1897,11 @@ module Aws::Lambda
1733
1897
  # resp.tags["TagKey"] #=> String
1734
1898
  # resp.concurrency.reserved_concurrent_executions #=> Integer
1735
1899
  #
1900
+ #
1901
+ # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
1902
+ #
1903
+ # * function_exists
1904
+ #
1736
1905
  # @see http://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/GetFunction AWS API Documentation
1737
1906
  #
1738
1907
  # @overload get_function(params = {})
@@ -1765,6 +1934,20 @@ module Aws::Lambda
1765
1934
  #
1766
1935
  # * {Types::GetFunctionConcurrencyResponse#reserved_concurrent_executions #reserved_concurrent_executions} => Integer
1767
1936
  #
1937
+ #
1938
+ # @example Example: To get the reserved concurrency setting for a function
1939
+ #
1940
+ # # The following example returns the reserved concurrency setting for a function named my-function.
1941
+ #
1942
+ # resp = client.get_function_concurrency({
1943
+ # function_name: "my-function",
1944
+ # })
1945
+ #
1946
+ # resp.to_h outputs the following:
1947
+ # {
1948
+ # reserved_concurrent_executions: 250,
1949
+ # }
1950
+ #
1768
1951
  # @example Request syntax with placeholder values
1769
1952
  #
1770
1953
  # resp = client.get_function_concurrency({
@@ -1842,36 +2025,42 @@ module Aws::Lambda
1842
2025
  # * {Types::FunctionConfiguration#last_update_status_reason_code #last_update_status_reason_code} => String
1843
2026
  #
1844
2027
  #
1845
- # @example Example: To retrieve a Lambda function's event source mapping
2028
+ # @example Example: To get a Lambda function's event source mapping
1846
2029
  #
1847
- # # This operation retrieves a Lambda function's event source mapping
2030
+ # # The following example returns and configuration details for version 1 of a function named my-function.
1848
2031
  #
1849
2032
  # resp = client.get_function_configuration({
1850
- # function_name: "myFunction",
2033
+ # function_name: "my-function",
1851
2034
  # qualifier: "1",
1852
2035
  # })
1853
2036
  #
1854
2037
  # resp.to_h outputs the following:
1855
2038
  # {
1856
- # code_sha_256: "LQT+0DHxxxxcfwLyQjzoEFKZtdqQjHXanlSdfXBlEW0VA=",
1857
- # code_size: 123,
1858
- # dead_letter_config: {
1859
- # },
1860
- # description: "",
2039
+ # code_sha_256: "YFgDgEKG3ugvF1+pX64gV6tu9qNuIYNUdgJm8nCxsm4=",
2040
+ # code_size: 5797206,
2041
+ # description: "Process image objects from Amazon S3.",
1861
2042
  # environment: {
2043
+ # variables: {
2044
+ # "BUCKET" => "my-bucket-1xpuxmplzrlbh",
2045
+ # "PREFIX" => "inbound",
2046
+ # },
1862
2047
  # },
1863
- # function_arn: "arn:aws:lambda:us-west-2:123456789012:function:myFunction",
1864
- # function_name: "myFunction",
2048
+ # function_arn: "arn:aws:lambda:us-west-2:123456789012:function:my-function",
2049
+ # function_name: "my-function",
1865
2050
  # handler: "index.handler",
1866
- # kms_key_arn: "",
1867
- # last_modified: Time.parse("2016-11-21T19:49:20.006+0000"),
1868
- # memory_size: 128,
1869
- # role: "arn:aws:iam::123456789012:role/lambda_basic_execution",
1870
- # runtime: "python2.7",
1871
- # timeout: 123,
1872
- # version: "1",
1873
- # vpc_config: {
2051
+ # kms_key_arn: "arn:aws:kms:us-west-2:123456789012:key/b0844d6c-xmpl-4463-97a4-d49f50839966",
2052
+ # last_modified: Time.parse("2020-04-10T19:06:32.563+0000"),
2053
+ # last_update_status: "Successful",
2054
+ # memory_size: 256,
2055
+ # revision_id: "b75dcd81-xmpl-48a8-a75a-93ba8b5b9727",
2056
+ # role: "arn:aws:iam::123456789012:role/lambda-role",
2057
+ # runtime: "nodejs12.x",
2058
+ # state: "Active",
2059
+ # timeout: 15,
2060
+ # tracing_config: {
2061
+ # mode: "Active",
1874
2062
  # },
2063
+ # version: "$LATEST",
1875
2064
  # }
1876
2065
  #
1877
2066
  # @example Request syntax with placeholder values
@@ -1885,7 +2074,7 @@ module Aws::Lambda
1885
2074
  #
1886
2075
  # resp.function_name #=> String
1887
2076
  # resp.function_arn #=> String
1888
- # resp.runtime #=> String, one of "nodejs", "nodejs4.3", "nodejs6.10", "nodejs8.10", "nodejs10.x", "nodejs12.x", "java8", "java11", "python2.7", "python3.6", "python3.7", "python3.8", "dotnetcore1.0", "dotnetcore2.0", "dotnetcore2.1", "nodejs4.3-edge", "go1.x", "ruby2.5", "ruby2.7", "provided"
2077
+ # resp.runtime #=> String, one of "nodejs", "nodejs4.3", "nodejs6.10", "nodejs8.10", "nodejs10.x", "nodejs12.x", "java8", "java11", "python2.7", "python3.6", "python3.7", "python3.8", "dotnetcore1.0", "dotnetcore2.0", "dotnetcore2.1", "dotnetcore3.1", "nodejs4.3-edge", "go1.x", "ruby2.5", "ruby2.7", "provided"
1889
2078
  # resp.role #=> String
1890
2079
  # resp.handler #=> String
1891
2080
  # resp.code_size #=> Integer
@@ -1919,6 +2108,12 @@ module Aws::Lambda
1919
2108
  # resp.last_update_status_reason #=> String
1920
2109
  # resp.last_update_status_reason_code #=> String, one of "EniLimitExceeded", "InsufficientRolePermissions", "InvalidConfiguration", "InternalError", "SubnetOutOfIPAddresses", "InvalidSubnet", "InvalidSecurityGroup"
1921
2110
  #
2111
+ #
2112
+ # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
2113
+ #
2114
+ # * function_active
2115
+ # * function_updated
2116
+ #
1922
2117
  # @see http://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/GetFunctionConfiguration AWS API Documentation
1923
2118
  #
1924
2119
  # @overload get_function_configuration(params = {})
@@ -1962,6 +2157,32 @@ module Aws::Lambda
1962
2157
  # * {Types::FunctionEventInvokeConfig#maximum_event_age_in_seconds #maximum_event_age_in_seconds} => Integer
1963
2158
  # * {Types::FunctionEventInvokeConfig#destination_config #destination_config} => Types::DestinationConfig
1964
2159
  #
2160
+ #
2161
+ # @example Example: To get an asynchronous invocation configuration
2162
+ #
2163
+ # # The following example returns the asynchronous invocation configuration for the BLUE alias of a function named
2164
+ # # my-function.
2165
+ #
2166
+ # resp = client.get_function_event_invoke_config({
2167
+ # function_name: "my-function",
2168
+ # qualifier: "BLUE",
2169
+ # })
2170
+ #
2171
+ # resp.to_h outputs the following:
2172
+ # {
2173
+ # destination_config: {
2174
+ # on_failure: {
2175
+ # destination: "arn:aws:sqs:us-east-2:123456789012:failed-invocations",
2176
+ # },
2177
+ # on_success: {
2178
+ # },
2179
+ # },
2180
+ # function_arn: "arn:aws:lambda:us-east-2:123456789012:function:my-function:BLUE",
2181
+ # last_modified: Time.parse("${timestamp}"),
2182
+ # maximum_event_age_in_seconds: 3600,
2183
+ # maximum_retry_attempts: 0,
2184
+ # }
2185
+ #
1965
2186
  # @example Request syntax with placeholder values
1966
2187
  #
1967
2188
  # resp = client.get_function_event_invoke_config({
@@ -2011,6 +2232,35 @@ module Aws::Lambda
2011
2232
  # * {Types::GetLayerVersionResponse#compatible_runtimes #compatible_runtimes} => Array<String>
2012
2233
  # * {Types::GetLayerVersionResponse#license_info #license_info} => String
2013
2234
  #
2235
+ #
2236
+ # @example Example: To get information about a Lambda layer version
2237
+ #
2238
+ # # The following example returns information for version 1 of a layer named my-layer.
2239
+ #
2240
+ # resp = client.get_layer_version({
2241
+ # layer_name: "my-layer",
2242
+ # version_number: 1,
2243
+ # })
2244
+ #
2245
+ # resp.to_h outputs the following:
2246
+ # {
2247
+ # compatible_runtimes: [
2248
+ # "python3.6",
2249
+ # "python3.7",
2250
+ # ],
2251
+ # content: {
2252
+ # code_sha_256: "tv9jJO+rPbXUUXuRKi7CwHzKtLDkDRJLB3cC3Z/ouXo=",
2253
+ # code_size: 169,
2254
+ # location: "https://awslambda-us-east-2-layers.s3.us-east-2.amazonaws.com/snapshots/123456789012/my-layer-4aaa2fbb-ff77-4b0a-ad92-5b78a716a96a?versionId=27iWyA73cCAYqyH...",
2255
+ # },
2256
+ # created_date: Time.parse("2018-11-14T23:03:52.894+0000"),
2257
+ # description: "My Python layer",
2258
+ # layer_arn: "arn:aws:lambda:us-east-2:123456789012:layer:my-layer",
2259
+ # layer_version_arn: "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:1",
2260
+ # license_info: "MIT",
2261
+ # version: 1,
2262
+ # }
2263
+ #
2014
2264
  # @example Request syntax with placeholder values
2015
2265
  #
2016
2266
  # resp = client.get_layer_version({
@@ -2029,7 +2279,7 @@ module Aws::Lambda
2029
2279
  # resp.created_date #=> Time
2030
2280
  # resp.version #=> Integer
2031
2281
  # resp.compatible_runtimes #=> Array
2032
- # resp.compatible_runtimes[0] #=> String, one of "nodejs", "nodejs4.3", "nodejs6.10", "nodejs8.10", "nodejs10.x", "nodejs12.x", "java8", "java11", "python2.7", "python3.6", "python3.7", "python3.8", "dotnetcore1.0", "dotnetcore2.0", "dotnetcore2.1", "nodejs4.3-edge", "go1.x", "ruby2.5", "ruby2.7", "provided"
2282
+ # resp.compatible_runtimes[0] #=> String, one of "nodejs", "nodejs4.3", "nodejs6.10", "nodejs8.10", "nodejs10.x", "nodejs12.x", "java8", "java11", "python2.7", "python3.6", "python3.7", "python3.8", "dotnetcore1.0", "dotnetcore2.0", "dotnetcore2.1", "dotnetcore3.1", "nodejs4.3-edge", "go1.x", "ruby2.5", "ruby2.7", "provided"
2033
2283
  # resp.license_info #=> String
2034
2284
  #
2035
2285
  # @see http://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/GetLayerVersion AWS API Documentation
@@ -2062,6 +2312,32 @@ module Aws::Lambda
2062
2312
  # * {Types::GetLayerVersionResponse#compatible_runtimes #compatible_runtimes} => Array<String>
2063
2313
  # * {Types::GetLayerVersionResponse#license_info #license_info} => String
2064
2314
  #
2315
+ #
2316
+ # @example Example: To get information about a Lambda layer version
2317
+ #
2318
+ # # The following example returns information about the layer version with the specified Amazon Resource Name (ARN).
2319
+ #
2320
+ # resp = client.get_layer_version_by_arn({
2321
+ # arn: "arn:aws:lambda:ca-central-1:123456789012:layer:blank-python-lib:3",
2322
+ # })
2323
+ #
2324
+ # resp.to_h outputs the following:
2325
+ # {
2326
+ # compatible_runtimes: [
2327
+ # "python3.8",
2328
+ # ],
2329
+ # content: {
2330
+ # code_sha_256: "6x+xmpl/M3BnQUk7gS9sGmfeFsR/npojXoA3fZUv4eU=",
2331
+ # code_size: 9529009,
2332
+ # location: "https://awslambda-us-east-2-layers.s3.us-east-2.amazonaws.com/snapshots/123456789012/blank-python-lib-e5212378-xmpl-44ee-8398-9d8ec5113949?versionId=WbZnvf...",
2333
+ # },
2334
+ # created_date: Time.parse("2020-03-31T00:35:18.949+0000"),
2335
+ # description: "Dependencies for the blank-python sample app.",
2336
+ # layer_arn: "arn:aws:lambda:us-east-2:123456789012:layer:blank-python-lib",
2337
+ # layer_version_arn: "arn:aws:lambda:us-east-2:123456789012:layer:blank-python-lib:3",
2338
+ # version: 3,
2339
+ # }
2340
+ #
2065
2341
  # @example Request syntax with placeholder values
2066
2342
  #
2067
2343
  # resp = client.get_layer_version_by_arn({
@@ -2079,7 +2355,7 @@ module Aws::Lambda
2079
2355
  # resp.created_date #=> Time
2080
2356
  # resp.version #=> Integer
2081
2357
  # resp.compatible_runtimes #=> Array
2082
- # resp.compatible_runtimes[0] #=> String, one of "nodejs", "nodejs4.3", "nodejs6.10", "nodejs8.10", "nodejs10.x", "nodejs12.x", "java8", "java11", "python2.7", "python3.6", "python3.7", "python3.8", "dotnetcore1.0", "dotnetcore2.0", "dotnetcore2.1", "nodejs4.3-edge", "go1.x", "ruby2.5", "ruby2.7", "provided"
2358
+ # resp.compatible_runtimes[0] #=> String, one of "nodejs", "nodejs4.3", "nodejs6.10", "nodejs8.10", "nodejs10.x", "nodejs12.x", "java8", "java11", "python2.7", "python3.6", "python3.7", "python3.8", "dotnetcore1.0", "dotnetcore2.0", "dotnetcore2.1", "dotnetcore3.1", "nodejs4.3-edge", "go1.x", "ruby2.5", "ruby2.7", "provided"
2083
2359
  # resp.license_info #=> String
2084
2360
  #
2085
2361
  # @see http://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/GetLayerVersionByArn AWS API Documentation
@@ -2165,16 +2441,17 @@ module Aws::Lambda
2165
2441
  #
2166
2442
  # @example Example: To retrieve a Lambda function policy
2167
2443
  #
2168
- # # This operation retrieves a Lambda function policy
2444
+ # # The following example returns the resource-based policy for version 1 of a Lambda function named my-function.
2169
2445
  #
2170
2446
  # resp = client.get_policy({
2171
- # function_name: "myFunction",
2447
+ # function_name: "my-function",
2172
2448
  # qualifier: "1",
2173
2449
  # })
2174
2450
  #
2175
2451
  # resp.to_h outputs the following:
2176
2452
  # {
2177
- # policy: "",
2453
+ # policy: "{\"Version\":\"2012-10-17\",\"Id\":\"default\",\"Statement\":[{\"Sid\":\"xaccount\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::123456789012:root\"},\"Action\":\"lambda:InvokeFunction\",\"Resource\":\"arn:aws:lambda:us-east-2:123456789012:function:my-function:1\"}]}",
2454
+ # revision_id: "4843f2f6-7c59-4fda-b484-afd0bc0e22b8",
2178
2455
  # }
2179
2456
  #
2180
2457
  # @example Request syntax with placeholder values
@@ -2228,6 +2505,45 @@ module Aws::Lambda
2228
2505
  # * {Types::GetProvisionedConcurrencyConfigResponse#status_reason #status_reason} => String
2229
2506
  # * {Types::GetProvisionedConcurrencyConfigResponse#last_modified #last_modified} => Time
2230
2507
  #
2508
+ #
2509
+ # @example Example: To get a provisioned concurrency configuration
2510
+ #
2511
+ # # The following example returns details for the provisioned concurrency configuration for the BLUE alias of the specified
2512
+ # # function.
2513
+ #
2514
+ # resp = client.get_provisioned_concurrency_config({
2515
+ # function_name: "my-function",
2516
+ # qualifier: "BLUE",
2517
+ # })
2518
+ #
2519
+ # resp.to_h outputs the following:
2520
+ # {
2521
+ # allocated_provisioned_concurrent_executions: 100,
2522
+ # available_provisioned_concurrent_executions: 100,
2523
+ # last_modified: Time.parse("2019-12-31T20:28:49+0000"),
2524
+ # requested_provisioned_concurrent_executions: 100,
2525
+ # status: "READY",
2526
+ # }
2527
+ #
2528
+ # @example Example: To view a provisioned concurrency configuration
2529
+ #
2530
+ # # The following example displays details for the provisioned concurrency configuration for the BLUE alias of the specified
2531
+ # # function.
2532
+ #
2533
+ # resp = client.get_provisioned_concurrency_config({
2534
+ # function_name: "my-function",
2535
+ # qualifier: "BLUE",
2536
+ # })
2537
+ #
2538
+ # resp.to_h outputs the following:
2539
+ # {
2540
+ # allocated_provisioned_concurrent_executions: 100,
2541
+ # available_provisioned_concurrent_executions: 100,
2542
+ # last_modified: Time.parse("2019-12-31T20:28:49+0000"),
2543
+ # requested_provisioned_concurrent_executions: 100,
2544
+ # status: "READY",
2545
+ # }
2546
+ #
2231
2547
  # @example Request syntax with placeholder values
2232
2548
  #
2233
2549
  # resp = client.get_provisioned_concurrency_config({
@@ -2289,7 +2605,7 @@ module Aws::Lambda
2289
2605
  # your HTTP client, SDK, firewall, proxy, or operating system to allow
2290
2606
  # for long connections with timeout or keep-alive settings.
2291
2607
  #
2292
- # This operation requires permission for the `lambda:InvokeFunction`
2608
+ # This operation requires permission for the [lambda:InvokeFunction][8]
2293
2609
  # action.
2294
2610
  #
2295
2611
  #
@@ -2301,6 +2617,7 @@ module Aws::Lambda
2301
2617
  # [5]: https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html
2302
2618
  # [6]: https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#dlq
2303
2619
  # [7]: https://docs.aws.amazon.com/lambda/latest/dg/limits.html
2620
+ # [8]: https://docs.aws.amazon.com/IAM/latest/UserGuide/list_awslambda.html
2304
2621
  #
2305
2622
  # @option params [required, String] :function_name
2306
2623
  # The name of the Lambda function, version, or alias.
@@ -2359,23 +2676,35 @@ module Aws::Lambda
2359
2676
  #
2360
2677
  # @example Example: To invoke a Lambda function
2361
2678
  #
2362
- # # This operation invokes a Lambda function
2679
+ # # The following example invokes version 1 of a function named my-function with an empty event payload.
2363
2680
  #
2364
2681
  # resp = client.invoke({
2365
- # client_context: "MyApp",
2366
- # function_name: "MyFunction",
2682
+ # function_name: "my-function",
2683
+ # payload: "{}",
2684
+ # qualifier: "1",
2685
+ # })
2686
+ #
2687
+ # resp.to_h outputs the following:
2688
+ # {
2689
+ # payload: "200 SUCCESS",
2690
+ # status_code: 200,
2691
+ # }
2692
+ #
2693
+ # @example Example: To invoke a Lambda function asynchronously
2694
+ #
2695
+ # # The following example invokes version 1 of a function named my-function asynchronously.
2696
+ #
2697
+ # resp = client.invoke({
2698
+ # function_name: "my-function",
2367
2699
  # invocation_type: "Event",
2368
- # log_type: "Tail",
2369
- # payload: "fileb://file-path/input.json",
2700
+ # payload: "{}",
2370
2701
  # qualifier: "1",
2371
2702
  # })
2372
2703
  #
2373
2704
  # resp.to_h outputs the following:
2374
2705
  # {
2375
- # function_error: "",
2376
- # log_result: "",
2377
- # payload: "?",
2378
- # status_code: 123,
2706
+ # payload: "",
2707
+ # status_code: 202,
2379
2708
  # }
2380
2709
  #
2381
2710
  # @example Request syntax with placeholder values
@@ -2435,16 +2764,16 @@ module Aws::Lambda
2435
2764
  #
2436
2765
  # @example Example: To invoke a Lambda function asynchronously
2437
2766
  #
2438
- # # This operation invokes a Lambda function asynchronously
2767
+ # # The following example invokes a Lambda function asynchronously
2439
2768
  #
2440
2769
  # resp = client.invoke_async({
2441
- # function_name: "myFunction",
2442
- # invoke_args: "fileb://file-path/input.json",
2770
+ # function_name: "my-function",
2771
+ # invoke_args: "{}",
2443
2772
  # })
2444
2773
  #
2445
2774
  # resp.to_h outputs the following:
2446
2775
  # {
2447
- # status: 123,
2776
+ # status: 202,
2448
2777
  # }
2449
2778
  #
2450
2779
  # @example Request syntax with placeholder values
@@ -2504,23 +2833,40 @@ module Aws::Lambda
2504
2833
  # * {Types::ListAliasesResponse#next_marker #next_marker} => String
2505
2834
  # * {Types::ListAliasesResponse#aliases #aliases} => Array<Types::AliasConfiguration>
2506
2835
  #
2836
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2507
2837
  #
2508
- # @example Example: To retrieve a Lambda function aliases
2509
2838
  #
2510
- # # This operation retrieves a Lambda function's aliases
2839
+ # @example Example: To list a function's aliases
2840
+ #
2841
+ # # The following example returns a list of aliases for a function named my-function.
2511
2842
  #
2512
2843
  # resp = client.list_aliases({
2513
- # function_name: "myFunction",
2514
- # function_version: "1",
2515
- # marker: "",
2516
- # max_items: 123,
2844
+ # function_name: "my-function",
2517
2845
  # })
2518
2846
  #
2519
2847
  # resp.to_h outputs the following:
2520
2848
  # {
2521
2849
  # aliases: [
2850
+ # {
2851
+ # alias_arn: "arn:aws:lambda:us-west-2:123456789012:function:my-function:BETA",
2852
+ # description: "Production environment BLUE.",
2853
+ # function_version: "2",
2854
+ # name: "BLUE",
2855
+ # revision_id: "a410117f-xmpl-494e-8035-7e204bb7933b",
2856
+ # routing_config: {
2857
+ # additional_version_weights: {
2858
+ # "1" => 0.7,
2859
+ # },
2860
+ # },
2861
+ # },
2862
+ # {
2863
+ # alias_arn: "arn:aws:lambda:us-west-2:123456789012:function:my-function:LIVE",
2864
+ # description: "Production environment GREEN.",
2865
+ # function_version: "1",
2866
+ # name: "GREEN",
2867
+ # revision_id: "21d40116-xmpl-40ba-9360-3ea284da1bb5",
2868
+ # },
2522
2869
  # ],
2523
- # next_marker: "",
2524
2870
  # }
2525
2871
  #
2526
2872
  # @example Request syntax with placeholder values
@@ -2595,6 +2941,32 @@ module Aws::Lambda
2595
2941
  # * {Types::ListEventSourceMappingsResponse#next_marker #next_marker} => String
2596
2942
  # * {Types::ListEventSourceMappingsResponse#event_source_mappings #event_source_mappings} => Array<Types::EventSourceMappingConfiguration>
2597
2943
  #
2944
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2945
+ #
2946
+ #
2947
+ # @example Example: To list the event source mappings for a function
2948
+ #
2949
+ # # The following example returns a list of the event source mappings for a function named my-function.
2950
+ #
2951
+ # resp = client.list_event_source_mappings({
2952
+ # function_name: "my-function",
2953
+ # })
2954
+ #
2955
+ # resp.to_h outputs the following:
2956
+ # {
2957
+ # event_source_mappings: [
2958
+ # {
2959
+ # batch_size: 5,
2960
+ # event_source_arn: "arn:aws:sqs:us-west-2:123456789012:mySQSqueue",
2961
+ # function_arn: "arn:aws:lambda:us-west-2:123456789012:function:my-function",
2962
+ # last_modified: Time.parse(1569284520.333),
2963
+ # state: "Enabled",
2964
+ # state_transition_reason: "USER_INITIATED",
2965
+ # uuid: "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
2966
+ # },
2967
+ # ],
2968
+ # }
2969
+ #
2598
2970
  # @example Request syntax with placeholder values
2599
2971
  #
2600
2972
  # resp = client.list_event_source_mappings({
@@ -2666,6 +3038,35 @@ module Aws::Lambda
2666
3038
  # * {Types::ListFunctionEventInvokeConfigsResponse#function_event_invoke_configs #function_event_invoke_configs} => Array<Types::FunctionEventInvokeConfig>
2667
3039
  # * {Types::ListFunctionEventInvokeConfigsResponse#next_marker #next_marker} => String
2668
3040
  #
3041
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3042
+ #
3043
+ #
3044
+ # @example Example: To view a list of asynchronous invocation configurations
3045
+ #
3046
+ # # The following example returns a list of asynchronous invocation configurations for a function named my-function.
3047
+ #
3048
+ # resp = client.list_function_event_invoke_configs({
3049
+ # function_name: "my-function",
3050
+ # })
3051
+ #
3052
+ # resp.to_h outputs the following:
3053
+ # {
3054
+ # function_event_invoke_configs: [
3055
+ # {
3056
+ # function_arn: "arn:aws:lambda:us-east-2:123456789012:function:my-function:GREEN",
3057
+ # last_modified: Time.parse(1577824406.719),
3058
+ # maximum_event_age_in_seconds: 1800,
3059
+ # maximum_retry_attempts: 2,
3060
+ # },
3061
+ # {
3062
+ # function_arn: "arn:aws:lambda:us-east-2:123456789012:function:my-function:BLUE",
3063
+ # last_modified: Time.parse(1577824396.653),
3064
+ # maximum_event_age_in_seconds: 3600,
3065
+ # maximum_retry_attempts: 0,
3066
+ # },
3067
+ # ],
3068
+ # }
3069
+ #
2669
3070
  # @example Request syntax with placeholder values
2670
3071
  #
2671
3072
  # resp = client.list_function_event_invoke_configs({
@@ -2723,19 +3124,62 @@ module Aws::Lambda
2723
3124
  # * {Types::ListFunctionsResponse#next_marker #next_marker} => String
2724
3125
  # * {Types::ListFunctionsResponse#functions #functions} => Array<Types::FunctionConfiguration>
2725
3126
  #
3127
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3128
+ #
2726
3129
  #
2727
- # @example Example: To retrieve a list of Lambda functions
3130
+ # @example Example: To get a list of Lambda functions
2728
3131
  #
2729
- # # This operation retrieves a Lambda functions
3132
+ # # This operation returns a list of Lambda functions.
2730
3133
  #
2731
3134
  # resp = client.list_functions({
2732
- # marker: "",
2733
- # max_items: 25,
2734
3135
  # })
2735
3136
  #
2736
3137
  # resp.to_h outputs the following:
2737
3138
  # {
2738
3139
  # functions: [
3140
+ # {
3141
+ # code_sha_256: "dBG9m8SGdmlEjw/JYXlhhvCrAv5TxvXsbL/RMr0fT/I=",
3142
+ # code_size: 294,
3143
+ # description: "",
3144
+ # function_arn: "arn:aws:lambda:us-west-2:123456789012:function:helloworld",
3145
+ # function_name: "helloworld",
3146
+ # handler: "helloworld.handler",
3147
+ # last_modified: Time.parse("2019-09-23T18:32:33.857+0000"),
3148
+ # memory_size: 128,
3149
+ # revision_id: "1718e831-badf-4253-9518-d0644210af7b",
3150
+ # role: "arn:aws:iam::123456789012:role/service-role/MyTestFunction-role-zgur6bf4",
3151
+ # runtime: "nodejs10.x",
3152
+ # timeout: 3,
3153
+ # tracing_config: {
3154
+ # mode: "PassThrough",
3155
+ # },
3156
+ # version: "$LATEST",
3157
+ # },
3158
+ # {
3159
+ # code_sha_256: "sU0cJ2/hOZevwV/lTxCuQqK3gDZP3i8gUoqUUVRmY6E=",
3160
+ # code_size: 266,
3161
+ # description: "",
3162
+ # function_arn: "arn:aws:lambda:us-west-2:123456789012:function:my-function",
3163
+ # function_name: "my-function",
3164
+ # handler: "index.handler",
3165
+ # last_modified: Time.parse("2019-10-01T16:47:28.490+0000"),
3166
+ # memory_size: 256,
3167
+ # revision_id: "93017fc9-59cb-41dc-901b-4845ce4bf668",
3168
+ # role: "arn:aws:iam::123456789012:role/service-role/helloWorldPython-role-uy3l9qyq",
3169
+ # runtime: "nodejs10.x",
3170
+ # timeout: 3,
3171
+ # tracing_config: {
3172
+ # mode: "PassThrough",
3173
+ # },
3174
+ # version: "$LATEST",
3175
+ # vpc_config: {
3176
+ # security_group_ids: [
3177
+ # ],
3178
+ # subnet_ids: [
3179
+ # ],
3180
+ # vpc_id: "",
3181
+ # },
3182
+ # },
2739
3183
  # ],
2740
3184
  # next_marker: "",
2741
3185
  # }
@@ -2755,7 +3199,7 @@ module Aws::Lambda
2755
3199
  # resp.functions #=> Array
2756
3200
  # resp.functions[0].function_name #=> String
2757
3201
  # resp.functions[0].function_arn #=> String
2758
- # resp.functions[0].runtime #=> String, one of "nodejs", "nodejs4.3", "nodejs6.10", "nodejs8.10", "nodejs10.x", "nodejs12.x", "java8", "java11", "python2.7", "python3.6", "python3.7", "python3.8", "dotnetcore1.0", "dotnetcore2.0", "dotnetcore2.1", "nodejs4.3-edge", "go1.x", "ruby2.5", "ruby2.7", "provided"
3202
+ # resp.functions[0].runtime #=> String, one of "nodejs", "nodejs4.3", "nodejs6.10", "nodejs8.10", "nodejs10.x", "nodejs12.x", "java8", "java11", "python2.7", "python3.6", "python3.7", "python3.8", "dotnetcore1.0", "dotnetcore2.0", "dotnetcore2.1", "dotnetcore3.1", "nodejs4.3-edge", "go1.x", "ruby2.5", "ruby2.7", "provided"
2759
3203
  # resp.functions[0].role #=> String
2760
3204
  # resp.functions[0].handler #=> String
2761
3205
  # resp.functions[0].code_size #=> Integer
@@ -2825,10 +3269,45 @@ module Aws::Lambda
2825
3269
  # * {Types::ListLayerVersionsResponse#next_marker #next_marker} => String
2826
3270
  # * {Types::ListLayerVersionsResponse#layer_versions #layer_versions} => Array<Types::LayerVersionsListItem>
2827
3271
  #
3272
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3273
+ #
3274
+ #
3275
+ # @example Example: To list versions of a layer
3276
+ #
3277
+ # # The following example displays information about the versions for the layer named blank-java-lib
3278
+ #
3279
+ # resp = client.list_layer_versions({
3280
+ # layer_name: "blank-java-lib",
3281
+ # })
3282
+ #
3283
+ # resp.to_h outputs the following:
3284
+ # {
3285
+ # layer_versions: [
3286
+ # {
3287
+ # compatible_runtimes: [
3288
+ # "java8",
3289
+ # ],
3290
+ # created_date: Time.parse("2020-03-18T23:38:42.284+0000"),
3291
+ # description: "Dependencies for the blank-java sample app.",
3292
+ # layer_version_arn: "arn:aws:lambda:us-east-2:123456789012:layer:blank-java-lib:7",
3293
+ # version: 7,
3294
+ # },
3295
+ # {
3296
+ # compatible_runtimes: [
3297
+ # "java8",
3298
+ # ],
3299
+ # created_date: Time.parse("2020-03-17T07:24:21.960+0000"),
3300
+ # description: "Dependencies for the blank-java sample app.",
3301
+ # layer_version_arn: "arn:aws:lambda:us-east-2:123456789012:layer:blank-java-lib:6",
3302
+ # version: 6,
3303
+ # },
3304
+ # ],
3305
+ # }
3306
+ #
2828
3307
  # @example Request syntax with placeholder values
2829
3308
  #
2830
3309
  # resp = client.list_layer_versions({
2831
- # compatible_runtime: "nodejs", # accepts nodejs, nodejs4.3, nodejs6.10, nodejs8.10, nodejs10.x, nodejs12.x, java8, java11, python2.7, python3.6, python3.7, python3.8, dotnetcore1.0, dotnetcore2.0, dotnetcore2.1, nodejs4.3-edge, go1.x, ruby2.5, ruby2.7, provided
3310
+ # compatible_runtime: "nodejs", # accepts nodejs, nodejs4.3, nodejs6.10, nodejs8.10, nodejs10.x, nodejs12.x, java8, java11, python2.7, python3.6, python3.7, python3.8, dotnetcore1.0, dotnetcore2.0, dotnetcore2.1, dotnetcore3.1, nodejs4.3-edge, go1.x, ruby2.5, ruby2.7, provided
2832
3311
  # layer_name: "LayerName", # required
2833
3312
  # marker: "String",
2834
3313
  # max_items: 1,
@@ -2843,7 +3322,7 @@ module Aws::Lambda
2843
3322
  # resp.layer_versions[0].description #=> String
2844
3323
  # resp.layer_versions[0].created_date #=> Time
2845
3324
  # resp.layer_versions[0].compatible_runtimes #=> Array
2846
- # resp.layer_versions[0].compatible_runtimes[0] #=> String, one of "nodejs", "nodejs4.3", "nodejs6.10", "nodejs8.10", "nodejs10.x", "nodejs12.x", "java8", "java11", "python2.7", "python3.6", "python3.7", "python3.8", "dotnetcore1.0", "dotnetcore2.0", "dotnetcore2.1", "nodejs4.3-edge", "go1.x", "ruby2.5", "ruby2.7", "provided"
3325
+ # resp.layer_versions[0].compatible_runtimes[0] #=> String, one of "nodejs", "nodejs4.3", "nodejs6.10", "nodejs8.10", "nodejs10.x", "nodejs12.x", "java8", "java11", "python2.7", "python3.6", "python3.7", "python3.8", "dotnetcore1.0", "dotnetcore2.0", "dotnetcore2.1", "dotnetcore3.1", "nodejs4.3-edge", "go1.x", "ruby2.5", "ruby2.7", "provided"
2847
3326
  # resp.layer_versions[0].license_info #=> String
2848
3327
  #
2849
3328
  # @see http://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/ListLayerVersions AWS API Documentation
@@ -2878,10 +3357,41 @@ module Aws::Lambda
2878
3357
  # * {Types::ListLayersResponse#next_marker #next_marker} => String
2879
3358
  # * {Types::ListLayersResponse#layers #layers} => Array<Types::LayersListItem>
2880
3359
  #
3360
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3361
+ #
3362
+ #
3363
+ # @example Example: To list the layers that are compatible with your function's runtime
3364
+ #
3365
+ # # The following example returns information about layers that are compatible with the Python 3.7 runtime.
3366
+ #
3367
+ # resp = client.list_layers({
3368
+ # compatible_runtime: "python3.7",
3369
+ # })
3370
+ #
3371
+ # resp.to_h outputs the following:
3372
+ # {
3373
+ # layers: [
3374
+ # {
3375
+ # latest_matching_version: {
3376
+ # compatible_runtimes: [
3377
+ # "python3.6",
3378
+ # "python3.7",
3379
+ # ],
3380
+ # created_date: Time.parse("2018-11-15T00:37:46.592+0000"),
3381
+ # description: "My layer",
3382
+ # layer_version_arn: "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:2",
3383
+ # version: 2,
3384
+ # },
3385
+ # layer_arn: "arn:aws:lambda:us-east-2:123456789012:layer:my-layer",
3386
+ # layer_name: "my-layer",
3387
+ # },
3388
+ # ],
3389
+ # }
3390
+ #
2881
3391
  # @example Request syntax with placeholder values
2882
3392
  #
2883
3393
  # resp = client.list_layers({
2884
- # compatible_runtime: "nodejs", # accepts nodejs, nodejs4.3, nodejs6.10, nodejs8.10, nodejs10.x, nodejs12.x, java8, java11, python2.7, python3.6, python3.7, python3.8, dotnetcore1.0, dotnetcore2.0, dotnetcore2.1, nodejs4.3-edge, go1.x, ruby2.5, ruby2.7, provided
3394
+ # compatible_runtime: "nodejs", # accepts nodejs, nodejs4.3, nodejs6.10, nodejs8.10, nodejs10.x, nodejs12.x, java8, java11, python2.7, python3.6, python3.7, python3.8, dotnetcore1.0, dotnetcore2.0, dotnetcore2.1, dotnetcore3.1, nodejs4.3-edge, go1.x, ruby2.5, ruby2.7, provided
2885
3395
  # marker: "String",
2886
3396
  # max_items: 1,
2887
3397
  # })
@@ -2897,7 +3407,7 @@ module Aws::Lambda
2897
3407
  # resp.layers[0].latest_matching_version.description #=> String
2898
3408
  # resp.layers[0].latest_matching_version.created_date #=> Time
2899
3409
  # resp.layers[0].latest_matching_version.compatible_runtimes #=> Array
2900
- # resp.layers[0].latest_matching_version.compatible_runtimes[0] #=> String, one of "nodejs", "nodejs4.3", "nodejs6.10", "nodejs8.10", "nodejs10.x", "nodejs12.x", "java8", "java11", "python2.7", "python3.6", "python3.7", "python3.8", "dotnetcore1.0", "dotnetcore2.0", "dotnetcore2.1", "nodejs4.3-edge", "go1.x", "ruby2.5", "ruby2.7", "provided"
3410
+ # resp.layers[0].latest_matching_version.compatible_runtimes[0] #=> String, one of "nodejs", "nodejs4.3", "nodejs6.10", "nodejs8.10", "nodejs10.x", "nodejs12.x", "java8", "java11", "python2.7", "python3.6", "python3.7", "python3.8", "dotnetcore1.0", "dotnetcore2.0", "dotnetcore2.1", "dotnetcore3.1", "nodejs4.3-edge", "go1.x", "ruby2.5", "ruby2.7", "provided"
2901
3411
  # resp.layers[0].latest_matching_version.license_info #=> String
2902
3412
  #
2903
3413
  # @see http://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/ListLayers AWS API Documentation
@@ -2939,6 +3449,39 @@ module Aws::Lambda
2939
3449
  # * {Types::ListProvisionedConcurrencyConfigsResponse#provisioned_concurrency_configs #provisioned_concurrency_configs} => Array<Types::ProvisionedConcurrencyConfigListItem>
2940
3450
  # * {Types::ListProvisionedConcurrencyConfigsResponse#next_marker #next_marker} => String
2941
3451
  #
3452
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3453
+ #
3454
+ #
3455
+ # @example Example: To get a list of provisioned concurrency configurations
3456
+ #
3457
+ # # The following example returns a list of provisioned concurrency configurations for a function named my-function.
3458
+ #
3459
+ # resp = client.list_provisioned_concurrency_configs({
3460
+ # function_name: "my-function",
3461
+ # })
3462
+ #
3463
+ # resp.to_h outputs the following:
3464
+ # {
3465
+ # provisioned_concurrency_configs: [
3466
+ # {
3467
+ # allocated_provisioned_concurrent_executions: 100,
3468
+ # available_provisioned_concurrent_executions: 100,
3469
+ # function_arn: "arn:aws:lambda:us-east-2:123456789012:function:my-function:GREEN",
3470
+ # last_modified: Time.parse("2019-12-31T20:29:00+0000"),
3471
+ # requested_provisioned_concurrent_executions: 100,
3472
+ # status: "READY",
3473
+ # },
3474
+ # {
3475
+ # allocated_provisioned_concurrent_executions: 100,
3476
+ # available_provisioned_concurrent_executions: 100,
3477
+ # function_arn: "arn:aws:lambda:us-east-2:123456789012:function:my-function:BLUE",
3478
+ # last_modified: Time.parse("2019-12-31T20:28:49+0000"),
3479
+ # requested_provisioned_concurrent_executions: 100,
3480
+ # status: "READY",
3481
+ # },
3482
+ # ],
3483
+ # }
3484
+ #
2942
3485
  # @example Request syntax with placeholder values
2943
3486
  #
2944
3487
  # resp = client.list_provisioned_concurrency_configs({
@@ -2982,6 +3525,23 @@ module Aws::Lambda
2982
3525
  #
2983
3526
  # * {Types::ListTagsResponse#tags #tags} => Hash<String,String>
2984
3527
  #
3528
+ #
3529
+ # @example Example: To retrieve the list of tags for a Lambda function
3530
+ #
3531
+ # # The following example displays the tags attached to the my-function Lambda function.
3532
+ #
3533
+ # resp = client.list_tags({
3534
+ # resource: "arn:aws:lambda:us-west-2:123456789012:function:my-function",
3535
+ # })
3536
+ #
3537
+ # resp.to_h outputs the following:
3538
+ # {
3539
+ # tags: {
3540
+ # "Category" => "Web Tools",
3541
+ # "Department" => "Sales",
3542
+ # },
3543
+ # }
3544
+ #
2985
3545
  # @example Request syntax with placeholder values
2986
3546
  #
2987
3547
  # resp = client.list_tags({
@@ -3036,21 +3596,70 @@ module Aws::Lambda
3036
3596
  # * {Types::ListVersionsByFunctionResponse#next_marker #next_marker} => String
3037
3597
  # * {Types::ListVersionsByFunctionResponse#versions #versions} => Array<Types::FunctionConfiguration>
3038
3598
  #
3599
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3600
+ #
3039
3601
  #
3040
- # @example Example: To retrieve a list of Lambda function versions
3602
+ # @example Example: To list versions of a function
3041
3603
  #
3042
- # # This operation retrieves a Lambda function versions
3604
+ # # The following example returns a list of versions of a function named my-function
3043
3605
  #
3044
3606
  # resp = client.list_versions_by_function({
3045
- # function_name: "myFunction",
3046
- # marker: "",
3047
- # max_items: 25,
3607
+ # function_name: "my-function",
3048
3608
  # })
3049
3609
  #
3050
3610
  # resp.to_h outputs the following:
3051
3611
  # {
3052
- # next_marker: "",
3053
3612
  # versions: [
3613
+ # {
3614
+ # code_sha_256: "YFgDgEKG3ugvF1+pX64gV6tu9qNuIYNUdgJm8nCxsm4=",
3615
+ # code_size: 5797206,
3616
+ # description: "Process image objects from Amazon S3.",
3617
+ # environment: {
3618
+ # variables: {
3619
+ # "BUCKET" => "my-bucket-1xpuxmplzrlbh",
3620
+ # "PREFIX" => "inbound",
3621
+ # },
3622
+ # },
3623
+ # function_arn: "arn:aws:lambda:us-west-2:123456789012:function:my-function",
3624
+ # function_name: "my-function",
3625
+ # handler: "index.handler",
3626
+ # kms_key_arn: "arn:aws:kms:us-west-2:123456789012:key/b0844d6c-xmpl-4463-97a4-d49f50839966",
3627
+ # last_modified: Time.parse("2020-04-10T19:06:32.563+0000"),
3628
+ # memory_size: 256,
3629
+ # revision_id: "850ca006-2d98-4ff4-86db-8766e9d32fe9",
3630
+ # role: "arn:aws:iam::123456789012:role/lambda-role",
3631
+ # runtime: "nodejs12.x",
3632
+ # timeout: 15,
3633
+ # tracing_config: {
3634
+ # mode: "Active",
3635
+ # },
3636
+ # version: "$LATEST",
3637
+ # },
3638
+ # {
3639
+ # code_sha_256: "YFgDgEKG3ugvF1+pX64gV6tu9qNuIYNUdgJm8nCxsm4=",
3640
+ # code_size: 5797206,
3641
+ # description: "Process image objects from Amazon S3.",
3642
+ # environment: {
3643
+ # variables: {
3644
+ # "BUCKET" => "my-bucket-1xpuxmplzrlbh",
3645
+ # "PREFIX" => "inbound",
3646
+ # },
3647
+ # },
3648
+ # function_arn: "arn:aws:lambda:us-west-2:123456789012:function:my-function",
3649
+ # function_name: "my-function",
3650
+ # handler: "index.handler",
3651
+ # kms_key_arn: "arn:aws:kms:us-west-2:123456789012:key/b0844d6c-xmpl-4463-97a4-d49f50839966",
3652
+ # last_modified: Time.parse("2020-04-10T19:06:32.563+0000"),
3653
+ # memory_size: 256,
3654
+ # revision_id: "b75dcd81-xmpl-48a8-a75a-93ba8b5b9727",
3655
+ # role: "arn:aws:iam::123456789012:role/lambda-role",
3656
+ # runtime: "nodejs12.x",
3657
+ # timeout: 5,
3658
+ # tracing_config: {
3659
+ # mode: "Active",
3660
+ # },
3661
+ # version: "1",
3662
+ # },
3054
3663
  # ],
3055
3664
  # }
3056
3665
  #
@@ -3068,7 +3677,7 @@ module Aws::Lambda
3068
3677
  # resp.versions #=> Array
3069
3678
  # resp.versions[0].function_name #=> String
3070
3679
  # resp.versions[0].function_arn #=> String
3071
- # resp.versions[0].runtime #=> String, one of "nodejs", "nodejs4.3", "nodejs6.10", "nodejs8.10", "nodejs10.x", "nodejs12.x", "java8", "java11", "python2.7", "python3.6", "python3.7", "python3.8", "dotnetcore1.0", "dotnetcore2.0", "dotnetcore2.1", "nodejs4.3-edge", "go1.x", "ruby2.5", "ruby2.7", "provided"
3680
+ # resp.versions[0].runtime #=> String, one of "nodejs", "nodejs4.3", "nodejs6.10", "nodejs8.10", "nodejs10.x", "nodejs12.x", "java8", "java11", "python2.7", "python3.6", "python3.7", "python3.8", "dotnetcore1.0", "dotnetcore2.0", "dotnetcore2.1", "dotnetcore3.1", "nodejs4.3-edge", "go1.x", "ruby2.5", "ruby2.7", "provided"
3072
3681
  # resp.versions[0].role #=> String
3073
3682
  # resp.versions[0].handler #=> String
3074
3683
  # resp.versions[0].code_size #=> Integer
@@ -3164,6 +3773,45 @@ module Aws::Lambda
3164
3773
  # * {Types::PublishLayerVersionResponse#compatible_runtimes #compatible_runtimes} => Array<String>
3165
3774
  # * {Types::PublishLayerVersionResponse#license_info #license_info} => String
3166
3775
  #
3776
+ #
3777
+ # @example Example: To create a Lambda layer version
3778
+ #
3779
+ # # The following example creates a new Python library layer version. The command retrieves the layer content a file named
3780
+ # # layer.zip in the specified S3 bucket.
3781
+ #
3782
+ # resp = client.publish_layer_version({
3783
+ # compatible_runtimes: [
3784
+ # "python3.6",
3785
+ # "python3.7",
3786
+ # ],
3787
+ # content: {
3788
+ # s3_bucket: "lambda-layers-us-west-2-123456789012",
3789
+ # s3_key: "layer.zip",
3790
+ # },
3791
+ # description: "My Python layer",
3792
+ # layer_name: "my-layer",
3793
+ # license_info: "MIT",
3794
+ # })
3795
+ #
3796
+ # resp.to_h outputs the following:
3797
+ # {
3798
+ # compatible_runtimes: [
3799
+ # "python3.6",
3800
+ # "python3.7",
3801
+ # ],
3802
+ # content: {
3803
+ # code_sha_256: "tv9jJO+rPbXUUXuRKi7CwHzKtLDkDRJLB3cC3Z/ouXo=",
3804
+ # code_size: 169,
3805
+ # location: "https://awslambda-us-west-2-layers.s3.us-west-2.amazonaws.com/snapshots/123456789012/my-layer-4aaa2fbb-ff77-4b0a-ad92-5b78a716a96a?versionId=27iWyA73cCAYqyH...",
3806
+ # },
3807
+ # created_date: Time.parse("2018-11-14T23:03:52.894+0000"),
3808
+ # description: "My Python layer",
3809
+ # layer_arn: "arn:aws:lambda:us-west-2:123456789012:layer:my-layer",
3810
+ # layer_version_arn: "arn:aws:lambda:us-west-2:123456789012:layer:my-layer:1",
3811
+ # license_info: "MIT",
3812
+ # version: 1,
3813
+ # }
3814
+ #
3167
3815
  # @example Request syntax with placeholder values
3168
3816
  #
3169
3817
  # resp = client.publish_layer_version({
@@ -3175,7 +3823,7 @@ module Aws::Lambda
3175
3823
  # s3_object_version: "S3ObjectVersion",
3176
3824
  # zip_file: "data",
3177
3825
  # },
3178
- # compatible_runtimes: ["nodejs"], # accepts nodejs, nodejs4.3, nodejs6.10, nodejs8.10, nodejs10.x, nodejs12.x, java8, java11, python2.7, python3.6, python3.7, python3.8, dotnetcore1.0, dotnetcore2.0, dotnetcore2.1, nodejs4.3-edge, go1.x, ruby2.5, ruby2.7, provided
3826
+ # compatible_runtimes: ["nodejs"], # accepts nodejs, nodejs4.3, nodejs6.10, nodejs8.10, nodejs10.x, nodejs12.x, java8, java11, python2.7, python3.6, python3.7, python3.8, dotnetcore1.0, dotnetcore2.0, dotnetcore2.1, dotnetcore3.1, nodejs4.3-edge, go1.x, ruby2.5, ruby2.7, provided
3179
3827
  # license_info: "LicenseInfo",
3180
3828
  # })
3181
3829
  #
@@ -3190,7 +3838,7 @@ module Aws::Lambda
3190
3838
  # resp.created_date #=> Time
3191
3839
  # resp.version #=> Integer
3192
3840
  # resp.compatible_runtimes #=> Array
3193
- # resp.compatible_runtimes[0] #=> String, one of "nodejs", "nodejs4.3", "nodejs6.10", "nodejs8.10", "nodejs10.x", "nodejs12.x", "java8", "java11", "python2.7", "python3.6", "python3.7", "python3.8", "dotnetcore1.0", "dotnetcore2.0", "dotnetcore2.1", "nodejs4.3-edge", "go1.x", "ruby2.5", "ruby2.7", "provided"
3841
+ # resp.compatible_runtimes[0] #=> String, one of "nodejs", "nodejs4.3", "nodejs6.10", "nodejs8.10", "nodejs10.x", "nodejs12.x", "java8", "java11", "python2.7", "python3.6", "python3.7", "python3.8", "dotnetcore1.0", "dotnetcore2.0", "dotnetcore2.1", "dotnetcore3.1", "nodejs4.3-edge", "go1.x", "ruby2.5", "ruby2.7", "provided"
3194
3842
  # resp.license_info #=> String
3195
3843
  #
3196
3844
  # @see http://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/PublishLayerVersion AWS API Documentation
@@ -3291,20 +3939,31 @@ module Aws::Lambda
3291
3939
  #
3292
3940
  # resp.to_h outputs the following:
3293
3941
  # {
3294
- # code_sha_256: "",
3295
- # code_size: 123,
3296
- # description: "",
3297
- # function_arn: "arn:aws:lambda:us-west-2:123456789012:function:myFunction",
3298
- # function_name: "myFunction",
3942
+ # code_sha_256: "YFgDgEKG3ugvF1+pX64gV6tu9qNuIYNUdgJm8nCxsm4=",
3943
+ # code_size: 5797206,
3944
+ # description: "Process image objects from Amazon S3.",
3945
+ # environment: {
3946
+ # variables: {
3947
+ # "BUCKET" => "my-bucket-1xpuxmplzrlbh",
3948
+ # "PREFIX" => "inbound",
3949
+ # },
3950
+ # },
3951
+ # function_arn: "arn:aws:lambda:us-west-2:123456789012:function:my-function",
3952
+ # function_name: "my-function",
3299
3953
  # handler: "index.handler",
3300
- # last_modified: Time.parse("2016-11-21T19:49:20.006+0000"),
3301
- # memory_size: 128,
3302
- # role: "arn:aws:iam::123456789012:role/lambda_basic_execution",
3303
- # runtime: "python2.7",
3304
- # timeout: 123,
3305
- # version: "1",
3306
- # vpc_config: {
3954
+ # kms_key_arn: "arn:aws:kms:us-west-2:123456789012:key/b0844d6c-xmpl-4463-97a4-d49f50839966",
3955
+ # last_modified: Time.parse("2020-04-10T19:06:32.563+0000"),
3956
+ # last_update_status: "Successful",
3957
+ # memory_size: 256,
3958
+ # revision_id: "b75dcd81-xmpl-48a8-a75a-93ba8b5b9727",
3959
+ # role: "arn:aws:iam::123456789012:role/lambda-role",
3960
+ # runtime: "nodejs12.x",
3961
+ # state: "Active",
3962
+ # timeout: 5,
3963
+ # tracing_config: {
3964
+ # mode: "Active",
3307
3965
  # },
3966
+ # version: "1",
3308
3967
  # }
3309
3968
  #
3310
3969
  # @example Request syntax with placeholder values
@@ -3320,7 +3979,7 @@ module Aws::Lambda
3320
3979
  #
3321
3980
  # resp.function_name #=> String
3322
3981
  # resp.function_arn #=> String
3323
- # resp.runtime #=> String, one of "nodejs", "nodejs4.3", "nodejs6.10", "nodejs8.10", "nodejs10.x", "nodejs12.x", "java8", "java11", "python2.7", "python3.6", "python3.7", "python3.8", "dotnetcore1.0", "dotnetcore2.0", "dotnetcore2.1", "nodejs4.3-edge", "go1.x", "ruby2.5", "ruby2.7", "provided"
3982
+ # resp.runtime #=> String, one of "nodejs", "nodejs4.3", "nodejs6.10", "nodejs8.10", "nodejs10.x", "nodejs12.x", "java8", "java11", "python2.7", "python3.6", "python3.7", "python3.8", "dotnetcore1.0", "dotnetcore2.0", "dotnetcore2.1", "dotnetcore3.1", "nodejs4.3-edge", "go1.x", "ruby2.5", "ruby2.7", "provided"
3324
3983
  # resp.role #=> String
3325
3984
  # resp.handler #=> String
3326
3985
  # resp.code_size #=> Integer
@@ -3404,6 +4063,21 @@ module Aws::Lambda
3404
4063
  #
3405
4064
  # * {Types::Concurrency#reserved_concurrent_executions #reserved_concurrent_executions} => Integer
3406
4065
  #
4066
+ #
4067
+ # @example Example: To configure a reserved concurrency limit for a function
4068
+ #
4069
+ # # The following example configures 100 reserved concurrent executions for the my-function function.
4070
+ #
4071
+ # resp = client.put_function_concurrency({
4072
+ # function_name: "my-function",
4073
+ # reserved_concurrent_executions: 100,
4074
+ # })
4075
+ #
4076
+ # resp.to_h outputs the following:
4077
+ # {
4078
+ # reserved_concurrent_executions: 100,
4079
+ # }
4080
+ #
3407
4081
  # @example Request syntax with placeholder values
3408
4082
  #
3409
4083
  # resp = client.put_function_concurrency({
@@ -3498,6 +4172,31 @@ module Aws::Lambda
3498
4172
  # * {Types::FunctionEventInvokeConfig#maximum_event_age_in_seconds #maximum_event_age_in_seconds} => Integer
3499
4173
  # * {Types::FunctionEventInvokeConfig#destination_config #destination_config} => Types::DestinationConfig
3500
4174
  #
4175
+ #
4176
+ # @example Example: To configure error handling for asynchronous invocation
4177
+ #
4178
+ # # The following example sets a maximum event age of one hour and disables retries for the specified function.
4179
+ #
4180
+ # resp = client.put_function_event_invoke_config({
4181
+ # function_name: "my-function",
4182
+ # maximum_event_age_in_seconds: 3600,
4183
+ # maximum_retry_attempts: 0,
4184
+ # })
4185
+ #
4186
+ # resp.to_h outputs the following:
4187
+ # {
4188
+ # destination_config: {
4189
+ # on_failure: {
4190
+ # },
4191
+ # on_success: {
4192
+ # },
4193
+ # },
4194
+ # function_arn: "arn:aws:lambda:us-east-2:123456789012:function:my-function:$LATEST",
4195
+ # last_modified: Time.parse("${timestamp}"),
4196
+ # maximum_event_age_in_seconds: 3600,
4197
+ # maximum_retry_attempts: 0,
4198
+ # }
4199
+ #
3501
4200
  # @example Request syntax with placeholder values
3502
4201
  #
3503
4202
  # resp = client.put_function_event_invoke_config({
@@ -3567,6 +4266,25 @@ module Aws::Lambda
3567
4266
  # * {Types::PutProvisionedConcurrencyConfigResponse#status_reason #status_reason} => String
3568
4267
  # * {Types::PutProvisionedConcurrencyConfigResponse#last_modified #last_modified} => Time
3569
4268
  #
4269
+ #
4270
+ # @example Example: To allocate provisioned concurrency
4271
+ #
4272
+ # # The following example allocates 100 provisioned concurrency for the BLUE alias of the specified function.
4273
+ #
4274
+ # resp = client.put_provisioned_concurrency_config({
4275
+ # function_name: "my-function",
4276
+ # provisioned_concurrent_executions: 100,
4277
+ # qualifier: "BLUE",
4278
+ # })
4279
+ #
4280
+ # resp.to_h outputs the following:
4281
+ # {
4282
+ # allocated_provisioned_concurrent_executions: 0,
4283
+ # last_modified: Time.parse("2019-11-21T19:32:12+0000"),
4284
+ # requested_provisioned_concurrent_executions: 100,
4285
+ # status: "IN_PROGRESS",
4286
+ # }
4287
+ #
3570
4288
  # @example Request syntax with placeholder values
3571
4289
  #
3572
4290
  # resp = client.put_provisioned_concurrency_config({
@@ -3617,6 +4335,17 @@ module Aws::Lambda
3617
4335
  #
3618
4336
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
3619
4337
  #
4338
+ #
4339
+ # @example Example: To delete layer-version permissions
4340
+ #
4341
+ # # The following example deletes permission for an account to configure a layer version.
4342
+ #
4343
+ # resp = client.remove_layer_version_permission({
4344
+ # layer_name: "my-layer",
4345
+ # statement_id: "xaccount",
4346
+ # version_number: 1,
4347
+ # })
4348
+ #
3620
4349
  # @example Request syntax with placeholder values
3621
4350
  #
3622
4351
  # resp = client.remove_layer_version_permission({
@@ -3673,12 +4402,13 @@ module Aws::Lambda
3673
4402
  #
3674
4403
  # @example Example: To remove a Lambda function's permissions
3675
4404
  #
3676
- # # This operation removes a Lambda function's permissions
4405
+ # # The following example removes a permissions statement named xaccount from the PROD alias of a function named
4406
+ # # my-function.
3677
4407
  #
3678
4408
  # resp = client.remove_permission({
3679
- # function_name: "myFunction",
3680
- # qualifier: "1",
3681
- # statement_id: "role-statement-id",
4409
+ # function_name: "my-function",
4410
+ # qualifier: "PROD",
4411
+ # statement_id: "xaccount",
3682
4412
  # })
3683
4413
  #
3684
4414
  # @example Request syntax with placeholder values
@@ -3713,6 +4443,19 @@ module Aws::Lambda
3713
4443
  #
3714
4444
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
3715
4445
  #
4446
+ #
4447
+ # @example Example: To add tags to an existing Lambda function
4448
+ #
4449
+ # # The following example adds a tag with the key name DEPARTMENT and a value of 'Department A' to the specified Lambda
4450
+ # # function.
4451
+ #
4452
+ # resp = client.tag_resource({
4453
+ # resource: "arn:aws:lambda:us-west-2:123456789012:function:my-function",
4454
+ # tags: {
4455
+ # "DEPARTMENT" => "Department A",
4456
+ # },
4457
+ # })
4458
+ #
3716
4459
  # @example Request syntax with placeholder values
3717
4460
  #
3718
4461
  # resp = client.tag_resource({
@@ -3745,6 +4488,18 @@ module Aws::Lambda
3745
4488
  #
3746
4489
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
3747
4490
  #
4491
+ #
4492
+ # @example Example: To remove tags from an existing Lambda function
4493
+ #
4494
+ # # The following example removes the tag with the key name DEPARTMENT tag from the my-function Lambda function.
4495
+ #
4496
+ # resp = client.untag_resource({
4497
+ # resource: "arn:aws:lambda:us-west-2:123456789012:function:my-function",
4498
+ # tag_keys: [
4499
+ # "DEPARTMENT",
4500
+ # ],
4501
+ # })
4502
+ #
3748
4503
  # @example Request syntax with placeholder values
3749
4504
  #
3750
4505
  # resp = client.untag_resource({
@@ -3813,23 +4568,33 @@ module Aws::Lambda
3813
4568
  # * {Types::AliasConfiguration#revision_id #revision_id} => String
3814
4569
  #
3815
4570
  #
3816
- # @example Example: To update a Lambda function alias
4571
+ # @example Example: To update a function alias
3817
4572
  #
3818
- # # This operation updates a Lambda function alias
4573
+ # # The following example updates the alias named BLUE to send 30% of traffic to version 2 and 70% to version 1.
3819
4574
  #
3820
4575
  # resp = client.update_alias({
3821
- # description: "",
3822
- # function_name: "myFunction",
3823
- # function_version: "1",
3824
- # name: "functionAlias",
4576
+ # function_name: "my-function",
4577
+ # function_version: "2",
4578
+ # name: "BLUE",
4579
+ # routing_config: {
4580
+ # additional_version_weights: {
4581
+ # "1" => 0.7,
4582
+ # },
4583
+ # },
3825
4584
  # })
3826
4585
  #
3827
4586
  # resp.to_h outputs the following:
3828
4587
  # {
3829
- # alias_arn: "arn:aws:lambda:us-west-2:123456789012:function:functionAlias",
3830
- # description: "",
3831
- # function_version: "1",
3832
- # name: "functionAlias",
4588
+ # alias_arn: "arn:aws:lambda:us-west-2:123456789012:function:my-function:BLUE",
4589
+ # description: "Production environment BLUE.",
4590
+ # function_version: "2",
4591
+ # name: "BLUE",
4592
+ # revision_id: "594f41fb-xmpl-4c20-95c7-6ca5f2a92c93",
4593
+ # routing_config: {
4594
+ # additional_version_weights: {
4595
+ # "1" => 0.7,
4596
+ # },
4597
+ # },
3833
4598
  # }
3834
4599
  #
3835
4600
  # @example Request syntax with placeholder values
@@ -3922,8 +4687,8 @@ module Aws::Lambda
3922
4687
  # * **Amazon Simple Queue Service** - Default 10. Max 10.
3923
4688
  #
3924
4689
  # @option params [Integer] :maximum_batching_window_in_seconds
3925
- # The maximum amount of time to gather records before invoking the
3926
- # function, in seconds.
4690
+ # (Streams) The maximum amount of time to gather records before invoking
4691
+ # the function, in seconds.
3927
4692
  #
3928
4693
  # @option params [Types::DestinationConfig] :destination_config
3929
4694
  # (Streams) An Amazon SQS queue or Amazon SNS topic destination for
@@ -4116,33 +4881,33 @@ module Aws::Lambda
4116
4881
  #
4117
4882
  # @example Example: To update a Lambda function's code
4118
4883
  #
4119
- # # This operation updates a Lambda function's code
4884
+ # # The following example replaces the code of the unpublished ($LATEST) version of a function named my-function with the
4885
+ # # contents of the specified zip file in Amazon S3.
4120
4886
  #
4121
4887
  # resp = client.update_function_code({
4122
- # function_name: "myFunction",
4123
- # publish: true,
4124
- # s3_bucket: "myBucket",
4125
- # s3_key: "myKey",
4126
- # s3_object_version: "1",
4127
- # zip_file: "fileb://file-path/file.zip",
4888
+ # function_name: "my-function",
4889
+ # s3_bucket: "my-bucket-1xpuxmplzrlbh",
4890
+ # s3_key: "function.zip",
4128
4891
  # })
4129
4892
  #
4130
4893
  # resp.to_h outputs the following:
4131
4894
  # {
4132
- # code_sha_256: "LQT+0DHxxxxcfwLyQjzoEFKZtdqQjHXanlSdfXBlEW0VA=",
4133
- # code_size: 123,
4895
+ # code_sha_256: "PFn4S+er27qk+UuZSTKEQfNKG/XNn7QJs90mJgq6oH8=",
4896
+ # code_size: 308,
4134
4897
  # description: "",
4135
- # function_arn: "arn:aws:lambda:us-west-2:123456789012:function:myFunction",
4136
- # function_name: "myFunction",
4898
+ # function_arn: "arn:aws:lambda:us-east-2:123456789012:function:my-function",
4899
+ # function_name: "my-function",
4137
4900
  # handler: "index.handler",
4138
- # last_modified: Time.parse("2016-11-21T19:49:20.006+0000"),
4901
+ # last_modified: Time.parse("2019-08-14T22:26:11.234+0000"),
4139
4902
  # memory_size: 128,
4140
- # role: "arn:aws:iam::123456789012:role/lambda_basic_execution",
4141
- # runtime: "python2.7",
4142
- # timeout: 123,
4143
- # version: "1",
4144
- # vpc_config: {
4903
+ # revision_id: "873282ed-xmpl-4dc8-a069-d0c647e470c6",
4904
+ # role: "arn:aws:iam::123456789012:role/lambda-role",
4905
+ # runtime: "nodejs12.x",
4906
+ # timeout: 3,
4907
+ # tracing_config: {
4908
+ # mode: "PassThrough",
4145
4909
  # },
4910
+ # version: "$LATEST",
4146
4911
  # }
4147
4912
  #
4148
4913
  # @example Request syntax with placeholder values
@@ -4162,7 +4927,7 @@ module Aws::Lambda
4162
4927
  #
4163
4928
  # resp.function_name #=> String
4164
4929
  # resp.function_arn #=> String
4165
- # resp.runtime #=> String, one of "nodejs", "nodejs4.3", "nodejs6.10", "nodejs8.10", "nodejs10.x", "nodejs12.x", "java8", "java11", "python2.7", "python3.6", "python3.7", "python3.8", "dotnetcore1.0", "dotnetcore2.0", "dotnetcore2.1", "nodejs4.3-edge", "go1.x", "ruby2.5", "ruby2.7", "provided"
4930
+ # resp.runtime #=> String, one of "nodejs", "nodejs4.3", "nodejs6.10", "nodejs8.10", "nodejs10.x", "nodejs12.x", "java8", "java11", "python2.7", "python3.6", "python3.7", "python3.8", "dotnetcore1.0", "dotnetcore2.0", "dotnetcore2.1", "dotnetcore3.1", "nodejs4.3-edge", "go1.x", "ruby2.5", "ruby2.7", "provided"
4166
4931
  # resp.role #=> String
4167
4932
  # resp.handler #=> String
4168
4933
  # resp.code_size #=> Integer
@@ -4354,36 +5119,32 @@ module Aws::Lambda
4354
5119
  #
4355
5120
  # @example Example: To update a Lambda function's configuration
4356
5121
  #
4357
- # # This operation updates a Lambda function's configuration
5122
+ # # The following example modifies the memory size to be 256 MB for the unpublished ($LATEST) version of a function named
5123
+ # # my-function.
4358
5124
  #
4359
5125
  # resp = client.update_function_configuration({
4360
- # description: "",
4361
- # function_name: "myFunction",
4362
- # handler: "index.handler",
4363
- # memory_size: 128,
4364
- # role: "arn:aws:iam::123456789012:role/lambda_basic_execution",
4365
- # runtime: "python2.7",
4366
- # timeout: 123,
4367
- # vpc_config: {
4368
- # },
5126
+ # function_name: "my-function",
5127
+ # memory_size: 256,
4369
5128
  # })
4370
5129
  #
4371
5130
  # resp.to_h outputs the following:
4372
5131
  # {
4373
- # code_sha_256: "LQT+0DHxxxxcfwLyQjzoEFKZtdqQjHXanlSdfXBlEW0VA=",
4374
- # code_size: 123,
5132
+ # code_sha_256: "PFn4S+er27qk+UuZSTKEQfNKG/XNn7QJs90mJgq6oH8=",
5133
+ # code_size: 308,
4375
5134
  # description: "",
4376
- # function_arn: "arn:aws:lambda:us-west-2:123456789012:function:myFunction",
4377
- # function_name: "myFunction",
5135
+ # function_arn: "arn:aws:lambda:us-east-2:123456789012:function:my-function",
5136
+ # function_name: "my-function",
4378
5137
  # handler: "index.handler",
4379
- # last_modified: Time.parse("2016-11-21T19:49:20.006+0000"),
4380
- # memory_size: 128,
4381
- # role: "arn:aws:iam::123456789012:role/lambda_basic_execution",
4382
- # runtime: "python2.7",
4383
- # timeout: 123,
4384
- # version: "1",
4385
- # vpc_config: {
5138
+ # last_modified: Time.parse("2019-08-14T22:26:11.234+0000"),
5139
+ # memory_size: 256,
5140
+ # revision_id: "873282ed-xmpl-4dc8-a069-d0c647e470c6",
5141
+ # role: "arn:aws:iam::123456789012:role/lambda-role",
5142
+ # runtime: "nodejs12.x",
5143
+ # timeout: 3,
5144
+ # tracing_config: {
5145
+ # mode: "PassThrough",
4386
5146
  # },
5147
+ # version: "$LATEST",
4387
5148
  # }
4388
5149
  #
4389
5150
  # @example Request syntax with placeholder values
@@ -4404,7 +5165,7 @@ module Aws::Lambda
4404
5165
  # "EnvironmentVariableName" => "EnvironmentVariableValue",
4405
5166
  # },
4406
5167
  # },
4407
- # runtime: "nodejs", # accepts nodejs, nodejs4.3, nodejs6.10, nodejs8.10, nodejs10.x, nodejs12.x, java8, java11, python2.7, python3.6, python3.7, python3.8, dotnetcore1.0, dotnetcore2.0, dotnetcore2.1, nodejs4.3-edge, go1.x, ruby2.5, ruby2.7, provided
5168
+ # runtime: "nodejs", # accepts nodejs, nodejs4.3, nodejs6.10, nodejs8.10, nodejs10.x, nodejs12.x, java8, java11, python2.7, python3.6, python3.7, python3.8, dotnetcore1.0, dotnetcore2.0, dotnetcore2.1, dotnetcore3.1, nodejs4.3-edge, go1.x, ruby2.5, ruby2.7, provided
4408
5169
  # dead_letter_config: {
4409
5170
  # target_arn: "ResourceArn",
4410
5171
  # },
@@ -4420,7 +5181,7 @@ module Aws::Lambda
4420
5181
  #
4421
5182
  # resp.function_name #=> String
4422
5183
  # resp.function_arn #=> String
4423
- # resp.runtime #=> String, one of "nodejs", "nodejs4.3", "nodejs6.10", "nodejs8.10", "nodejs10.x", "nodejs12.x", "java8", "java11", "python2.7", "python3.6", "python3.7", "python3.8", "dotnetcore1.0", "dotnetcore2.0", "dotnetcore2.1", "nodejs4.3-edge", "go1.x", "ruby2.5", "ruby2.7", "provided"
5184
+ # resp.runtime #=> String, one of "nodejs", "nodejs4.3", "nodejs6.10", "nodejs8.10", "nodejs10.x", "nodejs12.x", "java8", "java11", "python2.7", "python3.6", "python3.7", "python3.8", "dotnetcore1.0", "dotnetcore2.0", "dotnetcore2.1", "dotnetcore3.1", "nodejs4.3-edge", "go1.x", "ruby2.5", "ruby2.7", "provided"
4424
5185
  # resp.role #=> String
4425
5186
  # resp.handler #=> String
4426
5187
  # resp.code_size #=> Integer
@@ -4519,6 +5280,36 @@ module Aws::Lambda
4519
5280
  # * {Types::FunctionEventInvokeConfig#maximum_event_age_in_seconds #maximum_event_age_in_seconds} => Integer
4520
5281
  # * {Types::FunctionEventInvokeConfig#destination_config #destination_config} => Types::DestinationConfig
4521
5282
  #
5283
+ #
5284
+ # @example Example: To update an asynchronous invocation configuration
5285
+ #
5286
+ # # The following example adds an on-failure destination to the existing asynchronous invocation configuration for a
5287
+ # # function named my-function.
5288
+ #
5289
+ # resp = client.update_function_event_invoke_config({
5290
+ # destination_config: {
5291
+ # on_failure: {
5292
+ # destination: "arn:aws:sqs:us-east-2:123456789012:destination",
5293
+ # },
5294
+ # },
5295
+ # function_name: "my-function",
5296
+ # })
5297
+ #
5298
+ # resp.to_h outputs the following:
5299
+ # {
5300
+ # destination_config: {
5301
+ # on_failure: {
5302
+ # destination: "arn:aws:sqs:us-east-2:123456789012:destination",
5303
+ # },
5304
+ # on_success: {
5305
+ # },
5306
+ # },
5307
+ # function_arn: "arn:aws:lambda:us-east-2:123456789012:function:my-function:$LATEST",
5308
+ # last_modified: Time.parse(1573687896.493),
5309
+ # maximum_event_age_in_seconds: 3600,
5310
+ # maximum_retry_attempts: 0,
5311
+ # }
5312
+ #
4522
5313
  # @example Request syntax with placeholder values
4523
5314
  #
4524
5315
  # resp = client.update_function_event_invoke_config({
@@ -4567,7 +5358,7 @@ module Aws::Lambda
4567
5358
  params: params,
4568
5359
  config: config)
4569
5360
  context[:gem_name] = 'aws-sdk-lambda'
4570
- context[:gem_version] = '1.37.0'
5361
+ context[:gem_version] = '1.42.0'
4571
5362
  Seahorse::Client::Request.new(handlers, context)
4572
5363
  end
4573
5364
 
@@ -4633,11 +5424,11 @@ module Aws::Lambda
4633
5424
  # The following table lists the valid waiter names, the operations they call,
4634
5425
  # and the default `:delay` and `:max_attempts` values.
4635
5426
  #
4636
- # | waiter_name | params | :delay | :max_attempts |
4637
- # | ---------------- | ----------------------------- | -------- | ------------- |
4638
- # | function_active | {#get_function_configuration} | 5 | 60 |
4639
- # | function_exists | {#get_function} | 1 | 20 |
4640
- # | function_updated | {#get_function_configuration} | 5 | 60 |
5427
+ # | waiter_name | params | :delay | :max_attempts |
5428
+ # | ---------------- | ----------------------------------- | -------- | ------------- |
5429
+ # | function_active | {Client#get_function_configuration} | 5 | 60 |
5430
+ # | function_exists | {Client#get_function} | 1 | 20 |
5431
+ # | function_updated | {Client#get_function_configuration} | 5 | 60 |
4641
5432
  #
4642
5433
  # @raise [Errors::FailureStateError] Raised when the waiter terminates
4643
5434
  # because the waiter has entered a state that it will not transition