docs: call out @deprecated in comments for shapes/members (#1876)

Author: trivikr

clients/client-application-discovery-service/ApplicationDiscoveryService.ts

@@ -566,6 +566,8 @@ export class ApplicationDiscoveryService extends ApplicationDiscoveryServiceClie
   }
 
   /**
+   * @deprecated
+   *
    * <p>
    *             <code>DescribeExportConfigurations</code> is deprecated. Use <a href="https://docs.aws.amazon.com/application-discovery/latest/APIReference/API_DescribeExportTasks.html">DescribeImportTasks</a>, instead.</p>
    */
@@ -743,6 +745,8 @@ export class ApplicationDiscoveryService extends ApplicationDiscoveryServiceClie
   }
 
   /**
+   * @deprecated
+   *
    * <p>Deprecated. Use <code>StartExportTask</code> instead.</p>
    *          <p>Exports all discovered configuration data to an Amazon S3 bucket or an application that
    *       enables you to view and evaluate the data. Data includes tags and tag associations, processes,

clients/client-application-discovery-service/commands/DescribeExportConfigurationsCommand.ts

@@ -25,6 +25,8 @@ export type DescribeExportConfigurationsCommandInput = DescribeExportConfigurati
 export type DescribeExportConfigurationsCommandOutput = DescribeExportConfigurationsResponse & __MetadataBearer;
 
 /**
+ * @deprecated
+ *
  * <p>
  *             <code>DescribeExportConfigurations</code> is deprecated. Use <a href="https://docs.aws.amazon.com/application-discovery/latest/APIReference/API_DescribeExportTasks.html">DescribeImportTasks</a>, instead.</p>
  */

clients/client-application-discovery-service/commands/ExportConfigurationsCommand.ts

@@ -25,6 +25,8 @@ export type ExportConfigurationsCommandInput = {};
 export type ExportConfigurationsCommandOutput = ExportConfigurationsResponse & __MetadataBearer;
 
 /**
+ * @deprecated
+ *
  * <p>Deprecated. Use <code>StartExportTask</code> instead.</p>
  *          <p>Exports all discovered configuration data to an Amazon S3 bucket or an application that
  *       enables you to view and evaluate the data. Data includes tags and tag associations, processes,

clients/client-appstream/models/models_0.ts

@@ -3786,6 +3786,8 @@ export interface UpdateFleetRequest {
   DisconnectTimeoutInSeconds?: number;
 
   /**
+   * @deprecated
+   *
    * <p>Deletes the VPC association for the specified fleet.</p>
    */
   DeleteVpcConfig?: boolean;
