google-api-python-client 2.85.0__py2.py3-none-any.whl → 2.87.0__py2.py3-none-any.whl

googleapiclient/discovery_cache/documents/contactcenteraiplatform.v1alpha1.json

@@ -512,7 +512,7 @@
       }
     }
   },
-  "revision": "20230329",
+  "revision": "20230503",
   "rootUrl": "https://contactcenteraiplatform.googleapis.com/",
   "schemas": {
     "AdminUser": {
@@ -627,14 +627,21 @@
       "id": "ContactCenterQuota",
       "properties": {
         "contactCenterCountLimit": {
-          "description": "Reflects the count limit of contact centers on a billing account.",
+          "description": "Deprecated: Use the Quota fields instead. Reflects the count limit of contact centers on a billing account.",
           "format": "int32",
           "type": "integer"
         },
         "contactCenterCountSum": {
-          "description": "Reflects the count sum of contact centers on a billing account.",
+          "description": "Deprecated: Use the Quota fields instead. Reflects the count sum of contact centers on a billing account.",
           "format": "int32",
           "type": "integer"
+        },
+        "quotas": {
+          "description": "Quota details per contact center instance type.",
+          "items": {
+            "$ref": "Quota"
+          },
+          "type": "array"
         }
       },
       "type": "object"
@@ -736,7 +743,7 @@
       "type": "object"
     },
     "Location": {
-      "description": "A resource that represents Google Cloud Platform location.",
+      "description": "A resource that represents a Google Cloud location.",
       "id": "Location",
       "properties": {
         "displayName": {
@@ -852,6 +859,45 @@
       },
       "type": "object"
     },
+    "Quota": {
+      "description": "Quota details.",
+      "id": "Quota",
+      "properties": {
+        "contactCenterCountLimit": {
+          "description": "Reflects the count limit of contact centers on a billing account.",
+          "format": "int32",
+          "type": "integer"
+        },
+        "contactCenterCountSum": {
+          "description": "Reflects the count sum of contact centers on a billing account.",
+          "format": "int32",
+          "type": "integer"
+        },
+        "contactCenterInstanceSize": {
+          "description": "Contact center instance type.",
+          "enum": [
+            "INSTANCE_SIZE_UNSPECIFIED",
+            "STANDARD_SMALL",
+            "STANDARD_MEDIUM",
+            "STANDARD_LARGE",
+            "STANDARD_XLARGE",
+            "STANDARD_2XLARGE",
+            "STANDARD_3XLARGE"
+          ],
+          "enumDescriptions": [
+            "The default value. This value is used if the state is omitted.",
+            "Instance Size STANDARD_SMALL.",
+            "Instance Size STANDARD_MEDIUM.",
+            "Instance Size STANDARD_LARGE.",
+            "Instance Size STANDARD_XLARGE.",
+            "Instance Size STANDARD_2XLARGE.",
+            "Instance Size STANDARD_3XLARGE."
+          ],
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "SAMLParams": {
       "description": "Message storing SAML params to enable Google as IDP.",
       "id": "SAMLParams",

googleapiclient/discovery_cache/documents/contactcenterinsights.v1.json

@@ -1384,7 +1384,7 @@
       }
     }
   },
-  "revision": "20230402",
+  "revision": "20230515",
   "rootUrl": "https://contactcenterinsights.googleapis.com/",
   "schemas": {
     "GoogleCloudContactcenterinsightsV1Analysis": {
@@ -1543,6 +1543,37 @@
         "runSilenceAnnotator": {
           "description": "Whether to run the silence annotator.",
           "type": "boolean"
+        },
+        "runSummarizationAnnotator": {
+          "description": "Whether to run the summarization annotator.",
+          "type": "boolean"
+        },
+        "summarizationConfig": {
+          "$ref": "GoogleCloudContactcenterinsightsV1AnnotatorSelectorSummarizationConfig",
+          "description": "Configuration for the summarization annotator."
+        }
+      },
+      "type": "object"
+    },
+    "GoogleCloudContactcenterinsightsV1AnnotatorSelectorSummarizationConfig": {
+      "description": "Configuration for summarization.",
+      "id": "GoogleCloudContactcenterinsightsV1AnnotatorSelectorSummarizationConfig",
+      "properties": {
+        "conversationProfile": {
+          "description": "Resource name of the Dialogflow conversation profile. Format: projects/{project}/locations/{location}/conversationProfiles/{conversation_profile}",
+          "type": "string"
+        },
+        "summarizationModel": {
+          "description": "Default summarization model to be used.",
+          "enum": [
+            "SUMMARIZATION_MODEL_UNSPECIFIED",
+            "BASELINE_MODEL"
+          ],
+          "enumDescriptions": [
+            "Unspecified summarization model.",
+            "The Insights baseline model."
+          ],
+          "type": "string"
         }
       },
       "type": "object"
@@ -1903,6 +1934,11 @@
           "description": "Output only. The conversation's latest analysis, if one exists.",
           "readOnly": true
         },
+        "latestSummary": {
+          "$ref": "GoogleCloudContactcenterinsightsV1ConversationSummarizationSuggestionData",
+          "description": "Output only. Latest summary of the conversation.",
+          "readOnly": true
+        },
         "medium": {
           "description": "Immutable. The conversation medium, if unspecified will default to PHONE_CALL.",
           "enum": [
@@ -2052,6 +2088,44 @@
       },
       "type": "object"
     },
+    "GoogleCloudContactcenterinsightsV1ConversationSummarizationSuggestionData": {
+      "description": "Conversation summarization suggestion data.",
+      "id": "GoogleCloudContactcenterinsightsV1ConversationSummarizationSuggestionData",
+      "properties": {
+        "answerRecord": {
+          "description": "The name of the answer record. Format: projects/{project}/locations/{location}/answerRecords/{answer_record}",
+          "type": "string"
+        },
+        "confidence": {
+          "description": "The confidence score of the summarization.",
+          "format": "float",
+          "type": "number"
+        },
+        "conversationModel": {
+          "description": "The name of the model that generates this summary. Format: projects/{project}/locations/{location}/conversationModels/{conversation_model}",
+          "type": "string"
+        },
+        "metadata": {
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "A map that contains metadata about the summarization and the document from which it originates.",
+          "type": "object"
+        },
+        "text": {
+          "description": "The summarization content that is concatenated into one string.",
+          "type": "string"
+        },
+        "textSections": {
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "The summarization content that is divided into sections. The key is the section's name and the value is the section's content. There is no specific format for the key or value.",
+          "type": "object"
+        }
+      },
+      "type": "object"
+    },
     "GoogleCloudContactcenterinsightsV1ConversationTranscript": {
       "description": "A message representing the transcript of a conversation.",
       "id": "GoogleCloudContactcenterinsightsV1ConversationTranscript",
@@ -3129,7 +3203,7 @@
       "id": "GoogleCloudContactcenterinsightsV1PhraseMatchRuleGroup",
       "properties": {
         "phraseMatchRules": {
-          "description": "A list of phase match rules that are included in this group.",
+          "description": "A list of phrase match rules that are included in this group.",
           "items": {
             "$ref": "GoogleCloudContactcenterinsightsV1PhraseMatchRule"
           },
@@ -3268,6 +3342,10 @@
           "$ref": "GoogleCloudContactcenterinsightsV1ArticleSuggestionData",
           "description": "Agent Assist Article Suggestion data."
         },
+        "conversationSummarizationSuggestion": {
+          "$ref": "GoogleCloudContactcenterinsightsV1ConversationSummarizationSuggestionData",
+          "description": "Conversation summarization suggestion data."
+        },
         "createTime": {
           "description": "The time at which this annotation was created.",
           "format": "google-datetime",
@@ -3729,6 +3807,37 @@
         "runSilenceAnnotator": {
           "description": "Whether to run the silence annotator.",
           "type": "boolean"
+        },
+        "runSummarizationAnnotator": {
+          "description": "Whether to run the summarization annotator.",
+          "type": "boolean"
+        },
+        "summarizationConfig": {
+          "$ref": "GoogleCloudContactcenterinsightsV1alpha1AnnotatorSelectorSummarizationConfig",
+          "description": "Configuration for the summarization annotator."
+        }
+      },
+      "type": "object"
+    },
+    "GoogleCloudContactcenterinsightsV1alpha1AnnotatorSelectorSummarizationConfig": {
+      "description": "Configuration for summarization.",
+      "id": "GoogleCloudContactcenterinsightsV1alpha1AnnotatorSelectorSummarizationConfig",
+      "properties": {
+        "conversationProfile": {
+          "description": "Resource name of the Dialogflow conversation profile. Format: projects/{project}/locations/{location}/conversationProfiles/{conversation_profile}",
+          "type": "string"
+        },
+        "summarizationModel": {
+          "description": "Default summarization model to be used.",
+          "enum": [
+            "SUMMARIZATION_MODEL_UNSPECIFIED",
+            "BASELINE_MODEL"
+          ],
+          "enumDescriptions": [
+            "Unspecified summarization model.",
+            "The Insights baseline model."
+          ],
+          "type": "string"
         }
       },
       "type": "object"
@@ -3985,6 +4094,11 @@
           "description": "Output only. The conversation's latest analysis, if one exists.",
           "readOnly": true
         },
+        "latestSummary": {
+          "$ref": "GoogleCloudContactcenterinsightsV1alpha1ConversationSummarizationSuggestionData",
+          "description": "Output only. Latest summary of the conversation.",
+          "readOnly": true
+        },
         "medium": {
           "description": "Immutable. The conversation medium, if unspecified will default to PHONE_CALL.",
           "enum": [
@@ -4134,6 +4248,44 @@
       },
       "type": "object"
     },
+    "GoogleCloudContactcenterinsightsV1alpha1ConversationSummarizationSuggestionData": {
+      "description": "Conversation summarization suggestion data.",
+      "id": "GoogleCloudContactcenterinsightsV1alpha1ConversationSummarizationSuggestionData",
+      "properties": {
+        "answerRecord": {
+          "description": "The name of the answer record. Format: projects/{project}/locations/{location}/answerRecords/{answer_record}",
+          "type": "string"
+        },
+        "confidence": {
+          "description": "The confidence score of the summarization.",
+          "format": "float",
+          "type": "number"
+        },
+        "conversationModel": {
+          "description": "The name of the model that generates this summary. Format: projects/{project}/locations/{location}/conversationModels/{conversation_model}",
+          "type": "string"
+        },
+        "metadata": {
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "A map that contains metadata about the summarization and the document from which it originates.",
+          "type": "object"
+        },
+        "text": {
+          "description": "The summarization content that is concatenated into one string.",
+          "type": "string"
+        },
+        "textSections": {
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "The summarization content that is divided into sections. The key is the section's name and the value is the section's content. There is no specific format for the key or value.",
+          "type": "object"
+        }
+      },
+      "type": "object"
+    },
     "GoogleCloudContactcenterinsightsV1alpha1ConversationTranscript": {
       "description": "A message representing the transcript of a conversation.",
       "id": "GoogleCloudContactcenterinsightsV1alpha1ConversationTranscript",
@@ -5061,6 +5213,10 @@
           "$ref": "GoogleCloudContactcenterinsightsV1alpha1ArticleSuggestionData",
           "description": "Agent Assist Article Suggestion data."
         },
+        "conversationSummarizationSuggestion": {
+          "$ref": "GoogleCloudContactcenterinsightsV1alpha1ConversationSummarizationSuggestionData",
+          "description": "Conversation summarization suggestion data."
+        },
         "createTime": {
           "description": "The time at which this annotation was created.",
           "format": "google-datetime",

googleapiclient/discovery_cache/documents/container.v1.json

@@ -447,6 +447,7 @@
                   ]
                 },
                 "setLocations": {
+                  "deprecated": true,
                   "description": "Sets the locations for a specific cluster. Deprecated. Use [projects.locations.clusters.update](https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/projects.locations.clusters/update) instead.",
                   "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}:setLocations",
                   "httpMethod": "POST",
@@ -1517,6 +1518,7 @@
                   ]
                 },
                 "locations": {
+                  "deprecated": true,
                   "description": "Sets the locations for a specific cluster. Deprecated. Use [projects.locations.clusters.update](https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/projects.locations.clusters/update) instead.",
                   "flatPath": "v1/projects/{projectId}/zones/{zone}/clusters/{clusterId}/locations",
                   "httpMethod": "POST",
@@ -2487,7 +2489,7 @@
       }
     }
   },
