feat(client-efs): Added support for Internet Protocol Version 6 (IPv6) on EFS Service APIs and mount targets.

Author: awstools

clients/client-efs/README.md

@@ -9,9 +9,12 @@ AWS SDK for JavaScript EFS Client for Node.js, Browser and React Native.
 <fullname>Amazon Elastic File System</fullname>
 
 <p>Amazon Elastic File System (Amazon EFS) provides simple, scalable file storage for
-use with Amazon EC2 Linux and Mac instances in the Amazon Web Services Cloud. With Amazon EFS, storage capacity is elastic, growing and shrinking automatically as you add and
-remove files, so that your applications have the storage they need, when they need it. For
-more information, see the <a href="https://docs.aws.amazon.com/efs/latest/ug/api-reference.html">Amazon Elastic File System API Reference</a> and the <a href="https://docs.aws.amazon.com/efs/latest/ug/whatisefs.html">Amazon Elastic File System User Guide</a>.</p>
+use with Amazon EC2 Linux and Mac instances in the Amazon Web Services Cloud. With
+Amazon EFS, storage capacity is elastic, growing and shrinking automatically as you
+add and remove files, so that your applications have the storage they need, when they need it.
+For more information, see the <a href="https://docs.aws.amazon.com/efs/latest/ug/api-reference.html">Amazon Elastic File System API Reference</a> and
+the <a href="https://docs.aws.amazon.com/efs/latest/ug/whatisefs.html">Amazon Elastic File System
+User Guide</a>.</p>
 
 ## Installing
 

clients/client-efs/src/EFS.ts

