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

gcloud auth application-default login/google-cloud-sdk/lib/surface/fault_injection/__init__.py

@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+"""The command group for the Fault Injection Testing CLI."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+@base.Hidden
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class Faultinjectiontesting(base.Group):
+  """Manage Apphub resources."""
+
+  # See third_party/py/googlecloudsdk/calliope/base.py for a list of categories.
+  category = base.MANAGEMENT_TOOLS_CATEGORY

gcloud auth application-default login/google-cloud-sdk/lib/surface/fault_injection/experiments/__init__.py

@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+"""The command group for the Fault injection testing CLI."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+@base.Hidden
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class Experiments(base.Group):
+  """Manage Apphub resources."""
+
+  # See third_party/py/googlecloudsdk/calliope/base.py for a list of categories.
+  category = base.MANAGEMENT_TOOLS_CATEGORY

gcloud auth application-default login/google-cloud-sdk/lib/surface/fault_injection/experiments/create.py

@@ -0,0 +1,64 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+"""Command to create a experiment in the Project/Location."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.fault_injection import experiments
+from googlecloudsdk.calliope import base
+from googlecloudsdk.calliope import exceptions
+from googlecloudsdk.command_lib.fault_injection import flags
+
+
+_DETAILED_HELP = {
+    'DESCRIPTION': '{description}',
+    'EXAMPLES': """ \
+        To create a experiment with the id `my-experiment` and file path `my/path/to/yaml`, run:
+
+          $ {command} my-experiment --file=my/path/to/yaml
+        """,
+}
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class Create(base.CreateCommand):
+  """Command to create a experiment in the Project/Location."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    flags.AddCreateExperimentFlags(parser)
+
+  def Run(self, args):
+    """Run the create command."""
+    client = experiments.ExperimentsClient()
+    exp_ref = args.CONCEPTS.experiment.Parse()
+    parent_ref = exp_ref.Parent()
+    if not exp_ref.Name():
+      raise exceptions.InvalidArgumentException(
+          'experiment', 'experiment id must be non-empty.'
+      )
+    if not args.file:
+      raise exceptions.InvalidArgumentException(
+          'experiment', 'file path must be non-empty.'
+      )
+    return client.Create(
+        experiment=exp_ref.Name(),
+        experiment_config=args.file,
+        parent=parent_ref.RelativeName(),
+    )

gcloud auth application-default login/google-cloud-sdk/lib/surface/fault_injection/experiments/delete.py

@@ -0,0 +1,55 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+"""Command to delete a Experiment in the Project/Location."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.fault_injection import experiments
+from googlecloudsdk.calliope import base
+from googlecloudsdk.calliope import exceptions
+from googlecloudsdk.command_lib.fault_injection import flags
+
+
+_DETAILED_HELP = {
+    'DESCRIPTION': '{description}',
+    'EXAMPLES': """ \
+        To delete a experiment with the id `my-experiment`, run:
+
+          $ {command} my-experiment
+        """,
+}
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class Delete(base.DeleteCommand):
+  """Delete Experiment."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    flags.AddDeleteExperimentFlags(parser)
+
+  def Run(self, args):
+    """Run the describe command."""
+    client = experiments.ExperimentsClient()
+    exp_ref = args.CONCEPTS.experiment.Parse()
+    if not exp_ref.Name():
+      raise exceptions.InvalidArgumentException(
+          'experiment', 'experiment id must be non-empty.'
+      )
+    return client.Delete(experiment=exp_ref.RelativeName())

gcloud auth application-default login/google-cloud-sdk/lib/surface/fault_injection/experiments/describe.py

@@ -0,0 +1,55 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+"""Command to describe a Experiment in the Project/Location."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.fault_injection import experiments
+from googlecloudsdk.calliope import base
+from googlecloudsdk.calliope import exceptions
+from googlecloudsdk.command_lib.fault_injection import flags
+
+
+_DETAILED_HELP = {
+    'DESCRIPTION': '{description}',
+    'EXAMPLES': """ \
+        to describe a experiment with the id `my-experiment`, run:
+
+          $ {command} my-experiment
+        """,
+}
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class Describe(base.DescribeCommand):
+  """Describe Experiment."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    flags.AddDescribeExperimentFlags(parser)
+
+  def Run(self, args):
+    """Run the describe command."""
+    client = experiments.ExperimentsClient()
+    exp_ref = args.CONCEPTS.experiment.Parse()
+    if not exp_ref.Name():
+      raise exceptions.InvalidArgumentException(
+          'experiment', 'experiment id must be non-empty.'
+      )
+    return client.Describe(experiment=exp_ref.RelativeName())

