feat(file): update the API

#### file:v1beta1 The following keys were added: - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.description - schemas.Instance.properties.protocol.description - schemas.Instance.properties.protocol.enum - schemas.Instance.properties.protocol.enumDescriptions - schemas.Instance.properties.protocol.type The following keys were changed: - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.consumerDefinedName.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.maintenancePolicyNames.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings.properties.maintenancePolicies.description #### file:v1 The following keys were added: - schemas.Backup.properties.kmsKey.description - schemas.Backup.properties.kmsKey.type - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.description The following keys were changed: - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.consumerDefinedName.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.maintenancePolicyNames.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings.properties.maintenancePolicies.description
googleapis · Feb 2, 2023 · 3b7046b · 3b7046b
1 parent 8f35984
commit 3b7046b
Show file tree

Hide file tree

Showing 4 changed files with 54 additions and 14 deletions.
diff --git a/discovery/file-v1.json b/discovery/file-v1.json
@@ -846,7 +846,7 @@
       }
     }
   },
-  "revision": "20221207",
+  "revision": "20230125",
   "rootUrl": "https://file.googleapis.com/",
   "schemas": {
     "Backup": {
@@ -875,6 +875,10 @@
           "readOnly": true,
           "type": "string"
         },
+        "kmsKey": {
+          "description": "Immutable. KMS key name used for data encryption.",
+          "type": "string"
+        },
         "labels": {
           "additionalProperties": {
             "type": "string"
@@ -1048,10 +1052,11 @@
       "type": "object"
     },
     "GoogleCloudSaasacceleratorManagementProvidersV1Instance": {
+      "description": "Instance represents the interface for SLM services to actuate the state of control plane resources. Example Instance in JSON, where consumer-project-number=123456, producer-project-id=cloud-sql: ```json Instance: { \"name\": \"projects/123456/locations/us-east1/instances/prod-instance\", \"create_time\": { \"seconds\": 1526406431, }, \"labels\": { \"env\": \"prod\", \"foo\": \"bar\" }, \"state\": READY, \"software_versions\": { \"software_update\": \"cloud-sql-09-28-2018\", }, \"maintenance_policy_names\": { \"UpdatePolicy\": \"projects/123456/locations/us-east1/maintenancePolicies/prod-update-policy\", } \"tenant_project_id\": \"cloud-sql-test-tenant\", \"producer_metadata\": { \"cloud-sql-tier\": \"basic\", \"cloud-sql-instance-size\": \"1G\", }, \"provisioned_resources\": [ { \"resource-type\": \"compute-instance\", \"resource-url\": \"https://www.googleapis.com/compute/v1/projects/cloud-sql/zones/us-east1-b/instances/vm-1\", } ], \"maintenance_schedules\": { \"csa_rollout\": { \"start_time\": { \"seconds\": 1526406431, }, \"end_time\": { \"seconds\": 1535406431, }, }, \"ncsa_rollout\": { \"start_time\": { \"seconds\": 1526406431, }, \"end_time\": { \"seconds\": 1535406431, }, } }, \"consumer_defined_name\": \"my-sql-instance1\", } ``` LINT.IfChange",
       "id": "GoogleCloudSaasacceleratorManagementProvidersV1Instance",
       "properties": {
         "consumerDefinedName": {
-          "description": "consumer_defined_name is the name that is set by the consumer. On the other hand Name field represents system-assigned id of an instance so consumers are not necessarily aware of it. consumer_defined_name is used for notification/UI purposes for consumer to recognize their instances.",
+          "description": "consumer_defined_name is the name of the instance set by the service consumers. Generally this is different from the `name` field which reperesents the system-assigned id of the instance which the service consumers do not recognize. This is a required field for tenants onboarding to Maintenance Window notifications (go/slm-rollout-maintenance-policies#prerequisites).",
           "type": "string"
         },
         "createTime": {
@@ -1075,7 +1080,7 @@
           "additionalProperties": {
             "type": "string"
           },
-          "description": "Optional. Deprecated. The MaintenancePolicies that have been attached to the instance. The key must be of the type name of the oneof policy name defined in MaintenancePolicy, and the referenced policy must define the same policy type. For complete details of MaintenancePolicy, please refer to go/cloud-saas-mw-ug.",
+          "description": "Optional. The MaintenancePolicies that have been attached to the instance. The key must be of the type name of the oneof policy name defined in MaintenancePolicy, and the referenced policy must define the same policy type. For details, please refer to go/cloud-saas-mw-ug. Should not be set if maintenance_settings.maintenance_policies is set.",
           "type": "object"
         },
         "maintenanceSchedules": {
@@ -1215,7 +1220,7 @@
           "additionalProperties": {
             "$ref": "MaintenancePolicy"
           },
-          "description": "Optional. The MaintenancePolicies that have been attached to the instance. The key must be of the type name of the oneof policy name defined in MaintenancePolicy, and the embedded policy must define the same policy type. For complete details of MaintenancePolicy, please refer to go/cloud-saas-mw-ug. If only the name is needed, then only populate MaintenancePolicy.name.",
+          "description": "Optional. The MaintenancePolicies that have been attached to the instance. The key must be of the type name of the oneof policy name defined in MaintenancePolicy, and the embedded policy must define the same policy type. For details, please refer to go/cloud-saas-mw-ug. Should not be set if maintenance_policy_names is set. If only the name is needed, then only populate MaintenancePolicy.name.",
           "type": "object"
         }
       },

diff --git a/discovery/file-v1beta1.json b/discovery/file-v1beta1.json
@@ -1041,7 +1041,7 @@
       }
     }
   },
