aws-sdk-lambda 1.16.0 → 1.17.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: 982bd0a6b613eb89dfc35d44773bd3a83ee35219
4
- data.tar.gz: 7dfd8c0ea53e73d891660a11d263f2f63e732e87
3
+ metadata.gz: bd643bbe5a48f16c78db15051761bb80aeb7a7da
4
+ data.tar.gz: b37ebc33cbc30a1cc9ad5c5aae3845b474fe3fd1
5
5
  SHA512:
6
- metadata.gz: 8c289c5cdc1ea50576e11f7467825be4fda767052fd3e8c78268b66ed6e53cc6094d1d90ed3b1e2556c27a3777bbbb36291e3826e63ac8da6f612285a888dd2d
7
- data.tar.gz: 3d9ff72e1dd17434d3555c3ddebcf370a0c9600161fed373b8efa158d6cadcc8a5431b9f497413cb8618af77cb847481bb8ceb09bea2c8778d7374591c7334fa
6
+ metadata.gz: f848d049a6a05c1d5d521ef117e4fd6aff8781436382599d6b8992ca0fdefbd312e31f9c40b7c920a07063a807e3502d735493ba11a0806696f995995b10be59
7
+ data.tar.gz: 2cdefecb8f7e537f61b4f8c81db49345ce347b3b44672d5398b9cd3c1668d5995c1997cc32c4798a573d987b4ee958dbe95678cbe56c4e3ff1bea3241ef5e7ba
@@ -42,6 +42,6 @@ require_relative 'aws-sdk-lambda/customizations'
42
42
  # @service
43
43
  module Aws::Lambda
44
44
 
45
- GEM_VERSION = '1.16.0'
45
+ GEM_VERSION = '1.17.0'
46
46
 
47
47
  end
@@ -205,16 +205,20 @@ module Aws::Lambda
205
205
 
206
206
  # @!group API Operations
207
207
 
208
- # Adds permissions to the resource-based policy of a version of a
209
- # function layer. Use this action to grant layer usage permission to
208
+ # Adds permissions to the resource-based policy of a version of an [AWS
209
+ # Lambda layer][1]. Use this action to grant layer usage permission to
210
210
  # other accounts. You can grant permission to a single account, all AWS
211
211
  # accounts, or all accounts in an organization.
212
212
  #
213
213
  # To revoke permission, call RemoveLayerVersionPermission with the
214
214
  # statement ID that you specified when you added it.
215
215
  #
216
+ #
217
+ #
218
+ # [1]: http://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html
219
+ #
216
220
  # @option params [required, String] :layer_name
217
- # The name of the layer.
221
+ # The name or Amazon Resource Name (ARN) of the layer.
218
222
  #
219
223
  # @option params [required, Integer] :version_number
220
224
  # The version number.
@@ -270,90 +274,83 @@ module Aws::Lambda
270
274
  req.send_request(options)
271
275
  end
272
276
 
273
- # Adds a permission to the resource policy associated with the specified
274
- # AWS Lambda function. You use resource policies to grant permissions to
275
- # event sources that use the *push* model. In a *push* model, event
276
- # sources (such as Amazon S3 and custom applications) invoke your Lambda
277
- # function. Each permission you add to the resource policy allows an
278
- # event source permission to invoke the Lambda function.
279
- #
280
- # Permissions apply to the Amazon Resource Name (ARN) used to invoke the
281
- # function, which can be unqualified (the unpublished version of the
282
- # function), or include a version or alias. If a client uses a version
283
- # or alias to invoke a function, use the `Qualifier` parameter to apply
284
- # permissions to that ARN. For more information about versioning, see
285
- # [AWS Lambda Function Versioning and Aliases][1].
286
- #
287
- # This operation requires permission for the `lambda:AddPermission`
288
- # action.
277
+ # Grants an AWS service or another account permission to use a function.
278
+ # You can apply the policy at the function level, or specify a qualifier
279
+ # to restrict access to a single version or alias. If you use a
280
+ # qualifier, the invoker must use the full Amazon Resource Name (ARN) of
281
+ # that version or alias to invoke the function.
289
282
  #
283
+ # To grant permission to another account, specify the account ID as the
284
+ # `Principal`. For AWS services, the principal is a domain-style
285
+ # identifier defined by the service, like `s3.amazonaws.com` or
286
+ # `sns.amazonaws.com`. For AWS services, you can also specify the ARN or
287
+ # owning account of the associated resource as the `SourceArn` or
288
+ # `SourceAccount`. If you grant permission to a service principal
289
+ # without specifying the source, other accounts could potentially
290
+ # configure resources in their account to invoke your Lambda function.
290
291
  #
292
+ # This action adds a statement to a resource-based permission policy for
293
+ # the function. For more information about function policies, see
294
+ # [Lambda Function Policies][1].
291
295
  #
292
- # [1]: http://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html
296
+ #
297
+ #
298
+ # [1]: http://docs.aws.amazon.com/lambda/latest/dg/access-control-resource-based.html
293
299
  #
294
300
  # @option params [required, String] :function_name
295
- # The name of the Lambda function.
301
+ # The name of the Lambda function, version, or alias.
296
302
  #
297
303
  # **Name formats**
298
304
  #
299
- # * **Function name** - `MyFunction`.
305
+ # * **Function name** - `my-function` (name-only), `my-function:v1`
306
+ # (with alias).
300
307
  #
301
308
  # * **Function ARN** -
302
- # `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`.
309
+ # `arn:aws:lambda:us-west-2:123456789012:function:my-function`.
303
310
  #
304
- # * **Partial ARN** - `123456789012:function:MyFunction`.
311
+ # * **Partial ARN** - `123456789012:function:my-function`.
305
312
  #
306
- # The length constraint applies only to the full ARN. If you specify
307
- # only the function name, it is limited to 64 characters in length.
313
+ # You can append a version number or alias to any of the formats. The
314
+ # length constraint applies only to the full ARN. If you specify only
315
+ # the function name, it is limited to 64 characters in length.
308
316
  #
309
317
  # @option params [required, String] :statement_id
310
- # A unique statement identifier.
318
+ # A statement identifier that differentiates the statement from others
319
+ # in the same policy.
311
320
  #
312
321
  # @option params [required, String] :action
313
- # The AWS Lambda action you want to allow in this statement. Each Lambda
314
- # action is a string starting with `lambda:` followed by the API name .
315
- # For example, `lambda:CreateFunction`. You can use wildcard
316
- # (`lambda:*`) to grant permission for all AWS Lambda actions.
322
+ # The action that the principal can use on the function. For example,
323
+ # `lambda:InvokeFunction` or `lambda:GetFunction`.
317
324
  #
318
325
  # @option params [required, String] :principal
319
- # The principal who is getting this permission. The principal can be an
320
- # AWS service (e.g. `s3.amazonaws.com` or `sns.amazonaws.com`) for
321
- # service triggers, or an account ID for cross-account access. If you
322
- # specify a service as a principal, use the `SourceArn` parameter to
323
- # limit who can invoke the function through that service.
326
+ # The AWS service or account that invokes the function. If you specify a
327
+ # service, use `SourceArn` or `SourceAccount` to limit who can invoke
328
+ # the function through that service.
324
329
  #
325
330
  # @option params [String] :source_arn
326
- # The Amazon Resource Name of the invoker.
327
- #
328
- # If you add a permission to a service principal without providing the
329
- # source ARN, any AWS account that creates a mapping to your function
330
- # ARN can invoke your Lambda function.
331
+ # For AWS services, the ARN of the AWS resource that invokes the
332
+ # function. For example, an Amazon S3 bucket or Amazon SNS topic.
331
333
  #
332
334
  # @option params [String] :source_account
333
- # This parameter is used for S3 and SES. The AWS account ID (without a
334
- # hyphen) of the source owner. For example, if the `SourceArn`
335
- # identifies a bucket, then this is the bucket owner's account ID. You
336
- # can use this additional condition to ensure the bucket you specify is
337
- # owned by a specific account (it is possible the bucket owner deleted
338
- # the bucket and some other AWS account created the bucket). You can
339
- # also use this condition to specify all sources (that is, you don't
340
- # specify the `SourceArn`) owned by a specific account.
335
+ # For AWS services, the ID of the account that owns the resource. Use
336
+ # instead of `SourceArn` to grant permission to resources owned by
337
+ # another account (e.g. all of an account's Amazon S3 buckets). Or use
338
+ # together with `SourceArn` to ensure that the resource is owned by the
339
+ # specified account. For example, an Amazon S3 bucket could be deleted
340
+ # by its owner and recreated by another account.
341
341
  #
342
342
  # @option params [String] :event_source_token
343
- # A unique token that must be supplied by the principal invoking the
344
- # function. This is currently only used for Alexa Smart Home functions.
343
+ # For Alexa Smart Home functions, a token that must be supplied by the
344
+ # invoker.
345
345
  #
346
346
  # @option params [String] :qualifier
347
347
  # Specify a version or alias to add permissions to a published version
348
348
  # of the function.
349
349
  #
350
350
  # @option params [String] :revision_id
351
- # An optional value you can use to ensure you are updating the latest
352
- # update of the function version or alias. If the `RevisionID` you pass
353
- # doesn't match the latest `RevisionId` of the function or alias, it
354
- # will fail with an error message, advising you to retrieve the latest
355
- # function version or alias `RevisionID` using either GetFunction or
356
- # GetAlias
351
+ # Only update the policy if the revision ID matches the ID specified.
352
+ # Use this option to avoid modifying a policy that has changed since you
353
+ # last read it.
357
354
  #
358
355
  # @return [Types::AddPermissionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
359
356
  #
@@ -405,15 +402,17 @@ module Aws::Lambda
405
402
  req.send_request(options)
