feat: Add new gcloud commands, API clients, and third-party libraries across various services.

gcloud auth application-default login/google-cloud-sdk/lib/googlecloudsdk/api_lib/audit_manager/__init__.py

@@ -0,0 +1,14 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2024 Google LLC. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.

gcloud auth application-default login/google-cloud-sdk/lib/googlecloudsdk/api_lib/audit_manager/audit_reports.py

@@ -0,0 +1,79 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2024 Google LLC. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Utilities for Audit Manager API, Audit Report Endpoints."""
+
+from googlecloudsdk.api_lib.audit_manager import constants
+from googlecloudsdk.api_lib.audit_manager import util
+
+
+class AuditReportsClient(object):
+  """Client for Audit Reports in Audit Manager API."""
+
+  def __init__(
+      self, api_version: constants.ApiVersion, client=None, messages=None
+  ) -> None:
+    self.client = client or util.GetClientInstance(api_version=api_version)
+    self.messages = messages or util.GetMessagesModule(
+        api_version=api_version,
+        client=client,
+    )
+
+    report_format_enum = (
+        self.messages.GenerateAuditReportRequest.ReportFormatValueValuesEnum
+    )
+    self.report_format_map = {'odf': report_format_enum.AUDIT_REPORT_FORMAT_ODF}
+
+  def Generate(
+      self,
+      scope: str,
+      compliance_framework: str,
+      report_format: str,
+      gcs_uri: str,
+      is_parent_folder: bool,
+  ):
+    """Generate an Audit Report.
+
+    Args:
+      scope: The scope for which to generate the report.
+      compliance_framework: Compliance framework against which the Report must
+        be generated.
+      report_format: The format in which the audit report should be generated.
+      gcs_uri: Destination Cloud storage bucket where report and evidence must
+        be uploaded.
+      is_parent_folder: Whether the parent is folder and not project.
+
+    Returns:
+      Described audit operation resource.
+    """
+    service = (
+        self.client.folders_locations_auditReports
+        if is_parent_folder
+        else self.client.projects_locations_auditReports
+    )
+
+    inner_req = self.messages.GenerateAuditReportRequest()
+    inner_req.complianceFramework = compliance_framework
+    inner_req.reportFormat = self.report_format_map[report_format]
+    inner_req.gcsUri = gcs_uri
+
+    req = (
+        self.messages.AuditmanagerFoldersLocationsAuditReportsGenerateRequest()
+        if is_parent_folder
+        else self.messages.AuditmanagerProjectsLocationsAuditReportsGenerateRequest()
+    )
+
+    req.scope = scope
+    req.generateAuditReportRequest = inner_req
+    return service.Generate(req)

gcloud auth application-default login/google-cloud-sdk/lib/googlecloudsdk/api_lib/audit_manager/audit_scopes.py

@@ -0,0 +1,76 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2024 Google LLC. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Utilities for Audit Manager API, Audit Scope Endpoints."""
+
+from googlecloudsdk.api_lib.audit_manager import constants
+from googlecloudsdk.api_lib.audit_manager import util
+
+
+class AuditScopesClient(object):
+  """Client for Audit Scopes in Audit Manager API."""
+
+  def __init__(
+      self, api_version: constants.ApiVersion, client=None, messages=None
+  ) -> None:
+    self.client = client or util.GetClientInstance(api_version=api_version)
+    self.messages = messages or util.GetMessagesModule(
+        api_version=api_version, client=client
+    )
+
+    scope_report_format_enum = (
+        self.messages.GenerateAuditScopeReportRequest.ReportFormatValueValuesEnum
+    )
+    self.report_format_map = {
+        'odf': scope_report_format_enum.AUDIT_SCOPE_REPORT_FORMAT_ODF
+    }
+
+  def Generate(
+      self,
+      scope: str,
+      compliance_standard: str,
+      report_format: str,
+      is_parent_folder: bool,
+  ):
+    """Generate an Audit Scope.
+
+    Args:
+      scope: The scope for which to generate the scope.
+      compliance_standard: Compliance standard against which the scope must be
+        generated.
+      report_format: The format in which the audit scope should be generated.
+      is_parent_folder: Whether the parent is folder and not project.
+
+    Returns:
+      Described audit scope resource.
+    """
+    service = (
+        self.client.folders_locations_auditScopeReports
+        if is_parent_folder
+        else self.client.projects_locations_auditScopeReports
+    )
+
+    inner_req = self.messages.GenerateAuditScopeReportRequest()
+    inner_req.complianceStandard = compliance_standard
+    inner_req.reportFormat = self.report_format_map[report_format]
+
+    req = (
+        self.messages.AuditmanagerFoldersLocationsAuditScopeReportsGenerateRequest()
+        if is_parent_folder
+        else self.messages.AuditmanagerProjectsLocationsAuditScopeReportsGenerateRequest()
+    )
+
+    req.scope = scope
+    req.generateAuditScopeReportRequest = inner_req
+    return service.Generate(req)

gcloud auth application-default login/google-cloud-sdk/lib/googlecloudsdk/api_lib/audit_manager/constants.py

