[DOCS] Augment descriptions in the license APIs (#6109) (#6126)

(cherry picked from commit 11f0a10)

Co-authored-by: Lisa Cawley <lcawley@elastic.co>

Author: github-actions[bot]

specification/license/get/types.ts

@@ -23,16 +23,52 @@ import { DateTime, EpochTime, UnitMillis } from '@_types/Time'
 import { LicenseStatus, LicenseType } from '@license/_types/License'
 
 export class LicenseInformation {
+  /**
+   * The date and time the license expires in ISO 8601 format.
+   */
   expiry_date?: DateTime
+  /**
+   * The date and time the license expires in milliseconds since the Unix epoch.
+   */
   expiry_date_in_millis?: EpochTime<UnitMillis>
+  /**
+   * The date and time the license was issued in ISO 8601 format.
+   */
   issue_date: DateTime
+  /**
+   * The date and time the license was issued in milliseconds since the Unix epoch.
+   */
   issue_date_in_millis: EpochTime<UnitMillis>
+  /**
+   * The name of the customer or organization that received the license.
+   */
   issued_to: string
+  /**
+   * The name of the organization that issued the license.
+   */
   issuer: string
+  /**
+   * The maximum number of nodes the license allows.
+   */
   max_nodes: long | null
+  /**
+   * The maximum number of resource units the license allows (for enterprise licenses only).
+   */
   max_resource_units?: integer | null
+  /**
+   * The status of the license. For example,active, valid, invalid, or expired.
+   */
   status: LicenseStatus
+  /**
+   * The type of the license. For example, trial, basic, gold, platinum, or enterprise.
+   */
   type: LicenseType
+  /**
+   * The unique identifier of the license.
+   */
   uid: Uuid
+  /**
+   * The date and time the license was started in milliseconds since the Unix epoch.
+   */
   start_date_in_millis: EpochTime<UnitMillis>
 }

specification/license/post/PostLicenseRequest.ts

@@ -48,7 +48,8 @@ export interface Request extends RequestBase {
   response_media_type: MediaType.Json
   query_parameters: {
     /**
-     * Specifies whether you acknowledge the license changes.
+     * To update a license, you must accept the acknowledge messages and set this parameter to `true`.
+     * In particular, if you are upgrading or downgrading a license, you must acknowlege the feature changes.
      * @server_default false
      */
     acknowledge?: boolean

specification/license/post_start_basic/StartBasicLicenseRequest.ts

@@ -47,7 +47,7 @@ export interface Request extends RequestBase {
   response_media_type: MediaType.Json
   query_parameters: {
     /**
-     * Whether the user has acknowledged acknowledge messages
+     *  To start a basic license, you must accept the acknowledge messages and set this parameter to `true`.
      * @server_default false
      */
     acknowledge?: boolean

specification/license/post_start_trial/StartTrialLicenseRequest.ts

@@ -45,7 +45,7 @@ export interface Request extends RequestBase {
   response_media_type: MediaType.Json
   query_parameters: {
     /**
-     * Whether the user has acknowledged acknowledge messages
+     * To start a trial, you must accept the acknowledge messages and set this parameter to `true`.
      * @server_default false
      */
     acknowledge?: boolean