Google Cloud Dataform V1beta1 Client - Class DataformClient (0.5.1)

Beta

This library is covered by thePre-GA Offerings Terms of the Terms of Service. Pre-GA libraries might have limited support, and changes to pre-GA libraries might not be compatible with other pre-GA versions. For more information, see thelaunch stage descriptions.

Reference documentation and code samples for the Google Cloud Dataform V1beta1 Client class DataformClient.

Service Description: Dataform is a service to develop, create, document, test, and update curatedtables in BigQuery.

This class provides the ability to make remote calls to the backing service through methodcalls that map to API methods.

Many parameters require resource names to be formatted in a particular way. Toassist with these names, this class includes a format method for each type ofname, and additionally a parseName method to extract the individual identifierscontained within formatted names that are returned by the API.

Namespace

Google \ Cloud \ Dataform \ V1beta1 \ Client

Methods

__construct

Constructor.

Parameters
NameDescription
optionsarray

Optional. Options for configuring the service API wrapper.

↳ apiEndpointstring

The address of the API remote host. May optionally include the port, formatted as "

↳ credentialsstring|array|FetchAuthTokenInterface|CredentialsWrapper

The credentials to be used by the client to authorize API calls. This option accepts either a path to a credentials file, or a decoded credentials file as a PHP array.Advanced usage: In addition, this option can also accept a pre-constructedGoogle\Auth\FetchAuthTokenInterface object orGoogle\ApiCore\CredentialsWrapper object. Note that when one of these objects are provided, any settings in $credentialsConfig will be ignored.Important: If you accept a credential configuration (credential JSON/File/Stream) from an external source for authentication to Google Cloud Platform, you must validate it before providing it to any Google API or library. Providing an unvalidated credential configuration to Google APIs can compromise the security of your systems and data. For more informationhttps://cloud.google.com/docs/authentication/external/externally-sourced-credentials

↳ credentialsConfigarray

Options used to configure credentials, including auth token caching, for the client. For a full list of supporting configuration options, seeGoogle\ApiCore\CredentialsWrapper::build() .

↳ disableRetriesbool

Determines whether or not retries defined by the client configuration should be disabled. Defaults tofalse.

↳ clientConfigstring|array

Client method configuration, including retry settings. This option can be either a path to a JSON file, or a PHP array containing the decoded JSON data. By default this settings points to the default client config file, which is provided in the resources folder.

↳ transportstring|TransportInterface

The transport used for executing network requests. May be either the stringrest orgrpc. Defaults togrpc if gRPC support is detected on the system.Advanced usage: Additionally, it is possible to pass in an already instantiatedGoogle\ApiCore\Transport\TransportInterface object. Note that when this object is provided, any settings in $transportConfig, and any $apiEndpoint setting, will be ignored.

↳ transportConfigarray

Configuration options that will be used to construct the transport. Options for each supported transport type should be passed in a key for that transport. For example: $transportConfig = [ 'grpc' => [...], 'rest' => [...], ]; See theGoogle\ApiCore\Transport\GrpcTransport::build() andGoogle\ApiCore\Transport\RestTransport::build() methods for the supported options.

↳ clientCertSourcecallable

A callable which returns the client cert as a string. This can be used to provide a certificate and private key to the transport layer for mTLS.

↳ loggerfalse|LoggerInterface

A PSR-3 compliant logger. If set to false, logging is disabled, ignoring the 'GOOGLE_SDK_PHP_LOGGING' environment flag

cancelWorkflowInvocation

Requests cancellation of a running WorkflowInvocation.

The async variant isDataformClient::cancelWorkflowInvocationAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\CancelWorkflowInvocationRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\CancelWorkflowInvocationRequest;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;/** * @param string $formattedName The workflow invocation resource's name. Please see *                              {@see DataformClient::workflowInvocationName()} for help formatting this field. */function cancel_workflow_invocation_sample(string $formattedName): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new CancelWorkflowInvocationRequest())        ->setName($formattedName);    // Call the API and handle any network failures.    try {        $dataformClient->cancelWorkflowInvocation($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 = DataformClient::workflowInvocationName(        '[PROJECT]',        '[LOCATION]',        '[REPOSITORY]',        '[WORKFLOW_INVOCATION]'    );    cancel_workflow_invocation_sample($formattedName);}

commitRepositoryChanges

Applies a Git commit to a Repository. The Repository must not have a valueforgit_remote_settings.url.

