Google Cloud Api Hub V1 Client - Class ApiHubPluginClient (0.3.0)

use Google\ApiCore\ApiException;
use Google\Cloud\ApiHub\V1\Client\ApiHubPluginClient;
use Google\Cloud\ApiHub\V1\CreatePluginRequest;
use Google\Cloud\ApiHub\V1\Plugin;

/**
 * @param string $formattedParent   The parent resource where this plugin will be created.
 *                                  Format: `projects/{project}/locations/{location}`. Please see
 *                                  {@see ApiHubPluginClient::locationName()} for help formatting this field.
 * @param string $pluginDisplayName The display name of the plugin. Max length is 50 characters
 *                                  (Unicode code points).
 */
function create_plugin_sample(string $formattedParent, string $pluginDisplayName): void
{
    // Create a client.
    $apiHubPluginClient = new ApiHubPluginClient();

    // Prepare the request message.
    $plugin = (new Plugin())
        ->setDisplayName($pluginDisplayName);
    $request = (new CreatePluginRequest())
        ->setParent($formattedParent)
        ->setPlugin($plugin);

    // Call the API and handle any network failures.
    try {
        /** @var Plugin $response */
        $response = $apiHubPluginClient->createPlugin($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 = ApiHubPluginClient::locationName('[PROJECT]', '[LOCATION]');
    $pluginDisplayName = '[DISPLAY_NAME]';

    create_plugin_sample($formattedParent, $pluginDisplayName);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\ApiHub\V1\Client\ApiHubPluginClient;
use Google\Cloud\ApiHub\V1\CreatePluginInstanceRequest;
use Google\Cloud\ApiHub\V1\PluginInstance;
use Google\Cloud\ApiHub\V1\PluginInstanceAction;
use Google\Rpc\Status;

/**
 * @param string $formattedParent               The parent of the plugin instance resource.
 *                                              Format: `projects/{project}/locations/{location}/plugins/{plugin}`
 *                                              Please see {@see ApiHubPluginClient::pluginName()} for help formatting this field.
 * @param string $pluginInstanceDisplayName     The display name for this plugin instance. Max length is 255
 *                                              characters.
 * @param string $pluginInstanceActionsActionId This should map to one of the [action
 *                                              id][google.cloud.apihub.v1.PluginActionConfig.id] specified in
 *                                              [actions_config][google.cloud.apihub.v1.Plugin.actions_config] in the
 *                                              plugin.
 */
function create_plugin_instance_sample(
    string $formattedParent,
    string $pluginInstanceDisplayName,
    string $pluginInstanceActionsActionId
): void {
    // Create a client.
    $apiHubPluginClient = new ApiHubPluginClient();

    // Prepare the request message.
    $pluginInstanceAction = (new PluginInstanceAction())
        ->setActionId($pluginInstanceActionsActionId);
    $pluginInstanceActions = [$pluginInstanceAction,];
    $pluginInstance = (new PluginInstance())
        ->setDisplayName($pluginInstanceDisplayName)
        ->setActions($pluginInstanceActions);
    $request = (new CreatePluginInstanceRequest())
        ->setParent($formattedParent)
        ->setPluginInstance($pluginInstance);

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

        if ($response->operationSucceeded()) {
            /** @var PluginInstance $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 = ApiHubPluginClient::pluginName('[PROJECT]', '[LOCATION]', '[PLUGIN]');
    $pluginInstanceDisplayName = '[DISPLAY_NAME]';
    $pluginInstanceActionsActionId = '[ACTION_ID]';

    create_plugin_instance_sample(
        $formattedParent,
        $pluginInstanceDisplayName,
        $pluginInstanceActionsActionId
    );
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\ApiHub\V1\Client\ApiHubPluginClient;
use Google\Cloud\ApiHub\V1\DeletePluginRequest;
use Google\Rpc\Status;

/**
 * @param string $formattedName The name of the Plugin resource to delete.
 *                              Format: `projects/{project}/locations/{location}/plugins/{plugin}`
 *                              Please see {@see ApiHubPluginClient::pluginName()} for help formatting this field.
 */
function delete_plugin_sample(string $formattedName): void
{
    // Create a client.
    $apiHubPluginClient = new ApiHubPluginClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var OperationResponse $response */
        $response = $apiHubPluginClient->deletePlugin($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 = ApiHubPluginClient::pluginName('[PROJECT]', '[LOCATION]', '[PLUGIN]');

    delete_plugin_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\ApiHub\V1\Client\ApiHubPluginClient;
use Google\Cloud\ApiHub\V1\DeletePluginInstanceRequest;
use Google\Rpc\Status;

/**
 * @param string $formattedName The name of the plugin instance to delete.
 *                              Format:
 *                              `projects/{project}/locations/{location}/plugins/{plugin}/instances/{instance}`. Please see
 *                              {@see ApiHubPluginClient::pluginInstanceName()} for help formatting this field.
 */
function delete_plugin_instance_sample(string $formattedName): void
{
    // Create a client.
    $apiHubPluginClient = new ApiHubPluginClient();

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

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

    delete_plugin_instance_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\Cloud\ApiHub\V1\Client\ApiHubPluginClient;
use Google\Cloud\ApiHub\V1\DisablePluginRequest;
use Google\Cloud\ApiHub\V1\Plugin;

/**
 * @param string $formattedName The name of the plugin to disable.
 *                              Format: `projects/{project}/locations/{location}/plugins/{plugin}`. Please see
 *                              {@see ApiHubPluginClient::pluginName()} for help formatting this field.
 */
function disable_plugin_sample(string $formattedName): void
{
    // Create a client.
    $apiHubPluginClient = new ApiHubPluginClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var Plugin $response */
        $response = $apiHubPluginClient->disablePlugin($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 = ApiHubPluginClient::pluginName('[PROJECT]', '[LOCATION]', '[PLUGIN]');

    disable_plugin_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\ApiHub\V1\Client\ApiHubPluginClient;
use Google\Cloud\ApiHub\V1\DisablePluginInstanceActionRequest;
use Google\Cloud\ApiHub\V1\DisablePluginInstanceActionResponse;
use Google\Rpc\Status;

/**
 * @param string $formattedName The name of the plugin instance to disable.
 *                              Format:
 *                              `projects/{project}/locations/{location}/plugins/{plugin}/instances/{instance}`
 *                              Please see {@see ApiHubPluginClient::pluginInstanceName()} for help formatting this field.
 * @param string $actionId      The action id to disable.
 */
function disable_plugin_instance_action_sample(string $formattedName, string $actionId): void
{
    // Create a client.
    $apiHubPluginClient = new ApiHubPluginClient();

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

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

        if ($response->operationSucceeded()) {
            /** @var DisablePluginInstanceActionResponse $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 = ApiHubPluginClient::pluginInstanceName(
        '[PROJECT]',
        '[LOCATION]',
        '[PLUGIN]',
        '[INSTANCE]'
    );
    $actionId = '[ACTION_ID]';

    disable_plugin_instance_action_sample($formattedName, $actionId);
}

use Google\ApiCore\ApiException;
use Google\Cloud\ApiHub\V1\Client\ApiHubPluginClient;
use Google\Cloud\ApiHub\V1\EnablePluginRequest;
use Google\Cloud\ApiHub\V1\Plugin;

/**
 * @param string $formattedName The name of the plugin to enable.
 *                              Format: `projects/{project}/locations/{location}/plugins/{plugin}`. Please see
 *                              {@see ApiHubPluginClient::pluginName()} for help formatting this field.
 */
function enable_plugin_sample(string $formattedName): void
{
    // Create a client.
    $apiHubPluginClient = new ApiHubPluginClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var Plugin $response */
        $response = $apiHubPluginClient->enablePlugin($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 = ApiHubPluginClient::pluginName('[PROJECT]', '[LOCATION]', '[PLUGIN]');

    enable_plugin_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\ApiHub\V1\Client\ApiHubPluginClient;
use Google\Cloud\ApiHub\V1\EnablePluginInstanceActionRequest;
use Google\Cloud\ApiHub\V1\EnablePluginInstanceActionResponse;
use Google\Rpc\Status;

/**
 * @param string $formattedName The name of the plugin instance to enable.
 *                              Format:
 *                              `projects/{project}/locations/{location}/plugins/{plugin}/instances/{instance}`
 *                              Please see {@see ApiHubPluginClient::pluginInstanceName()} for help formatting this field.
 * @param string $actionId      The action id to enable.
 */
function enable_plugin_instance_action_sample(string $formattedName, string $actionId): void
{
    // Create a client.
    $apiHubPluginClient = new ApiHubPluginClient();

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

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

        if ($response->operationSucceeded()) {
            /** @var EnablePluginInstanceActionResponse $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 = ApiHubPluginClient::pluginInstanceName(
        '[PROJECT]',
        '[LOCATION]',
        '[PLUGIN]',
        '[INSTANCE]'
    );
    $actionId = '[ACTION_ID]';

    enable_plugin_instance_action_sample($formattedName, $actionId);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\ApiHub\V1\ActionExecutionDetail;
use Google\Cloud\ApiHub\V1\Client\ApiHubPluginClient;
use Google\Cloud\ApiHub\V1\ExecutePluginInstanceActionRequest;
use Google\Cloud\ApiHub\V1\ExecutePluginInstanceActionResponse;
use Google\Rpc\Status;

/**
 * @param string $formattedName                 The name of the plugin instance to execute.
 *                                              Format:
 *                                              `projects/{project}/locations/{location}/plugins/{plugin}/instances/{instance}`
 *                                              Please see {@see ApiHubPluginClient::pluginInstanceName()} for help formatting this field.
 * @param string $actionExecutionDetailActionId The action id of the plugin to execute.
 */
function execute_plugin_instance_action_sample(
    string $formattedName,
    string $actionExecutionDetailActionId
): void {
    // Create a client.
    $apiHubPluginClient = new ApiHubPluginClient();

    // Prepare the request message.
    $actionExecutionDetail = (new ActionExecutionDetail())
        ->setActionId($actionExecutionDetailActionId);
    $request = (new ExecutePluginInstanceActionRequest())
        ->setName($formattedName)
        ->setActionExecutionDetail($actionExecutionDetail);

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

        if ($response->operationSucceeded()) {
            /** @var ExecutePluginInstanceActionResponse $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 = ApiHubPluginClient::pluginInstanceName(
        '[PROJECT]',
        '[LOCATION]',
        '[PLUGIN]',
        '[INSTANCE]'
    );
    $actionExecutionDetailActionId = '[ACTION_ID]';

    execute_plugin_instance_action_sample($formattedName, $actionExecutionDetailActionId);
}

use Google\ApiCore\ApiException;
use Google\Cloud\ApiHub\V1\Client\ApiHubPluginClient;
use Google\Cloud\ApiHub\V1\GetPluginRequest;
use Google\Cloud\ApiHub\V1\Plugin;

/**
 * @param string $formattedName The name of the plugin to retrieve.
 *                              Format: `projects/{project}/locations/{location}/plugins/{plugin}`. Please see
 *                              {@see ApiHubPluginClient::pluginName()} for help formatting this field.
 */
function get_plugin_sample(string $formattedName): void
{
    // Create a client.
    $apiHubPluginClient = new ApiHubPluginClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var Plugin $response */
        $response = $apiHubPluginClient->getPlugin($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 = ApiHubPluginClient::pluginName('[PROJECT]', '[LOCATION]', '[PLUGIN]');

    get_plugin_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\Cloud\ApiHub\V1\Client\ApiHubPluginClient;
use Google\Cloud\ApiHub\V1\GetPluginInstanceRequest;
use Google\Cloud\ApiHub\V1\PluginInstance;

/**
 * @param string $formattedName The name of the plugin instance to retrieve.
 *                              Format:
 *                              `projects/{project}/locations/{location}/plugins/{plugin}/instances/{instance}`
 *                              Please see {@see ApiHubPluginClient::pluginInstanceName()} for help formatting this field.
 */
function get_plugin_instance_sample(string $formattedName): void
{
    // Create a client.
    $apiHubPluginClient = new ApiHubPluginClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var PluginInstance $response */
        $response = $apiHubPluginClient->getPluginInstance($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 = ApiHubPluginClient::pluginInstanceName(
        '[PROJECT]',
        '[LOCATION]',
        '[PLUGIN]',
        '[INSTANCE]'
    );

    get_plugin_instance_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;
use Google\Cloud\ApiHub\V1\Client\ApiHubPluginClient;
use Google\Cloud\ApiHub\V1\ListPluginInstancesRequest;

/**
 * @param string $formattedParent The parent resource where this plugin will be created.
 *                                Format: `projects/{project}/locations/{location}/plugins/{plugin}`.
 *                                To list plugin instances for multiple plugins,
 *                                use the - character instead of the plugin ID. Please see
 *                                {@see ApiHubPluginClient::pluginName()} for help formatting this field.
 */
function list_plugin_instances_sample(string $formattedParent): void
{
    // Create a client.
    $apiHubPluginClient = new ApiHubPluginClient();

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

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

        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 = ApiHubPluginClient::pluginName('[PROJECT]', '[LOCATION]', '[PLUGIN]');

    list_plugin_instances_sample($formattedParent);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;
use Google\Cloud\ApiHub\V1\Client\ApiHubPluginClient;
use Google\Cloud\ApiHub\V1\ListPluginsRequest;

/**
 * @param string $formattedParent The parent resource where this plugin will be created.
 *                                Format: `projects/{project}/locations/{location}`. Please see
 *                                {@see ApiHubPluginClient::locationName()} for help formatting this field.
 */
function list_plugins_sample(string $formattedParent): void
{
    // Create a client.
    $apiHubPluginClient = new ApiHubPluginClient();

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

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

        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 = ApiHubPluginClient::locationName('[PROJECT]', '[LOCATION]');

    list_plugins_sample($formattedParent);
}

use Google\ApiCore\ApiException;
use Google\Cloud\ApiHub\V1\Client\ApiHubPluginClient;
use Google\Cloud\ApiHub\V1\PluginInstance;
use Google\Cloud\ApiHub\V1\PluginInstanceAction;
use Google\Cloud\ApiHub\V1\UpdatePluginInstanceRequest;

/**
 * @param string $pluginInstanceDisplayName     The display name for this plugin instance. Max length is 255
 *                                              characters.
 * @param string $pluginInstanceActionsActionId This should map to one of the [action
 *                                              id][google.cloud.apihub.v1.PluginActionConfig.id] specified in
 *                                              [actions_config][google.cloud.apihub.v1.Plugin.actions_config] in the
 *                                              plugin.
 */
function update_plugin_instance_sample(
    string $pluginInstanceDisplayName,
    string $pluginInstanceActionsActionId
): void {
    // Create a client.
    $apiHubPluginClient = new ApiHubPluginClient();

    // Prepare the request message.
    $pluginInstanceAction = (new PluginInstanceAction())
        ->setActionId($pluginInstanceActionsActionId);
    $pluginInstanceActions = [$pluginInstanceAction,];
    $pluginInstance = (new PluginInstance())
        ->setDisplayName($pluginInstanceDisplayName)
        ->setActions($pluginInstanceActions);
    $request = (new UpdatePluginInstanceRequest())
        ->setPluginInstance($pluginInstance);

    // Call the API and handle any network failures.
    try {
        /** @var PluginInstance $response */
        $response = $apiHubPluginClient->updatePluginInstance($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
{
    $pluginInstanceDisplayName = '[DISPLAY_NAME]';
    $pluginInstanceActionsActionId = '[ACTION_ID]';

    update_plugin_instance_sample($pluginInstanceDisplayName, $pluginInstanceActionsActionId);
}

use Google\ApiCore\ApiException;
use Google\Cloud\ApiHub\V1\Client\ApiHubPluginClient;
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.
    $apiHubPluginClient = new ApiHubPluginClient();

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

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

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

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

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

        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());
    }
}