Resource Settings v1 API - Class ResourceSettingsService.ResourceSettingsServiceClient (2.1.0)

public class ResourceSettingsServiceClient : ClientBase<ResourceSettingsService.ResourceSettingsServiceClient>

Reference documentation and code samples for the Resource Settings v1 API class ResourceSettingsService.ResourceSettingsServiceClient.

Client for ResourceSettingsService

Inheritance

Object > ClientBase > ClientBase<ResourceSettingsService.ResourceSettingsServiceClient> > ResourceSettingsService.ResourceSettingsServiceClient

Namespace

Google.Cloud.ResourceSettings.V1

Assembly

Google.Cloud.ResourceSettings.V1.dll

Constructors

ResourceSettingsServiceClient()

protected ResourceSettingsServiceClient()

Protected parameterless constructor to allow creation of test doubles.

ResourceSettingsServiceClient(CallInvoker)

public ResourceSettingsServiceClient(CallInvoker callInvoker)

Creates a new client for ResourceSettingsService that uses a custom CallInvoker.

Parameter
NameDescription
callInvokerCallInvoker

The callInvoker to use to make remote calls.

ResourceSettingsServiceClient(ChannelBase)

public ResourceSettingsServiceClient(ChannelBase channel)

Creates a new client for ResourceSettingsService

Parameter
NameDescription
channelChannelBase

The channel to use to make remote calls.

ResourceSettingsServiceClient(ClientBase.ClientBaseConfiguration)

protected ResourceSettingsServiceClient(ClientBase.ClientBaseConfiguration configuration)

Protected constructor to allow creation of configured clients.

Parameter
NameDescription
configurationClientBase.ClientBaseConfiguration

The client configuration.

Methods

GetSetting(GetSettingRequest, CallOptions)

public virtual Setting GetSetting(GetSettingRequest request, CallOptions options)

Gets a setting.

Returns a google.rpc.Status with google.rpc.Code.NOT_FOUND if the setting does not exist.

Parameters
NameDescription
requestGetSettingRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
Setting

The response received from the server.

GetSetting(GetSettingRequest, Metadata, Nullable<DateTime>, CancellationToken)

public virtual Setting GetSetting(GetSettingRequest request, Metadata headers = null, DateTime? deadline = null, CancellationToken cancellationToken = default(CancellationToken))

Gets a setting.

Returns a google.rpc.Status with google.rpc.Code.NOT_FOUND if the setting does not exist.

Parameters
NameDescription
requestGetSettingRequest

The request to send to the server.

headersMetadata

The initial metadata to send with the call. This parameter is optional.

deadlineNullable<DateTime>

An optional deadline for the call. The call will be cancelled if deadline is hit.

cancellationTokenCancellationToken

An optional token for canceling the call.

Returns
TypeDescription
Setting

The response received from the server.

GetSettingAsync(GetSettingRequest, CallOptions)

public virtual AsyncUnaryCall<Setting> GetSettingAsync(GetSettingRequest request, CallOptions options)

Gets a setting.

Returns a google.rpc.Status with google.rpc.Code.NOT_FOUND if the setting does not exist.

Parameters
NameDescription
requestGetSettingRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
AsyncUnaryCall<Setting>

The call object.

GetSettingAsync(GetSettingRequest, Metadata, Nullable<DateTime>, CancellationToken)

public virtual AsyncUnaryCall<Setting> GetSettingAsync(GetSettingRequest request, Metadata headers = null, DateTime? deadline = null, CancellationToken cancellationToken = default(CancellationToken))

Gets a setting.

Returns a google.rpc.Status with google.rpc.Code.NOT_FOUND if the setting does not exist.

Parameters
NameDescription
requestGetSettingRequest

The request to send to the server.

headersMetadata

The initial metadata to send with the call. This parameter is optional.

deadlineNullable<DateTime>

An optional deadline for the call. The call will be cancelled if deadline is hit.

cancellationTokenCancellationToken

An optional token for canceling the call.

Returns
TypeDescription
AsyncUnaryCall<Setting>

The call object.

ListSettings(ListSettingsRequest, CallOptions)

public virtual ListSettingsResponse ListSettings(ListSettingsRequest request, CallOptions options)

Lists all the settings that are available on the Cloud resource parent.

Parameters
NameDescription
requestListSettingsRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
ListSettingsResponse

The response received from the server.

ListSettings(ListSettingsRequest, Metadata, Nullable<DateTime>, CancellationToken)

public virtual ListSettingsResponse ListSettings(ListSettingsRequest request, Metadata headers = null, DateTime? deadline = null, CancellationToken cancellationToken = default(CancellationToken))

Lists all the settings that are available on the Cloud resource parent.

Parameters
NameDescription
requestListSettingsRequest

The request to send to the server.

headersMetadata

The initial metadata to send with the call. This parameter is optional.

deadlineNullable<DateTime>

An optional deadline for the call. The call will be cancelled if deadline is hit.

cancellationTokenCancellationToken

An optional token for canceling the call.

Returns
TypeDescription
ListSettingsResponse

The response received from the server.

ListSettingsAsync(ListSettingsRequest, CallOptions)

public virtual AsyncUnaryCall<ListSettingsResponse> ListSettingsAsync(ListSettingsRequest request, CallOptions options)

Lists all the settings that are available on the Cloud resource parent.

Parameters
NameDescription
requestListSettingsRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
AsyncUnaryCall<ListSettingsResponse>

The call object.

