Cloud AI Platform v1 API - Class VizierServiceClient (2.26.0)

public abstract class VizierServiceClient

Reference documentation and code samples for the Cloud AI Platform v1 API class VizierServiceClient.

VizierService client wrapper, for convenient use.

Inheritance

object > VizierServiceClient

Derived Types

Namespace

Google.Cloud.AIPlatform.V1

Assembly

Google.Cloud.AIPlatform.V1.dll

Remarks

Vertex AI Vizier API.

Vertex AI Vizier is a service to solve blackbox optimization problems, such as tuning machine learning hyperparameters and searching over deep learning architectures.

Properties

CheckTrialEarlyStoppingStateOperationsClient

public virtual OperationsClient CheckTrialEarlyStoppingStateOperationsClient { get; }

The long-running operations client for CheckTrialEarlyStoppingState.

Property Value
TypeDescription
OperationsClient

DefaultEndpoint

public static string DefaultEndpoint { get; }

The default endpoint for the VizierService service, which is a host of "aiplatform.googleapis.com" and a port of 443.

Property Value
TypeDescription
string

DefaultScopes

public static IReadOnlyList<string> DefaultScopes { get; }

The default VizierService scopes.

Property Value
TypeDescription
IReadOnlyListstring
Remarks

The default VizierService scopes are:

GrpcClient

public virtual VizierService.VizierServiceClient GrpcClient { get; }

The underlying gRPC VizierService client

Property Value
TypeDescription
VizierServiceVizierServiceClient

IAMPolicyClient

public virtual IAMPolicyClient IAMPolicyClient { get; }

The IAMPolicyClient associated with this client.

Property Value
TypeDescription
IAMPolicyClient

LocationsClient

public virtual LocationsClient LocationsClient { get; }

The LocationsClient associated with this client.

Property Value
TypeDescription
LocationsClient

ServiceMetadata

public static ServiceMetadata ServiceMetadata { get; }

The service metadata associated with this client type.

Property Value
TypeDescription
ServiceMetadata

SuggestTrialsOperationsClient

public virtual OperationsClient SuggestTrialsOperationsClient { get; }

The long-running operations client for SuggestTrials.

Property Value
TypeDescription
OperationsClient

Methods

AddTrialMeasurement(AddTrialMeasurementRequest, CallSettings)

public virtual Trial AddTrialMeasurement(AddTrialMeasurementRequest request, CallSettings callSettings = null)

Adds a measurement of the objective metrics to a Trial. This measurement is assumed to have been taken before the Trial is complete.

Parameters
NameDescription
requestAddTrialMeasurementRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
Trial

The RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
AddTrialMeasurementRequest request = new AddTrialMeasurementRequest
{
    TrialNameAsTrialName = TrialName.FromProjectLocationStudyTrial("[PROJECT]", "[LOCATION]", "[STUDY]", "[TRIAL]"),
    Measurement = new Measurement(),
};
// Make the request
Trial response = vizierServiceClient.AddTrialMeasurement(request);

AddTrialMeasurementAsync(AddTrialMeasurementRequest, CallSettings)

public virtual Task<Trial> AddTrialMeasurementAsync(AddTrialMeasurementRequest request, CallSettings callSettings = null)

Adds a measurement of the objective metrics to a Trial. This measurement is assumed to have been taken before the Trial is complete.

Parameters
NameDescription
requestAddTrialMeasurementRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskTrial

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
AddTrialMeasurementRequest request = new AddTrialMeasurementRequest
{
    TrialNameAsTrialName = TrialName.FromProjectLocationStudyTrial("[PROJECT]", "[LOCATION]", "[STUDY]", "[TRIAL]"),
    Measurement = new Measurement(),
};
// Make the request
Trial response = await vizierServiceClient.AddTrialMeasurementAsync(request);

AddTrialMeasurementAsync(AddTrialMeasurementRequest, CancellationToken)

public virtual Task<Trial> AddTrialMeasurementAsync(AddTrialMeasurementRequest request, CancellationToken cancellationToken)

Adds a measurement of the objective metrics to a Trial. This measurement is assumed to have been taken before the Trial is complete.

Parameters
NameDescription
requestAddTrialMeasurementRequest

The request object containing all of the parameters for the API call.

cancellationTokenCancellationToken

A CancellationToken to use for this RPC.

Returns
TypeDescription
TaskTrial

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
AddTrialMeasurementRequest request = new AddTrialMeasurementRequest
{
    TrialNameAsTrialName = TrialName.FromProjectLocationStudyTrial("[PROJECT]", "[LOCATION]", "[STUDY]", "[TRIAL]"),
    Measurement = new Measurement(),
};
// Make the request
Trial response = await vizierServiceClient.AddTrialMeasurementAsync(request);

CheckTrialEarlyStoppingState(CheckTrialEarlyStoppingStateRequest, CallSettings)

public virtual Operation<CheckTrialEarlyStoppingStateResponse, CheckTrialEarlyStoppingStateMetatdata> CheckTrialEarlyStoppingState(CheckTrialEarlyStoppingStateRequest request, CallSettings callSettings = null)

Checks whether a Trial should stop or not. Returns a long-running operation. When the operation is successful, it will contain a [CheckTrialEarlyStoppingStateResponse][google.cloud.aiplatform.v1.CheckTrialEarlyStoppingStateResponse].

Parameters
NameDescription
requestCheckTrialEarlyStoppingStateRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
OperationCheckTrialEarlyStoppingStateResponseCheckTrialEarlyStoppingStateMetatdata

The RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
CheckTrialEarlyStoppingStateRequest request = new CheckTrialEarlyStoppingStateRequest
{
    TrialNameAsTrialName = TrialName.FromProjectLocationStudyTrial("[PROJECT]", "[LOCATION]", "[STUDY]", "[TRIAL]"),
};
// Make the request
Operation<CheckTrialEarlyStoppingStateResponse, CheckTrialEarlyStoppingStateMetatdata> response = vizierServiceClient.CheckTrialEarlyStoppingState(request);

// Poll until the returned long-running operation is complete
Operation<CheckTrialEarlyStoppingStateResponse, CheckTrialEarlyStoppingStateMetatdata> completedResponse = response.PollUntilCompleted();
// Retrieve the operation result
CheckTrialEarlyStoppingStateResponse result = completedResponse.Result;

// Or get the name of the operation
string operationName = response.Name;
// This name can be stored, then the long-running operation retrieved later by name
Operation<CheckTrialEarlyStoppingStateResponse, CheckTrialEarlyStoppingStateMetatdata> retrievedResponse = vizierServiceClient.PollOnceCheckTrialEarlyStoppingState(operationName);
// Check if the retrieved long-running operation has completed
if (retrievedResponse.IsCompleted)
{
    // If it has completed, then access the result
    CheckTrialEarlyStoppingStateResponse retrievedResult = retrievedResponse.Result;
}

CheckTrialEarlyStoppingStateAsync(CheckTrialEarlyStoppingStateRequest, CallSettings)

public virtual Task<Operation<CheckTrialEarlyStoppingStateResponse, CheckTrialEarlyStoppingStateMetatdata>> CheckTrialEarlyStoppingStateAsync(CheckTrialEarlyStoppingStateRequest request, CallSettings callSettings = null)

Checks whether a Trial should stop or not. Returns a long-running operation. When the operation is successful, it will contain a [CheckTrialEarlyStoppingStateResponse][google.cloud.aiplatform.v1.CheckTrialEarlyStoppingStateResponse].

Parameters
NameDescription
requestCheckTrialEarlyStoppingStateRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskOperationCheckTrialEarlyStoppingStateResponseCheckTrialEarlyStoppingStateMetatdata

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
CheckTrialEarlyStoppingStateRequest request = new CheckTrialEarlyStoppingStateRequest
{
    TrialNameAsTrialName = TrialName.FromProjectLocationStudyTrial("[PROJECT]", "[LOCATION]", "[STUDY]", "[TRIAL]"),
};
// Make the request
Operation<CheckTrialEarlyStoppingStateResponse, CheckTrialEarlyStoppingStateMetatdata> response = await vizierServiceClient.CheckTrialEarlyStoppingStateAsync(request);

// Poll until the returned long-running operation is complete
Operation<CheckTrialEarlyStoppingStateResponse, CheckTrialEarlyStoppingStateMetatdata> completedResponse = await response.PollUntilCompletedAsync();
// Retrieve the operation result
CheckTrialEarlyStoppingStateResponse result = completedResponse.Result;

// Or get the name of the operation
string operationName = response.Name;
// This name can be stored, then the long-running operation retrieved later by name
Operation<CheckTrialEarlyStoppingStateResponse, CheckTrialEarlyStoppingStateMetatdata> retrievedResponse = await vizierServiceClient.PollOnceCheckTrialEarlyStoppingStateAsync(operationName);
// Check if the retrieved long-running operation has completed
if (retrievedResponse.IsCompleted)
{
    // If it has completed, then access the result
    CheckTrialEarlyStoppingStateResponse retrievedResult = retrievedResponse.Result;
}

CheckTrialEarlyStoppingStateAsync(CheckTrialEarlyStoppingStateRequest, CancellationToken)

public virtual Task<Operation<CheckTrialEarlyStoppingStateResponse, CheckTrialEarlyStoppingStateMetatdata>> CheckTrialEarlyStoppingStateAsync(CheckTrialEarlyStoppingStateRequest request, CancellationToken cancellationToken)

Checks whether a Trial should stop or not. Returns a long-running operation. When the operation is successful, it will contain a [CheckTrialEarlyStoppingStateResponse][google.cloud.aiplatform.v1.CheckTrialEarlyStoppingStateResponse].

Parameters
NameDescription
requestCheckTrialEarlyStoppingStateRequest

The request object containing all of the parameters for the API call.

cancellationTokenCancellationToken

A CancellationToken to use for this RPC.

Returns
TypeDescription
TaskOperationCheckTrialEarlyStoppingStateResponseCheckTrialEarlyStoppingStateMetatdata

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
CheckTrialEarlyStoppingStateRequest request = new CheckTrialEarlyStoppingStateRequest
{
    TrialNameAsTrialName = TrialName.FromProjectLocationStudyTrial("[PROJECT]", "[LOCATION]", "[STUDY]", "[TRIAL]"),
};
// Make the request
Operation<CheckTrialEarlyStoppingStateResponse, CheckTrialEarlyStoppingStateMetatdata> response = await vizierServiceClient.CheckTrialEarlyStoppingStateAsync(request);

