feat: add monitoring_config field (#234)

* feat: add `monitoring_config` field
feat: add `cluster_missing` on `GkeResource`
feat: add `google_managed` on `MembershipEndpoint`
feat: add `force` on `DeleteMembershipRequest`
docs: update API annotation

PiperOrigin-RevId: 525548423

Source-Link: googleapis/googleapis@1b897f4

Source-Link: googleapis/googleapis-gen@935fade
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiOTM1ZmFkZWZlYWU2MGU5NDA1MWJkZmM5ZmY2MGE5NDY3MzRiN2FiZiJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: gcf-owl-bot[bot]

packages/google-cloud-gke-hub/google/cloud/gkehub/__init__.py

@@ -37,6 +37,7 @@
     Membership,
     MembershipEndpoint,
     MembershipState,
+    MonitoringConfig,
     ResourceManifest,
     ResourceOptions,
 )
@@ -77,6 +78,7 @@
     "Membership",
     "MembershipEndpoint",
     "MembershipState",
+    "MonitoringConfig",
     "ResourceManifest",
     "ResourceOptions",
     "ConnectAgentResource",

packages/google-cloud-gke-hub/google/cloud/gkehub_v1/__init__.py

@@ -36,6 +36,7 @@
     Membership,
     MembershipEndpoint,
     MembershipState,
+    MonitoringConfig,
     ResourceManifest,
     ResourceOptions,
 )
@@ -89,6 +90,7 @@
     "MembershipFeatureSpec",
     "MembershipFeatureState",
     "MembershipState",
+    "MonitoringConfig",
     "OperationMetadata",
     "ResourceManifest",
     "ResourceOptions",

packages/google-cloud-gke-hub/google/cloud/gkehub_v1/services/gke_hub/async_client.py

@@ -66,7 +66,10 @@ class GkeHubAsyncClient:
     -  [Membership][google.cloud.gkehub.v1.Membership]
     -  [Feature][google.cloud.gkehub.v1.Feature]
 
-    GKE Hub is currently only available in the global region.
+    GKE Hub is currently available in the global region and all regions
+    in https://cloud.google.com/compute/docs/regions-zones. Feature is
+    only available in global region while membership is global region
+    and all the regions.
 
     **Membership management may be non-trivial:** it is recommended to
     use one of the Google-provided client libraries or tools where
@@ -270,7 +273,8 @@ async def sample_list_memberships():
             parent (:class:`str`):
                 Required. The parent (project and location) where the
                 Memberships will be listed. Specified in the format
-                ``projects/*/locations/*``.
+                ``projects/*/locations/*``. ``projects/*/locations/-``
+                list memberships in all the regions.
 
                 This corresponds to the ``parent`` field
                 on the ``request`` instance; if ``request`` is provided, this

packages/google-cloud-gke-hub/google/cloud/gkehub_v1/services/gke_hub/client.py

@@ -106,7 +106,10 @@ class GkeHubClient(metaclass=GkeHubClientMeta):
     -  [Membership][google.cloud.gkehub.v1.Membership]
     -  [Feature][google.cloud.gkehub.v1.Feature]
 
-    GKE Hub is currently only available in the global region.
+    GKE Hub is currently available in the global region and all regions
+    in https://cloud.google.com/compute/docs/regions-zones. Feature is
+    only available in global region while membership is global region
+    and all the regions.
 
     **Membership management may be non-trivial:** it is recommended to
     use one of the Google-provided client libraries or tools where
@@ -529,7 +532,8 @@ def sample_list_memberships():
             parent (str):
                 Required. The parent (project and location) where the
                 Memberships will be listed. Specified in the format
-                ``projects/*/locations/*``.
+                ``projects/*/locations/*``. ``projects/*/locations/-``
+                list memberships in all the regions.
 
                 This corresponds to the ``parent`` field
                 on the ``request`` instance; if ``request`` is provided, this

packages/google-cloud-gke-hub/google/cloud/gkehub_v1/services/gke_hub/transports/grpc.py

@@ -40,7 +40,10 @@ class GkeHubGrpcTransport(GkeHubTransport):
     -  [Membership][google.cloud.gkehub.v1.Membership]
     -  [Feature][google.cloud.gkehub.v1.Feature]
 
