Google Cloud Ai Platform V1 Client - Class VizierServiceClient (0.19.0)

use Google\ApiCore\ApiException;
use Google\Cloud\AIPlatform\V1\AddTrialMeasurementRequest;
use Google\Cloud\AIPlatform\V1\Client\VizierServiceClient;
use Google\Cloud\AIPlatform\V1\Measurement;
use Google\Cloud\AIPlatform\V1\Trial;

/**
 * @param string $formattedTrialName The name of the trial to add measurement.
 *                                   Format:
 *                                   `projects/{project}/locations/{location}/studies/{study}/trials/{trial}`
 *                                   Please see {@see VizierServiceClient::trialName()} for help formatting this field.
 */
function add_trial_measurement_sample(string $formattedTrialName): void
{
    // Create a client.
    $vizierServiceClient = new VizierServiceClient();

    // Prepare the request message.
    $measurement = new Measurement();
    $request = (new AddTrialMeasurementRequest())
        ->setTrialName($formattedTrialName)
        ->setMeasurement($measurement);

    // Call the API and handle any network failures.
    try {
        /** @var Trial $response */
        $response = $vizierServiceClient->addTrialMeasurement($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
{
    $formattedTrialName = VizierServiceClient::trialName(
        '[PROJECT]',
        '[LOCATION]',
        '[STUDY]',
        '[TRIAL]'
    );

    add_trial_measurement_sample($formattedTrialName);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\AIPlatform\V1\CheckTrialEarlyStoppingStateRequest;
use Google\Cloud\AIPlatform\V1\CheckTrialEarlyStoppingStateResponse;
use Google\Cloud\AIPlatform\V1\Client\VizierServiceClient;
use Google\Rpc\Status;

/**
 * @param string $formattedTrialName The Trial's name.
 *                                   Format:
 *                                   `projects/{project}/locations/{location}/studies/{study}/trials/{trial}`
 *                                   Please see {@see VizierServiceClient::trialName()} for help formatting this field.
 */
function check_trial_early_stopping_state_sample(string $formattedTrialName): void
{
    // Create a client.
    $vizierServiceClient = new VizierServiceClient();

    // Prepare the request message.
    $request = (new CheckTrialEarlyStoppingStateRequest())
        ->setTrialName($formattedTrialName);

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

        if ($response->operationSucceeded()) {
            /** @var CheckTrialEarlyStoppingStateResponse $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
{
    $formattedTrialName = VizierServiceClient::trialName(
        '[PROJECT]',
        '[LOCATION]',
        '[STUDY]',
        '[TRIAL]'
    );

    check_trial_early_stopping_state_sample($formattedTrialName);
}

use Google\ApiCore\ApiException;
use Google\Cloud\AIPlatform\V1\Client\VizierServiceClient;
use Google\Cloud\AIPlatform\V1\CompleteTrialRequest;
use Google\Cloud\AIPlatform\V1\Trial;

/**
 * @param string $formattedName The Trial's name.
 *                              Format:
 *                              `projects/{project}/locations/{location}/studies/{study}/trials/{trial}`
 *                              Please see {@see VizierServiceClient::trialName()} for help formatting this field.
 */
function complete_trial_sample(string $formattedName): void
{
    // Create a client.
    $vizierServiceClient = new VizierServiceClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var Trial $response */
        $response = $vizierServiceClient->completeTrial($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 = VizierServiceClient::trialName('[PROJECT]', '[LOCATION]', '[STUDY]', '[TRIAL]');

    complete_trial_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\Cloud\AIPlatform\V1\Client\VizierServiceClient;
use Google\Cloud\AIPlatform\V1\CreateStudyRequest;
use Google\Cloud\AIPlatform\V1\Study;
use Google\Cloud\AIPlatform\V1\StudySpec;
use Google\Cloud\AIPlatform\V1\StudySpec\MetricSpec;
use Google\Cloud\AIPlatform\V1\StudySpec\MetricSpec\GoalType;
use Google\Cloud\AIPlatform\V1\StudySpec\ParameterSpec;

/**
 * @param string $formattedParent                     The resource name of the Location to create the CustomJob in.
 *                                                    Format: `projects/{project}/locations/{location}`
 *                                                    Please see {@see VizierServiceClient::locationName()} for help formatting this field.
 * @param string $studyDisplayName                    Describes the Study, default value is empty string.
 * @param string $studyStudySpecMetricsMetricId       The ID of the metric. Must not contain whitespaces and must be
 *                                                    unique amongst all MetricSpecs.
 * @param int    $studyStudySpecMetricsGoal           The optimization goal of the metric.
 * @param string $studyStudySpecParametersParameterId The ID of the parameter. Must not contain whitespaces and must
 *                                                    be unique amongst all ParameterSpecs.
 */
function create_study_sample(
    string $formattedParent,
    string $studyDisplayName,
    string $studyStudySpecMetricsMetricId,
    int $studyStudySpecMetricsGoal,
    string $studyStudySpecParametersParameterId
): void {
    // Create a client.
    $vizierServiceClient = new VizierServiceClient();

    // Prepare the request message.
    $metricSpec = (new MetricSpec())
        ->setMetricId($studyStudySpecMetricsMetricId)
        ->setGoal($studyStudySpecMetricsGoal);
    $studyStudySpecMetrics = [$metricSpec,];
    $parameterSpec = (new ParameterSpec())
        ->setParameterId($studyStudySpecParametersParameterId);
    $studyStudySpecParameters = [$parameterSpec,];
    $studyStudySpec = (new StudySpec())
        ->setMetrics($studyStudySpecMetrics)
        ->setParameters($studyStudySpecParameters);
    $study = (new Study())
        ->setDisplayName($studyDisplayName)
        ->setStudySpec($studyStudySpec);
    $request = (new CreateStudyRequest())
        ->setParent($formattedParent)
        ->setStudy($study);

    // Call the API and handle any network failures.
    try {
        /** @var Study $response */
        $response = $vizierServiceClient->createStudy($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 = VizierServiceClient::locationName('[PROJECT]', '[LOCATION]');
    $studyDisplayName = '[DISPLAY_NAME]';
    $studyStudySpecMetricsMetricId = '[METRIC_ID]';
    $studyStudySpecMetricsGoal = GoalType::GOAL_TYPE_UNSPECIFIED;
    $studyStudySpecParametersParameterId = '[PARAMETER_ID]';

    create_study_sample(
        $formattedParent,
        $studyDisplayName,
        $studyStudySpecMetricsMetricId,
        $studyStudySpecMetricsGoal,
        $studyStudySpecParametersParameterId
    );
}

use Google\ApiCore\ApiException;
use Google\Cloud\AIPlatform\V1\Client\VizierServiceClient;
use Google\Cloud\AIPlatform\V1\CreateTrialRequest;
use Google\Cloud\AIPlatform\V1\Trial;

/**
 * @param string $formattedParent The resource name of the Study to create the Trial in.
 *                                Format: `projects/{project}/locations/{location}/studies/{study}`
 *                                Please see {@see VizierServiceClient::studyName()} for help formatting this field.
 */
function create_trial_sample(string $formattedParent): void
{
    // Create a client.
    $vizierServiceClient = new VizierServiceClient();

    // Prepare the request message.
    $trial = new Trial();
    $request = (new CreateTrialRequest())
        ->setParent($formattedParent)
        ->setTrial($trial);

    // Call the API and handle any network failures.
    try {
        /** @var Trial $response */
        $response = $vizierServiceClient->createTrial($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 = VizierServiceClient::studyName('[PROJECT]', '[LOCATION]', '[STUDY]');

    create_trial_sample($formattedParent);
}

use Google\ApiCore\ApiException;
use Google\Cloud\AIPlatform\V1\Client\VizierServiceClient;
use Google\Cloud\AIPlatform\V1\DeleteStudyRequest;

/**
 * @param string $formattedName The name of the Study resource to be deleted.
 *                              Format: `projects/{project}/locations/{location}/studies/{study}`
 *                              Please see {@see VizierServiceClient::studyName()} for help formatting this field.
 */
function delete_study_sample(string $formattedName): void
{
    // Create a client.
    $vizierServiceClient = new VizierServiceClient();

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

    // Call the API and handle any network failures.
    try {
        $vizierServiceClient->deleteStudy($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 = VizierServiceClient::studyName('[PROJECT]', '[LOCATION]', '[STUDY]');

    delete_study_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\Cloud\AIPlatform\V1\Client\VizierServiceClient;
use Google\Cloud\AIPlatform\V1\DeleteTrialRequest;

/**
 * @param string $formattedName The Trial's name.
 *                              Format:
 *                              `projects/{project}/locations/{location}/studies/{study}/trials/{trial}`
 *                              Please see {@see VizierServiceClient::trialName()} for help formatting this field.
 */
function delete_trial_sample(string $formattedName): void
{
    // Create a client.
    $vizierServiceClient = new VizierServiceClient();

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

    // Call the API and handle any network failures.
    try {
        $vizierServiceClient->deleteTrial($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 = VizierServiceClient::trialName('[PROJECT]', '[LOCATION]', '[STUDY]', '[TRIAL]');

    delete_trial_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\Cloud\AIPlatform\V1\Client\VizierServiceClient;
use Google\Cloud\AIPlatform\V1\GetStudyRequest;
use Google\Cloud\AIPlatform\V1\Study;

/**
 * @param string $formattedName The name of the Study resource.
 *                              Format: `projects/{project}/locations/{location}/studies/{study}`
 *                              Please see {@see VizierServiceClient::studyName()} for help formatting this field.
 */
function get_study_sample(string $formattedName): void
{
    // Create a client.
    $vizierServiceClient = new VizierServiceClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var Study $response */
        $response = $vizierServiceClient->getStudy($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 = VizierServiceClient::studyName('[PROJECT]', '[LOCATION]', '[STUDY]');

    get_study_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\Cloud\AIPlatform\V1\Client\VizierServiceClient;
use Google\Cloud\AIPlatform\V1\GetTrialRequest;
use Google\Cloud\AIPlatform\V1\Trial;

/**
 * @param string $formattedName The name of the Trial resource.
 *                              Format:
 *                              `projects/{project}/locations/{location}/studies/{study}/trials/{trial}`
 *                              Please see {@see VizierServiceClient::trialName()} for help formatting this field.
 */
function get_trial_sample(string $formattedName): void
{
    // Create a client.
    $vizierServiceClient = new VizierServiceClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var Trial $response */
        $response = $vizierServiceClient->getTrial($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 = VizierServiceClient::trialName('[PROJECT]', '[LOCATION]', '[STUDY]', '[TRIAL]');

    get_trial_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\Cloud\AIPlatform\V1\Client\VizierServiceClient;
use Google\Cloud\AIPlatform\V1\ListOptimalTrialsRequest;
use Google\Cloud\AIPlatform\V1\ListOptimalTrialsResponse;

/**
 * @param string $formattedParent The name of the Study that the optimal Trial belongs to. Please see
 *                                {@see VizierServiceClient::studyName()} for help formatting this field.
 */
function list_optimal_trials_sample(string $formattedParent): void
{
    // Create a client.
    $vizierServiceClient = new VizierServiceClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var ListOptimalTrialsResponse $response */
        $response = $vizierServiceClient->listOptimalTrials($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 = VizierServiceClient::studyName('[PROJECT]', '[LOCATION]', '[STUDY]');

    list_optimal_trials_sample($formattedParent);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;
use Google\Cloud\AIPlatform\V1\Client\VizierServiceClient;
use Google\Cloud\AIPlatform\V1\ListStudiesRequest;
use Google\Cloud\AIPlatform\V1\Study;

/**
 * @param string $formattedParent The resource name of the Location to list the Study from.
 *                                Format: `projects/{project}/locations/{location}`
 *                                Please see {@see VizierServiceClient::locationName()} for help formatting this field.
 */
function list_studies_sample(string $formattedParent): void
{
    // Create a client.
    $vizierServiceClient = new VizierServiceClient();

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

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

        /** @var Study $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 = VizierServiceClient::locationName('[PROJECT]', '[LOCATION]');

    list_studies_sample($formattedParent);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;
use Google\Cloud\AIPlatform\V1\Client\VizierServiceClient;
use Google\Cloud\AIPlatform\V1\ListTrialsRequest;
use Google\Cloud\AIPlatform\V1\Trial;

/**
 * @param string $formattedParent The resource name of the Study to list the Trial from.
 *                                Format: `projects/{project}/locations/{location}/studies/{study}`
 *                                Please see {@see VizierServiceClient::studyName()} for help formatting this field.
 */
function list_trials_sample(string $formattedParent): void
{
    // Create a client.
    $vizierServiceClient = new VizierServiceClient();

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

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

        /** @var Trial $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 = VizierServiceClient::studyName('[PROJECT]', '[LOCATION]', '[STUDY]');

    list_trials_sample($formattedParent);
}

use Google\ApiCore\ApiException;
use Google\Cloud\AIPlatform\V1\Client\VizierServiceClient;
use Google\Cloud\AIPlatform\V1\LookupStudyRequest;
use Google\Cloud\AIPlatform\V1\Study;

/**
 * @param string $formattedParent The resource name of the Location to get the Study from.
 *                                Format: `projects/{project}/locations/{location}`
 *                                Please see {@see VizierServiceClient::locationName()} for help formatting this field.
 * @param string $displayName     The user-defined display name of the Study
 */
function lookup_study_sample(string $formattedParent, string $displayName): void
{
    // Create a client.
    $vizierServiceClient = new VizierServiceClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var Study $response */
        $response = $vizierServiceClient->lookupStudy($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 = VizierServiceClient::locationName('[PROJECT]', '[LOCATION]');
    $displayName = '[DISPLAY_NAME]';

    lookup_study_sample($formattedParent, $displayName);
}

use Google\ApiCore\ApiException;
use Google\Cloud\AIPlatform\V1\Client\VizierServiceClient;
use Google\Cloud\AIPlatform\V1\StopTrialRequest;
use Google\Cloud\AIPlatform\V1\Trial;

/**
 * @param string $formattedName The Trial's name.
 *                              Format:
 *                              `projects/{project}/locations/{location}/studies/{study}/trials/{trial}`
 *                              Please see {@see VizierServiceClient::trialName()} for help formatting this field.
 */
function stop_trial_sample(string $formattedName): void
{
    // Create a client.
    $vizierServiceClient = new VizierServiceClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var Trial $response */
        $response = $vizierServiceClient->stopTrial($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 = VizierServiceClient::trialName('[PROJECT]', '[LOCATION]', '[STUDY]', '[TRIAL]');

    stop_trial_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\AIPlatform\V1\Client\VizierServiceClient;
use Google\Cloud\AIPlatform\V1\SuggestTrialsRequest;
use Google\Cloud\AIPlatform\V1\SuggestTrialsResponse;
use Google\Rpc\Status;

/**
 * @param string $formattedParent The project and location that the Study belongs to.
 *                                Format: `projects/{project}/locations/{location}/studies/{study}`
 *                                Please see {@see VizierServiceClient::studyName()} for help formatting this field.
 * @param int    $suggestionCount The number of suggestions requested. It must be positive.
 * @param string $clientId        The identifier of the client that is requesting the suggestion.
 *
 *                                If multiple SuggestTrialsRequests have the same `client_id`,
 *                                the service will return the identical suggested Trial if the Trial is
 *                                pending, and provide a new Trial if the last suggested Trial was completed.
 */
function suggest_trials_sample(
    string $formattedParent,
    int $suggestionCount,
    string $clientId
): void {
    // Create a client.
    $vizierServiceClient = new VizierServiceClient();

    // Prepare the request message.
    $request = (new SuggestTrialsRequest())
        ->setParent($formattedParent)
        ->setSuggestionCount($suggestionCount)
        ->setClientId($clientId);

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

        if ($response->operationSucceeded()) {
            /** @var SuggestTrialsResponse $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 = VizierServiceClient::studyName('[PROJECT]', '[LOCATION]', '[STUDY]');
    $suggestionCount = 0;
    $clientId = '[CLIENT_ID]';

    suggest_trials_sample($formattedParent, $suggestionCount, $clientId);
}

use Google\ApiCore\ApiException;
use Google\Cloud\AIPlatform\V1\Client\VizierServiceClient;
use Google\Cloud\Location\GetLocationRequest;
use Google\Cloud\Location\Location;

/**
 * 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 get_location_sample(): void
{
    // Create a client.
    $vizierServiceClient = new VizierServiceClient();

    // Prepare the request message.
    $request = new GetLocationRequest();

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

use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;
use Google\Cloud\AIPlatform\V1\Client\VizierServiceClient;
use Google\Cloud\Location\ListLocationsRequest;
use Google\Cloud\Location\Location;

/**
 * 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 list_locations_sample(): void
{
    // Create a client.
    $vizierServiceClient = new VizierServiceClient();

    // Prepare the request message.
    $request = new ListLocationsRequest();

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

        /** @var Location $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());
    }
}

use Google\ApiCore\ApiException;
use Google\Cloud\AIPlatform\V1\Client\VizierServiceClient;
use Google\Cloud\Iam\V1\GetIamPolicyRequest;
use Google\Cloud\Iam\V1\Policy;

/**
 * @param string $resource REQUIRED: The resource for which the policy is being requested.
 *                         See the operation documentation for the appropriate value for this field.
 */
function get_iam_policy_sample(string $resource): void
{
    // Create a client.
    $vizierServiceClient = new VizierServiceClient();

    // Prepare the request message.
    $request = (new GetIamPolicyRequest())
        ->setResource($resource);

    // Call the API and handle any network failures.
    try {
        /** @var Policy $response */
        $response = $vizierServiceClient->getIamPolicy($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
{
    $resource = '[RESOURCE]';

    get_iam_policy_sample($resource);
}

use Google\ApiCore\ApiException;
use Google\Cloud\AIPlatform\V1\Client\VizierServiceClient;
use Google\Cloud\Iam\V1\Policy;
use Google\Cloud\Iam\V1\SetIamPolicyRequest;

/**
 * @param string $resource REQUIRED: The resource for which the policy is being specified.
 *                         See the operation documentation for the appropriate value for this field.
 */
function set_iam_policy_sample(string $resource): void
{
    // Create a client.
    $vizierServiceClient = new VizierServiceClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var Policy $response */
        $response = $vizierServiceClient->setIamPolicy($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
{
    $resource = '[RESOURCE]';

    set_iam_policy_sample($resource);
}

use Google\ApiCore\ApiException;
use Google\Cloud\AIPlatform\V1\Client\VizierServiceClient;
use Google\Cloud\Iam\V1\TestIamPermissionsRequest;
use Google\Cloud\Iam\V1\TestIamPermissionsResponse;

/**
 * @param string $resource           REQUIRED: The resource for which the policy detail is being requested.
 *                                   See the operation documentation for the appropriate value for this field.
 * @param string $permissionsElement The set of permissions to check for the `resource`. Permissions with
 *                                   wildcards (such as '*' or 'storage.*') are not allowed. For more
 *                                   information see
 *                                   [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
 */
function test_iam_permissions_sample(string $resource, string $permissionsElement): void
{
    // Create a client.
    $vizierServiceClient = new VizierServiceClient();

    // Prepare the request message.
    $permissions = [$permissionsElement,];
    $request = (new TestIamPermissionsRequest())
        ->setResource($resource)
        ->setPermissions($permissions);

    // Call the API and handle any network failures.
    try {
        /** @var TestIamPermissionsResponse $response */
        $response = $vizierServiceClient->testIamPermissions($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
{
    $resource = '[RESOURCE]';
    $permissionsElement = '[PERMISSIONS]';

    test_iam_permissions_sample($resource, $permissionsElement);
}