Google Cloud Run V2 Client - Class RevisionsClient (0.6.0)

$revisionsClient = new RevisionsClient();
try {
    $formattedName = $revisionsClient->revisionName('[PROJECT]', '[LOCATION]', '[SERVICE]', '[REVISION]');
    $operationResponse = $revisionsClient->deleteRevision($formattedName);
    $operationResponse->pollUntilComplete();
    if ($operationResponse->operationSucceeded()) {
        $result = $operationResponse->getResult();
        // doSomethingWith($result)
    } else {
        $error = $operationResponse->getError();
        // handleError($error)
    }
    // Alternatively:
    // start the operation, keep the operation name, and resume later
    $operationResponse = $revisionsClient->deleteRevision($formattedName);
    $operationName = $operationResponse->getName();
    // ... do other work
    $newOperationResponse = $revisionsClient->resumeOperation($operationName, 'deleteRevision');
    while (!$newOperationResponse->isDone()) {
        // ... do other work
        $newOperationResponse->reload();
    }
    if ($newOperationResponse->operationSucceeded()) {
        $result = $newOperationResponse->getResult();
        // doSomethingWith($result)
    } else {
        $error = $newOperationResponse->getError();
        // handleError($error)
    }
} finally {
    $revisionsClient->close();
}

Namespace

Methods

__construct

deleteRevision

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Run\V2\Client\RevisionsClient;
use Google\Cloud\Run\V2\DeleteRevisionRequest;
use Google\Cloud\Run\V2\Revision;
use Google\Rpc\Status;

/**
 * @param string $formattedName The name of the Revision to delete.
 *                              Format:
 *                              projects/{project}/locations/{location}/services/{service}/revisions/{revision}
 *                              Please see {@see RevisionsClient::revisionName()} for help formatting this field.
 */
function delete_revision_sample(string $formattedName): void
{
    // Create a client.
    $revisionsClient = new RevisionsClient();

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

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

        if ($response->operationSucceeded()) {
            /** @var Revision $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
{
    $formattedName = RevisionsClient::revisionName(
        '[PROJECT]',
        '[LOCATION]',
        '[SERVICE]',
        '[REVISION]'
    );

    delete_revision_sample($formattedName);
}

getRevision

use Google\ApiCore\ApiException;
use Google\Cloud\Run\V2\Client\RevisionsClient;
use Google\Cloud\Run\V2\GetRevisionRequest;
use Google\Cloud\Run\V2\Revision;

/**
 * @param string $formattedName The full name of the Revision.
 *                              Format:
 *                              projects/{project}/locations/{location}/services/{service}/revisions/{revision}
 *                              Please see {@see RevisionsClient::revisionName()} for help formatting this field.
 */
function get_revision_sample(string $formattedName): void
{
    // Create a client.
    $revisionsClient = new RevisionsClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var Revision $response */
        $response = $revisionsClient->getRevision($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
{
    $formattedName = RevisionsClient::revisionName(
        '[PROJECT]',
        '[LOCATION]',
        '[SERVICE]',
        '[REVISION]'
    );

    get_revision_sample($formattedName);
}

listRevisions

use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;
use Google\Cloud\Run\V2\Client\RevisionsClient;
use Google\Cloud\Run\V2\ListRevisionsRequest;
use Google\Cloud\Run\V2\Revision;

/**
 * @param string $formattedParent The Service from which the Revisions should be listed.
 *                                To list all Revisions across Services, use "-" instead of Service name.
 *                                Format:
 *                                projects/{project}/locations/{location}/services/{service}
 *                                Please see {@see RevisionsClient::serviceName()} for help formatting this field.
 */
function list_revisions_sample(string $formattedParent): void
{
    // Create a client.
    $revisionsClient = new RevisionsClient();

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

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

        /** @var Revision $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 = RevisionsClient::serviceName('[PROJECT]', '[LOCATION]', '[SERVICE]');

    list_revisions_sample($formattedParent);
}

getOperationsClient

resumeOperation

static::revisionName

static::serviceName

static::parseName

Constants

SERVICE_NAME

Value: 'google.cloud.run.v2.Revisions'

SERVICE_ADDRESS

Value: 'run.googleapis.com'

DEFAULT_SERVICE_PORT

Value: 443

CODEGEN_NAME

Value: 'gapic'