406
403
  end
407
404
 
408
- # Creates an alias that points to the specified Lambda function version.
409
- # For more information, see [Introduction to AWS Lambda Aliases][1].
405
+ # Creates an [alias][1] for a Lambda function version. Use aliases to
406
+ # provide clients with a function identifier that you can update to
407
+ # invoke a different version.
410
408
  #
411
- # Alias names are unique for a given function. This requires permission
412
- # for the lambda:CreateAlias action.
409
+ # You can also map an alias to split invocation requests between two
410
+ # versions. Use the `RoutingConfig` parameter to specify a second
411
+ # version and the percentage of invocation requests that it receives.
413
412
  #
414
413
  #
415
414
  #
416
- # [1]: http://docs.aws.amazon.com/lambda/latest/dg/aliases-intro.html
415
+ # [1]: http://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html
417
416
  #
418
417
  # @option params [required, String] :function_name
419
418
  # The name of the lambda function.
@@ -431,18 +430,16 @@ module Aws::Lambda
431
430
  # only the function name, it is limited to 64 characters in length.
432
431
  #
433
432
  # @option params [required, String] :name
434
- # Name for the alias you are creating.
433
+ # The name of the alias.
435
434
  #
436
435
  # @option params [required, String] :function_version
437
- # Lambda function version for which you are creating the alias.
436
+ # The function version that the alias invokes.
438
437
  #
439
438
  # @option params [String] :description
440
- # Description of the alias.
439
+ # A description of the alias.
441
440
  #
442
441
  # @option params [Types::AliasRoutingConfiguration] :routing_config
443
- # Specifies an additional version your alias can point to, allowing you
444
- # to dictate what percentage of traffic will invoke each version. For
445
- # more information, see [Traffic Shifting Using Aliases][1].
442
+ # The [routing configuration][1] of the alias.
446
443
  #
447
444
  #
448
445
  #
@@ -553,8 +550,8 @@ module Aws::Lambda
553
550
  # only supported for Amazon Kinesis streams.
554
551
  #
555
552
  # @option params [Time,DateTime,Date,Integer,String] :starting_position_timestamp
556
- # With `StartingPosition` set to `AT_TIMESTAMP`, the Unix time in
557
- # seconds from which to start reading.
553
+ # With `StartingPosition` set to `AT_TIMESTAMP`, the time from which to
554
+ # start reading.
558
555
  #
559
556
  # @return [Types::EventSourceMappingConfiguration] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
560
557
  #
@@ -598,41 +595,72 @@ module Aws::Lambda
598
595
  req.send_request(options)
599
596
  end
600
597
 
601
- # Creates a new Lambda function. The function configuration is created
602
- # from the request parameters, and the code for the function is provided
603
- # by a .zip file. The function name is case-sensitive.
604
- #
605
- # This operation requires permission for the `lambda:CreateFunction`
606
- # action.
598
+ # Creates a Lambda function. To create a function, you need a
599
+ # [deployment package][1] and an [execution role][2]. The deployment
600
+ # package contains your function code. The execution role grants the
601
+ # function permission to use AWS services such as Amazon CloudWatch Logs
602
+ # for log streaming and AWS X-Ray for request tracing.
603
+ #
604
+ # A function has an unpublished version, and can have published versions
605
+ # and aliases. A published version is a snapshot of your function code
606
+ # and configuration that can not be changed. An alias is a named
607
+ # resource that maps to a version, and can be changed to map to a
608
+ # different version. Use the `Publish` parameter to create version `1`
609
+ # of your function from its initial configuration.
610
+ #
611
+ # The other parameters let you configure version-specific and
612
+ # function-level settings. You can modify version-specific settings
613
+ # later with UpdateFunctionConfiguration. Function-level settings apply
614
+ # to both the unpublished and published versions of the function and
615
+ # include tags (TagResource) and per-function concurrency limits
616
+ # (PutFunctionConcurrency).
617
+ #
618
+ # If another account or a AWS service invokes your function, use
619
+ # AddPermission to grant permission by creating a resource-based IAM
620
+ # policy. You can grant permissions at the function level, on a version,
621
+ # or on an alias.
622
+ #
623
+ # To invoke your function directly, use Invoke. To invoke your function
624
+ # in response to events in other AWS services, create an event source
625
+ # mapping (CreateEventSourceMapping), or configure a function trigger in
626
+ # the other service. For more information, see [Invoking Functions][3].
627
+ #
628
+ #
629
+ #
630
+ # [1]: http://docs.aws.amazon.com/lambda/latest/dg/deployment-package-v2.html
631
+ # [2]: http://docs.aws.amazon.com/lambda/latest/dg/intro-permission-model.html#lambda-intro-execution-role
632
+ # [3]: http://docs.aws.amazon.com/lambda/latest/dg/invoking-lambda-functions.html
607
633
  #
608
634
  # @option params [required, String] :function_name
609
635
  # The name of the Lambda function.
610
636
  #
611
637
  # **Name formats**
612
638
  #
613
- # * **Function name** - `MyFunction`.
639
+ # * **Function name** - `my-function`.
614
640
  #
615
641
  # * **Function ARN** -
616
- # `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`.
642
+ # `arn:aws:lambda:us-west-2:123456789012:function:my-function`.
617
643
  #
618
- # * **Partial ARN** - `123456789012:function:MyFunction`.
644
+ # * **Partial ARN** - `123456789012:function:my-function`.
619
645
  #
620
646
  # The length constraint applies only to the full ARN. If you specify
621
647
  # only the function name, it is limited to 64 characters in length.
622
648
  #
623
649
  # @option params [required, String] :runtime
624
- # The runtime version for the function.
650
+ # The identifier of the function's [runtime][1].
625
651
  #
626
- # @option params [required, String] :role
627
- # The Amazon Resource Name (ARN) of the function's [execution role][1].
628
652
  #
629
653
  #
654
+ # [1]: http://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html
630
655
  #
631
- # [1]: http://docs.aws.amazon.com/lambda/latest/dg/intro-permission-model.html#lambda-intro-execution-role
656
+ # @option params [required, String] :role
657
+ # The Amazon Resource Name (ARN) of the function's execution role.
632
658
  #
633
659
  # @option params [required, String] :handler
634
660
  # The name of the method within your code that Lambda calls to execute
635
- # your function. For more information, see [Programming Model][1].
661
+ # your function. The format includes the filename and can also include
662
+ # namespaces and other qualifiers, depending on the runtime. For more
663
+ # information, see [Programming Model][1].
636
664
  #
637
665
  #
638
666
  #
@@ -659,10 +687,14 @@ module Aws::Lambda
659
687
  # creation.
660
688
  #
661
689
  # @option params [Types::VpcConfig] :vpc_config
662
- # If your Lambda function accesses resources in a VPC, you provide this
663
- # parameter identifying the list of security group IDs and subnet IDs.
664
- # These must belong to the same VPC. You must provide at least one
665
- # security group and one subnet ID.
690
+ # For network connectivity to AWS resources in a VPC, specify a list of
691
+ # security groups and subnets in the VPC. When you connect a function to
692
+ # a VPC, it can only access resources and the internet through that VPC.
693
+ # For more information, see [VPC Settings][1].
694
+ #
695
+ #
696
+ #
697
+ # [1]: http://docs.aws.amazon.com/lambda/latest/dg/vpc.html
666
698
  #
667
699
  # @option params [Types::DeadLetterConfig] :dead_letter_config
668
700
  # A dead letter queue configuration that specifies the queue or topic
@@ -678,17 +710,16 @@ module Aws::Lambda
678
710
  # execution.
679
711
  #
680
712
  # @option params [String] :kms_key_arn
681
- # The ARN of the KMS key used to encrypt your function's environment
682
- # variables. If not provided, AWS Lambda will use a default service key.
713
+ # The ARN of the AWS Key Management Service key used to encrypt your
714
+ # function's environment variables. If not provided, AWS Lambda uses a
715
+ # default service key.
683
716
  #
684
717
  # @option params [Types::TracingConfig] :tracing_config
685
718
  # Set `Mode` to `Active` to sample and trace a subset of incoming
686
719
  # requests with AWS X-Ray.
687
720
  #
688
721
  # @option params [Hash<String,String>] :tags
689
- # The list of tags (key-value pairs) assigned to the new function. For
690
- # more information, see [Tagging Lambda Functions][1] in the **AWS
691
- # Lambda Developer Guide**.
722
+ # A list of [tags][1] to apply to the function.
692
723
  #
693
724
  #
694
725
  #
@@ -696,7 +727,7 @@ module Aws::Lambda
696
727
  #
697
728
  # @option params [Array<String>] :layers
698
729
  # A list of [function layers][1] to add to the function's execution
699
- # environment.
730
+ # environment. Specify each layer by ARN, including the version.
700
731
  #
701
732
  #
702
733
  #
@@ -739,7 +770,7 @@ module Aws::Lambda
739
770
  # memory_size: 128,
740
771
  # publish: true,
741
772
  # role: "arn:aws:iam::123456789012:role/service-role/role-name", # replace with the actual arn of the execution role you created
742
- # runtime: "nodejs4.3",
773
+ # runtime: "nodejs8.10",
743
774
  # timeout: 15,
744
775
  # vpc_config: {
745
776
  # },
@@ -756,7 +787,7 @@ module Aws::Lambda
756
787
  # last_modified: Time.parse("2016-11-21T19:49:20.006+0000"),
757
788
  # memory_size: 128,
758
789
  # role: "arn:aws:iam::123456789012:role/service-role/role-name",
759
- # runtime: "nodejs4.3",
790
+ # runtime: "nodejs8.10",
760
791
  # timeout: 123,