gcloud auth application-default login/google-cloud-sdk/lib/surface/fault_injection/experiments/list.py

@@ -0,0 +1,66 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+"""Command to List experiments in the Project/Location."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.fault_injection import experiments
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.fault_injection import flags
+
+
+_DETAILED_HELP = {
+    'DESCRIPTION': '{description}',
+    'EXAMPLES': """ \
+        To List all experiments, run:
+
+          $ {command}
+        """,
+}
+
+_FORMAT = """
+  table(
+    name.scope("experiments"):label=NAME,
+    name.scope("projects").segment(1):label=PROJECT,
+    name.scope("locations").segment(0):label=LOCATION,
+    description,
+    runFaults:label=FAULTS,
+    createTime.date(unit=1000, tz_default=UTC)
+  )
+"""
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class List(base.ListCommand):
+  """List Experiments."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    flags.AddListExperimentFlags(parser)
+    parser.display_info.AddFormat(_FORMAT)
+
+  def Run(self, args):
+    """Run the list command."""
+    client = experiments.ExperimentsClient()
+    location_ref = args.CONCEPTS.location.Parse()
+    return client.List(
+        limit=args.limit,
+        page_size=args.page_size,
+        parent=location_ref.RelativeName(),
+    )

gcloud auth application-default login/google-cloud-sdk/lib/surface/fault_injection/experiments/update.py

@@ -0,0 +1,62 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+"""Command to update a experiment in the Project/Location."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.fault_injection import experiments
+from googlecloudsdk.calliope import base
+from googlecloudsdk.calliope import exceptions
+from googlecloudsdk.command_lib.fault_injection import flags
+
+
+_DETAILED_HELP = {
+    'DESCRIPTION': '{description}',
+    'EXAMPLES': """ \
+        To update a experiment with the id `my-experiment` and file path `my/path/to/yaml`, run:
+
+          $ {command} my-experiment --file=my/path/to/yaml
+        """,
+}
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class Update(base.UpdateCommand):
+  """Command to update a experiment in the Project/Location."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    flags.AddUpdateExperimentFlags(parser)
+
+  def Run(self, args):
+    """Run the create command."""
+    client = experiments.ExperimentsClient()
+    exp_ref = args.CONCEPTS.experiment.Parse()
+    if not exp_ref.Name():
+      raise exceptions.InvalidArgumentException(
+          'experiment', 'experiment id must be non-empty.'
+      )
+    if not args.file:
+      raise exceptions.InvalidArgumentException(
+          'experiment', 'file path must be non-empty.'
+      )
+    return client.Update(
+        experiment=exp_ref.RelativeName(),
+        experiment_config=args.file,
+    )

gcloud auth application-default login/google-cloud-sdk/lib/surface/fault_injection/faults/__init__.py

