aws-sdk-efs 1.33.0 → 1.38.0

Sign up to get free protection for your applications and to get access to all the features.
data/VERSION ADDED
@@ -0,0 +1 @@
1
+ 1.38.0
data/lib/aws-sdk-efs.rb CHANGED
@@ -7,6 +7,7 @@
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
10
+
10
11
  require 'aws-sdk-core'
11
12
  require 'aws-sigv4'
12
13
 
@@ -44,9 +45,9 @@ require_relative 'aws-sdk-efs/customizations'
44
45
  #
45
46
  # See {Errors} for more information.
46
47
  #
47
- # @service
48
+ # @!group service
48
49
  module Aws::EFS
49
50
 
50
- GEM_VERSION = '1.33.0'
51
+ GEM_VERSION = '1.38.0'
51
52
 
52
53
  end
@@ -85,13 +85,28 @@ module Aws::EFS
85
85
  # * `Aws::Credentials` - Used for configuring static, non-refreshing
86
86
  # credentials.
87
87
  #
88
+ # * `Aws::SharedCredentials` - Used for loading static credentials from a
89
+ # shared file, such as `~/.aws/config`.
90
+ #
91
+ # * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
92
+ #
93
+ # * `Aws::AssumeRoleWebIdentityCredentials` - Used when you need to
94
+ # assume a role after providing credentials via the web.
95
+ #
96
+ # * `Aws::SSOCredentials` - Used for loading credentials from AWS SSO using an
97
+ # access token generated from `aws login`.
98
+ #
99
+ # * `Aws::ProcessCredentials` - Used for loading credentials from a
100
+ # process that outputs to stdout.
101
+ #
88
102
  # * `Aws::InstanceProfileCredentials` - Used for loading credentials
89
103
  # from an EC2 IMDS on an EC2 instance.
90
104
  #
91
- # * `Aws::SharedCredentials` - Used for loading credentials from a
92
- # shared file, such as `~/.aws/config`.
105
+ # * `Aws::ECSCredentials` - Used for loading credentials from
106
+ # instances running in ECS.
93
107
  #
94
- # * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
108
+ # * `Aws::CognitoIdentityCredentials` - Used for loading credentials
109
+ # from the Cognito Identity service.
95
110
  #
96
111
  # When `:credentials` are not configured directly, the following
97
112
  # locations will be searched for credentials:
@@ -101,10 +116,10 @@ module Aws::EFS
101
116
  # * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
102
117
  # * `~/.aws/credentials`
103
118
  # * `~/.aws/config`
104
- # * EC2 IMDS instance profile - When used by default, the timeouts are
105
- # very aggressive. Construct and pass an instance of
106
- # `Aws::InstanceProfileCredentails` to enable retries and extended
107
- # timeouts.
119
+ # * EC2/ECS IMDS instance profile - When used by default, the timeouts
120
+ # are very aggressive. Construct and pass an instance of
121
+ # `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
122
+ # enable retries and extended timeouts.
108
123
  #
109
124
  # @option options [required, String] :region
110
125
  # The AWS region to connect to. The configured `:region` is
@@ -319,8 +334,8 @@ module Aws::EFS
319
334
  # user and group override any identity information provided by the NFS
320
335
  # client. The file system path is exposed as the access point's root
321
336
  # directory. Applications using the access point can only access data in
322
- # its own directory and below. To learn more, see [Mounting a File
323
- # System Using EFS Access Points][1].
337
+ # its own directory and below. To learn more, see [Mounting a file
338
+ # system using EFS access points][1].
324
339
  #
325
340
  # This operation requires permissions for the
326
341
  # `elasticfilesystem:CreateAccessPoint` action.
@@ -356,7 +371,13 @@ module Aws::EFS
356
371
  # `Path` specified does not exist, EFS creates it and applies the
357
372
  # `CreationInfo` settings when a client connects to an access point.
358
373
  # When specifying a `RootDirectory`, you need to provide the `Path`, and
