Create a keyspace (HTTP)
|
For details about additional languages, see: |
Creates a new keyspace in a database.
Keyspaces are used to store collections and tables in Astra DB Serverless.
|
You need an application token with permission to interact with the target database, such as the Database Administrator role. For more information, see Get endpoint and token. |
Result
Creates the specified keyspace.
Returns 201 Created.
Parameters
Use the DevOps API to create a keyspace, as demonstrated in Examples. This operation is a POST request that includes the new keyspace name as a path parameter.
Keyspace names must follow these rules:
-
Must start with a letter or number
-
Can contain letters, numbers, and underscores
-
Cannot exceed 48 characters.
-
Cannot be the reserved words
dseorsystem -
Must be unique within the database
Examples
The following examples demonstrate how to create a keyspace.
Create a keyspace
curl -sS -L -X POST "https://api.astra.datastax.com/v2/databases/DATABASE_ID/keyspaces/KEYSPACE_NAME" \
--header "Authorization: Bearer APPLICATION_TOKEN" \
--header "Content-Type: application/json"Create a keyspace and set it as the working keyspace for the database
This option only applies to the clients.