// Poll until the returned long-running operation is complete
Operation<CheckTrialEarlyStoppingStateResponse, CheckTrialEarlyStoppingStateMetatdata> completedResponse = await response.PollUntilCompletedAsync();
// Retrieve the operation result
CheckTrialEarlyStoppingStateResponse result = completedResponse.Result;

// Or get the name of the operation
string operationName = response.Name;
// This name can be stored, then the long-running operation retrieved later by name
Operation<CheckTrialEarlyStoppingStateResponse, CheckTrialEarlyStoppingStateMetatdata> retrievedResponse = await vizierServiceClient.PollOnceCheckTrialEarlyStoppingStateAsync(operationName);
// Check if the retrieved long-running operation has completed
if (retrievedResponse.IsCompleted)
{
    // If it has completed, then access the result
    CheckTrialEarlyStoppingStateResponse retrievedResult = retrievedResponse.Result;
}

CompleteTrial(CompleteTrialRequest, CallSettings)

public virtual Trial CompleteTrial(CompleteTrialRequest request, CallSettings callSettings = null)

Marks a Trial as complete.

Parameters
NameDescription
requestCompleteTrialRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
Trial

The RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
CompleteTrialRequest request = new CompleteTrialRequest
{
    TrialName = TrialName.FromProjectLocationStudyTrial("[PROJECT]", "[LOCATION]", "[STUDY]", "[TRIAL]"),
    FinalMeasurement = new Measurement(),
    TrialInfeasible = false,
    InfeasibleReason = "",
};
// Make the request
Trial response = vizierServiceClient.CompleteTrial(request);

CompleteTrialAsync(CompleteTrialRequest, CallSettings)

public virtual Task<Trial> CompleteTrialAsync(CompleteTrialRequest request, CallSettings callSettings = null)

Marks a Trial as complete.

Parameters
NameDescription
requestCompleteTrialRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskTrial

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
CompleteTrialRequest request = new CompleteTrialRequest
{
    TrialName = TrialName.FromProjectLocationStudyTrial("[PROJECT]", "[LOCATION]", "[STUDY]", "[TRIAL]"),
    FinalMeasurement = new Measurement(),
    TrialInfeasible = false,
    InfeasibleReason = "",
};
// Make the request
Trial response = await vizierServiceClient.CompleteTrialAsync(request);

CompleteTrialAsync(CompleteTrialRequest, CancellationToken)

public virtual Task<Trial> CompleteTrialAsync(CompleteTrialRequest request, CancellationToken cancellationToken)

Marks a Trial as complete.

Parameters
NameDescription
requestCompleteTrialRequest

The request object containing all of the parameters for the API call.

cancellationTokenCancellationToken

A CancellationToken to use for this RPC.

Returns
TypeDescription
TaskTrial

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
CompleteTrialRequest request = new CompleteTrialRequest
{
    TrialName = TrialName.FromProjectLocationStudyTrial("[PROJECT]", "[LOCATION]", "[STUDY]", "[TRIAL]"),
    FinalMeasurement = new Measurement(),
    TrialInfeasible = false,
    InfeasibleReason = "",
};
// Make the request
Trial response = await vizierServiceClient.CompleteTrialAsync(request);

Create()

public static VizierServiceClient Create()

Synchronously creates a VizierServiceClient using the default credentials, endpoint and settings. To specify custom credentials or other settings, use VizierServiceClientBuilder.

Returns
TypeDescription
VizierServiceClient

The created VizierServiceClient.

CreateAsync(CancellationToken)

public static Task<VizierServiceClient> CreateAsync(CancellationToken cancellationToken = default)

Asynchronously creates a VizierServiceClient using the default credentials, endpoint and settings. To specify custom credentials or other settings, use VizierServiceClientBuilder.

Parameter
NameDescription
cancellationTokenCancellationToken

The CancellationToken to use while creating the client.

Returns
TypeDescription
TaskVizierServiceClient

The task representing the created VizierServiceClient.

CreateStudy(LocationName, Study, CallSettings)

public virtual Study CreateStudy(LocationName parent, Study study, CallSettings callSettings = null)

Creates a Study. A resource name will be generated after creation of the Study.

Parameters
NameDescription
parentLocationName

Required. The resource name of the Location to create the CustomJob in. Format: projects/{project}/locations/{location}

studyStudy

Required. The Study configuration used to create the Study.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
Study

The RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
LocationName parent = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
Study study = new Study();
// Make the request
Study response = vizierServiceClient.CreateStudy(parent, study);

CreateStudy(CreateStudyRequest, CallSettings)

public virtual Study CreateStudy(CreateStudyRequest request, CallSettings callSettings = null)

Creates a Study. A resource name will be generated after creation of the Study.

Parameters
NameDescription
requestCreateStudyRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
Study

The RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
CreateStudyRequest request = new CreateStudyRequest
{
    ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
    Study = new Study(),
};
// Make the request
Study response = vizierServiceClient.CreateStudy(request);

CreateStudy(string, Study, CallSettings)

public virtual Study CreateStudy(string parent, Study study, CallSettings callSettings = null)

Creates a Study. A resource name will be generated after creation of the Study.

Parameters
NameDescription
parentstring

Required. The resource name of the Location to create the CustomJob in. Format: projects/{project}/locations/{location}

studyStudy

Required. The Study configuration used to create the Study.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
Study

The RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]";
Study study = new Study();
// Make the request
Study response = vizierServiceClient.CreateStudy(parent, study);

CreateStudyAsync(LocationName, Study, CallSettings)

public virtual Task<Study> CreateStudyAsync(LocationName parent, Study study, CallSettings callSettings = null)

Creates a Study. A resource name will be generated after creation of the Study.

Parameters
NameDescription
parentLocationName

Required. The resource name of the Location to create the CustomJob in. Format: projects/{project}/locations/{location}

studyStudy

Required. The Study configuration used to create the Study.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskStudy

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
LocationName parent = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
Study study = new Study();
// Make the request
Study response = await vizierServiceClient.CreateStudyAsync(parent, study);

CreateStudyAsync(LocationName, Study, CancellationToken)

public virtual Task<Study> CreateStudyAsync(LocationName parent, Study study, CancellationToken cancellationToken)

Creates a Study. A resource name will be generated after creation of the Study.

Parameters
NameDescription
parentLocationName

Required. The resource name of the Location to create the CustomJob in. Format: projects/{project}/locations/{location}

studyStudy

Required. The Study configuration used to create the Study.

cancellationTokenCancellationToken

A CancellationToken to use for this RPC.

Returns
TypeDescription
TaskStudy

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
LocationName parent = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
Study study = new Study();
// Make the request
Study response = await vizierServiceClient.CreateStudyAsync(parent, study);

CreateStudyAsync(CreateStudyRequest, CallSettings)

public virtual Task<Study> CreateStudyAsync(CreateStudyRequest request, CallSettings callSettings = null)

Creates a Study. A resource name will be generated after creation of the Study.

Parameters
NameDescription
requestCreateStudyRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskStudy

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
CreateStudyRequest request = new CreateStudyRequest
{
    ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
    Study = new Study(),
};
// Make the request
Study response = await vizierServiceClient.CreateStudyAsync(request);

CreateStudyAsync(CreateStudyRequest, CancellationToken)

public virtual Task<Study> CreateStudyAsync(CreateStudyRequest request, CancellationToken cancellationToken)

Creates a Study. A resource name will be generated after creation of the Study.

Parameters
NameDescription
requestCreateStudyRequest

The request object containing all of the parameters for the API call.

cancellationTokenCancellationToken

A CancellationToken to use for this RPC.

Returns
TypeDescription
TaskStudy

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
CreateStudyRequest request = new CreateStudyRequest
{
    ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
    Study = new Study(),
};
// Make the request
Study response = await vizierServiceClient.CreateStudyAsync(request);

CreateStudyAsync(string, Study, CallSettings)

public virtual Task<Study> CreateStudyAsync(string parent, Study study, CallSettings callSettings = null)

Creates a Study. A resource name will be generated after creation of the Study.

Parameters
NameDescription
parentstring

Required. The resource name of the Location to create the CustomJob in. Format: projects/{project}/locations/{location}

studyStudy

Required. The Study configuration used to create the Study.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskStudy

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]";
Study study = new Study();
// Make the request
Study response = await vizierServiceClient.CreateStudyAsync(parent, study);

CreateStudyAsync(string, Study, CancellationToken)

public virtual Task<Study> CreateStudyAsync(string parent, Study study, CancellationToken cancellationToken)

Creates a Study. A resource name will be generated after creation of the Study.

Parameters
NameDescription
parentstring

Required. The resource name of the Location to create the CustomJob in. Format: projects/{project}/locations/{location}

studyStudy

Required. The Study configuration used to create the Study.

cancellationTokenCancellationToken

A CancellationToken to use for this RPC.

Returns
TypeDescription
TaskStudy

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]";
Study study = new Study();
// Make the request
Study response = await vizierServiceClient.CreateStudyAsync(parent, study);

CreateTrial(CreateTrialRequest, CallSettings)

public virtual Trial CreateTrial(CreateTrialRequest request, CallSettings callSettings = null)

Adds a user provided Trial to a Study.

Parameters
NameDescription
requestCreateTrialRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
Trial

The RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
CreateTrialRequest request = new CreateTrialRequest
{
    ParentAsStudyName = StudyName.FromProjectLocationStudy("[PROJECT]", "[LOCATION]", "[STUDY]"),
    Trial = new Trial(),
};
// Make the request
Trial response = vizierServiceClient.CreateTrial(request);

CreateTrial(StudyName, Trial, CallSettings)

public virtual Trial CreateTrial(StudyName parent, Trial trial, CallSettings callSettings = null)

Adds a user provided Trial to a Study.

Parameters
NameDescription
parentStudyName

Required. The resource name of the Study to create the Trial in. Format: projects/{project}/locations/{location}/studies/{study}

trialTrial