The async variant isDataformClient::commitRepositoryChangesAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\CommitRepositoryChangesRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\CommitAuthor;use Google\Cloud\Dataform\V1beta1\CommitMetadata;use Google\Cloud\Dataform\V1beta1\CommitRepositoryChangesRequest;/** * @param string $formattedName                    The repository's name. Please see *                                                 {@see DataformClient::repositoryName()} for help formatting this field. * @param string $commitMetadataAuthorName         The commit author's name. * @param string $commitMetadataAuthorEmailAddress The commit author's email address. */function commit_repository_changes_sample(    string $formattedName,    string $commitMetadataAuthorName,    string $commitMetadataAuthorEmailAddress): void {    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $commitMetadataAuthor = (new CommitAuthor())        ->setName($commitMetadataAuthorName)        ->setEmailAddress($commitMetadataAuthorEmailAddress);    $commitMetadata = (new CommitMetadata())        ->setAuthor($commitMetadataAuthor);    $request = (new CommitRepositoryChangesRequest())        ->setName($formattedName)        ->setCommitMetadata($commitMetadata);    // Call the API and handle any network failures.    try {        $dataformClient->commitRepositoryChanges($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 = DataformClient::repositoryName('[PROJECT]', '[LOCATION]', '[REPOSITORY]');    $commitMetadataAuthorName = '[NAME]';    $commitMetadataAuthorEmailAddress = '[EMAIL_ADDRESS]';    commit_repository_changes_sample(        $formattedName,        $commitMetadataAuthorName,        $commitMetadataAuthorEmailAddress    );}

commitWorkspaceChanges

Applies a Git commit for uncommitted files in a Workspace.

The async variant isDataformClient::commitWorkspaceChangesAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\CommitWorkspaceChangesRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\CommitAuthor;use Google\Cloud\Dataform\V1beta1\CommitWorkspaceChangesRequest;/** * @param string $formattedName      The workspace's name. Please see *                                   {@see DataformClient::workspaceName()} for help formatting this field. * @param string $authorName         The commit author's name. * @param string $authorEmailAddress The commit author's email address. */function commit_workspace_changes_sample(    string $formattedName,    string $authorName,    string $authorEmailAddress): void {    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $author = (new CommitAuthor())        ->setName($authorName)        ->setEmailAddress($authorEmailAddress);    $request = (new CommitWorkspaceChangesRequest())        ->setName($formattedName)        ->setAuthor($author);    // Call the API and handle any network failures.    try {        $dataformClient->commitWorkspaceChanges($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 = DataformClient::workspaceName(        '[PROJECT]',        '[LOCATION]',        '[REPOSITORY]',        '[WORKSPACE]'    );    $authorName = '[NAME]';    $authorEmailAddress = '[EMAIL_ADDRESS]';    commit_workspace_changes_sample($formattedName, $authorName, $authorEmailAddress);}

computeRepositoryAccessTokenStatus

Computes a Repository's Git access token status.

The async variant isDataformClient::computeRepositoryAccessTokenStatusAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\ComputeRepositoryAccessTokenStatusRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\Cloud\Dataform\V1beta1\ComputeRepositoryAccessTokenStatusResponse
Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\ComputeRepositoryAccessTokenStatusRequest;use Google\Cloud\Dataform\V1beta1\ComputeRepositoryAccessTokenStatusResponse;/** * @param string $formattedName The repository's name. Please see *                              {@see DataformClient::repositoryName()} for help formatting this field. */function compute_repository_access_token_status_sample(string $formattedName): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new ComputeRepositoryAccessTokenStatusRequest())        ->setName($formattedName);    // Call the API and handle any network failures.    try {        /** @var ComputeRepositoryAccessTokenStatusResponse $response */        $response = $dataformClient->computeRepositoryAccessTokenStatus($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 = DataformClient::repositoryName('[PROJECT]', '[LOCATION]', '[REPOSITORY]');    compute_repository_access_token_status_sample($formattedName);}

createCompilationResult

Creates a new CompilationResult in a given project and location.

The async variant isDataformClient::createCompilationResultAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\CreateCompilationResultRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\Cloud\Dataform\V1beta1\CompilationResult
Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\CompilationResult;use Google\Cloud\Dataform\V1beta1\CreateCompilationResultRequest;/** * @param string $formattedParent The repository in which to create the compilation result. Must be *                                in the format `projects/*/locations/*/repositories/*`. Please see *                                {@see DataformClient::repositoryName()} for help formatting this field. */function create_compilation_result_sample(string $formattedParent): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $compilationResult = new CompilationResult();    $request = (new CreateCompilationResultRequest())        ->setParent($formattedParent)        ->setCompilationResult($compilationResult);    // Call the API and handle any network failures.    try {        /** @var CompilationResult $response */        $response = $dataformClient->createCompilationResult($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 = DataformClient::repositoryName('[PROJECT]', '[LOCATION]', '[REPOSITORY]');    create_compilation_result_sample($formattedParent);}

createReleaseConfig

Creates a new ReleaseConfig in a given Repository.

The async variant isDataformClient::createReleaseConfigAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\CreateReleaseConfigRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\Cloud\Dataform\V1beta1\ReleaseConfig
Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\CreateReleaseConfigRequest;use Google\Cloud\Dataform\V1beta1\ReleaseConfig;/** * @param string $formattedParent           The repository in which to create the release config. Must be in *                                          the format `projects/*/locations/*/repositories/*`. Please see *                                          {@see DataformClient::repositoryName()} for help formatting this field. * @param string $releaseConfigGitCommitish Git commit/tag/branch name at which the repository should be *                                          compiled. Must exist in the remote repository. Examples: *                                          - a commit SHA: `12ade345` *                                          - a tag: `tag1` *                                          - a branch name: `branch1` * @param string $releaseConfigId           The ID to use for the release config, which will become the final *                                          component of the release config's resource name. */function create_release_config_sample(    string $formattedParent,    string $releaseConfigGitCommitish,    string $releaseConfigId): void {    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $releaseConfig = (new ReleaseConfig())        ->setGitCommitish($releaseConfigGitCommitish);    $request = (new CreateReleaseConfigRequest())        ->setParent($formattedParent)        ->setReleaseConfig($releaseConfig)        ->setReleaseConfigId($releaseConfigId);    // Call the API and handle any network failures.    try {        /** @var ReleaseConfig $response */        $response = $dataformClient->createReleaseConfig($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 = DataformClient::repositoryName('[PROJECT]', '[LOCATION]', '[REPOSITORY]');    $releaseConfigGitCommitish = '[GIT_COMMITISH]';    $releaseConfigId = '[RELEASE_CONFIG_ID]';    create_release_config_sample($formattedParent, $releaseConfigGitCommitish, $releaseConfigId);}

createRepository

Creates a new Repository in a given project and location.

The async variant isDataformClient::createRepositoryAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\CreateRepositoryRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\Cloud\Dataform\V1beta1\Repository
Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\CreateRepositoryRequest;use Google\Cloud\Dataform\V1beta1\Repository;/** * @param string $formattedParent The location in which to create the repository. Must be in the *                                format `projects/*/locations/*`. Please see *                                {@see DataformClient::locationName()} for help formatting this field. * @param string $repositoryId    The ID to use for the repository, which will become the final *                                component of the repository's resource name. */function create_repository_sample(string $formattedParent, string $repositoryId): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $repository = new Repository();    $request = (new CreateRepositoryRequest())        ->setParent($formattedParent)        ->setRepository($repository)        ->setRepositoryId($repositoryId);    // Call the API and handle any network failures.    try {        /** @var Repository $response */        $response = $dataformClient->createRepository($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 = DataformClient::locationName('[PROJECT]', '[LOCATION]');    $repositoryId = '[REPOSITORY_ID]';    create_repository_sample($formattedParent, $repositoryId);}

createWorkflowConfig

Creates a new WorkflowConfig in a given Repository.

The async variant isDataformClient::createWorkflowConfigAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\CreateWorkflowConfigRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\Cloud\Dataform\V1beta1\WorkflowConfig
Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\CreateWorkflowConfigRequest;use Google\Cloud\Dataform\V1beta1\WorkflowConfig;/** * @param string $formattedParent                      The repository in which to create the workflow config. Must be in *                                                     the format `projects/*/locations/*/repositories/*`. Please see *                                                     {@see DataformClient::repositoryName()} for help formatting this field. * @param string $formattedWorkflowConfigReleaseConfig The name of the release config whose release_compilation_result *                                                     should be executed. Must be in the format *                                                     `projects/*/locations/*/repositories/*/releaseConfigs/*`. Please see *                                                     {@see DataformClient::releaseConfigName()} for help formatting this field. * @param string $workflowConfigId                     The ID to use for the workflow config, which will become the *                                                     final component of the workflow config's resource name. */function create_workflow_config_sample(    string $formattedParent,    string $formattedWorkflowConfigReleaseConfig,    string $workflowConfigId): void {    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $workflowConfig = (new WorkflowConfig())        ->setReleaseConfig($formattedWorkflowConfigReleaseConfig);    $request = (new CreateWorkflowConfigRequest())        ->setParent($formattedParent)        ->setWorkflowConfig($workflowConfig)        ->setWorkflowConfigId($workflowConfigId);    // Call the API and handle any network failures.    try {        /** @var WorkflowConfig $response */        $response = $dataformClient->createWorkflowConfig($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 = DataformClient::repositoryName('[PROJECT]', '[LOCATION]', '[REPOSITORY]');    $formattedWorkflowConfigReleaseConfig = DataformClient::releaseConfigName(        '[PROJECT]',        '[LOCATION]',        '[REPOSITORY]',        '[RELEASE_CONFIG]'    );    $workflowConfigId = '[WORKFLOW_CONFIG_ID]';    create_workflow_config_sample(        $formattedParent,        $formattedWorkflowConfigReleaseConfig,        $workflowConfigId    );}

createWorkflowInvocation

Creates a new WorkflowInvocation in a given Repository.

The async variant isDataformClient::createWorkflowInvocationAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\CreateWorkflowInvocationRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\Cloud\Dataform\V1beta1\WorkflowInvocation
Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\CreateWorkflowInvocationRequest;use Google\Cloud\Dataform\V1beta1\WorkflowInvocation;/** * @param string $formattedParent The repository in which to create the workflow invocation. Must *                                be in the format `projects/*/locations/*/repositories/*`. Please see *                                {@see DataformClient::repositoryName()} for help formatting this field. */function create_workflow_invocation_sample(string $formattedParent): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $workflowInvocation = new WorkflowInvocation();    $request = (new CreateWorkflowInvocationRequest())        ->setParent($formattedParent)        ->setWorkflowInvocation($workflowInvocation);    // Call the API and handle any network failures.    try {        /** @var WorkflowInvocation $response */        $response = $dataformClient->createWorkflowInvocation($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 = DataformClient::repositoryName('[PROJECT]', '[LOCATION]', '[REPOSITORY]');    create_workflow_invocation_sample($formattedParent);}

createWorkspace

Creates a new Workspace in a given Repository.

The async variant isDataformClient::createWorkspaceAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\CreateWorkspaceRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\Cloud\Dataform\V1beta1\Workspace
Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\CreateWorkspaceRequest;use Google\Cloud\Dataform\V1beta1\Workspace;/** * @param string $formattedParent The repository in which to create the workspace. Must be in the *                                format `projects/*/locations/*/repositories/*`. Please see *                                {@see DataformClient::repositoryName()} for help formatting this field. * @param string $workspaceId     The ID to use for the workspace, which will become the final *                                component of the workspace's resource name. */function create_workspace_sample(string $formattedParent, string $workspaceId): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $workspace = new Workspace();    $request = (new CreateWorkspaceRequest())        ->setParent($formattedParent)        ->setWorkspace($workspace)        ->setWorkspaceId($workspaceId);    // Call the API and handle any network failures.    try {        /** @var Workspace $response */        $response = $dataformClient->createWorkspace($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 = DataformClient::repositoryName('[PROJECT]', '[LOCATION]', '[REPOSITORY]');    $workspaceId = '[WORKSPACE_ID]';    create_workspace_sample($formattedParent, $workspaceId);}

deleteReleaseConfig

Deletes a single ReleaseConfig.

The async variant isDataformClient::deleteReleaseConfigAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\DeleteReleaseConfigRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\DeleteReleaseConfigRequest;/** * @param string $formattedName The release config's name. Please see *                              {@see DataformClient::releaseConfigName()} for help formatting this field. */function delete_release_config_sample(string $formattedName): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new DeleteReleaseConfigRequest())        ->setName($formattedName);    // Call the API and handle any network failures.    try {        $dataformClient->deleteReleaseConfig($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 = DataformClient::releaseConfigName(        '[PROJECT]',        '[LOCATION]',        '[REPOSITORY]',        '[RELEASE_CONFIG]'    );    delete_release_config_sample($formattedName);}

deleteRepository

Deletes a single Repository.

The async variant isDataformClient::deleteRepositoryAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\DeleteRepositoryRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\DeleteRepositoryRequest;/** * @param string $formattedName The repository's name. Please see *                              {@see DataformClient::repositoryName()} for help formatting this field. */function delete_repository_sample(string $formattedName): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new DeleteRepositoryRequest())        ->setName($formattedName);    // Call the API and handle any network failures.    try {        $dataformClient->deleteRepository($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 = DataformClient::repositoryName('[PROJECT]', '[LOCATION]', '[REPOSITORY]');    delete_repository_sample($formattedName);}

deleteWorkflowConfig

Deletes a single WorkflowConfig.

The async variant isDataformClient::deleteWorkflowConfigAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\DeleteWorkflowConfigRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\DeleteWorkflowConfigRequest;/** * @param string $formattedName The workflow config's name. Please see *                              {@see DataformClient::workflowConfigName()} for help formatting this field. */function delete_workflow_config_sample(string $formattedName): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new DeleteWorkflowConfigRequest())        ->setName($formattedName);    // Call the API and handle any network failures.    try {        $dataformClient->deleteWorkflowConfig($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 = DataformClient::workflowConfigName(        '[PROJECT]',        '[LOCATION]',        '[REPOSITORY]',        '[WORKFLOW_CONFIG]'    );    delete_workflow_config_sample($formattedName);}

