{ "opencollection": "1.0.0", "info": { "name": "Astra DevOps Access List Database Operations API", "version": "2.3.0" }, "request": { "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "items": [ { "info": { "name": "Database Operations", "type": "folder" }, "items": [ { "info": { "name": "Returns a list of databases", "type": "http" }, "http": { "method": "GET", "url": "https://api.astra.datastax.com/v2/databases", "params": [ { "name": "include", "value": "", "type": "query", "description": "Allows filtering so that databases in listed states are returned" }, { "name": "provider", "value": "", "type": "query", "description": "Allows filtering so that databases from a given provider are returned" }, { "name": "starting_after", "value": "", "type": "query", "description": "Optional parameter for pagination purposes. Used as this value for starting retrieving a specific page of results" }, { "name": "limit", "value": "", "type": "query", "description": "Optional parameter for pagination purposes. Specify the number of items for one page of data" } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Get a list of databases visible to the user" }, { "info": { "name": "Create a new database", "type": "http" }, "http": { "method": "POST", "url": "https://api.astra.datastax.com/v2/databases", "body": { "type": "json", "data": "{}" }, "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Takes a user provided databaseInfo and returns the uuid for a new database" }, { "info": { "name": "Finds database by ID", "type": "http" }, "http": { "method": "GET", "url": "https://api.astra.datastax.com/v2/databases/:databaseID", "params": [ { "name": "databaseID", "value": "", "type": "path", "description": "String representation of the database ID" } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Returns specified database" }, { "info": { "name": "Adds keyspace into database", "type": "http" }, "http": { "method": "POST", "url": "https://api.astra.datastax.com/v2/databases/:databaseID/keyspaces/:keyspaceName", "params": [ { "name": "databaseID", "value": "", "type": "path", "description": "String representation of the database ID" }, { "name": "keyspaceName", "value": "", "type": "path", "description": "Name of database keyspace" } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Adds the specified keyspace to the database" }, { "info": { "name": "Removes keyspace", "type": "http" }, "http": { "method": "DELETE", "url": "https://api.astra.datastax.com/v2/databases/:databaseID/keyspaces/:keyspaceName", "params": [ { "name": "databaseID", "value": "", "type": "path", "description": "String representation of the database ID" }, { "name": "keyspaceName", "value": "", "type": "path", "description": "Name of database keyspace" } ] }, "docs": "Removes the specified keyspace from the database" }, { "info": { "name": "Alter keyspace to enable graph engine", "type": "http" }, "http": { "method": "POST", "url": "https://api.astra.datastax.com/v2/databases/:databaseID/keyspaces/:keyspaceName/actions/alterWithGraphEngine", "params": [ { "name": "databaseID", "value": "", "type": "path", "description": "String representation of the database ID" }, { "name": "keyspaceName", "value": "", "type": "path", "description": "Name of database keyspace" } ] }, "docs": "Alter the specified keyspace to enable graph engine capabilities. Only supports Managed Cluster (Classic) databases." }, { "info": { "name": "Obtain zip for connecting to the database", "type": "http" }, "http": { "method": "POST", "url": "https://api.astra.datastax.com/v2/databases/:databaseID/secureBundleURL", "params": [ { "name": "databaseID", "value": "", "type": "path", "description": "String representation of the database ID" }, { "name": "all", "value": "", "type": "query", "description": "Optional parameter to obtain secure-connect-*.zip for one (false) or many (true) datacenters. If false, `200` returns `CredsURL` (download URLs for one datacenter). If true, `200` returns `CredsURLList` (download URLs for multiple datacenters)." } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Returns a temporary URL to download a zip file with certificates for connecting to the database. The URL expires after five minutes.
There are two types of the secure bundle URL: