Google Cloud Iam V3 Client - Class PrincipalAccessBoundaryPoliciesClient (1.1.1)

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Iam\V3\Client\PrincipalAccessBoundaryPoliciesClient;
use Google\Cloud\Iam\V3\CreatePrincipalAccessBoundaryPolicyRequest;
use Google\Cloud\Iam\V3\PrincipalAccessBoundaryPolicy;
use Google\Rpc\Status;

/**
 * @param string $formattedParent                 The parent resource where this principal access boundary policy
 *                                                will be created. Only organizations are supported.
 *
 *                                                Format:
 *                                                `organizations/{organization_id}/locations/{location}`
 *                                                Please see {@see PrincipalAccessBoundaryPoliciesClient::organizationLocationName()} for help formatting this field.
 * @param string $principalAccessBoundaryPolicyId The ID to use for the principal access boundary policy, which
 *                                                will become the final component of the principal access boundary policy's
 *                                                resource name.
 *
 *                                                This value must start with a lowercase letter followed by up to 62
 *                                                lowercase letters, numbers, hyphens, or dots. Pattern,
 *                                                /[a-z][a-z0-9-\.]{2,62}/.
 */
function create_principal_access_boundary_policy_sample(
    string $formattedParent,
    string $principalAccessBoundaryPolicyId
): void {
    // Create a client.
    $principalAccessBoundaryPoliciesClient = new PrincipalAccessBoundaryPoliciesClient();

    // Prepare the request message.
    $principalAccessBoundaryPolicy = new PrincipalAccessBoundaryPolicy();
    $request = (new CreatePrincipalAccessBoundaryPolicyRequest())
        ->setParent($formattedParent)
        ->setPrincipalAccessBoundaryPolicyId($principalAccessBoundaryPolicyId)
        ->setPrincipalAccessBoundaryPolicy($principalAccessBoundaryPolicy);

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

        if ($response->operationSucceeded()) {
            /** @var PrincipalAccessBoundaryPolicy $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 = PrincipalAccessBoundaryPoliciesClient::organizationLocationName(
        '[ORGANIZATION]',
        '[LOCATION]'
    );
    $principalAccessBoundaryPolicyId = '[PRINCIPAL_ACCESS_BOUNDARY_POLICY_ID]';

    create_principal_access_boundary_policy_sample($formattedParent, $principalAccessBoundaryPolicyId);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Iam\V3\Client\PrincipalAccessBoundaryPoliciesClient;
use Google\Cloud\Iam\V3\DeletePrincipalAccessBoundaryPolicyRequest;
use Google\Rpc\Status;

/**
 * @param string $formattedName The name of the principal access boundary policy to delete.
 *
 *                              Format:
 *                              `organizations/{organization_id}/locations/{location}/principalAccessBoundaryPolicies/{principal_access_boundary_policy_id}`
 *                              Please see {@see PrincipalAccessBoundaryPoliciesClient::principalAccessBoundaryPolicyName()} for help formatting this field.
 */
function delete_principal_access_boundary_policy_sample(string $formattedName): void
{
    // Create a client.
    $principalAccessBoundaryPoliciesClient = new PrincipalAccessBoundaryPoliciesClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var OperationResponse $response */
        $response = $principalAccessBoundaryPoliciesClient->deletePrincipalAccessBoundaryPolicy($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 = PrincipalAccessBoundaryPoliciesClient::principalAccessBoundaryPolicyName(
        '[ORGANIZATION]',
        '[LOCATION]',
        '[PRINCIPAL_ACCESS_BOUNDARY_POLICY]'
    );

    delete_principal_access_boundary_policy_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\Cloud\Iam\V3\Client\PrincipalAccessBoundaryPoliciesClient;
use Google\Cloud\Iam\V3\GetPrincipalAccessBoundaryPolicyRequest;
use Google\Cloud\Iam\V3\PrincipalAccessBoundaryPolicy;

/**
 * @param string $formattedName The name of the principal access boundary policy to retrieve.
 *
 *                              Format:
 *                              `organizations/{organization_id}/locations/{location}/principalAccessBoundaryPolicies/{principal_access_boundary_policy_id}`
 *                              Please see {@see PrincipalAccessBoundaryPoliciesClient::principalAccessBoundaryPolicyName()} for help formatting this field.
 */
function get_principal_access_boundary_policy_sample(string $formattedName): void
{
    // Create a client.
    $principalAccessBoundaryPoliciesClient = new PrincipalAccessBoundaryPoliciesClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var PrincipalAccessBoundaryPolicy $response */
        $response = $principalAccessBoundaryPoliciesClient->getPrincipalAccessBoundaryPolicy($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 = PrincipalAccessBoundaryPoliciesClient::principalAccessBoundaryPolicyName(
        '[ORGANIZATION]',
        '[LOCATION]',
        '[PRINCIPAL_ACCESS_BOUNDARY_POLICY]'
    );

    get_principal_access_boundary_policy_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;
use Google\Cloud\Iam\V3\Client\PrincipalAccessBoundaryPoliciesClient;
use Google\Cloud\Iam\V3\ListPrincipalAccessBoundaryPoliciesRequest;
use Google\Cloud\Iam\V3\PrincipalAccessBoundaryPolicy;

/**
 * @param string $formattedParent The parent resource, which owns the collection of principal
 *                                access boundary policies.
 *
 *                                Format:
 *                                `organizations/{organization_id}/locations/{location}`
 *                                Please see {@see PrincipalAccessBoundaryPoliciesClient::organizationLocationName()} for help formatting this field.
 */
function list_principal_access_boundary_policies_sample(string $formattedParent): void
{
    // Create a client.
    $principalAccessBoundaryPoliciesClient = new PrincipalAccessBoundaryPoliciesClient();

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

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

        /** @var PrincipalAccessBoundaryPolicy $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 = PrincipalAccessBoundaryPoliciesClient::organizationLocationName(
        '[ORGANIZATION]',
        '[LOCATION]'
    );

    list_principal_access_boundary_policies_sample($formattedParent);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;
use Google\Cloud\Iam\V3\Client\PrincipalAccessBoundaryPoliciesClient;
use Google\Cloud\Iam\V3\PolicyBinding;
use Google\Cloud\Iam\V3\SearchPrincipalAccessBoundaryPolicyBindingsRequest;

/**
 * @param string $formattedName The name of the principal access boundary policy.
 *                              Format:
 *                              `organizations/{organization_id}/locations/{location}/principalAccessBoundaryPolicies/{principal_access_boundary_policy_id}`
 *                              Please see {@see PrincipalAccessBoundaryPoliciesClient::principalAccessBoundaryPolicyName()} for help formatting this field.
 */
function search_principal_access_boundary_policy_bindings_sample(string $formattedName): void
{
    // Create a client.
    $principalAccessBoundaryPoliciesClient = new PrincipalAccessBoundaryPoliciesClient();

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

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

        /** @var PolicyBinding $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
{
    $formattedName = PrincipalAccessBoundaryPoliciesClient::principalAccessBoundaryPolicyName(
        '[ORGANIZATION]',
        '[LOCATION]',
        '[PRINCIPAL_ACCESS_BOUNDARY_POLICY]'
    );

    search_principal_access_boundary_policy_bindings_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Iam\V3\Client\PrincipalAccessBoundaryPoliciesClient;
use Google\Cloud\Iam\V3\PrincipalAccessBoundaryPolicy;
use Google\Cloud\Iam\V3\UpdatePrincipalAccessBoundaryPolicyRequest;
use Google\Rpc\Status;

/**
 * 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_principal_access_boundary_policy_sample(): void
{
    // Create a client.
    $principalAccessBoundaryPoliciesClient = new PrincipalAccessBoundaryPoliciesClient();

    // Prepare the request message.
    $principalAccessBoundaryPolicy = new PrincipalAccessBoundaryPolicy();
    $request = (new UpdatePrincipalAccessBoundaryPolicyRequest())
        ->setPrincipalAccessBoundaryPolicy($principalAccessBoundaryPolicy);

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

        if ($response->operationSucceeded()) {
            /** @var PrincipalAccessBoundaryPolicy $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());
    }
}