359
- # the `CreationInfo` is optional.
374
+ # the `CreationInfo`.
375
+ #
376
+ # Amazon EFS creates a root directory only if you have provided the
377
+ # CreationInfo: OwnUid, OwnGID, and permissions for the directory. If
378
+ # you do not provide this information, Amazon EFS does not create the
379
+ # root directory. If the root directory does not exist, attempts to
380
+ # mount using the access point will fail.
360
381
  #
361
382
  # @return [Types::AccessPointDescription] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
362
383
  #
@@ -416,7 +437,7 @@ module Aws::EFS
416
437
  # resp.root_directory.creation_info.owner_gid #=> Integer
417
438
  # resp.root_directory.creation_info.permissions #=> String
418
439
  # resp.owner_id #=> String
419
- # resp.life_cycle_state #=> String, one of "creating", "available", "updating", "deleting", "deleted"
440
+ # resp.life_cycle_state #=> String, one of "creating", "available", "updating", "deleting", "deleted", "error"
420
441
  #
421
442
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/CreateAccessPoint AWS API Documentation
422
443
  #
@@ -456,6 +477,9 @@ module Aws::EFS
456
477
  # creating a file system, the client can learn of its existence from the
457
478
  # `FileSystemAlreadyExists` error.
458
479
  #
480
+ # For more information, see [Creating a file system][1] in the *Amazon
481
+ # EFS User Guide*.
482
+ #
459
483
  # <note markdown="1"> The `CreateFileSystem` call returns while the file system's lifecycle
460
484
  # state is still `creating`. You can check the file system creation
461
485
  # status by calling the DescribeFileSystems operation, which among other
@@ -463,29 +487,33 @@ module Aws::EFS
463
487
  #
464
488
  # </note>
465
489
  #
466
- # This operation also takes an optional `PerformanceMode` parameter that
490
+ # This operation accepts an optional `PerformanceMode` parameter that
467
491
  # you choose for your file system. We recommend `generalPurpose`
468
492
  # performance mode for most file systems. File systems using the `maxIO`
469
493
  # performance mode can scale to higher levels of aggregate throughput
470
494
  # and operations per second with a tradeoff of slightly higher latencies
471
495
  # for most file operations. The performance mode can't be changed after
472
496
  # the file system has been created. For more information, see [Amazon
473
- # EFS: Performance Modes][1].
497
+ # EFS performance modes][2].
498
+ #
499
+ # You can set the throughput mode for the file system using the
500
+ # `ThroughputMode` parameter.
474
501
  #
475
502
  # After the file system is fully created, Amazon EFS sets its lifecycle
476
503
  # state to `available`, at which point you can create one or more mount
477
504
  # targets for the file system in your VPC. For more information, see
478
505
  # CreateMountTarget. You mount your Amazon EFS file system on an EC2
479
506
  # instances in your VPC by using the mount target. For more information,
480
- # see [Amazon EFS: How it Works][2].
507
+ # see [Amazon EFS: How it Works][3].
481
508
  #
482
509
  # This operation requires permissions for the
483
510
  # `elasticfilesystem:CreateFileSystem` action.
484
511
  #
485
512
  #
486
513
  #
487
- # [1]: https://docs.aws.amazon.com/efs/latest/ug/performance.html#performancemodes.html
488
- # [2]: https://docs.aws.amazon.com/efs/latest/ug/how-it-works.html
514
+ # [1]: https://docs.aws.amazon.com/efs/latest/ug/creating-using-create-fs.html#creating-using-create-fs-part1
515
+ # [2]: https://docs.aws.amazon.com/efs/latest/ug/performance.html#performancemodes.html
516
+ # [3]: https://docs.aws.amazon.com/efs/latest/ug/how-it-works.html
489
517
  #
490
518
  # @option params [required, String] :creation_token
491
519
  # A string of up to 64 ASCII characters. Amazon EFS uses this to ensure
@@ -502,6 +530,11 @@ module Aws::EFS
502
530
  # for most file operations. The performance mode can't be changed after
503
531
  # the file system has been created.
504
532
  #
533
+ # <note markdown="1"> The `maxIO` mode is not supported on file systems using One Zone
534
+ # storage classes.
535
+ #
536
+ # </note>
537
+ #
505
538
  # @option params [Boolean] :encrypted