761
792
  # version: "1",
762
793
  # vpc_config: {
@@ -843,14 +874,11 @@ module Aws::Lambda
843
874
  req.send_request(options)
844
875
  end
845
876
 
846
- # Deletes the specified Lambda function alias. For more information, see
847
- # [Introduction to AWS Lambda Aliases][1].
877
+ # Deletes a Lambda function [alias][1].
848
878
  #
849
- # This requires permission for the lambda:DeleteAlias action.
850
879
  #
851
880
  #
852
- #
853
- # [1]: http://docs.aws.amazon.com/lambda/latest/dg/aliases-intro.html
881
+ # [1]: http://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html
854
882
  #
855
883
  # @option params [required, String] :function_name
856
884
  # The name of the lambda function.
@@ -868,7 +896,7 @@ module Aws::Lambda
868
896
  # only the function name, it is limited to 64 characters in length.
869
897
  #
870
898
  # @option params [required, String] :name
871
- # Name of the alias to delete.
899
+ # The name of the alias.
872
900
  #
873
901
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
874
902
  #
@@ -898,7 +926,12 @@ module Aws::Lambda
898
926
  req.send_request(options)
899
927
  end
900
928
 
901
- # Deletes an event source mapping.
929
+ # Deletes an [event source mapping][1]. You can get the identifier of a
930
+ # mapping from the output of ListEventSourceMappings.
931
+ #
932
+ #
933
+ #
934
+ # [1]: http://docs.aws.amazon.com/lambda/latest/dg/intro-invocation-modes.html
902
935
  #
903
936
  # @option params [required, String] :uuid
904
937
  # The identifier of the event source mapping.
@@ -963,25 +996,29 @@ module Aws::Lambda
963
996
 
964
997
  # Deletes a Lambda function. To delete a specific function version, use
965
998
  # the `Qualifier` parameter. Otherwise, all versions and aliases are
966
- # deleted. Event source mappings are not deleted.
999
+ # deleted.
967
1000
  #
968
- # This operation requires permission for the `lambda:DeleteFunction`
969
- # action.
1001
+ # To delete Lambda event source mappings that invoke a function, use
1002
+ # DeleteEventSourceMapping. For AWS services and resources that invoke
1003
+ # your function directly, delete the trigger in the service where you
1004
+ # originally configured it.
970
1005
  #
971
1006
  # @option params [required, String] :function_name
972
- # The name of the Lambda function.
1007
+ # The name of the Lambda function or version.
973
1008
  #
974
1009
  # **Name formats**
975
1010
  #
976
- # * **Function name** - `MyFunction`.
1011
+ # * **Function name** - `my-function` (name-only), `my-function:1` (with
1012
+ # version).
977
1013
  #
978
1014
  # * **Function ARN** -
979
- # `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`.
1015
+ # `arn:aws:lambda:us-west-2:123456789012:function:my-function`.
980
1016
  #
981
- # * **Partial ARN** - `123456789012:function:MyFunction`.
1017
+ # * **Partial ARN** - `123456789012:function:my-function`.
982
1018
  #
983
- # The length constraint applies only to the full ARN. If you specify
984
- # only the function name, it is limited to 64 characters in length.
1019
+ # You can append a version number or alias to any of the formats. The
1020
+ # length constraint applies only to the full ARN. If you specify only
1021
+ # the function name, it is limited to 64 characters in length.
985
1022
  #
986
1023
  # @option params [String] :qualifier
987
1024
  # Specify a version to delete. You cannot delete a version that is
@@ -1015,24 +1052,19 @@ module Aws::Lambda
1015
1052
  req.send_request(options)
1016
1053
  end
1017
1054
 
1018
- # Removes concurrent execution limits from this function. For more
1019
- # information, see [Managing Concurrency][1].
1020
- #
1021
- #
1022
- #
1023
- # [1]: http://docs.aws.amazon.com/lambda/latest/dg/concurrent-executions.html
1055
+ # Removes a concurrent execution limit from a function.
1024
1056
  #
1025
1057
  # @option params [required, String] :function_name
1026
1058
  # The name of the Lambda function.
1027
1059
  #
1028
1060
  # **Name formats**
1029
1061
  #
1030
- # * **Function name** - `MyFunction`.
1062
+ # * **Function name** - `my-function`.
1031
1063
  #
1032
1064
  # * **Function ARN** -
1033
- # `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`.
1065
+ # `arn:aws:lambda:us-west-2:123456789012:function:my-function`.
1034
1066
  #
1035
- # * **Partial ARN** - `123456789012:function:MyFunction`.
1067
+ # * **Partial ARN** - `123456789012:function:my-function`.
1036
1068
  #
1037
1069
  # The length constraint applies only to the full ARN. If you specify
1038
1070
  # only the function name, it is limited to 64 characters in length.
@@ -1054,12 +1086,16 @@ module Aws::Lambda
1054
1086
  req.send_request(options)
1055
1087
  end
1056
1088
 
1057
- # Deletes a version of a function layer. Deleted versions can no longer
1058
- # be viewed or added to functions. However, a copy of the version
1059
- # remains in Lambda until no functions refer to it.
1089
+ # Deletes a version of an [AWS Lambda layer][1]. Deleted versions can no
1090
+ # longer be viewed or added to functions. To avoid breaking functions, a
1091
+ # copy of the version remains in Lambda until no functions refer to it.
1092
+ #
1093
+ #
1094
+ #
1095
+ # [1]: http://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html
1060
1096
  #
1061
1097
  # @option params [required, String] :layer_name
1062
- # The name of the layer.
1098
+ # The name or Amazon Resource Name (ARN) of the layer.
1063
1099
  #
1064
1100
  # @option params [required, Integer] :version_number
1065
1101
  # The version number.
@@ -1129,15 +1165,11 @@ module Aws::Lambda
1129
1165
  req.send_request(options)
1130
1166
  end
1131
1167
 
1132
- # Returns the specified alias information such as the alias ARN,
1133
- # description, and function version it is pointing to. For more
1134
- # information, see [Introduction to AWS Lambda Aliases][1].
1135
- #
1136
- # This requires permission for the `lambda:GetAlias` action.
1168
+ # Returns details about a Lambda function [alias][1].
1137
1169
  #
1138
1170
  #
1139
1171
  #
1140
- # [1]: http://docs.aws.amazon.com/lambda/latest/dg/aliases-intro.html
1172
+ # [1]: http://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html
1141
1173
  #
1142
1174
  # @option params [required, String] :function_name
1143
1175
  # The name of the lambda function.
@@ -1155,7 +1187,7 @@ module Aws::Lambda
1155
1187
  # only the function name, it is limited to 64 characters in length.
1156
1188
  #
1157
1189
  # @option params [required, String] :name
1158
- # Name of the alias for which you want to retrieve information.
1190
+ # The name of the alias.
1159
1191
  #
1160
1192
  # @return [Types::AliasConfiguration] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1161
1193
  #
@@ -1210,7 +1242,8 @@ module Aws::Lambda
1210
1242
  req.send_request(options)
1211
1243
  end
1212
1244
 
1213
- # Returns details about an event source mapping.
1245
+ # Returns details about an event source mapping. You can get the
1246
+ # identifier of a mapping from the output of ListEventSourceMappings.
1214
1247
  #
1215
1248
  # @option params [required, String] :uuid
1216
1249
  # The identifier of the event source mapping.
@@ -1273,37 +1306,27 @@ module Aws::Lambda
1273
1306
  req.send_request(options)
1274
1307
  end
1275
1308
 
1276
- # Returns the configuration information of the Lambda function and a
1277
- # presigned URL link to the .zip file you uploaded with CreateFunction
1278
- # so you can download the .zip file. Note that the URL is valid for up
1279
- # to 10 minutes. The configuration information is the same information
1280
- # you provided as parameters when uploading the function.
1281
- #
1282
- # Use the `Qualifier` parameter to retrieve a published version of the
1283
- # function. Otherwise, returns the unpublished version (`$LATEST`). For
1284
- # more information, see [AWS Lambda Function Versioning and Aliases][1].
1285
- #
1286
- # This operation requires permission for the `lambda:GetFunction`
1287
- # action.
1288
- #
1289
- #
1290
- #
1291
- # [1]: http://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html
1309
+ # Returns information about function or function version, with a link to
1310
+ # download the deployment package that's valid for 10 minutes. If you
1311
+ # specify a function version, only details specific to that version are
1312
+ # returned.
1292
1313
  #
1293
1314
  # @option params [required, String] :function_name
1294
- # The name of the Lambda function.
1315
+ # The name of the Lambda function, version, or alias.
1295
1316
  #
1296
1317
  # **Name formats**
1297
1318
  #
1298
- # * **Function name** - `MyFunction`.
1319
+ # * **Function name** - `my-function` (name-only), `my-function:v1`
1320
+ # (with alias).
1299
1321
  #
1300
1322
  # * **Function ARN** -
1301
- # `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`.
1323
+ # `arn:aws:lambda:us-west-2:123456789012:function:my-function`.
1302
1324
  #
1303
- # * **Partial ARN** - `123456789012:function:MyFunction`.
1325
+ # * **Partial ARN** - `123456789012:function:my-function`.
1304
1326
  #
1305
- # The length constraint applies only to the full ARN. If you specify
1306
- # only the function name, it is limited to 64 characters in length.
1327
+ # You can append a version number or alias to any of the formats. The
1328
+ # length constraint applies only to the full ARN. If you specify only
1329
+ # the function name, it is limited to 64 characters in length.
1307
1330
  #
1308
1331
  # @option params [String] :qualifier
1309
1332
  # Specify a version or alias to get details about a published version of