@@ -3935,6 +3937,8 @@ export interface UpdateStackRequest {
   StorageConnectors?: StorageConnector[];
 
   /**
+   * @deprecated
+   *
    * <p>Deletes the storage connectors currently enabled for the stack.</p>
    */
   DeleteStorageConnectors?: boolean;

clients/client-auto-scaling/models/models_0.ts

@@ -3546,6 +3546,8 @@ export interface ScalingPolicy {
   AdjustmentType?: string;
 
   /**
+   * @deprecated
+   *
    * <p>Available for backward compatibility. Use <code>MinAdjustmentMagnitude</code>
    *             instead.</p>
    */
@@ -4524,6 +4526,8 @@ export interface PutScalingPolicyType {
   AdjustmentType?: string;
 
   /**
+   * @deprecated
+   *
    * <p>Available for backward compatibility. Use <code>MinAdjustmentMagnitude</code>
    *             instead.</p>
    */

clients/client-batch/models/models_0.ts

@@ -435,6 +435,8 @@ export interface ComputeResource {
   instanceTypes?: string[];
 
   /**
+   * @deprecated
+   *
    * <p>The Amazon Machine Image (AMI) ID used for instances launched in the compute environment. This parameter is
    *    overridden by the <code>imageIdOverride</code> member of the <code>Ec2Configuration</code> structure.</p>
    *          <note>
@@ -1645,6 +1647,8 @@ export interface ContainerProperties {
   image?: string;
 
   /**
+   * @deprecated
+   *
    * <p>This parameter is deprecated and not supported for jobs run on Fargate resources, see
    *     <code>resourceRequirement</code>. The number of vCPUs reserved for the container. Jobs running on EC2 resources can
    *    specify the vCPU requirement for the job using <code>resourceRequirements</code> but the vCPU requirements can't be
@@ -1661,6 +1665,8 @@ export interface ContainerProperties {
   vcpus?: number;
 
   /**
+   * @deprecated
+   *
    * <p>This parameter is deprecated and not supported for jobs run on Fargate resources, use
    *     <code>ResourceRequirement</code>. For jobs run on EC2 resources can specify the memory requirement using the
    *     <code>ResourceRequirement</code> structure. The hard limit (in MiB) of memory to present to the container. If your
@@ -2969,6 +2975,8 @@ export namespace RegisterJobDefinitionResponse {
  */
 export interface ContainerOverrides {
   /**
+   * @deprecated
+   *
    * <p>This parameter is deprecated and not supported for jobs run on Fargate resources, see
    *     <code>resourceRequirement</code>. For jobs run on EC2 resources, the number of vCPUs to reserve for the container.
    *    This value overrides the value set in the job definition. Jobs run on EC2 resources can specify the vCPU requirement
@@ -2985,6 +2993,8 @@ export interface ContainerOverrides {
   vcpus?: number;
 
   /**
+   * @deprecated
+   *
    * <p>This parameter is deprecated and not supported for jobs run on Fargate resources, use
    *     <code>ResourceRequirement</code>. For jobs run on EC2 resource, the number of MiB of memory reserved for the job.
    *    This value overrides the value set in the job definition.</p>

clients/client-cloudfront/models/models_0.ts

@@ -884,6 +884,8 @@ export interface CacheBehavior {
   OriginRequestPolicyId?: string;
 
   /**
+   * @deprecated
+   *
    * <p>This field is deprecated. We recommend that you use a cache policy or an origin
    * 			request policy instead of this field. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/working-with-policies.html">Working with policies</a> in the
    * 			<i>Amazon CloudFront Developer Guide</i>.</p>
@@ -898,6 +900,8 @@ export interface CacheBehavior {
   ForwardedValues?: ForwardedValues;
 
   /**
+   * @deprecated
+   *
    * <p>This field is deprecated. We recommend that you use the <code>MinTTL</code> field in a cache
    * 			policy instead of this field. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-key-create-cache-policy">Creating cache policies</a> or <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html">Using the managed cache policies</a> in the
    * 			<i>Amazon CloudFront Developer Guide</i>.</p>
@@ -913,6 +917,8 @@ export interface CacheBehavior {
   MinTTL?: number;
 
   /**
+   * @deprecated
+   *
    * <p>This field is deprecated. We recommend that you use the <code>DefaultTTL</code> field in a
    * 			cache policy instead of this field. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-key-create-cache-policy">Creating cache policies</a> or <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html">Using the managed cache policies</a> in the
    * 			<i>Amazon CloudFront Developer Guide</i>.</p>
@@ -926,6 +932,8 @@ export interface CacheBehavior {
   DefaultTTL?: number;
 
   /**
+   * @deprecated
+   *
    * <p>This field is deprecated. We recommend that you use the <code>MaxTTL</code> field in a cache
    * 			policy instead of this field. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-key-create-cache-policy">Creating cache policies</a> or <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html">Using the managed cache policies</a> in the
    * 			<i>Amazon CloudFront Developer Guide</i>.</p>
@@ -2072,6 +2080,8 @@ export interface DefaultCacheBehavior {
   OriginRequestPolicyId?: string;
 
   /**
+   * @deprecated
+   *
    * <p>This field is deprecated. We recommend that you use a cache policy or an origin request
    * 			policy instead of this field. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/working-with-policies.html">Working with policies</a> in the
    * 			<i>Amazon CloudFront Developer Guide</i>.</p>
@@ -2086,6 +2096,8 @@ export interface DefaultCacheBehavior {
   ForwardedValues?: ForwardedValues;
 
   /**
+   * @deprecated
+   *
    * <p>This field is deprecated. We recommend that you use the <code>MinTTL</code> field in a cache
    * 			policy instead of this field. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-key-create-cache-policy">Creating cache policies</a> or <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html">Using the managed cache policies</a> in the
    * 			<i>Amazon CloudFront Developer Guide</i>.</p>
@@ -2100,6 +2112,8 @@ export interface DefaultCacheBehavior {
   MinTTL?: number;
 
   /**
+   * @deprecated
+   *
    * <p>This field is deprecated. We recommend that you use the <code>DefaultTTL</code> field in a
    * 			cache policy instead of this field. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-key-create-cache-policy">Creating cache policies</a> or <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html">Using the managed cache policies</a> in the
    * 			<i>Amazon CloudFront Developer Guide</i>.</p>
@@ -2113,6 +2127,8 @@ export interface DefaultCacheBehavior {
   DefaultTTL?: number;
 
   /**
+   * @deprecated
+   *
    * <p>This field is deprecated. We recommend that you use the <code>MaxTTL</code> field in a cache
    * 			policy instead of this field. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-key-create-cache-policy">Creating cache policies</a> or <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html">Using the managed cache policies</a> in the
    * 			<i>Amazon CloudFront Developer Guide</i>.</p>
@@ -2935,6 +2951,8 @@ export interface ViewerCertificate {
   MinimumProtocolVersion?: MinimumProtocolVersion | string;
 
   /**
+   * @deprecated
+   *
    * <p>This field is deprecated. Use one of the following fields instead:</p>
    * 		       <ul>
    *             <li>
@@ -2959,6 +2977,8 @@ export interface ViewerCertificate {
   Certificate?: string;
 
   /**
+   * @deprecated
+   *
    * <p>This field is deprecated. Use one of the following fields instead:</p>
    * 		       <ul>
    *             <li>

clients/client-cloudtrail/models/models_0.ts

@@ -627,6 +627,8 @@ export interface CreateTrailResponse {
   S3KeyPrefix?: string;
 
   /**
+   * @deprecated
+   *
    * <p>This field is no longer in use. Use SnsTopicARN.</p>
    */
   SnsTopicName?: string;
@@ -912,6 +914,8 @@ export namespace KmsException {
 }
 
 /**
+ * @deprecated
+ *
  * <p>This exception is no longer in use.</p>
  */
 export interface KmsKeyDisabledException extends __SmithyException, $MetadataBearer {
@@ -1188,6 +1192,8 @@ export interface Trail {
   S3KeyPrefix?: string;
 
   /**
+   * @deprecated
+   *
    * <p>This field is no longer in use. Use SnsTopicARN.</p>
    */
   SnsTopicName?: string;
@@ -2680,6 +2686,8 @@ export interface UpdateTrailResponse {
   S3KeyPrefix?: string;
 
   /**
+   * @deprecated
+   *
    * <p>This field is no longer in use. Use SnsTopicARN.</p>
    */
   SnsTopicName?: string;

clients/client-cloudwatch-logs/models/models_0.ts

@@ -831,6 +831,8 @@ export interface LogStream {
   arn?: string;
 
   /**
+   * @deprecated
+   *
    * <p>The number of bytes stored.</p>
    *          <p>
    *             <b>Important:</b> On June 17, 2019, this parameter was
@@ -1434,6 +1436,8 @@ export interface FilterLogEventsRequest {
   limit?: number;
 
   /**
+   * @deprecated
+   *
    * <p>If the value is true, the operation makes a best effort to provide responses that
    *       contain events from multiple log streams within the log group, interleaved in a single
    *       response. If the value is false, all the matched log events in the first log stream are

clients/client-codedeploy/CodeDeploy.ts

@@ -464,6 +464,8 @@ export class CodeDeploy extends CodeDeployClient {
   }
 
   /**
+   * @deprecated
+   *
    * <note>
    *             <p> This method works, but is deprecated. Use <code>BatchGetDeploymentTargets</code>
    *                 instead. </p>
@@ -1152,6 +1154,8 @@ export class CodeDeploy extends CodeDeployClient {
   }
 
   /**
+   * @deprecated
+   *
    * <p>Gets information about an instance as part of a deployment.</p>
    */
   public getDeploymentInstance(
@@ -1377,6 +1381,8 @@ export class CodeDeploy extends CodeDeployClient {
   }
 
   /**
+   * @deprecated
+   *
    * <note>
    *             <p> The newer <code>BatchGetDeploymentTargets</code> should be used instead because
    *                 it works with all compute types. <code>ListDeploymentInstances</code> throws an
@@ -1721,6 +1727,8 @@ export class CodeDeploy extends CodeDeployClient {
   }
 
   /**
+   * @deprecated
+   *
    * <p>In a blue/green deployment, overrides any specified wait time and starts terminating
    *             instances immediately after the traffic routing is complete.</p>
    */

clients/client-codedeploy/commands/BatchGetDeploymentInstancesCommand.ts

@@ -21,6 +21,8 @@ export type BatchGetDeploymentInstancesCommandInput = BatchGetDeploymentInstance
 export type BatchGetDeploymentInstancesCommandOutput = BatchGetDeploymentInstancesOutput & __MetadataBearer;
 
 /**
+ * @deprecated
+ *
  * <note>
  *             <p> This method works, but is deprecated. Use <code>BatchGetDeploymentTargets</code>
  *                 instead. </p>

clients/client-codedeploy/commands/GetDeploymentInstanceCommand.ts

@@ -21,6 +21,8 @@ export type GetDeploymentInstanceCommandInput = GetDeploymentInstanceInput;
 export type GetDeploymentInstanceCommandOutput = GetDeploymentInstanceOutput & __MetadataBearer;
 
 /**
+ * @deprecated
+ *
  * <p>Gets information about an instance as part of a deployment.</p>
  */
 export class GetDeploymentInstanceCommand extends $Command<

clients/client-codedeploy/commands/ListDeploymentInstancesCommand.ts

@@ -21,6 +21,8 @@ export type ListDeploymentInstancesCommandInput = ListDeploymentInstancesInput;
 export type ListDeploymentInstancesCommandOutput = ListDeploymentInstancesOutput & __MetadataBearer;
 
 /**
+ * @deprecated
+ *
  * <note>
  *             <p> The newer <code>BatchGetDeploymentTargets</code> should be used instead because
  *                 it works with all compute types. <code>ListDeploymentInstances</code> throws an

clients/client-codedeploy/commands/SkipWaitTimeForInstanceTerminationCommand.ts

@@ -21,6 +21,8 @@ export type SkipWaitTimeForInstanceTerminationCommandInput = SkipWaitTimeForInst
 export type SkipWaitTimeForInstanceTerminationCommandOutput = __MetadataBearer;
 
 /**
+ * @deprecated
+ *
  * <p>In a blue/green deployment, overrides any specified wait time and starts terminating
  *             instances immediately after the traffic routing is complete.</p>
  */