506
539
  # A Boolean value that, if true, creates an encrypted file system. When
507
540
  # creating an encrypted file system, you have the option of specifying
@@ -513,7 +546,7 @@ module Aws::EFS
513
546
  # @option params [String] :kms_key_id
514
547
  # The ID of the AWS KMS CMK to be used to protect the encrypted file
515
548
  # system. This parameter is only required if you want to use a
516
- # nondefault CMK. If this parameter is not specified, the default CMK
549
+ # non-default CMK. If this parameter is not specified, the default CMK
517
550
  # for Amazon EFS is used. This ID can be in one of the following
518
551
  # formats:
519
552
  #
@@ -536,15 +569,17 @@ module Aws::EFS
536
569
  # EFS file systems.
537
570
  #
538
571
  # @option params [String] :throughput_mode
539
- # The throughput mode for the file system to be created. There are two
540
- # throughput modes to choose from for your file system: `bursting` and
541
- # `provisioned`. If you set `ThroughputMode` to `provisioned`, you must
542
- # also set a value for `ProvisionedThroughPutInMibps`. You can decrease
543
- # your file system's throughput in Provisioned Throughput mode or
544
- # change between the throughput modes as long as it’s been more than 24
545
- # hours since the last decrease or throughput mode change. For more, see
546
- # [Specifying Throughput with Provisioned Mode][1] in the *Amazon EFS
547
- # User Guide.*
572
+ # Specifies the throughput mode for the file system, either `bursting`
573
+ # or `provisioned`. If you set `ThroughputMode` to `provisioned`, you
574
+ # must also set a value for `ProvisionedThroughputInMibps`. After you
575
+ # create the file system, you can decrease your file system's
576
+ # throughput in Provisioned Throughput mode or change between the
577
+ # throughput modes, as long as it’s been more than 24 hours since the
578
+ # last decrease or throughput mode change. For more information, see
579
+ # [Specifying throughput with provisioned mode][1] in the *Amazon EFS
580
+ # User Guide*.
581
+ #
582
+ # Default is `bursting`.
548
583
  #
549
584
  #
550
585
  #
@@ -554,14 +589,50 @@ module Aws::EFS
554
589
  # The throughput, measured in MiB/s, that you want to provision for a
555
590
  # file system that you're creating. Valid values are 1-1024. Required
556
591
  # if `ThroughputMode` is set to `provisioned`. The upper limit for
557
- # throughput is 1024 MiB/s. You can get this limit increased by
558
- # contacting AWS Support. For more information, see [Amazon EFS Limits
559
- # That You Can Increase][1] in the *Amazon EFS User Guide.*
592
+ # throughput is 1024 MiB/s. To increase this limit, contact AWS Support.
593
+ # For more information, see [Amazon EFS quotas that you can increase][1]
594
+ # in the *Amazon EFS User Guide*.
560
595
  #
561
596
  #
562
597
  #
563
598
  # [1]: https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits
564
599
  #
600
+ # @option params [String] :availability_zone_name
601
+ # Used to create a file system that uses One Zone storage classes. It
602
+ # specifies the AWS Availability Zone in which to create the file
603
+ # system. Use the format `us-east-1a` to specify the Availability Zone.
604
+ # For more information about One Zone storage classes, see [Using EFS
605
+ # storage classes][1] in the *Amazon EFS User Guide*.
606
+ #
607
+ # <note markdown="1"> One Zone storage classes are not available in all Availability Zones
608
+ # in AWS Regions where Amazon EFS is available.
609
+ #
610
+ # </note>
611
+ #
612
+ #
613
+ #
614
+ # [1]: https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html
615
+ #
616
+ # @option params [Boolean] :backup
617
+ # Specifies whether automatic backups are enabled on the file system
618
+ # that you are creating. Set the value to `true` to enable automatic
619
+ # backups. If you are creating a file system that uses One Zone storage
620
+ # classes, automatic backups are enabled by default. For more
621
+ # information, see [Automatic backups][1] in the *Amazon EFS User
622
+ # Guide*.
623
+ #
624
+ # Default is `false`. However, if you specify an `AvailabilityZoneName`,
625
+ # the default is `true`.
626
+ #
627
+ # <note markdown="1"> AWS Backup is not available in all AWS Regions where Amazon EFS is
628
+ # available.
629
+ #
630
+ # </note>
631
+ #
632
+ #
633
+ #
634
+ # [1]: https://docs.aws.amazon.com/efs/latest/ug/awsbackup.html#automatic-backups
635
+ #
565
636
  # @option params [Array<Types::Tag>] :tags