@@ -1347,7 +1370,7 @@ module Aws::Lambda
1347
1370
  # last_modified: Time.parse("2016-11-21T19:49:20.006+0000"),
1348
1371
  # memory_size: 128,
1349
1372
  # role: "arn:aws:iam::123456789012:role/lambda_basic_execution",
1350
- # runtime: "nodejs4.3",
1373
+ # runtime: "nodejs8.10",
1351
1374
  # timeout: 3,
1352
1375
  # version: "$LATEST",
1353
1376
  # vpc_config: {
@@ -1412,39 +1435,30 @@ module Aws::Lambda
1412
1435
  req.send_request(options)
1413
1436
  end
1414
1437
 
1415
- # Returns the configuration information of the Lambda function. This the
1416
- # same information you provided as parameters when uploading the
1417
- # function by using CreateFunction.
1418
- #
1419
- # If you are using the versioning feature, you can retrieve this
1420
- # information for a specific function version by using the optional
1421
- # `Qualifier` parameter and specifying the function version or alias
1422
- # that points to it. If you don't provide it, the API returns
1423
- # information about the $LATEST version of the function. For more
1424
- # information about versioning, see [AWS Lambda Function Versioning and
1425
- # Aliases][1].
1426
- #
1427
- # This operation requires permission for the
1428
- # `lambda:GetFunctionConfiguration` operation.
1429
- #
1430
- #
1438
+ # Returns a the version-specific settings of a Lambda function or
1439
+ # version. The output includes only options that can vary between
1440
+ # versions of a function. To modify these settings, use
1441
+ # UpdateFunctionConfiguration.
1431
1442
  #
1432
- # [1]: http://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html
1443
+ # To get all of a function's details, including function-level
1444
+ # settings, use GetFunction.
1433
1445
  #
1434
1446
  # @option params [required, String] :function_name
1435
- # The name of the Lambda function.
1447
+ # The name of the Lambda function, version, or alias.
1436
1448
  #
1437
1449
  # **Name formats**
1438
1450
  #
1439
- # * **Function name** - `MyFunction`.
1451
+ # * **Function name** - `my-function` (name-only), `my-function:v1`
1452
+ # (with alias).
1440
1453
  #
1441
1454
  # * **Function ARN** -
1442
- # `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`.
1455
+ # `arn:aws:lambda:us-west-2:123456789012:function:my-function`.
1443
1456
  #
1444
- # * **Partial ARN** - `123456789012:function:MyFunction`.
1457
+ # * **Partial ARN** - `123456789012:function:my-function`.
1445
1458
  #
1446
- # The length constraint applies only to the full ARN. If you specify
1447
- # only the function name, it is limited to 64 characters in length.
1459
+ # You can append a version number or alias to any of the formats. The
1460
+ # length constraint applies only to the full ARN. If you specify only
1461
+ # the function name, it is limited to 64 characters in length.
1448
1462
  #
1449
1463
  # @option params [String] :qualifier
1450
1464
  # Specify a version or alias to get details about a published version of
@@ -1554,11 +1568,15 @@ module Aws::Lambda
1554
1568
  req.send_request(options)
1555
1569
  end
1556
1570
 
1557
- # Returns information about a version of a function layer, with a link
1558
- # to download the layer archive that's valid for 10 minutes.
1571
+ # Returns information about a version of an [AWS Lambda layer][1], with
1572
+ # a link to download the layer archive that's valid for 10 minutes.
1573
+ #
1574
+ #
1575
+ #
1576
+ # [1]: http://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html
1559
1577
  #
1560
1578
  # @option params [required, String] :layer_name
1561
- # The name of the layer.
1579
+ # The name or Amazon Resource Name (ARN) of the layer.
1562
1580
  #
1563
1581
  # @option params [required, Integer] :version_number
1564
1582
  # The version number.
@@ -1604,11 +1622,15 @@ module Aws::Lambda
1604
1622
  req.send_request(options)
1605
1623
  end
1606
1624
 
1607
- # Returns the permission policy for a layer version. For more
1608
- # information, see AddLayerVersionPermission.
1625
+ # Returns the permission policy for a version of an [AWS Lambda
1626
+ # layer][1]. For more information, see AddLayerVersionPermission.
1627
+ #
1628
+ #
1629
+ #
1630
+ # [1]: http://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html
1609
1631
  #
1610
1632
  # @option params [required, String] :layer_name
1611
- # The name of the layer.
1633
+ # The name or Amazon Resource Name (ARN) of the layer.
1612
1634
  #
1613
1635
  # @option params [required, Integer] :version_number
1614
1636
  # The version number.
@@ -1639,32 +1661,32 @@ module Aws::Lambda
1639
1661
  req.send_request(options)
1640
1662
  end
1641
1663
 
1642
- # Returns the resource policy associated with the specified Lambda
1643
- # function.
1664
+ # Returns the [resource-based IAM policy][1] for a function, version, or
1665
+ # alias.
1666
+ #
1644
1667
  #
1645
- # This action requires permission for the `lambda:GetPolicy action.`
1668
+ #
1669
+ # [1]: http://docs.aws.amazon.com/lambda/latest/dg/access-control-resource-based.html
1646
1670
  #
1647
1671
  # @option params [required, String] :function_name
1648
- # The name of the lambda function.
1672
+ # The name of the Lambda function, version, or alias.
1649
1673
  #
1650
1674
  # **Name formats**
1651
1675
  #
1652
- # * **Function name** - `MyFunction`.
1676
+ # * **Function name** - `my-function` (name-only), `my-function:v1`
1677
+ # (with alias).
1653
1678
  #
1654
1679
  # * **Function ARN** -
1655
- # `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`.
1680
+ # `arn:aws:lambda:us-west-2:123456789012:function:my-function`.
1656
1681
  #
1657
- # * **Partial ARN** - `123456789012:function:MyFunction`.
1682
+ # * **Partial ARN** - `123456789012:function:my-function`.
1658
1683
  #
1659
- # The length constraint applies only to the full ARN. If you specify
1660
- # only the function name, it is limited to 64 characters in length.
1684
+ # You can append a version number or alias to any of the formats. The
1685
+ # length constraint applies only to the full ARN. If you specify only
1686
+ # the function name, it is limited to 64 characters in length.
1661
1687
  #
1662
1688
  # @option params [String] :qualifier
1663
- # You can specify this optional query parameter to specify a function
1664
- # version or an alias name in which case this API will return all
1665
- # permissions associated with the specific qualified ARN. If you don't
1666
- # provide this parameter, the API will return permissions that apply to
1667
- # the unqualified function ARN.
1689
+ # Specify a version or alias to get the policy for that resource.
1668
1690
  #
1669
1691
  # @return [Types::GetPolicyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1670
1692
  #
@@ -1707,18 +1729,25 @@ module Aws::Lambda
1707
1729
  req.send_request(options)
1708
1730
  end
1709
1731
 
1710
- # Invokes a Lambda function. For an example, see [Create the Lambda
1711
- # Function and Test It Manually][1].
1712
- #
1713
- # Specify just a function name to invoke the latest version of the
1714
- # function. To invoke a published version, use the `Qualifier` parameter
1715
- # to specify a [version or alias][2].
1716
- #
1717
- # If you use the `RequestResponse` (synchronous) invocation option, the
1718
- # function will be invoked only once. If you use the `Event`
1719
- # (asynchronous) invocation option, the function will be invoked at
1720
- # least once in response to an event and the function must be idempotent
1721
- # to handle this.
1732
+ # Invokes a Lambda function. You can invoke a function synchronously and
1733
+ # wait for the response, or asynchronously. To invoke a function
1734
+ # asynchronously, set `InvocationType` to `Event`.
1735
+ #
1736
+ # For synchronous invocation, details about the function response,
1737
+ # including errors, are included in the response body and headers. For
1738
+ # either invocation type, you can find more information in the
1739
+ # [execution log][1] and [trace][2]. To record function errors for
1740
+ # asynchronous invocations, configure your function with a [dead letter
1741
+ # queue][2].
1742
+ #
1743
+ # The status code in the API response does not reflect function errors.
1744
+ # Error codes are reserved for errors that prevent your function from
1745
+ # executing, such as permissions errors, [limit errors][3], or issues
1746
+ # with your function's code and configuration. For example, Lambda
1747
+ # returns `TooManyRequestsException` if executing the function would
1748
+ # cause you to exceed a concurrency limit at either the account level
1749
+ # (`ConcurrentInvocationLimitExceeded`) or function level
1750
+ # (`ReservedFunctionConcurrentInvocationLimitExceeded`).
1722
1751
  #
1723
1752
  # For functions with a long timeout, your client may be disconnected
1724
1753
  # during synchronous invocation while it waits for a response. Configure
@@ -1728,73 +1757,50 @@ module Aws::Lambda
1728
1757
  # This operation requires permission for the `lambda:InvokeFunction`
1729
1758
  # action.
1730
1759
  #
1731
- # The `TooManyRequestsException` noted below will return the following:
1732
- # `ConcurrentInvocationLimitExceeded` will be returned if you have no
1733
- # functions with reserved concurrency and have exceeded your account
1734
- # concurrent limit or if a function without reserved concurrency exceeds
1735
- # the account's unreserved concurrency limit.
1736
- # `ReservedFunctionConcurrentInvocationLimitExceeded` will be returned
1737
- # when a function with reserved concurrency exceeds its configured
1738
- # concurrency limit.
1739
1760
  #
1740
1761
  #
1741
- #
1742
- # [1]: http://docs.aws.amazon.com/lambda/latest/dg/with-dynamodb-create-function.html#with-dbb-invoke-manually
1743
- # [2]: http://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html
1762
+ # [1]: http://docs.aws.amazon.com/lambda/latest/dg/monitoring-functions.html
1763
+ # [2]: http://docs.aws.amazon.com/lambda/latest/dg/dlq.html
1764
+ # [3]: http://docs.aws.amazon.com/lambda/latest/dg/limits.html
1744
1765
  #