-  "revision": "20221207",
+  "revision": "20230125",
   "rootUrl": "https://file.googleapis.com/",
   "schemas": {
     "Backup": {
@@ -1247,10 +1247,11 @@
       "type": "object"
     },
     "GoogleCloudSaasacceleratorManagementProvidersV1Instance": {
+      "description": "Instance represents the interface for SLM services to actuate the state of control plane resources. Example Instance in JSON, where consumer-project-number=123456, producer-project-id=cloud-sql: ```json Instance: { \"name\": \"projects/123456/locations/us-east1/instances/prod-instance\", \"create_time\": { \"seconds\": 1526406431, }, \"labels\": { \"env\": \"prod\", \"foo\": \"bar\" }, \"state\": READY, \"software_versions\": { \"software_update\": \"cloud-sql-09-28-2018\", }, \"maintenance_policy_names\": { \"UpdatePolicy\": \"projects/123456/locations/us-east1/maintenancePolicies/prod-update-policy\", } \"tenant_project_id\": \"cloud-sql-test-tenant\", \"producer_metadata\": { \"cloud-sql-tier\": \"basic\", \"cloud-sql-instance-size\": \"1G\", }, \"provisioned_resources\": [ { \"resource-type\": \"compute-instance\", \"resource-url\": \"https://www.googleapis.com/compute/v1/projects/cloud-sql/zones/us-east1-b/instances/vm-1\", } ], \"maintenance_schedules\": { \"csa_rollout\": { \"start_time\": { \"seconds\": 1526406431, }, \"end_time\": { \"seconds\": 1535406431, }, }, \"ncsa_rollout\": { \"start_time\": { \"seconds\": 1526406431, }, \"end_time\": { \"seconds\": 1535406431, }, } }, \"consumer_defined_name\": \"my-sql-instance1\", } ``` LINT.IfChange",
       "id": "GoogleCloudSaasacceleratorManagementProvidersV1Instance",
       "properties": {
         "consumerDefinedName": {
-          "description": "consumer_defined_name is the name that is set by the consumer. On the other hand Name field represents system-assigned id of an instance so consumers are not necessarily aware of it. consumer_defined_name is used for notification/UI purposes for consumer to recognize their instances.",
+          "description": "consumer_defined_name is the name of the instance set by the service consumers. Generally this is different from the `name` field which reperesents the system-assigned id of the instance which the service consumers do not recognize. This is a required field for tenants onboarding to Maintenance Window notifications (go/slm-rollout-maintenance-policies#prerequisites).",
           "type": "string"
         },
         "createTime": {
@@ -1274,7 +1275,7 @@
           "additionalProperties": {
             "type": "string"
           },
-          "description": "Optional. Deprecated. The MaintenancePolicies that have been attached to the instance. The key must be of the type name of the oneof policy name defined in MaintenancePolicy, and the referenced policy must define the same policy type. For complete details of MaintenancePolicy, please refer to go/cloud-saas-mw-ug.",
+          "description": "Optional. The MaintenancePolicies that have been attached to the instance. The key must be of the type name of the oneof policy name defined in MaintenancePolicy, and the referenced policy must define the same policy type. For details, please refer to go/cloud-saas-mw-ug. Should not be set if maintenance_settings.maintenance_policies is set.",
           "type": "object"
         },
         "maintenanceSchedules": {
@@ -1414,7 +1415,7 @@
           "additionalProperties": {
             "$ref": "MaintenancePolicy"
           },
-          "description": "Optional. The MaintenancePolicies that have been attached to the instance. The key must be of the type name of the oneof policy name defined in MaintenancePolicy, and the embedded policy must define the same policy type. For complete details of MaintenancePolicy, please refer to go/cloud-saas-mw-ug. If only the name is needed, then only populate MaintenancePolicy.name.",
+          "description": "Optional. The MaintenancePolicies that have been attached to the instance. The key must be of the type name of the oneof policy name defined in MaintenancePolicy, and the embedded policy must define the same policy type. For details, please refer to go/cloud-saas-mw-ug. Should not be set if maintenance_policy_names is set. If only the name is needed, then only populate MaintenancePolicy.name.",
           "type": "object"
         }
       },
@@ -1594,6 +1595,20 @@
           },
           "type": "array"
         },