566
637
  # A value that specifies to create one or more tags associated with the
567
638
  # file system. Each tag is a user-defined key-value pair. Name your file
@@ -584,15 +655,20 @@ module Aws::EFS
584
655
  # * {Types::FileSystemDescription#kms_key_id #kms_key_id} => String
585
656
  # * {Types::FileSystemDescription#throughput_mode #throughput_mode} => String
586
657
  # * {Types::FileSystemDescription#provisioned_throughput_in_mibps #provisioned_throughput_in_mibps} => Float
658
+ # * {Types::FileSystemDescription#availability_zone_name #availability_zone_name} => String
659
+ # * {Types::FileSystemDescription#availability_zone_id #availability_zone_id} => String
587
660
  # * {Types::FileSystemDescription#tags #tags} => Array&lt;Types::Tag&gt;
588
661
  #
589
662
  #
590
663
  # @example Example: To create a new file system
591
664
  #
592
- # # This operation creates a new file system with the default generalpurpose performance mode.
665
+ # # This operation creates a new, encrypted file system with automatic backups enabled, and the default generalpurpose
666
+ # # performance mode.
593
667
  #
594
668
  # resp = client.create_file_system({
669
+ # backup: true,
595
670
  # creation_token: "tokenstring",
671
+ # encrypted: true,
596
672
  # performance_mode: "generalPurpose",
597
673
  # tags: [
598
674
  # {
@@ -606,6 +682,7 @@ module Aws::EFS
606
682
  # {
607
683
  # creation_time: Time.parse("1481841524.0"),
608
684
  # creation_token: "tokenstring",
685
+ # encrypted: true,
609
686
  # file_system_id: "fs-01234567",
610
687
  # life_cycle_state: "creating",
611
688
  # number_of_mount_targets: 0,
@@ -631,6 +708,8 @@ module Aws::EFS
631
708
  # kms_key_id: "KmsKeyId",
632
709
  # throughput_mode: "bursting", # accepts bursting, provisioned
633
710
  # provisioned_throughput_in_mibps: 1.0,
711
+ # availability_zone_name: "AvailabilityZoneName",
712
+ # backup: false,
634
713
  # tags: [
635
714
  # {
636
715
  # key: "TagKey", # required
@@ -646,7 +725,7 @@ module Aws::EFS
646
725
  # resp.file_system_id #=> String
647
726
  # resp.file_system_arn #=> String
648
727
  # resp.creation_time #=> Time
649
- # resp.life_cycle_state #=> String, one of "creating", "available", "updating", "deleting", "deleted"
728
+ # resp.life_cycle_state #=> String, one of "creating", "available", "updating", "deleting", "deleted", "error"
650
729
  # resp.name #=> String
651
730
  # resp.number_of_mount_targets #=> Integer
652
731
  # resp.size_in_bytes.value #=> Integer
@@ -658,6 +737,8 @@ module Aws::EFS
658
737
  # resp.kms_key_id #=> String
659
738
  # resp.throughput_mode #=> String, one of "bursting", "provisioned"
660
739
  # resp.provisioned_throughput_in_mibps #=> Float
740
+ # resp.availability_zone_name #=> String
741
+ # resp.availability_zone_id #=> String
661
742
  # resp.tags #=> Array
662
743
  # resp.tags[0].key #=> String
663
744
  # resp.tags[0].value #=> String
@@ -679,22 +760,35 @@ module Aws::EFS
679
760
  # single mount target for a given file system. If you have multiple
680
761
  # subnets in an Availability Zone, you create a mount target in one of
681
762
  # the subnets. EC2 instances do not need to be in the same subnet as the
