Compute V1 Client - Class HostsClient (2.14.1)

use Google\ApiCore\ApiException;
use Google\Cloud\Compute\V1\Client\HostsClient;
use Google\Cloud\Compute\V1\GetHostRequest;
use Google\Cloud\Compute\V1\Host;

/**
 * @param string $association The parent resource association for the Host. This field specifies the
 *                            hierarchical context (e.g., reservation, block, sub-block) when
 *                            accessing the host. For example, reservations/reservation_name,
 *                            reservations/reservation_name/reservationBlocks/reservation_block_name or
 *                            reservations/reservation_name/reservationBlocks/reservation_block_name/reservationSubBlocks/reservation_sub_block_name.
 * @param string $host        The name of the host, formatted as RFC1035 or a resource ID
 *                            number.
 * @param string $project     The project ID for this request.
 * @param string $zone        The name of the zone for this request, formatted as RFC1035.
 */
function get_sample(string $association, string $host, string $project, string $zone): void
{
    // Create a client.
    $hostsClient = new HostsClient();

    // Prepare the request message.
    $request = (new GetHostRequest())
        ->setAssociation($association)
        ->setHost($host)
        ->setProject($project)
        ->setZone($zone);

    // Call the API and handle any network failures.
    try {
        /** @var Host $response */
        $response = $hostsClient->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
{
    $association = '[ASSOCIATION]';
    $host = '[HOST]';
    $project = '[PROJECT]';
    $zone = '[ZONE]';

    get_sample($association, $host, $project, $zone);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Compute\V1\Client\HostsClient;
use Google\Cloud\Compute\V1\GetVersionHostRequest;
use Google\Cloud\Compute\V1\HostsGetVersionRequest;
use Google\Rpc\Status;

/**
 * @param string $association The parent resource association for the Host. This field specifies the
 *                            hierarchical context (e.g., reservation, block, sub-block) when
 *                            accessing the host.
 * @param string $host        The name of the host, formatted as RFC1035 or a resource ID
 *                            number.
 * @param string $project     Project ID for this request.
 * @param string $zone        Name of the zone for this request. Zone name should conform to RFC1035.
 */
function get_version_sample(
    string $association,
    string $host,
    string $project,
    string $zone
): void {
    // Create a client.
    $hostsClient = new HostsClient();

    // Prepare the request message.
    $hostsGetVersionRequestResource = new HostsGetVersionRequest();
    $request = (new GetVersionHostRequest())
        ->setAssociation($association)
        ->setHost($host)
        ->setHostsGetVersionRequestResource($hostsGetVersionRequestResource)
        ->setProject($project)
        ->setZone($zone);

    // Call the API and handle any network failures.
    try {
        /** @var OperationResponse $response */
        $response = $hostsClient->getVersion($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
{
    $association = '[ASSOCIATION]';
    $host = '[HOST]';
    $project = '[PROJECT]';
    $zone = '[ZONE]';

    get_version_sample($association, $host, $project, $zone);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;
use Google\Cloud\Compute\V1\Client\HostsClient;
use Google\Cloud\Compute\V1\ListHostsRequest;

/**
 * @param string $association The parent resource association for the Host. This field specifies the
 *                            hierarchical context (e.g., reservation, block, sub-block) when
 *                            accessing the host. For example, reservations/reservation_name,
 *                            reservations/reservation_name/reservationBlocks/reservation_block_name or
 *                            reservations/reservation_name/reservationBlocks/reservation_block_name/reservationSubBlocks/reservation_sub_block_name.
 * @param string $project     The project ID for this request.
 * @param string $zone        The name of the zone for this request, formatted as RFC1035.
 */
function list_sample(string $association, string $project, string $zone): void
{
    // Create a client.
    $hostsClient = new HostsClient();

    // Prepare the request message.
    $request = (new ListHostsRequest())
        ->setAssociation($association)
        ->setProject($project)
        ->setZone($zone);

    // Call the API and handle any network failures.
    try {
        /** @var PagedListResponse $response */
        $response = $hostsClient->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
{
    $association = '[ASSOCIATION]';
    $project = '[PROJECT]';
    $zone = '[ZONE]';

    list_sample($association, $project, $zone);
}