Google Cloud Org Policy V2 Client - Class OrgPolicyClient (0.6.5)

Namespace

Methods

__construct

createCustomConstraint

use Google\ApiCore\ApiException;
use Google\Cloud\OrgPolicy\V2\Client\OrgPolicyClient;
use Google\Cloud\OrgPolicy\V2\CreateCustomConstraintRequest;
use Google\Cloud\OrgPolicy\V2\CustomConstraint;

/**
 * @param string $formattedParent Must be in the following form:
 *
 *                                * `organizations/{organization_id}`
 *                                Please see {@see OrgPolicyClient::organizationName()} for help formatting this field.
 */
function create_custom_constraint_sample(string $formattedParent): void
{
    // Create a client.
    $orgPolicyClient = new OrgPolicyClient();

    // Prepare the request message.
    $customConstraint = new CustomConstraint();
    $request = (new CreateCustomConstraintRequest())
        ->setParent($formattedParent)
        ->setCustomConstraint($customConstraint);

    // Call the API and handle any network failures.
    try {
        /** @var CustomConstraint $response */
        $response = $orgPolicyClient->createCustomConstraint($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
{
    $formattedParent = OrgPolicyClient::organizationName('[ORGANIZATION]');

    create_custom_constraint_sample($formattedParent);
}

createPolicy

use Google\ApiCore\ApiException;
use Google\Cloud\OrgPolicy\V2\Client\OrgPolicyClient;
use Google\Cloud\OrgPolicy\V2\CreatePolicyRequest;
use Google\Cloud\OrgPolicy\V2\Policy;

/**
 * @param string $formattedParent The Google Cloud resource that will parent the new policy. Must
 *                                be in one of the following forms:
 *
 *                                * `projects/{project_number}`
 *                                * `projects/{project_id}`
 *                                * `folders/{folder_id}`
 *                                * `organizations/{organization_id}`
 *                                Please see {@see OrgPolicyClient::projectName()} for help formatting this field.
 */
function create_policy_sample(string $formattedParent): void
{
    // Create a client.
    $orgPolicyClient = new OrgPolicyClient();

    // Prepare the request message.
    $policy = new Policy();
    $request = (new CreatePolicyRequest())
        ->setParent($formattedParent)
        ->setPolicy($policy);

    // Call the API and handle any network failures.
    try {
        /** @var Policy $response */
        $response = $orgPolicyClient->createPolicy($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
{
    $formattedParent = OrgPolicyClient::projectName('[PROJECT]');

    create_policy_sample($formattedParent);
}

deleteCustomConstraint

use Google\ApiCore\ApiException;
use Google\Cloud\OrgPolicy\V2\Client\OrgPolicyClient;
use Google\Cloud\OrgPolicy\V2\DeleteCustomConstraintRequest;

/**
 * @param string $formattedName Name of the custom constraint to delete.
 *                              See the custom constraint entry for naming rules. Please see
 *                              {@see OrgPolicyClient::customConstraintName()} for help formatting this field.
 */
function delete_custom_constraint_sample(string $formattedName): void
{
    // Create a client.
    $orgPolicyClient = new OrgPolicyClient();

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

    // Call the API and handle any network failures.
    try {
        $orgPolicyClient->deleteCustomConstraint($request);
        printf('Call completed successfully.' . PHP_EOL);
    } 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 = OrgPolicyClient::customConstraintName('[ORGANIZATION]', '[CUSTOM_CONSTRAINT]');

    delete_custom_constraint_sample($formattedName);
}

deletePolicy

use Google\ApiCore\ApiException;
use Google\Cloud\OrgPolicy\V2\Client\OrgPolicyClient;
use Google\Cloud\OrgPolicy\V2\DeletePolicyRequest;

/**
 * @param string $formattedName Name of the policy to delete.
 *                              See the policy entry for naming rules. Please see
 *                              {@see OrgPolicyClient::policyName()} for help formatting this field.
 */
function delete_policy_sample(string $formattedName): void
{
    // Create a client.
    $orgPolicyClient = new OrgPolicyClient();

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

    // Call the API and handle any network failures.
    try {
        $orgPolicyClient->deletePolicy($request);
        printf('Call completed successfully.' . PHP_EOL);
    } 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 = OrgPolicyClient::policyName('[PROJECT]', '[POLICY]');

    delete_policy_sample($formattedName);
}

getCustomConstraint

use Google\ApiCore\ApiException;
use Google\Cloud\OrgPolicy\V2\Client\OrgPolicyClient;
use Google\Cloud\OrgPolicy\V2\CustomConstraint;
use Google\Cloud\OrgPolicy\V2\GetCustomConstraintRequest;

/**
 * @param string $formattedName Resource name of the custom constraint. See the custom constraint
 *                              entry for naming requirements. Please see
 *                              {@see OrgPolicyClient::customConstraintName()} for help formatting this field.
 */
function get_custom_constraint_sample(string $formattedName): void
{
    // Create a client.
    $orgPolicyClient = new OrgPolicyClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var CustomConstraint $response */
        $response = $orgPolicyClient->getCustomConstraint($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 = OrgPolicyClient::customConstraintName('[ORGANIZATION]', '[CUSTOM_CONSTRAINT]');

    get_custom_constraint_sample($formattedName);
}

getEffectivePolicy

use Google\ApiCore\ApiException;
use Google\Cloud\OrgPolicy\V2\Client\OrgPolicyClient;
use Google\Cloud\OrgPolicy\V2\GetEffectivePolicyRequest;
use Google\Cloud\OrgPolicy\V2\Policy;

/**
 * @param string $formattedName The effective policy to compute. See
 *                              [Policy][google.cloud.orgpolicy.v2.Policy] for naming requirements. Please see
 *                              {@see OrgPolicyClient::policyName()} for help formatting this field.
 */
function get_effective_policy_sample(string $formattedName): void
{
    // Create a client.
    $orgPolicyClient = new OrgPolicyClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var Policy $response */
        $response = $orgPolicyClient->getEffectivePolicy($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 = OrgPolicyClient::policyName('[PROJECT]', '[POLICY]');

    get_effective_policy_sample($formattedName);
}

getPolicy

use Google\ApiCore\ApiException;
use Google\Cloud\OrgPolicy\V2\Client\OrgPolicyClient;
use Google\Cloud\OrgPolicy\V2\GetPolicyRequest;
use Google\Cloud\OrgPolicy\V2\Policy;

/**
 * @param string $formattedName Resource name of the policy. See
 *                              [Policy][google.cloud.orgpolicy.v2.Policy] for naming requirements. Please see
 *                              {@see OrgPolicyClient::policyName()} for help formatting this field.
 */
function get_policy_sample(string $formattedName): void
{
    // Create a client.
    $orgPolicyClient = new OrgPolicyClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var Policy $response */
        $response = $orgPolicyClient->getPolicy($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 = OrgPolicyClient::policyName('[PROJECT]', '[POLICY]');

    get_policy_sample($formattedName);
}

listConstraints

use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;
use Google\Cloud\OrgPolicy\V2\Client\OrgPolicyClient;
use Google\Cloud\OrgPolicy\V2\Constraint;
use Google\Cloud\OrgPolicy\V2\ListConstraintsRequest;

/**
 * @param string $formattedParent The Google Cloud resource that parents the constraint. Must be in
 *                                one of the following forms:
 *
 *                                * `projects/{project_number}`
 *                                * `projects/{project_id}`
 *                                * `folders/{folder_id}`
 *                                * `organizations/{organization_id}`
 *                                Please see {@see OrgPolicyClient::projectName()} for help formatting this field.
 */
function list_constraints_sample(string $formattedParent): void
{
    // Create a client.
    $orgPolicyClient = new OrgPolicyClient();

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

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

        /** @var Constraint $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 = OrgPolicyClient::projectName('[PROJECT]');

    list_constraints_sample($formattedParent);
}

listCustomConstraints

use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;
use Google\Cloud\OrgPolicy\V2\Client\OrgPolicyClient;
use Google\Cloud\OrgPolicy\V2\CustomConstraint;
use Google\Cloud\OrgPolicy\V2\ListCustomConstraintsRequest;

/**
 * @param string $formattedParent The target Google Cloud resource that parents the set of custom
 *                                constraints that will be returned from this call. Must be in one of the
 *                                following forms:
 *
 *                                * `organizations/{organization_id}`
 *                                Please see {@see OrgPolicyClient::organizationName()} for help formatting this field.
 */
function list_custom_constraints_sample(string $formattedParent): void
{
    // Create a client.
    $orgPolicyClient = new OrgPolicyClient();

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

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

        /** @var CustomConstraint $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 = OrgPolicyClient::organizationName('[ORGANIZATION]');

    list_custom_constraints_sample($formattedParent);
}

listPolicies

use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;
use Google\Cloud\OrgPolicy\V2\Client\OrgPolicyClient;
use Google\Cloud\OrgPolicy\V2\ListPoliciesRequest;
use Google\Cloud\OrgPolicy\V2\Policy;

/**
 * @param string $formattedParent The target Google Cloud resource that parents the set of
 *                                constraints and policies that will be returned from this call. Must be in
 *                                one of the following forms:
 *
 *                                * `projects/{project_number}`
 *                                * `projects/{project_id}`
 *                                * `folders/{folder_id}`
 *                                * `organizations/{organization_id}`
 *                                Please see {@see OrgPolicyClient::projectName()} for help formatting this field.
 */
function list_policies_sample(string $formattedParent): void
{
    // Create a client.
    $orgPolicyClient = new OrgPolicyClient();

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

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

        /** @var Policy $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 = OrgPolicyClient::projectName('[PROJECT]');

    list_policies_sample($formattedParent);
}

updateCustomConstraint

use Google\ApiCore\ApiException;
use Google\Cloud\OrgPolicy\V2\Client\OrgPolicyClient;
use Google\Cloud\OrgPolicy\V2\CustomConstraint;
use Google\Cloud\OrgPolicy\V2\UpdateCustomConstraintRequest;

/**
 * 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 update_custom_constraint_sample(): void
{
    // Create a client.
    $orgPolicyClient = new OrgPolicyClient();

    // Prepare the request message.
    $customConstraint = new CustomConstraint();
    $request = (new UpdateCustomConstraintRequest())
        ->setCustomConstraint($customConstraint);

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

updatePolicy

use Google\ApiCore\ApiException;
use Google\Cloud\OrgPolicy\V2\Client\OrgPolicyClient;
use Google\Cloud\OrgPolicy\V2\Policy;
use Google\Cloud\OrgPolicy\V2\UpdatePolicyRequest;

/**
 * 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 update_policy_sample(): void
{
    // Create a client.
    $orgPolicyClient = new OrgPolicyClient();

    // Prepare the request message.
    $policy = new Policy();
    $request = (new UpdatePolicyRequest())
        ->setPolicy($policy);

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

createCustomConstraintAsync

createPolicyAsync

deleteCustomConstraintAsync

deletePolicyAsync

getCustomConstraintAsync

getEffectivePolicyAsync

getPolicyAsync

listConstraintsAsync

listCustomConstraintsAsync

listPoliciesAsync

updateCustomConstraintAsync

updatePolicyAsync

static::customConstraintName

static::folderName

static::folderPolicyName

static::organizationName

static::organizationPolicyName

static::policyName

static::projectName

static::projectPolicyName

static::parseName