-    GKE Hub is currently only available in the global region.
+    GKE Hub is currently available in the global region and all regions
+    in https://cloud.google.com/compute/docs/regions-zones. Feature is
+    only available in global region while membership is global region
+    and all the regions.
 
     **Membership management may be non-trivial:** it is recommended to
     use one of the Google-provided client libraries or tools where

packages/google-cloud-gke-hub/google/cloud/gkehub_v1/services/gke_hub/transports/grpc_asyncio.py

@@ -41,7 +41,10 @@ class GkeHubGrpcAsyncIOTransport(GkeHubTransport):
     -  [Membership][google.cloud.gkehub.v1.Membership]
     -  [Feature][google.cloud.gkehub.v1.Feature]
 
-    GKE Hub is currently only available in the global region.
+    GKE Hub is currently available in the global region and all regions
+    in https://cloud.google.com/compute/docs/regions-zones. Feature is
+    only available in global region while membership is global region
+    and all the regions.
 
     **Membership management may be non-trivial:** it is recommended to
     use one of the Google-provided client libraries or tools where

packages/google-cloud-gke-hub/google/cloud/gkehub_v1/services/gke_hub/transports/rest.py

@@ -424,7 +424,10 @@ class GkeHubRestTransport(GkeHubTransport):
     -  [Membership][google.cloud.gkehub.v1.Membership]
     -  [Feature][google.cloud.gkehub.v1.Feature]
 
-    GKE Hub is currently only available in the global region.
+    GKE Hub is currently available in the global region and all regions
+    in https://cloud.google.com/compute/docs/regions-zones. Feature is
+    only available in global region while membership is global region
+    and all the regions.
 
     **Membership management may be non-trivial:** it is recommended to
     use one of the Google-provided client libraries or tools where

packages/google-cloud-gke-hub/google/cloud/gkehub_v1/types/__init__.py

@@ -30,6 +30,7 @@
     Membership,
     MembershipEndpoint,
     MembershipState,
+    MonitoringConfig,
     ResourceManifest,
     ResourceOptions,
 )
@@ -68,6 +69,7 @@
     "Membership",
     "MembershipEndpoint",
     "MembershipState",
+    "MonitoringConfig",
     "ResourceManifest",
     "ResourceOptions",
     "ConnectAgentResource",

packages/google-cloud-gke-hub/google/cloud/gkehub_v1/types/membership.py

@@ -30,6 +30,7 @@
         "ResourceManifest",
         "GkeCluster",
         "KubernetesMetadata",
+        "MonitoringConfig",
         "MembershipState",
         "Authority",
     },
@@ -65,7 +66,7 @@ class Membership(proto.Message):
             ``[a-z0-9]([-a-z0-9]*[a-z0-9])?``, with a maximum length of
             63 characters.
         labels (MutableMapping[str, str]):
-            Optional. GCP labels for this membership.
+            Optional. Labels for this membership.
         description (str):
             Output only. Description of this membership, limited to 63
             characters. Must match the regex:
@@ -111,6 +112,9 @@ class Membership(proto.Message):
             Membership. See the documentation on Workload
             Identity for more details:
             https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity
+        monitoring_config (google.cloud.gkehub_v1.types.MonitoringConfig):
+            Optional. The monitoring config information
+            for this membership.
     """
 
     endpoint: "MembershipEndpoint" = proto.Field(
@@ -170,6 +174,11 @@ class Membership(proto.Message):
         number=12,
         message="Authority",
     )
+    monitoring_config: "MonitoringConfig" = proto.Field(
+        proto.MESSAGE,
+        number=14,
+        message="MonitoringConfig",
+    )
 
 
 class MembershipEndpoint(proto.Message):
@@ -194,6 +203,10 @@ class MembershipEndpoint(proto.Message):
                Membership Authority field.
             -  Ensure proper initial configuration of default Hub
                Features.
+        google_managed (bool):
+            Output only. Whether the lifecycle of this
+            membership is managed by a google cluster
+            platform service.
     """
 
     gke_cluster: "GkeCluster" = proto.Field(
@@ -211,6 +224,10 @@ class MembershipEndpoint(proto.Message):
         number=3,
         message="KubernetesResource",
     )
