Google Cloud Resource Manager V3 Client - Class TagHoldsClient (0.6.1)

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\ResourceManager\V3\Client\TagHoldsClient;
use Google\Cloud\ResourceManager\V3\CreateTagHoldRequest;
use Google\Cloud\ResourceManager\V3\TagHold;
use Google\Rpc\Status;

/**
 * @param string $formattedParent The resource name of the TagHold's parent TagValue. Must be of
 *                                the form: `tagValues/{tag-value-id}`. Please see
 *                                {@see TagHoldsClient::tagValueName()} for help formatting this field.
 * @param string $tagHoldHolder   The name of the resource where the TagValue is being used. Must
 *                                be less than 200 characters. E.g.
 *                                `//compute.googleapis.com/compute/projects/myproject/regions/us-east-1/instanceGroupManagers/instance-group`
 */
function create_tag_hold_sample(string $formattedParent, string $tagHoldHolder): void
{
    // Create a client.
    $tagHoldsClient = new TagHoldsClient();

    // Prepare the request message.
    $tagHold = (new TagHold())
        ->setHolder($tagHoldHolder);
    $request = (new CreateTagHoldRequest())
        ->setParent($formattedParent)
        ->setTagHold($tagHold);

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

        if ($response->operationSucceeded()) {
            /** @var TagHold $result */
            $result = $response->getResult();
            printf('Operation successful with response data: %s' . PHP_EOL, $result->serializeToJsonString());
        } 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
{
    $formattedParent = TagHoldsClient::tagValueName('[TAG_VALUE]');
    $tagHoldHolder = '[HOLDER]';

    create_tag_hold_sample($formattedParent, $tagHoldHolder);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\ResourceManager\V3\Client\TagHoldsClient;
use Google\Cloud\ResourceManager\V3\DeleteTagHoldRequest;
use Google\Rpc\Status;

/**
 * @param string $formattedName The resource name of the TagHold to delete. Must be of the form:
 *                              `tagValues/{tag-value-id}/tagHolds/{tag-hold-id}`. Please see
 *                              {@see TagHoldsClient::tagHoldName()} for help formatting this field.
 */
function delete_tag_hold_sample(string $formattedName): void
{
    // Create a client.
    $tagHoldsClient = new TagHoldsClient();

    // Prepare the request message.
    $request = (new DeleteTagHoldRequest())
        ->setName($formattedName);

    // Call the API and handle any network failures.
    try {
        /** @var OperationResponse $response */
        $response = $tagHoldsClient->deleteTagHold($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
{
    $formattedName = TagHoldsClient::tagHoldName('[TAG_VALUE]', '[TAG_HOLD]');

    delete_tag_hold_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;
use Google\Cloud\ResourceManager\V3\Client\TagHoldsClient;
use Google\Cloud\ResourceManager\V3\ListTagHoldsRequest;
use Google\Cloud\ResourceManager\V3\TagHold;

/**
 * @param string $formattedParent The resource name of the parent TagValue. Must be of the form:
 *                                `tagValues/{tag-value-id}`. Please see
 *                                {@see TagHoldsClient::tagValueName()} for help formatting this field.
 */
function list_tag_holds_sample(string $formattedParent): void
{
    // Create a client.
    $tagHoldsClient = new TagHoldsClient();

    // Prepare the request message.
    $request = (new ListTagHoldsRequest())
        ->setParent($formattedParent);

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

        /** @var TagHold $element */
        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
{
    $formattedParent = TagHoldsClient::tagValueName('[TAG_VALUE]');

    list_tag_holds_sample($formattedParent);
}