-  "revision": "20230322",
+  "revision": "20230501",
   "rootUrl": "https://container.googleapis.com/",
   "schemas": {
     "AcceleratorConfig": {
@@ -2517,7 +2519,15 @@
     "AdditionalPodRangesConfig": {
       "description": "AdditionalPodRangesConfig is the configuration for additional pod secondary ranges supporting the ClusterUpdate message.",
       "id": "AdditionalPodRangesConfig",
-      "properties": {},
+      "properties": {
+        "podRangeNames": {
+          "description": "Name for pod secondary ipv4 range which has the actual range defined ahead.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        }
+      },
       "type": "object"
     },
     "AddonsConfig": {
@@ -3076,7 +3086,7 @@
         },
         "releaseChannel": {
           "$ref": "ReleaseChannel",
-          "description": "Release channel configuration."
+          "description": "Release channel configuration. If left unspecified on cluster creation and a version is specified, the cluster is enrolled in the most mature release channel where the version is available (first checking STABLE, then REGULAR, and finally RAPID). Otherwise, if no release channel configuration and no version is specified, the cluster is enrolled in the REGULAR channel with its default version."
         },
         "resourceLabels": {
           "additionalProperties": {
@@ -3251,6 +3261,10 @@
           "description": "Enable/Disable private endpoint for the cluster's master.",
           "type": "boolean"
         },
+        "desiredFleet": {
+          "$ref": "Fleet",
+          "description": "The desired fleet configuration for the cluster."
+        },
         "desiredGatewayApiConfig": {
           "$ref": "GatewayAPIConfig",
           "description": "The desired config of Gateway API on this cluster."
@@ -3589,7 +3603,7 @@
           "type": "string"
         },
         "state": {
-          "description": "Denotes the state of etcd encryption.",
+          "description": "The desired state of etcd encryption.",
           "enum": [
             "UNKNOWN",
             "ENCRYPTED",
@@ -5208,26 +5222,28 @@
             "SET_MASTER_AUTH",
             "SET_NODE_POOL_SIZE",
             "SET_NETWORK_POLICY",
-            "SET_MAINTENANCE_POLICY"
+            "SET_MAINTENANCE_POLICY",
+            "RESIZE_CLUSTER"
           ],
           "enumDescriptions": [
             "Not set.",
-            "Cluster create.",
-            "Cluster delete.",
-            "A master upgrade.",
-            "A node upgrade.",
-            "Cluster repair.",
-            "Cluster update.",
-            "Node pool create.",
-            "Node pool delete.",
-            "Set node pool management.",
-            "Automatic node pool repair.",
-            "Automatic node upgrade.",
-            "Set labels.",
-            "Set/generate master auth materials",
-            "Set node pool size.",
-            "Updates network policy for a cluster.",
-            "Set the maintenance policy."
+            "The cluster is being created. The cluster should be assumed to be unusable until the operation finishes. In the event of the operation failing, the cluster will enter the ERROR state and eventually be deleted.",
+            "The cluster is being deleted. The cluster should be assumed to be unusable as soon as this operation starts. In the event of the operation failing, the cluster will enter the ERROR state and the deletion will be automatically retried until completed.",
+            "The cluster version is being updated. Note that this includes \"upgrades\" to the same version, which are simply a recreation. This also includes [auto-upgrades](https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-upgrades#upgrading_automatically). For more details, see [documentation on cluster upgrades](https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-upgrades#cluster_upgrades).",
+            "A node pool is being updated. Despite calling this an \"upgrade\", this includes most forms of updates to node pools. This also includes [auto-upgrades](https://cloud.google.com/kubernetes-engine/docs/how-to/node-auto-upgrades). This operation sets the progress field and may be canceled. The upgrade strategy depends on [node pool configuration](https://cloud.google.com/kubernetes-engine/docs/concepts/node-pool-upgrade-strategies). The nodes are generally still usable during this operation.",
+            "A problem has been detected with the control plane and is being repaired. This operation type is initiated by GKE. For more details, see [documentation on repairs](https://cloud.google.com/kubernetes-engine/docs/concepts/maintenance-windows-and-exclusions#repairs).",
+            "The cluster is being updated. This is a broad category of operations and includes operations that only change metadata as well as those that must recreate the entire cluster. If the control plane must be recreated, this will cause temporary downtime for zonal clusters. Some features require recreating the nodes as well. Those will be recreated as separate operations and the update may not be completely functional until the node pools recreations finish. Node recreations will generally follow [maintenance policies](https://cloud.google.com/kubernetes-engine/docs/concepts/maintenance-windows-and-exclusions). Some GKE-initiated operations use this type. This includes certain types of auto-upgrades and incident mitigations.",
+            "A node pool is being created. The node pool should be assumed to be unusable until this operation finishes. In the event of an error, the node pool may be partially created. If enabled, [node autoprovisioning](https://cloud.google.com/kubernetes-engine/docs/how-to/node-auto-provisioning) may have automatically initiated such operations.",
+            "The node pool is being deleted. The node pool should be assumed to be unusable as soon as this operation starts.",
+            "The node pool's manamagent field is being updated. These operations only update metadata and may be concurrent with most other operations.",
+            "A problem has been detected with nodes and [they are being repaired](https://cloud.google.com/kubernetes-engine/docs/how-to/node-auto-repair). This operation type is initiated by GKE, typically automatically. This operation may be concurrent with other operations and there may be multiple repairs occurring on the same node pool.",
+            "Unused. Automatic node upgrade uses UPGRADE_NODES.",
+            "Unused. Updating labels uses UPDATE_CLUSTER.",
+            "Unused. Updating master auth uses UPDATE_CLUSTER.",
+            "The node pool is being resized. With the exception of resizing to or from size zero, the node pool is generally usable during this operation.",
+            "Unused. Updating network policy uses UPDATE_CLUSTER.",
+            "Unused. Updating maintenance policy uses UPDATE_CLUSTER.",
+            "The control plane is being resized. This operation type is initiated by GKE. These operations are often performed preemptively to ensure that the control plane has sufficient resources and is not typically an indication of issues. For more details, see [documentation on resizes](https://cloud.google.com/kubernetes-engine/docs/concepts/maintenance-windows-and-exclusions#repairs)."
           ],
           "type": "string"
         },
@@ -5237,7 +5253,7 @@
           "readOnly": true
         },
         "selfLink": {
-          "description": "Server-defined URL for the resource.",
+          "description": "Server-defined URI for the operation. Example: `https://container.googleapis.com/v1alpha1/projects/123/locations/us-central1/operations/operation-123`.",
           "type": "string"
         },
         "startTime": {
@@ -5268,7 +5284,7 @@
           "type": "string"
         },
         "targetLink": {
-          "description": "Server-defined URL for the target of the operation.",
+          "description": "Server-defined URI for the target of the operation. The format of this is a URI to the resource being modified (such as a cluster, node pool, or node). For node pool repairs, there may be multiple nodes being repaired, but only one will be the target. Examples: - ## `https://container.googleapis.com/v1/projects/123/locations/us-central1/clusters/my-cluster` ## `https://container.googleapis.com/v1/projects/123/zones/us-central1-c/clusters/my-cluster/nodePools/my-np` `https://container.googleapis.com/v1/projects/123/zones/us-central1-c/clusters/my-cluster/nodePools/my-np/node/my-node`",
           "type": "string"
         },
         "zone": {

googleapiclient/discovery_cache/documents/container.v1beta1.json

@@ -472,6 +472,7 @@
                   ]
                 },
                 "setLocations": {
+                  "deprecated": true,
                   "description": "Sets the locations for a specific cluster. Deprecated. Use [projects.locations.clusters.update](https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1beta1/projects.locations.clusters/update) instead.",
                   "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}:setLocations",
                   "httpMethod": "POST",
@@ -1542,6 +1543,7 @@
                   ]
                 },
                 "locations": {
+                  "deprecated": true,
                   "description": "Sets the locations for a specific cluster. Deprecated. Use [projects.locations.clusters.update](https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1beta1/projects.locations.clusters/update) instead.",
                   "flatPath": "v1beta1/projects/{projectId}/zones/{zone}/clusters/{clusterId}/locations",
                   "httpMethod": "POST",
@@ -2512,7 +2514,7 @@
       }
     }
   },