Required. The Trial to create.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
Trial

The RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
StudyName parent = StudyName.FromProjectLocationStudy("[PROJECT]", "[LOCATION]", "[STUDY]");
Trial trial = new Trial();
// Make the request
Trial response = vizierServiceClient.CreateTrial(parent, trial);

CreateTrial(string, Trial, CallSettings)

public virtual Trial CreateTrial(string parent, Trial trial, CallSettings callSettings = null)

Adds a user provided Trial to a Study.

Parameters
NameDescription
parentstring

Required. The resource name of the Study to create the Trial in. Format: projects/{project}/locations/{location}/studies/{study}

trialTrial

Required. The Trial to create.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
Trial

The RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]/studies/[STUDY]";
Trial trial = new Trial();
// Make the request
Trial response = vizierServiceClient.CreateTrial(parent, trial);

CreateTrialAsync(CreateTrialRequest, CallSettings)

public virtual Task<Trial> CreateTrialAsync(CreateTrialRequest request, CallSettings callSettings = null)

Adds a user provided Trial to a Study.

Parameters
NameDescription
requestCreateTrialRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskTrial

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
CreateTrialRequest request = new CreateTrialRequest
{
    ParentAsStudyName = StudyName.FromProjectLocationStudy("[PROJECT]", "[LOCATION]", "[STUDY]"),
    Trial = new Trial(),
};
// Make the request
Trial response = await vizierServiceClient.CreateTrialAsync(request);

CreateTrialAsync(CreateTrialRequest, CancellationToken)

public virtual Task<Trial> CreateTrialAsync(CreateTrialRequest request, CancellationToken cancellationToken)

Adds a user provided Trial to a Study.

Parameters
NameDescription
requestCreateTrialRequest

The request object containing all of the parameters for the API call.

cancellationTokenCancellationToken

A CancellationToken to use for this RPC.

Returns
TypeDescription
TaskTrial

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
CreateTrialRequest request = new CreateTrialRequest
{
    ParentAsStudyName = StudyName.FromProjectLocationStudy("[PROJECT]", "[LOCATION]", "[STUDY]"),
    Trial = new Trial(),
};
// Make the request
Trial response = await vizierServiceClient.CreateTrialAsync(request);

CreateTrialAsync(StudyName, Trial, CallSettings)

public virtual Task<Trial> CreateTrialAsync(StudyName parent, Trial trial, CallSettings callSettings = null)

Adds a user provided Trial to a Study.

Parameters
NameDescription
parentStudyName

Required. The resource name of the Study to create the Trial in. Format: projects/{project}/locations/{location}/studies/{study}

trialTrial

Required. The Trial to create.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskTrial

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
StudyName parent = StudyName.FromProjectLocationStudy("[PROJECT]", "[LOCATION]", "[STUDY]");
Trial trial = new Trial();
// Make the request
Trial response = await vizierServiceClient.CreateTrialAsync(parent, trial);

CreateTrialAsync(StudyName, Trial, CancellationToken)

public virtual Task<Trial> CreateTrialAsync(StudyName parent, Trial trial, CancellationToken cancellationToken)

Adds a user provided Trial to a Study.

Parameters
NameDescription
parentStudyName

Required. The resource name of the Study to create the Trial in. Format: projects/{project}/locations/{location}/studies/{study}

trialTrial

Required. The Trial to create.

cancellationTokenCancellationToken

A CancellationToken to use for this RPC.

Returns
TypeDescription
TaskTrial

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
StudyName parent = StudyName.FromProjectLocationStudy("[PROJECT]", "[LOCATION]", "[STUDY]");
Trial trial = new Trial();
// Make the request
Trial response = await vizierServiceClient.CreateTrialAsync(parent, trial);

CreateTrialAsync(string, Trial, CallSettings)

public virtual Task<Trial> CreateTrialAsync(string parent, Trial trial, CallSettings callSettings = null)

Adds a user provided Trial to a Study.

Parameters
NameDescription
parentstring

Required. The resource name of the Study to create the Trial in. Format: projects/{project}/locations/{location}/studies/{study}

trialTrial

Required. The Trial to create.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskTrial

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]/studies/[STUDY]";
Trial trial = new Trial();
// Make the request
Trial response = await vizierServiceClient.CreateTrialAsync(parent, trial);

CreateTrialAsync(string, Trial, CancellationToken)

public virtual Task<Trial> CreateTrialAsync(string parent, Trial trial, CancellationToken cancellationToken)

Adds a user provided Trial to a Study.

Parameters
NameDescription
parentstring

Required. The resource name of the Study to create the Trial in. Format: projects/{project}/locations/{location}/studies/{study}

trialTrial

Required. The Trial to create.

cancellationTokenCancellationToken

A CancellationToken to use for this RPC.

Returns
TypeDescription
TaskTrial

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]/studies/[STUDY]";
Trial trial = new Trial();
// Make the request
Trial response = await vizierServiceClient.CreateTrialAsync(parent, trial);

DeleteStudy(DeleteStudyRequest, CallSettings)

public virtual void DeleteStudy(DeleteStudyRequest request, CallSettings callSettings = null)

Deletes a Study.

Parameters
NameDescription
requestDeleteStudyRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
DeleteStudyRequest request = new DeleteStudyRequest
{
    StudyName = StudyName.FromProjectLocationStudy("[PROJECT]", "[LOCATION]", "[STUDY]"),
};
// Make the request
vizierServiceClient.DeleteStudy(request);

DeleteStudy(StudyName, CallSettings)

public virtual void DeleteStudy(StudyName name, CallSettings callSettings = null)

Deletes a Study.

Parameters
NameDescription
nameStudyName

Required. The name of the Study resource to be deleted. Format: projects/{project}/locations/{location}/studies/{study}

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
StudyName name = StudyName.FromProjectLocationStudy("[PROJECT]", "[LOCATION]", "[STUDY]");
// Make the request
vizierServiceClient.DeleteStudy(name);

DeleteStudy(string, CallSettings)

public virtual void DeleteStudy(string name, CallSettings callSettings = null)

Deletes a Study.

Parameters
NameDescription
namestring

Required. The name of the Study resource to be deleted. Format: projects/{project}/locations/{location}/studies/{study}

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/studies/[STUDY]";
// Make the request
vizierServiceClient.DeleteStudy(name);

DeleteStudyAsync(DeleteStudyRequest, CallSettings)

public virtual Task DeleteStudyAsync(DeleteStudyRequest request, CallSettings callSettings = null)

Deletes a Study.

Parameters
NameDescription
requestDeleteStudyRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
Task

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
DeleteStudyRequest request = new DeleteStudyRequest
{
    StudyName = StudyName.FromProjectLocationStudy("[PROJECT]", "[LOCATION]", "[STUDY]"),
};
// Make the request
await vizierServiceClient.DeleteStudyAsync(request);

DeleteStudyAsync(DeleteStudyRequest, CancellationToken)

public virtual Task DeleteStudyAsync(DeleteStudyRequest request, CancellationToken cancellationToken)

Deletes a Study.

Parameters
NameDescription
requestDeleteStudyRequest

The request object containing all of the parameters for the API call.

cancellationTokenCancellationToken

A CancellationToken to use for this RPC.

Returns
TypeDescription
Task

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
DeleteStudyRequest request = new DeleteStudyRequest
{
    StudyName = StudyName.FromProjectLocationStudy("[PROJECT]", "[LOCATION]", "[STUDY]"),
};
// Make the request
await vizierServiceClient.DeleteStudyAsync(request);

DeleteStudyAsync(StudyName, CallSettings)

public virtual Task DeleteStudyAsync(StudyName name, CallSettings callSettings = null)

Deletes a Study.

Parameters
NameDescription
nameStudyName

Required. The name of the Study resource to be deleted. Format: projects/{project}/locations/{location}/studies/{study}

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
Task

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
StudyName name = StudyName.FromProjectLocationStudy("[PROJECT]", "[LOCATION]", "[STUDY]");
// Make the request
await vizierServiceClient.DeleteStudyAsync(name);

DeleteStudyAsync(StudyName, CancellationToken)

public virtual Task DeleteStudyAsync(StudyName name, CancellationToken cancellationToken)

Deletes a Study.

Parameters
NameDescription
nameStudyName

Required. The name of the Study resource to be deleted. Format: projects/{project}/locations/{location}/studies/{study}

cancellationTokenCancellationToken

A CancellationToken to use for this RPC.

Returns
TypeDescription
Task

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
StudyName name = StudyName.FromProjectLocationStudy("[PROJECT]", "[LOCATION]", "[STUDY]");
// Make the request
await vizierServiceClient.DeleteStudyAsync(name);

DeleteStudyAsync(string, CallSettings)

public virtual Task DeleteStudyAsync(string name, CallSettings callSettings = null)

Deletes a Study.

Parameters
NameDescription
namestring

Required. The name of the Study resource to be deleted. Format: projects/{project}/locations/{location}/studies/{study}

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
Task

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/studies/[STUDY]";
// Make the request
await vizierServiceClient.DeleteStudyAsync(name);

DeleteStudyAsync(string, CancellationToken)

public virtual Task DeleteStudyAsync(string name, CancellationToken cancellationToken)

Deletes a Study.

Parameters
NameDescription
namestring

Required. The name of the Study resource to be deleted. Format: projects/{project}/locations/{location}/studies/{study}

cancellationTokenCancellationToken

A CancellationToken to use for this RPC.

Returns
TypeDescription
Task

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/studies/[STUDY]";
// Make the request
await vizierServiceClient.DeleteStudyAsync(name);

DeleteTrial(DeleteTrialRequest, CallSettings)

public virtual void DeleteTrial(DeleteTrialRequest request, CallSettings callSettings = null)

Deletes a Trial.

Parameters
NameDescription
requestDeleteTrialRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
DeleteTrialRequest request = new DeleteTrialRequest
{
    TrialName = TrialName.FromProjectLocationStudyTrial("[PROJECT]", "[LOCATION]", "[STUDY]", "[TRIAL]"),
};
// Make the request
vizierServiceClient.DeleteTrial(request);

DeleteTrial(TrialName, CallSettings)

public virtual void DeleteTrial(TrialName name, CallSettings callSettings = null)

