fix(privateca): update the API

#### privateca:v1

The following keys were changed:
- schemas.CaOptions.description
- schemas.CaOptions.properties.isCa.description
- schemas.CaOptions.properties.maxIssuerPathLength.description
- schemas.X509Parameters.properties.caOptions.description

Author: yoshi-automation

discovery/privateca-v1.json

@@ -1605,7 +1605,7 @@
       }
     }
   },
-  "revision": "20240424",
+  "revision": "20240619",
   "rootUrl": "https://privateca.googleapis.com/",
   "schemas": {
     "AccessUrls": {
@@ -1731,15 +1731,15 @@
       "type": "object"
     },
     "CaOptions": {
-      "description": "Describes values that are relevant in a CA certificate.",
+      "description": "Describes the X.509 basic constraints extension, per [RFC 5280 section 4.2.1.9](https://tools.ietf.org/html/rfc5280#section-4.2.1.9)",
       "id": "CaOptions",
       "properties": {
         "isCa": {
-          "description": "Optional. Refers to the \"CA\" X.509 extension, which is a boolean value. When this value is missing, the extension will be omitted from the CA certificate.",
+          "description": "Optional. Refers to the \"CA\" boolean field in the X.509 extension. When this value is missing, the basic constraints extension will be omitted from the certificate.",
           "type": "boolean"
         },
         "maxIssuerPathLength": {
-          "description": "Optional. Refers to the path length restriction X.509 extension. For a CA certificate, this value describes the depth of subordinate CA certificates that are allowed. If this value is less than 0, the request will fail. If this value is missing, the max path length will be omitted from the CA certificate.",
+          "description": "Optional. Refers to the path length constraint field in the X.509 extension. For a CA certificate, this value describes the depth of subordinate CA certificates that are allowed. If this value is less than 0, the request will fail. If this value is missing, the max path length will be omitted from the certificate.",
           "format": "int32",
           "type": "integer"
         }
@@ -3510,7 +3510,7 @@
         },
         "caOptions": {
           "$ref": "CaOptions",
-          "description": "Optional. Describes options in this X509Parameters that are relevant in a CA certificate."
+          "description": "Optional. Describes options in this X509Parameters that are relevant in a CA certificate. If not specified, a default basic constraints extension with `is_ca=false` will be added for leaf certificates."
         },
         "keyUsage": {
           "$ref": "KeyUsage",

src/apis/privateca/v1.ts

@@ -215,15 +215,15 @@ export namespace privateca_v1 {
    */
   export interface Schema$CancelOperationRequest {}
   /**
-   * Describes values that are relevant in a CA certificate.
+   * Describes the X.509 basic constraints extension, per [RFC 5280 section 4.2.1.9](https://tools.ietf.org/html/rfc5280#section-4.2.1.9)
    */
   export interface Schema$CaOptions {
     /**
-     * Optional. Refers to the "CA" X.509 extension, which is a boolean value. When this value is missing, the extension will be omitted from the CA certificate.
+     * Optional. Refers to the "CA" boolean field in the X.509 extension. When this value is missing, the basic constraints extension will be omitted from the certificate.
      */
     isCa?: boolean | null;
     /**
-     * Optional. Refers to the path length restriction X.509 extension. For a CA certificate, this value describes the depth of subordinate CA certificates that are allowed. If this value is less than 0, the request will fail. If this value is missing, the max path length will be omitted from the CA certificate.
+     * Optional. Refers to the path length constraint field in the X.509 extension. For a CA certificate, this value describes the depth of subordinate CA certificates that are allowed. If this value is less than 0, the request will fail. If this value is missing, the max path length will be omitted from the certificate.
      */
     maxIssuerPathLength?: number | null;
   }
@@ -1403,7 +1403,7 @@ export namespace privateca_v1 {
      */
     aiaOcspServers?: string[] | null;
     /**
-     * Optional. Describes options in this X509Parameters that are relevant in a CA certificate.
+     * Optional. Describes options in this X509Parameters that are relevant in a CA certificate. If not specified, a default basic constraints extension with `is_ca=false` will be added for leaf certificates.
      */
     caOptions?: Schema$CaOptions;
     /**