POST
/
v1
/
projects
/
{project}
/
databaseGroups
{
  "name": "<string>",
  "title": "<string>",
  "databaseExpr": {
    "id": "<string>",
    "constExpr": {
      "nullValue": "NULL_VALUE",
      "boolValue": true,
      "int64Value": "<string>",
      "uint64Value": "<string>",
      "doubleValue": 123,
      "stringValue": "<string>",
      "bytesValue": "<string>",
      "durationValue": "<string>",
      "timestampValue": "2023-11-07T05:31:56Z"
    },
    "identExpr": {
      "name": "<string>"
    },
    "selectExpr": {
      "operand": {},
      "field": "<string>",
      "testOnly": true
    },
    "callExpr": {
      "target": {},
      "function": "<string>",
      "args": [
        {}
      ]
    },
    "listExpr": {
      "elements": [
        {}
      ],
      "optionalIndices": [
        123
      ]
    },
    "structExpr": {
      "messageName": "<string>",
      "entries": [
        {
          "id": "<string>",
          "fieldKey": "<string>",
          "mapKey": {},
          "value": {},
          "optionalEntry": true
        }
      ]
    },
    "comprehensionExpr": {
      "iterVar": "<string>",
      "iterVar2": "<string>",
      "iterRange": {},
      "accuVar": "<string>",
      "accuInit": {},
      "loopCondition": {},
      "loopStep": {},
      "result": {}
    }
  },
  "matchedDatabases": [
    {
      "name": "<string>"
    }
  ]
}

Path Parameters

​
project
string
required

The project id.

Query Parameters

​
databaseGroupId
string

The ID to use for the database group, which will become the final component of the database group's resource name.

This value should be 4-63 characters, and valid characters are /[a-z][0-9]-/.

​
validateOnly
boolean

If set, validate the create request and preview the full database group response, but do not actually create it.

Body

application/json
​
name
string

The name of the database group. Format: projects/{project}/databaseGroups/{databaseGroup}

​
title
string

The short name used in actual databases specified by users.

​
databaseExpr
object

The condition that is associated with this database group. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec

Support variables: resource.environment_name: the environment resource id. Support "==", "!=", "in [XX]", "!(in [xx])" operations. resource.instance_id: the instance resource id. Support "==", "!=", "in [XX]", "!(in [xx])", "contains", "matches", "startsWith", "endsWith" operations. resource.database_name: the database name. Support "==", "!=", "in [XX]", "!(in [xx])", "contains", "matches", "startsWith", "endsWith" operations. All variables should join with "&&" condition.

For example: resource.environment_name == "test" && resource.database_name.startsWith("sample_") An abstract representation of a common expression.

Expressions are abstractly represented as a collection of identifiers, select statements, function calls, literals, and comprehensions. All operators with the exception of the '.' operator are modelled as function calls. This makes it easy to represent new operators into the existing AST.

All references within expressions must resolve to a [Decl][google.api.expr.v1alpha1.Decl] provided at type-check for an expression to be valid. A reference may either be a bare identifier name or a qualified identifier google.api.name. References may either refer to a value or a function declaration.

For example, the expression google.api.name.startsWith('expr') references the declaration google.api.name within a [Expr.Select][google.api.expr.v1alpha1.Expr.Select] expression, and the function declaration startsWith.

Response

OK

​
name
string

The name of the database group. Format: projects/{project}/databaseGroups/{databaseGroup}

​
title
string

The short name used in actual databases specified by users.

​
databaseExpr
object

The condition that is associated with this database group. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec

Support variables: resource.environment_name: the environment resource id. Support "==", "!=", "in [XX]", "!(in [xx])" operations. resource.instance_id: the instance resource id. Support "==", "!=", "in [XX]", "!(in [xx])", "contains", "matches", "startsWith", "endsWith" operations. resource.database_name: the database name. Support "==", "!=", "in [XX]", "!(in [xx])", "contains", "matches", "startsWith", "endsWith" operations. All variables should join with "&&" condition.

For example: resource.environment_name == "test" && resource.database_name.startsWith("sample_") An abstract representation of a common expression.

Expressions are abstractly represented as a collection of identifiers, select statements, function calls, literals, and comprehensions. All operators with the exception of the '.' operator are modelled as function calls. This makes it easy to represent new operators into the existing AST.

All references within expressions must resolve to a [Decl][google.api.expr.v1alpha1.Decl] provided at type-check for an expression to be valid. A reference may either be a bare identifier name or a qualified identifier google.api.name. References may either refer to a value or a function declaration.

For example, the expression google.api.name.startsWith('expr') references the declaration google.api.name within a [Expr.Select][google.api.expr.v1alpha1.Expr.Select] expression, and the function declaration startsWith.

​
matchedDatabases
object[]

The list of databases that match the database group condition.