Deletes a Trial.

Parameters
NameDescription
nameTrialName

Required. The Trial's name. Format: projects/{project}/locations/{location}/studies/{study}/trials/{trial}

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
TrialName name = TrialName.FromProjectLocationStudyTrial("[PROJECT]", "[LOCATION]", "[STUDY]", "[TRIAL]");
// Make the request
vizierServiceClient.DeleteTrial(name);

DeleteTrial(string, CallSettings)

public virtual void DeleteTrial(string name, CallSettings callSettings = null)

Deletes a Trial.

Parameters
NameDescription
namestring

Required. The Trial's name. Format: projects/{project}/locations/{location}/studies/{study}/trials/{trial}

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/studies/[STUDY]/trials/[TRIAL]";
// Make the request
vizierServiceClient.DeleteTrial(name);

DeleteTrialAsync(DeleteTrialRequest, CallSettings)

public virtual Task DeleteTrialAsync(DeleteTrialRequest request, CallSettings callSettings = null)

Deletes a Trial.

Parameters
NameDescription
requestDeleteTrialRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
Task

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
DeleteTrialRequest request = new DeleteTrialRequest
{
    TrialName = TrialName.FromProjectLocationStudyTrial("[PROJECT]", "[LOCATION]", "[STUDY]", "[TRIAL]"),
};
// Make the request
await vizierServiceClient.DeleteTrialAsync(request);

DeleteTrialAsync(DeleteTrialRequest, CancellationToken)

public virtual Task DeleteTrialAsync(DeleteTrialRequest request, CancellationToken cancellationToken)

Deletes a Trial.

Parameters
NameDescription
requestDeleteTrialRequest

The request object containing all of the parameters for the API call.

cancellationTokenCancellationToken

A CancellationToken to use for this RPC.

Returns
TypeDescription
Task

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
DeleteTrialRequest request = new DeleteTrialRequest
{
    TrialName = TrialName.FromProjectLocationStudyTrial("[PROJECT]", "[LOCATION]", "[STUDY]", "[TRIAL]"),
};
// Make the request
await vizierServiceClient.DeleteTrialAsync(request);

DeleteTrialAsync(TrialName, CallSettings)

public virtual Task DeleteTrialAsync(TrialName name, CallSettings callSettings = null)

Deletes a Trial.

Parameters
NameDescription
nameTrialName

Required. The Trial's name. Format: projects/{project}/locations/{location}/studies/{study}/trials/{trial}

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
Task

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
TrialName name = TrialName.FromProjectLocationStudyTrial("[PROJECT]", "[LOCATION]", "[STUDY]", "[TRIAL]");
// Make the request
await vizierServiceClient.DeleteTrialAsync(name);

DeleteTrialAsync(TrialName, CancellationToken)

public virtual Task DeleteTrialAsync(TrialName name, CancellationToken cancellationToken)

Deletes a Trial.

Parameters
NameDescription
nameTrialName

Required. The Trial's name. Format: projects/{project}/locations/{location}/studies/{study}/trials/{trial}

cancellationTokenCancellationToken

A CancellationToken to use for this RPC.

Returns
TypeDescription
Task

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
TrialName name = TrialName.FromProjectLocationStudyTrial("[PROJECT]", "[LOCATION]", "[STUDY]", "[TRIAL]");
// Make the request
await vizierServiceClient.DeleteTrialAsync(name);

DeleteTrialAsync(string, CallSettings)

public virtual Task DeleteTrialAsync(string name, CallSettings callSettings = null)

Deletes a Trial.

Parameters
NameDescription
namestring

Required. The Trial's name. Format: projects/{project}/locations/{location}/studies/{study}/trials/{trial}

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
Task

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/studies/[STUDY]/trials/[TRIAL]";
// Make the request
await vizierServiceClient.DeleteTrialAsync(name);

DeleteTrialAsync(string, CancellationToken)

public virtual Task DeleteTrialAsync(string name, CancellationToken cancellationToken)

Deletes a Trial.

Parameters
NameDescription
namestring

Required. The Trial's name. Format: projects/{project}/locations/{location}/studies/{study}/trials/{trial}

cancellationTokenCancellationToken

A CancellationToken to use for this RPC.

Returns
TypeDescription
Task

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/studies/[STUDY]/trials/[TRIAL]";
// Make the request
await vizierServiceClient.DeleteTrialAsync(name);

GetStudy(GetStudyRequest, CallSettings)

public virtual Study GetStudy(GetStudyRequest request, CallSettings callSettings = null)

Gets a Study by name.

Parameters
NameDescription
requestGetStudyRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
Study

The RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
GetStudyRequest request = new GetStudyRequest
{
    StudyName = StudyName.FromProjectLocationStudy("[PROJECT]", "[LOCATION]", "[STUDY]"),
};
// Make the request
Study response = vizierServiceClient.GetStudy(request);

GetStudy(StudyName, CallSettings)

public virtual Study GetStudy(StudyName name, CallSettings callSettings = null)

Gets a Study by name.

Parameters
NameDescription
nameStudyName

Required. The name of the Study resource. Format: projects/{project}/locations/{location}/studies/{study}

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
Study

The RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
StudyName name = StudyName.FromProjectLocationStudy("[PROJECT]", "[LOCATION]", "[STUDY]");
// Make the request
Study response = vizierServiceClient.GetStudy(name);

GetStudy(string, CallSettings)

public virtual Study GetStudy(string name, CallSettings callSettings = null)

Gets a Study by name.

Parameters
NameDescription
namestring

Required. The name of the Study resource. Format: projects/{project}/locations/{location}/studies/{study}

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
Study

The RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/studies/[STUDY]";
// Make the request
Study response = vizierServiceClient.GetStudy(name);

GetStudyAsync(GetStudyRequest, CallSettings)

public virtual Task<Study> GetStudyAsync(GetStudyRequest request, CallSettings callSettings = null)

Gets a Study by name.

Parameters
NameDescription
requestGetStudyRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskStudy

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
GetStudyRequest request = new GetStudyRequest
{
    StudyName = StudyName.FromProjectLocationStudy("[PROJECT]", "[LOCATION]", "[STUDY]"),
};
// Make the request
Study response = await vizierServiceClient.GetStudyAsync(request);

GetStudyAsync(GetStudyRequest, CancellationToken)

public virtual Task<Study> GetStudyAsync(GetStudyRequest request, CancellationToken cancellationToken)

Gets a Study by name.

Parameters
NameDescription
requestGetStudyRequest

The request object containing all of the parameters for the API call.

cancellationTokenCancellationToken

A CancellationToken to use for this RPC.

Returns
TypeDescription
TaskStudy

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
GetStudyRequest request = new GetStudyRequest
{
    StudyName = StudyName.FromProjectLocationStudy("[PROJECT]", "[LOCATION]", "[STUDY]"),
};
// Make the request
Study response = await vizierServiceClient.GetStudyAsync(request);

GetStudyAsync(StudyName, CallSettings)

public virtual Task<Study> GetStudyAsync(StudyName name, CallSettings callSettings = null)

Gets a Study by name.

Parameters
NameDescription
nameStudyName

Required. The name of the Study resource. Format: projects/{project}/locations/{location}/studies/{study}

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskStudy

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
StudyName name = StudyName.FromProjectLocationStudy("[PROJECT]", "[LOCATION]", "[STUDY]");
// Make the request
Study response = await vizierServiceClient.GetStudyAsync(name);

GetStudyAsync(StudyName, CancellationToken)

public virtual Task<Study> GetStudyAsync(StudyName name, CancellationToken cancellationToken)

Gets a Study by name.

Parameters
NameDescription
nameStudyName

Required. The name of the Study resource. Format: projects/{project}/locations/{location}/studies/{study}

cancellationTokenCancellationToken

A CancellationToken to use for this RPC.

Returns
TypeDescription
TaskStudy

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
StudyName name = StudyName.FromProjectLocationStudy("[PROJECT]", "[LOCATION]", "[STUDY]");
// Make the request
Study response = await vizierServiceClient.GetStudyAsync(name);

GetStudyAsync(string, CallSettings)

public virtual Task<Study> GetStudyAsync(string name, CallSettings callSettings = null)

Gets a Study by name.

Parameters
NameDescription
namestring

Required. The name of the Study resource. Format: projects/{project}/locations/{location}/studies/{study}

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskStudy

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/studies/[STUDY]";
// Make the request
Study response = await vizierServiceClient.GetStudyAsync(name);

GetStudyAsync(string, CancellationToken)

public virtual Task<Study> GetStudyAsync(string name, CancellationToken cancellationToken)

Gets a Study by name.

Parameters
NameDescription
namestring

Required. The name of the Study resource. Format: projects/{project}/locations/{location}/studies/{study}

cancellationTokenCancellationToken

A CancellationToken to use for this RPC.

Returns
TypeDescription
TaskStudy

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/studies/[STUDY]";
// Make the request
Study response = await vizierServiceClient.GetStudyAsync(name);

GetTrial(GetTrialRequest, CallSettings)

public virtual Trial GetTrial(GetTrialRequest request, CallSettings callSettings = null)

Gets a Trial.

Parameters
NameDescription
requestGetTrialRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
Trial

The RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
GetTrialRequest request = new GetTrialRequest
{
    TrialName = TrialName.FromProjectLocationStudyTrial("[PROJECT]", "[LOCATION]", "[STUDY]", "[TRIAL]"),
};
// Make the request
Trial response = vizierServiceClient.GetTrial(request);

GetTrial(TrialName, CallSettings)

public virtual Trial GetTrial(TrialName name, CallSettings callSettings = null)

Gets a Trial.

Parameters
NameDescription
nameTrialName

Required. The name of the Trial resource. Format: projects/{project}/locations/{location}/studies/{study}/trials/{trial}

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
Trial

The RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
TrialName name = TrialName.FromProjectLocationStudyTrial("[PROJECT]", "[LOCATION]", "[STUDY]", "[TRIAL]");
// Make the request
Trial response = vizierServiceClient.GetTrial(name);

GetTrial(string, CallSettings)

public virtual Trial GetTrial(string name, CallSettings callSettings = null)

Gets a Trial.

Parameters
NameDescription
namestring