@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+"""The command group for the Fault injection testing CLI."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+@base.Hidden
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class Faults(base.Group):
+  """Manage Apphub resources."""
+
+  # See third_party/py/googlecloudsdk/calliope/base.py for a list of categories.
+  category = base.MANAGEMENT_TOOLS_CATEGORY

gcloud auth application-default login/google-cloud-sdk/lib/surface/fault_injection/faults/create.py

@@ -0,0 +1,64 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+"""Create Command for fault."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.fault_injection import faults
+from googlecloudsdk.calliope import base
+from googlecloudsdk.calliope import exceptions
+from googlecloudsdk.command_lib.fault_injection import flags
+
+
+_DETAILED_HELP = {
+    'DESCRIPTION': '{description}',
+    'EXAMPLES': """ \
+        To create a fault with the id `my-fault` and file path `my/path/to/yaml`, run:
+
+          $ {command} my-fault --file=my/path/to/yaml
+        """,
+}
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class Create(base.CreateCommand):
+  """Command to create a fault in the Project/Location."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    flags.AddCreateFaultFlags(parser)
+
+  def Run(self, args):
+    """Run the create command."""
+    client = faults.FaultsClient()
+    fault_ref = args.CONCEPTS.fault.Parse()
+    parent_ref = fault_ref.Parent()
+    if not fault_ref.Name():
+      raise exceptions.InvalidArgumentException(
+          'fault', 'fault id must be non-empty.'
+      )
+    if not args.file:
+      raise exceptions.InvalidArgumentException(
+          'fault', 'file must be non-empty.'
+      )
+    return client.Create(
+        fault=fault_ref.Name(),
+        faultconfig=args.file,
+        parent=parent_ref.RelativeName(),
+    )

gcloud auth application-default login/google-cloud-sdk/lib/surface/fault_injection/faults/delete.py

@@ -0,0 +1,54 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+"""Command to delete a Fault in the Project/Location."""
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.fault_injection import faults
+from googlecloudsdk.calliope import base
+from googlecloudsdk.calliope import exceptions
+from googlecloudsdk.command_lib.fault_injection import flags
+
+
+_DETAILED_HELP = {
+    'DESCRIPTION': '{description}',
+    'EXAMPLES': """ \
+        to delete a fault with the id `my-fault`, run:
+
+          $ {command} my-fault
+        """,
+}
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class Delete(base.DeleteCommand):
+  """Delete Faults."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    flags.AddDeleteFaultFlags(parser)
+
+  def Run(self, args):
+    """Run the describe command."""
+    client = faults.FaultsClient()
+    fault_ref = args.CONCEPTS.fault.Parse()
+    if not fault_ref.Name():
+      raise exceptions.InvalidArgumentException(
+          'fault', 'fault id must be non-empty.'
+      )
+    return client.Delete(fault=fault_ref.RelativeName())

gcloud auth application-default login/google-cloud-sdk/lib/surface/fault_injection/faults/describe.py

@@ -0,0 +1,53 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+"""Command to describe a Fault in the Project/Location."""
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.fault_injection import faults
+from googlecloudsdk.calliope import base
+from googlecloudsdk.calliope import exceptions
+from googlecloudsdk.command_lib.fault_injection import flags
+
+
+_DETAILED_HELP = {
+    'DESCRIPTION': '{description}',
+    'EXAMPLES': """ \
+        to describe a fault with the id `my-fault`, run:
+
+          $ {command} my-fault
+        """,
+}
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class Describe(base.DescribeCommand):
+  """Describe Faults."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    flags.AddDescribeFaultFlags(parser)
+
+  def Run(self, args):
+    """Run the describe command."""
+    client = faults.FaultsClient()
+    fault_ref = args.CONCEPTS.fault.Parse()
+    if not fault_ref.Name():
+      raise exceptions.InvalidArgumentException(
+          'fault', 'fault id must be non-empty.')
+    return client.Describe(fault=fault_ref.RelativeName())

gcloud auth application-default login/google-cloud-sdk/lib/surface/fault_injection/faults/list.py

@@ -0,0 +1,65 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+"""Command to describe a Fault in the Project/Location."""
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.fault_injection import faults
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.fault_injection import flags
+
+
+_DETAILED_HELP = {
+    'DESCRIPTION': '{description}',
+    'EXAMPLES': """ \
+        To List all faults, run:
+
+          $ {command}
+        """,
+}
+
+_FORMAT = """
+  table(
+    name.scope("faults"):label=NAME,
+    name.scope("projects").segment(1):label=PROJECT,
+    name.scope("locations").segment(0):label=LOCATION,
+    description,
+    action,
+    createTime.date(unit=1000, tz_default=UTC)
+  )
+"""
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class List(base.ListCommand):
+  """List Faults."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    flags.AddListFaultFlags(parser)
+    parser.display_info.AddFormat(_FORMAT)
+
+  def Run(self, args):
+    """Run the list command."""
+    client = faults.FaultsClient()
+    location_ref = args.CONCEPTS.location.Parse()
+    return client.List(
+        limit=args.limit,
+        page_size=args.page_size,
+        parent=location_ref.RelativeName(),
+    )