deleteWorkflowInvocation

Deletes a single WorkflowInvocation.

The async variant isDataformClient::deleteWorkflowInvocationAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\DeleteWorkflowInvocationRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\DeleteWorkflowInvocationRequest;/** * @param string $formattedName The workflow invocation resource's name. Please see *                              {@see DataformClient::workflowInvocationName()} for help formatting this field. */function delete_workflow_invocation_sample(string $formattedName): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new DeleteWorkflowInvocationRequest())        ->setName($formattedName);    // Call the API and handle any network failures.    try {        $dataformClient->deleteWorkflowInvocation($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 = DataformClient::workflowInvocationName(        '[PROJECT]',        '[LOCATION]',        '[REPOSITORY]',        '[WORKFLOW_INVOCATION]'    );    delete_workflow_invocation_sample($formattedName);}

deleteWorkspace

Deletes a single Workspace.

The async variant isDataformClient::deleteWorkspaceAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\DeleteWorkspaceRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\DeleteWorkspaceRequest;/** * @param string $formattedName The workspace resource's name. Please see *                              {@see DataformClient::workspaceName()} for help formatting this field. */function delete_workspace_sample(string $formattedName): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new DeleteWorkspaceRequest())        ->setName($formattedName);    // Call the API and handle any network failures.    try {        $dataformClient->deleteWorkspace($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 = DataformClient::workspaceName(        '[PROJECT]',        '[LOCATION]',        '[REPOSITORY]',        '[WORKSPACE]'    );    delete_workspace_sample($formattedName);}

fetchFileDiff

Fetches Git diff for an uncommitted file in a Workspace.

The async variant isDataformClient::fetchFileDiffAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\FetchFileDiffRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\Cloud\Dataform\V1beta1\FetchFileDiffResponse
Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\FetchFileDiffRequest;use Google\Cloud\Dataform\V1beta1\FetchFileDiffResponse;/** * @param string $formattedWorkspace The workspace's name. Please see *                                   {@see DataformClient::workspaceName()} for help formatting this field. * @param string $path               The file's full path including filename, relative to the *                                   workspace root. */function fetch_file_diff_sample(string $formattedWorkspace, string $path): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new FetchFileDiffRequest())        ->setWorkspace($formattedWorkspace)        ->setPath($path);    // Call the API and handle any network failures.    try {        /** @var FetchFileDiffResponse $response */        $response = $dataformClient->fetchFileDiff($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{    $formattedWorkspace = DataformClient::workspaceName(        '[PROJECT]',        '[LOCATION]',        '[REPOSITORY]',        '[WORKSPACE]'    );    $path = '[PATH]';    fetch_file_diff_sample($formattedWorkspace, $path);}

fetchFileGitStatuses

Fetches Git statuses for the files in a Workspace.

The async variant isDataformClient::fetchFileGitStatusesAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\FetchFileGitStatusesRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\Cloud\Dataform\V1beta1\FetchFileGitStatusesResponse
Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\FetchFileGitStatusesRequest;use Google\Cloud\Dataform\V1beta1\FetchFileGitStatusesResponse;/** * @param string $formattedName The workspace's name. Please see *                              {@see DataformClient::workspaceName()} for help formatting this field. */function fetch_file_git_statuses_sample(string $formattedName): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new FetchFileGitStatusesRequest())        ->setName($formattedName);    // Call the API and handle any network failures.    try {        /** @var FetchFileGitStatusesResponse $response */        $response = $dataformClient->fetchFileGitStatuses($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 = DataformClient::workspaceName(        '[PROJECT]',        '[LOCATION]',        '[REPOSITORY]',        '[WORKSPACE]'    );    fetch_file_git_statuses_sample($formattedName);}

fetchGitAheadBehind

Fetches Git ahead/behind against a remote branch.

The async variant isDataformClient::fetchGitAheadBehindAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\FetchGitAheadBehindRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\Cloud\Dataform\V1beta1\FetchGitAheadBehindResponse
Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\FetchGitAheadBehindRequest;use Google\Cloud\Dataform\V1beta1\FetchGitAheadBehindResponse;/** * @param string $formattedName The workspace's name. Please see *                              {@see DataformClient::workspaceName()} for help formatting this field. */function fetch_git_ahead_behind_sample(string $formattedName): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new FetchGitAheadBehindRequest())        ->setName($formattedName);    // Call the API and handle any network failures.    try {        /** @var FetchGitAheadBehindResponse $response */        $response = $dataformClient->fetchGitAheadBehind($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 = DataformClient::workspaceName(        '[PROJECT]',        '[LOCATION]',        '[REPOSITORY]',        '[WORKSPACE]'    );    fetch_git_ahead_behind_sample($formattedName);}

fetchRemoteBranches

Fetches a Repository's remote branches.

The async variant isDataformClient::fetchRemoteBranchesAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\FetchRemoteBranchesRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\Cloud\Dataform\V1beta1\FetchRemoteBranchesResponse
Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\FetchRemoteBranchesRequest;use Google\Cloud\Dataform\V1beta1\FetchRemoteBranchesResponse;/** * @param string $formattedName The repository's name. Please see *                              {@see DataformClient::repositoryName()} for help formatting this field. */function fetch_remote_branches_sample(string $formattedName): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new FetchRemoteBranchesRequest())        ->setName($formattedName);    // Call the API and handle any network failures.    try {        /** @var FetchRemoteBranchesResponse $response */        $response = $dataformClient->fetchRemoteBranches($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 = DataformClient::repositoryName('[PROJECT]', '[LOCATION]', '[REPOSITORY]');    fetch_remote_branches_sample($formattedName);}

fetchRepositoryHistory

Fetches a Repository's history of commits. The Repository must not have avalue forgit_remote_settings.url.

The async variant isDataformClient::fetchRepositoryHistoryAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\FetchRepositoryHistoryRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\ApiCore\PagedListResponse
Example
use Google\ApiCore\ApiException;use Google\ApiCore\PagedListResponse;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\CommitLogEntry;use Google\Cloud\Dataform\V1beta1\FetchRepositoryHistoryRequest;/** * @param string $formattedName The repository's name. Please see *                              {@see DataformClient::repositoryName()} for help formatting this field. */function fetch_repository_history_sample(string $formattedName): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new FetchRepositoryHistoryRequest())        ->setName($formattedName);    // Call the API and handle any network failures.    try {        /** @var PagedListResponse $response */        $response = $dataformClient->fetchRepositoryHistory($request);        /** @var CommitLogEntry $element */        foreach ($response as $element) {            printf('Element data: %s' . PHP_EOL, $element->serializeToJsonString());        }    } catch (ApiException $ex) {        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());    }}/** * Helper to execute the sample. * * This sample has been automatically generated and should be regarded as a code * template only. It will require modifications to work: *  - It may require correct/in-range values for request initialization. *  - It may require specifying regional endpoints when creating the service client, *    please see the apiEndpoint client configuration option for more details. */function callSample(): void{    $formattedName = DataformClient::repositoryName('[PROJECT]', '[LOCATION]', '[REPOSITORY]');    fetch_repository_history_sample($formattedName);}

getCompilationResult

Fetches a single CompilationResult.

The async variant isDataformClient::getCompilationResultAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\GetCompilationResultRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\Cloud\Dataform\V1beta1\CompilationResult
Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\CompilationResult;use Google\Cloud\Dataform\V1beta1\GetCompilationResultRequest;/** * @param string $formattedName The compilation result's name. Please see *                              {@see DataformClient::compilationResultName()} for help formatting this field. */function get_compilation_result_sample(string $formattedName): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new GetCompilationResultRequest())        ->setName($formattedName);    // Call the API and handle any network failures.    try {        /** @var CompilationResult $response */        $response = $dataformClient->getCompilationResult($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 = DataformClient::compilationResultName(        '[PROJECT]',        '[LOCATION]',        '[REPOSITORY]',        '[COMPILATION_RESULT]'    );    get_compilation_result_sample($formattedName);}