+        "protocol": {
+          "description": "Immutable. The protocol indicates the access protocol for all shares in the instance. This field is immutable and it cannot be changed after the instance has been created. Default value: `NFS_V3`.",
+          "enum": [
+            "FILE_PROTOCOL_UNSPECIFIED",
+            "NFS_V3",
+            "NFS_V4_1"
+          ],
+          "enumDescriptions": [
+            "FILE_PROTOCOL_UNSPECIFIED serves a \"not set\" default value when a FileProtocol is a separate field in a message.",
+            "NFS 3.0.",
+            "NFS 4.1."
+          ],
+          "type": "string"
+        },
         "satisfiesPzs": {
           "description": "Output only. Reserved for future use.",
           "readOnly": true,

diff --git a/src/apis/file/v1.ts b/src/apis/file/v1.ts
@@ -144,6 +144,10 @@ export namespace file_v1 {
      * Output only. Amount of bytes that will be downloaded if the backup is restored. This may be different than storage bytes, since sequential backups of the same disk will share storage.
      */
     downloadBytes?: string | null;
+    /**
+     * Immutable. KMS key name used for data encryption.
+     */
+    kmsKey?: string | null;
     /**
      * Resource labels to represent user provided metadata.
      */
@@ -253,9 +257,12 @@ export namespace file_v1 {
      */
     sourceBackup?: string | null;
   }
+  /**
+   * Instance represents the interface for SLM services to actuate the state of control plane resources. Example Instance in JSON, where consumer-project-number=123456, producer-project-id=cloud-sql: ```json Instance: { "name": "projects/123456/locations/us-east1/instances/prod-instance", "create_time": { "seconds": 1526406431, \}, "labels": { "env": "prod", "foo": "bar" \}, "state": READY, "software_versions": { "software_update": "cloud-sql-09-28-2018", \}, "maintenance_policy_names": { "UpdatePolicy": "projects/123456/locations/us-east1/maintenancePolicies/prod-update-policy", \} "tenant_project_id": "cloud-sql-test-tenant", "producer_metadata": { "cloud-sql-tier": "basic", "cloud-sql-instance-size": "1G", \}, "provisioned_resources": [ { "resource-type": "compute-instance", "resource-url": "https://www.googleapis.com/compute/v1/projects/cloud-sql/zones/us-east1-b/instances/vm-1", \} ], "maintenance_schedules": { "csa_rollout": { "start_time": { "seconds": 1526406431, \}, "end_time": { "seconds": 1535406431, \}, \}, "ncsa_rollout": { "start_time": { "seconds": 1526406431, \}, "end_time": { "seconds": 1535406431, \}, \} \}, "consumer_defined_name": "my-sql-instance1", \} ``` LINT.IfChange
+   */
   export interface Schema$GoogleCloudSaasacceleratorManagementProvidersV1Instance {
     /**
-     * consumer_defined_name is the name that is set by the consumer. On the other hand Name field represents system-assigned id of an instance so consumers are not necessarily aware of it. consumer_defined_name is used for notification/UI purposes for consumer to recognize their instances.
+     * consumer_defined_name is the name of the instance set by the service consumers. Generally this is different from the `name` field which reperesents the system-assigned id of the instance which the service consumers do not recognize. This is a required field for tenants onboarding to Maintenance Window notifications (go/slm-rollout-maintenance-policies#prerequisites).
      */
     consumerDefinedName?: string | null;
     /**
@@ -271,7 +278,7 @@ export namespace file_v1 {
      */
     labels?: {[key: string]: string} | null;
     /**
-     * Optional. Deprecated. The MaintenancePolicies that have been attached to the instance. The key must be of the type name of the oneof policy name defined in MaintenancePolicy, and the referenced policy must define the same policy type. For complete details of MaintenancePolicy, please refer to go/cloud-saas-mw-ug.
+     * Optional. The MaintenancePolicies that have been attached to the instance. The key must be of the type name of the oneof policy name defined in MaintenancePolicy, and the referenced policy must define the same policy type. For details, please refer to go/cloud-saas-mw-ug. Should not be set if maintenance_settings.maintenance_policies is set.
      */
     maintenancePolicyNames?: {[key: string]: string} | null;
     /**
@@ -369,7 +376,7 @@ export namespace file_v1 {
      */
     isRollback?: boolean | null;
     /**
-     * Optional. The MaintenancePolicies that have been attached to the instance. The key must be of the type name of the oneof policy name defined in MaintenancePolicy, and the embedded policy must define the same policy type. For complete details of MaintenancePolicy, please refer to go/cloud-saas-mw-ug. If only the name is needed, then only populate MaintenancePolicy.name.
+     * Optional. The MaintenancePolicies that have been attached to the instance. The key must be of the type name of the oneof policy name defined in MaintenancePolicy, and the embedded policy must define the same policy type. For details, please refer to go/cloud-saas-mw-ug. Should not be set if maintenance_policy_names is set. If only the name is needed, then only populate MaintenancePolicy.name.
      */
     maintenancePolicies?: {[key: string]: Schema$MaintenancePolicy} | null;
   }
@@ -1262,6 +1269,7 @@ export namespace file_v1 {
      *       //   "createTime": "my_createTime",
      *       //   "description": "my_description",
      *       //   "downloadBytes": "my_downloadBytes",
+     *       //   "kmsKey": "my_kmsKey",
      *       //   "labels": {},
      *       //   "name": "my_name",
      *       //   "satisfiesPzs": false,
@@ -1544,6 +1552,7 @@ export namespace file_v1 {
      *   //   "createTime": "my_createTime",
      *   //   "description": "my_description",
      *   //   "downloadBytes": "my_downloadBytes",
+     *   //   "kmsKey": "my_kmsKey",
      *   //   "labels": {},
      *   //   "name": "my_name",
      *   //   "satisfiesPzs": false,
@@ -1825,6 +1834,7 @@ export namespace file_v1 {
      *       //   "createTime": "my_createTime",
      *       //   "description": "my_description",
      *       //   "downloadBytes": "my_downloadBytes",
+     *       //   "kmsKey": "my_kmsKey",
      *       //   "labels": {},
      *       //   "name": "my_name",
      *       //   "satisfiesPzs": false,