gcloud auth application-default login/google-cloud-sdk/lib/surface/fault_injection/faults/update.py

@@ -0,0 +1,62 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+"""Command to update a fault in the Project/Location."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.fault_injection import faults
+from googlecloudsdk.calliope import base
+from googlecloudsdk.calliope import exceptions
+from googlecloudsdk.command_lib.fault_injection import flags
+
+
+_DETAILED_HELP = {
+    'DESCRIPTION': '{description}',
+    'EXAMPLES': """ \
+        To update a fault with the id `my-fault` and file path `my/path/to/yaml`, run:
+
+          $ {command} my-fault --file=my/path/to/yaml
+        """,
+}
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class Update(base.UpdateCommand):
+  """Command to update a fault in the Project/Location."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    flags.AddUpdateFaultFlags(parser)
+
+  def Run(self, args):
+    """Run the create command."""
+    client = faults.FaultsClient()
+    fault_ref = args.CONCEPTS.fault.Parse()
+    if not fault_ref.Name():
+      raise exceptions.InvalidArgumentException(
+          'fault', 'fault id must be non-empty.'
+      )
+    if not args.file:
+      raise exceptions.InvalidArgumentException(
+          'fault', 'file must be non-empty.'
+      )
+    return client.Update(
+        fault=fault_ref.RelativeName(),
+        faultconfig=args.file,
+    )

gcloud auth application-default login/google-cloud-sdk/lib/surface/fault_injection/jobs/__init__.py

@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+"""The command group for the Fault injection testing CLI."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+@base.Hidden
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class Jobs(base.Group):
+  """Manage Fault injection testing resources."""
+
+  # See third_party/py/googlecloudsdk/calliope/base.py for a list of categories.
+  category = base.MANAGEMENT_TOOLS_CATEGORY

gcloud auth application-default login/google-cloud-sdk/lib/surface/fault_injection/jobs/create.py

@@ -0,0 +1,113 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+"""Create Command for Job."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.fault_injection import jobs
+from googlecloudsdk.calliope import base
+from googlecloudsdk.calliope import exceptions
+from googlecloudsdk.command_lib.fault_injection import flags
+from googlecloudsdk.core import resources
+
+
+_DETAILED_HELP = {
+    'DESCRIPTION': '{description}',
+    'EXAMPLES': """ \
+        To create a Job with the id `my-job` experiment `my-experiment`
+        and fault-targets `target1 and target2`, run:
+
+          $ {command} my-job --experiment=my-experiment --fault-targets="target1", "target2"
+        """,
+}
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class Create(base.CreateCommand):
+  """Create a Fault injection testing job."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    flags.AddCreateJobFlags(parser)
+
+  @staticmethod
+  def ParseResourceArgs(args):
+    """Parse, validate and return the CA and KMS key version args from the CLI.
+
+    Args:
+      args: The parsed arguments from the command-line.
+
+    Returns:
+      Tuple containing the Resource objects for the KMS key version and CA,
+      respectively.
+    """
+    job_ref = args.CONCEPTS.job.Parse()
+    # TODO(b/149316889): Use concepts library once attribute fallthroughs work.
+    exp_ref = resources.REGISTRY.Parse(
+        args.experiment,
+        collection='faultinjectiontesting.projects.locations.experiments',
+        params={
+            'projectsId': job_ref.projectsId,
+            'locationsId': job_ref.locationsId,
+        },
+    )
+
+    if exp_ref.projectsId != job_ref.projectsId:
+      raise exceptions.InvalidArgumentException(
+          'Experiment',
+          'Experiment must be in the same project as the JOB'
+          'version.',
+      )
+
+    if exp_ref.locationsId != job_ref.locationsId:
+      raise exceptions.InvalidArgumentException(
+          'Experiment',
+          'Experiment must be in the same location as the Job'
+          'version.',
+      )
+
+    return (job_ref, exp_ref)
+
+  def Run(self, args):
+    """Run the create command."""
+    client = jobs.JobsClient()
+    # job_ref = args.CONCEPTS.job.Parse()
+    # exp_ref = args.CONCEPTS.experiment.Parse()
+    job_ref, exp_ref = self.ParseResourceArgs(args)
+    parent_ref = job_ref.Parent()
+    if not job_ref.Name():
+      raise exceptions.InvalidArgumentException(
+          'job', 'job id must be non-empty.'
+      )
+    if not exp_ref.Name():
+      raise exceptions.InvalidArgumentException(
+          'job', 'experiment must be non-empty.'
+      )
+    if not args.fault_targets:
+      raise exceptions.InvalidArgumentException(
+          'job', 'fault targets must be non-empty.'
+      )
+    # if args.fault_targets.
+    return client.Create(
+        job_id=job_ref.Name(),
+        experiment_id=exp_ref.RelativeName(),
+        fault_targets=args.fault_targets,
+        dry_run=args.dry_run,
+        parent=parent_ref.RelativeName(),
+    )

gcloud auth application-default login/google-cloud-sdk/lib/surface/fault_injection/jobs/delete.py

@@ -0,0 +1,54 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+"""Command to delete a Fault in the Project/Location."""
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.fault_injection import jobs
+from googlecloudsdk.calliope import base
+from googlecloudsdk.calliope import exceptions
+from googlecloudsdk.command_lib.fault_injection import flags
+
+
+_DETAILED_HELP = {
+    'DESCRIPTION': '{description}',
+    'EXAMPLES': """ \
+        To delete a job with the id `my-job`, run:
+
+          $ {command} my-job
+        """,
+}
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class Delete(base.DeleteCommand):
+  """Delete a Fault injection testing job."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    flags.AddDeleteJobFlags(parser)
+
+  def Run(self, args):
+    """Run the describe command."""
+    client = jobs.JobsClient()
+    job_ref = args.CONCEPTS.job.Parse()
+    if not job_ref.Name():
+      raise exceptions.InvalidArgumentException(
+          'job', 'job name must be non-empty.'
+      )
+    return client.Delete(job=job_ref.RelativeName())

