Document resource's internal ID structure and create foundation for migration guide (#12)

* Add internal ID structure to DSA instance descriptions

* Add internal ID structure to DSA credential descriptions

* Add internal ID structure to Argus descriptions

* Add internal ID structure to DNS descriptions

* Add internal ID structure to PostgresFlex descriptions

* Add internal ID structure to ResourceManager descriptions

* Add internal ID structure to SKE descriptions

* Generate updated docs

* Add first basis for migration guide

docs/resources/argus_credential.md

@@ -22,6 +22,6 @@ description: |-
 
 ### Read-Only
 
-- `id` (String) Terraform's internal resource ID.
+- `id` (String) Terraform's internal resource ID. It is structured as "`project_id`,`instance_id`,`username`".
 - `password` (String, Sensitive) Credential password
 - `username` (String) Credential username

docs/resources/argus_instance.md

@@ -41,7 +41,7 @@ resource "stackit_argus_instance" "example" {
 - `grafana_initial_admin_user` (String) Specifies an initial Grafana admin username.
 - `grafana_public_read_access` (Boolean) If true, anyone can access Grafana dashboards without logging in.
 - `grafana_url` (String) Specifies Grafana URL.
-- `id` (String) Terraform's internal resource ID.
+- `id` (String) Terraform's internal resource ID. It is structured as "`project_id`,`instance_id`".
 - `instance_id` (String) The Argus instance ID.
 - `is_updatable` (Boolean) Specifies if the instance can be updated.
 - `jaeger_traces_url` (String)

docs/resources/argus_scrapeconfig.md

@@ -53,7 +53,7 @@ resource "stackit_argus_scrapeconfig" "example" {
 
 ### Read-Only
 
-- `id` (String) Terraform's internal resource ID.
+- `id` (String) Terraform's internal resource ID. It is structured as "`project_id`,`instance_id`,`name`".
 
 <a id="nestedatt--targets"></a>
 ### Nested Schema for `targets`

docs/resources/dns_record_set.md

@@ -43,6 +43,6 @@ resource "stackit_dns_record_set" "example" {
 ### Read-Only
 
 - `error` (String) Error shows error in case create/update/delete failed.
-- `id` (String) Terraform's internal resource ID.
+- `id` (String) Terraform's internal resource ID. It is structured as "`project_id`,`instance_id`,`record_set_id`".
 - `record_set_id` (String) The rr set id.
 - `state` (String) Record set state.

docs/resources/dns_zone.md

@@ -51,7 +51,7 @@ resource "stackit_dns_zone" "example" {
 
 ### Read-Only
 
-- `id` (String) Terraform's internal resource ID.
+- `id` (String) Terraform's internal resource ID. It is structured as "`project_id`,`zone_id`".
 - `primary_name_server` (String) Primary name server. FQDN.
 - `record_count` (Number) Record count how many records are in the zone.
 - `serial_number` (Number) Serial number. E.g. `2022111400`.

docs/resources/logme_credentials.md

@@ -26,7 +26,7 @@ LogMe credentials resource schema.
 - `host` (String)
 - `hosts` (List of String)
 - `http_api_uri` (String)
-- `id` (String) Terraform's internal resource identifier.
+- `id` (String) Terraform's internal resource identifier. It is structured as "`project_id`,`instance_id`,`credentials_id`".
 - `name` (String)
 - `password` (String, Sensitive)
 - `port` (Number)

docs/resources/logme_instance.md

@@ -41,12 +41,12 @@ resource "stackit_logme_instance" "example" {
 ### Read-Only
 
 - `cf_guid` (String)
+- `cf_organization_guid` (String)
 - `cf_space_guid` (String)
 - `dashboard_url` (String)
-- `id` (String) Terraform's internal resource ID.
+- `id` (String) Terraform's internal resource ID. It is structured as "`project_id`,`instance_id`".
 - `image_url` (String)
 - `instance_id` (String) ID of the LogMe instance.
-- `cf_organization_guid` (String)
 - `plan_id` (String) The selected plan ID.
 
 <a id="nestedatt--parameters"></a>

docs/resources/mariadb_credentials.md

@@ -33,7 +33,7 @@ resource "stackit_mariadb_credentials" "example" {
 - `host` (String)
 - `hosts` (List of String)
 - `http_api_uri` (String)
-- `id` (String) Terraform's internal resource identifier.
+- `id` (String) Terraform's internal resource ID. It is structured as "`project_id`,`instance_id`,`credentials_id`".
 - `name` (String)
 - `password` (String, Sensitive)
 - `port` (Number)

docs/resources/mariadb_instance.md

@@ -41,12 +41,12 @@ resource "stackit_mariadb_instance" "example" {
 ### Read-Only
 
 - `cf_guid` (String)
+- `cf_organization_guid` (String)
 - `cf_space_guid` (String)
 - `dashboard_url` (String)
-- `id` (String) Terraform's internal resource ID.
+- `id` (String) Terraform's internal resource ID. It is structured as "`project_id`,`instance_id`".
 - `image_url` (String)
 - `instance_id` (String) ID of the MariaDB instance.
-- `cf_organization_guid` (String)
 - `plan_id` (String) The selected plan ID.
 
 <a id="nestedatt--parameters"></a>

docs/resources/opensearch_credentials.md

@@ -33,7 +33,7 @@ resource "stackit_opensearch_credentials" "example" {
 - `host` (String)
 - `hosts` (List of String)
 - `http_api_uri` (String)
-- `id` (String) Terraform's internal resource identifier.
+- `id` (String) Terraform's internal resource identifier. It is structured as "`project_id`,`instance_id`,`credentials_id`".
 - `name` (String)
 - `password` (String, Sensitive)
 - `port` (Number)

docs/resources/opensearch_instance.md

@@ -41,12 +41,12 @@ resource "stackit_opensearch_instance" "example" {
 ### Read-Only
 
 - `cf_guid` (String)
+- `cf_organization_guid` (String)
 - `cf_space_guid` (String)
 - `dashboard_url` (String)
-- `id` (String) Terraform's internal resource ID.
+- `id` (String) Terraform's internal resource ID. It is structured as "`project_id`,`instance_id`".
 - `image_url` (String)
 - `instance_id` (String) ID of the OpenSearch instance.
-- `cf_organization_guid` (String)
 - `plan_id` (String) The selected plan ID.
 
 <a id="nestedatt--parameters"></a>

docs/resources/postgresflex_instance.md

@@ -47,7 +47,7 @@ resource "stackit_postgresflex_instance" "example" {
 
 ### Read-Only
 
-- `id` (String) Terraform's internal resource ID.
+- `id` (String) Terraform's internal resource ID. It is structured as "`project_id`,`instance_id`".
 - `instance_id` (String) ID of the PostgresFlex instance.
 
 <a id="nestedatt--flavor"></a>

docs/resources/postgresflex_user.md

@@ -17,7 +17,7 @@ resource "stackit_postgresflex_user" "example" {
   project_id  = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
   instance_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
   username    = "username"
-  roles = ["role"]
+  roles       = ["role"]
 }
 ```
 
@@ -34,7 +34,7 @@ resource "stackit_postgresflex_user" "example" {
 ### Read-Only
 
 - `host` (String)
-- `id` (String) Terraform's internal resource ID.
+- `id` (String) Terraform's internal resource ID. It is structured as "`project_id`,`instance_id`,`user_id`".
 - `password` (String, Sensitive)
 - `port` (Number)
 - `user_id` (String) User ID.

docs/resources/postgresql_credentials.md

@@ -33,7 +33,7 @@ resource "stackit_postgresql_credentials" "example" {
 - `host` (String)
 - `hosts` (List of String)
 - `http_api_uri` (String)
-- `id` (String) Terraform's internal resource identifier.
+- `id` (String) Terraform's internal resource identifier. It is structured as "`project_id`,`instance_id`,`credentials_id`".
 - `name` (String)
 - `password` (String, Sensitive)
 - `port` (Number)

docs/resources/postgresql_instance.md

@@ -41,12 +41,12 @@ resource "stackit_postgresql_instance" "example" {
 ### Read-Only
 
 - `cf_guid` (String)
+- `cf_organization_guid` (String)
 - `cf_space_guid` (String)
 - `dashboard_url` (String)
-- `id` (String) Terraform's internal resource ID.
+- `id` (String) Terraform's internal resource ID. It is structured as "`project_id`,`instance_id`".
 - `image_url` (String)
 - `instance_id` (String) ID of the PostgreSQL instance.
-- `cf_organization_guid` (String)
 - `plan_id` (String) The selected plan ID.
 
 <a id="nestedatt--parameters"></a>

docs/resources/rabbitmq_credentials.md

@@ -33,7 +33,7 @@ resource "stackit_rabbitmq_credentials" "example" {
 - `host` (String)
 - `hosts` (List of String)
 - `http_api_uri` (String)
-- `id` (String) Terraform's internal resource identifier.
+- `id` (String) Terraform's internal resource identifier. It is structured as "`project_id`,`instance_id`,`credentials_id`".
 - `name` (String)
 - `password` (String, Sensitive)
 - `port` (Number)

docs/resources/rabbitmq_instance.md

@@ -41,12 +41,12 @@ resource "stackit_rabbitmq_instance" "example" {
 ### Read-Only
 
 - `cf_guid` (String)
+- `cf_organization_guid` (String)
 - `cf_space_guid` (String)
 - `dashboard_url` (String)
-- `id` (String) Terraform's internal resource ID.
+- `id` (String) Terraform's internal resource ID. It is structured as "`project_id`,`instance_id`".
 - `image_url` (String)
 - `instance_id` (String) ID of the RabbitMQ instance.
-- `cf_organization_guid` (String)
 - `plan_id` (String) The selected plan ID.
 
 <a id="nestedatt--parameters"></a>

docs/resources/redis_credentials.md

@@ -33,7 +33,7 @@ resource "stackit_redis_credentials" "example" {
 - `host` (String)
 - `hosts` (List of String)
 - `http_api_uri` (String)
-- `id` (String) Terraform's internal resource identifier.
+- `id` (String) Terraform's internal resource identifier. It is structured as "`project_id`,`instance_id`,`credentials_id`".
 - `name` (String)
 - `password` (String, Sensitive)
 - `port` (Number)

docs/resources/redis_instance.md

@@ -41,12 +41,12 @@ resource "stackit_redis_instance" "example" {
 ### Read-Only
 
 - `cf_guid` (String)
+- `cf_organization_guid` (String)
 - `cf_space_guid` (String)
 - `dashboard_url` (String)
-- `id` (String) Terraform's internal resource ID.
+- `id` (String) Terraform's internal resource ID. It is structured as "`project_id`,`instance_id`".
 - `image_url` (String)
 - `instance_id` (String) ID of the Redis instance.
-- `cf_organization_guid` (String)
 - `plan_id` (String) The selected plan ID.
 
 <a id="nestedatt--parameters"></a>

docs/resources/resourcemanager_project.md

@@ -40,4 +40,4 @@ resource "stackit_resourcemanager_project" "example" {
 ### Read-Only
 
 - `container_id` (String) Project container ID. Globally unique, user-friendly identifier.
-- `id` (String) Terraform's internal unique identifier of the project, equivalent to the container ID
+- `id` (String) Terraform's internal resource ID. It is structured as "`container_id`".

docs/resources/ske_cluster.md

@@ -57,7 +57,7 @@ Deprecated as of Kubernetes 1.25 and later
 
 ### Read-Only
 
-- `id` (String) Terraform's internal resource ID.
+- `id` (String) Terraform's internal resource ID. It is structured as "`project_id`,`name`".
 - `kube_config` (String, Sensitive) Kube config file used for connecting to the cluster
 - `kubernetes_version_used` (String) Full Kubernetes version used. For example, if 1.22 was selected, this value may result to 1.22.15
 

docs/resources/ske_project.md

@@ -27,4 +27,4 @@ resource "stackit_ske_project" "example" {
 
 ### Read-Only
 
-- `id` (String) Terraform's internal resource ID.
+- `id` (String) Terraform's internal resource ID. It is structured as "`project_id`".