Required. The name of the Trial resource. Format: projects/{project}/locations/{location}/studies/{study}/trials/{trial}

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
Trial

The RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/studies/[STUDY]/trials/[TRIAL]";
// Make the request
Trial response = vizierServiceClient.GetTrial(name);

GetTrialAsync(GetTrialRequest, CallSettings)

public virtual Task<Trial> GetTrialAsync(GetTrialRequest request, CallSettings callSettings = null)

Gets a Trial.

Parameters
NameDescription
requestGetTrialRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskTrial

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
GetTrialRequest request = new GetTrialRequest
{
    TrialName = TrialName.FromProjectLocationStudyTrial("[PROJECT]", "[LOCATION]", "[STUDY]", "[TRIAL]"),
};
// Make the request
Trial response = await vizierServiceClient.GetTrialAsync(request);

GetTrialAsync(GetTrialRequest, CancellationToken)

public virtual Task<Trial> GetTrialAsync(GetTrialRequest request, CancellationToken cancellationToken)

Gets a Trial.

Parameters
NameDescription
requestGetTrialRequest

The request object containing all of the parameters for the API call.

cancellationTokenCancellationToken

A CancellationToken to use for this RPC.

Returns
TypeDescription
TaskTrial

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
GetTrialRequest request = new GetTrialRequest
{
    TrialName = TrialName.FromProjectLocationStudyTrial("[PROJECT]", "[LOCATION]", "[STUDY]", "[TRIAL]"),
};
// Make the request
Trial response = await vizierServiceClient.GetTrialAsync(request);

GetTrialAsync(TrialName, CallSettings)

public virtual Task<Trial> GetTrialAsync(TrialName name, CallSettings callSettings = null)

Gets a Trial.

Parameters
NameDescription
nameTrialName

Required. The name of the Trial resource. Format: projects/{project}/locations/{location}/studies/{study}/trials/{trial}

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskTrial

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
TrialName name = TrialName.FromProjectLocationStudyTrial("[PROJECT]", "[LOCATION]", "[STUDY]", "[TRIAL]");
// Make the request
Trial response = await vizierServiceClient.GetTrialAsync(name);

GetTrialAsync(TrialName, CancellationToken)

public virtual Task<Trial> GetTrialAsync(TrialName name, CancellationToken cancellationToken)

Gets a Trial.

Parameters
NameDescription
nameTrialName

Required. The name of the Trial resource. Format: projects/{project}/locations/{location}/studies/{study}/trials/{trial}

cancellationTokenCancellationToken

A CancellationToken to use for this RPC.

Returns
TypeDescription
TaskTrial

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
TrialName name = TrialName.FromProjectLocationStudyTrial("[PROJECT]", "[LOCATION]", "[STUDY]", "[TRIAL]");
// Make the request
Trial response = await vizierServiceClient.GetTrialAsync(name);

GetTrialAsync(string, CallSettings)

public virtual Task<Trial> GetTrialAsync(string name, CallSettings callSettings = null)

Gets a Trial.

Parameters
NameDescription
namestring

Required. The name of the Trial resource. Format: projects/{project}/locations/{location}/studies/{study}/trials/{trial}

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskTrial

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/studies/[STUDY]/trials/[TRIAL]";
// Make the request
Trial response = await vizierServiceClient.GetTrialAsync(name);

GetTrialAsync(string, CancellationToken)

public virtual Task<Trial> GetTrialAsync(string name, CancellationToken cancellationToken)

Gets a Trial.

Parameters
NameDescription
namestring

Required. The name of the Trial resource. Format: projects/{project}/locations/{location}/studies/{study}/trials/{trial}

cancellationTokenCancellationToken

A CancellationToken to use for this RPC.

Returns
TypeDescription
TaskTrial

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/studies/[STUDY]/trials/[TRIAL]";
// Make the request
Trial response = await vizierServiceClient.GetTrialAsync(name);

ListOptimalTrials(ListOptimalTrialsRequest, CallSettings)

public virtual ListOptimalTrialsResponse ListOptimalTrials(ListOptimalTrialsRequest request, CallSettings callSettings = null)

Lists the pareto-optimal Trials for multi-objective Study or the optimal Trials for single-objective Study. The definition of pareto-optimal can be checked in wiki page. https://en.wikipedia.org/wiki/Pareto_efficiency

Parameters
NameDescription
requestListOptimalTrialsRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
ListOptimalTrialsResponse

The RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
ListOptimalTrialsRequest request = new ListOptimalTrialsRequest
{
    ParentAsStudyName = StudyName.FromProjectLocationStudy("[PROJECT]", "[LOCATION]", "[STUDY]"),
};
// Make the request
ListOptimalTrialsResponse response = vizierServiceClient.ListOptimalTrials(request);

ListOptimalTrials(StudyName, CallSettings)

public virtual ListOptimalTrialsResponse ListOptimalTrials(StudyName parent, CallSettings callSettings = null)

Lists the pareto-optimal Trials for multi-objective Study or the optimal Trials for single-objective Study. The definition of pareto-optimal can be checked in wiki page. https://en.wikipedia.org/wiki/Pareto_efficiency

Parameters
NameDescription
parentStudyName

Required. The name of the Study that the optimal Trial belongs to.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
ListOptimalTrialsResponse

The RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
StudyName parent = StudyName.FromProjectLocationStudy("[PROJECT]", "[LOCATION]", "[STUDY]");
// Make the request
ListOptimalTrialsResponse response = vizierServiceClient.ListOptimalTrials(parent);

ListOptimalTrials(string, CallSettings)

public virtual ListOptimalTrialsResponse ListOptimalTrials(string parent, CallSettings callSettings = null)

Lists the pareto-optimal Trials for multi-objective Study or the optimal Trials for single-objective Study. The definition of pareto-optimal can be checked in wiki page. https://en.wikipedia.org/wiki/Pareto_efficiency

Parameters
NameDescription
parentstring

Required. The name of the Study that the optimal Trial belongs to.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
ListOptimalTrialsResponse

The RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]/studies/[STUDY]";
// Make the request
ListOptimalTrialsResponse response = vizierServiceClient.ListOptimalTrials(parent);

ListOptimalTrialsAsync(ListOptimalTrialsRequest, CallSettings)

public virtual Task<ListOptimalTrialsResponse> ListOptimalTrialsAsync(ListOptimalTrialsRequest request, CallSettings callSettings = null)

Lists the pareto-optimal Trials for multi-objective Study or the optimal Trials for single-objective Study. The definition of pareto-optimal can be checked in wiki page. https://en.wikipedia.org/wiki/Pareto_efficiency

Parameters
NameDescription
requestListOptimalTrialsRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskListOptimalTrialsResponse

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
ListOptimalTrialsRequest request = new ListOptimalTrialsRequest
{
    ParentAsStudyName = StudyName.FromProjectLocationStudy("[PROJECT]", "[LOCATION]", "[STUDY]"),
};
// Make the request
ListOptimalTrialsResponse response = await vizierServiceClient.ListOptimalTrialsAsync(request);

ListOptimalTrialsAsync(ListOptimalTrialsRequest, CancellationToken)

public virtual Task<ListOptimalTrialsResponse> ListOptimalTrialsAsync(ListOptimalTrialsRequest request, CancellationToken cancellationToken)

Lists the pareto-optimal Trials for multi-objective Study or the optimal Trials for single-objective Study. The definition of pareto-optimal can be checked in wiki page. https://en.wikipedia.org/wiki/Pareto_efficiency

Parameters
NameDescription
requestListOptimalTrialsRequest

The request object containing all of the parameters for the API call.

cancellationTokenCancellationToken

A CancellationToken to use for this RPC.

Returns
TypeDescription
TaskListOptimalTrialsResponse

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
ListOptimalTrialsRequest request = new ListOptimalTrialsRequest
{
    ParentAsStudyName = StudyName.FromProjectLocationStudy("[PROJECT]", "[LOCATION]", "[STUDY]"),
};
// Make the request
ListOptimalTrialsResponse response = await vizierServiceClient.ListOptimalTrialsAsync(request);

ListOptimalTrialsAsync(StudyName, CallSettings)

public virtual Task<ListOptimalTrialsResponse> ListOptimalTrialsAsync(StudyName parent, CallSettings callSettings = null)

Lists the pareto-optimal Trials for multi-objective Study or the optimal Trials for single-objective Study. The definition of pareto-optimal can be checked in wiki page. https://en.wikipedia.org/wiki/Pareto_efficiency

Parameters
NameDescription
parentStudyName

Required. The name of the Study that the optimal Trial belongs to.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskListOptimalTrialsResponse

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
StudyName parent = StudyName.FromProjectLocationStudy("[PROJECT]", "[LOCATION]", "[STUDY]");
// Make the request
ListOptimalTrialsResponse response = await vizierServiceClient.ListOptimalTrialsAsync(parent);

ListOptimalTrialsAsync(StudyName, CancellationToken)

public virtual Task<ListOptimalTrialsResponse> ListOptimalTrialsAsync(StudyName parent, CancellationToken cancellationToken)

Lists the pareto-optimal Trials for multi-objective Study or the optimal Trials for single-objective Study. The definition of pareto-optimal can be checked in wiki page. https://en.wikipedia.org/wiki/Pareto_efficiency

Parameters
NameDescription
parentStudyName

Required. The name of the Study that the optimal Trial belongs to.

cancellationTokenCancellationToken

A CancellationToken to use for this RPC.

Returns
TypeDescription
TaskListOptimalTrialsResponse

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
StudyName parent = StudyName.FromProjectLocationStudy("[PROJECT]", "[LOCATION]", "[STUDY]");
// Make the request
ListOptimalTrialsResponse response = await vizierServiceClient.ListOptimalTrialsAsync(parent);

ListOptimalTrialsAsync(string, CallSettings)

public virtual Task<ListOptimalTrialsResponse> ListOptimalTrialsAsync(string parent, CallSettings callSettings = null)

Lists the pareto-optimal Trials for multi-objective Study or the optimal Trials for single-objective Study. The definition of pareto-optimal can be checked in wiki page. https://en.wikipedia.org/wiki/Pareto_efficiency

Parameters
NameDescription
parentstring