gcloud auth application-default login/google-cloud-sdk/lib/surface/fault_injection/jobs/describe.py

@@ -0,0 +1,54 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+"""Describe Command for Job."""
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.fault_injection import jobs
+from googlecloudsdk.calliope import base
+from googlecloudsdk.calliope import exceptions
+from googlecloudsdk.command_lib.fault_injection import flags
+
+
+_DETAILED_HELP = {
+    'DESCRIPTION': '{description}',
+    'EXAMPLES': """ \
+        To describe a job with the id `my-job`, run:
+
+          $ {command} my-job
+        """,
+}
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class Describe(base.DescribeCommand):
+  """Describe a Fault injection testing job."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    flags.AddDescribeJobFlags(parser)
+
+  def Run(self, args):
+    """Run the describe command."""
+    client = jobs.JobsClient()
+    job_ref = args.CONCEPTS.job.Parse()
+    if not job_ref.Name():
+      raise exceptions.InvalidArgumentException(
+          'job', 'job id must be non-empty.'
+      )
+    return client.Describe(job=job_ref.RelativeName())

gcloud auth application-default login/google-cloud-sdk/lib/surface/fault_injection/jobs/list.py

@@ -0,0 +1,67 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+"""Command to List Jobs in the Project/Location."""
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.fault_injection import jobs
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.fault_injection import flags
+
+
+_DETAILED_HELP = {
+    'DESCRIPTION': '{description}',
+    'EXAMPLES': """ \
+        To List all jobs, run:
+
+          $ {command}
+        """,
+}
+
+_FORMAT = """
+  table(
+    name.scope("jobs"):label=NAME,
+    name.scope("projects").segment(1):label=PROJECT,
+    name.scope("locations").segment(0):label=LOCATION,
+    description,
+    experimentSnapshot,
+    faultPepStatuses,
+    faultTargets,
+    createTime.date(unit=1000, tz_default=UTC)
+  )
+"""
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class List(base.ListCommand):
+  """List Fault injection testing jobs."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    flags.AddListJobFlags(parser)
+    parser.display_info.AddFormat(_FORMAT)
+
+  def Run(self, args):
+    """Run the list command."""
+    client = jobs.JobsClient()
+    location_ref = args.CONCEPTS.location.Parse()
+    return client.List(
+        limit=args.limit,
+        page_size=args.page_size,
+        parent=location_ref.RelativeName(),
+    )