feat(client-datasync): With this launch, we are giving customers the …

…ability to use older SMB protocol versions, enabling them to use DataSync to copy data to and from their legacy storage arrays.

clients/client-datasync/src/DataSync.ts

@@ -538,11 +538,8 @@ export class DataSync extends DataSyncClient {
   }
 
   /**
-   * <p>Creates an endpoint for an Amazon S3 bucket that DataSync can access for a transfer.</p>
-   *          <p>For
-   *       more information, see
-   *       <a href="https://docs.aws.amazon.com/datasync/latest/userguide/create-locations-cli.html#create-location-s3-cli">Create an Amazon S3 location</a>
-   *       in the <i>DataSync User Guide</i>.</p>
+   * <p>Creates an endpoint for an Amazon S3 bucket that DataSync can
+   *       access for a transfer. For more information, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/create-locations-cli.html#create-location-s3-cli">Create an Amazon S3 location</a>.</p>
    */
   public createLocationS3(
     args: CreateLocationS3CommandInput,
@@ -574,8 +571,7 @@ export class DataSync extends DataSyncClient {
   }
 
   /**
-   * <p>Defines a file system on a Server Message Block (SMB) server that can be read from or
-   *       written to.</p>
+   * <p>Creates an endpoint for a Server Message Block (SMB) file server that DataSync can access for a transfer. For more information, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html">Creating an SMB location</a>.</p>
    */
   public createLocationSmb(
     args: CreateLocationSmbCommandInput,
@@ -724,9 +720,7 @@ export class DataSync extends DataSyncClient {
   }
 
   /**
-   * <p>Returns metadata such as the name, the network interfaces, and the status (that is,
-   *       whether the agent is running or not) for an agent. To specify which agent to describe, use the
-   *       Amazon Resource Name (ARN) of the agent in your request. </p>
+   * <p>Returns metadata about an DataSync agent, such as its name, endpoint type, and status.</p>
    */
   public describeAgent(
     args: DescribeAgentCommandInput,
@@ -1149,14 +1143,17 @@ export class DataSync extends DataSyncClient {
   }
 
   /**
-   * <p>Returns a list of agents owned by an Amazon Web Services account in the Amazon Web Services Region specified in the
-   *       request. The returned list is ordered by agent Amazon Resource Name (ARN).</p>
-   *          <p>By default, this operation returns a maximum of 100 agents. This operation supports
-   *       pagination that enables you to optionally reduce the number of agents returned in a
-   *       response.</p>
-   *          <p>If you have more agents than are returned in a response (that is, the response returns
-   *       only a truncated list of your agents), the response contains a marker that you can specify in
-   *       your next request to fetch the next page of agents.</p>
+   * <p>Returns a list of DataSync agents that belong to an Amazon Web Services account in the Amazon Web Services Region specified in the request.</p>
+   *          <p>With pagination, you can reduce the number of agents returned in a response. If you get
+   *       a truncated list of agents in a response, the response contains a marker that you can specify
+   *       in your next request to fetch the next page of agents.</p>
+   *          <p>
+   *             <code>ListAgents</code> is eventually consistent. This means the result of running the
+   *       operation might not reflect that you just created or deleted an agent. For example, if you
+   *       create an agent with <a href="https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateAgent.html">CreateAgent</a> and then
+   *       immediately run <code>ListAgents</code>, that agent might not show up in the list right away.
+   *       In situations like this, you can always confirm whether an agent has been created (or deleted)
+   *       by using <a href="https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeAgent.html">DescribeAgent</a>.</p>
    */
   public listAgents(args: ListAgentsCommandInput, options?: __HttpHandlerOptions): Promise<ListAgentsCommandOutput>;
   public listAgents(args: ListAgentsCommandInput, cb: (err: any, data?: ListAgentsCommandOutput) => void): void;

clients/client-datasync/src/commands/CreateLocationS3Command.ts

@@ -29,11 +29,8 @@ export interface CreateLocationS3CommandInput extends CreateLocationS3Request {}
 export interface CreateLocationS3CommandOutput extends CreateLocationS3Response, __MetadataBearer {}
 
 /**
- * <p>Creates an endpoint for an Amazon S3 bucket that DataSync can access for a transfer.</p>
- *          <p>For
- *       more information, see
- *       <a href="https://docs.aws.amazon.com/datasync/latest/userguide/create-locations-cli.html#create-location-s3-cli">Create an Amazon S3 location</a>
- *       in the <i>DataSync User Guide</i>.</p>
+ * <p>Creates an endpoint for an Amazon S3 bucket that DataSync can
+ *       access for a transfer. For more information, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/create-locations-cli.html#create-location-s3-cli">Create an Amazon S3 location</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

clients/client-datasync/src/commands/CreateLocationSmbCommand.ts

@@ -29,8 +29,7 @@ export interface CreateLocationSmbCommandInput extends CreateLocationSmbRequest
 export interface CreateLocationSmbCommandOutput extends CreateLocationSmbResponse, __MetadataBearer {}
 
 /**
- * <p>Defines a file system on a Server Message Block (SMB) server that can be read from or
- *       written to.</p>
+ * <p>Creates an endpoint for a Server Message Block (SMB) file server that DataSync can access for a transfer. For more information, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html">Creating an SMB location</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

clients/client-datasync/src/commands/DescribeAgentCommand.ts

@@ -29,9 +29,7 @@ export interface DescribeAgentCommandInput extends DescribeAgentRequest {}
 export interface DescribeAgentCommandOutput extends DescribeAgentResponse, __MetadataBearer {}
 
 /**
- * <p>Returns metadata such as the name, the network interfaces, and the status (that is,
- *       whether the agent is running or not) for an agent. To specify which agent to describe, use the
- *       Amazon Resource Name (ARN) of the agent in your request. </p>
+ * <p>Returns metadata about an DataSync agent, such as its name, endpoint type, and status.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

clients/client-datasync/src/commands/ListAgentsCommand.ts

@@ -29,14 +29,17 @@ export interface ListAgentsCommandInput extends ListAgentsRequest {}
 export interface ListAgentsCommandOutput extends ListAgentsResponse, __MetadataBearer {}
 
 /**
- * <p>Returns a list of agents owned by an Amazon Web Services account in the Amazon Web Services Region specified in the
- *       request. The returned list is ordered by agent Amazon Resource Name (ARN).</p>
- *          <p>By default, this operation returns a maximum of 100 agents. This operation supports
- *       pagination that enables you to optionally reduce the number of agents returned in a
- *       response.</p>
- *          <p>If you have more agents than are returned in a response (that is, the response returns
- *       only a truncated list of your agents), the response contains a marker that you can specify in
- *       your next request to fetch the next page of agents.</p>
+ * <p>Returns a list of DataSync agents that belong to an Amazon Web Services account in the Amazon Web Services Region specified in the request.</p>
+ *          <p>With pagination, you can reduce the number of agents returned in a response. If you get
+ *       a truncated list of agents in a response, the response contains a marker that you can specify
+ *       in your next request to fetch the next page of agents.</p>
+ *          <p>
+ *             <code>ListAgents</code> is eventually consistent. This means the result of running the
+ *       operation might not reflect that you just created or deleted an agent. For example, if you
+ *       create an agent with <a href="https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateAgent.html">CreateAgent</a> and then
+ *       immediately run <code>ListAgents</code>, that agent might not show up in the list right away.
+ *       In situations like this, you can always confirm whether an agent has been created (or deleted)
+ *       by using <a href="https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeAgent.html">DescribeAgent</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

clients/client-datasync/src/endpoint/EndpointParameters.ts

@@ -24,7 +24,7 @@ export const resolveClientEndpointParameters = <T>(
 };
 
 export interface EndpointParameters extends __EndpointParameters {
-  Region: string;
+  Region?: string;
   UseDualStack?: boolean;
   UseFIPS?: boolean;
   Endpoint?: string;

clients/client-datasync/src/endpoint/ruleset.ts

@@ -6,24 +6,25 @@ import { RuleSetObject } from "@aws-sdk/util-endpoints";
    or see "smithy.rules#endpointRuleSet"
    in codegen/sdk-codegen/aws-models/datasync.json */
 
-const q="fn",
-r="argv",
-s="ref";
-const a=true,
-b=false,
-c="String",
-d="PartitionResult",
-e="tree",
-f="error",
-g="endpoint",
-h={"required":true,"default":false,"type":"Boolean"},
-i={[s]:"Endpoint"},
-j={[q]:"booleanEquals",[r]:[{[s]:"UseFIPS"},true]},
-k={[q]:"booleanEquals",[r]:[{[s]:"UseDualStack"},true]},
-l={},
-m={[q]:"booleanEquals",[r]:[true,{[q]:"getAttr",[r]:[{[s]:d},"supportsFIPS"]}]},
-n={[q]:"booleanEquals",[r]:[true,{[q]:"getAttr",[r]:[{[s]:d},"supportsDualStack"]}]},
+const q="required",
+r="fn",
+s="argv",
+t="ref";
+const a="isSet",
+b="tree",
+c="error",
+d="endpoint",
+e="PartitionResult",
+f={[q]:false,"type":"String"},
+g={[q]:true,"default":false,"type":"Boolean"},
+h={[t]:"Endpoint"},
+i={[r]:"booleanEquals",[s]:[{[t]:"UseFIPS"},true]},
+j={[r]:"booleanEquals",[s]:[{[t]:"UseDualStack"},true]},
+k={},
+l={[r]:"booleanEquals",[s]:[true,{[r]:"getAttr",[s]:[{[t]:e},"supportsFIPS"]}]},
+m={[r]:"booleanEquals",[s]:[true,{[r]:"getAttr",[s]:[{[t]:e},"supportsDualStack"]}]},
+n=[i],
 o=[j],
-p=[k];
-const _data={version:"1.0",parameters:{Region:{required:a,type:c},UseDualStack:h,UseFIPS:h,Endpoint:{required:b,type:c}},rules:[{conditions:[{[q]:"aws.partition",[r]:[{[s]:"Region"}],assign:d}],type:e,rules:[{conditions:[{[q]:"isSet",[r]:[i]}],type:e,rules:[{conditions:o,error:"Invalid Configuration: FIPS and custom endpoint are not supported",type:f},{type:e,rules:[{conditions:p,error:"Invalid Configuration: Dualstack and custom endpoint are not supported",type:f},{endpoint:{url:i,properties:l,headers:l},type:g}]}]},{conditions:[j,k],type:e,rules:[{conditions:[m,n],type:e,rules:[{endpoint:{url:"https://datasync-fips.{Region}.{PartitionResult#dualStackDnsSuffix}",properties:l,headers:l},type:g}]},{error:"FIPS and DualStack are enabled, but this partition does not support one or both",type:f}]},{conditions:o,type:e,rules:[{conditions:[m],type:e,rules:[{type:e,rules:[{endpoint:{url:"https://datasync-fips.{Region}.{PartitionResult#dnsSuffix}",properties:l,headers:l},type:g}]}]},{error:"FIPS is enabled but this partition does not support FIPS",type:f}]},{conditions:p,type:e,rules:[{conditions:[n],type:e,rules:[{endpoint:{url:"https://datasync.{Region}.{PartitionResult#dualStackDnsSuffix}",properties:l,headers:l},type:g}]},{error:"DualStack is enabled but this partition does not support DualStack",type:f}]},{endpoint:{url:"https://datasync.{Region}.{PartitionResult#dnsSuffix}",properties:l,headers:l},type:g}]}]};
+p=[{[t]:"Region"}];
+const _data={version:"1.0",parameters:{Region:f,UseDualStack:g,UseFIPS:g,Endpoint:f},rules:[{conditions:[{[r]:a,[s]:[h]}],type:b,rules:[{conditions:n,error:"Invalid Configuration: FIPS and custom endpoint are not supported",type:c},{type:b,rules:[{conditions:o,error:"Invalid Configuration: Dualstack and custom endpoint are not supported",type:c},{endpoint:{url:h,properties:k,headers:k},type:d}]}]},{type:b,rules:[{conditions:[{[r]:a,[s]:p}],type:b,rules:[{conditions:[{[r]:"aws.partition",[s]:p,assign:e}],type:b,rules:[{conditions:[i,j],type:b,rules:[{conditions:[l,m],type:b,rules:[{type:b,rules:[{endpoint:{url:"https://datasync-fips.{Region}.{PartitionResult#dualStackDnsSuffix}",properties:k,headers:k},type:d}]}]},{error:"FIPS and DualStack are enabled, but this partition does not support one or both",type:c}]},{conditions:n,type:b,rules:[{conditions:[l],type:b,rules:[{type:b,rules:[{endpoint:{url:"https://datasync-fips.{Region}.{PartitionResult#dnsSuffix}",properties:k,headers:k},type:d}]}]},{error:"FIPS is enabled but this partition does not support FIPS",type:c}]},{conditions:o,type:b,rules:[{conditions:[m],type:b,rules:[{type:b,rules:[{endpoint:{url:"https://datasync.{Region}.{PartitionResult#dualStackDnsSuffix}",properties:k,headers:k},type:d}]}]},{error:"DualStack is enabled but this partition does not support DualStack",type:c}]},{type:b,rules:[{endpoint:{url:"https://datasync.{Region}.{PartitionResult#dnsSuffix}",properties:k,headers:k},type:d}]}]}]},{error:"Invalid Configuration: Missing Region",type:c}]}]};
 export const ruleSet: RuleSetObject = _data;