-  "revision": "20230322",
+  "revision": "20230501",
   "rootUrl": "https://container.googleapis.com/",
   "schemas": {
     "AcceleratorConfig": {
@@ -2547,7 +2549,15 @@
     "AdditionalPodRangesConfig": {
       "description": "AdditionalPodRangesConfig is the configuration for additional pod secondary ranges supporting the ClusterUpdate message.",
       "id": "AdditionalPodRangesConfig",
-      "properties": {},
+      "properties": {
+        "podRangeNames": {
+          "description": "Name for pod secondary ipv4 range which has the actual range defined ahead.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        }
+      },
       "type": "object"
     },
     "AddonsConfig": {
@@ -2574,6 +2584,10 @@
           "$ref": "GcpFilestoreCsiDriverConfig",
           "description": "Configuration for the GCP Filestore CSI driver."
         },
+        "gcsFuseCsiDriverConfig": {
+          "$ref": "GcsFuseCsiDriverConfig",
+          "description": "Configuration for the Cloud Storage Fuse CSI driver."
+        },
         "gkeBackupAgentConfig": {
           "$ref": "GkeBackupAgentConfig",
           "description": "Configuration for the Backup for GKE agent addon."
@@ -3153,7 +3167,7 @@
         },
         "releaseChannel": {
           "$ref": "ReleaseChannel",
-          "description": "Release channel configuration."
+          "description": "Release channel configuration. If left unspecified on cluster creation and a version is specified, the cluster is enrolled in the most mature release channel where the version is available (first checking STABLE, then REGULAR, and finally RAPID). Otherwise, if no release channel configuration and no version is specified, the cluster is enrolled in the REGULAR channel with its default version."
         },
         "resourceLabels": {
           "additionalProperties": {
@@ -3367,6 +3381,10 @@
           "description": "Enable/Disable private endpoint for the cluster's master.",
           "type": "boolean"
         },
+        "desiredFleet": {
+          "$ref": "Fleet",
+          "description": "The desired fleet configuration for the cluster."
+        },
         "desiredGatewayApiConfig": {
           "$ref": "GatewayAPIConfig",
           "description": "The desired config of Gateway API on this cluster."
@@ -3729,7 +3747,7 @@
           "type": "string"
         },
         "state": {
-          "description": "Denotes the state of etcd encryption.",
+          "description": "The desired state of etcd encryption.",
           "enum": [
             "UNKNOWN",
             "ENCRYPTED",
@@ -3955,6 +3973,17 @@
       },
       "type": "object"
     },
+    "GcsFuseCsiDriverConfig": {
+      "description": "Configuration for the Cloud Storage Fuse CSI driver.",
+      "id": "GcsFuseCsiDriverConfig",
+      "properties": {
+        "enabled": {
+          "description": "Whether the Cloud Storage Fuse CSI driver is enabled for this cluster.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
     "GetJSONWebKeysResponse": {
       "description": "GetJSONWebKeysResponse is a valid JSON Web Key Set as specififed in rfc 7517",
       "id": "GetJSONWebKeysResponse",
@@ -5490,26 +5519,28 @@
             "SET_MASTER_AUTH",
             "SET_NODE_POOL_SIZE",
             "SET_NETWORK_POLICY",
-            "SET_MAINTENANCE_POLICY"
+            "SET_MAINTENANCE_POLICY",
+            "RESIZE_CLUSTER"
           ],
           "enumDescriptions": [
             "Not set.",
-            "Cluster create.",
-            "Cluster delete.",
-            "A master upgrade.",
-            "A node upgrade.",
-            "Cluster repair.",
-            "Cluster update.",
-            "Node pool create.",
-            "Node pool delete.",
-            "Set node pool management.",
-            "Automatic node pool repair.",
-            "Automatic node upgrade.",
-            "Set labels.",
-            "Set/generate master auth materials",
-            "Set node pool size.",
-            "Updates network policy for a cluster.",
-            "Set the maintenance policy."
+            "The cluster is being created. The cluster should be assumed to be unusable until the operation finishes. In the event of the operation failing, the cluster will enter the ERROR state and eventually be deleted.",
+            "The cluster is being deleted. The cluster should be assumed to be unusable as soon as this operation starts. In the event of the operation failing, the cluster will enter the ERROR state and the deletion will be automatically retried until completed.",
+            "The cluster version is being updated. Note that this includes \"upgrades\" to the same version, which are simply a recreation. This also includes [auto-upgrades](https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-upgrades#upgrading_automatically). For more details, see [documentation on cluster upgrades](https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-upgrades#cluster_upgrades).",
+            "A node pool is being updated. Despite calling this an \"upgrade\", this includes most forms of updates to node pools. This also includes [auto-upgrades](https://cloud.google.com/kubernetes-engine/docs/how-to/node-auto-upgrades). This operation sets the progress field and may be canceled. The upgrade strategy depends on [node pool configuration](https://cloud.google.com/kubernetes-engine/docs/concepts/node-pool-upgrade-strategies). The nodes are generally still usable during this operation.",
+            "A problem has been detected with the control plane and is being repaired. This operation type is initiated by GKE. For more details, see [documentation on repairs](https://cloud.google.com/kubernetes-engine/docs/concepts/maintenance-windows-and-exclusions#repairs).",
+            "The cluster is being updated. This is a broad category of operations and includes operations that only change metadata as well as those that must recreate the entire cluster. If the control plane must be recreated, this will cause temporary downtime for zonal clusters. Some features require recreating the nodes as well. Those will be recreated as separate operations and the update may not be completely functional until the node pools recreations finish. Node recreations will generally follow [maintenance policies](https://cloud.google.com/kubernetes-engine/docs/concepts/maintenance-windows-and-exclusions). Some GKE-initiated operations use this type. This includes certain types of auto-upgrades and incident mitigations.",
+            "A node pool is being created. The node pool should be assumed to be unusable until this operation finishes. In the event of an error, the node pool may be partially created. If enabled, [node autoprovisioning](https://cloud.google.com/kubernetes-engine/docs/how-to/node-auto-provisioning) may have automatically initiated such operations.",
+            "The node pool is being deleted. The node pool should be assumed to be unusable as soon as this operation starts.",
+            "The node pool's manamagent field is being updated. These operations only update metadata and may be concurrent with most other operations.",
+            "A problem has been detected with nodes and [they are being repaired](https://cloud.google.com/kubernetes-engine/docs/how-to/node-auto-repair). This operation type is initiated by GKE, typically automatically. This operation may be concurrent with other operations and there may be multiple repairs occurring on the same node pool.",
+            "Unused. Automatic node upgrade uses UPGRADE_NODES.",
+            "Unused. Updating labels uses UPDATE_CLUSTER.",
+            "Unused. Updating master auth uses UPDATE_CLUSTER.",
+            "The node pool is being resized. With the exception of resizing to or from size zero, the node pool is generally usable during this operation.",
+            "Unused. Updating network policy uses UPDATE_CLUSTER.",
+            "Unused. Updating maintenance policy uses UPDATE_CLUSTER.",
+            "The control plane is being resized. This operation type is initiated by GKE. These operations are often performed preemptively to ensure that the control plane has sufficient resources and is not typically an indication of issues. For more details, see [documentation on resizes](https://cloud.google.com/kubernetes-engine/docs/concepts/maintenance-windows-and-exclusions#repairs)."
           ],
           "type": "string"
         },
@@ -5519,7 +5550,7 @@
           "readOnly": true
         },
         "selfLink": {
-          "description": "Server-defined URL for the resource.",
+          "description": "Server-defined URI for the operation. Example: `https://container.googleapis.com/v1alpha1/projects/123/locations/us-central1/operations/operation-123`.",
           "type": "string"
         },
         "startTime": {
@@ -5550,7 +5581,7 @@
           "type": "string"
         },
         "targetLink": {
-          "description": "Server-defined URL for the target of the operation.",
+          "description": "Server-defined URI for the target of the operation. The format of this is a URI to the resource being modified (such as a cluster, node pool, or node). For node pool repairs, there may be multiple nodes being repaired, but only one will be the target. Examples: - ## `https://container.googleapis.com/v1/projects/123/locations/us-central1/clusters/my-cluster` ## `https://container.googleapis.com/v1/projects/123/zones/us-central1-c/clusters/my-cluster/nodePools/my-np` `https://container.googleapis.com/v1/projects/123/zones/us-central1-c/clusters/my-cluster/nodePools/my-np/node/my-node`",
           "type": "string"
         },
         "zone": {