1745
1766
  # @option params [required, String] :function_name
1746
- # The name of the Lambda function.
1767
+ # The name of the Lambda function, version, or alias.
1747
1768
  #
1748
1769
  # **Name formats**
1749
1770
  #
1750
- # * **Function name** - `MyFunction`.
1771
+ # * **Function name** - `my-function` (name-only), `my-function:v1`
1772
+ # (with alias).
1751
1773
  #
1752
1774
  # * **Function ARN** -
1753
- # `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`.
1775
+ # `arn:aws:lambda:us-west-2:123456789012:function:my-function`.
1754
1776
  #
1755
- # * **Partial ARN** - `123456789012:function:MyFunction`.
1777
+ # * **Partial ARN** - `123456789012:function:my-function`.
1756
1778
  #
1757
- # The length constraint applies only to the full ARN. If you specify
1758
- # only the function name, it is limited to 64 characters in length.
1779
+ # You can append a version number or alias to any of the formats. The
1780
+ # length constraint applies only to the full ARN. If you specify only
1781
+ # the function name, it is limited to 64 characters in length.
1759
1782
  #
1760
1783
  # @option params [String] :invocation_type
1761
1784
  # Choose from the following options.
1762
1785
  #
1763
1786
  # * `RequestResponse` (default) - Invoke the function synchronously.
1764
1787
  # Keep the connection open until the function returns a response or
1765
- # times out.
1788
+ # times out. The API response includes the function response and
1789
+ # additional data.
1766
1790
  #
1767
1791
  # * `Event` - Invoke the function asynchronously. Send events that fail
1768
1792
  # multiple times to the function's dead-letter queue (if configured).
1793
+ # The API response only includes a status code.
1769
1794
  #
1770
1795
  # * `DryRun` - Validate parameter values and verify that the user or
1771
1796
  # role has permission to invoke the function.
1772
1797
  #
1773
1798
  # @option params [String] :log_type
1774
- # You can set this optional parameter to `Tail` in the request only if
1775
- # you specify the `InvocationType` parameter with value
1776
- # `RequestResponse`. In this case, AWS Lambda returns the base64-encoded
1777
- # last 4 KB of log data produced by your Lambda function in the
1778
- # `x-amz-log-result` header.
1799
+ # Set to `Tail` to include the execution log in the response.
1779
1800
  #
1780
1801
  # @option params [String] :client_context
1781
- # Using the `ClientContext` you can pass client-specific information to
1782
- # the Lambda function you are invoking. You can then process the client
1783
- # information in your Lambda function as you choose through the context
1784
- # variable. For an example of a `ClientContext` JSON, see [PutEvents][1]
1785
- # in the *Amazon Mobile Analytics API Reference and User Guide*.
1786
- #
1787
- # The ClientContext JSON must be base64-encoded and has a maximum size
1788
- # of 3583 bytes.
1789
- #
1790
- # <note markdown="1"> `ClientContext` information is returned only if you use the
1791
- # synchronous (`RequestResponse`) invocation type.
1792
- #
1793
- # </note>
1794
- #
1795
- #
1796
- #
1797
- # [1]: http://docs.aws.amazon.com/mobileanalytics/latest/ug/PutEvents.html
1802
+ # Up to 3583 bytes of base64-encoded data about the invoking client to
1803
+ # pass to the function in the context object.
1798
1804
  #
1799
1805
  # @option params [String, IO] :payload
1800
1806
  # JSON that you want to provide to your Lambda function as input.
@@ -1863,25 +1869,19 @@ module Aws::Lambda
1863
1869
 
1864
1870
  # For asynchronous function invocation, use Invoke.
1865
1871
  #
1866
- # Submits an invocation request to AWS Lambda. Upon receiving the
1867
- # request, Lambda executes the specified function asynchronously. To see
1868
- # the logs generated by the Lambda function execution, see the
1869
- # CloudWatch Logs console.
1870
- #
1871
- # This operation requires permission for the `lambda:InvokeFunction`
1872
- # action.
1872
+ # Invokes a function asynchronously.
1873
1873
  #
1874
1874
  # @option params [required, String] :function_name
1875
1875
  # The name of the Lambda function.
1876
1876
  #
1877
1877
  # **Name formats**
1878
1878
  #
1879
- # * **Function name** - `MyFunction`.
1879
+ # * **Function name** - `my-function`.
1880
1880
  #
1881
1881
  # * **Function ARN** -
1882
- # `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`.
1882
+ # `arn:aws:lambda:us-west-2:123456789012:function:my-function`.
1883
1883
  #
1884
- # * **Partial ARN** - `123456789012:function:MyFunction`.
1884
+ # * **Partial ARN** - `123456789012:function:my-function`.
1885
1885
  #
1886
1886
  # The length constraint applies only to the full ARN. If you specify
1887
1887
  # only the function name, it is limited to 64 characters in length.
@@ -1928,16 +1928,11 @@ module Aws::Lambda
1928
1928
  req.send_request(options)
1929
1929
  end
1930
1930
 
1931
- # Returns list of aliases created for a Lambda function. For each alias,
1932
- # the response includes information such as the alias ARN, description,
1933
- # alias name, and the function version to which it points. For more
1934
- # information, see [Introduction to AWS Lambda Aliases][1].
1931
+ # Returns a list of [aliases][1] for a Lambda function.
1935
1932
  #
1936
- # This requires permission for the lambda:ListAliases action.
1937
1933
  #
1938
1934
  #
1939
- #
1940
- # [1]: http://docs.aws.amazon.com/lambda/latest/dg/aliases-intro.html
1935
+ # [1]: http://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html
1941
1936
  #
1942
1937
  # @option params [required, String] :function_name
1943
1938
  # The name of the lambda function.
@@ -1955,19 +1950,15 @@ module Aws::Lambda
1955
1950
  # only the function name, it is limited to 64 characters in length.
1956
1951
  #
1957
1952
  # @option params [String] :function_version
1958
- # If you specify this optional parameter, the API returns only the
1959
- # aliases that are pointing to the specific Lambda function version,
1960
- # otherwise the API returns all of the aliases created for the Lambda
1961
- # function.
1953
+ # Specify a function version to only list aliases that invoke that
1954
+ # version.
1962
1955
  #
1963
1956
  # @option params [String] :marker
1964
- # Optional string. An opaque pagination token returned from a previous
1965
- # `ListAliases` operation. If present, indicates where to continue the
1966
- # listing.
1957
+ # Specify the pagination token returned by a previous request to
1958
+ # retrieve the next page of results.
1967
1959
  #
1968
1960
  # @option params [Integer] :max_items
1969
- # Optional integer. Specifies the maximum number of aliases to return in
1970
- # response. This parameter value must be greater than 0.
1961
+ # Limit the number of aliases returned.
1971
1962
  #
1972
1963
  # @return [Types::ListAliasesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1973
1964
  #
@@ -2096,41 +2087,29 @@ module Aws::Lambda
2096
2087
  req.send_request(options)
2097
2088
  end
2098
2089
 
2099
- # Returns a list of your Lambda functions. For each function, the
2100
- # response includes the function configuration information. You must use
2101
- # GetFunction to retrieve the code for your function.
2102
- #
2103
- # This operation requires permission for the `lambda:ListFunctions`
2104
- # action.
2105
- #
2106
- # If you are using the versioning feature, you can list all of your
2107
- # functions or only `$LATEST` versions. For information about the
2108
- # versioning feature, see [AWS Lambda Function Versioning and
2109
- # Aliases][1].
2090
+ # Returns a list of Lambda functions, with the version-specific
2091
+ # configuration of each.
2110
2092
  #
2111
- #
2112
- #
2113
- # [1]: http://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html
2093
+ # Set `FunctionVersion` to `ALL` to include all published versions of
2094
+ # each function in addition to the unpublished version. To get more
2095
+ # information about a function or version, use GetFunction.
2114
2096
  #
2115
2097
  # @option params [String] :master_region
2116
- # Specify a region (e.g. `us-east-2`) to only list functions that were
2117
- # created in that region, or `ALL` to include functions replicated from
2118
- # any region. If specified, you also must specify the `FunctionVersion`.
2098
+ # For Lambda@Edge functions, the region of the master function. For
2099
+ # example, `us-east-2` or `ALL`. If specified, you must set
2100
+ # `FunctionVersion` to `ALL`.
2119
2101
  #
2120
2102
  # @option params [String] :function_version
2121
- # Set to `ALL` to list all published versions. If not specified, only
2122
- # the latest unpublished version ARN is returned.
2103
+ # Set to `ALL` to include entries for all published versions of each
2104
+ # function.
2123
2105
  #
2124
2106
  # @option params [String] :marker
2125
- # Optional string. An opaque pagination token returned from a previous
2126
- # `ListFunctions` operation. If present, indicates where to continue the
2127
- # listing.
2107
+ # Specify the pagination token returned by a previous request to
2108
+ # retrieve the next page of results.
2128
2109
  #
2129
2110
  # @option params [Integer] :max_items
2130
- # Optional integer. Specifies the maximum number of AWS Lambda functions
2131
- # to return in response. This parameter value must be greater than 0.
2132
- # The absolute maximum of AWS Lambda functions that can be returned is
2133
- # 50.
2111
+ # Specify a value between 1 and 50 to limit the number of functions in
2112
+ # the response.
2134
2113
  #
2135
2114
  # @return [Types::ListFunctionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2136
2115
  #
@@ -2206,19 +2185,21 @@ module Aws::Lambda
2206
2185
  req.send_request(options)