getReleaseConfig

Fetches a single ReleaseConfig.

The async variant isDataformClient::getReleaseConfigAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\GetReleaseConfigRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\Cloud\Dataform\V1beta1\ReleaseConfig
Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\GetReleaseConfigRequest;use Google\Cloud\Dataform\V1beta1\ReleaseConfig;/** * @param string $formattedName The release config's name. Please see *                              {@see DataformClient::releaseConfigName()} for help formatting this field. */function get_release_config_sample(string $formattedName): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new GetReleaseConfigRequest())        ->setName($formattedName);    // Call the API and handle any network failures.    try {        /** @var ReleaseConfig $response */        $response = $dataformClient->getReleaseConfig($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 = DataformClient::releaseConfigName(        '[PROJECT]',        '[LOCATION]',        '[REPOSITORY]',        '[RELEASE_CONFIG]'    );    get_release_config_sample($formattedName);}

getRepository

Fetches a single Repository.

The async variant isDataformClient::getRepositoryAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\GetRepositoryRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\Cloud\Dataform\V1beta1\Repository
Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\GetRepositoryRequest;use Google\Cloud\Dataform\V1beta1\Repository;/** * @param string $formattedName The repository's name. Please see *                              {@see DataformClient::repositoryName()} for help formatting this field. */function get_repository_sample(string $formattedName): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new GetRepositoryRequest())        ->setName($formattedName);    // Call the API and handle any network failures.    try {        /** @var Repository $response */        $response = $dataformClient->getRepository($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 = DataformClient::repositoryName('[PROJECT]', '[LOCATION]', '[REPOSITORY]');    get_repository_sample($formattedName);}

getWorkflowConfig

Fetches a single WorkflowConfig.

The async variant isDataformClient::getWorkflowConfigAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\GetWorkflowConfigRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\Cloud\Dataform\V1beta1\WorkflowConfig
Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\GetWorkflowConfigRequest;use Google\Cloud\Dataform\V1beta1\WorkflowConfig;/** * @param string $formattedName The workflow config's name. Please see *                              {@see DataformClient::workflowConfigName()} for help formatting this field. */function get_workflow_config_sample(string $formattedName): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new GetWorkflowConfigRequest())        ->setName($formattedName);    // Call the API and handle any network failures.    try {        /** @var WorkflowConfig $response */        $response = $dataformClient->getWorkflowConfig($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 = DataformClient::workflowConfigName(        '[PROJECT]',        '[LOCATION]',        '[REPOSITORY]',        '[WORKFLOW_CONFIG]'    );    get_workflow_config_sample($formattedName);}

getWorkflowInvocation

Fetches a single WorkflowInvocation.

The async variant isDataformClient::getWorkflowInvocationAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\GetWorkflowInvocationRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\Cloud\Dataform\V1beta1\WorkflowInvocation
Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\GetWorkflowInvocationRequest;use Google\Cloud\Dataform\V1beta1\WorkflowInvocation;/** * @param string $formattedName The workflow invocation resource's name. Please see *                              {@see DataformClient::workflowInvocationName()} for help formatting this field. */function get_workflow_invocation_sample(string $formattedName): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new GetWorkflowInvocationRequest())        ->setName($formattedName);    // Call the API and handle any network failures.    try {        /** @var WorkflowInvocation $response */        $response = $dataformClient->getWorkflowInvocation($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 = DataformClient::workflowInvocationName(        '[PROJECT]',        '[LOCATION]',        '[REPOSITORY]',        '[WORKFLOW_INVOCATION]'    );    get_workflow_invocation_sample($formattedName);}

getWorkspace

Fetches a single Workspace.

The async variant isDataformClient::getWorkspaceAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\GetWorkspaceRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\Cloud\Dataform\V1beta1\Workspace
Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\GetWorkspaceRequest;use Google\Cloud\Dataform\V1beta1\Workspace;/** * @param string $formattedName The workspace's name. Please see *                              {@see DataformClient::workspaceName()} for help formatting this field. */function get_workspace_sample(string $formattedName): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new GetWorkspaceRequest())        ->setName($formattedName);    // Call the API and handle any network failures.    try {        /** @var Workspace $response */        $response = $dataformClient->getWorkspace($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 = DataformClient::workspaceName(        '[PROJECT]',        '[LOCATION]',        '[REPOSITORY]',        '[WORKSPACE]'    );    get_workspace_sample($formattedName);}

installNpmPackages

Installs dependency NPM packages (inside a Workspace).

The async variant isDataformClient::installNpmPackagesAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\InstallNpmPackagesRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\Cloud\Dataform\V1beta1\InstallNpmPackagesResponse
Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\InstallNpmPackagesRequest;use Google\Cloud\Dataform\V1beta1\InstallNpmPackagesResponse;/** * @param string $formattedWorkspace The workspace's name. Please see *                                   {@see DataformClient::workspaceName()} for help formatting this field. */function install_npm_packages_sample(string $formattedWorkspace): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new InstallNpmPackagesRequest())        ->setWorkspace($formattedWorkspace);    // Call the API and handle any network failures.    try {        /** @var InstallNpmPackagesResponse $response */        $response = $dataformClient->installNpmPackages($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{    $formattedWorkspace = DataformClient::workspaceName(        '[PROJECT]',        '[LOCATION]',        '[REPOSITORY]',        '[WORKSPACE]'    );    install_npm_packages_sample($formattedWorkspace);}

listCompilationResults

Lists CompilationResults in a given Repository.

The async variant isDataformClient::listCompilationResultsAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\ListCompilationResultsRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\ApiCore\PagedListResponse
Example
use Google\ApiCore\ApiException;use Google\ApiCore\PagedListResponse;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\CompilationResult;use Google\Cloud\Dataform\V1beta1\ListCompilationResultsRequest;/** * @param string $formattedParent The repository in which to list compilation results. Must be in *                                the format `projects/*/locations/*/repositories/*`. Please see *                                {@see DataformClient::repositoryName()} for help formatting this field. */function list_compilation_results_sample(string $formattedParent): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new ListCompilationResultsRequest())        ->setParent($formattedParent);    // Call the API and handle any network failures.    try {        /** @var PagedListResponse $response */        $response = $dataformClient->listCompilationResults($request);        /** @var CompilationResult $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 = DataformClient::repositoryName('[PROJECT]', '[LOCATION]', '[REPOSITORY]');    list_compilation_results_sample($formattedParent);}

listReleaseConfigs

Lists ReleaseConfigs in a given Repository.

The async variant isDataformClient::listReleaseConfigsAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\ListReleaseConfigsRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\ApiCore\PagedListResponse
Example
use Google\ApiCore\ApiException;use Google\ApiCore\PagedListResponse;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\ListReleaseConfigsRequest;use Google\Cloud\Dataform\V1beta1\ReleaseConfig;/** * @param string $formattedParent The repository in which to list release configs. Must be in the *                                format `projects/*/locations/*/repositories/*`. Please see *                                {@see DataformClient::repositoryName()} for help formatting this field. */function list_release_configs_sample(string $formattedParent): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new ListReleaseConfigsRequest())        ->setParent($formattedParent);    // Call the API and handle any network failures.    try {        /** @var PagedListResponse $response */        $response = $dataformClient->listReleaseConfigs($request);        /** @var ReleaseConfig $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 = DataformClient::repositoryName('[PROJECT]', '[LOCATION]', '[REPOSITORY]');    list_release_configs_sample($formattedParent);}

listRepositories

Lists Repositories in a given project and location.

The async variant isDataformClient::listRepositoriesAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\ListRepositoriesRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\ApiCore\PagedListResponse
Example
use Google\ApiCore\ApiException;use Google\ApiCore\PagedListResponse;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\ListRepositoriesRequest;use Google\Cloud\Dataform\V1beta1\Repository;/** * @param string $formattedParent The location in which to list repositories. Must be in the format *                                `projects/*/locations/*`. Please see *                                {@see DataformClient::locationName()} for help formatting this field. */function list_repositories_sample(string $formattedParent): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new ListRepositoriesRequest())        ->setParent($formattedParent);    // Call the API and handle any network failures.    try {        /** @var PagedListResponse $response */        $response = $dataformClient->listRepositories($request);        /** @var Repository $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 = DataformClient::locationName('[PROJECT]', '[LOCATION]');    list_repositories_sample($formattedParent);}

listWorkflowConfigs

Lists WorkflowConfigs in a given Repository.

