Class InstancesClientImpl (1.0.0)

public sealed class InstancesClientImpl : InstancesClient

Instances client wrapper implementation, for convenient use.

Inheritance

Object > InstancesClient > InstancesClientImpl

Namespace

Google.Cloud.AppEngine.V1

Assembly

Google.Cloud.AppEngine.V1.dll

Remarks

Manages instances of a version.

Constructors

InstancesClientImpl(Instances.InstancesClient, InstancesSettings)

public InstancesClientImpl(Instances.InstancesClient grpcClient, InstancesSettings settings)

Constructs a client wrapper for the Instances service, with the specified gRPC client and settings.

Parameters
NameDescription
grpcClientInstances.InstancesClient

The underlying gRPC client.

settingsInstancesSettings

The base InstancesSettings used within this client.

Properties

DebugInstanceOperationsClient

public override OperationsClient DebugInstanceOperationsClient { get; }

The long-running operations client for DebugInstance.

Property Value
TypeDescription
Google.LongRunning.OperationsClient
Overrides

DeleteInstanceOperationsClient

public override OperationsClient DeleteInstanceOperationsClient { get; }

The long-running operations client for DeleteInstance.

Property Value
TypeDescription
Google.LongRunning.OperationsClient
Overrides

GrpcClient

public override Instances.InstancesClient GrpcClient { get; }

The underlying gRPC Instances client

Property Value
TypeDescription
Instances.InstancesClient
Overrides

Methods

DebugInstance(DebugInstanceRequest, CallSettings)

public override Operation<Instance, OperationMetadataV1> DebugInstance(DebugInstanceRequest request, CallSettings callSettings = null)

Enables debugging on a VM instance. This allows you to use the SSH command to connect to the virtual machine where the instance lives. While in "debug mode", the instance continues to serve live traffic. You should delete the instance when you are done debugging and then allow the system to take over and determine if another instance should be started.

Only applicable for instances in App Engine flexible environment.

Parameters
NameDescription
requestDebugInstanceRequest

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

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
Google.LongRunning.Operation<Instance, OperationMetadataV1>

The RPC response.

Overrides

DebugInstanceAsync(DebugInstanceRequest, CallSettings)

public override Task<Operation<Instance, OperationMetadataV1>> DebugInstanceAsync(DebugInstanceRequest request, CallSettings callSettings = null)

Enables debugging on a VM instance. This allows you to use the SSH command to connect to the virtual machine where the instance lives. While in "debug mode", the instance continues to serve live traffic. You should delete the instance when you are done debugging and then allow the system to take over and determine if another instance should be started.

Only applicable for instances in App Engine flexible environment.

Parameters
NameDescription
requestDebugInstanceRequest

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<Google.LongRunning.Operation<Instance, OperationMetadataV1>>

A Task containing the RPC response.

Overrides

DeleteInstance(DeleteInstanceRequest, CallSettings)

public override Operation<Empty, OperationMetadataV1> DeleteInstance(DeleteInstanceRequest request, CallSettings callSettings = null)

Stops a running instance.

The instance might be automatically recreated based on the scaling settings of the version. For more information, see "How Instances are Managed" (standard environment | flexible environment).

To ensure that instances are not re-created and avoid getting billed, you can stop all instances within the target version by changing the serving status of the version to STOPPED with the apps.services.versions.patch method.

Parameters
NameDescription
requestDeleteInstanceRequest

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

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
Google.LongRunning.Operation<Google.Protobuf.WellKnownTypes.Empty, OperationMetadataV1>

The RPC response.

Overrides

DeleteInstanceAsync(DeleteInstanceRequest, CallSettings)

public override Task<Operation<Empty, OperationMetadataV1>> DeleteInstanceAsync(DeleteInstanceRequest request, CallSettings callSettings = null)

Stops a running instance.

The instance might be automatically recreated based on the scaling settings of the version. For more information, see "How Instances are Managed" (standard environment | flexible environment).

To ensure that instances are not re-created and avoid getting billed, you can stop all instances within the target version by changing the serving status of the version to STOPPED with the apps.services.versions.patch method.

Parameters
NameDescription
requestDeleteInstanceRequest

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<Google.LongRunning.Operation<Google.Protobuf.WellKnownTypes.Empty, OperationMetadataV1>>

A Task containing the RPC response.

Overrides

GetInstance(GetInstanceRequest, CallSettings)

public override Instance GetInstance(GetInstanceRequest request, CallSettings callSettings = null)

Gets instance information.

Parameters
NameDescription
requestGetInstanceRequest

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

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
Instance

The RPC response.

Overrides

GetInstanceAsync(GetInstanceRequest, CallSettings)

public override Task<Instance> GetInstanceAsync(GetInstanceRequest request, CallSettings callSettings = null)

Gets instance information.

Parameters
NameDescription
requestGetInstanceRequest

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<Instance>

A Task containing the RPC response.

Overrides

ListInstances(ListInstancesRequest, CallSettings)

public override PagedEnumerable<ListInstancesResponse, Instance> ListInstances(ListInstancesRequest request, CallSettings callSettings = null)

Lists the instances of a version.

Tip: To aggregate details about instances over time, see the Stackdriver Monitoring API.

Parameters
NameDescription
requestListInstancesRequest

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

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
PagedEnumerable<ListInstancesResponse, Instance>

A pageable sequence of Instance resources.

Overrides

ListInstancesAsync(ListInstancesRequest, CallSettings)

public override PagedAsyncEnumerable<ListInstancesResponse, Instance> ListInstancesAsync(ListInstancesRequest request, CallSettings callSettings = null)

Lists the instances of a version.

Tip: To aggregate details about instances over time, see the Stackdriver Monitoring API.

Parameters
NameDescription
requestListInstancesRequest

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

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
PagedAsyncEnumerable<ListInstancesResponse, Instance>

A pageable asynchronous sequence of Instance resources.

Overrides