682
- # mount target in order to access their file system. For more
683
- # information, see [Amazon EFS: How it Works][1].
763
+ # mount target in order to access their file system.
684
764
  #
685
- # In the request, you also specify a file system ID for which you are
686
- # creating the mount target and the file system's lifecycle state must
687
- # be `available`. For more information, see DescribeFileSystems.
765
+ # You can create only one mount target for an EFS file system using One
766
+ # Zone storage classes. You must create that mount target in the same
767
+ # Availability Zone in which the file system is located. Use the
768
+ # `AvailabilityZoneName` and `AvailabiltyZoneId` properties in the
769
+ # DescribeFileSystems response object to get this information. Use the
770
+ # `subnetId` associated with the file system's Availability Zone when
771
+ # creating the mount target.
688
772
  #
689
- # In the request, you also provide a subnet ID, which determines the
690
- # following:
773
+ # For more information, see [Amazon EFS: How it Works][1].
774
+ #
775
+ # To create a mount target for a file system, the file system's
776
+ # lifecycle state must be `available`. For more information, see
777
+ # DescribeFileSystems.
778
+ #
779
+ # In the request, provide the following:
780
+ #
781
+ # * The file system ID for which you are creating the mount target.
691
782
  #
692
- # * VPC in which Amazon EFS creates the mount target
783
+ # * A subnet ID, which determines the following:
693
784
  #
694
- # * Availability Zone in which Amazon EFS creates the mount target
785
+ # * The VPC in which Amazon EFS creates the mount target
695
786
  #
696
- # * IP address range from which Amazon EFS selects the IP address of the
697
- # mount target (if you don't specify an IP address in the request)
787
+ # * The Availability Zone in which Amazon EFS creates the mount target
788
+ #
789
+ # * The IP address range from which Amazon EFS selects the IP address
790
+ # of the mount target (if you don't specify an IP address in the
791
+ # request)
698
792
  #
699
793
  # After creating the mount target, Amazon EFS returns a response that
700
794
  # includes, a `MountTargetId` and an `IpAddress`. You use this IP
@@ -790,7 +884,9 @@ module Aws::EFS
790
884
  # The ID of the file system for which to create the mount target.
791
885
  #
792
886
  # @option params [required, String] :subnet_id
793
- # The ID of the subnet to add the mount target in.
887
+ # The ID of the subnet to add the mount target in. For file systems that
888
+ # use One Zone storage classes, use the subnet that is associated with
889
+ # the file system's Availability Zone.
794
890
  #
795
891
  # @option params [String] :ip_address
796
892
  # Valid IPv4 address within the address range of the specified subnet.
@@ -848,7 +944,7 @@ module Aws::EFS
848
944
  # resp.mount_target_id #=> String
849
945
  # resp.file_system_id #=> String
850
946
  # resp.subnet_id #=> String
851
- # resp.life_cycle_state #=> String, one of "creating", "available", "updating", "deleting", "deleted"
947
+ # resp.life_cycle_state #=> String, one of "creating", "available", "updating", "deleting", "deleted", "error"
852
948
  # resp.ip_address #=> String
853
949
  # resp.network_interface_id #=> String
854
950
  # resp.availability_zone_id #=> String
@@ -1204,7 +1300,7 @@ module Aws::EFS
1204
1300
  # resp.access_points[0].root_directory.creation_info.owner_gid #=> Integer
1205
1301
  # resp.access_points[0].root_directory.creation_info.permissions #=> String
1206
1302
  # resp.access_points[0].owner_id #=> String
1207
- # resp.access_points[0].life_cycle_state #=> String, one of "creating", "available", "updating", "deleting", "deleted"
1303
+ # resp.access_points[0].life_cycle_state #=> String, one of "creating", "available", "updating", "deleting", "deleted", "error"
1208
1304
  # resp.next_token #=> String
1209
1305
  #
1210
1306
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DescribeAccessPoints AWS API Documentation
@@ -1384,7 +1480,7 @@ module Aws::EFS
1384
1480
  # resp.file_systems[0].file_system_id #=> String