Required. The name of the Study that the optimal Trial belongs to.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskListOptimalTrialsResponse

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]/studies/[STUDY]";
// Make the request
ListOptimalTrialsResponse response = await vizierServiceClient.ListOptimalTrialsAsync(parent);

ListOptimalTrialsAsync(string, CancellationToken)

public virtual Task<ListOptimalTrialsResponse> ListOptimalTrialsAsync(string parent, CancellationToken cancellationToken)

Lists the pareto-optimal Trials for multi-objective Study or the optimal Trials for single-objective Study. The definition of pareto-optimal can be checked in wiki page. https://en.wikipedia.org/wiki/Pareto_efficiency

Parameters
NameDescription
parentstring

Required. The name of the Study that the optimal Trial belongs to.

cancellationTokenCancellationToken

A CancellationToken to use for this RPC.

Returns
TypeDescription
TaskListOptimalTrialsResponse

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]/studies/[STUDY]";
// Make the request
ListOptimalTrialsResponse response = await vizierServiceClient.ListOptimalTrialsAsync(parent);

ListStudies(LocationName, string, int?, CallSettings)

public virtual PagedEnumerable<ListStudiesResponse, Study> ListStudies(LocationName parent, string pageToken = null, int? pageSize = null, CallSettings callSettings = null)

Lists all the studies in a region for an associated project.

Parameters
NameDescription
parentLocationName

Required. The resource name of the Location to list the Study from. Format: projects/{project}/locations/{location}

pageTokenstring

The token returned from the previous request. A value of null or an empty string retrieves the first page.

pageSizeint

The size of page to request. The response will not be larger than this, but may be smaller. A value of null or 0 uses a server-defined page size.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
PagedEnumerableListStudiesResponseStudy

A pageable sequence of Study resources.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
LocationName parent = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
// Make the request
PagedEnumerable<ListStudiesResponse, Study> response = vizierServiceClient.ListStudies(parent);

// Iterate over all response items, lazily performing RPCs as required
foreach (Study item in response)
{
    // Do something with each item
    Console.WriteLine(item);
}

