AlloyDB Admin Source

The “alloydb-admin” source provides a client for the AlloyDB API.

About

The alloydb-admin source provides a client to interact with the Google AlloyDB API. This allows tools to perform administrative tasks on AlloyDB resources, such as managing clusters, instances, and users.

Authentication can be handled in two ways:

  1. Application Default Credentials (ADC): By default, the source uses ADC to authenticate with the API.
  2. Client-side OAuth: If useClientOAuth is set to true, the source will expect an OAuth 2.0 access token to be provided by the client (e.g., a web browser) for each request.

Available Tools

AlloyDB Admin Source Tools

Tool NameDescription
alloydb-create-cluster ToolThe "alloydb-create-cluster" tool creates a new AlloyDB for PostgreSQL cluster in a specified project and location.
alloydb-create-instance ToolThe "alloydb-create-instance" tool creates a new AlloyDB instance within a specified cluster.
alloydb-get-cluster ToolThe "alloydb-get-cluster" tool retrieves details for a specific AlloyDB cluster.
alloydb-get-instance ToolThe "alloydb-get-instance" tool retrieves details for a specific AlloyDB instance.
alloydb-get-user ToolThe "alloydb-get-user" tool retrieves details for a specific AlloyDB user.
alloydb-list-clusters ToolThe "alloydb-list-clusters" tool lists the AlloyDB clusters in a given project and location.
alloydb-list-instances ToolThe "alloydb-list-instances" tool lists the AlloyDB instances for a given project, cluster and location.
alloydb-list-users ToolThe "alloydb-list-users" tool lists all database users within an AlloyDB cluster.
alloydb-create-user ToolThe "alloydb-create-user" tool creates a new database user within a specified AlloyDB cluster.
alloydb-wait-for-operation ToolWait for a long-running AlloyDB operation to complete.

Example

kind: sources
name: my-alloydb-admin
type: alloydb-admin
---
kind: sources
name: my-oauth-alloydb-admin
type: alloydb-admin
useClientOAuth: true

Reference

fieldtyperequireddescription
typestringtrueMust be “alloydb-admin”.
defaultProjectstringfalseThe Google Cloud project ID to use for AlloyDB infrastructure tools.
useClientOAuthbooleanfalseIf true, the source will use client-side OAuth for authorization. Otherwise, it will use Application Default Credentials. Defaults to false.