1385
1481
  # resp.file_systems[0].file_system_arn #=> String
1386
1482
  # resp.file_systems[0].creation_time #=> Time
1387
- # resp.file_systems[0].life_cycle_state #=> String, one of "creating", "available", "updating", "deleting", "deleted"
1483
+ # resp.file_systems[0].life_cycle_state #=> String, one of "creating", "available", "updating", "deleting", "deleted", "error"
1388
1484
  # resp.file_systems[0].name #=> String
1389
1485
  # resp.file_systems[0].number_of_mount_targets #=> Integer
1390
1486
  # resp.file_systems[0].size_in_bytes.value #=> Integer
@@ -1396,6 +1492,8 @@ module Aws::EFS
1396
1492
  # resp.file_systems[0].kms_key_id #=> String
1397
1493
  # resp.file_systems[0].throughput_mode #=> String, one of "bursting", "provisioned"
1398
1494
  # resp.file_systems[0].provisioned_throughput_in_mibps #=> Float
1495
+ # resp.file_systems[0].availability_zone_name #=> String
1496
+ # resp.file_systems[0].availability_zone_id #=> String
1399
1497
  # resp.file_systems[0].tags #=> Array
1400
1498
  # resp.file_systems[0].tags[0].key #=> String
1401
1499
  # resp.file_systems[0].tags[0].value #=> String
@@ -1609,7 +1707,7 @@ module Aws::EFS
1609
1707
  # resp.mount_targets[0].mount_target_id #=> String
1610
1708
  # resp.mount_targets[0].file_system_id #=> String
1611
1709
  # resp.mount_targets[0].subnet_id #=> String
1612
- # resp.mount_targets[0].life_cycle_state #=> String, one of "creating", "available", "updating", "deleting", "deleted"
1710
+ # resp.mount_targets[0].life_cycle_state #=> String, one of "creating", "available", "updating", "deleting", "deleted", "error"
1613
1711
  # resp.mount_targets[0].ip_address #=> String
1614
1712
  # resp.mount_targets[0].network_interface_id #=> String
1615
1713
  # resp.mount_targets[0].availability_zone_id #=> String
@@ -1843,9 +1941,12 @@ module Aws::EFS
1843
1941
  # A file system policy is an IAM resource-based policy and can contain
1844
1942
  # multiple policy statements. A file system always has exactly one file
1845
1943
  # system policy, which can be the default policy or an explicit policy
1846
- # set or updated using this API operation. When an explicit policy is
1847
- # set, it overrides the default policy. For more information about the
1848
- # default file system policy, see [Default EFS File System Policy][1].
1944
+ # set or updated using this API operation. EFS file system policies have
1945
+ # a 20,000 character limit. When an explicit policy is set, it overrides
1946
+ # the default policy. For more information about the default file system
1947
+ # policy, see [Default EFS File System Policy][1].
1948
+ #
1949
+ # EFS file system policies have a 20,000 character limit.
1849
1950
  #
1850
1951
  # This operation requires permissions for the
1851
1952
  # `elasticfilesystem:PutFileSystemPolicy` action.
@@ -1860,8 +1961,9 @@ module Aws::EFS
1860
1961
  #
1861
1962
  # @option params [required, String] :policy
1862
1963
  # The `FileSystemPolicy` that you're creating. Accepts a JSON formatted
1863
- # policy definition. To find out more about the elements that make up a
1864
- # file system policy, see [EFS Resource-based Policies][1].
1964
+ # policy definition. EFS file system policies have a 20,000 character
1965
+ # limit. To find out more about the elements that make up a file system
1966
+ # policy, see [EFS Resource-based Policies][1].
1865
1967
  #
1866
1968
  #
1867
1969
  #
@@ -2044,7 +2146,7 @@ module Aws::EFS
2044
2146
  # Specifies the EFS resource that you want to remove tags from.
2045
2147
  #
2046
2148
  # @option params [required, Array<String>] :tag_keys
2047
- # The keys of the key:value tag pairs that you want to remove from the
2149
+ # The keys of the key-value tag pairs that you want to remove from the
2048
2150
  # specified EFS resource.