2207
2186
  end
2208
2187
 
2209
- # Lists the versions of a function layer. Versions that have been
2210
- # deleted aren't listed. Specify a [runtime identifier][1] to list only
2211
- # versions that indicate that they're compatible with that runtime.
2188
+ # Lists the versions of an [AWS Lambda layer][1]. Versions that have
2189
+ # been deleted aren't listed. Specify a [runtime identifier][2] to list
2190
+ # only versions that indicate that they're compatible with that
2191
+ # runtime.
2212
2192
  #
2213
2193
  #
2214
2194
  #
2215
- # [1]: http://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html
2195
+ # [1]: http://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html
2196
+ # [2]: http://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html
2216
2197
  #
2217
2198
  # @option params [String] :compatible_runtime
2218
2199
  # A runtime identifier. For example, `go1.x`.
2219
2200
  #
2220
2201
  # @option params [required, String] :layer_name
2221
- # The name of the layer.
2202
+ # The name or Amazon Resource Name (ARN) of the layer.
2222
2203
  #
2223
2204
  # @option params [String] :marker
2224
2205
  # A pagination token returned by a previous call.
@@ -2261,13 +2242,14 @@ module Aws::Lambda
2261
2242
  req.send_request(options)
2262
2243
  end
2263
2244
 
2264
- # Lists function layers and shows information about the latest version
2265
- # of each. Specify a [runtime identifier][1] to list only layers that
2266
- # indicate that they're compatible with that runtime.
2245
+ # Lists [AWS Lambda layers][1] and shows information about the latest
2246
+ # version of each. Specify a [runtime identifier][2] to list only layers
2247
+ # that indicate that they're compatible with that runtime.
2267
2248
  #
2268
2249
  #
2269
2250
  #
2270
- # [1]: http://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html
2251
+ # [1]: http://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html
2252
+ # [2]: http://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html
2271
2253
  #
2272
2254
  # @option params [String] :compatible_runtime
2273
2255
  # A runtime identifier. For example, `go1.x`.
@@ -2314,23 +2296,15 @@ module Aws::Lambda
2314
2296
  req.send_request(options)
2315
2297
  end
2316
2298
 
2317
- # Returns a list of tags assigned to a function when supplied the
2318
- # function ARN (Amazon Resource Name). For more information on Tagging,
2319
- # see [Tagging Lambda Functions][1] in the **AWS Lambda Developer
2320
- # Guide**.
2299
+ # Returns a function's [tags][1]. You can also view tags with
2300
+ # GetFunction.
2321
2301
  #
2322
2302
  #
2323
2303
  #
2324
2304
  # [1]: http://docs.aws.amazon.com/lambda/latest/dg/tagging.html
2325
2305
  #
2326
2306
  # @option params [required, String] :resource
2327
- # The ARN (Amazon Resource Name) of the function. For more information,
2328
- # see [Tagging Lambda Functions][1] in the **AWS Lambda Developer
2329
- # Guide**.
2330
- #
2331
- #
2332
- #
2333
- # [1]: http://docs.aws.amazon.com/lambda/latest/dg/tagging.html
2307
+ # The function's Amazon Resource Name (ARN).
2334
2308
  #
2335
2309
  # @return [Types::ListTagsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2336
2310
  #
@@ -2356,8 +2330,8 @@ module Aws::Lambda
2356
2330
  req.send_request(options)
2357
2331
  end
2358
2332
 
2359
- # Lists all versions of a function. For information about versioning,
2360
- # see [AWS Lambda Function Versioning and Aliases][1].
2333
+ # Returns a list of [versions][1], with the version-specific
2334
+ # configuration of each.
2361
2335
  #
2362
2336
  #
2363
2337
  #
@@ -2379,14 +2353,11 @@ module Aws::Lambda
2379
2353
  # only the function name, it is limited to 64 characters in length.
2380
2354
  #
2381
2355
  # @option params [String] :marker
2382
- # Optional string. An opaque pagination token returned from a previous
2383
- # `ListVersionsByFunction` operation. If present, indicates where to
2384
- # continue the listing.
2356
+ # Specify the pagination token returned by a previous request to
2357
+ # retrieve the next page of results.
2385
2358
  #
2386
2359
  # @option params [Integer] :max_items
2387
- # Optional integer. Specifies the maximum number of AWS Lambda function
2388
- # versions to return in response. This parameter value must be greater
2389
- # than 0.
2360
+ # Limit the number of versions returned.
2390
2361
  #
2391
2362
  # @return [Types::ListVersionsByFunctionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2392
2363
  #
@@ -2462,15 +2433,19 @@ module Aws::Lambda
2462
2433
  req.send_request(options)
2463
2434
  end
2464
2435
 
2465
- # Creates a function layer from a ZIP archive. Each time you call
2466
- # `PublishLayerVersion` with the same version name, a new version is
2467
- # created.
2436
+ # Creates an [AWS Lambda layer][1] from a ZIP archive. Each time you
2437
+ # call `PublishLayerVersion` with the same version name, a new version
2438
+ # is created.
2468
2439
  #
2469
2440
  # Add layers to your function with CreateFunction or
2470
2441
  # UpdateFunctionConfiguration.
2471
2442
  #
2443
+ #
2444
+ #
2445
+ # [1]: http://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html
2446
+ #
2472
2447
  # @option params [required, String] :layer_name
2473
- # The name of the layer.
2448
+ # The name or Amazon Resource Name (ARN) of the layer.
2474
2449
  #
2475
2450
  # @option params [String] :description
2476
2451
  # The description of the version.
@@ -2549,12 +2524,17 @@ module Aws::Lambda
2549
2524
  req.send_request(options)
2550
2525
  end
2551
2526
 
2552
- # Publishes a version of your function from the current snapshot of
2553
- # $LATEST. That is, AWS Lambda takes a snapshot of the function code and
2554
- # configuration information from $LATEST and publishes a new version.
2555
- # The code and configuration cannot be modified after publication. For
2556
- # information about the versioning feature, see [AWS Lambda Function
2557
- # Versioning and Aliases][1].
2527
+ # Creates a [version][1] from the current code and configuration of a
2528
+ # function. Use versions to create a snapshot of your function code and
2529
+ # configuration that doesn't change.
2530
+ #
2531
+ # AWS Lambda does not publish a version if the function's configuration
2532
+ # and code hasn't changed since the last version. Use
2533
+ # UpdateFunctionCode or UpdateFunctionConfiguration to update the
2534
+ # function prior to publishing a version.
2535
+ #
2536
+ # Clients can invoke versions directly or with an alias. To create an
2537
+ # alias, use CreateAlias.
2558
2538
  #
2559
2539
  #
2560
2540
  #
@@ -2576,24 +2556,19 @@ module Aws::Lambda
2576
2556
  # only the function name, it is limited to 64 characters in length.
2577
2557
  #
2578
2558
  # @option params [String] :code_sha_256
2579
- # The SHA256 hash of the deployment package you want to publish. This
2580
- # provides validation on the code you are publishing. If you provide
2581
- # this parameter, the value must match the SHA256 of the $LATEST version
2582
- # for the publication to succeed. You can use the **DryRun** parameter
2583
- # of UpdateFunctionCode to verify the hash value that will be returned
2584
- # before publishing your new version.
2559
+ # Only publish a version if the hash matches the value specified. Use
2560
+ # this option to avoid publishing a version if the function code has
2561
+ # changed since you last updated it. You can get the hash for the
2562
+ # version you uploaded from the output of UpdateFunctionCode.
2585
2563
  #
2586
2564
  # @option params [String] :description
2587
- # The description for the version you are publishing. If not provided,
2588
- # AWS Lambda copies the description from the $LATEST version.
2565
+ # Specify a description for the version to override the description in
2566
+ # the function configuration.
2589
2567
  #
2590
2568
  # @option params [String] :revision_id
2591
- # An optional value you can use to ensure you are updating the latest
2592
- # update of the function version or alias. If the `RevisionID` you pass
2593
- # doesn't match the latest `RevisionId` of the function or alias, it
2594
- # will fail with an error message, advising you retrieve the latest
2595
- # function version or alias `RevisionID` using either GetFunction or
2596
- # GetAlias.
2569
+ # Only update the function if the revision ID matches the ID specified.
2570
+ # Use this option to avoid publishing a version if the function
2571
+ # configuration has changed since you last updated it.
2597
2572
  #
2598
2573
  # @return [Types::FunctionConfiguration] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2599
2574
  #
@@ -2697,12 +2672,20 @@ module Aws::Lambda
2697
2672
  req.send_request(options)
2698
2673
  end
2699
2674
 
2700
- # Sets a limit on the number of concurrent executions available to this
2701
- # function. It is a subset of your account's total concurrent execution
2702
- # limit per region. Note that Lambda automatically reserves a buffer of
2703
- # 100 concurrent executions for functions without any reserved
2704
- # concurrency limit. This means if your account limit is 1000, you have
2705
- # a total of 900 available to allocate to individual functions. For more
2675
+ # Sets the maximum number of simultaneous executions for a function, and
2676
+ # reserves capacity for that concurrency level.
2677
+ #
2678
+ # Concurrency settings apply to the function as a whole, including all
2679
+ # published versions and the unpublished version. Reserving concurrency
2680
+ # both guarantees that your function has capacity to process the
2681
+ # specified number of events simultaneously, and prevents it from
2682
+ # scaling beyond that level. Use GetFunction to see the current setting
2683
+ # for a function.
2684
+ #
2685
+ # Use GetAccountSettings to see your regional concurrency limit. You can
2686
+ # reserve concurrency for as many functions as you like, as long as you
2687
+ # leave at least 100 simultaneous executions unreserved for functions
2688
+ # that aren't configured with a per-function limit. For more
2706
2689
  # information, see [Managing Concurrency][1].