ListSettingsAsync(ListSettingsRequest, Metadata, Nullable<DateTime>, CancellationToken)

public virtual AsyncUnaryCall<ListSettingsResponse> ListSettingsAsync(ListSettingsRequest request, Metadata headers = null, DateTime? deadline = null, CancellationToken cancellationToken = default(CancellationToken))

Lists all the settings that are available on the Cloud resource parent.

Parameters
NameDescription
requestListSettingsRequest

The request to send to the server.

headersMetadata

The initial metadata to send with the call. This parameter is optional.

deadlineNullable<DateTime>

An optional deadline for the call. The call will be cancelled if deadline is hit.

cancellationTokenCancellationToken

An optional token for canceling the call.

Returns
TypeDescription
AsyncUnaryCall<ListSettingsResponse>

The call object.

NewInstance(ClientBase.ClientBaseConfiguration)

protected override ResourceSettingsService.ResourceSettingsServiceClient NewInstance(ClientBase.ClientBaseConfiguration configuration)

Creates a new instance of client from given ClientBaseConfiguration.

Parameter
NameDescription
configurationClientBase.ClientBaseConfiguration
Returns
TypeDescription
ResourceSettingsService.ResourceSettingsServiceClient
Overrides
Grpc.Core.ClientBase<Google.Cloud.ResourceSettings.V1.ResourceSettingsService.ResourceSettingsServiceClient>.NewInstance(Grpc.Core.ClientBase.ClientBaseConfiguration)

UpdateSetting(UpdateSettingRequest, CallOptions)

public virtual Setting UpdateSetting(UpdateSettingRequest request, CallOptions options)

Updates a setting.

Returns a google.rpc.Status with google.rpc.Code.NOT_FOUND if the setting does not exist. Returns a google.rpc.Status with google.rpc.Code.FAILED_PRECONDITION if the setting is flagged as read only. Returns a google.rpc.Status with google.rpc.Code.ABORTED if the etag supplied in the request does not match the persisted etag of the setting value.

On success, the response will contain only name, local_value and etag. The metadata and effective_value cannot be updated through this API.

Note: the supplied setting will perform a full overwrite of the local_value field.

Parameters
NameDescription
requestUpdateSettingRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
Setting

The response received from the server.

UpdateSetting(UpdateSettingRequest, Metadata, Nullable<DateTime>, CancellationToken)

public virtual Setting UpdateSetting(UpdateSettingRequest request, Metadata headers = null, DateTime? deadline = null, CancellationToken cancellationToken = default(CancellationToken))

Updates a setting.

Returns a google.rpc.Status with google.rpc.Code.NOT_FOUND if the setting does not exist. Returns a google.rpc.Status with google.rpc.Code.FAILED_PRECONDITION if the setting is flagged as read only. Returns a google.rpc.Status with google.rpc.Code.ABORTED if the etag supplied in the request does not match the persisted etag of the setting value.

On success, the response will contain only name, local_value and etag. The metadata and effective_value cannot be updated through this API.

Note: the supplied setting will perform a full overwrite of the local_value field.

Parameters
NameDescription
requestUpdateSettingRequest

The request to send to the server.

headersMetadata

The initial metadata to send with the call. This parameter is optional.

deadlineNullable<DateTime>

An optional deadline for the call. The call will be cancelled if deadline is hit.

cancellationTokenCancellationToken

An optional token for canceling the call.

Returns
TypeDescription
Setting

The response received from the server.

UpdateSettingAsync(UpdateSettingRequest, CallOptions)

public virtual AsyncUnaryCall<Setting> UpdateSettingAsync(UpdateSettingRequest request, CallOptions options)

Updates a setting.

Returns a google.rpc.Status with google.rpc.Code.NOT_FOUND if the setting does not exist. Returns a google.rpc.Status with google.rpc.Code.FAILED_PRECONDITION if the setting is flagged as read only. Returns a google.rpc.Status with google.rpc.Code.ABORTED if the etag supplied in the request does not match the persisted etag of the setting value.

On success, the response will contain only name, local_value and etag. The metadata and effective_value cannot be updated through this API.

Note: the supplied setting will perform a full overwrite of the local_value field.

Parameters
NameDescription
requestUpdateSettingRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
AsyncUnaryCall<Setting>

The call object.

UpdateSettingAsync(UpdateSettingRequest, Metadata, Nullable<DateTime>, CancellationToken)

public virtual AsyncUnaryCall<Setting> UpdateSettingAsync(UpdateSettingRequest request, Metadata headers = null, DateTime? deadline = null, CancellationToken cancellationToken = default(CancellationToken))

Updates a setting.

Returns a google.rpc.Status with google.rpc.Code.NOT_FOUND if the setting does not exist. Returns a google.rpc.Status with google.rpc.Code.FAILED_PRECONDITION if the setting is flagged as read only. Returns a google.rpc.Status with google.rpc.Code.ABORTED if the etag supplied in the request does not match the persisted etag of the setting value.

On success, the response will contain only name, local_value and etag. The metadata and effective_value cannot be updated through this API.

Note: the supplied setting will perform a full overwrite of the local_value field.

Parameters
NameDescription
requestUpdateSettingRequest

The request to send to the server.

headersMetadata

The initial metadata to send with the call. This parameter is optional.

deadlineNullable<DateTime>

An optional deadline for the call. The call will be cancelled if deadline is hit.

cancellationTokenCancellationToken

An optional token for canceling the call.

Returns
TypeDescription
AsyncUnaryCall<Setting>

The call object.