From 7887f0ab9d887b16b9153c791a7858161aa69930 Mon Sep 17 00:00:00 2001 From: Annabelle PELLIER Date: Mon, 12 Jan 2026 10:04:39 +0100 Subject: [PATCH 01/11] add db endpoints --- _scalingo_api/databases_ng.md | 169 ++++++++++++++++++++++++++++++++++ 1 file changed, 169 insertions(+) create mode 100644 _scalingo_api/databases_ng.md diff --git a/_scalingo_api/databases_ng.md b/_scalingo_api/databases_ng.md new file mode 100644 index 0000000..5522c1e --- /dev/null +++ b/_scalingo_api/databases_ng.md @@ -0,0 +1,169 @@ +--- +title: Databases NG +layout: default +--- + +# Databases NG + +--- row --- + +**Database attributes** + +{:.table} +| field | type | description | +| ----------- | ------ | ----------------------------------------------------- | +| id | string | unique ID | +| name | string | name of the database | +| project_id | string | ID of the project the database belongs to | +| technology | string | database technology (e.g., postgresql, mysql, mongodb)| +| plan | string | plan name (e.g., postgresql-starter-512, mysql-business-1024) | + +||| col ||| + +Example object: + +```json +{ + "id": "54100930736f7563d5030000", + "name": "my-postgres-db", + "project_id": "pr-82a3cac5-9b25-473e-b33d-6272b87e636f", + "technology": "postgresql", + "plan": "postgresql-starter-512" +} +``` + +--- row --- + +## Create a Database + +--- row --- + +`POST https://$SCALINGO_API_URL/v1/databases` + +### Parameters + +* `database.name`: Database name. Should have between 6 and 48 lower case alphanumerical characters + and hyphens, it can't have an hyphen at the beginning or at the end, nor two + hyphens in a row. +* `database.technology`: Database technology identifier (e.g., `postgresql`, `mysql`, `mongodb`, `redis`, `elasticsearch`, `influxdb`) +* `database.plan_id`: Plan identifier (e.g., `postgresql-starter-512`, `mysql-business-1024`) +* `database.project_id`: (*Optional*) ID of the project to assign the database to. If not provided, the database will be assigned to your default project. + +||| col ||| + +Example + +```sh +curl -H "Accept: application/json" -H "Content-Type: application/json" \ + -H "Authorization: Bearer $BEARER_TOKEN" \ + -X POST https://$SCALINGO_API_URL/v1/databases -d \ + '{ + "database": { + "name": "my-postgres-db", + "technology": "postgresql", + "plan": "postgresql-starter-512", + "project_id": "pr-82a3cac5-9b25-473e-b33d-6272b87e636f" + } + }' +``` + +Returns 201 Created + +```json +{ + "database": { + "id": "54100930736f7563d5030000", + "name": "my-postgres-db", + "project_id": "pr-82a3cac5-9b25-473e-b33d-6272b87e636f", + "technology": "postgresql", + "plan": "postgresql-starter-512" + } +} +``` + +--- row --- + +## List Your Databases + +--- row --- + +`GET https://$SCALINGO_API_URL/v1/databases` + +List all your databases. + +||| col ||| + +Example + +```shell +curl -H "Accept: application/json" -H "Content-Type: application/json" \ + -H "Authorization: Bearer $BEARER_TOKEN" \ + -X GET https://$SCALINGO_API_URL/v1/databases +``` + +Returns 200 OK + +```json +{ + "databases": [ + { + "id": "54100930736f7563d5030000", + "name": "my-postgres-db", + "project_id": "pr-82a3cac5-9b25-473e-b33d-6272b87e636f", + "technology": "postgresql", + "plan": "postgresql-starter-512" + }, + { + "id": "54100930736f7563d5030001", + "name": "my-redis-db", + "project_id": "pr-82a3cac5-9b25-473e-b33d-6272b87e636f", + "technology": "redis", + "plan": "redis-starter-256" + } + ] +} +``` + +--- row --- + +## Get a Precise Database + +--- row --- + +`GET https://$SCALINGO_API_URL/v1/databases/[:database]` + +Display a precise database. + +||| col ||| + +Example request + +```shell +curl -H "Accept: application/json" -H "Content-Type: application/json" \ + -H "Authorization: Bearer $BEARER_TOKEN" \ + -X GET https://$SCALINGO_API_URL/v1/databases/my-postgres-db +``` + +Returns 200 OK + +```json +{ + "database": { + "id": "54100930736f7563d5030000", + "name": "my-postgres-db", + "project_id": "pr-82a3cac5-9b25-473e-b33d-6272b87e636f", + "technology": "postgresql", + "plan": "postgresql-starter-512" + } +} +``` + +Returns 404 Not Found if the database doesn't exist + +```json +{ + "error": "Database not found" +} +``` + +--- row --- From c8037ecc30cc566fe378d5ea0061c1023bd06023 Mon Sep 17 00:00:00 2001 From: Annabelle PELLIER Date: Mon, 12 Jan 2026 10:13:03 +0100 Subject: [PATCH 02/11] rename url --- _scalingo_api/{databases_ng.md => dedicated_databases.md} | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) rename _scalingo_api/{databases_ng.md => dedicated_databases.md} (99%) diff --git a/_scalingo_api/databases_ng.md b/_scalingo_api/dedicated_databases.md similarity index 99% rename from _scalingo_api/databases_ng.md rename to _scalingo_api/dedicated_databases.md index 5522c1e..1938dab 100644 --- a/_scalingo_api/databases_ng.md +++ b/_scalingo_api/dedicated_databases.md @@ -1,5 +1,5 @@ --- -title: Databases NG +title: Databases layout: default --- From d7c6882888f52c0d6da9746eedfc1978850525b8 Mon Sep 17 00:00:00 2001 From: Annabelle PELLIER Date: Mon, 12 Jan 2026 10:14:42 +0100 Subject: [PATCH 03/11] remove ng --- _scalingo_api/dedicated_databases.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_scalingo_api/dedicated_databases.md b/_scalingo_api/dedicated_databases.md index 1938dab..ced145d 100644 --- a/_scalingo_api/dedicated_databases.md +++ b/_scalingo_api/dedicated_databases.md @@ -3,7 +3,7 @@ title: Databases layout: default --- -# Databases NG +# Databases --- row --- From 0afba0c3aa7d63b00707690d4d4566df284d02ae Mon Sep 17 00:00:00 2001 From: Annabelle PELLIER Date: Mon, 12 Jan 2026 10:56:59 +0100 Subject: [PATCH 04/11] use dr --- _scalingo_api/{dedicated_databases.md => databases_dr.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename _scalingo_api/{dedicated_databases.md => databases_dr.md} (100%) diff --git a/_scalingo_api/dedicated_databases.md b/_scalingo_api/databases_dr.md similarity index 100% rename from _scalingo_api/dedicated_databases.md rename to _scalingo_api/databases_dr.md From caa5de33599a611f201c2c434eff2d8a870c48de Mon Sep 17 00:00:00 2001 From: Annabelle PELLIER Date: Mon, 12 Jan 2026 18:22:38 +0100 Subject: [PATCH 05/11] add comments + use correct plan --- _scalingo_api/databases_dr.md | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/_scalingo_api/databases_dr.md b/_scalingo_api/databases_dr.md index ced145d..3c5807d 100644 --- a/_scalingo_api/databases_dr.md +++ b/_scalingo_api/databases_dr.md @@ -27,8 +27,8 @@ Example object: "id": "54100930736f7563d5030000", "name": "my-postgres-db", "project_id": "pr-82a3cac5-9b25-473e-b33d-6272b87e636f", - "technology": "postgresql", - "plan": "postgresql-starter-512" + "technology": "postgresql-ng", + "plan": "postgresql-ng-starter-4096" } ``` @@ -45,8 +45,8 @@ Example object: * `database.name`: Database name. Should have between 6 and 48 lower case alphanumerical characters and hyphens, it can't have an hyphen at the beginning or at the end, nor two hyphens in a row. -* `database.technology`: Database technology identifier (e.g., `postgresql`, `mysql`, `mongodb`, `redis`, `elasticsearch`, `influxdb`) -* `database.plan_id`: Plan identifier (e.g., `postgresql-starter-512`, `mysql-business-1024`) +* `database.technology`: Database technology identifier (only `postgresql-ng` is supported for now) +* `database.plan`: Plan identifier (e.g., `postgresql-ng-starter-4096`). Available plans can be retrieved via the [Addon Providers endpoint](/addon_providers). * `database.project_id`: (*Optional*) ID of the project to assign the database to. If not provided, the database will be assigned to your default project. ||| col ||| @@ -60,8 +60,8 @@ curl -H "Accept: application/json" -H "Content-Type: application/json" \ '{ "database": { "name": "my-postgres-db", - "technology": "postgresql", - "plan": "postgresql-starter-512", + "technology": "postgresql-ng", + "plan": "postgresql-ng-starter-4096", "project_id": "pr-82a3cac5-9b25-473e-b33d-6272b87e636f" } }' @@ -75,8 +75,8 @@ Returns 201 Created "id": "54100930736f7563d5030000", "name": "my-postgres-db", "project_id": "pr-82a3cac5-9b25-473e-b33d-6272b87e636f", - "technology": "postgresql", - "plan": "postgresql-starter-512" + "technology": "postgresql-ng", + "plan": "postgresql-ng-starter-4096" } } ``` @@ -110,8 +110,8 @@ Returns 200 OK "id": "54100930736f7563d5030000", "name": "my-postgres-db", "project_id": "pr-82a3cac5-9b25-473e-b33d-6272b87e636f", - "technology": "postgresql", - "plan": "postgresql-starter-512" + "technology": "postgresql-ng", + "plan": "postgresql-ng-starter-4096" }, { "id": "54100930736f7563d5030001", @@ -152,8 +152,8 @@ Returns 200 OK "id": "54100930736f7563d5030000", "name": "my-postgres-db", "project_id": "pr-82a3cac5-9b25-473e-b33d-6272b87e636f", - "technology": "postgresql", - "plan": "postgresql-starter-512" + "technology": "postgresql-ng", + "plan": "postgresql-ng-starter-4096" } } ``` From 56b62ea72628e0dac35dfb1a7142560a2f8a7f52 Mon Sep 17 00:00:00 2001 From: Annabelle PELLIER Date: Tue, 13 Jan 2026 08:54:31 +0100 Subject: [PATCH 06/11] add note for other technos --- _scalingo_api/databases_dr.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/_scalingo_api/databases_dr.md b/_scalingo_api/databases_dr.md index 3c5807d..b121413 100644 --- a/_scalingo_api/databases_dr.md +++ b/_scalingo_api/databases_dr.md @@ -42,13 +42,13 @@ Example object: ### Parameters -* `database.name`: Database name. Should have between 6 and 48 lower case alphanumerical characters - and hyphens, it can't have an hyphen at the beginning or at the end, nor two - hyphens in a row. -* `database.technology`: Database technology identifier (only `postgresql-ng` is supported for now) +* `database.name`: Database name. Should have between 6 and 48 lower case alphanumerical characters and hyphens. +* `database.technology`: Database technology identifier. Only `postgresql-ng` is supported for now. * `database.plan`: Plan identifier (e.g., `postgresql-ng-starter-4096`). Available plans can be retrieved via the [Addon Providers endpoint](/addon_providers). * `database.project_id`: (*Optional*) ID of the project to assign the database to. If not provided, the database will be assigned to your default project. +**Note:** To provision other database types (MySQL, MongoDB, Redis, etc.), please use the [Addons provisioning endpoint](/addons#provision-an-addon). + ||| col ||| Example From 2698a2006c4f0e005e33a52eb9b5c15a8b2748cc Mon Sep 17 00:00:00 2001 From: Annabelle PELLIER Date: Tue, 13 Jan 2026 09:14:15 +0100 Subject: [PATCH 07/11] remove non ng examples --- _scalingo_api/databases_dr.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/_scalingo_api/databases_dr.md b/_scalingo_api/databases_dr.md index b121413..5b733f4 100644 --- a/_scalingo_api/databases_dr.md +++ b/_scalingo_api/databases_dr.md @@ -15,8 +15,8 @@ layout: default | id | string | unique ID | | name | string | name of the database | | project_id | string | ID of the project the database belongs to | -| technology | string | database technology (e.g., postgresql, mysql, mongodb)| -| plan | string | plan name (e.g., postgresql-starter-512, mysql-business-1024) | +| technology | string | database technology (e.g., postgresql-ng)| +| plan | string | plan name (e.g., postgresql-ng-starter-4096) | ||| col ||| @@ -115,10 +115,10 @@ Returns 200 OK }, { "id": "54100930736f7563d5030001", - "name": "my-redis-db", + "name": "backup-db", "project_id": "pr-82a3cac5-9b25-473e-b33d-6272b87e636f", - "technology": "redis", - "plan": "redis-starter-256" + "technology": "postgresql-ng", + "plan": "postgresql-ng-starter-4096" } ] } From 7201f294e209a9400c6abaff917d8f472447379f Mon Sep 17 00:00:00 2001 From: Annabelle PELLIER Date: Mon, 2 Feb 2026 16:42:04 +0100 Subject: [PATCH 08/11] pr review + replace ng by dr --- _scalingo_api/databases_dr.md | 44 +++++++++++++++++++++-------------- 1 file changed, 26 insertions(+), 18 deletions(-) diff --git a/_scalingo_api/databases_dr.md b/_scalingo_api/databases_dr.md index 5b733f4..59a2fba 100644 --- a/_scalingo_api/databases_dr.md +++ b/_scalingo_api/databases_dr.md @@ -5,6 +5,12 @@ layout: default # Databases +Databases endpoints allows you to manage Databases provisioned as Dedicated Resources. + +Dedicated Resource databases offer enhanced performance, isolation, and control compared to standard addon databases. + +Standard addon databases should be managed via the [Addons endpoints](/addons). + --- row --- **Database attributes** @@ -15,8 +21,8 @@ layout: default | id | string | unique ID | | name | string | name of the database | | project_id | string | ID of the project the database belongs to | -| technology | string | database technology (e.g., postgresql-ng)| -| plan | string | plan name (e.g., postgresql-ng-starter-4096) | +| technology | string | database technology (e.g., postgresql-dr)| +| plan | string | plan name (e.g., postgresql-dr-starter-4096) | ||| col ||| @@ -27,8 +33,8 @@ Example object: "id": "54100930736f7563d5030000", "name": "my-postgres-db", "project_id": "pr-82a3cac5-9b25-473e-b33d-6272b87e636f", - "technology": "postgresql-ng", - "plan": "postgresql-ng-starter-4096" + "technology": "postgresql-dr", + "plan": "postgresql-dr-starter-4096" } ``` @@ -43,8 +49,8 @@ Example object: ### Parameters * `database.name`: Database name. Should have between 6 and 48 lower case alphanumerical characters and hyphens. -* `database.technology`: Database technology identifier. Only `postgresql-ng` is supported for now. -* `database.plan`: Plan identifier (e.g., `postgresql-ng-starter-4096`). Available plans can be retrieved via the [Addon Providers endpoint](/addon_providers). +* `database.technology`: Database technology identifier. Only `postgresql-dr` is supported for now. +* `database.plan`: Plan identifier (e.g., `postgresql-dr-starter-4096`). Available plans can be retrieved via the [Addon Providers endpoint](/addon_providers). * `database.project_id`: (*Optional*) ID of the project to assign the database to. If not provided, the database will be assigned to your default project. **Note:** To provision other database types (MySQL, MongoDB, Redis, etc.), please use the [Addons provisioning endpoint](/addons#provision-an-addon). @@ -60,8 +66,8 @@ curl -H "Accept: application/json" -H "Content-Type: application/json" \ '{ "database": { "name": "my-postgres-db", - "technology": "postgresql-ng", - "plan": "postgresql-ng-starter-4096", + "technology": "postgresql-dr", + "plan": "postgresql-dr-starter-4096", "project_id": "pr-82a3cac5-9b25-473e-b33d-6272b87e636f" } }' @@ -75,8 +81,8 @@ Returns 201 Created "id": "54100930736f7563d5030000", "name": "my-postgres-db", "project_id": "pr-82a3cac5-9b25-473e-b33d-6272b87e636f", - "technology": "postgresql-ng", - "plan": "postgresql-ng-starter-4096" + "technology": "postgresql-dr", + "plan": "postgresql-dr-starter-4096" } } ``` @@ -89,7 +95,7 @@ Returns 201 Created `GET https://$SCALINGO_API_URL/v1/databases` -List all your databases. +List all your databases of postgresql-dr technology, including those where you are a collaborator. ||| col ||| @@ -110,15 +116,15 @@ Returns 200 OK "id": "54100930736f7563d5030000", "name": "my-postgres-db", "project_id": "pr-82a3cac5-9b25-473e-b33d-6272b87e636f", - "technology": "postgresql-ng", - "plan": "postgresql-ng-starter-4096" + "technology": "postgresql-dr", + "plan": "postgresql-dr-starter-4096" }, { "id": "54100930736f7563d5030001", "name": "backup-db", "project_id": "pr-82a3cac5-9b25-473e-b33d-6272b87e636f", - "technology": "postgresql-ng", - "plan": "postgresql-ng-starter-4096" + "technology": "postgresql-dr", + "plan": "postgresql-dr-business-4096" } ] } @@ -132,7 +138,9 @@ Returns 200 OK `GET https://$SCALINGO_API_URL/v1/databases/[:database]` -Display a precise database. +Display a precise database of postgresql-dr technology. + +The `[:database]` parameter can be either the database ID or the database name. ||| col ||| @@ -152,8 +160,8 @@ Returns 200 OK "id": "54100930736f7563d5030000", "name": "my-postgres-db", "project_id": "pr-82a3cac5-9b25-473e-b33d-6272b87e636f", - "technology": "postgresql-ng", - "plan": "postgresql-ng-starter-4096" + "technology": "postgresql-dr", + "plan": "postgresql-dr-starter-4096" } } ``` From 2bc3174c04556d3450a395eae56652f3bbc2084b Mon Sep 17 00:00:00 2001 From: Annabelle PELLIER Date: Mon, 2 Feb 2026 17:37:35 +0100 Subject: [PATCH 09/11] use -ng in technology --- _scalingo_api/databases_dr.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/_scalingo_api/databases_dr.md b/_scalingo_api/databases_dr.md index 59a2fba..4f5b2a1 100644 --- a/_scalingo_api/databases_dr.md +++ b/_scalingo_api/databases_dr.md @@ -21,7 +21,7 @@ Standard addon databases should be managed via the [Addons endpoints](/addons). | id | string | unique ID | | name | string | name of the database | | project_id | string | ID of the project the database belongs to | -| technology | string | database technology (e.g., postgresql-dr)| +| technology | string | database technology (e.g., postgresql-ng)| | plan | string | plan name (e.g., postgresql-dr-starter-4096) | ||| col ||| @@ -33,7 +33,7 @@ Example object: "id": "54100930736f7563d5030000", "name": "my-postgres-db", "project_id": "pr-82a3cac5-9b25-473e-b33d-6272b87e636f", - "technology": "postgresql-dr", + "technology": "postgresql-ng", "plan": "postgresql-dr-starter-4096" } ``` @@ -49,7 +49,7 @@ Example object: ### Parameters * `database.name`: Database name. Should have between 6 and 48 lower case alphanumerical characters and hyphens. -* `database.technology`: Database technology identifier. Only `postgresql-dr` is supported for now. +* `database.technology`: Database technology identifier. Only `postgresql-ng` is supported for now. * `database.plan`: Plan identifier (e.g., `postgresql-dr-starter-4096`). Available plans can be retrieved via the [Addon Providers endpoint](/addon_providers). * `database.project_id`: (*Optional*) ID of the project to assign the database to. If not provided, the database will be assigned to your default project. @@ -66,7 +66,7 @@ curl -H "Accept: application/json" -H "Content-Type: application/json" \ '{ "database": { "name": "my-postgres-db", - "technology": "postgresql-dr", + "technology": "postgresql-ng", "plan": "postgresql-dr-starter-4096", "project_id": "pr-82a3cac5-9b25-473e-b33d-6272b87e636f" } @@ -81,7 +81,7 @@ Returns 201 Created "id": "54100930736f7563d5030000", "name": "my-postgres-db", "project_id": "pr-82a3cac5-9b25-473e-b33d-6272b87e636f", - "technology": "postgresql-dr", + "technology": "postgresql-ng", "plan": "postgresql-dr-starter-4096" } } @@ -116,14 +116,14 @@ Returns 200 OK "id": "54100930736f7563d5030000", "name": "my-postgres-db", "project_id": "pr-82a3cac5-9b25-473e-b33d-6272b87e636f", - "technology": "postgresql-dr", + "technology": "postgresql-ng", "plan": "postgresql-dr-starter-4096" }, { "id": "54100930736f7563d5030001", "name": "backup-db", "project_id": "pr-82a3cac5-9b25-473e-b33d-6272b87e636f", - "technology": "postgresql-dr", + "technology": "postgresql-ng", "plan": "postgresql-dr-business-4096" } ] @@ -160,7 +160,7 @@ Returns 200 OK "id": "54100930736f7563d5030000", "name": "my-postgres-db", "project_id": "pr-82a3cac5-9b25-473e-b33d-6272b87e636f", - "technology": "postgresql-dr", + "technology": "postgresql-ng", "plan": "postgresql-dr-starter-4096" } } From aad19d2871d4ad9b9097a0a68e50c52b375d1c7f Mon Sep 17 00:00:00 2001 From: Annabelle PELLIER Date: Mon, 2 Feb 2026 17:41:47 +0100 Subject: [PATCH 10/11] missing renaming --- _scalingo_api/databases_dr.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/_scalingo_api/databases_dr.md b/_scalingo_api/databases_dr.md index 4f5b2a1..f51ec5f 100644 --- a/_scalingo_api/databases_dr.md +++ b/_scalingo_api/databases_dr.md @@ -3,7 +3,7 @@ title: Databases layout: default --- -# Databases +# Databases as Dedicated Resources Databases endpoints allows you to manage Databases provisioned as Dedicated Resources. @@ -40,7 +40,7 @@ Example object: --- row --- -## Create a Database +## Create a Database as a Dedicated Resource --- row --- @@ -89,13 +89,13 @@ Returns 201 Created --- row --- -## List Your Databases +## List Your Dedicated Resource Databases --- row --- `GET https://$SCALINGO_API_URL/v1/databases` -List all your databases of postgresql-dr technology, including those where you are a collaborator. +List all your databases of postgresql-ng technology, including those where you are a collaborator. ||| col ||| @@ -132,13 +132,13 @@ Returns 200 OK --- row --- -## Get a Precise Database +## Get a Dedicated Resource Database --- row --- `GET https://$SCALINGO_API_URL/v1/databases/[:database]` -Display a precise database of postgresql-dr technology. +Display a precise database of postgresql-ng technology. The `[:database]` parameter can be either the database ID or the database name. From 5fcb56b0243620ec6f3ca91dfff0248a1ca0ed6f Mon Sep 17 00:00:00 2001 From: samiFakhfakhScalingo Date: Mon, 9 Feb 2026 14:54:57 +0100 Subject: [PATCH 11/11] update database attributes to include hds_resource field and examples --- _scalingo_api/databases_dr.md | 34 +++++++++++++++++++++------------- 1 file changed, 21 insertions(+), 13 deletions(-) diff --git a/_scalingo_api/databases_dr.md b/_scalingo_api/databases_dr.md index f51ec5f..4135b01 100644 --- a/_scalingo_api/databases_dr.md +++ b/_scalingo_api/databases_dr.md @@ -16,13 +16,14 @@ Standard addon databases should be managed via the [Addons endpoints](/addons). **Database attributes** {:.table} -| field | type | description | -| ----------- | ------ | ----------------------------------------------------- | -| id | string | unique ID | -| name | string | name of the database | -| project_id | string | ID of the project the database belongs to | -| technology | string | database technology (e.g., postgresql-ng)| -| plan | string | plan name (e.g., postgresql-dr-starter-4096) | +| field | type | description | +| ------------- | ------- | ----------------------------------------------------- | +| id | string | unique ID | +| name | string | name of the database | +| project_id | string | ID of the project the database belongs to | +| technology | string | database technology (e.g., postgresql-ng) | +| plan | string | plan name (e.g., postgresql-dr-starter-4096) | +| hds_resource | boolean | whether the database is an HDS resource | ||| col ||| @@ -34,7 +35,8 @@ Example object: "name": "my-postgres-db", "project_id": "pr-82a3cac5-9b25-473e-b33d-6272b87e636f", "technology": "postgresql-ng", - "plan": "postgresql-dr-starter-4096" + "plan": "postgresql-dr-starter-4096", + "hds_resource": false } ``` @@ -52,6 +54,7 @@ Example object: * `database.technology`: Database technology identifier. Only `postgresql-ng` is supported for now. * `database.plan`: Plan identifier (e.g., `postgresql-dr-starter-4096`). Available plans can be retrieved via the [Addon Providers endpoint](/addon_providers). * `database.project_id`: (*Optional*) ID of the project to assign the database to. If not provided, the database will be assigned to your default project. +* `database.hds_resource`: (*Optional*) Set to `true` to create the database as an HDS resource. **Note:** To provision other database types (MySQL, MongoDB, Redis, etc.), please use the [Addons provisioning endpoint](/addons#provision-an-addon). @@ -68,7 +71,8 @@ curl -H "Accept: application/json" -H "Content-Type: application/json" \ "name": "my-postgres-db", "technology": "postgresql-ng", "plan": "postgresql-dr-starter-4096", - "project_id": "pr-82a3cac5-9b25-473e-b33d-6272b87e636f" + "project_id": "pr-82a3cac5-9b25-473e-b33d-6272b87e636f", + "hds_resource": false } }' ``` @@ -82,7 +86,8 @@ Returns 201 Created "name": "my-postgres-db", "project_id": "pr-82a3cac5-9b25-473e-b33d-6272b87e636f", "technology": "postgresql-ng", - "plan": "postgresql-dr-starter-4096" + "plan": "postgresql-dr-starter-4096", + "hds_resource": false } } ``` @@ -117,14 +122,16 @@ Returns 200 OK "name": "my-postgres-db", "project_id": "pr-82a3cac5-9b25-473e-b33d-6272b87e636f", "technology": "postgresql-ng", - "plan": "postgresql-dr-starter-4096" + "plan": "postgresql-dr-starter-4096", + "hds_resource": false }, { "id": "54100930736f7563d5030001", "name": "backup-db", "project_id": "pr-82a3cac5-9b25-473e-b33d-6272b87e636f", "technology": "postgresql-ng", - "plan": "postgresql-dr-business-4096" + "plan": "postgresql-dr-business-4096", + "hds_resource": true } ] } @@ -161,7 +168,8 @@ Returns 200 OK "name": "my-postgres-db", "project_id": "pr-82a3cac5-9b25-473e-b33d-6272b87e636f", "technology": "postgresql-ng", - "plan": "postgresql-dr-starter-4096" + "plan": "postgresql-dr-starter-4096", + "hds_resource": false } } ```