@@ -685,9 +685,12 @@ export interface EFS {
 /**
  * <fullname>Amazon Elastic File System</fullname>
  *          <p>Amazon Elastic File System (Amazon EFS) provides simple, scalable file storage for
- *       use with Amazon EC2 Linux and Mac instances in the Amazon Web Services Cloud. With Amazon EFS, storage capacity is elastic, growing and shrinking automatically as you add and
- *       remove files, so that your applications have the storage they need, when they need it. For
- *       more information, see the <a href="https://docs.aws.amazon.com/efs/latest/ug/api-reference.html">Amazon Elastic File System API Reference</a> and the <a href="https://docs.aws.amazon.com/efs/latest/ug/whatisefs.html">Amazon Elastic File System User Guide</a>.</p>
+ *       use with Amazon EC2 Linux and Mac instances in the Amazon Web Services Cloud. With
+ *         Amazon EFS, storage capacity is elastic, growing and shrinking automatically as you
+ *       add and remove files, so that your applications have the storage they need, when they need it.
+ *       For more information, see the <a href="https://docs.aws.amazon.com/efs/latest/ug/api-reference.html">Amazon Elastic File System API Reference</a> and
+ *       the <a href="https://docs.aws.amazon.com/efs/latest/ug/whatisefs.html">Amazon Elastic File System
+ *         User Guide</a>.</p>
  * @public
  */
 export class EFS extends EFSClient implements EFS {}

clients/client-efs/src/EFSClient.ts

@@ -414,9 +414,12 @@ export interface EFSClientResolvedConfig extends EFSClientResolvedConfigType {}
 /**
  * <fullname>Amazon Elastic File System</fullname>
  *          <p>Amazon Elastic File System (Amazon EFS) provides simple, scalable file storage for
- *       use with Amazon EC2 Linux and Mac instances in the Amazon Web Services Cloud. With Amazon EFS, storage capacity is elastic, growing and shrinking automatically as you add and
- *       remove files, so that your applications have the storage they need, when they need it. For
- *       more information, see the <a href="https://docs.aws.amazon.com/efs/latest/ug/api-reference.html">Amazon Elastic File System API Reference</a> and the <a href="https://docs.aws.amazon.com/efs/latest/ug/whatisefs.html">Amazon Elastic File System User Guide</a>.</p>
+ *       use with Amazon EC2 Linux and Mac instances in the Amazon Web Services Cloud. With
+ *         Amazon EFS, storage capacity is elastic, growing and shrinking automatically as you
+ *       add and remove files, so that your applications have the storage they need, when they need it.
+ *       For more information, see the <a href="https://docs.aws.amazon.com/efs/latest/ug/api-reference.html">Amazon Elastic File System API Reference</a> and
+ *       the <a href="https://docs.aws.amazon.com/efs/latest/ug/whatisefs.html">Amazon Elastic File System
+ *         User Guide</a>.</p>
  * @public
  */
 export class EFSClient extends __Client<

clients/client-efs/src/commands/CreateAccessPointCommand.ts

@@ -33,13 +33,14 @@ export interface CreateAccessPointCommandOutput extends AccessPointDescription,
  *       system path, to any file system request made through the access point. The operating system
  *       user and group override any identity information provided by the NFS client. The file system
  *       path is exposed as the access point's root directory. Applications using the access point can
- *       only access data in the application's own directory and any subdirectories. To learn more, see
+ *       only access data in the application's own directory and any subdirectories. A file system can
+ *       have a maximum of 10,000 access points unless you request an increase. To learn more, see
  *         <a href="https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html">Mounting a file
  *         system using EFS access points</a>.</p>
  *          <note>
  *             <p>If multiple requests to create access points on the same file system are sent in quick
- *         succession, and the file system is near the limit of 1,000 access points, you may experience
- *         a throttling response for these requests. This is to ensure that the file system does not
+ *         succession, and the file system is near the limit of access points, you may experience a
+ *         throttling response for these requests. This is to ensure that the file system does not
  *         exceed the stated access point limit.</p>
  *          </note>
  *          <p>This operation requires permissions for the <code>elasticfilesystem:CreateAccessPoint</code> action.</p>

clients/client-efs/src/commands/CreateFileSystemCommand.ts

@@ -76,8 +76,9 @@ export interface CreateFileSystemCommandOutput extends FileSystemDescription, __
  *       parameter.</p>
  *          <p>After the file system is fully created, Amazon EFS sets its lifecycle state to
  *         <code>available</code>, at which point you can create one or more mount targets for the file
- *       system in your VPC. For more information, see <a>CreateMountTarget</a>. You mount your Amazon EFS file system on an EC2 instances in
- *       your VPC by using the mount target. For more information, see <a href="https://docs.aws.amazon.com/efs/latest/ug/how-it-works.html">Amazon EFS: How it Works</a>. </p>
+ *       system in your VPC. For more information, see <a>CreateMountTarget</a>. You mount
+ *       your Amazon EFS file system on an EC2 instances in your VPC by using the mount
+ *       target. For more information, see <a href="https://docs.aws.amazon.com/efs/latest/ug/how-it-works.html">Amazon EFS: How it Works</a>. </p>
  *          <p>This operation requires permissions for the
  *         <code>elasticfilesystem:CreateFileSystem</code> action. </p>
  *          <p>File systems can be tagged on creation. If tags are specified in the creation action, IAM

clients/client-efs/src/commands/CreateMountTargetCommand.ts

@@ -30,17 +30,16 @@ export interface CreateMountTargetCommandOutput extends MountTargetDescription,
 /**
  * <p>Creates a mount target for a file system. You can then mount the file system on EC2
  *       instances by using the mount target.</p>
- *          <p>You can create one mount target in each Availability Zone in your VPC. All EC2
- *       instances in a VPC within a given Availability Zone share a single mount target for a given
- *       file system. If you have multiple subnets in an Availability Zone, you create a mount target
- *       in one of the subnets. EC2 instances do not need to be in the same subnet as the mount target
- *       in order to access their file system.</p>
- *          <p>You can create only one mount target for a One Zone file system.
- *       You must create that mount target in the same Availability Zone in which the file system is
- *       located. Use the <code>AvailabilityZoneName</code> and <code>AvailabiltyZoneId</code>
- *       properties in the <a>DescribeFileSystems</a> response object to get this
- *       information. Use the <code>subnetId</code> associated with the file system's Availability Zone
- *       when creating the mount target.</p>
+ *          <p>You can create one mount target in each Availability Zone in your VPC. All EC2 instances
+ *       in a VPC within a given Availability Zone share a single mount target for a given file system. If
+ *       you have multiple subnets in an Availability Zone, you create a mount target in one of the subnets.
+ *       EC2 instances do not need to be in the same subnet as the mount target in order to
+ *       access their file system.</p>
+ *          <p>You can create only one mount target for a One Zone file system. You must
+ *       create that mount target in the same Availability Zone in which the file system is located. Use the
+ *         <code>AvailabilityZoneName</code> and <code>AvailabiltyZoneId</code> properties in the <a>DescribeFileSystems</a> response object to get this information. Use the
+ *         <code>subnetId</code> associated with the file system's Availability Zone when creating the mount
+ *       target.</p>
  *          <p>For more information, see <a href="https://docs.aws.amazon.com/efs/latest/ug/how-it-works.html">Amazon EFS: How it Works</a>. </p>
  *          <p>To create a mount target for a file system, the file system's lifecycle state must be
  *         <code>available</code>. For more information, see <a>DescribeFileSystems</a>.</p>
@@ -68,22 +67,22 @@ export interface CreateMountTargetCommandOutput extends MountTargetDescription,
  *          </ul>
  *          <p>After creating the mount target, Amazon EFS returns a response that includes, a
  *         <code>MountTargetId</code> and an <code>IpAddress</code>. You use this IP address when
- *       mounting the file system in an EC2 instance. You can also use the mount target's DNS name
- *       when mounting the file system. The EC2 instance on which you mount the file system by using
- *       the mount target can resolve the mount target's DNS name to its IP address. For more
- *       information, see <a href="https://docs.aws.amazon.com/efs/latest/ug/how-it-works.html#how-it-works-implementation">How it Works:
+ *       mounting the file system in an EC2 instance. You can also use the mount target's
+ *       DNS name when mounting the file system. The EC2 instance on which you mount the file
+ *       system by using the mount target can resolve the mount target's DNS name to its IP
+ *       address. For more information, see <a href="https://docs.aws.amazon.com/efs/latest/ug/how-it-works.html#how-it-works-implementation">How it Works:
  *         Implementation Overview</a>. </p>
- *          <p>Note that you can create mount targets for a file system in only one VPC, and there can
- *       be only one mount target per Availability Zone. That is, if the file system already has one or
- *       more mount targets created for it, the subnet specified in the request to add another mount
- *       target must meet the following requirements:</p>
+ *          <p>Note that you can create mount targets for a file system in only one VPC, and there can be
+ *       only one mount target per Availability Zone. That is, if the file system already has one or more
+ *       mount targets created for it, the subnet specified in the request to add another mount target
+ *       must meet the following requirements:</p>
  *          <ul>
  *             <li>
  *                <p>Must belong to the same VPC as the subnets of the existing mount targets</p>
  *             </li>
  *             <li>
- *                <p>Must not be in the same Availability Zone as any of the subnets of the existing
- *           mount targets</p>
+ *                <p>Must not be in the same Availability Zone as any of the subnets of the existing mount
+ *           targets</p>
  *             </li>
  *          </ul>
  *          <p>If the request satisfies the requirements, Amazon EFS does the following:</p>
@@ -95,10 +94,11 @@ export interface CreateMountTargetCommandOutput extends MountTargetDescription,
  *                <p>Also creates a new network interface in the subnet as follows:</p>
  *                <ul>
  *                   <li>
- *                      <p>If the request provides an <code>IpAddress</code>, Amazon EFS assigns that IP
- *               address to the network interface. Otherwise, Amazon EFS assigns a free address in the
- *               subnet (in the same way that the Amazon EC2 <code>CreateNetworkInterface</code> call
- *               does when a request does not specify a primary private IP address).</p>
+ *                      <p>If the request provides an <code>IpAddress</code>, Amazon EFS assigns that
+ *               IP address to the network interface. Otherwise, Amazon EFS assigns a free
+ *               address in the subnet (in the same way that the Amazon EC2
+ *                 <code>CreateNetworkInterface</code> call does when a request does not specify a
+ *               primary private IP address).</p>
  *                   </li>
  *                   <li>
  *                      <p>If the request provides <code>SecurityGroups</code>, this network interface is
@@ -120,10 +120,10 @@ export interface CreateMountTargetCommandOutput extends MountTargetDescription,
  *               <code>EFS</code>.</p>
  *                   </li>
  *                </ul>
- *                <p>Each Amazon EFS mount target has one corresponding requester-managed EC2 network
- *           interface. After the network interface is created, Amazon EFS sets the
- *             <code>NetworkInterfaceId</code> field in the mount target's description to the
- *           network interface ID, and the <code>IpAddress</code> field to its address. If network
+ *                <p>Each Amazon EFS mount target has one corresponding requester-managed
+ *           EC2 network interface. After the network interface is created, Amazon EFS
+ *           sets the <code>NetworkInterfaceId</code> field in the mount target's description to
+ *           the network interface ID, and the <code>IpAddress</code> field to its address. If network
  *           interface creation fails, the entire <code>CreateMountTarget</code> operation
  *           fails.</p>
  *             </li>
@@ -134,12 +134,12 @@ export interface CreateMountTargetCommandOutput extends MountTargetDescription,
  *         the mount target creation status by calling the <a>DescribeMountTargets</a> operation, which among other things returns the mount
  *         target state.</p>
  *          </note>
- *          <p>We recommend that you create a mount target in each of the Availability Zones. There
- *       are cost considerations for using a file system in an Availability Zone through a mount target
- *       created in another Availability Zone. For more information, see <a href="http://aws.amazon.com/efs/">Amazon EFS</a>. In addition, by always using a mount target local to the
- *       instance's Availability Zone, you eliminate a partial failure scenario. If the
- *       Availability Zone in which your mount target is created goes down, then you can't access
- *       your file system through that mount target. </p>
+ *          <p>We recommend that you create a mount target in each of the Availability Zones. There are cost
+ *       considerations for using a file system in an Availability Zone through a mount target created in
+ *       another Availability Zone. For more information, see <a href="http://aws.amazon.com/efs/pricing/">Amazon EFS pricing</a>. In addition, by always using a mount target local to the
+ *       instance's Availability Zone, you eliminate a partial failure scenario. If the Availability Zone in
+ *       which your mount target is created goes down, then you can't access your file system
+ *       through that mount target. </p>
  *          <p>This operation requires permissions for the following action on the file
  *       system:</p>
  *          <ul>
@@ -178,6 +178,8 @@ export interface CreateMountTargetCommandOutput extends MountTargetDescription,
  *   FileSystemId: "STRING_VALUE", // required
  *   SubnetId: "STRING_VALUE", // required
  *   IpAddress: "STRING_VALUE",
+ *   Ipv6Address: "STRING_VALUE",
+ *   IpAddressType: "IPV4_ONLY" || "IPV6_ONLY" || "DUAL_STACK",
  *   SecurityGroups: [ // SecurityGroups
  *     "STRING_VALUE",
  *   ],
@@ -191,6 +193,7 @@ export interface CreateMountTargetCommandOutput extends MountTargetDescription,
  * //   SubnetId: "STRING_VALUE", // required
  * //   LifeCycleState: "creating" || "available" || "updating" || "deleting" || "deleted" || "error", // required
  * //   IpAddress: "STRING_VALUE",
+ * //   Ipv6Address: "STRING_VALUE",
  * //   NetworkInterfaceId: "STRING_VALUE",
  * //   AvailabilityZoneId: "STRING_VALUE",
  * //   AvailabilityZoneName: "STRING_VALUE",
@@ -235,7 +238,7 @@ export interface CreateMountTargetCommandOutput extends MountTargetDescription,
  * @throws {@link NetworkInterfaceLimitExceeded} (client fault)
  *  <p>The calling account has reached the limit for elastic network interfaces for the
  *             specific Amazon Web Services Region. Either delete some network interfaces or request
- *             that the account quota be raised. For more information, see <a href="https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_Appendix_Limits.html">Amazon VPC Quotas</a>
+ *             that the account quota be raised. For more information, see <a href="https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html">Amazon VPC Quotas</a>
  *             in the <i>Amazon VPC User Guide</i> (see the <b>Network
  *                 interfaces per Region</b> entry in the <b>Network
  *                 interfaces</b> table). </p>
@@ -245,8 +248,12 @@ export interface CreateMountTargetCommandOutput extends MountTargetDescription,
  *             no free IP addresses in the subnet.</p>
  *
  * @throws {@link SecurityGroupLimitExceeded} (client fault)
- *  <p>Returned if the size of <code>SecurityGroups</code> specified in the request is
- *             greater than five.</p>
+ *  <p>Returned if the number of <code>SecurityGroups</code> specified in the request is
+ *             greater than the limit, which is based on account quota.  Either delete some security groups
+ *             or request that the account quota be raised. For more information, see <a href="https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html">Amazon VPC Quotas</a>
+ *             in the <i>Amazon VPC User Guide</i> (see the <b>Security Groups</b>
+ *             table).
+ *         </p>
  *
  * @throws {@link SecurityGroupNotFound} (client fault)
  *  <p>Returned if one of the specified security groups doesn't exist in the subnet's

clients/client-efs/src/commands/DeleteMountTargetCommand.ts

@@ -34,8 +34,8 @@ export interface DeleteMountTargetCommandOutput extends __MetadataBearer {}
  *       avoid applications getting cut off abruptly, you might consider unmounting any mounts of the
  *       mount target, if feasible. The operation also deletes the associated network interface.
  *       Uncommitted writes might be lost, but breaking a mount target using this operation does not
- *       corrupt the file system itself. The file system you created remains. You can mount an EC2
- *       instance in your VPC by using another mount target.</p>
+ *       corrupt the file system itself. The file system you created remains. You can mount an
+ *       EC2 instance in your VPC by using another mount target.</p>
  *          <p>This operation requires permissions for the following action on the file
  *       system:</p>
  *          <ul>

clients/client-efs/src/commands/DescribeBackupPolicyCommand.ts

@@ -66,7 +66,7 @@ export interface DescribeBackupPolicyCommandOutput extends BackupPolicyDescripti
  *  <p>Returned if an error occurred on the server side.</p>
  *
  * @throws {@link PolicyNotFound} (client fault)
- *  <p>Returned if the default file system policy is in effect for the EFS file system specified.</p>
+ *  <p>Returned if <code>no backup</code> is specified for a One Zone EFS file system.</p>
  *
  * @throws {@link ValidationException} (client fault)
  *  <p>Returned if the Backup service is not available in the Amazon Web Services Region in which the request was made.</p>