Improve descriptions for various API commands and data types.

Author: aws-sdk-dotnet-automation

generator/ServiceModels/opensearch/opensearch-2021-01-01.docs.json

@@ -30,7 +30,9 @@
 namespace Amazon.OpenSearchService.Model
 {
     /// <summary>
-    /// Configurations of the OpenSearch Application.
+    /// Configuration settings for an OpenSearch application. For more information, see see
+    /// <a href="https://docs.aws.amazon.com/opensearch-service/latest/developerguide/application.html">Using
+    /// the OpenSearch user interface in Amazon OpenSearch Service</a>.
     /// </summary>
     public partial class AppConfig
     {
@@ -40,7 +42,7 @@ public partial class AppConfig
         /// <summary>
         /// Gets and sets the property Key. 
         /// <para>
-        /// Specify the item to configure, such as admin role for the OpenSearch Application.
+        /// The configuration item to set, such as the admin role for the OpenSearch application.
         /// </para>
         /// </summary>
         public AppConfigType Key
@@ -58,7 +60,7 @@ internal bool IsSetKey()
         /// <summary>
         /// Gets and sets the property Value. 
         /// <para>
-        /// Specifies the value to configure for the key, such as an IAM user ARN.
+        /// The value assigned to the configuration key, such as an IAM user ARN.
         /// </para>
         /// </summary>
         [AWSProperty(Min=1, Max=4096)]

generator/ServiceModels/opensearch/opensearch-2021-01-01.normal.json

@@ -30,7 +30,7 @@
 namespace Amazon.OpenSearchService.Model
 {
     /// <summary>
-    /// Basic information of the OpenSearch Application.
+    /// Basic details of an OpenSearch application.
     /// </summary>
     public partial class ApplicationSummary
     {
@@ -61,7 +61,7 @@ internal bool IsSetArn()
         /// <summary>
         /// Gets and sets the property CreatedAt. 
         /// <para>
-        /// Timestamp at which an OpenSearch Application was created.
+        /// The timestamp when an OpenSearch application was created.
         /// </para>
         /// </summary>
         public DateTime CreatedAt
@@ -79,7 +79,7 @@ internal bool IsSetCreatedAt()
         /// <summary>
         /// Gets and sets the property Endpoint. 
         /// <para>
-        /// Endpoint URL of an OpenSearch Application.
+        /// The endpoint URL of an OpenSearch application.
         /// </para>
         /// </summary>
         public string Endpoint
@@ -97,7 +97,7 @@ internal bool IsSetEndpoint()
         /// <summary>
         /// Gets and sets the property Id. 
         /// <para>
-        /// Unique identifier for an OpenSearch application.
+        /// The unique identifier of an OpenSearch application.
         /// </para>
         /// </summary>
         public string Id
@@ -115,7 +115,7 @@ internal bool IsSetId()
         /// <summary>
         /// Gets and sets the property LastUpdatedAt. 
         /// <para>
-        /// Timestamp at which an OpenSearch Application was last updated.
+        /// The timestamp of the last update to an OpenSearch application.
         /// </para>
         /// </summary>
         public DateTime LastUpdatedAt
@@ -133,7 +133,7 @@ internal bool IsSetLastUpdatedAt()
         /// <summary>
         /// Gets and sets the property Name. 
         /// <para>
-        /// Name of an OpenSearch Application.
+        /// The name of an OpenSearch application.
         /// </para>
         /// </summary>
         [AWSProperty(Min=3, Max=30)]
@@ -152,8 +152,8 @@ internal bool IsSetName()
         /// <summary>
         /// Gets and sets the property Status. 
         /// <para>
-        /// Status of an OpenSearch Application. Possible values are <c>CREATING</c>, <c>UPDATING</c>,<c>
-        /// DELETING</c>, <c>FAILED</c>, <c>ACTIVE</c>, and <c>DELETED</c>.
+        /// The current status of an OpenSearch application. Possible values: <c>CREATING</c>,
+        /// <c>UPDATING</c>, <c>DELETING</c>, <c>FAILED</c>, <c>ACTIVE</c>, and <c>DELETED</c>.
         /// </para>
         /// </summary>
         public ApplicationStatus Status

sdk/src/Services/OpenSearchService/Generated/Model/AppConfig.cs

@@ -31,7 +31,8 @@ namespace Amazon.OpenSearchService.Model
 {
     /// <summary>
     /// Container for the parameters to the CreateApplication operation.
-    /// Creates an OpenSearch Application.
+    /// Creates an OpenSearch UI application. For more information, see <a href="https://docs.aws.amazon.com/opensearch-service/latest/developerguide/application.html">Using
+    /// the OpenSearch user interface in Amazon OpenSearch Service</a>.
     /// </summary>
     public partial class CreateApplicationRequest : AmazonOpenSearchServiceRequest
     {
@@ -45,7 +46,7 @@ public partial class CreateApplicationRequest : AmazonOpenSearchServiceRequest
         /// <summary>
         /// Gets and sets the property AppConfigs. 
         /// <para>
-        /// Configurations of the OpenSearch Application, inlcuding admin configuration.
+        /// Configuration settings for the OpenSearch application, including administrative options.
         /// </para>
         /// </summary>
         [AWSProperty(Max=200)]
@@ -64,7 +65,7 @@ internal bool IsSetAppConfigs()
         /// <summary>
         /// Gets and sets the property ClientToken. 
         /// <para>
-        /// A unique client idempotency token. It will be auto generated if not provided.
+        /// Unique, case-sensitive identifier to ensure idempotency of the request.
         /// </para>
         /// </summary>
         [AWSProperty(Min=1, Max=64)]
@@ -83,7 +84,7 @@ internal bool IsSetClientToken()
         /// <summary>
         /// Gets and sets the property DataSources. 
         /// <para>
-        /// Data sources to be associated with the OpenSearch Application.
+        /// The data sources to link to the OpenSearch application.
         /// </para>
         /// </summary>
         public List<DataSource> DataSources
@@ -101,7 +102,8 @@ internal bool IsSetDataSources()
         /// <summary>
         /// Gets and sets the property IamIdentityCenterOptions. 
         /// <para>
-        /// Settings of IAM Identity Center for the OpenSearch Application.
+        /// Configuration settings for integrating Amazon Web Services IAM Identity Center with
+        /// the OpenSearch application.
         /// </para>
         /// </summary>
         public IamIdentityCenterOptionsInput IamIdentityCenterOptions
@@ -119,8 +121,8 @@ internal bool IsSetIamIdentityCenterOptions()
         /// <summary>
         /// Gets and sets the property Name. 
         /// <para>
-        /// Name of the OpenSearch Appication to create. Application names are unique across the
-        /// applications owned by an account within an Amazon Web Services Region.
+        /// The unique name of the OpenSearch application. Names must be unique within an Amazon
+        /// Web Services Region for each account.
         /// </para>
         /// </summary>
         [AWSProperty(Required=true, Min=3, Max=30)]

sdk/src/Services/OpenSearchService/Generated/Model/ApplicationSummary.cs

@@ -46,7 +46,7 @@ public partial class CreateApplicationResponse : AmazonWebServiceResponse
         /// <summary>
         /// Gets and sets the property AppConfigs. 
         /// <para>
-        /// Configurations of the OpenSearch Application, inlcuding admin configuration.
+        /// Configuration settings for the OpenSearch application, including administrative options.
         /// </para>
         /// </summary>
         [AWSProperty(Max=200)]
@@ -81,7 +81,7 @@ internal bool IsSetArn()
         /// <summary>
         /// Gets and sets the property CreatedAt. 
         /// <para>
-        /// Timestamp when the OpenSearch Application was created.
+        /// The timestamp indicating when the OpenSearch application was created.
         /// </para>
         /// </summary>
         public DateTime CreatedAt
@@ -99,7 +99,7 @@ internal bool IsSetCreatedAt()
         /// <summary>
         /// Gets and sets the property DataSources. 
         /// <para>
-        /// Data sources associated with the created OpenSearch Application.
+        /// The data sources linked to the OpenSearch application.
         /// </para>
         /// </summary>
         public List<DataSource> DataSources
@@ -117,7 +117,7 @@ internal bool IsSetDataSources()
         /// <summary>
         /// Gets and sets the property IamIdentityCenterOptions. 
         /// <para>
-        /// Settings of IAM Identity Center for the created OpenSearch Application.
+        /// The IAM Identity Center settings configured for the OpenSearch application.
         /// </para>
         /// </summary>
         public IamIdentityCenterOptions IamIdentityCenterOptions
@@ -135,7 +135,7 @@ internal bool IsSetIamIdentityCenterOptions()
         /// <summary>
         /// Gets and sets the property Id. 
         /// <para>
-        /// Unique identifier for the created OpenSearch Application.
+        /// The unique identifier assigned to the OpenSearch application.
         /// </para>
         /// </summary>
         public string Id
@@ -153,7 +153,7 @@ internal bool IsSetId()
         /// <summary>
         /// Gets and sets the property Name. 
         /// <para>
-        /// Name of the created OpenSearch Application.
+        /// The name of the OpenSearch application.
         /// </para>
         /// </summary>
         [AWSProperty(Min=3, Max=30)]

sdk/src/Services/OpenSearchService/Generated/Model/CreateApplicationRequest.cs

@@ -323,7 +323,8 @@ internal bool IsSetEngineVersion()
         /// <summary>
         /// Gets and sets the property IdentityCenterOptions. 
         /// <para>
-        /// Options for IAM Identity Center Option control for the domain.
+        /// Configuration options for enabling and managing IAM Identity Center integration within
+        /// a domain.
         /// </para>
         /// </summary>
         public IdentityCenterOptionsInput IdentityCenterOptions

sdk/src/Services/OpenSearchService/Generated/Model/CreateApplicationResponse.cs

@@ -31,7 +31,7 @@ namespace Amazon.OpenSearchService.Model
 {
     /// <summary>
     /// Container for the parameters to the DeleteApplication operation.
-    /// Deletes an existing OpenSearch Application.
+    /// Deletes a specified OpenSearch application.
     /// </summary>
     public partial class DeleteApplicationRequest : AmazonOpenSearchServiceRequest
     {
@@ -40,7 +40,7 @@ public partial class DeleteApplicationRequest : AmazonOpenSearchServiceRequest
         /// <summary>
         /// Gets and sets the property Id. 
         /// <para>
-        /// Unique identifier for the OpenSearch Application that you want to delete.
+        /// The unique identifier of the OpenSearch application to delete.
         /// </para>
         /// </summary>
         [AWSProperty(Required=true)]

sdk/src/Services/OpenSearchService/Generated/Model/CreateDomainRequest.cs

@@ -278,7 +278,8 @@ internal bool IsSetEngineVersion()
         /// <summary>
         /// Gets and sets the property IdentityCenterOptions. 
         /// <para>
-        /// Container for IAM Identity Center Option control for the domain.
+        /// Configuration options for enabling and managing IAM Identity Center integration within
+        /// a domain.
         /// </para>
         /// </summary>
         public IdentityCenterOptionsStatus IdentityCenterOptions

sdk/src/Services/OpenSearchService/Generated/Model/DeleteApplicationRequest.cs

@@ -120,7 +120,7 @@ internal bool IsSetNodeStatus()
         /// <summary>
         /// Gets and sets the property NodeType. 
         /// <para>
-        /// Indicates whether the nodes is a data, master, or ultrawarm node.
+        /// Indicates whether the nodes is a data, master, or UltraWarm node.
         /// </para>
         /// </summary>
         public NodeType NodeType
@@ -174,7 +174,7 @@ internal bool IsSetStorageType()
         /// <summary>
         /// Gets and sets the property StorageVolumeType. 
         /// <para>
-        /// If the nodes has EBS storage, indicates if the volume type is GP2 or GP3. Only applicable
+        /// If the nodes has EBS storage, indicates if the volume type is gp2 or gp3. Only applicable
         /// for data nodes. 
         /// </para>
         /// </summary>