The async variant isDataformClient::listWorkflowConfigsAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\ListWorkflowConfigsRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\ApiCore\PagedListResponse
Example
use Google\ApiCore\ApiException;use Google\ApiCore\PagedListResponse;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\ListWorkflowConfigsRequest;use Google\Cloud\Dataform\V1beta1\WorkflowConfig;/** * @param string $formattedParent The repository in which to list workflow configs. Must be in the *                                format `projects/*/locations/*/repositories/*`. Please see *                                {@see DataformClient::repositoryName()} for help formatting this field. */function list_workflow_configs_sample(string $formattedParent): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new ListWorkflowConfigsRequest())        ->setParent($formattedParent);    // Call the API and handle any network failures.    try {        /** @var PagedListResponse $response */        $response = $dataformClient->listWorkflowConfigs($request);        /** @var WorkflowConfig $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 = DataformClient::repositoryName('[PROJECT]', '[LOCATION]', '[REPOSITORY]');    list_workflow_configs_sample($formattedParent);}

listWorkflowInvocations

Lists WorkflowInvocations in a given Repository.

The async variant isDataformClient::listWorkflowInvocationsAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\ListWorkflowInvocationsRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\ApiCore\PagedListResponse
Example
use Google\ApiCore\ApiException;use Google\ApiCore\PagedListResponse;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\ListWorkflowInvocationsRequest;use Google\Cloud\Dataform\V1beta1\WorkflowInvocation;/** * @param string $formattedParent The parent resource of the WorkflowInvocation type. Must be in *                                the format `projects/*/locations/*/repositories/*`. Please see *                                {@see DataformClient::repositoryName()} for help formatting this field. */function list_workflow_invocations_sample(string $formattedParent): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new ListWorkflowInvocationsRequest())        ->setParent($formattedParent);    // Call the API and handle any network failures.    try {        /** @var PagedListResponse $response */        $response = $dataformClient->listWorkflowInvocations($request);        /** @var WorkflowInvocation $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 = DataformClient::repositoryName('[PROJECT]', '[LOCATION]', '[REPOSITORY]');    list_workflow_invocations_sample($formattedParent);}

listWorkspaces

Lists Workspaces in a given Repository.

The async variant isDataformClient::listWorkspacesAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\ListWorkspacesRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\ApiCore\PagedListResponse
Example
use Google\ApiCore\ApiException;use Google\ApiCore\PagedListResponse;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\ListWorkspacesRequest;use Google\Cloud\Dataform\V1beta1\Workspace;/** * @param string $formattedParent The repository in which to list workspaces. Must be in the *                                format `projects/*/locations/*/repositories/*`. Please see *                                {@see DataformClient::repositoryName()} for help formatting this field. */function list_workspaces_sample(string $formattedParent): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new ListWorkspacesRequest())        ->setParent($formattedParent);    // Call the API and handle any network failures.    try {        /** @var PagedListResponse $response */        $response = $dataformClient->listWorkspaces($request);        /** @var Workspace $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 = DataformClient::repositoryName('[PROJECT]', '[LOCATION]', '[REPOSITORY]');    list_workspaces_sample($formattedParent);}

makeDirectory

Creates a directory inside a Workspace.

The async variant isDataformClient::makeDirectoryAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\MakeDirectoryRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\Cloud\Dataform\V1beta1\MakeDirectoryResponse
Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\MakeDirectoryRequest;use Google\Cloud\Dataform\V1beta1\MakeDirectoryResponse;/** * @param string $formattedWorkspace The workspace's name. Please see *                                   {@see DataformClient::workspaceName()} for help formatting this field. * @param string $path               The directory's full path including directory name, relative to *                                   the workspace root. */function make_directory_sample(string $formattedWorkspace, string $path): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new MakeDirectoryRequest())        ->setWorkspace($formattedWorkspace)        ->setPath($path);    // Call the API and handle any network failures.    try {        /** @var MakeDirectoryResponse $response */        $response = $dataformClient->makeDirectory($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{    $formattedWorkspace = DataformClient::workspaceName(        '[PROJECT]',        '[LOCATION]',        '[REPOSITORY]',        '[WORKSPACE]'    );    $path = '[PATH]';    make_directory_sample($formattedWorkspace, $path);}

moveDirectory

Moves a directory (inside a Workspace), and all of its contents, to a newlocation.

The async variant isDataformClient::moveDirectoryAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\MoveDirectoryRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\Cloud\Dataform\V1beta1\MoveDirectoryResponse
Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\MoveDirectoryRequest;use Google\Cloud\Dataform\V1beta1\MoveDirectoryResponse;/** * @param string $formattedWorkspace The workspace's name. Please see *                                   {@see DataformClient::workspaceName()} for help formatting this field. * @param string $path               The directory's full path including directory name, relative to *                                   the workspace root. * @param string $newPath            The new path for the directory including directory name, rooted *                                   at workspace root. */function move_directory_sample(string $formattedWorkspace, string $path, string $newPath): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new MoveDirectoryRequest())        ->setWorkspace($formattedWorkspace)        ->setPath($path)        ->setNewPath($newPath);    // Call the API and handle any network failures.    try {        /** @var MoveDirectoryResponse $response */        $response = $dataformClient->moveDirectory($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{    $formattedWorkspace = DataformClient::workspaceName(        '[PROJECT]',        '[LOCATION]',        '[REPOSITORY]',        '[WORKSPACE]'    );    $path = '[PATH]';    $newPath = '[NEW_PATH]';    move_directory_sample($formattedWorkspace, $path, $newPath);}

moveFile

Moves a file (inside a Workspace) to a new location.

The async variant isDataformClient::moveFileAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\MoveFileRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\Cloud\Dataform\V1beta1\MoveFileResponse
Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\MoveFileRequest;use Google\Cloud\Dataform\V1beta1\MoveFileResponse;/** * @param string $formattedWorkspace The workspace's name. Please see *                                   {@see DataformClient::workspaceName()} for help formatting this field. * @param string $path               The file's full path including filename, relative to the *                                   workspace root. * @param string $newPath            The file's new path including filename, relative to the workspace *                                   root. */function move_file_sample(string $formattedWorkspace, string $path, string $newPath): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new MoveFileRequest())        ->setWorkspace($formattedWorkspace)        ->setPath($path)        ->setNewPath($newPath);    // Call the API and handle any network failures.    try {        /** @var MoveFileResponse $response */        $response = $dataformClient->moveFile($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{    $formattedWorkspace = DataformClient::workspaceName(        '[PROJECT]',        '[LOCATION]',        '[REPOSITORY]',        '[WORKSPACE]'    );    $path = '[PATH]';    $newPath = '[NEW_PATH]';    move_file_sample($formattedWorkspace, $path, $newPath);}

pullGitCommits

Pulls Git commits from the Repository's remote into a Workspace.

The async variant isDataformClient::pullGitCommitsAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\PullGitCommitsRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\CommitAuthor;use Google\Cloud\Dataform\V1beta1\PullGitCommitsRequest;/** * @param string $formattedName      The workspace's name. Please see *                                   {@see DataformClient::workspaceName()} for help formatting this field. * @param string $authorName         The commit author's name. * @param string $authorEmailAddress The commit author's email address. */function pull_git_commits_sample(    string $formattedName,    string $authorName,    string $authorEmailAddress): void {    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $author = (new CommitAuthor())        ->setName($authorName)        ->setEmailAddress($authorEmailAddress);    $request = (new PullGitCommitsRequest())        ->setName($formattedName)        ->setAuthor($author);    // Call the API and handle any network failures.    try {        $dataformClient->pullGitCommits($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 = DataformClient::workspaceName(        '[PROJECT]',        '[LOCATION]',        '[REPOSITORY]',        '[WORKSPACE]'    );    $authorName = '[NAME]';    $authorEmailAddress = '[EMAIL_ADDRESS]';    pull_git_commits_sample($formattedName, $authorName, $authorEmailAddress);}

pushGitCommits

Pushes Git commits from a Workspace to the Repository's remote.

The async variant isDataformClient::pushGitCommitsAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\PushGitCommitsRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\PushGitCommitsRequest;/** * @param string $formattedName The workspace's name. Please see *                              {@see DataformClient::workspaceName()} for help formatting this field. */function push_git_commits_sample(string $formattedName): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new PushGitCommitsRequest())        ->setName($formattedName);    // Call the API and handle any network failures.    try {        $dataformClient->pushGitCommits($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 = DataformClient::workspaceName(        '[PROJECT]',        '[LOCATION]',        '[REPOSITORY]',        '[WORKSPACE]'    );    push_git_commits_sample($formattedName);}

queryCompilationResultActions

Returns CompilationResultActions in a given CompilationResult.