// Or iterate over pages (of server-defined size), performing one RPC per page
foreach (ListStudiesResponse page in response.AsRawResponses())
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (Study item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
}

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<Study> singlePage = response.ReadPage(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Study item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

ListStudies(ListStudiesRequest, CallSettings)

public virtual PagedEnumerable<ListStudiesResponse, Study> ListStudies(ListStudiesRequest request, CallSettings callSettings = null)

Lists all the studies in a region for an associated project.

Parameters
NameDescription
requestListStudiesRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
PagedEnumerableListStudiesResponseStudy

A pageable sequence of Study resources.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
ListStudiesRequest request = new ListStudiesRequest
{
    ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
};
// Make the request
PagedEnumerable<ListStudiesResponse, Study> response = vizierServiceClient.ListStudies(request);

// Iterate over all response items, lazily performing RPCs as required
foreach (Study item in response)
{
    // Do something with each item
    Console.WriteLine(item);
}

// Or iterate over pages (of server-defined size), performing one RPC per page
foreach (ListStudiesResponse page in response.AsRawResponses())
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (Study item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
}

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<Study> singlePage = response.ReadPage(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Study item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

ListStudies(string, string, int?, CallSettings)

public virtual PagedEnumerable<ListStudiesResponse, Study> ListStudies(string parent, string pageToken = null, int? pageSize = null, CallSettings callSettings = null)

Lists all the studies in a region for an associated project.

Parameters
NameDescription
parentstring

Required. The resource name of the Location to list the Study from. Format: projects/{project}/locations/{location}

pageTokenstring

The token returned from the previous request. A value of null or an empty string retrieves the first page.

pageSizeint

The size of page to request. The response will not be larger than this, but may be smaller. A value of null or 0 uses a server-defined page size.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
PagedEnumerableListStudiesResponseStudy

A pageable sequence of Study resources.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]";
// Make the request
PagedEnumerable<ListStudiesResponse, Study> response = vizierServiceClient.ListStudies(parent);

// Iterate over all response items, lazily performing RPCs as required
foreach (Study item in response)
{
    // Do something with each item
    Console.WriteLine(item);
}

// Or iterate over pages (of server-defined size), performing one RPC per page
foreach (ListStudiesResponse page in response.AsRawResponses())
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (Study item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
}

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<Study> singlePage = response.ReadPage(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Study item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

ListStudiesAsync(LocationName, string, int?, CallSettings)

public virtual PagedAsyncEnumerable<ListStudiesResponse, Study> ListStudiesAsync(LocationName parent, string pageToken = null, int? pageSize = null, CallSettings callSettings = null)

Lists all the studies in a region for an associated project.

Parameters
NameDescription
parentLocationName

Required. The resource name of the Location to list the Study from. Format: projects/{project}/locations/{location}

pageTokenstring

The token returned from the previous request. A value of null or an empty string retrieves the first page.

pageSizeint

The size of page to request. The response will not be larger than this, but may be smaller. A value of null or 0 uses a server-defined page size.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
PagedAsyncEnumerableListStudiesResponseStudy

A pageable asynchronous sequence of Study resources.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
LocationName parent = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
// Make the request
PagedAsyncEnumerable<ListStudiesResponse, Study> response = vizierServiceClient.ListStudiesAsync(parent);

// Iterate over all response items, lazily performing RPCs as required
await response.ForEachAsync((Study item) =>
{
    // Do something with each item
    Console.WriteLine(item);
});

// Or iterate over pages (of server-defined size), performing one RPC per page
await response.AsRawResponses().ForEachAsync((ListStudiesResponse page) =>
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (Study item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
});

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<Study> singlePage = await response.ReadPageAsync(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Study item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

ListStudiesAsync(ListStudiesRequest, CallSettings)

public virtual PagedAsyncEnumerable<ListStudiesResponse, Study> ListStudiesAsync(ListStudiesRequest request, CallSettings callSettings = null)

Lists all the studies in a region for an associated project.

Parameters
NameDescription
requestListStudiesRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
PagedAsyncEnumerableListStudiesResponseStudy

A pageable asynchronous sequence of Study resources.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
ListStudiesRequest request = new ListStudiesRequest
{
    ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
};
// Make the request
PagedAsyncEnumerable<ListStudiesResponse, Study> response = vizierServiceClient.ListStudiesAsync(request);

// Iterate over all response items, lazily performing RPCs as required
await response.ForEachAsync((Study item) =>
{
    // Do something with each item
    Console.WriteLine(item);
});

// Or iterate over pages (of server-defined size), performing one RPC per page
await response.AsRawResponses().ForEachAsync((ListStudiesResponse page) =>
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (Study item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
});

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<Study> singlePage = await response.ReadPageAsync(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Study item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

ListStudiesAsync(string, string, int?, CallSettings)

public virtual PagedAsyncEnumerable<ListStudiesResponse, Study> ListStudiesAsync(string parent, string pageToken = null, int? pageSize = null, CallSettings callSettings = null)

Lists all the studies in a region for an associated project.

Parameters
NameDescription
parentstring

Required. The resource name of the Location to list the Study from. Format: projects/{project}/locations/{location}

pageTokenstring

The token returned from the previous request. A value of null or an empty string retrieves the first page.

pageSizeint

The size of page to request. The response will not be larger than this, but may be smaller. A value of null or 0 uses a server-defined page size.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
PagedAsyncEnumerableListStudiesResponseStudy

A pageable asynchronous sequence of Study resources.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]";
// Make the request
PagedAsyncEnumerable<ListStudiesResponse, Study> response = vizierServiceClient.ListStudiesAsync(parent);

// Iterate over all response items, lazily performing RPCs as required
await response.ForEachAsync((Study item) =>
{
    // Do something with each item
    Console.WriteLine(item);
});

// Or iterate over pages (of server-defined size), performing one RPC per page
await response.AsRawResponses().ForEachAsync((ListStudiesResponse page) =>
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (Study item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
});

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<Study> singlePage = await response.ReadPageAsync(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Study item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

ListTrials(ListTrialsRequest, CallSettings)

public virtual PagedEnumerable<ListTrialsResponse, Trial> ListTrials(ListTrialsRequest request, CallSettings callSettings = null)

Lists the Trials associated with a Study.

Parameters
NameDescription
requestListTrialsRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
PagedEnumerableListTrialsResponseTrial

A pageable sequence of Trial resources.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
ListTrialsRequest request = new ListTrialsRequest
{
    ParentAsStudyName = StudyName.FromProjectLocationStudy("[PROJECT]", "[LOCATION]", "[STUDY]"),
};
// Make the request
PagedEnumerable<ListTrialsResponse, Trial> response = vizierServiceClient.ListTrials(request);

// Iterate over all response items, lazily performing RPCs as required
foreach (Trial item in response)
{
    // Do something with each item
    Console.WriteLine(item);
}

// Or iterate over pages (of server-defined size), performing one RPC per page
foreach (ListTrialsResponse page in response.AsRawResponses())
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (Trial item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
}

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<Trial> singlePage = response.ReadPage(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Trial item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

ListTrials(StudyName, string, int?, CallSettings)

public virtual PagedEnumerable<ListTrialsResponse, Trial> ListTrials(StudyName parent, string pageToken = null, int? pageSize = null, CallSettings callSettings = null)

Lists the Trials associated with a Study.

Parameters
NameDescription
parentStudyName

Required. The resource name of the Study to list the Trial from. Format: projects/{project}/locations/{location}/studies/{study}

pageTokenstring

The token returned from the previous request. A value of null or an empty string retrieves the first page.

pageSizeint

The size of page to request. The response will not be larger than this, but may be smaller. A value of null or 0 uses a server-defined page size.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
PagedEnumerableListTrialsResponseTrial

A pageable sequence of Trial resources.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
StudyName parent = StudyName.FromProjectLocationStudy("[PROJECT]", "[LOCATION]", "[STUDY]");
// Make the request
PagedEnumerable<ListTrialsResponse, Trial> response = vizierServiceClient.ListTrials(parent);

// Iterate over all response items, lazily performing RPCs as required
foreach (Trial item in response)
{
    // Do something with each item
    Console.WriteLine(item);
}

// Or iterate over pages (of server-defined size), performing one RPC per page
foreach (ListTrialsResponse page in response.AsRawResponses())
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (Trial item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
}

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<Trial> singlePage = response.ReadPage(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Trial item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

ListTrials(string, string, int?, CallSettings)

public virtual PagedEnumerable<ListTrialsResponse, Trial> ListTrials(string parent, string pageToken = null, int? pageSize = null, CallSettings callSettings = null)

Lists the Trials associated with a Study.

Parameters
NameDescription
parentstring

Required. The resource name of the Study to list the Trial from. Format: projects/{project}/locations/{location}/studies/{study}

pageTokenstring

The token returned from the previous request. A value of null or an empty string retrieves the first page.

pageSizeint

The size of page to request. The response will not be larger than this, but may be smaller. A value of null or 0 uses a server-defined page size.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
PagedEnumerableListTrialsResponseTrial

A pageable sequence of Trial resources.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]/studies/[STUDY]";
// Make the request
PagedEnumerable<ListTrialsResponse, Trial> response = vizierServiceClient.ListTrials(parent);

// Iterate over all response items, lazily performing RPCs as required
foreach (Trial item in response)
{
    // Do something with each item
    Console.WriteLine(item);
}

// Or iterate over pages (of server-defined size), performing one RPC per page
foreach (ListTrialsResponse page in response.AsRawResponses())
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (Trial item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
}

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<Trial> singlePage = response.ReadPage(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Trial item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

ListTrialsAsync(ListTrialsRequest, CallSettings)

public virtual PagedAsyncEnumerable<ListTrialsResponse, Trial> ListTrialsAsync(ListTrialsRequest request, CallSettings callSettings = null)

Lists the Trials associated with a Study.

Parameters
NameDescription
requestListTrialsRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
PagedAsyncEnumerableListTrialsResponseTrial

A pageable asynchronous sequence of Trial resources.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
ListTrialsRequest request = new ListTrialsRequest
{
    ParentAsStudyName = StudyName.FromProjectLocationStudy("[PROJECT]", "[LOCATION]", "[STUDY]"),
};
// Make the request
PagedAsyncEnumerable<ListTrialsResponse, Trial> response = vizierServiceClient.ListTrialsAsync(request);

// Iterate over all response items, lazily performing RPCs as required
await response.ForEachAsync((Trial item) =>
{
    // Do something with each item
    Console.WriteLine(item);
});

// Or iterate over pages (of server-defined size), performing one RPC per page
await response.AsRawResponses().ForEachAsync((ListTrialsResponse page) =>
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (Trial item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
});

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<Trial> singlePage = await response.ReadPageAsync(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Trial item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

ListTrialsAsync(StudyName, string, int?, CallSettings)

public virtual PagedAsyncEnumerable<ListTrialsResponse, Trial> ListTrialsAsync(StudyName parent, string pageToken = null, int? pageSize = null, CallSettings callSettings = null)

Lists the Trials associated with a Study.

Parameters
NameDescription
parentStudyName

Required. The resource name of the Study to list the Trial from. Format: projects/{project}/locations/{location}/studies/{study}

pageTokenstring

The token returned from the previous request. A value of null or an empty string retrieves the first page.

pageSizeint

The size of page to request. The response will not be larger than this, but may be smaller. A value of null or 0 uses a server-defined page size.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
PagedAsyncEnumerableListTrialsResponseTrial

A pageable asynchronous sequence of Trial resources.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
StudyName parent = StudyName.FromProjectLocationStudy("[PROJECT]", "[LOCATION]", "[STUDY]");
// Make the request
PagedAsyncEnumerable<ListTrialsResponse, Trial> response = vizierServiceClient.ListTrialsAsync(parent);

// Iterate over all response items, lazily performing RPCs as required
await response.ForEachAsync((Trial item) =>
{
    // Do something with each item
    Console.WriteLine(item);
});

// Or iterate over pages (of server-defined size), performing one RPC per page
await response.AsRawResponses().ForEachAsync((ListTrialsResponse page) =>
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (Trial item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
});

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<Trial> singlePage = await response.ReadPageAsync(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Trial item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

ListTrialsAsync(string, string, int?, CallSettings)

public virtual PagedAsyncEnumerable<ListTrialsResponse, Trial> ListTrialsAsync(string parent, string pageToken = null, int? pageSize = null, CallSettings callSettings = null)

Lists the Trials associated with a Study.

Parameters
NameDescription
parentstring

Required. The resource name of the Study to list the Trial from. Format: projects/{project}/locations/{location}/studies/{study}

pageTokenstring

The token returned from the previous request. A value of null or an empty string retrieves the first page.

pageSizeint

The size of page to request. The response will not be larger than this, but may be smaller. A value of null or 0 uses a server-defined page size.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
PagedAsyncEnumerableListTrialsResponseTrial

A pageable asynchronous sequence of Trial resources.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]/studies/[STUDY]";
// Make the request
PagedAsyncEnumerable<ListTrialsResponse, Trial> response = vizierServiceClient.ListTrialsAsync(parent);

// Iterate over all response items, lazily performing RPCs as required
await response.ForEachAsync((Trial item) =>
{
    // Do something with each item
    Console.WriteLine(item);
});

// Or iterate over pages (of server-defined size), performing one RPC per page
await response.AsRawResponses().ForEachAsync((ListTrialsResponse page) =>
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (Trial item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
});

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<Trial> singlePage = await response.ReadPageAsync(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Trial item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

LookupStudy(LocationName, CallSettings)

public virtual Study LookupStudy(LocationName parent, CallSettings callSettings = null)

Looks a study up using the user-defined display_name field instead of the fully qualified resource name.

Parameters
NameDescription
parentLocationName

Required. The resource name of the Location to get the Study from. Format: projects/{project}/locations/{location}

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
Study

The RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
LocationName parent = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
// Make the request
Study response = vizierServiceClient.LookupStudy(parent);

LookupStudy(LookupStudyRequest, CallSettings)

public virtual Study LookupStudy(LookupStudyRequest request, CallSettings callSettings = null)

Looks a study up using the user-defined display_name field instead of the fully qualified resource name.

Parameters
NameDescription
requestLookupStudyRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
Study

The RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
LookupStudyRequest request = new LookupStudyRequest
{
    ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
    DisplayName = "",
};
// Make the request
Study response = vizierServiceClient.LookupStudy(request);

LookupStudy(string, CallSettings)

public virtual Study LookupStudy(string parent, CallSettings callSettings = null)

Looks a study up using the user-defined display_name field instead of the fully qualified resource name.

Parameters
NameDescription
parentstring

Required. The resource name of the Location to get the Study from. Format: projects/{project}/locations/{location}

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
Study

The RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]";
// Make the request
Study response = vizierServiceClient.LookupStudy(parent);

LookupStudyAsync(LocationName, CallSettings)

public virtual Task<Study> LookupStudyAsync(LocationName parent, CallSettings callSettings = null)

Looks a study up using the user-defined display_name field instead of the fully qualified resource name.

Parameters
NameDescription
parentLocationName

Required. The resource name of the Location to get the Study from. Format: projects/{project}/locations/{location}

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskStudy

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
LocationName parent = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
// Make the request
Study response = await vizierServiceClient.LookupStudyAsync(parent);

LookupStudyAsync(LocationName, CancellationToken)

public virtual Task<Study> LookupStudyAsync(LocationName parent, CancellationToken cancellationToken)

Looks a study up using the user-defined display_name field instead of the fully qualified resource name.

Parameters
NameDescription
parentLocationName

Required. The resource name of the Location to get the Study from. Format: projects/{project}/locations/{location}

cancellationTokenCancellationToken

A CancellationToken to use for this RPC.

Returns
TypeDescription
TaskStudy

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
LocationName parent = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
// Make the request
Study response = await vizierServiceClient.LookupStudyAsync(parent);

LookupStudyAsync(LookupStudyRequest, CallSettings)

public virtual Task<Study> LookupStudyAsync(LookupStudyRequest request, CallSettings callSettings = null)

Looks a study up using the user-defined display_name field instead of the fully qualified resource name.

Parameters
NameDescription
requestLookupStudyRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskStudy

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
LookupStudyRequest request = new LookupStudyRequest
{
    ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
    DisplayName = "",
};
// Make the request
Study response = await vizierServiceClient.LookupStudyAsync(request);

LookupStudyAsync(LookupStudyRequest, CancellationToken)

public virtual Task<Study> LookupStudyAsync(LookupStudyRequest request, CancellationToken cancellationToken)

Looks a study up using the user-defined display_name field instead of the fully qualified resource name.

Parameters
NameDescription
requestLookupStudyRequest

The request object containing all of the parameters for the API call.

cancellationTokenCancellationToken

A CancellationToken to use for this RPC.

Returns
TypeDescription
TaskStudy

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
LookupStudyRequest request = new LookupStudyRequest
{
    ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
    DisplayName = "",
};
// Make the request
Study response = await vizierServiceClient.LookupStudyAsync(request);

LookupStudyAsync(string, CallSettings)

public virtual Task<Study> LookupStudyAsync(string parent, CallSettings callSettings = null)

Looks a study up using the user-defined display_name field instead of the fully qualified resource name.

Parameters
NameDescription
parentstring

Required. The resource name of the Location to get the Study from. Format: projects/{project}/locations/{location}

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskStudy

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]";
// Make the request
Study response = await vizierServiceClient.LookupStudyAsync(parent);

LookupStudyAsync(string, CancellationToken)

public virtual Task<Study> LookupStudyAsync(string parent, CancellationToken cancellationToken)

Looks a study up using the user-defined display_name field instead of the fully qualified resource name.

Parameters
NameDescription
parentstring

Required. The resource name of the Location to get the Study from. Format: projects/{project}/locations/{location}

cancellationTokenCancellationToken

A CancellationToken to use for this RPC.

Returns
TypeDescription
TaskStudy

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]";
// Make the request
Study response = await vizierServiceClient.LookupStudyAsync(parent);

PollOnceCheckTrialEarlyStoppingState(string, CallSettings)

public virtual Operation<CheckTrialEarlyStoppingStateResponse, CheckTrialEarlyStoppingStateMetatdata> PollOnceCheckTrialEarlyStoppingState(string operationName, CallSettings callSettings = null)

Poll an operation once, using an operationName from a previous invocation of CheckTrialEarlyStoppingState.

Parameters
NameDescription
operationNamestring

The name of a previously invoked operation. Must not be null or empty.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
OperationCheckTrialEarlyStoppingStateResponseCheckTrialEarlyStoppingStateMetatdata

The result of polling the operation.

PollOnceCheckTrialEarlyStoppingStateAsync(string, CallSettings)

public virtual Task<Operation<CheckTrialEarlyStoppingStateResponse, CheckTrialEarlyStoppingStateMetatdata>> PollOnceCheckTrialEarlyStoppingStateAsync(string operationName, CallSettings callSettings = null)

Asynchronously poll an operation once, using an operationName from a previous invocation of CheckTrialEarlyStoppingState.

Parameters
NameDescription
operationNamestring

The name of a previously invoked operation. Must not be null or empty.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskOperationCheckTrialEarlyStoppingStateResponseCheckTrialEarlyStoppingStateMetatdata

A task representing the result of polling the operation.

PollOnceSuggestTrials(string, CallSettings)

public virtual Operation<SuggestTrialsResponse, SuggestTrialsMetadata> PollOnceSuggestTrials(string operationName, CallSettings callSettings = null)

Poll an operation once, using an operationName from a previous invocation of SuggestTrials.

Parameters
NameDescription
operationNamestring

The name of a previously invoked operation. Must not be null or empty.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
OperationSuggestTrialsResponseSuggestTrialsMetadata

The result of polling the operation.

PollOnceSuggestTrialsAsync(string, CallSettings)

public virtual Task<Operation<SuggestTrialsResponse, SuggestTrialsMetadata>> PollOnceSuggestTrialsAsync(string operationName, CallSettings callSettings = null)

Asynchronously poll an operation once, using an operationName from a previous invocation of SuggestTrials.

Parameters
NameDescription
operationNamestring

The name of a previously invoked operation. Must not be null or empty.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskOperationSuggestTrialsResponseSuggestTrialsMetadata

A task representing the result of polling the operation.

ShutdownDefaultChannelsAsync()

public static Task ShutdownDefaultChannelsAsync()

Shuts down any channels automatically created by Create() and CreateAsync(CancellationToken). Channels which weren't automatically created are not affected.

Returns
TypeDescription
Task

A task representing the asynchronous shutdown operation.

Remarks

After calling this method, further calls to Create() and CreateAsync(CancellationToken) will create new channels, which could in turn be shut down by another call to this method.

StopTrial(StopTrialRequest, CallSettings)

public virtual Trial StopTrial(StopTrialRequest request, CallSettings callSettings = null)

Stops a Trial.

Parameters
NameDescription
requestStopTrialRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
Trial

The RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
StopTrialRequest request = new StopTrialRequest
{
    TrialName = TrialName.FromProjectLocationStudyTrial("[PROJECT]", "[LOCATION]", "[STUDY]", "[TRIAL]"),
};
// Make the request
Trial response = vizierServiceClient.StopTrial(request);

StopTrialAsync(StopTrialRequest, CallSettings)

public virtual Task<Trial> StopTrialAsync(StopTrialRequest request, CallSettings callSettings = null)

Stops a Trial.

Parameters
NameDescription
requestStopTrialRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskTrial

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
StopTrialRequest request = new StopTrialRequest
{
    TrialName = TrialName.FromProjectLocationStudyTrial("[PROJECT]", "[LOCATION]", "[STUDY]", "[TRIAL]"),
};
// Make the request
Trial response = await vizierServiceClient.StopTrialAsync(request);

StopTrialAsync(StopTrialRequest, CancellationToken)

public virtual Task<Trial> StopTrialAsync(StopTrialRequest request, CancellationToken cancellationToken)

Stops a Trial.

Parameters
NameDescription
requestStopTrialRequest

The request object containing all of the parameters for the API call.

cancellationTokenCancellationToken

A CancellationToken to use for this RPC.

Returns
TypeDescription
TaskTrial

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
StopTrialRequest request = new StopTrialRequest
{
    TrialName = TrialName.FromProjectLocationStudyTrial("[PROJECT]", "[LOCATION]", "[STUDY]", "[TRIAL]"),
};
// Make the request
Trial response = await vizierServiceClient.StopTrialAsync(request);

SuggestTrials(SuggestTrialsRequest, CallSettings)

public virtual Operation<SuggestTrialsResponse, SuggestTrialsMetadata> SuggestTrials(SuggestTrialsRequest request, CallSettings callSettings = null)

Adds one or more Trials to a Study, with parameter values suggested by Vertex AI Vizier. Returns a long-running operation associated with the generation of Trial suggestions. When this long-running operation succeeds, it will contain a [SuggestTrialsResponse][google.cloud.aiplatform.v1.SuggestTrialsResponse].

Parameters
NameDescription
requestSuggestTrialsRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
OperationSuggestTrialsResponseSuggestTrialsMetadata

The RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = VizierServiceClient.Create();
// Initialize request argument(s)
SuggestTrialsRequest request = new SuggestTrialsRequest
{
    ParentAsStudyName = StudyName.FromProjectLocationStudy("[PROJECT]", "[LOCATION]", "[STUDY]"),
    SuggestionCount = 0,
    ClientId = "",
    Contexts = { new TrialContext(), },
};
// Make the request
Operation<SuggestTrialsResponse, SuggestTrialsMetadata> response = vizierServiceClient.SuggestTrials(request);

// Poll until the returned long-running operation is complete
Operation<SuggestTrialsResponse, SuggestTrialsMetadata> completedResponse = response.PollUntilCompleted();
// Retrieve the operation result
SuggestTrialsResponse result = completedResponse.Result;

// Or get the name of the operation
string operationName = response.Name;
// This name can be stored, then the long-running operation retrieved later by name
Operation<SuggestTrialsResponse, SuggestTrialsMetadata> retrievedResponse = vizierServiceClient.PollOnceSuggestTrials(operationName);
// Check if the retrieved long-running operation has completed
if (retrievedResponse.IsCompleted)
{
    // If it has completed, then access the result
    SuggestTrialsResponse retrievedResult = retrievedResponse.Result;
}

SuggestTrialsAsync(SuggestTrialsRequest, CallSettings)

public virtual Task<Operation<SuggestTrialsResponse, SuggestTrialsMetadata>> SuggestTrialsAsync(SuggestTrialsRequest request, CallSettings callSettings = null)

Adds one or more Trials to a Study, with parameter values suggested by Vertex AI Vizier. Returns a long-running operation associated with the generation of Trial suggestions. When this long-running operation succeeds, it will contain a [SuggestTrialsResponse][google.cloud.aiplatform.v1.SuggestTrialsResponse].

Parameters
NameDescription
requestSuggestTrialsRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskOperationSuggestTrialsResponseSuggestTrialsMetadata

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
SuggestTrialsRequest request = new SuggestTrialsRequest
{
    ParentAsStudyName = StudyName.FromProjectLocationStudy("[PROJECT]", "[LOCATION]", "[STUDY]"),
    SuggestionCount = 0,
    ClientId = "",
    Contexts = { new TrialContext(), },
};
// Make the request
Operation<SuggestTrialsResponse, SuggestTrialsMetadata> response = await vizierServiceClient.SuggestTrialsAsync(request);

// Poll until the returned long-running operation is complete
Operation<SuggestTrialsResponse, SuggestTrialsMetadata> completedResponse = await response.PollUntilCompletedAsync();
// Retrieve the operation result
SuggestTrialsResponse result = completedResponse.Result;

// Or get the name of the operation
string operationName = response.Name;
// This name can be stored, then the long-running operation retrieved later by name
Operation<SuggestTrialsResponse, SuggestTrialsMetadata> retrievedResponse = await vizierServiceClient.PollOnceSuggestTrialsAsync(operationName);
// Check if the retrieved long-running operation has completed
if (retrievedResponse.IsCompleted)
{
    // If it has completed, then access the result
    SuggestTrialsResponse retrievedResult = retrievedResponse.Result;
}

SuggestTrialsAsync(SuggestTrialsRequest, CancellationToken)

public virtual Task<Operation<SuggestTrialsResponse, SuggestTrialsMetadata>> SuggestTrialsAsync(SuggestTrialsRequest request, CancellationToken cancellationToken)

Adds one or more Trials to a Study, with parameter values suggested by Vertex AI Vizier. Returns a long-running operation associated with the generation of Trial suggestions. When this long-running operation succeeds, it will contain a [SuggestTrialsResponse][google.cloud.aiplatform.v1.SuggestTrialsResponse].

Parameters
NameDescription
requestSuggestTrialsRequest

The request object containing all of the parameters for the API call.

cancellationTokenCancellationToken

A CancellationToken to use for this RPC.

Returns
TypeDescription
TaskOperationSuggestTrialsResponseSuggestTrialsMetadata

A Task containing the RPC response.

Example
// Create client
VizierServiceClient vizierServiceClient = await VizierServiceClient.CreateAsync();
// Initialize request argument(s)
SuggestTrialsRequest request = new SuggestTrialsRequest
{
    ParentAsStudyName = StudyName.FromProjectLocationStudy("[PROJECT]", "[LOCATION]", "[STUDY]"),
    SuggestionCount = 0,
    ClientId = "",
    Contexts = { new TrialContext(), },
};
// Make the request
Operation<SuggestTrialsResponse, SuggestTrialsMetadata> response = await vizierServiceClient.SuggestTrialsAsync(request);

// Poll until the returned long-running operation is complete
Operation<SuggestTrialsResponse, SuggestTrialsMetadata> completedResponse = await response.PollUntilCompletedAsync();
// Retrieve the operation result
SuggestTrialsResponse result = completedResponse.Result;

// Or get the name of the operation
string operationName = response.Name;
// This name can be stored, then the long-running operation retrieved later by name
Operation<SuggestTrialsResponse, SuggestTrialsMetadata> retrievedResponse = await vizierServiceClient.PollOnceSuggestTrialsAsync(operationName);
// Check if the retrieved long-running operation has completed
if (retrievedResponse.IsCompleted)
{
    // If it has completed, then access the result
    SuggestTrialsResponse retrievedResult = retrievedResponse.Result;
}