aws-sdk-lambda 1.16.0 → 1.17.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
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