The async variant isDataformClient::queryCompilationResultActionsAsync().

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\QueryCompilationResultActionsRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\ApiCore\PagedListResponse
Example
use Google\ApiCore\ApiException;use Google\ApiCore\PagedListResponse;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\CompilationResultAction;use Google\Cloud\Dataform\V1beta1\QueryCompilationResultActionsRequest;/** * @param string $formattedName The compilation result's name. Please see *                              {@see DataformClient::compilationResultName()} for help formatting this field. */function query_compilation_result_actions_sample(string $formattedName): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new QueryCompilationResultActionsRequest())        ->setName($formattedName);    // Call the API and handle any network failures.    try {        /** @var PagedListResponse $response */        $response = $dataformClient->queryCompilationResultActions($request);        /** @var CompilationResultAction $element */        foreach ($response as $element) {            printf('Element data: %s' . PHP_EOL, $element->serializeToJsonString());        }    } catch (ApiException $ex) {        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());    }}/** * Helper to execute the sample. * * This sample has been automatically generated and should be regarded as a code * template only. It will require modifications to work: *  - It may require correct/in-range values for request initialization. *  - It may require specifying regional endpoints when creating the service client, *    please see the apiEndpoint client configuration option for more details. */function callSample(): void{    $formattedName = DataformClient::compilationResultName(        '[PROJECT]',        '[LOCATION]',        '[REPOSITORY]',        '[COMPILATION_RESULT]'    );    query_compilation_result_actions_sample($formattedName);}

queryDirectoryContents

Returns the contents of a given Workspace directory.

The async variant isDataformClient::queryDirectoryContentsAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\QueryDirectoryContentsRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\ApiCore\PagedListResponse
Example
use Google\ApiCore\ApiException;use Google\ApiCore\PagedListResponse;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\DirectoryEntry;use Google\Cloud\Dataform\V1beta1\QueryDirectoryContentsRequest;/** * @param string $formattedWorkspace The workspace's name. Please see *                                   {@see DataformClient::workspaceName()} for help formatting this field. */function query_directory_contents_sample(string $formattedWorkspace): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new QueryDirectoryContentsRequest())        ->setWorkspace($formattedWorkspace);    // Call the API and handle any network failures.    try {        /** @var PagedListResponse $response */        $response = $dataformClient->queryDirectoryContents($request);        /** @var DirectoryEntry $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{    $formattedWorkspace = DataformClient::workspaceName(        '[PROJECT]',        '[LOCATION]',        '[REPOSITORY]',        '[WORKSPACE]'    );    query_directory_contents_sample($formattedWorkspace);}

queryRepositoryDirectoryContents

Returns the contents of a given Repository directory. The Repository mustnot have a value forgit_remote_settings.url.

The async variant isDataformClient::queryRepositoryDirectoryContentsAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\QueryRepositoryDirectoryContentsRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\ApiCore\PagedListResponse
Example
use Google\ApiCore\ApiException;use Google\ApiCore\PagedListResponse;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\DirectoryEntry;use Google\Cloud\Dataform\V1beta1\QueryRepositoryDirectoryContentsRequest;/** * @param string $formattedName The repository's name. Please see *                              {@see DataformClient::repositoryName()} for help formatting this field. */function query_repository_directory_contents_sample(string $formattedName): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new QueryRepositoryDirectoryContentsRequest())        ->setName($formattedName);    // Call the API and handle any network failures.    try {        /** @var PagedListResponse $response */        $response = $dataformClient->queryRepositoryDirectoryContents($request);        /** @var DirectoryEntry $element */        foreach ($response as $element) {            printf('Element data: %s' . PHP_EOL, $element->serializeToJsonString());        }    } catch (ApiException $ex) {        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());    }}/** * Helper to execute the sample. * * This sample has been automatically generated and should be regarded as a code * template only. It will require modifications to work: *  - It may require correct/in-range values for request initialization. *  - It may require specifying regional endpoints when creating the service client, *    please see the apiEndpoint client configuration option for more details. */function callSample(): void{    $formattedName = DataformClient::repositoryName('[PROJECT]', '[LOCATION]', '[REPOSITORY]');    query_repository_directory_contents_sample($formattedName);}

queryWorkflowInvocationActions

Returns WorkflowInvocationActions in a given WorkflowInvocation.

The async variant isDataformClient::queryWorkflowInvocationActionsAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\QueryWorkflowInvocationActionsRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\ApiCore\PagedListResponse
Example
use Google\ApiCore\ApiException;use Google\ApiCore\PagedListResponse;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\QueryWorkflowInvocationActionsRequest;use Google\Cloud\Dataform\V1beta1\WorkflowInvocationAction;/** * @param string $formattedName The workflow invocation's name. Please see *                              {@see DataformClient::workflowInvocationName()} for help formatting this field. */function query_workflow_invocation_actions_sample(string $formattedName): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new QueryWorkflowInvocationActionsRequest())        ->setName($formattedName);    // Call the API and handle any network failures.    try {        /** @var PagedListResponse $response */        $response = $dataformClient->queryWorkflowInvocationActions($request);        /** @var WorkflowInvocationAction $element */        foreach ($response as $element) {            printf('Element data: %s' . PHP_EOL, $element->serializeToJsonString());        }    } catch (ApiException $ex) {        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());    }}/** * Helper to execute the sample. * * This sample has been automatically generated and should be regarded as a code * template only. It will require modifications to work: *  - It may require correct/in-range values for request initialization. *  - It may require specifying regional endpoints when creating the service client, *    please see the apiEndpoint client configuration option for more details. */function callSample(): void{    $formattedName = DataformClient::workflowInvocationName(        '[PROJECT]',        '[LOCATION]',        '[REPOSITORY]',        '[WORKFLOW_INVOCATION]'    );    query_workflow_invocation_actions_sample($formattedName);}

readFile

Returns the contents of a file (inside a Workspace).

The async variant isDataformClient::readFileAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\ReadFileRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\Cloud\Dataform\V1beta1\ReadFileResponse
Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\ReadFileRequest;use Google\Cloud\Dataform\V1beta1\ReadFileResponse;/** * @param string $formattedWorkspace The workspace's name. Please see *                                   {@see DataformClient::workspaceName()} for help formatting this field. * @param string $path               The file's full path including filename, relative to the *                                   workspace root. */function read_file_sample(string $formattedWorkspace, string $path): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new ReadFileRequest())        ->setWorkspace($formattedWorkspace)        ->setPath($path);    // Call the API and handle any network failures.    try {        /** @var ReadFileResponse $response */        $response = $dataformClient->readFile($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{    $formattedWorkspace = DataformClient::workspaceName(        '[PROJECT]',        '[LOCATION]',        '[REPOSITORY]',        '[WORKSPACE]'    );    $path = '[PATH]';    read_file_sample($formattedWorkspace, $path);}

readRepositoryFile

Returns the contents of a file (inside a Repository). The Repositorymust not have a value forgit_remote_settings.url.

The async variant isDataformClient::readRepositoryFileAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\ReadRepositoryFileRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\Cloud\Dataform\V1beta1\ReadRepositoryFileResponse
Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\ReadRepositoryFileRequest;use Google\Cloud\Dataform\V1beta1\ReadRepositoryFileResponse;/** * @param string $formattedName The repository's name. Please see *                              {@see DataformClient::repositoryName()} for help formatting this field. * @param string $path          Full file path to read including filename, from repository root. */function read_repository_file_sample(string $formattedName, string $path): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new ReadRepositoryFileRequest())        ->setName($formattedName)        ->setPath($path);    // Call the API and handle any network failures.    try {        /** @var ReadRepositoryFileResponse $response */        $response = $dataformClient->readRepositoryFile($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 = DataformClient::repositoryName('[PROJECT]', '[LOCATION]', '[REPOSITORY]');    $path = '[PATH]';    read_repository_file_sample($formattedName, $path);}

removeDirectory

Deletes a directory (inside a Workspace) and all of its contents.

The async variant isDataformClient::removeDirectoryAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\RemoveDirectoryRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\RemoveDirectoryRequest;/** * @param string $formattedWorkspace The workspace's name. Please see *                                   {@see DataformClient::workspaceName()} for help formatting this field. * @param string $path               The directory's full path including directory name, relative to *                                   the workspace root. */function remove_directory_sample(string $formattedWorkspace, string $path): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new RemoveDirectoryRequest())        ->setWorkspace($formattedWorkspace)        ->setPath($path);    // Call the API and handle any network failures.    try {        $dataformClient->removeDirectory($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{    $formattedWorkspace = DataformClient::workspaceName(        '[PROJECT]',        '[LOCATION]',        '[REPOSITORY]',        '[WORKSPACE]'    );    $path = '[PATH]';    remove_directory_sample($formattedWorkspace, $path);}

removeFile

Deletes a file (inside a Workspace).

The async variant isDataformClient::removeFileAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\RemoveFileRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\RemoveFileRequest;/** * @param string $formattedWorkspace The workspace's name. Please see *                                   {@see DataformClient::workspaceName()} for help formatting this field. * @param string $path               The file's full path including filename, relative to the *                                   workspace root. */function remove_file_sample(string $formattedWorkspace, string $path): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new RemoveFileRequest())        ->setWorkspace($formattedWorkspace)        ->setPath($path);    // Call the API and handle any network failures.    try {        $dataformClient->removeFile($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{    $formattedWorkspace = DataformClient::workspaceName(        '[PROJECT]',        '[LOCATION]',        '[REPOSITORY]',        '[WORKSPACE]'    );    $path = '[PATH]';    remove_file_sample($formattedWorkspace, $path);}