+    google_managed: bool = proto.Field(
+        proto.BOOL,
+        number=8,
+    )
 
 
 class KubernetesResource(proto.Message):
@@ -346,16 +363,24 @@ class GkeCluster(proto.Message):
 
     Attributes:
         resource_link (str):
-            Immutable. Self-link of the GCP resource for
-            the GKE cluster. For example:
+            Immutable. Self-link of the Google Cloud
+            resource for the GKE cluster. For example:
+
             //container.googleapis.com/projects/my-project/locations/us-west1-a/clusters/my-cluster
             Zonal clusters are also supported.
+        cluster_missing (bool):
+            Output only. If cluster_missing is set then it denotes that
+            the GKE cluster no longer exists in the GKE Control Plane.
     """
 
     resource_link: str = proto.Field(
         proto.STRING,
         number=1,
     )
+    cluster_missing: bool = proto.Field(
+        proto.BOOL,
+        number=2,
+    )
 
 
 class KubernetesMetadata(proto.Message):
@@ -416,6 +441,60 @@ class KubernetesMetadata(proto.Message):
     )
 
 
+class MonitoringConfig(proto.Message):
+    r"""This field informs Fleet-based applications/services/UIs with
+    the necessary information for where each underlying Cluster
+    reports its metrics.
+
+    Attributes:
+        project_id (str):
+            Immutable. Project used to report Metrics
+        location (str):
+            Immutable. Location used to report Metrics
+        cluster (str):
+            Immutable. Cluster name used to report metrics. For Anthos
+            on VMWare/Baremetal, it would be in format
+            ``memberClusters/cluster_name``; And for Anthos on
+            MultiCloud, it would be in format
+            ``{azureClusters, awsClusters}/cluster_name``.
+        kubernetes_metrics_prefix (str):
+            Kubernetes system metrics, if available, are
+            written to this prefix. This defaults to
+            kubernetes.io for GKE, and kubernetes.io/anthos
+            for Anthos eventually. Noted: Anthos MultiCloud
+            will have kubernetes.io prefix today but will
+            migration to be under kubernetes.io/anthos
+        cluster_hash (str):
+            Immutable. Cluster hash, this is a unique
+            string generated by google code, which does not
+            contain any PII, which we can use to reference
+            the cluster. This is expected to be created by
+            the monitoring stack and persisted into the
+            Cluster object as well as to GKE-Hub.
+    """
+
+    project_id: str = proto.Field(
+        proto.STRING,
+        number=1,
+    )
+    location: str = proto.Field(
+        proto.STRING,
+        number=2,
+    )
+    cluster: str = proto.Field(
+        proto.STRING,
+        number=3,
+    )
+    kubernetes_metrics_prefix: str = proto.Field(
+        proto.STRING,
+        number=4,
+    )
+    cluster_hash: str = proto.Field(
+        proto.STRING,
+        number=5,
+    )
+
+
 class MembershipState(proto.Message):
     r"""MembershipState describes the state of a Membership resource.
 

packages/google-cloud-gke-hub/google/cloud/gkehub_v1/types/service.py

@@ -54,7 +54,8 @@ class ListMembershipsRequest(proto.Message):
         parent (str):
             Required. The parent (project and location) where the
             Memberships will be listed. Specified in the format
-            ``projects/*/locations/*``.
+            ``projects/*/locations/*``. ``projects/*/locations/-`` list
+            memberships in all the regions.
         page_size (int):
             Optional. When requesting a 'page' of resources,
             ``page_size`` specifies number of resources to return. If
@@ -252,6 +253,11 @@ class DeleteMembershipRequest(proto.Message):
             The request ID must be a valid UUID with the
             exception that zero UUID is not supported
             (00000000-0000-0000-0000-000000000000).
+        force (bool):
+            Optional. If set to true, any subresource
+            from this Membership will also be deleted.
+            Otherwise, the request will only work if the
+            Membership has no subresource.
     """
 
     name: str = proto.Field(
@@ -262,6 +268,10 @@ class DeleteMembershipRequest(proto.Message):
         proto.STRING,
         number=2,
     )
+    force: bool = proto.Field(
+        proto.BOOL,
+        number=3,
+    )
 
 
 class UpdateMembershipRequest(proto.Message):