fabiog1901.cockroachdb.cc_database module – Manage databases for a cluster.

Note

This module is part of the fabiog1901.cockroachdb collection (version 1.0.0).

To install it, use: ansible-galaxy collection install fabiog1901.cockroachdb. You need further requirements to be able to use this module, see Requirements for details.

To use it in a playbook, specify: fabiog1901.cockroachdb.cc_database.

New in fabiog1901.cockroachdb 1.0.0

Synopsis

  • Create, edit, delete a database.

  • A Cockroach Cloud Service Account API Key is required.

  • Export the key as environment variable ‘CC_KEY’ or pass it on module invokation

Requirements

The below requirements are needed on the host that executes this module.

  • cockroachdb-cloud-client

Parameters

Parameter

Comments

api_client

string

Define details for the API client

api_version

string

The API version to use

Default: "latest"

cc_key

string

The Service Account API key

This value is log redacted

By default it reads the env variable ‘CC_KEY’

host

string

the hostname of the API server

Default: "cockroachlabs.cloud"

path

string

the path to the API endpoint

Default: ""

port

string

the port number, as a string, for the API server

Default: "443"

scheme

string

http or https

Choices:

  • "http"

  • "https" ← (default)

verify_ssl

boolean

whether the client should verify the server cert

Choices:

  • false

  • true ← (default)

cluster_id

string / required

The UUID or the name of the cluster you want to get information for.

name

string / required

The database name

rename_to

string

The new database name

state

string

Allowed values: present, absent.

Default: "present"

Examples

- name: create a database
  fabiog1901.cockroachdb.cc_database:
    state: present
    cluster_id: dev_cluster
    name: dev_db
    api_client:
      api_version: '2022-09-20'
    register: out

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key

Description

database

dictionary

Returned: success

name

string

Returned: success

table_count

string

Returned: success

Authors

  • Cockroach Labs