resetWorkspaceChanges

Performs a Git reset for uncommitted files in a Workspace.

The async variant isDataformClient::resetWorkspaceChangesAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\ResetWorkspaceChangesRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\ResetWorkspaceChangesRequest;/** * @param string $formattedName The workspace's name. Please see *                              {@see DataformClient::workspaceName()} for help formatting this field. */function reset_workspace_changes_sample(string $formattedName): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new ResetWorkspaceChangesRequest())        ->setName($formattedName);    // Call the API and handle any network failures.    try {        $dataformClient->resetWorkspaceChanges($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 = DataformClient::workspaceName(        '[PROJECT]',        '[LOCATION]',        '[REPOSITORY]',        '[WORKSPACE]'    );    reset_workspace_changes_sample($formattedName);}

updateReleaseConfig

Updates a single ReleaseConfig.

The async variant isDataformClient::updateReleaseConfigAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\UpdateReleaseConfigRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\Cloud\Dataform\V1beta1\ReleaseConfig
Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\ReleaseConfig;use Google\Cloud\Dataform\V1beta1\UpdateReleaseConfigRequest;/** * @param string $releaseConfigGitCommitish Git commit/tag/branch name at which the repository should be *                                          compiled. Must exist in the remote repository. Examples: *                                          - a commit SHA: `12ade345` *                                          - a tag: `tag1` *                                          - a branch name: `branch1` */function update_release_config_sample(string $releaseConfigGitCommitish): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $releaseConfig = (new ReleaseConfig())        ->setGitCommitish($releaseConfigGitCommitish);    $request = (new UpdateReleaseConfigRequest())        ->setReleaseConfig($releaseConfig);    // Call the API and handle any network failures.    try {        /** @var ReleaseConfig $response */        $response = $dataformClient->updateReleaseConfig($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{    $releaseConfigGitCommitish = '[GIT_COMMITISH]';    update_release_config_sample($releaseConfigGitCommitish);}

updateRepository

Updates a single Repository.

The async variant isDataformClient::updateRepositoryAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\UpdateRepositoryRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\Cloud\Dataform\V1beta1\Repository
Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\Repository;use Google\Cloud\Dataform\V1beta1\UpdateRepositoryRequest;/** * This sample has been automatically generated and should be regarded as a code * template only. It will require modifications to work: *  - It may require correct/in-range values for request initialization. *  - It may require specifying regional endpoints when creating the service client, *    please see the apiEndpoint client configuration option for more details. */function update_repository_sample(): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $repository = new Repository();    $request = (new UpdateRepositoryRequest())        ->setRepository($repository);    // Call the API and handle any network failures.    try {        /** @var Repository $response */        $response = $dataformClient->updateRepository($request);        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());    } catch (ApiException $ex) {        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());    }}

updateWorkflowConfig

Updates a single WorkflowConfig.

The async variant isDataformClient::updateWorkflowConfigAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\UpdateWorkflowConfigRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\Cloud\Dataform\V1beta1\WorkflowConfig
Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\UpdateWorkflowConfigRequest;use Google\Cloud\Dataform\V1beta1\WorkflowConfig;/** * @param string $formattedWorkflowConfigReleaseConfig The name of the release config whose release_compilation_result *                                                     should be executed. Must be in the format *                                                     `projects/*/locations/*/repositories/*/releaseConfigs/*`. Please see *                                                     {@see DataformClient::releaseConfigName()} for help formatting this field. */function update_workflow_config_sample(string $formattedWorkflowConfigReleaseConfig): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $workflowConfig = (new WorkflowConfig())        ->setReleaseConfig($formattedWorkflowConfigReleaseConfig);    $request = (new UpdateWorkflowConfigRequest())        ->setWorkflowConfig($workflowConfig);    // Call the API and handle any network failures.    try {        /** @var WorkflowConfig $response */        $response = $dataformClient->updateWorkflowConfig($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{    $formattedWorkflowConfigReleaseConfig = DataformClient::releaseConfigName(        '[PROJECT]',        '[LOCATION]',        '[REPOSITORY]',        '[RELEASE_CONFIG]'    );    update_workflow_config_sample($formattedWorkflowConfigReleaseConfig);}

writeFile

Writes to a file (inside a Workspace).

