Google Cloud Lustre V1 Client - Class LustreClient (0.6.0)

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Lustre\V1\Client\LustreClient;
use Google\Cloud\Lustre\V1\CreateDirectoryPolicyRequest;
use Google\Cloud\Lustre\V1\DirectoryPolicy;
use Google\Rpc\Status;

/**
 * @param string $formattedParent              The parent instance.
 *                                             It must be in the format of
 *                                             `projects/{project}/locations/{location}/instances/{instance}`. Please see
 *                                             {@see LustreClient::instanceName()} for help formatting this field.
 * @param string $directoryPolicyId            The ID for the DirectoryPolicy to create.
 * @param string $directoryPolicyDirectoryPath Immutable. The lustre instance filesystem full path of the
 *                                             directory. It must start with a slash. e.g. /lustre/testFolder
 */
function create_directory_policy_sample(
    string $formattedParent,
    string $directoryPolicyId,
    string $directoryPolicyDirectoryPath
): void {
    // Create a client.
    $lustreClient = new LustreClient();

    // Prepare the request message.
    $directoryPolicy = (new DirectoryPolicy())
        ->setDirectoryPath($directoryPolicyDirectoryPath);
    $request = (new CreateDirectoryPolicyRequest())
        ->setParent($formattedParent)
        ->setDirectoryPolicyId($directoryPolicyId)
        ->setDirectoryPolicy($directoryPolicy);

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

        if ($response->operationSucceeded()) {
            /** @var DirectoryPolicy $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 = LustreClient::instanceName('[PROJECT]', '[LOCATION]', '[INSTANCE]');
    $directoryPolicyId = '[DIRECTORY_POLICY_ID]';
    $directoryPolicyDirectoryPath = '[DIRECTORY_PATH]';

    create_directory_policy_sample($formattedParent, $directoryPolicyId, $directoryPolicyDirectoryPath);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Lustre\V1\Client\LustreClient;
use Google\Cloud\Lustre\V1\CreateInstanceRequest;
use Google\Cloud\Lustre\V1\Instance;
use Google\Rpc\Status;

/**
 * @param string $formattedParent          The instance's project and location, in the format
 *                                         `projects/{project}/locations/{location}`. Locations map to Google Cloud
 *                                         zones; for example, `us-west1-b`. Please see
 *                                         {@see LustreClient::locationName()} for help formatting this field.
 * @param string $instanceId               The name of the Managed Lustre instance.
 *
 *                                         * Must contain only lowercase letters, numbers, and hyphens.
 *                                         * Must start with a letter.
 *                                         * Must be between 1-63 characters.
 *                                         * Must end with a number or a letter.
 * @param string $instanceFilesystem       Immutable. The filesystem name for this instance. This name is
 *                                         used by client-side tools, including when mounting the instance. Must be
 *                                         eight characters or less and can only contain letters and numbers.
 * @param int    $instanceCapacityGib      The storage capacity of the instance in gibibytes (GiB). Allowed
 *                                         values depend on the `perUnitStorageThroughput`. See [Performance
 *                                         tiers](https://docs.cloud.google.com/managed-lustre/docs/performance-tiers)
 *                                         for specific minimums, maximums, and step sizes for each performance tier.
 * @param string $formattedInstanceNetwork Immutable. The full name of the VPC network to which the instance
 *                                         is connected. Must be in the format
 *                                         `projects/{project_id}/global/networks/{network_name}`. Please see
 *                                         {@see LustreClient::networkName()} for help formatting this field.
 */
function create_instance_sample(
    string $formattedParent,
    string $instanceId,
    string $instanceFilesystem,
    int $instanceCapacityGib,
    string $formattedInstanceNetwork
): void {
    // Create a client.
    $lustreClient = new LustreClient();

    // Prepare the request message.
    $instance = (new Instance())
        ->setFilesystem($instanceFilesystem)
        ->setCapacityGib($instanceCapacityGib)
        ->setNetwork($formattedInstanceNetwork);
    $request = (new CreateInstanceRequest())
        ->setParent($formattedParent)
        ->setInstanceId($instanceId)
        ->setInstance($instance);

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

        if ($response->operationSucceeded()) {
            /** @var Instance $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 = LustreClient::locationName('[PROJECT]', '[LOCATION]');
    $instanceId = '[INSTANCE_ID]';
    $instanceFilesystem = '[FILESYSTEM]';
    $instanceCapacityGib = 0;
    $formattedInstanceNetwork = LustreClient::networkName('[PROJECT]', '[NETWORK]');

    create_instance_sample(
        $formattedParent,
        $instanceId,
        $instanceFilesystem,
        $instanceCapacityGib,
        $formattedInstanceNetwork
    );
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Lustre\V1\Client\LustreClient;
use Google\Cloud\Lustre\V1\CreateMirrorRequest;
use Google\Cloud\Lustre\V1\GcsPath;
use Google\Cloud\Lustre\V1\LustrePath;
use Google\Cloud\Lustre\V1\Mirror;
use Google\Cloud\Lustre\V1\Mirror\Direction;
use Google\Rpc\Status;

/**
 * @param string $formattedParent  Parent instance resource where the mirror will be created, in the
 *                                 format: `projects/{project}/locations/{location}/instances/{instance}`
 *                                 Please see {@see LustreClient::instanceName()} for help formatting this field.
 * @param string $mirrorId         The ID to use for the mirror.
 *
 *                                 * Must contain only lowercase letters, numbers, and hyphens.
 *                                 * Must start with a letter.
 *                                 * Must be between 1-63 characters.
 *                                 * Must end with a number or a letter.
 *
 *                                 The ID cannot be changed after the mirror is created.
 * @param string $mirrorGcsPathUri The URI to a Cloud Storage bucket, or a path within a bucket,
 *                                 using the format `gs://<bucket_name>/<optional_path_inside_bucket>/`. If a
 *                                 path inside the bucket is specified, it must end with a forward slash
 *                                 (`/`).
 * @param int    $mirrorDirection  Immutable. Represents the direction of the mirror.
 */
function create_mirror_sample(
    string $formattedParent,
    string $mirrorId,
    string $mirrorGcsPathUri,
    int $mirrorDirection
): void {
    // Create a client.
    $lustreClient = new LustreClient();

    // Prepare the request message.
    $mirrorGcsPath = (new GcsPath())
        ->setUri($mirrorGcsPathUri);
    $mirrorLustrePath = new LustrePath();
    $mirror = (new Mirror())
        ->setGcsPath($mirrorGcsPath)
        ->setLustrePath($mirrorLustrePath)
        ->setDirection($mirrorDirection);
    $request = (new CreateMirrorRequest())
        ->setParent($formattedParent)
        ->setMirrorId($mirrorId)
        ->setMirror($mirror);

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

        if ($response->operationSucceeded()) {
            /** @var Mirror $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 = LustreClient::instanceName('[PROJECT]', '[LOCATION]', '[INSTANCE]');
    $mirrorId = '[MIRROR_ID]';
    $mirrorGcsPathUri = '[URI]';
    $mirrorDirection = Direction::DIRECTION_UNSPECIFIED;

    create_mirror_sample($formattedParent, $mirrorId, $mirrorGcsPathUri, $mirrorDirection);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Lustre\V1\Client\LustreClient;
use Google\Cloud\Lustre\V1\DeleteDirectoryPolicyRequest;
use Google\Rpc\Status;

/**
 * @param string $formattedName The resource name of the directory policy.
 *                              DirectoryPolicy names have the form
 *                              `projects/{project}/locations/{location}/instances/{instance}/directoryPolicies/{id}`. Please see
 *                              {@see LustreClient::directoryPolicyName()} for help formatting this field.
 */
function delete_directory_policy_sample(string $formattedName): void
{
    // Create a client.
    $lustreClient = new LustreClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var OperationResponse $response */
        $response = $lustreClient->deleteDirectoryPolicy($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 = LustreClient::directoryPolicyName(
        '[PROJECT]',
        '[LOCATION]',
        '[INSTANCE]',
        '[DIRECTORY_POLICY]'
    );

    delete_directory_policy_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Lustre\V1\Client\LustreClient;
use Google\Cloud\Lustre\V1\DeleteInstanceRequest;
use Google\Rpc\Status;

/**
 * @param string $formattedName The resource name of the instance to delete, in the format
 *                              `projects/{projectId}/locations/{location}/instances/{instanceId}`. Please see
 *                              {@see LustreClient::instanceName()} for help formatting this field.
 */
function delete_instance_sample(string $formattedName): void
{
    // Create a client.
    $lustreClient = new LustreClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var OperationResponse $response */
        $response = $lustreClient->deleteInstance($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 = LustreClient::instanceName('[PROJECT]', '[LOCATION]', '[INSTANCE]');

    delete_instance_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Lustre\V1\Client\LustreClient;
use Google\Cloud\Lustre\V1\DeleteMirrorRequest;
use Google\Rpc\Status;

/**
 * @param string $formattedName Name of the mirror to delete, in the format:
 *                              `projects/{project}/locations/{location}/instances/{instance}/mirrors/{mirror}`
 *                              Please see {@see LustreClient::mirrorName()} for help formatting this field.
 */
function delete_mirror_sample(string $formattedName): void
{
    // Create a client.
    $lustreClient = new LustreClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var OperationResponse $response */
        $response = $lustreClient->deleteMirror($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 = LustreClient::mirrorName('[PROJECT]', '[LOCATION]', '[INSTANCE]', '[MIRROR]');

    delete_mirror_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Lustre\V1\Client\LustreClient;
use Google\Cloud\Lustre\V1\ExportDataRequest;
use Google\Cloud\Lustre\V1\ExportDataResponse;
use Google\Rpc\Status;

/**
 * @param string $formattedName The name of the Managed Lustre instance in the format
 *                              `projects/{project}/locations/{location}/instances/{instance}`. Please see
 *                              {@see LustreClient::instanceName()} for help formatting this field.
 */
function export_data_sample(string $formattedName): void
{
    // Create a client.
    $lustreClient = new LustreClient();

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

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

        if ($response->operationSucceeded()) {
            /** @var ExportDataResponse $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 = LustreClient::instanceName('[PROJECT]', '[LOCATION]', '[INSTANCE]');

    export_data_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\Cloud\Lustre\V1\Client\LustreClient;
use Google\Cloud\Lustre\V1\DirectoryPolicy;
use Google\Cloud\Lustre\V1\GetDirectoryPolicyRequest;

/**
 * @param string $formattedName The resource name of the directory policy.
 *                              DirectoryPolicy names have the form
 *                              `projects/{project}/locations/{location}/instances/{instance}/directoryPolicies/{id}`. Please see
 *                              {@see LustreClient::directoryPolicyName()} for help formatting this field.
 */
function get_directory_policy_sample(string $formattedName): void
{
    // Create a client.
    $lustreClient = new LustreClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var DirectoryPolicy $response */
        $response = $lustreClient->getDirectoryPolicy($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 = LustreClient::directoryPolicyName(
        '[PROJECT]',
        '[LOCATION]',
        '[INSTANCE]',
        '[DIRECTORY_POLICY]'
    );

    get_directory_policy_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\Cloud\Lustre\V1\Client\LustreClient;
use Google\Cloud\Lustre\V1\GetInstanceRequest;
use Google\Cloud\Lustre\V1\Instance;

/**
 * @param string $formattedName The instance resource name, in the format
 *                              `projects/{projectId}/locations/{location}/instances/{instanceId}`. Please see
 *                              {@see LustreClient::instanceName()} for help formatting this field.
 */
function get_instance_sample(string $formattedName): void
{
    // Create a client.
    $lustreClient = new LustreClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var Instance $response */
        $response = $lustreClient->getInstance($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 = LustreClient::instanceName('[PROJECT]', '[LOCATION]', '[INSTANCE]');

    get_instance_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\Cloud\Lustre\V1\Client\LustreClient;
use Google\Cloud\Lustre\V1\GetMirrorRequest;
use Google\Cloud\Lustre\V1\Mirror;

/**
 * @param string $formattedName Name of the mirror to retrieve, in the format:
 *                              `projects/{project}/locations/{location}/instances/{instance}/mirrors/{mirror}`
 *                              Please see {@see LustreClient::mirrorName()} for help formatting this field.
 */
function get_mirror_sample(string $formattedName): void
{
    // Create a client.
    $lustreClient = new LustreClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var Mirror $response */
        $response = $lustreClient->getMirror($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 = LustreClient::mirrorName('[PROJECT]', '[LOCATION]', '[INSTANCE]', '[MIRROR]');

    get_mirror_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Lustre\V1\Client\LustreClient;
use Google\Cloud\Lustre\V1\ImportDataRequest;
use Google\Cloud\Lustre\V1\ImportDataResponse;
use Google\Rpc\Status;

/**
 * @param string $formattedName The name of the Managed Lustre instance in the format
 *                              `projects/{project}/locations/{location}/instances/{instance}`. Please see
 *                              {@see LustreClient::instanceName()} for help formatting this field.
 */
function import_data_sample(string $formattedName): void
{
    // Create a client.
    $lustreClient = new LustreClient();

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

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

        if ($response->operationSucceeded()) {
            /** @var ImportDataResponse $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 = LustreClient::instanceName('[PROJECT]', '[LOCATION]', '[INSTANCE]');

    import_data_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;
use Google\Cloud\Lustre\V1\Client\LustreClient;
use Google\Cloud\Lustre\V1\DirectoryPolicy;
use Google\Cloud\Lustre\V1\ListDirectoryPoliciesRequest;

/**
 * @param string $formattedParent The parent instance.
 *                                It must be in the format of
 *                                `projects/{project}/locations/{location}/instances/{instance}`. Please see
 *                                {@see LustreClient::instanceName()} for help formatting this field.
 */
function list_directory_policies_sample(string $formattedParent): void
{
    // Create a client.
    $lustreClient = new LustreClient();

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

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

        /** @var DirectoryPolicy $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 = LustreClient::instanceName('[PROJECT]', '[LOCATION]', '[INSTANCE]');

    list_directory_policies_sample($formattedParent);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;
use Google\Cloud\Lustre\V1\Client\LustreClient;
use Google\Cloud\Lustre\V1\Instance;
use Google\Cloud\Lustre\V1\ListInstancesRequest;

/**
 * @param string $formattedParent The project and location for which to retrieve a list of
 *                                instances, in the format `projects/{projectId}/locations/{location}`.
 *
 *                                To retrieve instance information for all locations, use "-" as the value
 *                                of `{location}`. Please see
 *                                {@see LustreClient::locationName()} for help formatting this field.
 */
function list_instances_sample(string $formattedParent): void
{
    // Create a client.
    $lustreClient = new LustreClient();

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

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

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

    list_instances_sample($formattedParent);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;
use Google\Cloud\Lustre\V1\Client\LustreClient;
use Google\Cloud\Lustre\V1\ListMirrorsRequest;
use Google\Cloud\Lustre\V1\Mirror;

/**
 * @param string $formattedParent Parent instance resource where the mirrors will be listed, in the
 *                                format: `projects/{project}/locations/{location}/instances/{instance}`
 *                                Please see {@see LustreClient::instanceName()} for help formatting this field.
 */
function list_mirrors_sample(string $formattedParent): void
{
    // Create a client.
    $lustreClient = new LustreClient();

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

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

        /** @var Mirror $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 = LustreClient::instanceName('[PROJECT]', '[LOCATION]', '[INSTANCE]');

    list_mirrors_sample($formattedParent);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Lustre\V1\Client\LustreClient;
use Google\Cloud\Lustre\V1\Instance;
use Google\Cloud\Lustre\V1\RescheduleMaintenanceRequest;
use Google\Cloud\Lustre\V1\RescheduleMaintenanceRequest\Reschedule;
use Google\Cloud\Lustre\V1\RescheduleMaintenanceRequest\RescheduleType;
use Google\Rpc\Status;

/**
 * @param string $formattedName            Format:
 *                                         projects/{project}/locations/{location}/instances/{instance}
 *                                         Please see {@see LustreClient::instanceName()} for help formatting this field.
 * @param int    $rescheduleRescheduleType The type of rescheduling.
 */
function reschedule_maintenance_sample(string $formattedName, int $rescheduleRescheduleType): void
{
    // Create a client.
    $lustreClient = new LustreClient();

    // Prepare the request message.
    $reschedule = (new Reschedule())
        ->setRescheduleType($rescheduleRescheduleType);
    $request = (new RescheduleMaintenanceRequest())
        ->setName($formattedName)
        ->setReschedule($reschedule);

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

        if ($response->operationSucceeded()) {
            /** @var Instance $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 = LustreClient::instanceName('[PROJECT]', '[LOCATION]', '[INSTANCE]');
    $rescheduleRescheduleType = RescheduleType::RESCHEDULE_TYPE_UNSPECIFIED;

    reschedule_maintenance_sample($formattedName, $rescheduleRescheduleType);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Lustre\V1\Client\LustreClient;
use Google\Cloud\Lustre\V1\Instance;
use Google\Cloud\Lustre\V1\UpdateInstanceRequest;
use Google\Rpc\Status;

/**
 * @param string $instanceFilesystem       Immutable. The filesystem name for this instance. This name is
 *                                         used by client-side tools, including when mounting the instance. Must be
 *                                         eight characters or less and can only contain letters and numbers.
 * @param int    $instanceCapacityGib      The storage capacity of the instance in gibibytes (GiB). Allowed
 *                                         values depend on the `perUnitStorageThroughput`. See [Performance
 *                                         tiers](https://docs.cloud.google.com/managed-lustre/docs/performance-tiers)
 *                                         for specific minimums, maximums, and step sizes for each performance tier.
 * @param string $formattedInstanceNetwork Immutable. The full name of the VPC network to which the instance
 *                                         is connected. Must be in the format
 *                                         `projects/{project_id}/global/networks/{network_name}`. Please see
 *                                         {@see LustreClient::networkName()} for help formatting this field.
 */
function update_instance_sample(
    string $instanceFilesystem,
    int $instanceCapacityGib,
    string $formattedInstanceNetwork
): void {
    // Create a client.
    $lustreClient = new LustreClient();

    // Prepare the request message.
    $instance = (new Instance())
        ->setFilesystem($instanceFilesystem)
        ->setCapacityGib($instanceCapacityGib)
        ->setNetwork($formattedInstanceNetwork);
    $request = (new UpdateInstanceRequest())
        ->setInstance($instance);

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

        if ($response->operationSucceeded()) {
            /** @var Instance $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
{
    $instanceFilesystem = '[FILESYSTEM]';
    $instanceCapacityGib = 0;
    $formattedInstanceNetwork = LustreClient::networkName('[PROJECT]', '[NETWORK]');

    update_instance_sample($instanceFilesystem, $instanceCapacityGib, $formattedInstanceNetwork);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Lustre\V1\Client\LustreClient;
use Google\Cloud\Lustre\V1\GcsPath;
use Google\Cloud\Lustre\V1\LustrePath;
use Google\Cloud\Lustre\V1\Mirror;
use Google\Cloud\Lustre\V1\Mirror\Direction;
use Google\Cloud\Lustre\V1\UpdateMirrorRequest;
use Google\Rpc\Status;

/**
 * @param string $mirrorGcsPathUri The URI to a Cloud Storage bucket, or a path within a bucket,
 *                                 using the format `gs://<bucket_name>/<optional_path_inside_bucket>/`. If a
 *                                 path inside the bucket is specified, it must end with a forward slash
 *                                 (`/`).
 * @param int    $mirrorDirection  Immutable. Represents the direction of the mirror.
 */
function update_mirror_sample(string $mirrorGcsPathUri, int $mirrorDirection): void
{
    // Create a client.
    $lustreClient = new LustreClient();

    // Prepare the request message.
    $mirrorGcsPath = (new GcsPath())
        ->setUri($mirrorGcsPathUri);
    $mirrorLustrePath = new LustrePath();
    $mirror = (new Mirror())
        ->setGcsPath($mirrorGcsPath)
        ->setLustrePath($mirrorLustrePath)
        ->setDirection($mirrorDirection);
    $request = (new UpdateMirrorRequest())
        ->setMirror($mirror);

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

        if ($response->operationSucceeded()) {
            /** @var Mirror $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
{
    $mirrorGcsPathUri = '[URI]';
    $mirrorDirection = Direction::DIRECTION_UNSPECIFIED;

    update_mirror_sample($mirrorGcsPathUri, $mirrorDirection);
}

use Google\ApiCore\ApiException;
use Google\Cloud\Location\GetLocationRequest;
use Google\Cloud\Location\Location;
use Google\Cloud\Lustre\V1\Client\LustreClient;

/**
 * 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.
    $lustreClient = new LustreClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var Location $response */
        $response = $lustreClient->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\Location\ListLocationsRequest;
use Google\Cloud\Location\Location;
use Google\Cloud\Lustre\V1\Client\LustreClient;

/**
 * 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.
    $lustreClient = new LustreClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var PagedListResponse $response */
        $response = $lustreClient->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());
    }
}