Compute V1 Client - Class TargetPoolsClient (1.23.0)

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Compute\V1\AddHealthCheckTargetPoolRequest;
use Google\Cloud\Compute\V1\Client\TargetPoolsClient;
use Google\Cloud\Compute\V1\TargetPoolsAddHealthCheckRequest;
use Google\Rpc\Status;

/**
 * @param string $project    Project ID for this request.
 * @param string $region     Name of the region scoping this request.
 * @param string $targetPool Name of the target pool to add a health check to.
 */
function add_health_check_sample(string $project, string $region, string $targetPool): void
{
    // Create a client.
    $targetPoolsClient = new TargetPoolsClient();

    // Prepare the request message.
    $targetPoolsAddHealthCheckRequestResource = new TargetPoolsAddHealthCheckRequest();
    $request = (new AddHealthCheckTargetPoolRequest())
        ->setProject($project)
        ->setRegion($region)
        ->setTargetPool($targetPool)
        ->setTargetPoolsAddHealthCheckRequestResource($targetPoolsAddHealthCheckRequestResource);

    // Call the API and handle any network failures.
    try {
        /** @var OperationResponse $response */
        $response = $targetPoolsClient->addHealthCheck($request);
        $response->pollUntilComplete();

        if ($response->operationSucceeded()) {
            printf('Operation completed successfully.' . PHP_EOL);
        } else {
            /** @var Status $error */
            $error = $response->getError();
            printf('Operation failed with error data: %s' . PHP_EOL, $error->serializeToJsonString());
        }
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $project = '[PROJECT]';
    $region = '[REGION]';
    $targetPool = '[TARGET_POOL]';

    add_health_check_sample($project, $region, $targetPool);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Compute\V1\AddInstanceTargetPoolRequest;
use Google\Cloud\Compute\V1\Client\TargetPoolsClient;
use Google\Cloud\Compute\V1\TargetPoolsAddInstanceRequest;
use Google\Rpc\Status;

/**
 * @param string $project    Project ID for this request.
 * @param string $region     Name of the region scoping this request.
 * @param string $targetPool Name of the TargetPool resource to add instances to.
 */
function add_instance_sample(string $project, string $region, string $targetPool): void
{
    // Create a client.
    $targetPoolsClient = new TargetPoolsClient();

    // Prepare the request message.
    $targetPoolsAddInstanceRequestResource = new TargetPoolsAddInstanceRequest();
    $request = (new AddInstanceTargetPoolRequest())
        ->setProject($project)
        ->setRegion($region)
        ->setTargetPool($targetPool)
        ->setTargetPoolsAddInstanceRequestResource($targetPoolsAddInstanceRequestResource);

    // Call the API and handle any network failures.
    try {
        /** @var OperationResponse $response */
        $response = $targetPoolsClient->addInstance($request);
        $response->pollUntilComplete();

        if ($response->operationSucceeded()) {
            printf('Operation completed successfully.' . PHP_EOL);
        } else {
            /** @var Status $error */
            $error = $response->getError();
            printf('Operation failed with error data: %s' . PHP_EOL, $error->serializeToJsonString());
        }
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $project = '[PROJECT]';
    $region = '[REGION]';
    $targetPool = '[TARGET_POOL]';

    add_instance_sample($project, $region, $targetPool);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;
use Google\Cloud\Compute\V1\AggregatedListTargetPoolsRequest;
use Google\Cloud\Compute\V1\Client\TargetPoolsClient;

/**
 * @param string $project Project ID for this request.
 */
function aggregated_list_sample(string $project): void
{
    // Create a client.
    $targetPoolsClient = new TargetPoolsClient();

    // Prepare the request message.
    $request = (new AggregatedListTargetPoolsRequest())
        ->setProject($project);

    // Call the API and handle any network failures.
    try {
        /** @var PagedListResponse $response */
        $response = $targetPoolsClient->aggregatedList($request);

        foreach ($response as $element) {
            printf('Element data: %s' . PHP_EOL, $element->serializeToJsonString());
        }
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $project = '[PROJECT]';

    aggregated_list_sample($project);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Compute\V1\Client\TargetPoolsClient;
use Google\Cloud\Compute\V1\DeleteTargetPoolRequest;
use Google\Rpc\Status;

/**
 * @param string $project    Project ID for this request.
 * @param string $region     Name of the region scoping this request.
 * @param string $targetPool Name of the TargetPool resource to delete.
 */
function delete_sample(string $project, string $region, string $targetPool): void
{
    // Create a client.
    $targetPoolsClient = new TargetPoolsClient();

    // Prepare the request message.
    $request = (new DeleteTargetPoolRequest())
        ->setProject($project)
        ->setRegion($region)
        ->setTargetPool($targetPool);

    // Call the API and handle any network failures.
    try {
        /** @var OperationResponse $response */
        $response = $targetPoolsClient->delete($request);
        $response->pollUntilComplete();

        if ($response->operationSucceeded()) {
            printf('Operation completed successfully.' . PHP_EOL);
        } else {
            /** @var Status $error */
            $error = $response->getError();
            printf('Operation failed with error data: %s' . PHP_EOL, $error->serializeToJsonString());
        }
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $project = '[PROJECT]';
    $region = '[REGION]';
    $targetPool = '[TARGET_POOL]';

    delete_sample($project, $region, $targetPool);
}

use Google\ApiCore\ApiException;
use Google\Cloud\Compute\V1\Client\TargetPoolsClient;
use Google\Cloud\Compute\V1\GetTargetPoolRequest;
use Google\Cloud\Compute\V1\TargetPool;

/**
 * @param string $project    Project ID for this request.
 * @param string $region     Name of the region scoping this request.
 * @param string $targetPool Name of the TargetPool resource to return.
 */
function get_sample(string $project, string $region, string $targetPool): void
{
    // Create a client.
    $targetPoolsClient = new TargetPoolsClient();

    // Prepare the request message.
    $request = (new GetTargetPoolRequest())
        ->setProject($project)
        ->setRegion($region)
        ->setTargetPool($targetPool);

    // Call the API and handle any network failures.
    try {
        /** @var TargetPool $response */
        $response = $targetPoolsClient->get($request);
        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $project = '[PROJECT]';
    $region = '[REGION]';
    $targetPool = '[TARGET_POOL]';

    get_sample($project, $region, $targetPool);
}

use Google\ApiCore\ApiException;
use Google\Cloud\Compute\V1\Client\TargetPoolsClient;
use Google\Cloud\Compute\V1\GetHealthTargetPoolRequest;
use Google\Cloud\Compute\V1\InstanceReference;
use Google\Cloud\Compute\V1\TargetPoolInstanceHealth;

/**
 * @param string $project    Project ID for this request.
 * @param string $region     Name of the region scoping this request.
 * @param string $targetPool Name of the TargetPool resource to which the queried instance belongs.
 */
function get_health_sample(string $project, string $region, string $targetPool): void
{
    // Create a client.
    $targetPoolsClient = new TargetPoolsClient();

    // Prepare the request message.
    $instanceReferenceResource = new InstanceReference();
    $request = (new GetHealthTargetPoolRequest())
        ->setInstanceReferenceResource($instanceReferenceResource)
        ->setProject($project)
        ->setRegion($region)
        ->setTargetPool($targetPool);

    // Call the API and handle any network failures.
    try {
        /** @var TargetPoolInstanceHealth $response */
        $response = $targetPoolsClient->getHealth($request);
        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $project = '[PROJECT]';
    $region = '[REGION]';
    $targetPool = '[TARGET_POOL]';

    get_health_sample($project, $region, $targetPool);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Compute\V1\Client\TargetPoolsClient;
use Google\Cloud\Compute\V1\InsertTargetPoolRequest;
use Google\Cloud\Compute\V1\TargetPool;
use Google\Rpc\Status;

/**
 * @param string $project Project ID for this request.
 * @param string $region  Name of the region scoping this request.
 */
function insert_sample(string $project, string $region): void
{
    // Create a client.
    $targetPoolsClient = new TargetPoolsClient();

    // Prepare the request message.
    $targetPoolResource = new TargetPool();
    $request = (new InsertTargetPoolRequest())
        ->setProject($project)
        ->setRegion($region)
        ->setTargetPoolResource($targetPoolResource);

    // Call the API and handle any network failures.
    try {
        /** @var OperationResponse $response */
        $response = $targetPoolsClient->insert($request);
        $response->pollUntilComplete();

        if ($response->operationSucceeded()) {
            printf('Operation completed successfully.' . PHP_EOL);
        } else {
            /** @var Status $error */
            $error = $response->getError();
            printf('Operation failed with error data: %s' . PHP_EOL, $error->serializeToJsonString());
        }
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $project = '[PROJECT]';
    $region = '[REGION]';

    insert_sample($project, $region);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;
use Google\Cloud\Compute\V1\Client\TargetPoolsClient;
use Google\Cloud\Compute\V1\ListTargetPoolsRequest;

/**
 * @param string $project Project ID for this request.
 * @param string $region  Name of the region scoping this request.
 */
function list_sample(string $project, string $region): void
{
    // Create a client.
    $targetPoolsClient = new TargetPoolsClient();

    // Prepare the request message.
    $request = (new ListTargetPoolsRequest())
        ->setProject($project)
        ->setRegion($region);

    // Call the API and handle any network failures.
    try {
        /** @var PagedListResponse $response */
        $response = $targetPoolsClient->list($request);

        foreach ($response as $element) {
            printf('Element data: %s' . PHP_EOL, $element->serializeToJsonString());
        }
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $project = '[PROJECT]';
    $region = '[REGION]';

    list_sample($project, $region);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Compute\V1\Client\TargetPoolsClient;
use Google\Cloud\Compute\V1\RemoveHealthCheckTargetPoolRequest;
use Google\Cloud\Compute\V1\TargetPoolsRemoveHealthCheckRequest;
use Google\Rpc\Status;

/**
 * @param string $project    Project ID for this request.
 * @param string $region     Name of the region for this request.
 * @param string $targetPool Name of the target pool to remove health checks from.
 */
function remove_health_check_sample(string $project, string $region, string $targetPool): void
{
    // Create a client.
    $targetPoolsClient = new TargetPoolsClient();

    // Prepare the request message.
    $targetPoolsRemoveHealthCheckRequestResource = new TargetPoolsRemoveHealthCheckRequest();
    $request = (new RemoveHealthCheckTargetPoolRequest())
        ->setProject($project)
        ->setRegion($region)
        ->setTargetPool($targetPool)
        ->setTargetPoolsRemoveHealthCheckRequestResource($targetPoolsRemoveHealthCheckRequestResource);

    // Call the API and handle any network failures.
    try {
        /** @var OperationResponse $response */
        $response = $targetPoolsClient->removeHealthCheck($request);
        $response->pollUntilComplete();

        if ($response->operationSucceeded()) {
            printf('Operation completed successfully.' . PHP_EOL);
        } else {
            /** @var Status $error */
            $error = $response->getError();
            printf('Operation failed with error data: %s' . PHP_EOL, $error->serializeToJsonString());
        }
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $project = '[PROJECT]';
    $region = '[REGION]';
    $targetPool = '[TARGET_POOL]';

    remove_health_check_sample($project, $region, $targetPool);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Compute\V1\Client\TargetPoolsClient;
use Google\Cloud\Compute\V1\RemoveInstanceTargetPoolRequest;
use Google\Cloud\Compute\V1\TargetPoolsRemoveInstanceRequest;
use Google\Rpc\Status;

/**
 * @param string $project    Project ID for this request.
 * @param string $region     Name of the region scoping this request.
 * @param string $targetPool Name of the TargetPool resource to remove instances from.
 */
function remove_instance_sample(string $project, string $region, string $targetPool): void
{
    // Create a client.
    $targetPoolsClient = new TargetPoolsClient();

    // Prepare the request message.
    $targetPoolsRemoveInstanceRequestResource = new TargetPoolsRemoveInstanceRequest();
    $request = (new RemoveInstanceTargetPoolRequest())
        ->setProject($project)
        ->setRegion($region)
        ->setTargetPool($targetPool)
        ->setTargetPoolsRemoveInstanceRequestResource($targetPoolsRemoveInstanceRequestResource);

    // Call the API and handle any network failures.
    try {
        /** @var OperationResponse $response */
        $response = $targetPoolsClient->removeInstance($request);
        $response->pollUntilComplete();

        if ($response->operationSucceeded()) {
            printf('Operation completed successfully.' . PHP_EOL);
        } else {
            /** @var Status $error */
            $error = $response->getError();
            printf('Operation failed with error data: %s' . PHP_EOL, $error->serializeToJsonString());
        }
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $project = '[PROJECT]';
    $region = '[REGION]';
    $targetPool = '[TARGET_POOL]';

    remove_instance_sample($project, $region, $targetPool);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Compute\V1\Client\TargetPoolsClient;
use Google\Cloud\Compute\V1\SetBackupTargetPoolRequest;
use Google\Cloud\Compute\V1\TargetReference;
use Google\Rpc\Status;

/**
 * @param string $project    Project ID for this request.
 * @param string $region     Name of the region scoping this request.
 * @param string $targetPool Name of the TargetPool resource to set a backup pool for.
 */
function set_backup_sample(string $project, string $region, string $targetPool): void
{
    // Create a client.
    $targetPoolsClient = new TargetPoolsClient();

    // Prepare the request message.
    $targetReferenceResource = new TargetReference();
    $request = (new SetBackupTargetPoolRequest())
        ->setProject($project)
        ->setRegion($region)
        ->setTargetPool($targetPool)
        ->setTargetReferenceResource($targetReferenceResource);

    // Call the API and handle any network failures.
    try {
        /** @var OperationResponse $response */
        $response = $targetPoolsClient->setBackup($request);
        $response->pollUntilComplete();

        if ($response->operationSucceeded()) {
            printf('Operation completed successfully.' . PHP_EOL);
        } else {
            /** @var Status $error */
            $error = $response->getError();
            printf('Operation failed with error data: %s' . PHP_EOL, $error->serializeToJsonString());
        }
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $project = '[PROJECT]';
    $region = '[REGION]';
    $targetPool = '[TARGET_POOL]';

    set_backup_sample($project, $region, $targetPool);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Compute\V1\Client\TargetPoolsClient;
use Google\Cloud\Compute\V1\SecurityPolicyReference;
use Google\Cloud\Compute\V1\SetSecurityPolicyTargetPoolRequest;
use Google\Rpc\Status;

/**
 * @param string $project    Project ID for this request.
 * @param string $region     Name of the region scoping this request.
 * @param string $targetPool Name of the TargetPool resource to which the security policy should be set. The name should conform to RFC1035.
 */
function set_security_policy_sample(string $project, string $region, string $targetPool): void
{
    // Create a client.
    $targetPoolsClient = new TargetPoolsClient();

    // Prepare the request message.
    $securityPolicyReferenceResource = new SecurityPolicyReference();
    $request = (new SetSecurityPolicyTargetPoolRequest())
        ->setProject($project)
        ->setRegion($region)
        ->setSecurityPolicyReferenceResource($securityPolicyReferenceResource)
        ->setTargetPool($targetPool);

    // Call the API and handle any network failures.
    try {
        /** @var OperationResponse $response */
        $response = $targetPoolsClient->setSecurityPolicy($request);
        $response->pollUntilComplete();

        if ($response->operationSucceeded()) {
            printf('Operation completed successfully.' . PHP_EOL);
        } else {
            /** @var Status $error */
            $error = $response->getError();
            printf('Operation failed with error data: %s' . PHP_EOL, $error->serializeToJsonString());
        }
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $project = '[PROJECT]';
    $region = '[REGION]';
    $targetPool = '[TARGET_POOL]';

    set_security_policy_sample($project, $region, $targetPool);
}