2707
2690
  #
2708
2691
  #
@@ -2714,18 +2697,18 @@ module Aws::Lambda
2714
2697
  #
2715
2698
  # **Name formats**
2716
2699
  #
2717
- # * **Function name** - `MyFunction`.
2700
+ # * **Function name** - `my-function`.
2718
2701
  #
2719
2702
  # * **Function ARN** -
2720
- # `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`.
2703
+ # `arn:aws:lambda:us-west-2:123456789012:function:my-function`.
2721
2704
  #
2722
- # * **Partial ARN** - `123456789012:function:MyFunction`.
2705
+ # * **Partial ARN** - `123456789012:function:my-function`.
2723
2706
  #
2724
2707
  # The length constraint applies only to the full ARN. If you specify
2725
2708
  # only the function name, it is limited to 64 characters in length.
2726
2709
  #
2727
2710
  # @option params [required, Integer] :reserved_concurrent_executions
2728
- # The concurrent execution limit reserved for this function.
2711
+ # The number of simultaneous executions to reserve for the function.
2729
2712
  #
2730
2713
  # @return [Types::Concurrency] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2731
2714
  #
@@ -2751,11 +2734,16 @@ module Aws::Lambda
2751
2734
  req.send_request(options)
2752
2735
  end
2753
2736
 
2754
- # Removes a statement from the permissions policy for a layer version.
2755
- # For more information, see AddLayerVersionPermission.
2737
+ # Removes a statement from the permissions policy for a version of an
2738
+ # [AWS Lambda layer][1]. For more information, see
2739
+ # AddLayerVersionPermission.
2740
+ #
2741
+ #
2742
+ #
2743
+ # [1]: http://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html
2756
2744
  #
2757
2745
  # @option params [required, String] :layer_name
2758
- # The name of the layer.
2746
+ # The name or Amazon Resource Name (ARN) of the layer.
2759
2747
  #
2760
2748
  # @option params [required, Integer] :version_number
2761
2749
  # The version number.
@@ -2788,39 +2776,26 @@ module Aws::Lambda
2788
2776
  req.send_request(options)
2789
2777
  end
2790
2778
 
2791
- # Removes permissions from a function. You can remove individual
2792
- # permissions from an resource policy associated with a Lambda function
2793
- # by providing a statement ID that you provided when you added the
2794
- # permission. When you remove permissions, disable the event source
2795
- # mapping or trigger configuration first to avoid errors.
2796
- #
2797
- # Permissions apply to the Amazon Resource Name (ARN) used to invoke the
2798
- # function, which can be unqualified (the unpublished version of the
2799
- # function), or include a version or alias. If a client uses a version
2800
- # or alias to invoke a function, use the `Qualifier` parameter to apply
2801
- # permissions to that ARN. For more information about versioning, see
2802
- # [AWS Lambda Function Versioning and Aliases][1].
2803
- #
2804
- # You need permission for the `lambda:RemovePermission` action.
2805
- #
2806
- #
2807
- #
2808
- # [1]: http://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html
2779
+ # Revokes function use permission from an AWS service or another
2780
+ # account. You can get the ID of the statement from the output of
2781
+ # GetPolicy.
2809
2782
  #
2810
2783
  # @option params [required, String] :function_name
2811
- # The name of the Lambda function.
2784
+ # The name of the Lambda function, version, or alias.
2812
2785
  #
2813
2786
  # **Name formats**
2814
2787
  #
2815
- # * **Function name** - `MyFunction`.
2788
+ # * **Function name** - `my-function` (name-only), `my-function:v1`
2789
+ # (with alias).
2816
2790
  #
2817
2791
  # * **Function ARN** -
2818
- # `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`.
2792
+ # `arn:aws:lambda:us-west-2:123456789012:function:my-function`.
2819
2793
  #
2820
- # * **Partial ARN** - `123456789012:function:MyFunction`.
2794
+ # * **Partial ARN** - `123456789012:function:my-function`.
2821
2795
  #
2822
- # The length constraint applies only to the full ARN. If you specify
2823
- # only the function name, it is limited to 64 characters in length.
2796
+ # You can append a version number or alias to any of the formats. The
2797
+ # length constraint applies only to the full ARN. If you specify only
2798
+ # the function name, it is limited to 64 characters in length.
2824
2799
  #
2825
2800
  # @option params [required, String] :statement_id
2826
2801
  # Statement ID of the permission to remove.
@@ -2830,12 +2805,9 @@ module Aws::Lambda
2830
2805
  # version of the function.
2831
2806
  #
2832
2807
  # @option params [String] :revision_id
2833
- # An optional value you can use to ensure you are updating the latest
2834
- # update of the function version or alias. If the `RevisionID` you pass
2835
- # doesn't match the latest `RevisionId` of the function or alias, it
2836
- # will fail with an error message, advising you to retrieve the latest
2837
- # function version or alias `RevisionID` using either GetFunction or
2838
- # GetAlias.
2808
+ # Only update the policy if the revision ID matches the ID specified.
2809
+ # Use this option to avoid modifying a policy that has changed since you
2810
+ # last read it.
2839
2811
  #
2840
2812
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2841
2813
  #
@@ -2868,33 +2840,17 @@ module Aws::Lambda
2868
2840
  req.send_request(options)
2869
2841
  end
2870
2842
 
2871
- # Creates a list of tags (key-value pairs) on the Lambda function.
2872
- # Requires the Lambda function ARN (Amazon Resource Name). If a key is
2873
- # specified without a value, Lambda creates a tag with the specified key
2874
- # and a value of null. For more information, see [Tagging Lambda
2875
- # Functions][1] in the **AWS Lambda Developer Guide**.
2843
+ # Adds [tags][1] to a function.
2876
2844
  #
2877
2845
  #
2878
2846
  #
2879
2847
  # [1]: http://docs.aws.amazon.com/lambda/latest/dg/tagging.html
2880
2848
  #
2881
2849
  # @option params [required, String] :resource
2882
- # The ARN (Amazon Resource Name) of the Lambda function. For more
2883
- # information, see [Tagging Lambda Functions][1] in the **AWS Lambda
2884
- # Developer Guide**.
2885
- #
2886
- #
2887
- #
2888
- # [1]: http://docs.aws.amazon.com/lambda/latest/dg/tagging.html
2850
+ # The function's Amazon Resource Name (ARN).
2889
2851
  #
2890
2852
  # @option params [required, Hash<String,String>] :tags
2891
- # The list of tags (key-value pairs) you are assigning to the Lambda
2892
- # function. For more information, see [Tagging Lambda Functions][1] in
2893
- # the **AWS Lambda Developer Guide**.
2894
- #
2895
- #
2896
- #
2897
- # [1]: http://docs.aws.amazon.com/lambda/latest/dg/tagging.html
2853
+ # A list of tags to apply to the function.
2898
2854
  #
2899
2855
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2900
2856
  #
@@ -2916,31 +2872,17 @@ module Aws::Lambda
2916
2872
  req.send_request(options)
2917
2873
  end
2918
2874
 
2919
- # Removes tags from a Lambda function. Requires the function ARN (Amazon
2920
- # Resource Name). For more information, see [Tagging Lambda
2921
- # Functions][1] in the **AWS Lambda Developer Guide**.
2875
+ # Removes [tags][1] from a function.
2922
2876
  #
2923
2877
  #
2924
2878
  #
2925
2879
  # [1]: http://docs.aws.amazon.com/lambda/latest/dg/tagging.html
2926
2880
  #
2927
2881
  # @option params [required, String] :resource
2928
- # The ARN (Amazon Resource Name) of the function. For more information,
2929
- # see [Tagging Lambda Functions][1] in the **AWS Lambda Developer
2930
- # Guide**.
2931
- #
2932
- #
2933
- #
2934
- # [1]: http://docs.aws.amazon.com/lambda/latest/dg/tagging.html
2882
+ # The function's Amazon Resource Name (ARN).
2935
2883
  #
2936
2884
  # @option params [required, Array<String>] :tag_keys
2937
- # The list of tag keys to be deleted from the function. For more
2938
- # information, see [Tagging Lambda Functions][1] in the **AWS Lambda
2939
- # Developer Guide**.
2940
- #
2941
- #
2942
- #
2943
- # [1]: http://docs.aws.amazon.com/lambda/latest/dg/tagging.html
2885
+ # A list of tag keys to remove from the function.
2944
2886
  #
2945
2887
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2946
2888
  #
@@ -2960,15 +2902,11 @@ module Aws::Lambda
2960
2902
  req.send_request(options)
2961
2903
  end
2962
2904
 
2963
- # Using this API you can update the function version to which the alias
2964
- # points and the alias description. For more information, see
2965
- # [Introduction to AWS Lambda Aliases][1].
2966
- #
2967
- # This requires permission for the lambda:UpdateAlias action.
2905
+ # Updates the configuration of a Lambda function [alias][1].
2968
2906
  #
2969
2907
  #
2970
2908
  #
2971
- # [1]: http://docs.aws.amazon.com/lambda/latest/dg/aliases-intro.html
2909
+ # [1]: http://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html
2972
2910
  #
2973
2911
  # @option params [required, String] :function_name
2974
2912
  # The name of the lambda function.
@@ -2986,31 +2924,25 @@ module Aws::Lambda
2986
2924
  # only the function name, it is limited to 64 characters in length.
2987
2925
  #
2988
2926
  # @option params [required, String] :name
2989
- # The alias name.
2927
+ # The name of the alias.
2990
2928
  #
2991
2929
  # @option params [String] :function_version