2049
2151
  #
2050
2152
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
@@ -2072,18 +2174,18 @@ module Aws::EFS
2072
2174
  # The ID of the file system that you want to update.
2073
2175
  #
2074
2176
  # @option params [String] :throughput_mode
2075
- # (Optional) The throughput mode that you want your file system to use.
2076
- # If you're not updating your throughput mode, you don't need to
2077
- # provide this value in your request. If you are changing the
2078
- # `ThroughputMode` to `provisioned`, you must also set a value for
2177
+ # (Optional) Updates the file system's throughput mode. If you're not
2178
+ # updating your throughput mode, you don't need to provide this value
2179
+ # in your request. If you are changing the `ThroughputMode` to
2180
+ # `provisioned`, you must also set a value for
2079
2181
  # `ProvisionedThroughputInMibps`.
2080
2182
  #
2081
2183
  # @option params [Float] :provisioned_throughput_in_mibps
2082
- # (Optional) The amount of throughput, in MiB/s, that you want to
2083
- # provision for your file system. Valid values are 1-1024. Required if
2084
- # `ThroughputMode` is changed to `provisioned` on update. If you're not
2085
- # updating the amount of provisioned throughput for your file system,
2086
- # you don't need to provide this value in your request.
2184
+ # (Optional) Sets the amount of provisioned throughput, in MiB/s, for
2185
+ # the file system. Valid values are 1-1024. If you are changing the
2186
+ # throughput mode to provisioned, you must also provide the amount of
2187
+ # provisioned throughput. Required if `ThroughputMode` is changed to
2188
+ # `provisioned` on update.
2087
2189
  #
2088
2190
  # @return [Types::FileSystemDescription] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2089
2191
  #
@@ -2101,6 +2203,8 @@ module Aws::EFS
2101
2203
  # * {Types::FileSystemDescription#kms_key_id #kms_key_id} => String
2102
2204
  # * {Types::FileSystemDescription#throughput_mode #throughput_mode} => String
2103
2205
  # * {Types::FileSystemDescription#provisioned_throughput_in_mibps #provisioned_throughput_in_mibps} => Float
2206
+ # * {Types::FileSystemDescription#availability_zone_name #availability_zone_name} => String
2207
+ # * {Types::FileSystemDescription#availability_zone_id #availability_zone_id} => String
2104
2208
  # * {Types::FileSystemDescription#tags #tags} => Array&lt;Types::Tag&gt;
2105
2209
  #
2106
2210
  # @example Request syntax with placeholder values
@@ -2118,7 +2222,7 @@ module Aws::EFS
2118
2222
  # resp.file_system_id #=> String
2119
2223
  # resp.file_system_arn #=> String
2120
2224
  # resp.creation_time #=> Time
2121
- # resp.life_cycle_state #=> String, one of "creating", "available", "updating", "deleting", "deleted"
2225
+ # resp.life_cycle_state #=> String, one of "creating", "available", "updating", "deleting", "deleted", "error"
2122
2226
  # resp.name #=> String
2123
2227
  # resp.number_of_mount_targets #=> Integer
2124
2228
  # resp.size_in_bytes.value #=> Integer
@@ -2130,6 +2234,8 @@ module Aws::EFS
2130
2234
  # resp.kms_key_id #=> String
2131
2235
  # resp.throughput_mode #=> String, one of "bursting", "provisioned"
2132
2236
  # resp.provisioned_throughput_in_mibps #=> Float
2237
+ # resp.availability_zone_name #=> String
2238
+ # resp.availability_zone_id #=> String
2133
2239
  # resp.tags #=> Array
2134
2240
  # resp.tags[0].key #=> String
2135
2241
  # resp.tags[0].value #=> String
@@ -2156,7 +2262,7 @@ module Aws::EFS
2156
2262
  params: params,
2157
2263
  config: config)
2158
2264
  context[:gem_name] = 'aws-sdk-efs'
2159
- context[:gem_version] = '1.33.0'
2265
+ context[:gem_version] = '1.38.0'
2160
2266
  Seahorse::Client::Request.new(handlers, context)
2161
2267
  end
2162
2268