Add more descriptions to SSL certificate API

Author: lcawl

output/openapi/elasticsearch-openapi.json

@@ -672,6 +672,7 @@ security-api-update-key,https://www.elastic.co/guide/en/elasticsearch/reference/
 security-api-update-user-data,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/security-api-update-user-profile-data.html
 security-privileges,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/security-privileges.html
 security-api-update-settings,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/security-api-update-settings.html
+security-encrypt-internode,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/security-basic-setup.html#encrypt-internode-communication
 service-accounts,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/service-accounts.html
 set-processor,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/set-processor.html
 shape,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/shape.html

output/schema/schema.json

@@ -40,7 +40,9 @@ import { RequestBase } from '@_types/Base'
  * @rest_spec_name ssl.certificates
  * @availability stack since=6.2.0 stability=stable
  * @availability serverless stability=stable visibility=private
+ * @cluster_privileges monitor
  * @doc_tag security
  * @doc_id security-api-ssl
+ * @ext_doc_id security-encrypt-internode
  */
 export interface Request extends RequestBase {}

specification/_doc_ids/table.csv

@@ -20,12 +20,38 @@
 import { DateTime } from '@_types/Time'
 
 export class CertificateInformation {
+  /**
+   * If the path refers to a container file (a jks keystore, or a PKCS#12 file), it is the alias of the certificate.
+   * Otherwise, it is null.
+   */
   alias: string | null
+  /**
+   * The ISO formatted date of the certificate's expiry (not-after) date.
+   */
   expiry: DateTime
+  /**
+   * The format of the file.
+   * Valid values include `jks`, `PKCS12`, and `PEM`.
+   */
   format: string
+  /**
+   * Indicates whether Elasticsearch has access to the private key for this certificate.
+   */
   has_private_key: boolean
+  /**
+   * The Distinguished Name of the certificate's issuer.
+   */
   issuer?: string
+  /**
+   * The path to the certificate, as configured in the `elasticsearch.yml` file.
+   */
   path: string
+  /**
+   * The hexadecimal representation of the certificate's serial number.
+   */
   serial_number: string
+  /**
+   * The Distinguished Name of the certificate's subject.
+   */
   subject_dn: string
 }