The async variant isDataformClient::writeFileAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\WriteFileRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\Cloud\Dataform\V1beta1\WriteFileResponse
Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;use Google\Cloud\Dataform\V1beta1\WriteFileRequest;use Google\Cloud\Dataform\V1beta1\WriteFileResponse;/** * @param string $formattedWorkspace The workspace's name. Please see *                                   {@see DataformClient::workspaceName()} for help formatting this field. * @param string $path               The file. * @param string $contents           The file's contents. */function write_file_sample(string $formattedWorkspace, string $path, string $contents): void{    // Create a client.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new WriteFileRequest())        ->setWorkspace($formattedWorkspace)        ->setPath($path)        ->setContents($contents);    // Call the API and handle any network failures.    try {        /** @var WriteFileResponse $response */        $response = $dataformClient->writeFile($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{    $formattedWorkspace = DataformClient::workspaceName(        '[PROJECT]',        '[LOCATION]',        '[REPOSITORY]',        '[WORKSPACE]'    );    $path = '[PATH]';    $contents = '...';    write_file_sample($formattedWorkspace, $path, $contents);}

getLocation

Gets information about a location.

The async variant isDataformClient::getLocationAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Location\GetLocationRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\Cloud\Location\Location
Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;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.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = new GetLocationRequest();    // Call the API and handle any network failures.    try {        /** @var Location $response */        $response = $dataformClient->getLocation($request);        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());    } catch (ApiException $ex) {        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());    }}

listLocations

Lists information about the supported locations for this service.

The async variant isDataformClient::listLocationsAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Location\ListLocationsRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\ApiCore\PagedListResponse
Example
use Google\ApiCore\ApiException;use Google\ApiCore\PagedListResponse;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;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.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = new ListLocationsRequest();    // Call the API and handle any network failures.    try {        /** @var PagedListResponse $response */        $response = $dataformClient->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());    }}

getIamPolicy

Gets the access control policy for a resource. Returns an empty policyif the resource exists and does not have a policy set.

The async variant isDataformClient::getIamPolicyAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Iam\V1\GetIamPolicyRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\Cloud\Iam\V1\Policy
Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;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.    $dataformClient = new DataformClient();    // Prepare the request message.    $request = (new GetIamPolicyRequest())        ->setResource($resource);    // Call the API and handle any network failures.    try {        /** @var Policy $response */        $response = $dataformClient->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);}

setIamPolicy

Sets the access control policy on the specified resource. Replacesany existing policy.

Can returnNOT_FOUND,INVALID_ARGUMENT, andPERMISSION_DENIEDerrors.

The async variant isDataformClient::setIamPolicyAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Iam\V1\SetIamPolicyRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\Cloud\Iam\V1\Policy
Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;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.    $dataformClient = new DataformClient();    // 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 = $dataformClient->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);}

testIamPermissions

Returns permissions that a caller has on the specified resource. If theresource does not exist, this will return an empty set ofpermissions, not aNOT_FOUND error.

Note: This operation is designed to be used for buildingpermission-aware UIs and command-line tools, not for authorizationchecking. This operation may "fail open" without warning.

The async variant isDataformClient::testIamPermissionsAsync() .

Parameters
NameDescription
requestGoogle\Cloud\Iam\V1\TestIamPermissionsRequest

A request to house fields associated with the call.

callOptionsarray

Optional.

↳ retrySettingsRetrySettings|array

Retry settings to use for this call. Can be aGoogle\ApiCore\RetrySettings object, or an associative array of retry settings parameters. See the documentation onGoogle\ApiCore\RetrySettings for example usage.

Returns
TypeDescription
Google\Cloud\Iam\V1\TestIamPermissionsResponse
Example
use Google\ApiCore\ApiException;use Google\Cloud\Dataform\V1beta1\Client\DataformClient;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.    $dataformClient = new DataformClient();    // 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 = $dataformClient->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);}

cancelWorkflowInvocationAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\CancelWorkflowInvocationRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<void>

commitRepositoryChangesAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\CommitRepositoryChangesRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<void>

commitWorkspaceChangesAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\CommitWorkspaceChangesRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<void>

computeRepositoryAccessTokenStatusAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\ComputeRepositoryAccessTokenStatusRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\Cloud\Dataform\V1beta1\ComputeRepositoryAccessTokenStatusResponse>

createCompilationResultAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\CreateCompilationResultRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\Cloud\Dataform\V1beta1\CompilationResult>

createReleaseConfigAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\CreateReleaseConfigRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\Cloud\Dataform\V1beta1\ReleaseConfig>

createRepositoryAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\CreateRepositoryRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\Cloud\Dataform\V1beta1\Repository>

createWorkflowConfigAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\CreateWorkflowConfigRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\Cloud\Dataform\V1beta1\WorkflowConfig>

createWorkflowInvocationAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\CreateWorkflowInvocationRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\Cloud\Dataform\V1beta1\WorkflowInvocation>

createWorkspaceAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\CreateWorkspaceRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\Cloud\Dataform\V1beta1\Workspace>

deleteReleaseConfigAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\DeleteReleaseConfigRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<void>

deleteRepositoryAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\DeleteRepositoryRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<void>

deleteWorkflowConfigAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\DeleteWorkflowConfigRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<void>

deleteWorkflowInvocationAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\DeleteWorkflowInvocationRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<void>

deleteWorkspaceAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\DeleteWorkspaceRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<void>

fetchFileDiffAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\FetchFileDiffRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\Cloud\Dataform\V1beta1\FetchFileDiffResponse>

fetchFileGitStatusesAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\FetchFileGitStatusesRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\Cloud\Dataform\V1beta1\FetchFileGitStatusesResponse>

fetchGitAheadBehindAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\FetchGitAheadBehindRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\Cloud\Dataform\V1beta1\FetchGitAheadBehindResponse>

fetchRemoteBranchesAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\FetchRemoteBranchesRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\Cloud\Dataform\V1beta1\FetchRemoteBranchesResponse>

fetchRepositoryHistoryAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\FetchRepositoryHistoryRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\ApiCore\PagedListResponse>

getCompilationResultAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\GetCompilationResultRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\Cloud\Dataform\V1beta1\CompilationResult>

getReleaseConfigAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\GetReleaseConfigRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\Cloud\Dataform\V1beta1\ReleaseConfig>

getRepositoryAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\GetRepositoryRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\Cloud\Dataform\V1beta1\Repository>

getWorkflowConfigAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\GetWorkflowConfigRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\Cloud\Dataform\V1beta1\WorkflowConfig>

getWorkflowInvocationAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\GetWorkflowInvocationRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\Cloud\Dataform\V1beta1\WorkflowInvocation>

getWorkspaceAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\GetWorkspaceRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\Cloud\Dataform\V1beta1\Workspace>

installNpmPackagesAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\InstallNpmPackagesRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\Cloud\Dataform\V1beta1\InstallNpmPackagesResponse>

listCompilationResultsAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\ListCompilationResultsRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\ApiCore\PagedListResponse>

listReleaseConfigsAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\ListReleaseConfigsRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\ApiCore\PagedListResponse>

listRepositoriesAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\ListRepositoriesRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\ApiCore\PagedListResponse>

listWorkflowConfigsAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\ListWorkflowConfigsRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\ApiCore\PagedListResponse>

listWorkflowInvocationsAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\ListWorkflowInvocationsRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\ApiCore\PagedListResponse>

listWorkspacesAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\ListWorkspacesRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\ApiCore\PagedListResponse>

makeDirectoryAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\MakeDirectoryRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\Cloud\Dataform\V1beta1\MakeDirectoryResponse>

moveDirectoryAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\MoveDirectoryRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\Cloud\Dataform\V1beta1\MoveDirectoryResponse>

moveFileAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\MoveFileRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\Cloud\Dataform\V1beta1\MoveFileResponse>

pullGitCommitsAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\PullGitCommitsRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<void>

pushGitCommitsAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\PushGitCommitsRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<void>

queryCompilationResultActionsAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\QueryCompilationResultActionsRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\ApiCore\PagedListResponse>

queryDirectoryContentsAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\QueryDirectoryContentsRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\ApiCore\PagedListResponse>

queryRepositoryDirectoryContentsAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\QueryRepositoryDirectoryContentsRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\ApiCore\PagedListResponse>

queryWorkflowInvocationActionsAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\QueryWorkflowInvocationActionsRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\ApiCore\PagedListResponse>

readFileAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\ReadFileRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\Cloud\Dataform\V1beta1\ReadFileResponse>

readRepositoryFileAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\ReadRepositoryFileRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\Cloud\Dataform\V1beta1\ReadRepositoryFileResponse>

removeDirectoryAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\RemoveDirectoryRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<void>

removeFileAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\RemoveFileRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<void>

resetWorkspaceChangesAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\ResetWorkspaceChangesRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<void>

updateReleaseConfigAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\UpdateReleaseConfigRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\Cloud\Dataform\V1beta1\ReleaseConfig>

updateRepositoryAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\UpdateRepositoryRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\Cloud\Dataform\V1beta1\Repository>

updateWorkflowConfigAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\UpdateWorkflowConfigRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\Cloud\Dataform\V1beta1\WorkflowConfig>

writeFileAsync

Parameters
NameDescription
requestGoogle\Cloud\Dataform\V1beta1\WriteFileRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\Cloud\Dataform\V1beta1\WriteFileResponse>

getLocationAsync

Parameters
NameDescription
requestGoogle\Cloud\Location\GetLocationRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\Cloud\Location\Location>

listLocationsAsync

Parameters
NameDescription
requestGoogle\Cloud\Location\ListLocationsRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\ApiCore\PagedListResponse>

getIamPolicyAsync

Parameters
NameDescription
requestGoogle\Cloud\Iam\V1\GetIamPolicyRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\Cloud\Iam\V1\Policy>

setIamPolicyAsync

Parameters
NameDescription
requestGoogle\Cloud\Iam\V1\SetIamPolicyRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\Cloud\Iam\V1\Policy>

testIamPermissionsAsync

Parameters
NameDescription
requestGoogle\Cloud\Iam\V1\TestIamPermissionsRequest
optionalArgsarray
Returns
TypeDescription
GuzzleHttp\Promise\PromiseInterface<Google\Cloud\Iam\V1\TestIamPermissionsResponse>

static::compilationResultName

Formats a string containing the fully-qualified path to represent acompilation_result resource.

Parameters
NameDescription
projectstring
locationstring
repositorystring
compilationResultstring
Returns
TypeDescription
stringThe formatted compilation_result resource.

static::locationName

Formats a string containing the fully-qualified path to represent a locationresource.

Parameters
NameDescription
projectstring
locationstring
Returns
TypeDescription
stringThe formatted location resource.

static::releaseConfigName

Formats a string containing the fully-qualified path to represent arelease_config resource.

Parameters
NameDescription
projectstring
locationstring
repositorystring
releaseConfigstring
Returns
TypeDescription
stringThe formatted release_config resource.

static::repositoryName

Formats a string containing the fully-qualified path to represent a repositoryresource.

Parameters
NameDescription
projectstring
locationstring
repositorystring
Returns
TypeDescription
stringThe formatted repository resource.

static::secretVersionName

Formats a string containing the fully-qualified path to represent asecret_version resource.

Parameters
NameDescription
projectstring
secretstring
versionstring
Returns
TypeDescription
stringThe formatted secret_version resource.

static::workflowConfigName

Formats a string containing the fully-qualified path to represent aworkflow_config resource.

Parameters
NameDescription
projectstring
locationstring
repositorystring
workflowConfigstring
Returns
TypeDescription
stringThe formatted workflow_config resource.

static::workflowInvocationName

Formats a string containing the fully-qualified path to represent aworkflow_invocation resource.

Parameters
NameDescription
projectstring
locationstring
repositorystring
workflowInvocationstring
Returns
TypeDescription
stringThe formatted workflow_invocation resource.

static::workspaceName

Formats a string containing the fully-qualified path to represent a workspaceresource.

Parameters
NameDescription
projectstring
locationstring
repositorystring
workspacestring
Returns
TypeDescription
stringThe formatted workspace resource.

static::parseName

Parses a formatted name string and returns an associative array of the components in the name.

The following name formats are supported:Template: Pattern

  • compilationResult: projects/{project}/locations/{location}/repositories/{repository}/compilationResults/{compilation_result}
  • location: projects/{project}/locations/{location}
  • releaseConfig: projects/{project}/locations/{location}/repositories/{repository}/releaseConfigs/{release_config}
  • repository: projects/{project}/locations/{location}/repositories/{repository}
  • secretVersion: projects/{project}/secrets/{secret}/versions/{version}
  • workflowConfig: projects/{project}/locations/{location}/repositories/{repository}/workflowConfigs/{workflow_config}
  • workflowInvocation: projects/{project}/locations/{location}/repositories/{repository}/workflowInvocations/{workflow_invocation}
  • workspace: projects/{project}/locations/{location}/repositories/{repository}/workspaces/{workspace}

The optional $template argument can be supplied to specify a particular pattern,and must match one of the templates listed above. If no $template argument isprovided, or if the $template argument does not match one of the templateslisted, then parseName will check each of the supported templates, and returnthe first match.

Parameters
NameDescription
formattedNamestring

The formatted name string

template?string

Optional name of template to match

Returns
TypeDescription
arrayAn associative array from name component IDs to component values.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-01-09 UTC.