@@ -0,0 +1,25 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2024 Google LLC. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Constants for Audit Manager API, Client Generation Functions."""
+
+import enum
+
+
+@enum.unique
+class ApiVersion(enum.Enum):
+  """Different allowed versions of Audit Manager API."""
+
+  V1 = 'v1'
+  V1_ALPHA = 'v1alpha'

gcloud auth application-default login/google-cloud-sdk/lib/googlecloudsdk/api_lib/audit_manager/enrollments.py

@@ -0,0 +1,80 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2024 Google LLC. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Utilities for Audit Manager API, Enrollments Endpoints."""
+
+from googlecloudsdk.api_lib.audit_manager import constants
+from googlecloudsdk.api_lib.audit_manager import util
+
+
+class EnrollmentsClient(object):
+  """Client for operations in Audit Manager API."""
+
+  def __init__(
+      self, api_version: constants.ApiVersion, client=None, messages=None
+  ) -> None:
+    self.client = client or util.GetClientInstance(api_version=api_version)
+    self.messages = messages or util.GetMessagesModule(
+        api_version=api_version, client=client
+    )
+
+  def Add(
+      self,
+      scope: str,
+      eligible_gcs_buckets: str,
+      is_parent_folder: bool,
+      is_parent_organization: bool,
+  ):
+    """Enrolls a resource to Audit Manager.
+
+    Args:
+      scope: The scope to be enrolled.
+      eligible_gcs_buckets: List of destination among which customer can choose
+        to upload their reports during the audit process.
+      is_parent_folder: Whether the parent is folder and not project.
+      is_parent_organization: Whether the parent is organization and not
+        project.
+
+    Returns:
+      Described audit operation resource.
+    """
+    if is_parent_folder:
+      service = self.client.folders_locations
+    elif is_parent_organization:
+      service = self.client.organizations_locations
+    else:
+      service = self.client.projects_locations
+
+    inner_req = self.messages.EnrollResourceRequest()
+    inner_req.destinations = list(
+        map(self.Gcs_uri_to_eligible_destination, eligible_gcs_buckets)
+    )
+
+    if is_parent_folder:
+      req = self.messages.AuditmanagerFoldersLocationsEnrollResourceRequest()
+    elif is_parent_organization:
+      req = (
+          self.messages.AuditmanagerOrganizationsLocationsEnrollResourceRequest()
+      )
+    else:
+      req = self.messages.AuditmanagerProjectsLocationsEnrollResourceRequest()
+
+    req.scope = scope
+    req.enrollResourceRequest = inner_req
+    return service.EnrollResource(req)
+
+  def Gcs_uri_to_eligible_destination(self, gcs_uri):
+    dest = self.messages.EligibleDestination()
+    dest.eligibleGcsBucket = gcs_uri
+    return dest

gcloud auth application-default login/google-cloud-sdk/lib/googlecloudsdk/api_lib/audit_manager/operations.py

@@ -0,0 +1,55 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2024 Google LLC. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Utilities for Audit Manager API, Operations Endpoints."""
+
+from googlecloudsdk.api_lib.audit_manager import constants
+from googlecloudsdk.api_lib.audit_manager import util
+
+
+class OperationsClient(object):
+  """Client for operations in Audit Manager API."""
+
+  def __init__(
+      self, api_version: constants.ApiVersion, client=None, messages=None
+  ) -> None:
+    self.client = client or util.GetClientInstance(api_version=api_version)
+    self.messages = messages or util.GetMessagesModule(
+        api_version=api_version, client=client
+    )
+
+  def Get(self, name: str, is_parent_folder: bool):
+    """Describe an Audit Manager operation.
+
+    Args:
+      name: The name of the Audit Operation being described.
+      is_parent_folder: Whether the parent is folder and not project.
+
+    Returns:
+      Described audit operation resource.
+    """
+    service = (
+        self.client.folders_locations_operationDetails
+        if is_parent_folder
+        else self.client.projects_locations_operationDetails
+    )
+
+    req = (
+        self.messages.AuditmanagerFoldersLocationsOperationDetailsGetRequest()
+        if is_parent_folder
+        else self.messages.AuditmanagerProjectsLocationsOperationDetailsGetRequest()
+    )
+
+    req.name = name
+    return service.Get(req)

gcloud auth application-default login/google-cloud-sdk/lib/googlecloudsdk/api_lib/audit_manager/util.py

@@ -0,0 +1,29 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2024 Google LLC. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Utilities for Audit Manager API, Client Generation Functions."""
+
+from googlecloudsdk.api_lib.audit_manager import constants
+from googlecloudsdk.api_lib.util import apis
+
+
+def GetClientInstance(*, api_version: constants.ApiVersion, no_http=False):
+  return apis.GetClientInstance(
+      'auditmanager', api_version.value, no_http=no_http
+  )
+
+
+def GetMessagesModule(*, api_version: constants.ApiVersion, client=None):
+  client = client or GetClientInstance(api_version=api_version)
+  return client.MESSAGES_MODULE