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: https://github.com/googleapis/googleapis-gen/commit/935fadefeae60e94051bdfc9ff60a946734b7abf 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]

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",

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",

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

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

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

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

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

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",

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.
 

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):