2992
- # Using this parameter you can change the Lambda function version to
2993
- # which the alias points.
2930
+ # The function version that the alias invokes.
2994
2931
  #
2995
2932
  # @option params [String] :description
2996
- # You can change the description of the alias using this parameter.
2933
+ # A description of the alias.
2997
2934
  #
2998
2935
  # @option params [Types::AliasRoutingConfiguration] :routing_config
2999
- # Specifies an additional version your alias can point to, allowing you
3000
- # to dictate what percentage of traffic will invoke each version. For
3001
- # more information, see [Traffic Shifting Using Aliases][1].
2936
+ # The [routing configuration][1] of the alias.
3002
2937
  #
3003
2938
  #
3004
2939
  #
3005
2940
  # [1]: http://docs.aws.amazon.com/lambda/latest/dg/lambda-traffic-shifting-using-aliases.html
3006
2941
  #
3007
2942
  # @option params [String] :revision_id
3008
- # An optional value you can use to ensure you are updating the latest
3009
- # update of the function version or alias. If the `RevisionID` you pass
3010
- # doesn't match the latest `RevisionId` of the function or alias, it
3011
- # will fail with an error message, advising you retrieve the latest
3012
- # function version or alias `RevisionID` using either GetFunction or
3013
- # GetAlias.
2943
+ # Only update the alias if the revision ID matches the ID specified. Use
2944
+ # this option to avoid modifying an alias that has changed since you
2945
+ # last read it.
3014
2946
  #
3015
2947
  # @return [Types::AliasConfiguration] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3016
2948
  #
@@ -3176,80 +3108,54 @@ module Aws::Lambda
3176
3108
  req.send_request(options)
3177
3109
  end
3178
3110
 
3179
- # Updates the code for the specified Lambda function. This operation
3180
- # must only be used on an existing Lambda function and cannot be used to
3181
- # update the function configuration.
3182
- #
3183
- # If you are using the versioning feature, note this API will always
3184
- # update the $LATEST version of your Lambda function. For information
3185
- # about the versioning feature, see [AWS Lambda Function Versioning and
3186
- # Aliases][1].
3187
- #
3188
- # This operation requires permission for the `lambda:UpdateFunctionCode`
3189
- # action.
3190
- #
3111
+ # Updates a Lambda function's code.
3191
3112
  #
3192
- #
3193
- # [1]: http://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html
3113
+ # The function's code is locked when you publish a version. You cannot
3114
+ # modify the code of a published version, only the unpublished version.
3194
3115
  #
3195
3116
  # @option params [required, String] :function_name
3196
3117
  # The name of the Lambda function.
3197
3118
  #
3198
3119
  # **Name formats**
3199
3120
  #
3200
- # * **Function name** - `MyFunction`.
3121
+ # * **Function name** - `my-function`.
3201
3122
  #
3202
3123
  # * **Function ARN** -
3203
- # `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`.
3124
+ # `arn:aws:lambda:us-west-2:123456789012:function:my-function`.
3204
3125
  #
3205
- # * **Partial ARN** - `123456789012:function:MyFunction`.
3126
+ # * **Partial ARN** - `123456789012:function:my-function`.
3206
3127
  #
3207
3128
  # The length constraint applies only to the full ARN. If you specify
3208
3129
  # only the function name, it is limited to 64 characters in length.
3209
3130
  #
3210
3131
  # @option params [String, IO] :zip_file
3211
- # The contents of your zip file containing your deployment package. If
3212
- # you are using the web API directly, the contents of the zip file must
3213
- # be base64-encoded. If you are using the AWS SDKs or the AWS CLI, the
3214
- # SDKs or CLI will do the encoding for you. For more information about
3215
- # creating a .zip file, see [Execution Permissions][1].
3216
- #
3217
- #
3218
- #
3219
- # [1]: http://docs.aws.amazon.com/lambda/latest/dg/intro-permission-model.html#lambda-intro-execution-role.html
3132
+ # The base64-encoded contents of the deployment package. AWS SDK and AWS
3133
+ # CLI clients handle the encoding for you.
3220
3134
  #
3221
3135
  # @option params [String] :s3_bucket
3222
- # Amazon S3 bucket name where the .zip file containing your deployment
3223
- # package is stored. This bucket must reside in the same AWS Region
3224
- # where you are creating the Lambda function.
3136
+ # An Amazon S3 bucket in the same region as your function. The bucket
3137
+ # can be in a different AWS account.
3225
3138
  #
3226
3139
  # @option params [String] :s3_key
3227
- # The Amazon S3 object (the deployment package) key name you want to
3228
- # upload.
3140
+ # The Amazon S3 key of the deployment package.
3229
3141
  #
3230
3142
  # @option params [String] :s3_object_version
3231
- # The Amazon S3 object (the deployment package) version you want to
3232
- # upload.
3143
+ # For versioned objects, the version of the deployment package object to
3144
+ # use.
3233
3145
  #
3234
3146
  # @option params [Boolean] :publish
3235
- # This boolean parameter can be used to request AWS Lambda to update the
3236
- # Lambda function and publish a version as an atomic operation.
3147
+ # Set to true to publish a new version of the function after updating
3148
+ # the code. This has the same effect as calling PublishVersion
3149
+ # separately.
3237
3150
  #
3238
3151
  # @option params [Boolean] :dry_run
3239
- # This boolean parameter can be used to test your request to AWS Lambda
3240
- # to update the Lambda function and publish a version as an atomic
3241
- # operation. It will do all necessary computation and validation of your
3242
- # code but will not upload it or a publish a version. Each time this
3243
- # operation is invoked, the `CodeSha256` hash value of the provided code
3244
- # will also be computed and returned in the response.
3152
+ # Set to true to validate the request parameters and access permissions
3153
+ # without modifying the function code.
3245
3154
  #
3246
3155
  # @option params [String] :revision_id
3247
- # An optional value you can use to ensure you are updating the latest
3248
- # update of the function version or alias. If the `RevisionID` you pass
3249
- # doesn't match the latest `RevisionId` of the function or alias, it
3250
- # will fail with an error message, advising you to retrieve the latest
3251
- # function version or alias `RevisionID` using either using using either
3252
- # GetFunction or GetAlias.
3156
+ # Only update the function if the revision ID matches the ID specified.
3157
+ # Use this option to avoid modifying a function that has changed since
3158
+ # you last read it.
3253
3159
  #
3254
3160
  # @return [Types::FunctionConfiguration] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3255
3161
  #
@@ -3360,35 +3266,27 @@ module Aws::Lambda
3360
3266
  req.send_request(options)
3361
3267
  end
3362
3268
 
3363
- # Updates the configuration parameters for the specified Lambda function
3364
- # by using the values provided in the request. You provide only the
3365
- # parameters you want to change. This operation must only be used on an
3366
- # existing Lambda function and cannot be used to update the function's
3367
- # code.
3368
- #
3369
- # If you are using the versioning feature, note this API will always
3370
- # update the $LATEST version of your Lambda function. For information
3371
- # about the versioning feature, see [AWS Lambda Function Versioning and
3372
- # Aliases][1].
3269
+ # Modify the version-specifc settings of a Lambda function.
3373
3270
  #
3374
- # This operation requires permission for the
3375
- # `lambda:UpdateFunctionConfiguration` action.
3271
+ # These settings can vary between versions of a function and are locked
3272
+ # when you publish a version. You cannot modify the configuration of a
3273
+ # published version, only the unpublished version.
3376
3274
  #
3377
- #
3378
- #
3379
- # [1]: http://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html
3275
+ # To configure function concurrency, use PutFunctionConcurrency. To
3276
+ # grant invoke permissions to an account or AWS service, use
3277
+ # AddPermission.
3380
3278
  #
3381
3279
  # @option params [required, String] :function_name
3382
3280
  # The name of the Lambda function.
3383
3281
  #
3384
3282
  # **Name formats**
3385
3283
  #
3386
- # * **Function name** - `MyFunction`.
3284
+ # * **Function name** - `my-function`.
3387
3285
  #
3388
3286
  # * **Function ARN** -
3389
- # `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`.
3287
+ # `arn:aws:lambda:us-west-2:123456789012:function:my-function`.
3390
3288
  #
3391
- # * **Partial ARN** - `123456789012:function:MyFunction`.
3289
+ # * **Partial ARN** - `123456789012:function:my-function`.
3392
3290
  #
3393
3291
  # The length constraint applies only to the full ARN. If you specify
3394
3292
  # only the function name, it is limited to 64 characters in length.
@@ -3449,12 +3347,9 @@ module Aws::Lambda
3449
3347
  # requests with AWS X-Ray.
3450
3348
  #
3451
3349
  # @option params [String] :revision_id
3452
- # An optional value you can use to ensure you are updating the latest
3453
- # update of the function version or alias. If the `RevisionID` you pass
3454
- # doesn't match the latest `RevisionId` of the function or alias, it
3455
- # will fail with an error message, advising you to retrieve the latest
3456
- # function version or alias `RevisionID` using either GetFunction or
3457
- # GetAlias.
3350
+ # Only update the function if the revision ID matches the ID specified.
3351
+ # Use this option to avoid modifying a function that has changed since
3352
+ # you last read it.
3458
3353
  #
3459
3354
  # @option params [Array<String>] :layers
3460
3355
  # A list of [function layers][1] to add to the function's execution
@@ -3606,7 +3501,7 @@ module Aws::Lambda
3606
3501
  params: params,
3607
3502
  config: config)
3608
3503
  context[:gem_name] = 'aws-sdk-lambda'
3609
- context[:gem_version] = '1.16.0'
3504
+ context[:gem_version] = '1.17.0'
3610
3505
  Seahorse::Client::Request.new(handlers, context)
3611
3506
  end
3612
3507