Merge branch 'main' into feat-service-binding

docs/data-sources/subaccount_app.md

@@ -0,0 +1,56 @@
+---
+page_title: "btp_subaccount_app Data Source - terraform-provider-btp"
+subcategory: ""
+description: |-
+  Gets details about a specific app.
+---
+
+# btp_subaccount_app (Data Source)
+
+Gets details about a specific app.
+
+## Example Usage
+
+```terraform
+data "btp_subaccount_app" "by_id" {
+  subaccount_id = "6aa64c2f-38c1-49a9-b2e8-cf9fea769b7f"
+  id            = "xsuaa!t1"
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `id` (String) The application ID is the xsappname plus the identifier, which consists of an exclamation mark (!), an identifier for the plan under which the application is deployed, and an index number.
+- `subaccount_id` (String) The ID of the subaccount.
+
+### Read-Only
+
+- `authorities` (Set of String)
+- `description` (String) The description of the app.
+- `foreign_scope_references` (Set of String)
+- `master_app_id` (String)
+- `oauth2_configuration` (Attributes) (see [below for nested schema](#nestedatt--oauth2_configuration))
+- `org_id` (String)
+- `plan_id` (String)
+- `plan_name` (String)
+- `serviceinstance_id` (String)
+- `space_id` (String)
+- `tenant_mode` (String)
+- `username` (String)
+- `xsappname` (String)
+
+<a id="nestedatt--oauth2_configuration"></a>
+### Nested Schema for `oauth2_configuration`
+
+Read-Only:
+
+- `allowedproviders` (Set of String)
+- `autoapprove` (Boolean)
+- `grant_types` (Set of String)
+- `redirect_uris` (Set of String)
+- `refresh_token_validity` (Number)
+- `system_attributes` (Set of String)
+- `token_validity` (Number)

docs/data-sources/subaccount_apps.md

@@ -0,0 +1,63 @@
+---
+page_title: "btp_subaccount_apps Data Source - terraform-provider-btp"
+subcategory: ""
+description: |-
+  Lists all apps.
+---
+
+# btp_subaccount_apps (Data Source)
+
+Lists all apps.
+
+## Example Usage
+
+```terraform
+data "btp_subaccount_apps" "all" {
+  subaccount_id = "6aa64c2f-38c1-49a9-b2e8-cf9fea769b7f"
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `subaccount_id` (String) The ID of the subaccount.
+
+### Read-Only
+
+- `id` (String, Deprecated) The ID of the subaccount.
+- `values` (Attributes List) (see [below for nested schema](#nestedatt--values))
+
+<a id="nestedatt--values"></a>
+### Nested Schema for `values`
+
+Read-Only:
+
+- `authorities` (Set of String)
+- `description` (String) The description of the app.
+- `foreign_scope_references` (Set of String)
+- `id` (String) The application ID is the xsappname plus the identifier, which consists of an exclamation mark (!), an identifier for the plan under which the application is deployed, and an index number.
+- `master_app_id` (String)
+- `oauth2_configuration` (Attributes) (see [below for nested schema](#nestedatt--values--oauth2_configuration))
+- `org_id` (String)
+- `plan_id` (String)
+- `plan_name` (String)
+- `serviceinstance_id` (String)
+- `space_id` (String)
+- `tenant_mode` (String)
+- `username` (String)
+- `xsappname` (String)
+
+<a id="nestedatt--values--oauth2_configuration"></a>
+### Nested Schema for `values.oauth2_configuration`
+
+Read-Only:
+
+- `allowedproviders` (Set of String)
+- `autoapprove` (Boolean)
+- `grant_types` (Set of String)
+- `redirect_uris` (Set of String)
+- `refresh_token_validity` (Number)
+- `system_attributes` (Set of String)
+- `token_validity` (Number)

docs/data-sources/subaccount_subscription.md

@@ -0,0 +1,61 @@
+---
+page_title: "btp_subaccount_subscription Data Source - terraform-provider-btp"
+subcategory: ""
+description: |-
+  Gets the details of a specific multitenant application to which a subaccount is entitled to subscribe. If this application is in a different global account than the current one, you need to specify its plan with '--plan'.
+  Tip:
+  You must be assigned to the subaccount admin or viewer role.
+---
+
+# btp_subaccount_subscription (Data Source)
+
+Gets the details of a specific multitenant application to which a subaccount is entitled to subscribe. If this application is in a different global account than the current one, you need to specify its plan with '--plan'.
+
+__Tip:__
+You must be assigned to the subaccount admin or viewer role.
+
+## Example Usage
+
+```terraform
+data "btp_subaccount_subscription" "content_agent_ui_free" {
+  subaccount_id = "6aa64c2f-38c1-49a9-b2e8-cf9fea769b7f"
+  app_name      = "content-agent-ui"
+  plan_name     = "free"
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `app_name` (String) The unique registration name of the deployed multitenant application as defined by the app developer.
+- `plan_name` (String) The plan name of the application to which the consumer has subscribed.
+- `subaccount_id` (String) The ID of the subaccount.
+
+### Read-Only
+
+- `additional_plan_features` (Set of String) The list of features specific to this plan.
+- `app_id` (String) The ID returned by XSUAA after the app provider has performed a bind of the multitenant application to a XSUAA service instance.
+- `authentication_provider` (String) The authentication provider of the multitenant application. * XSUAA is the SAP Authorization and Trust Management service that defines scopes and permissions for users as tenants at the global account level. * IAS is Identity Authentication Service that defines scopes and permissions for users in zones (common data isolation systems across systems, SaaS tenants, and services).
+- `category` (String) The technical name of the category defined by the app developer to which the multitenant application is grouped in customer-facing UIs.
+- `commercial_app_name` (String) The commercial name of the deployed multitenant application as defined by the app developer.
+- `created_date` (String) The date and time when the resource was created in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) format.
+- `customer_developed` (Boolean) Shows whether the application was developed by a customer. If not, then the application is developed by the cloud operator, such as SAP.
+- `description` (String) The description of the multitenant application.
+- `display_name` (String) The display name of the application for customer-facing UIs.
+- `formation_solution_name` (String) The name of the formations solution associated with the multitenant application.
+- `globalaccount_id` (String) The ID of the associated global account.
+- `id` (String) The technical ID generated by XSUAA for a multitenant application when a consumer subscribes to the application.
+- `labels` (Map of Set of String) Set of words or phrases assigned to the multitenant application subscription.
+- `last_modified` (String) The date and time when the resource was last modified in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) format.
+- `parameters` (String) The parameters of the subscription as a valid JSON object.
+- `platform_entity_id` (String) The ID of the landscape-specific environment.
+- `quota` (Number) The total amount the subscribed subaccount is entitled to consume.
+- `state` (String) The subscription state of the subaccount regarding the multitenant application.
+- `subscribed_subaccount_id` (String) The ID of the subaccount which is subscribed to the multitenant application.
+- `subscribed_tenant_id` (String) The ID of the tenant which is subscribed to a multitenant application.
+- `subscription_url` (String) The URL for app users to launch the subscribed application.
+- `supports_parameters_updates` (Boolean) Specifies whether a consumer, whose subaccount is subscribed to the application, can change its subscriptions parameters.
+- `supports_plan_updates` (Boolean) Specifies whether a consumer, whose subaccount is subscribed to the application, can change the subscription to a different plan that is available for this application and subaccount.
+- `tenant_id` (String) The tenant ID of the application provider.

docs/data-sources/subaccount_subscriptions.md

@@ -0,0 +1,72 @@
+---
+page_title: "btp_subaccount_subscriptions Data Source - terraform-provider-btp"
+subcategory: ""
+description: |-
+  Lists all the multitenant applications to which a subaccount is entitled to subscribe, including their subscription details.
+  Tip:
+  You must be assigned to the subaccount admin or viewer role.
+---
+
+# btp_subaccount_subscriptions (Data Source)
+
+Lists all the multitenant applications to which a subaccount is entitled to subscribe, including their subscription details.
+
+__Tip:__
+You must be assigned to the subaccount admin or viewer role.
+
+## Example Usage
+
+```terraform
+data "btp_subaccount_subscriptions" "all" {
+  subaccount_id = "6aa64c2f-38c1-49a9-b2e8-cf9fea769b7f"
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `subaccount_id` (String)
+
+### Read-Only
+
+- `id` (String, Deprecated) The ID of the subaccount.
+- `values` (Attributes List) (see [below for nested schema](#nestedatt--values))
+
+<a id="nestedatt--values"></a>
+### Nested Schema for `values`
+
+Read-Only:
+
+- `additional_plan_features` (Set of String) The list of features specific to this plan.
+- `app_id` (String) The ID returned by XSUAA after the app provider has performed a bind of the multitenant application to a XSUAA service instance.
+- `app_name` (String) The unique registration name of the deployed multitenant application as defined by the app developer.
+- `authentication_provider` (String) The authentication provider of the multitenant application. * XSUAA is the SAP Authorization and Trust Management service that defines scopes and permissions for users as tenants at the global account level. * IAS is Identity Authentication Service that defines scopes and permissions for users in zones (common data isolation systems across systems, SaaS tenants, and services).
+- `automation_state` (String) The state of the automation solution.
+- `automation_state_message` (String) The message that describes the automation solution state.
+- `category` (String) The technical name of the category defined by the app developer to which the multitenant application is grouped in customer-facing UIs.
+- `category_display_name` (String) The display name of the category for customer-facing UIs.
+- `commercial_app_name` (String) The commercial name of the deployed multitenant application as defined by the app developer.
+- `created_date` (String) The date and time when the resource was created in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) format.
+- `customer_developed` (Boolean) Shows whether the application was developed by a customer. If not, then the application is developed by the cloud operator, such as SAP.
+- `description` (String) The description of the multitenant application.
+- `display_name` (String) The display name of the application for customer-facing UIs.
+- `formation_solution_name` (String) The name of the formations solution associated with the multitenant application.
+- `globalaccount_id` (String) The ID of the associated global account.
+- `id` (String) The technical ID generated by XSUAA for a multitenant application when a consumer subscribes to the application.
+- `incident_tracking_component` (String) The application's incident-tracking component provided in metadata for customer-facing UIs.
+- `labels` (Map of Set of String) Set of words or phrases assigned to the multitenant application subscription.
+- `last_modified` (String) The date and time when the resource was last modified in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) format.
+- `plan_description` (String) The description of the plan for customer-facing UIs.
+- `plan_name` (String) The plan name of the application to which the consumer has subscribed.
+- `platform_entity_id` (String) The ID of the landscape-specific environment.
+- `quota` (Number) The total amount the subscribed subaccount is entitled to consume.
+- `short_description` (String) The short description of the multitenant application for customer-facing UIs.
+- `state` (String) The subscription state of the subaccount regarding the multitenant application.
+- `subscribed_subaccount_id` (String) The ID of the subaccount which is subscribed to the multitenant application.
+- `subscribed_tenant_id` (String) The ID of the tenant which is subscribed to a multitenant application.
+- `subscription_url` (String) The URL for app users to launch the subscribed application.
+- `supports_parameters_updates` (Boolean) Specifies whether a consumer, whose subaccount is subscribed to the application, can change its subscriptions parameters.
+- `supports_plan_updates` (Boolean) Specifies whether a consumer, whose subaccount is subscribed to the application, can change the subscription to a different plan that is available for this application and subaccount.
+- `tenant_id` (String) The tenant ID of the application provider.

docs/resources/subaccount.md

@@ -59,6 +59,13 @@ resource "btp_subaccount" "my_project_on_azure" {
 - `description` (String) A description of the subaccount for customer-facing UIs.
 - `labels` (Map of Set of String) The set of words or phrases assigned to the subaccount.
 - `parent_id` (String) The ID of the subaccount’s parent entity. If the subaccount is located directly in the global account (not in a directory), then this is the ID of the global account.
+- `usage` (String) Shows whether the subaccount is used for production purposes. This flag can help your cloud operator to take appropriate action when handling incidents that are related to mission-critical accounts in production systems. Do not apply for subaccounts that are used for nonproduction purposes, such as development, testing, and demos. Applying this setting this does not modify the subaccount. Possible values are: 
+
+  | value | description | 
+  | --- | --- | 
+  | `UNSET` | Global account or subaccount admin has not set the production-relevancy flag (default value). | 
+  | `NOT_USED_FOR_PRODUCTION` | The subaccount is not used for production purposes. | 
+  | `USED_FOR_PRODUCTION` | The subaccount is used for production purposes. |
 
 ### Read-Only
 
@@ -94,13 +101,6 @@ resource "btp_subaccount" "my_project_on_azure" {
   | `MIGRATION_FAILED` | The migration of the subaccount failed and the subaccount was not migrated. | 
   | `ROLLBACK_MIGRATION_PROCESSING` | The migration of the subaccount was rolled back and the subaccount is not migrated. | 
   | `SUSPENSION_FAILED` | The suspension operations failed. |
-- `usage` (String) Shows whether the subaccount is used for production purposes. This flag can help your cloud operator to take appropriate action when handling incidents that are related to mission-critical accounts in production systems. Do not apply for subaccounts that are used for nonproduction purposes, such as development, testing, and demos. Applying this setting this does not modify the subaccount. Possible values are: 
-
-  | value | description | 
-  | --- | --- | 
-  | `UNSET` | Global account or subaccount admin has not set the production-relevancy flag (default value). | 
-  | `NOT_USED_FOR_PRODUCTION` | The subaccount is not used for production purposes. | 
-  | `USED_FOR_PRODUCTION` | The subaccount is used for production purposes. |
 
 ## Import
 

docs/resources/subaccount_subscription.md

@@ -0,0 +1,76 @@
+---
+page_title: "btp_subaccount_subscription Resource - terraform-provider-btp"
+subcategory: ""
+description: |-
+  Subscribes to a multitenant application from a subaccount.
+  Custom or partner-developed applications are currently not supported.
+  Tip:
+  You must be assigned to the subaccount admin role.
+---
+
+# btp_subaccount_subscription (Resource)
+
+Subscribes to a multitenant application from a subaccount.
+Custom or partner-developed applications are currently not supported.
+
+__Tip:__
+You must be assigned to the subaccount admin role.
+
+## Example Usage
+
+```terraform
+resource "btp_subaccount_subscription" "workzone" {
+  subaccount_id = "6aa64c2f-38c1-49a9-b2e8-cf9fea769b7f"
+  app_name      = "SAPLaunchpad"
+  plan_name     = "free"
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `app_name` (String) The unique registration name of the deployed multitenant application as defined by the app developer.
+- `plan_name` (String) The plan name of the application to which the consumer has subscribed.
+- `subaccount_id` (String) The ID of the subaccount.
+
+### Optional
+
+- `parameters` (String) The parameters of the subscription as a valid JSON object.
+
+### Read-Only
+
+- `additional_plan_features` (Set of String) The list of features specific to this plan.
+- `app_id` (String) The ID returned by XSUAA after the app provider has performed a bind of the multitenant application to an XSUAA service instance.
+- `authentication_provider` (String) The authentication provider of the multitenant application. * XSUAA is the SAP Authorization and Trust Management service that defines scopes and permissions for users as tenants at the global account level. * IAS is Identity Authentication Service that defines scopes and permissions for users in zones (common data isolation systems across systems, SaaS tenants, and services).
+- `category` (String) The technical name of the category defined by the app developer to which the multitenant application is grouped in customer-facing UIs.
+- `commercial_app_name` (String) The commercial name of the deployed multitenant application as defined by the app developer.
+- `created_date` (String) The date and time when the resource was created in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) format.
+- `customer_developed` (Boolean) Shows whether the application was developed by a customer. If not, then the application is developed by the cloud operator, such as SAP.
+- `description` (String) The description of the multitenant application for customer-facing UIs.
+- `display_name` (String) The display name of the application for customer-facing UIs.
+- `formation_solution_name` (String) The name of the formations solution associated with the multitenant application.
+- `globalaccount_id` (String) The ID of the associated global account.
+- `id` (String) The technical ID generated by XSUAA for a multitenant application when a consumer subscribes to the application.
+- `labels` (Map of Set of String) The set of words or phrases assigned to the multitenant application subscription.
+- `last_modified` (String) The date and time when the resource was last modified in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) format.
+- `platform_entity_id` (String) The ID of the landscape-specific environment.
+- `quota` (Number) The total amount the subscribed subaccount is entitled to consume.
+- `state` (String) The subscription state of the subaccount regarding the multitenant application.
+- `subscribed_subaccount_id` (String) The ID of the subaccount, which is subscribed to the multitenant application.
+- `subscribed_tenant_id` (String) The ID of the tenant, which is subscribed to a multitenant application.
+- `subscription_url` (String) The URL for app users to launch the subscribed application.
+- `supports_parameters_updates` (Boolean) Specifies whether a consumer, whose subaccount is subscribed to the application, can change its subscriptions parameters.
+- `supports_plan_updates` (Boolean) Specifies whether a consumer, whose subaccount is subscribed to the application, can change the subscription to a different plan that is available for this application and subaccount.
+- `tenant_id` (String) The tenant ID of the application provider.
+
+## Import
+
+Import is supported using the following syntax:
+
+```terraform
+# terraform import btp_subaccount_subscription.<resource_name> <subaccount_id>,<app_name>,<plan_name>
+
+terraform import btp_subaccount_subscription.workzone 6aa64c2f-38c1-49a9-b2e8-cf9fea769b7f,SAPLaunchpad,free
+```