Update parameter descriptions for Snapshot Management. (#836)

Signed-off-by: Archer <[email protected]>

Author: Naarcha-AWS

spec/namespaces/sm.yaml

@@ -217,30 +217,31 @@ components:
     sm.create_policy::path.policy_name:
       name: policy_name
       in: path
-      description: The name of the snapshot management policy.
+      description: The snapshot management policy name.
       required: true
       schema:
         type: string
 
     sm.get_policy::path.policy_name:
       name: policy_name
       in: path
-      description: The name of the snapshot management policy.
+      description: The snapshot management name.
       required: true
       schema:
         type: string
 
     sm.get_policies::query.from:
       name: from
       in: query
-      description: 'The starting index (default: 0)'
+      description: The index to retrieve snapshot management policies from.
       schema:
+        default: 0
         type: integer
 
     sm.update_policy::path.policy_name:
       name: policy_name
       in: path
-      description: The name of the snapshot management policy.
+      description: The snapshot management policy name.
       required: true
       schema:
         type: string
@@ -264,61 +265,60 @@ components:
     sm.delete_policy::path.policy_name:
       name: policy_name
       in: path
-      description: The name of the snapshot management policy.
+      description: The snapshot management policy name.
       required: true
       schema:
         type: string
 
     sm.explain_policy::path.policy_name:
       name: policy_name
       in: path
-      description: The name of the snapshot management policy.
+      description: The snapshot management policy name.
       required: true
       schema:
         type: string
 
     sm.start_policy::path.policy_name:
       name: policy_name
       in: path
-      description: The name of the snapshot management policy.
+      description: The snapshot management policy name.
       required: true
       schema:
         type: string
 
     sm.stop_policy::path.policy_name:
       name: policy_name
       in: path
-      description: The name of the snapshot management policy.
+      description: The snapshot management policy name.
       required: true
       schema:
         type: string
 
     sm.get_policies::query.size:
       name: size
       in: query
-      description:
-        The number of policies to return.
+      description: The number of snapshot management policies to return.
       schema:
         type: integer
 
     sm.get_policies::query.queryString:
       name: queryString
       in: query
-      description: A query string to filter policies.
+      description: Filters the returned snapshot management policies based on query string.
       schema:
         type: string
 
     sm.get_policies::query.sortField:
       name: sortField
       in: query
-      description: The field to sort on.
+      description: The name of the query field to sort on.
       schema:
         type: string
 
     sm.get_policies::query.sortOrder:
       name: sortOrder
       in: query
-      description: The order of sorting.
+      description: The order to sort the snapshot management policy result.
       schema:
         type: string
         enum: [asc, desc]