Some or all of the information on this page might not apply to Cloud de Confiance by S3NS. See Differences from Google Cloud for more details.

API Keys v2 API - Class ApiKeys.ApiKeysBase (1.0.0)

[BindServiceMethod(typeof(ApiKeys), "BindService")]
public abstract class ApiKeysBase

Reference documentation and code samples for the API Keys v2 API class ApiKeys.ApiKeysBase.

Base class for server-side implementations of ApiKeys

Inheritance

Object > ApiKeys.ApiKeysBase

Inherited Members

Object.GetHashCode()

Object.GetType()

Object.MemberwiseClone()

Object.ToString()

Namespace

Google.Cloud.ApiKeys.V2

Assembly

Google.Cloud.ApiKeys.V2.dll

Methods

CreateKey(CreateKeyRequest, ServerCallContext)

public virtual Task<Operation> CreateKey(CreateKeyRequest request, ServerCallContext context)

Creates a new API key.

NOTE: Key is a global resource; hence the only supported value for location is global.

Parameters
Name	Description
`request`	`CreateKeyRequest` The request received from the client.
`context`	`ServerCallContext` The context of the server-side call handler being invoked.

Returns
Type	Description
`Task<Operation>`	The response to send back to the client (wrapped by a task).

DeleteKey(DeleteKeyRequest, ServerCallContext)

public virtual Task<Operation> DeleteKey(DeleteKeyRequest request, ServerCallContext context)

Deletes an API key. Deleted key can be retrieved within 30 days of deletion. Afterward, key will be purged from the project.

NOTE: Key is a global resource; hence the only supported value for location is global.

Parameters
Name	Description
`request`	`DeleteKeyRequest` The request received from the client.
`context`	`ServerCallContext` The context of the server-side call handler being invoked.

Returns
Type	Description
`Task<Operation>`	The response to send back to the client (wrapped by a task).

GetKey(GetKeyRequest, ServerCallContext)

public virtual Task<Key> GetKey(GetKeyRequest request, ServerCallContext context)

Gets the metadata for an API key. The key string of the API key isn't included in the response.

NOTE: Key is a global resource; hence the only supported value for location is global.

Parameters
Name	Description
`request`	`GetKeyRequest` The request received from the client.
`context`	`ServerCallContext` The context of the server-side call handler being invoked.

Returns
Type	Description
`Task<Key>`	The response to send back to the client (wrapped by a task).

GetKeyString(GetKeyStringRequest, ServerCallContext)

public virtual Task<GetKeyStringResponse> GetKeyString(GetKeyStringRequest request, ServerCallContext context)

Get the key string for an API key.

NOTE: Key is a global resource; hence the only supported value for location is global.

Parameters
Name	Description
`request`	`GetKeyStringRequest` The request received from the client.
`context`	`ServerCallContext` The context of the server-side call handler being invoked.

Returns
Type	Description
`Task<GetKeyStringResponse>`	The response to send back to the client (wrapped by a task).

ListKeys(ListKeysRequest, ServerCallContext)

public virtual Task<ListKeysResponse> ListKeys(ListKeysRequest request, ServerCallContext context)

Lists the API keys owned by a project. The key string of the API key isn't included in the response.

NOTE: Key is a global resource; hence the only supported value for location is global.

Parameters
Name	Description
`request`	`ListKeysRequest` The request received from the client.
`context`	`ServerCallContext` The context of the server-side call handler being invoked.

Returns
Type	Description
`Task<ListKeysResponse>`	The response to send back to the client (wrapped by a task).

LookupKey(LookupKeyRequest, ServerCallContext)

public virtual Task<LookupKeyResponse> LookupKey(LookupKeyRequest request, ServerCallContext context)

Find the parent project and resource name of the API key that matches the key string in the request. If the API key has been purged, resource name will not be set. The service account must have the apikeys.keys.lookup permission on the parent project.

Parameters
Name	Description
`request`	`LookupKeyRequest` The request received from the client.
`context`	`ServerCallContext` The context of the server-side call handler being invoked.

Returns
Type	Description
`Task<LookupKeyResponse>`	The response to send back to the client (wrapped by a task).

UndeleteKey(UndeleteKeyRequest, ServerCallContext)

public virtual Task<Operation> UndeleteKey(UndeleteKeyRequest request, ServerCallContext context)

Undeletes an API key which was deleted within 30 days.

NOTE: Key is a global resource; hence the only supported value for location is global.

Parameters
Name	Description
`request`	`UndeleteKeyRequest` The request received from the client.
`context`	`ServerCallContext` The context of the server-side call handler being invoked.

Returns
Type	Description
`Task<Operation>`	The response to send back to the client (wrapped by a task).

UpdateKey(UpdateKeyRequest, ServerCallContext)

public virtual Task<Operation> UpdateKey(UpdateKeyRequest request, ServerCallContext context)

Patches the modifiable fields of an API key. The key string of the API key isn't included in the response.

NOTE: Key is a global resource; hence the only supported value for location is global.

Parameters
Name	Description
`request`	`UpdateKeyRequest` The request received from the client.
`context`	`ServerCallContext` The context of the server-side call handler being invoked.

Returns
Type	Description
`Task<Operation>`	The response to send back to the client (wrapped by a task).