Adding region tags for use on Google Cloud documentation pages + minor comments tweaks.

Author: rsamborski

compute/cloud-client/instances/src/create_instance.php

@@ -23,6 +23,7 @@
 
 namespace Google\Cloud\Samples\Compute;
 
+# [START compute_instances_create]
 use Google\Cloud\Compute\V1\InstancesClient;
 use Google\Cloud\Compute\V1\AttachedDisk;
 use Google\Cloud\Compute\V1\AttachedDiskInitializeParams;
@@ -37,11 +38,13 @@
  * ```
  *
  * @param string $projectId Your Google Cloud project ID.
- * @param string $zone The zone to create the instance in (e.g. "us-central1-a")
+ * @param string $zone The zone to create the instance in (e.g. "us-central1-a").
  * @param string $instanceName The unique name for this Compute instance.
- * @param string $machineType Instance machine type
- * @param string $sourceImage Boot disk image name or family
+ * @param string $machineType Instance machine type.
+ * @param string $sourceImage Boot disk image name or family.
  * @param string $networkName The Compute instance ID.
+ *
+ * @throws \Google\ApiCore\ApiException if the remote call fails.
  */
 function create_instance(
     string $projectId,
@@ -80,6 +83,7 @@ function create_instance(
 
     printf('Created instance %s' . PHP_EOL, $instanceName);
 }
+# [END compute_instances_create]
 
 require_once __DIR__ . '/../../../../testing/sample_helpers.php';
-\Google\Cloud\Samples\execute_sample(__FILE__, __NAMESPACE__, $argv);
+\Google\Cloud\Samples\execute_sample(__FILE__, __NAMESPACE__, $argv);

compute/cloud-client/instances/src/delete_instance.php

@@ -23,6 +23,7 @@
 
 namespace Google\Cloud\Samples\Compute;
 
+# [START compute_instances_delete]
 use Google\Cloud\Compute\V1\InstancesClient;
 
 /**
@@ -33,8 +34,10 @@
  * ```
  *
  * @param string $projectId Your Google Cloud project ID.
- * @param string $zone The zone to delete the instance in (e.g. "us-central1-a")
+ * @param string $zone The zone to delete the instance in (e.g. "us-central1-a").
  * @param string $instanceName The unique name for the Compute instance to delete.
+ *
+ * @throws \Google\ApiCore\ApiException if the remote call fails.
  */
 function delete_instance(
     string $projectId,
@@ -49,6 +52,7 @@ function delete_instance(
 
     printf('Deleted instance %s' . PHP_EOL, $instanceName);
 }
+# [END compute_instances_delete]
 
 require_once __DIR__ . '/../../../../testing/sample_helpers.php';
 \Google\Cloud\Samples\execute_sample(__FILE__, __NAMESPACE__, $argv);

compute/cloud-client/instances/src/list_instances.php

@@ -23,17 +23,20 @@
 
 namespace Google\Cloud\Samples\Compute;
 
+# [START compute_instances_list]
 use Google\Cloud\Compute\V1\InstancesClient;
 
 /**
- * Creates an instance.
+ * List instances for particular $projectId and $zone
  * Example:
  * ```
  * list_instances($projectId, $zone);
  * ```
  *
  * @param string $projectId Your Google Cloud project ID.
- * @param string $zone The zone to list the instance in (e.g. "us-central1-a")
+ * @param string $zone The zone to list the instance in (e.g. "us-central1-a").
+ *
+ * @throws \Google\ApiCore\ApiException if the remote call fails.
  */
 function list_instances(string $projectId, string $zone)
 {
@@ -46,6 +49,7 @@ function list_instances(string $projectId, string $zone)
         printf(' - %s' . PHP_EOL, $instance->getName());
     }
 }
+# [END compute_instances_list]
 
 require_once __DIR__ . '/../../../../testing/sample_helpers.php';
 \Google\Cloud\Samples\execute_sample(__FILE__, __NAMESPACE__, $argv);