Getting Started With SAP BTP
Getting Started With SAP BTP
PUBLIC
Warning
This document has been generated from the SAP Help Portal and is an incomplete version of the official SAP product
documentation. The information included in custom documentation may not reflect the arrangement of topics in the SAP Help
Portal, and may be missing important aspects and/or correlations to other topics. For this reason, it is not for productive use.
This is custom documentation. For more information, please visit the SAP Help Portal 1
10/15/24, 3:53 PM
SAP Business Technology Platform is built on a multi-cloud foundation, which lets you choose from different infrastructures and
runtimes. The services and solutions of SAP BTP are available on multiple cloud infrastructure providers, and it supports different
runtimes, such as Cloud Foundry, ABAP, and Kyma, as well as multiple different regions, and a broad choice of programming
languages.
The central point of entry to the platform is the SAP BTP cockpit, where you can access your accounts and applications and
manage all activities associated with them.
Services enable, facilitate, or accelerate the development of business applications and other platform services on SAP BTP.
For a complete list of services and capabilities, see SAP Discovery Center: Services .
Regions
You can deploy applications in different regions. Each region represents a geographical location (for example, Europe, US East)
where applications, data, or services are hosted.
This is custom documentation. For more information, please visit the SAP Help Portal 2
10/15/24, 3:53 PM
Regions are provided either by SAP or by our Infrastructure-as-a-Service (IaaS) partners Amazon Web Services (AWS), Microsoft
Azure, Google Cloud, and Alibaba Cloud. The third-party region providers operate the infrastructure layer of the regions, whereas
SAP operates the platform layer and Cloud Foundry.
A region is chosen at the subaccount level. For each subaccount, you select exactly one region (that is one data center).
Environments
Environments constitute the actual platform-as-a-service offering of SAP BTP that allows for the development and administration
of business applications. Environments are anchored in SAP BTP on subaccount level.
The Cloud Foundry environment enables you to develop new business applications and business services, supporting
multiple runtimes, programming languages, libraries, and services. You can leverage a multitude of buildpacks, including
community innovations and self-developed buildpacks.
ABAP Environment
Within the Cloud Foundry environment, you can create a new space for ABAP development. This is what we refer to as the
ABAP environment. It allows you to create extensions for ABAP-based products, such as SAP S/4HANA Cloud, and develop
new cloud applications. You can transform existing ABAP-based custom code or extensions to the cloud.
Kyma Environment
SAP BTP, Kyma runtime provides a fully managed cloud-native Kubernetes application runtime based on the open-source
project "Kyma". Based on modular building blocks, Kyma runtime includes all the necessary capabilities to simplify the
development and to run enterprise-grade cloud-native applications.
This is custom documentation. For more information, please visit the SAP Help Portal 3
10/15/24, 3:53 PM
Neo Environment
The Neo environment lets you develop HTML5, Java, and SAP HANA extended application services (SAP HANA XS)
applications. You can also use the UI Development Toolkit for HTML5 (SAPUI5) to develop rich user interfaces for modern
web-based business applications.
Remember
SAP Business Technology Platform, Neo environment will sunset on December 31, 2028, subject to terms of customer
or partner contracts.
SAP BTP provides different types of global accounts, enterprise and trial. The type you choose determines pricing, conditions of
use, resources, available services, and hosts.
A trial account lets you try out the platform for free. Access is open to everyone. Trial accounts are intended for personal
exploration, and not for production use or team development. They allow restricted use of the platform resources and
services.
An enterprise account is usually associated with one SAP customer or partner and contains their purchased entitlements
to platform resources and services. It groups together different subaccounts that an administrator makes available to users
for deploying applications.
Commercial Models
Consumption-based commercial model: Your organization receives access to all current and future services that are
eligible for this model. You have complete flexibility to turn services on and off and to switch between services as your
business requires throughout the duration of your contract. This commercial model is available in the following flavors: SAP
BTP Enterprise Agreement (SAP BTPEA), Cloud Platform Enterprise Agreement (CPEA), and Pay-As-You-Go for SAP BTP.
Subscription-based commercial model: Your organization subscribes only to the services that you plan to use. You can
then use these services at a fixed cost, irrespective of consumption.
This is custom documentation. For more information, please visit the SAP Help Portal 4
10/15/24, 3:53 PM
For more information, see What Is the Subscription-Based Commercial Model?
Account Model
The SAP BTP cockpit is structured according to global accounts, directories, and subaccounts:
A global account is the realization of a contract you or your company has made with SAP. A global account is used to
manage subaccounts, members, entitlements and quotas. You receive entitlements and quotas to use platform resources
per global account and then distribute the entitlements and quotas to the subaccount for actual consumption. There are
two types of commercial models for global accounts: consumption-based model and subscription-based model. See
Commercial Models
With directories, you can organize and manage your subaccounts according to your technical and business needs.
Subaccounts let you structure a global account according to your organization’s and project’s requirements with regard to
members, authorizations, and entitlements.
In the SAP BTP, Cloud Foundry environment, the subaccount is divided into one or more spaces, which is where application
development, deployment, and maintenance take place.
When you purchase an enterprise account, you’re entitled to use a specific set of resources, such as the amount of memory that
can be allocated to your applications.
This is custom documentation. For more information, please visit the SAP Help Portal 5
10/15/24, 3:53 PM
On SAP BTP, all external dependencies such as databases, messaging systems, files systems, and so on, are services. In
this context, multitenant applications and environments are considered services.
Each service has one or more service plans available. A service plan is the representation of the costs and benefits for a
given variant of a particular service. For instance, a database may be configured with various "T-shirt sizes", each of which
is a different service plan.
An entitlement is your right to provision and consume a resource. In other words, entitlements are the service plans that
you're entitled to use.
A quota represents the numeric quantity of a service plan that you're entitled to consume in your global account and its
subaccounts.
On SAP BTP, member management takes place at all levels from global account to environment, while user management is
relevant for business applications.
User accounts enable users to log on to SAP BTP, access subaccounts, and to use applications according to the permissions
granted to them. We distinguish between two types of users:
Platform users are usually developers, administrators or operators who deploy, administer, and troubleshoot applications
and services on SAP BTP.
Business users use the applications that are deployed to SAP BTP. For example, the end users of SaaS apps or services,
such as SAP Workflow service or SAP Cloud Integration, or end users of your custom applications are business users.
Member management refers to managing permissions for platform users. A member is a user who is assigned to an SAP BTP
global account or subaccount. Administrators can add users to global accounts and subaccounts and assign roles to them as
needed. You can use predefined roles, for example the administrator role for managing subaccount members.
User management refers to managing authentication and authorization for your business users.
SAP BTP includes many tools to help you develop and manage applications, and connect them to your on-premise systems.
For more information, see Tools.
SAP BTP supports many different programming languages; the availability of each depends on the development
environment you're using. For more information, see Programming Languages.
The SAP Cloud Application Programming Model offers a consistent end-to-end programming model that includes
languages, libraries, and APIs that are tailored for full-stack development on SAP BTP. For more information, see
Programming Models.
Depending on your use case, you can choose between different offerings for continuous integration and delivery. For more
information, see Continuous Integration and Delivery (CI/CD).
Discover and consume APIs to manage, build, and extend the core capabilities of SAP BTP. For more information, see APIs.
Solutions
SAP BTP offers fast in-memory processing, sustainable, agile solutions and services to integrate data and extend applications,
and fully embedded analytics and intelligent technologies.
Services
Services enable, facilitate, or accelerate the development of business applications and other platform services on SAP BTP.
Services are grouped into the following service types:
Business services: Services that enable, facilitate, or accelerate the development of business process components or
provide industry-specific functionalities or content within a business application.
Technical services: Services that enable, facilitate, or accelerate the development of general or domain independent
content within a business application, independent of the application's business process or task.
You find all available services, solutions, and use cases in the SAP Discovery Center .
This is custom documentation. For more information, please visit the SAP Help Portal 7
10/15/24, 3:53 PM
Regions
You can deploy applications in different regions. Each region represents a geographical location (for example, Europe, US East)
where applications, data, or services are hosted.
Regions are provided either by SAP or by our Infrastructure-as-a-Service (IaaS) partners Amazon Web Services (AWS), Microsoft
Azure, Google Cloud, and Alibaba Cloud. The third-party region providers operate the infrastructure layer of the regions, whereas
SAP operates the platform layer and Cloud Foundry.
This is custom documentation. For more information, please visit the SAP Help Portal 8
10/15/24, 3:53 PM
Selecting a Region
A region is chosen at the subaccount level. For each subaccount, you select exactly one region. The selection of a region is
dependent on many factors: For example, application performance (response time, latency) can be optimized by selecting a region
close to the user. For more information, see Selecting a Region.
To deploy an application in more than one region, execute the deployment separately for each host. For more information, see
Deploy an Application.
Within a region, there can be multiple instances of the SAP BTP, Cloud Foundry environment. When creating a subaccount, SAP
BTP automatically assigns the account to a specific instance of the environment. Several subaccounts of the same global account
can be located in different datacenters in one region. This also affects the format of the API endpoint URL that is displayed in the
cockpit after enabling Cloud Foundry in your subaccount. There are two possible formats for the API endpoint URL, either
displayed with or without an index. Here's an example for eu10:
Example
https://api.cf.eu10.hana.ondemand.com
https://api.cf.eu10-<XXX>.hana.ondemand.com
In both cases, the subaccount is located in the region eu10. The differences in the URLs are only an indicator of technical details on
the side of SAP BTP and do not affect the functionality of your applications. For information on enabling Cloud Foundry, see Create
Orgs.
High Availability
This is custom documentation. For more information, please visit the SAP Help Portal 9
10/15/24, 3:53 PM
SAP has a number of processes in place to support resilience in SAP BTP, and provides different offerings so that you can support
the high availability of your applications. For more information, see Resilience, High Availability, and Disaster Recovery.
EU Access
Some customer contracts include EU Access, which restricts processing of personal data to EEA/Switzerland. If the global
account is marked with EU Access, the actual EU Access compliance status of subaccounts will be displayed during creation of
subaccounts.
Note
If you require a subaccount with EU Access, make sure to select a provider and region where EU Access is available. Regions
that allow for EU Access are labeled as such in the map view filter in the SAP Discovery Center.
For some services, EU Access is generally not available, not even if the provider and region support EU Access.
Related Information
Regions and API Endpoints Available for the Cloud Foundry Environment
Regions and API Endpoints for the ABAP Environment
Regions for the Kyma Environment
IaaS Region Region Name Technical Technical NAT IPs LB IPs (ingress, API Endpoint
Provider Key Key of IaaS (egress, IPs for for incoming
Provider requests from a requests)
Cloud Foundry
app)
This is custom documentation. For more information, please visit the SAP Help Portal 10
10/15/24, 3:53 PM
IaaS Region Region Name Technical Technical NAT IPs LB IPs (ingress, API Endpoint
Provider Key Key of IaaS (egress, IPs for for incoming
Provider requests from a requests)
Cloud Foundry
app)
20.56.169.41,
20.56.169.58,
20.56.169.161,
20.56.169.116,
20.56.169.167,
20.56.169.50,
20.56.169.175,
20.56.169.131,
20.56.169.66,
20.56.169.71,
20.56.169.138,
20.56.169.91,
52.142.226.14,
20.86.1.84,
20.86.1.80,
20.86.0.233,
20.86.1.131,
20.86.1.54,
20.86.1.128,
20.86.1.134,
20.86.1.163,
20.86.1.15,
20.86.0.250,
20.86.1.107,
20.86.1.157,
20.86.0.253,
20.86.1.12,
20.86.1.97
cf-eu20-001:
20.54.248.90,
20.54.248.142,
20.54.250.88,
20.54.250.91,
20.56.17.109,
20.56.18.130,
20.56.18.132,
20.56.18.179,
20.86.17.114,
20.86.17.142,
20.86.17.153,
20.86.17.159
This is custom documentation. For more information, please visit the SAP Help Portal 11
10/15/24, 3:53 PM
IaaS Region Region Name Technical Technical NAT IPs LB IPs (ingress, API Endpoint
Provider Key Key of IaaS (egress, IPs for for incoming
Provider requests from a requests)
Cloud Foundry
app)
20.70.201.155,
20.70.201.89,
20.70.201.66
Microsoft jp20 Japan (Tokyo) cf-jp20 Japan East 52.185.186.130, 20.43.89.91 api.cf.jp20.hana.ondemand.com
Azure 20.194.193.229,
20.194.193.167,
20.194.194.97,
40.81.200.207,
20.78.122.9,
20.78.121.237,
20.78.122.8,
20.40.96.175,
20.78.2.104,
20.78.2.106,
20.78.2.107
This is custom documentation. For more information, please visit the SAP Help Portal 12
10/15/24, 3:53 PM
IaaS Region Region Name Technical Technical NAT IPs LB IPs (ingress, API Endpoint
Provider Key Key of IaaS (egress, IPs for for incoming
Provider requests from a requests)
Cloud Foundry
app)
52.146.15.82,
52.146.10.227
This is custom documentation. For more information, please visit the SAP Help Portal 13
10/15/24, 3:53 PM
IaaS Region Region Name Technical Technical NAT IPs LB IPs (ingress, API Endpoint
Provider Key Key of IaaS (egress, IPs for for incoming
Provider requests from a requests)
Cloud Foundry
app)
This is custom documentation. For more information, please visit the SAP Help Portal 14
10/15/24, 3:53 PM
IaaS Region Region Name Technical Technical NAT IPs LB IPs (ingress, API Endpoint
Provider Key Key of IaaS (egress, IPs for for incoming
Provider requests from a requests)
Cloud Foundry
app)
13.124.16.17,
15.165.83.237
3.121.35.143 18.196.206.8,
3.65.185.47,
cf-eu10-002: 3.73.109.100,
This is custom documentation. For more information, please visit the SAP Help Portal 15
10/15/24, 3:53 PM
IaaS Region Region Name Technical Technical NAT IPs LB IPs (ingress, API Endpoint
Provider Key Key of IaaS (egress, IPs for for incoming
Provider requests from a requests)
Cloud Foundry
app)
18.198.196.89, 3.73.8.210,
18.193.21.232, 52.59.18.183
3.65.9.91,
52.29.190.137,
18.197.134.65,
3.67.182.154,
3.67.255.232,
3.66.249.150,
3.68.44.236
cf-eu10-003:
3.64.131.199,
3.64.88.217,
3.64.142.243,
18.198.18.157,
3.68.40.83,
3.67.235.98,
3.68.17.221,
18.198.149.19,
3.68.38.23
cf-eu10-004:
3.69.195.103,
3.64.170.167,
3.68.176.248,
3.121.49.211,
18.197.219.60,
3.70.38.84
This is custom documentation. For more information, please visit the SAP Help Portal 16
10/15/24, 3:53 PM
IaaS Region Region Name Technical Technical NAT IPs LB IPs (ingress, API Endpoint
Provider Key Key of IaaS (egress, IPs for for incoming
Provider requests from a requests)
Cloud Foundry
app)
cf-us10-001:
52.0.214.195,
18.213.153.162,
54.227.144.195,
3.225.73.158,
34.233.151.91,
23.23.172.117,
3.222.22.16,
34.238.1.234,
34.194.239.31,
3.225.44.56,
34.201.208.150,
75.101.157.228
cf-us10-002:
54.162.233.194,
34.206.160.141,
35.168.80.144,
18.232.28.65,
54.82.224.146,
3.221.4.74,
18.211.12.227,
54.159.45.198,
72.44.51.245
This is custom documentation. For more information, please visit the SAP Help Portal 17
10/15/24, 3:53 PM
IaaS Region Region Name Technical Technical NAT IPs LB IPs (ingress, API Endpoint
Provider Key Key of IaaS (egress, IPs for for incoming
Provider requests from a requests)
Cloud Foundry
app)
35.193.69.164,
35.202.1.6,
23.236.63.113,
35.193.30.116,
35.202.66.196,
34.68.152.205,
35.222.158.222,
104.197.20.168,
35.232.105.70,
35.224.211.196,
35.222.192.158,
35.193.8.172,
34.171.4.220,
34.172.37.175,
34.170.206.220,
34.172.145.231,
35.222.38.254,
35.239.28.216,
34.134.91.47,
34.123.17.36,
35.202.205.85,
34.118.207.84,
35.193.6.192,
34.122.222.203,
104.197.157.121,
34.135.159.154,
35.223.208.27,
146.148.74.171,
34.132.192.46,
34.68.109.37,
104.198.49.58,
35.225.164.132
This is custom documentation. For more information, please visit the SAP Help Portal 18
10/15/24, 3:53 PM
IaaS Region Region Name Technical Technical NAT IPs LB IPs (ingress, API Endpoint
Provider Key Key of IaaS (egress, IPs for for incoming
Provider requests from a requests)
Cloud Foundry
app)
34.159.165.29,
35.242.240.154,
34.141.73.130,
34.159.27.236,
34.89.152.211,
35.242.194.75,
35.246.235.253,
34.159.127.190,
34.141.82.126,
35.234.69.102,
34.89.231.53,
34.159.188.133,
35.246.203.194,
34.159.201.78,
34.141.112.232,
35.198.84.213,
34.89.165.33
This is custom documentation. For more information, please visit the SAP Help Portal 19
10/15/24, 3:53 PM
IaaS Region Region Name Technical Technical NAT IPs LB IPs (ingress, API Endpoint
Provider Key Key of IaaS (egress, IPs for for incoming
Provider requests from a requests)
Cloud Foundry
app)
34.93.205.174,
34.93.159.24
This is custom documentation. For more information, please visit the SAP Help Portal 20
10/15/24, 3:53 PM
IaaS Region Region Name Technical Technical NAT IPs LB IPs (ingress, API Endpoint
Provider Key Key of IaaS (egress, IPs for for incoming
Provider requests from a requests)
Cloud Foundry
app)
34.166.50.229,
34.166.52.69,
34.166.53.147,
34.166.55.78,
34.166.57.177,
34.166.60.109,
34.166.61.61,
34.166.61.119,
34.166.61.169,
34.166.61.173,
34.166.62.51,
34.166.62.206,
34.166.63.160,
34.166.64.6,
34.166.65.231
IaaS Region Region Technical Technical Trial NAT IPs LB IPs API Endpoint Domain
Provider Name Key Key of (egress, IPs (ingress, for
IaaS for requests incoming
Provider from a Cloud requests)
Foundry app)
Note
Trial accounts and subaccounts on trial can no longer be created on eu10, Europe (Frankfurt).
Note
In the Cloud Foundry environment, IPs are controlled by the respective IaaS provider (AWS, Azure, or Google Cloud). IPs may
change due to network updates on the provider side. Any planned changes will be announced at least four weeks before they
take effect.
Note
In the Cloud Foundry environment, the region in which a global account was created determines the API endpoint of all
subaccounts associated with it. For example, subaccounts created in a global account in region eu10 share the API endpoint
URL api.cf.eu10.hana.ondemand.com.
This is custom documentation. For more information, please visit the SAP Help Portal 21
10/15/24, 3:53 PM
IaaS Region Region Name Technical Technical Key of NAT IPs (egress, IPs for API Endpoint Dom
Provider Key IaaS Provider requests from an ABAP
System)
Amazon ap12 South Korea cf-ap12 ap-northeast-2 3.39.57.235, 13.125.0.129, api.cf.ap12.hana.ondemand.com ap1
Web (Seoul) 13.124.63.148,
Services 13.209.63.123
This is custom documentation. For more information, please visit the SAP Help Portal 22
10/15/24, 3:53 PM
IaaS Region Region Name Technical Technical Key of NAT IPs (egress, IPs for API Endpoint Dom
Provider Key IaaS Provider requests from an ABAP
System)
This is custom documentation. For more information, please visit the SAP Help Portal 23
10/15/24, 3:53 PM
IaaS Region Region Name Technical Technical Key of NAT IPs (egress, IPs for API Endpoint Dom
Provider Key IaaS Provider requests from an ABAP
System)
104.154.245.19,
34.171.92.122,
35.224.140.73,
34.31.173.8
IaaS Region Region Technical Technical Key Trial NAT IPs API Endpoint Domain
Provider Name Key of IaaS (egress, IPs
Provider for requests
from a Cloud
Foundry app)
Note
In the Kyma environment, IP addresses for NAT Gateway that handles the egress traffic are configured dynamically. This means
that you cannot identify the IP address of NAT Gateway in advance. However, once the IP address is assigned, it remains
unchanged throughout the cluster's lifecycle.
Subaccount Regions
The table lists the regions you can choose from when creating a subaccount.
Global Account Region IaaS Provider Technical Key Region Name Plan ID
Type
Trial account
This is custom documentation. For more information, please visit the SAP Help Portal 24
10/15/24, 3:53 PM
Global Account Region IaaS Provider Technical Key Region Name Plan ID
Type
Enterprise account br20 Microsoft Azure cf-br20 Brazil (São Paulo) azure
Enterprise account br10 Amazon Web cf-br10 Brazil (São Paulo) aws
Services
Enterprise account ap12 Amazon Web cf-ap12 South Korea (Seoul) aws
Services
This is custom documentation. For more information, please visit the SAP Help Portal 25
10/15/24, 3:53 PM
Global Account Region IaaS Provider Technical Key Region Name Plan ID
Type
Enterprise account il30 Google Cloud cf-il30 Israel (Tel Aviv) gcp
Enterprise account br30 Google Cloud cf-br30 Brazil (São Paulo) gcp
Cluster Regions
When you enable a Kyma environment for a given subaccount, you must select a plan and region where the cluster is going to be
created. Note that there is a number of regions available within each plan. They are all listed in the table:
Cluster Regions
southeastasia Singapore
This is custom documentation. For more information, please visit the SAP Help Portal 26
10/15/24, 3:53 PM
ap-southeast-1 Singapore
Load Balancers
Depending on the IaaS Provider, the following Load Balancers are provisioned by default:
For more details on the Load Balancers and their features, check out the official documention of the respective IaaS provider.
Related Information
Create a Kyma Instance
Available Plans in the Kyma Environment
Provisioning and Updating Parameters in the Kyma Environment
This is custom documentation. For more information, please visit the SAP Help Portal 27
10/15/24, 3:53 PM
Availability Zones To achieve better fault-tolerance in the Cloud Foundry environment, we deploy our All regions
services across multiple AZs, which improves the availability of a service if there that support
are issues with the infrastructure of one AZ. For more information, see Availability the Cloud
Zones in the Cloud Foundry Environment. Foundry
runtime. See
Regions and
API
Endpoints
Available for
the Cloud
Foundry
Environment.
Backups in Kyma runtime Kyma runtime relies on managed Kubernetes clusters for periodic backups of All regions
Kubernetes objects. For more information, see Kyma Environment Backup. that support
the Kyma
runtime. See
Regions for
the Kyma
Environment.
Backup and Recovery for SAP If you use SAP HANA Cloud, your SAP HANA Cloud instances are continually All regions
HANA Cloud backed up to safeguard your database and ensure that it can be recovered where SAP
speedily. For more information, see Backup and Recovery. HANA Cloud
is available.
See
Availability of
SAP HANA
Cloud.
Disaster Recovery The SAP BTP Disaster Recovery (DR) Plan is part of the overall SAP BTP Business All regions.
Continuity Plan, which includes crisis management and process continuity
activities that are triggered by a declared disaster. For more information, see
Disaster Recovery as Part of the Business Continuity Plan.
In addition to the services offered by SAP BTP, you can follow our best practices for developing and deploying applications, which
allow you to make your application running on SAP BTP stable and highly available.
This is custom documentation. For more information, please visit the SAP Help Portal 28
10/15/24, 3:53 PM
When developing your applications, apply the principles and patterns of resilient software design that fit your use case. For
more information, see Developing Resilient Apps on SAP BTP. For situations where the load is highly available and where
applications need to react by scaling, consider using Application Autoscaler. For more information, see What Is Application
Autoscaler?
To benefit from the high availability mechanisms in Cloud Foundry, set up your applications with multiple instances. For
more information, see .
SAP can restore productive tenants from backups as soon as practicable in case of a disaster resulting in the loss of the primary
production data center.
As the magnitude of a disaster is unpredictable, a region might not be restored in a reasonable time. In addition, a new
infrastructure might need to be set up at a different location, which might require the purchase and setup of new hardware.
Therefore, we can't guarantee any fixed recovery timelines.
Environments
Environments constitute the actual platform-as-a-service offering of SAP BTP that allows for the development and administration
of business applications. Environments are anchored in SAP BTP on subaccount level.
Each environment comes equipped with specific tools, technologies, and runtimes that you need to build applications. So a multi-
environment subaccount is your single address to host a variety of applications and offer diverse development options. One
advantage of using different environments in one subaccount is that you only need to manage users, authorizations, and
entitlements once per subaccount, and thus grant more flexibility to your developers.
Environment Instances
To actually use an environment in a subaccount, you must enable it, which creates an instance of that environment. There are
several ways to create environment instances:
This is custom documentation. For more information, please visit the SAP Help Portal 29
10/15/24, 3:53 PM
In the SAP BTP cockpit, under Service Marketplace. Here, you get more information, such as the available plans and links
to further information.
Related Information
Account Administration
The Cloud Foundry environment enables you to develop new business applications and business services, supporting multiple
runtimes, programming languages, libraries, and services. You can leverage a multitude of buildpacks, including community
innovations and self-developed buildpacks. It also integrates with SAP HANA extended application services, advanced model.
For more information about Cloud Foundry, see the official Cloud Foundry documentation at https://docs.cloudfoundry.org/ .
Related Information
Getting Started in the Cloud Foundry Environment
Development in the Cloud Foundry Environment
Administration and Operations in the Cloud Foundry Environment
This is custom documentation. For more information, please visit the SAP Help Portal 30
10/15/24, 3:53 PM
Websockets. See
https://docs.cloudfoundry.org/adminguide/supporting-
websockets.html .
SAP BTP supports the Cloud Foundry command line interface (CF CLI) version 8 or newer. Older versions of the CF CLI are
not supported.
By default, a newly pushed (or started) Cloud Foundry application needs to respond to a health check within the first 60
seconds, otherwise the application is considered to have failed. For more information, see
https://docs.cloudfoundry.org/devguide/deploy-apps/healthchecks.html#health_check_timeout . On SAP BTP, however,
you can override this timeout to up to 10 minutes. For instructions, see https://docs.cloudfoundry.org/devguide/deploy-
apps/large-app-deploy.html .
On SAP BTP, application SSH access is disabled by default. For more information on SSH, see
https://docs.cloudfoundry.org/devguide/deploy-apps/app-ssh-overview.html .
SAP BTP supports the Cloud Foundry API version 3. The Cloud Foundry API v2 has been deprecated and is no longer
supported. For more information, see https://v3-apidocs.cloudfoundry.org/ .
This is custom documentation. For more information, please visit the SAP Help Portal 31
10/15/24, 3:53 PM
On SAP BTP, the Cloud Foundry API is protected by a rate limit against misuse. The limit is in the range of a few 10k
requests per hour per user on average. Starting in April 2023, the rate limit for the deprecated Cloud Foundry API v2 will be
decreased and eventually reach the range of a few hundred requests per hour per user.
In addition to the general rate limit on the Cloud Foundry API, requests for certain API endpoints related to services face a
separate limit on concurrent requests. The Cloud Foundry API responds with HTTP status code 429 if a rate limit is reached
and provides a Retry-After Header suggesting when the client can attempt a retry. For more information, see
https://docs.cloudfoundry.org/running/rate-limit-cloud-controller-
api.html#Rate%20Limit%20Responses:%20Service%20Brokers .
In the SAP BTP, Cloud Foundry environment, the total HTTP Request Header and HTTP Response Header size is limited to
64 KB to protect against misuse.
In the SAP BTP, Cloud Foundry environment, for both HTTP Request Headers and HTTP Response Headers the total
amount of Headers is limited to 101.
In the SAP BTP, Cloud Foundry environment, the limit of concurrent HTTP connections between client and application is
3000 per application container.
In the SAP BTP, Cloud Foundry environment, the HTTP keep-alive timeout towards the client is set to 60s to protect
against misuse. 60s is the maximum time span allowed to wait for a new HTTP request to appear if keep-alive is
enabled.
In the SAP BTP, Cloud Foundry environment, an internal HTTP keep-alive is set to 90s. A higher value must be set on
application-side to avoid intermittent disruptions. For more information, see step 4 of 3406978 .
In the Cloud Foundry environment, there’s a logging rate limit to guard against malicious applications. By default, the limit
is 4000 logs per second per application instance, but in exceptional high load scenarios it may be lowered by the platform.
If this limit is exceeded, additional logs from the application instance are dropped and a warning message is injected into
the application instance’s log stream every second. This message also contains the exact current log rate limit.
Applications requiring sent envelopes to be delivered to external Log Management Services should use the Cloud Foundry
syslog drain capability. See https://docs.cloudfoundry.org/devguide/services/log-management.html .
In the SAP BTP, Cloud Foundry environment, the time between signaling a container to shut down gracefully and forcefully
stopping it is set to 60 seconds. The default in Cloud Foundry is 10 seconds, see
https://docs.cloudfoundry.org/devguide/deploy-apps/app-lifecycle.html#shutdown . This time interval will not be taken
into account if there are no explicit kernel signal handlers implemented in the application.
In the SAP BTP, Cloud Foundry environment, applications get a guaranteed CPU share of ¼ core per GB instance memory.
As the maximum instance memory per application is 16 GB, this allows for vertical scaling up to 4 CPUs.
If applications running on the same virtual machine don't use their guaranteed CPU, other applications might get more
CPU. This isn’t guaranteed and might be subject to change in the future. If you encounter performance problems, scale up
your application or increase the application start timeout.
The number of running threads per application instance is limited to 10,420. Reaching this limit can cause performance
issues.
When pushing or scaling your application, you can define a disk_quota that can be up to 10 GB. For more information,
see https://docs.cloudfoundry.org/devguide/deploy-apps/manifest-attributes.html#disk-quota .
When deploying applications on SAP BTP, the maximum application package size is 1.5 GB. If your application is larger than
that, the deployment fails. For more information, see https://docs.cloudfoundry.org/devguide/deploy-apps/large-app-
deploy.html .
In the SAP BTP, Cloud Foundry environment, the hard limit for open file descriptors is 32,768 (32K) per container.
In global accounts that support the consumption-based commercial model you might see a quota limit for certain services.
This is a technical limit only, not a business limit. If you need to increase this limit, report an incident to SAP support for
This is custom documentation. For more information, please visit the SAP Help Portal 32
10/15/24, 3:53 PM
component BC-NEO-CIS.
In the SAP BTP, Cloud Foundry environment, the SAP HANA database supports up to 1000 simultaneous connections per
database.
In the SAP BTP, Cloud Foundry environment, each application can be mapped to approximately 1000 routes (128 KB). The
total length of the routing information must not exceed this limit.
Cloud Foundry Audit Events have a retention period of 14 days. For more information on Audit Events, see
https://docs.cloudfoundry.org/running/managing-cf/audit-events.html .
Availability zones (AZ) are single failure domains within a single geographical region and are separate physical locations with
independent power, network, and cooling. Multiple AZs exist in one region and are connected with each other through a low-
latency network.
To achieve better fault-tolerance, our partners recommend deploying services across multiple AZs, which improves the availability
of a service if there are issues with the region infrastructure of one AZ.
The SAP BTP Cloud Foundry environment follows these recommendations to support high availability at the platform and
application level:
The building blocks of Cloud Foundry and the virtual machines on which the Cloud Foundry application instances
are scheduled run in a high availability setup. Their instances are distributed across different AZs.
The technology that manages the deployment of the Cloud Foundry environment monitors the health of the
platform. If there are infrastructure failures, it re-creates the faulty components.
We recommend running multiple application instances to increase availability. For more information, see Run
Multiple Instances to Increase Availability . On SAP BTP, there are three ways to increase application instances:
This is custom documentation. For more information, please visit the SAP Help Portal 33
10/15/24, 3:53 PM
Scaling your application using the application manifest. The manifest.yml allows you to make and save
configurations for your application. To scale, you can configure the instance count in the manifest and push
the application again with the new configuration. See App Manifest Attribute Reference . To avoid
downtimes when updating your application configuration, you can also consider using rolling application
deployments. See Rolling App Deployments .
Scaling your application using the cf scale command in the Cloud Foundry command line interface (CF
CLI). See Scaling an App Using cf scale .
Scaling your application using the SAP BTP cockpit. See Add or Remove Application Instances.
The Cloud Foundry container scheduler takes care of distributing the different instances of one application on
virtual machines in different AZs. For more information, see How Diego Balances App Processes .
Cloud Foundry is constantly monitoring the health state of application instances and restarts instances that are
considered unhealthy. See Using App Health Checks .
When the number of desired instances doesn't match the number of actually running instances, Cloud Foundry
reschedules the missing instances, for example, when the virtual machines that an application instance was initially
scheduled on become unresponsive.
For more information on high availability configuration, see High Availability in Cloud Foundry .
Content Location
BOSH http://bosh.cloudfoundry.org
Buildpacks http://docs.cloudfoundry.org/buildpacks
This is custom documentation. For more information, please visit the SAP Help Portal 34
10/15/24, 3:53 PM
Content Location
http://docs.cloudfoundry.org/devguide/services/user-
provided.html
Service
Overview
The diagram below shows how the service plans listed in the SAP Discovery Center correspond to the plans you choose in the
SAP BTP cockpit , depending on the commercial model of your enterprise global account. For more information about the
commercial models offered by SAP, see Commercial Models.
Diagram captions: Service plans and environment plans in SAP BTP cockpit [Show/Hide]
The plan that the global account administrator can assign to a subaccount or a directory on the Entitlements page by choosing
Edit Add Service Plans .
Tip
Open image in new tab for the full-screen version.
This is custom documentation. For more information, please visit the SAP Help Portal 35
10/15/24, 3:53 PM
For more information about the procedure, see Configure Entitlements and Quotas for Subaccounts or Configure Entitlements and
Quotas for Directories.
The plan that the subaccount administrator can select on the Overview page of a subaccount when choosing Enable Cloud
Foundry.
Tip
Open image in new tab for the full-screen version.
Screenshot: Selecting an environment plan for the subaccount in SAP BTP cockpit [Show/Hide]
Note
An environment plan is a service plan associated with an environment. For more information about services and service plans,
see Entitlements and Quotas.
Service Plans
The tables below provide details about the plans for SAP BTP, Cloud Foundry runtime. They can give you more context for
understanding the diagram in the Overview section.
This is custom documentation. For more information, please visit the SAP Help Portal 36
10/15/24, 3:53 PM
Caution
With this plan, you get a
technical quota of 200 GB
of runtime memory per
Cloud Foundry org. This
doesn't mean that you can
use the runtime memory
for free. The technical
quota represents a limit on
how much runtime
memory all the spaces in
the org can use at any
given time. To increase this
limit, create a case on the
SAP Support Portal
using the component BC-
NEO-CIS.
Free Cloud Foundry free (Environment) free This is a free tier plan that
Environment allows you to try out and
(cloudfoundry) evaluate the service. For more
information, see Using Free
Service Plans.
This is custom documentation. For more information, please visit the SAP Help Portal 37
10/15/24, 3:53 PM
Note
Only community support is
available for free tier
service plans and these are
not subject to SLAs. Use of
free tier service plans is
subject to additional terms
and conditions as provided
in the Business Technology
Platform Supplemental
Terms and Conditions .
See SAP Build Code Cloud Foundry build-code build-code This plan is only for using the
Environment SAP BTP, Cloud Foundry
(cloudfoundry) runtime as part of SAP Build
Code. For more information,
see What Is SAP Build Code.
Note
The plan is not depicted on
the diagram in the
Overview section.
Standard Cloud Foundry Runtime MEMORY standard This is a paid plan for
(APPLICATION_RUNTIME) productive use. In the
subscription-based
commercial model, you pay
for runtime memory quota in
advance.
This is custom documentation. For more information, please visit the SAP Help Portal 38
10/15/24, 3:53 PM
See SAP Build Cloud Foundry Environment build-code build-code This plan is only for using the
Code (cloudfoundry) SAP BTP, Cloud Foundry
runtime as part of SAP Build
Code. For more information,
see What Is SAP Build Code.
Note
The plan is not depicted on
the diagram in the
Overview section.
Metrics
The table below provides details about the metrics for SAP BTP, Cloud Foundry runtime. It includes the names of services, with
which the metrics are associated on the pages Usage (accessed from the global account level) and Usage Analytics (accessed
from the subaccount level) in the SAP BTP cockpit.
Cloud Foundry GB Memory Temporary memory bank where For billing purposes, the metric GB Memory is
Runtime computers store data that needs to calculated as the total hourly usage of Cloud
be retrieved and processed quickly. Foundry runtime memory across all spaces in
the global account over a calendar month,
The memory represents the size of
divided by 730 hours and rounded up to the
the data that can be processed and
next full GB. For an example of such calculation,
CPU represents the speed at which
see Consumption Monitoring.
the data can be retrieved.
Note
In the Cloud Foundry environment,
applications get a guaranteed CPU share of
¼ core per GB of runtime memory quota
reserved for an application instance. For
more information, see SAP BTP-Specific
Configurations.
SAP Build Code CF Runtime The metric CF Runtime is intended only for
monitoring the usage of SAP BTP, Cloud
Foundry runtime when it's used as part of SAP
Build Code. For more information, see What Is
SAP Build Code.
This is custom documentation. For more information, please visit the SAP Help Portal 39
10/15/24, 3:53 PM
Note
The metric is not depicted on the diagram in
Service.
Service Specifics
In the context of SAP BTP, Cloud Foundry runtime, the terms consumption (or consume) and usage (or use) refer to the runtime
memory quota reserved by the platform for each application instance. This quota serves as the basis for calculating the billable
consumption, as explained in Consumption Monitoring.
Caution
From a billing standpoint, it doesn't matter how much of the reserved runtime memory quota is utilized when the application is
running. Billable consumption is calculated based on the full amount of runtime memory reserved, regardless of how much
runtime memory actually gets utilized.
Note
If an application is stopped, it doesn't reserve any runtime memory and, therefore, doesn't contribute to runtime memory
consumption.
There are two application settings that define how much runtime memory an application uses at any given time:
Runtime memory quota reserved for each application instance (default: 1024 MB)
You can specify custom values for these settings when deploying an application in the Cloud Foundry environment. You can also
change them for an application that has already been deployed without having to redeploy it.
How to set runtime memory quota and number of instances when deploying applications
Option 1: Create a manifest YAML file and specify the following application attributes:
You can then deploy your application with the manifest in one of two ways:
Option 2: In the SAP BTP cockpit, choose Deploy Application, deselect Use Manifest and specify the following:
Option 3: In the Cloud Foundry CLI, use the command cf push with the following flags:
This is custom documentation. For more information, please visit the SAP Help Portal 40
10/15/24, 3:53 PM
-m: runtime memory quota per application instance
How to change runtime memory quota and number of instances for already deployed applications
Option 1: In the SAP BTP cockpit, on the Overview page of the application you can:
Change the runtime memory quota per application instance under Change Instance Details Instance Memory
(MB)
Change the number of application instances as described in Add or Remove Application Instances
Option 2: In the Cloud Foundry CLI, you can use the command cf scale with the following flags:
You can use the Application Autoscaler to automatically increase or decrease the number of application instances based on the
policies you have defined. For more information, see What Is Application Autoscaler.
Tip
For tips on how to optimize the consumption of runtime memory, see the blog post Optimise your SAP BTP, Cloud Foundry
runtime costs . Note that while the general principles outlined in the blog post still apply, some of the UI texts and parameter
names may have changed.
For more information, see the section SAP BTP, Cloud Foundry Runtime in the SAP Business Technology Platform Service
Description Guide .
Glossary
ABAP Environment
Within the Cloud Foundry environment, you can create a new space for ABAP development. This is what we refer to as the ABAP
environment. It allows you to create extensions for ABAP-based products, such as SAP S/4HANA Cloud, and develop new cloud
applications. You can transform existing ABAP-based custom code or extensions to the cloud.
The ABAP environment is based on the latest ABAP platform cloud release that is also used for SAP S/4HANA Cloud. It leverages
the innovations provided by SAP HANA. The software stack contains standard technology components that are familiar from the
standalone Application Server ABAP. The ABAP environment supports the ABAP RESTful Application Programming Model
including SAP Fiori and Core Data Services (CDS). SAP services and APIs are offered according to the new approach of released
objects. The ABAP environment can be integrated with other SAP BTP services, such as SAP Destination service, SAP Build Work
Zone, standard edition, SAP Workflow Management, and SAP Interactive Forms by Adobe.
This is custom documentation. For more information, please visit the SAP Help Portal 41
10/15/24, 3:53 PM
Each ABAP system in the ABAP environment utilizes a dedicated SAP HANA database, which is provided by the SAP HANA Cloud
service and managed by the ABAP environment. The database is linked 1:1 to the ABAP system.
For information about regional availability, see Regions and API Endpoints for the ABAP Environment.
Related Information
Getting Started in the ABAP Environment
Development in the ABAP Environment
Administration and Operations in the ABAP Environment
Using Free Service Plans
Discovery Center
SAP Community
SAP Road Map Explorer
Learning Journey
Tutorials
Features
ABAP development tools for Eclipse enables you to perform ABAP-based development tasks, when you want to build, to extend,
and to run ABAP applications based on SAP products, such as SAP S/4HANA and SAP S/4HANA Cloud, private edition for classic
ABAP development as well as SAP BTP, ABAP environment and SAP S/4HANA Cloud for Cloud development.
ABAP development tools for Eclipse supports ABAP developers with the following possibilities:
Built-in extensibility of the IDE using the established Eclipse plug-in technology
In particular, ABAP development tools for Eclipse is a modern development toolset where ABAP developers can use, for example
the following features:
Syntax check
Code completion
Syntax highlighting
Pretty printing
This is custom documentation. For more information, please visit the SAP Help Portal 42
10/15/24, 3:53 PM
Navigation
Search
Quick fixes
The ABAP CDS Development Tools: User Guide describes the functionality and usage of tools for ABAP Core Data Services (CDS)
in the ABAP environment. It focuses on use cases for creating, editing, testing, and analyzing ABAP CDS entities.
Release Notes
ABAP development tools for Eclipse is released to customers in combination with the SAP BTP ABAP environment shipments.
Documentation in the context of ABAP Platform will be shipped in accordance with the relevant SAP product shipments.
The release notes are a general overview of the most significant changes relating to features of ABAP development tools for
Eclipse in the context of ABAP development and the ABAP programming models.
For more information, see Release Notes of ABAP Development Tools for Eclipse
FAQs
If you are an SE80 expert and new to ABAP development tools for Eclipse, the frequently asked questions (FAQs) enable you to
skim the features you want to perform in ADT.
For more information, see FAQs for SE80 Experts Using ADT
Installation
To install ABAP development tools for Eclipse, follow the Installation Guide. Alternatively, you may get ABAP development tools for
Eclipse from the SAP Development Tools page under the terms of the SAP DEVELOPER LICENSE AGREEMENT.
Support
The use of ABAP development tools for Eclipse is subject to the terms and conditions of your license agreement with SAP which is
directly related to the SAP shipment channel from whichABAP development tools for Eclipse was initially downloaded and
installed.
Service
This is custom documentation. For more information, please visit the SAP Help Portal 43
10/15/24, 3:53 PM
Overview
Note
For more information about consumption-based models, please check What is the Consumption-Based Commercial Model?
standard Standard Allows you to create projects for development, test, and
productive ABAP systems. The minimum system size is 2 HANA
Compute Units and 1 ABAP Compute Unit.
abap_compute_unit Standard Allows you to configure runtime memory, which refers to volatile
memory used during the execution of applications. This memory
provides fast read and write access but loses all data when the
system is restarted or shut down. The metric measures the
amount of runtime memory used in 16 GB blocks on an hourly
basis.
This is custom documentation. For more information, please visit the SAP Help Portal 44
10/15/24, 3:53 PM
saas_oem SaaS OEM Allows you to create projects for ABAP systems to run
multitenancy SaaS applications. The minimum system size is 2
HANA Compute Units and 1 ABAP Compute Unit.
16_abap_64_db (Deprecated) 16 GB Runtime and 64 GB This ABAP runtime service plan provides a 16 GB ABAP runtime
Persistence (Deprecated) with a 64 GB database. No additional sizing is possible.
Metrics
Metric Definition
Memory Temporary memory bank where computers store data that needs to be retrieve and
processed quickly.
The memory represents the size of the data that can be processed , and CPU represents the
speed at which the data can be retrieved.
Kyma Environment
SAP BTP, Kyma runtime provides a fully managed cloud-native Kubernetes application runtime based on the open-source project
"Kyma". Based on modular building blocks, Kyma runtime includes all the necessary capabilities to simplify the development and
to run enterprise-grade cloud-native applications.
This is custom documentation. For more information, please visit the SAP Help Portal 45
10/15/24, 3:53 PM
Kyma implements a dedicated application runtime to deploy highly scalable, robust, and secure containerized microservices.
Note
Kyma as a managed service automatically checks all Kyma-managed resources. Any unexpected modifications are discarded,
and the resource is reverted to the original state.
A Kubernetes cluster based on project "Gardener" on a cloud provider and region (data center) of your choice. To find out
the available regions and providers, see Regions for the Kyma Environment.
A set of Kyma modules picked by a user in the release channel of their choice installed on the provisioned cluster.
Integration
Every Kyma environment runs on a single Kubernetes cluster created for a specific subaccount. The configuration of the Kyma
environment enables you to connect it to a multitude of SAP systems. This way, you can build various formations that aggregate
the SAP systems and environment according to your business use cases.
SAP systems connected to a Kyma environment expose APIs and events. To extend the existing logic of these SAP services, you
can build serverless applications called “Functions”, and trigger them to react to particular events or calls to your application's API.
You can also use the Kyma environment to deploy microservices or even build full-stack applications.
Related Information
Getting Started in the Kyma Environment
Development in the Kyma Environment
Administration and Operations in the Kyma Environment
Security in the Kyma Environment
This is custom documentation. For more information, please visit the SAP Help Portal 46
10/15/24, 3:53 PM
Discovery Center
The modular approach boosts Kyma's extensibility and scalability and makes it more cost-effective. With fully modularized Kyma,
you can choose from many of its modules to facilitate your business needs best. You can add or delete modules on demand and
configure them, thus determining the costs generated by the infrastructure that your modules use.
You can decide which modules are needed for your workload, although some features may still require the presence of other
modules or related capabilities. For example, the API Gateway module depends on Istio capabilities, but it doesn't require the Istio
module from Kyma. Instead, the API Gateway module needs Istio custom resources, such as Gateway and VirtualService, to be
present in the cluster. If you want to use your own Istio installation, the API Gateway module will use it as soon as the required
resources are available.
Learn how to add a module under Add and Delete a Kyma Module.
Fast channel provides more frequent releases. It offers early previews of all new features and changes before they are
promoted to the regular channel. It also allows you to test and provide feedback on the new features sooner.
According to the Kyma modules` release cycle, we first release a new module's major or minor version in the fast channel. After
approximately two weeks, we promote the release to the regular channel.
Note
In case of important functionality fixes or critical vulnerabilities identified by our security organization, the timeline doesn't
apply, as we provide hotfixes between regular releases.
You can use one or both release channels in your Kyma cluster, but you can define only one release channel per module. For
example, you can mix different modules from the regular and fast channels in your development cluster, but you cannot deploy the
same module in the regular and fast versions in one cluster.
Note
You can upgrade module versions, but you cannot downgrade them. To test the upstream versions, you can switch a module or
an entire cluster from the regular channel to the fast one. To return to the regular channel, you must wait until the version you
are using in the fast channel is promoted to the regular channel. Once the versions in both the fast and regular channels are the
same, you can switch back to regular. Alternatively, you can delete and add your module from the regular channel.
This is custom documentation. For more information, please visit the SAP Help Portal 47
10/15/24, 3:53 PM
To find out which module version is running in your cluster, go to Kyma dashboard .
Release Notes
A release of a new module’s version is announced with a release note in What’s New for SAP Business Technology Platform for
both, the fast and regular channels:
On the day of the release in the fast channel, a release note is published with the Preview label.
After approximately two weeks, the module version becomes available in the regular channel and the Preview label is
removed.
Related Information
Kyma Functionalities
Kyma Modules
With Kyma's modular approach, you can install just the modules you need, instead of a predefined set of components.
You can choose to add any modules as required. To learn how, see Add and Delete a Kyma Module. To find out which module
version is running in your cluster, go to Kyma dashboard .
Tip
A release of a new module’s version is announced with a release note in What’s New for SAP Business Technology Platform for
both, the fast and regular channels:
On the day of the release in the fast channel, a release note is published with the Preview label.
When the module version becomes available in the regular channel (after approximately two weeks), the Preview label is
removed.
When you create Kyma runtime in SAP BTP cockpit, it is provisioned with the default modules added. The default modules are not
mandatory. If you don't need them, you can delete them in Kyma dashboard . See Add and Delete a Kyma Module.
Technical name
API Gateway API Gateway provides functionalities that allow you to kyma-project.io: API Gateway module
expose and secure APIs.
api-gateway
Istio Istio is a service mesh with Kyma-specific configuration. kyma-project.io: Istio module
istio
SAP BTP Operator Within the SAP BTP Operator module, BTP Manager installs Using SAP BTP Services in the Kyma
the SAP BTP service operator that allows you to consume Environment
btp-operator
This is custom documentation. For more information, please visit the SAP Help Portal 48
10/15/24, 3:53 PM
Technical name
SAP BTP services from your Kubernetes cluster using kyma-project.io: SAP BTP Operator
Kubernetes-native tools. module
Technical name
Application Connector Application Connector allows you to connect with external kyma-project.io: What is Application
solutions. No matter if you want to integrate an on-premise Connectivity in Kyma?
application-connector
or a cloud system, the integration process doesn't change,
GitHub repository: Application
which allows you to avoid any configuration or network-
Connector Manager
related problems.
Keda The Keda module comes with Keda Manager, an extension kyma-project.io: Keda module
to Kyma that allows you to install KEDA (Kubernetes
keda
Event Driven Autoscaler).
Serverless With the Serverless module, you can define simple code Deploy Workloads in the Kyma
snippets (Functions) with minimal implementation effort. Environment to Extend SAP Systems
serverless
kyma-project.io: What is Serverless in
Kyma?
kyma-project.io: Serverless
Configuration
Telemetry The Telemetry module collects application logs and Kyma Telemetry Module
distributed traces for your application, and dispatches them
telemetry What's New for Telemetry
to your preferred backends.
NATS NATS deploys a NATS cluster within the Kyma cluster. You kyma-project.io: NATS module
can use it as a backend for Kyma Eventing.
nats GitHub repository: NATS
Eventing Eventing provides functionality to publish and subscribe to Configure SAP Event Mesh for Kyma
CloudEvents. Eventing
eventing
At the moment, the SAP Event Mesh default plan and NATS kyma-project.io: Eventing module
are supported. If you choose NATS, add the NATS module.
GitHub repository: Eventing
Technical name
Transparent Proxy Use the transparent proxy for Kubernetes to connect Transparent Proxy in the Kyma
workloads in a Kubernetes cluster to Internet and on- Environment
transparent-proxy
premise applications.
Connectivity Proxy Use the connectivity proxy for Kubernetes to connect On-Premise Connectivity in the Kyma
workloads in a Kubernetes cluster to on-premise systems, Environment
connectivity-proxy
exposed via the Cloud Connector.
Kyma Functionalities
SAP BTP, Kyma runtime and open source project "Kyma" offer slightly different functionalities and install a different set of
components.
For all functionalities that the Kyma environment offers, see the official project "Kyma" documentation .
Functionality Comparison
Managed Kubernetes
Managed Kyma
Note
For an overview of the basic Kubernetes concepts that the Kyma environment heavily relies on, see the official Kubernetes
documentation .
This is custom documentation. For more information, please visit the SAP Help Portal 50
10/15/24, 3:53 PM
Concept Description
Kyma cluster A Kubernetes cluster provisioned with the latest version of the open-source project "Kyma". You can enable such a
cluster on a given subaccount through the SAP BTP cockpit. After creating a Kyma environment instance on your
subaccount, the cluster is provisioned automatically through Gardener on your chosen cloud service provider. To access
the cluster, you must have appropriate roles assigned to your subaccount.
Kyma module An extension to the Kyma environment that can be added, deleted, or re-configured at runtime.
Role Access to every cluster is managed by the roles assigned. Roles give the assigned users a different level of permissions
suitable for different purposes. For more information, read Assign Roles in the Kyma Environment.
Namespace Namespaces are used to organize objects in a cluster and provide a way to divide cluster resources. This way, several
users can share a cluster but have access only to resources within the namespace they have permissions for. This allows
for increasing the security and organization of your cluster by dividing it into smaller units. Access to namespaces in the
Kyma environment depends on your Kubernetes RBAC permissions.
Service A service operator is a piece of software that provides a set of all necessary resources (such as
operator CustomResourceDefinitions and controllers) needed to provision third-party services in your Kubernetes cluster.
Binding The connection you create between a service instance and an SAP solution so that they can communicate with each
other. You can also bind a service instance to any workload running in the Kyma environment, such as a Function or a
microservice.
Credentials / Sensitive data necessary for an SAP solution to call the service, connect to it, and authenticate it. Depending on whether
Secrets you use Kyma dashboard or kubectl to create the binding between a service instance and an SAP solution, the
Kubernetes Secret object that contains these credentials is either created automatically or you need to create it
manually.
Function A simple code snippet that you can run without provisioning or managing servers. It implements the exact business logic
you define. A Function is based on the Function custom resource and can be written in either Node.js or Python. A
Function can perform a business logic of its own. You can also bind it to an instance of a service and configure it to be
triggered whenever it receives a particular event type from the service or a call is made to the service's API. Functions
are executed only if they are triggered by an event or an API call.
Microservice An architectural variant for extensions or applications, where you separate the tasks into smaller pieces that interact
with each other as loosely coupled, independently deployable units of code. A failing microservice should not cause your
whole application to fail. Microservices are packed in a container that is always running; it's idling if there is no load. The
microservice should always be reachable even when the Pods move around. Microservices typically communicate
through APIs.
Service
Overview
This is custom documentation. For more information, please visit the SAP Help Portal 51
10/15/24, 3:53 PM
Note
For more information, see What is the Consumption-Based Commercial Model?
free Free Subscribe to the 30-day free plan provided on Amazon Web
Services. This plan uses Kyma on a limited size cluster (4 CPU -
16 GB RAM). The upgrade to the paid plan is not yet supported.
Only best-effort support is available for free tier service plans and
these are not subject to SLAs. The services you plan to use must
be available in the same region as the subaccount for the Kyma
runtime.
aws Standard Select Amazon Web Services as the cloud provider where your
Kyma cluster is deployed.
gcp Standard Select Google Cloud as the cloud provider where your Kyma
cluster is deployed.
azure Standard Select Microsoft Azure as the cloud provider where your Kyma
cluster is deployed.
Metrics
The usage metric for the Cloud Service is a Capacity Unit (CU) per month.
This is custom documentation. For more information, please visit the SAP Help Portal 52
10/15/24, 3:53 PM
Metric Definition
Capacity Unit Number of units consumed by the usage of the services as outlined in the solution-specific
product supplement.
For SAP BTP, Kyma runtime, there are two capacity units: one to measure the workload, the
second to measure the storage.
Backward Calculation
Formula
However, cost per monthly bill may vary because it depends on the size of the nodes that were used. There is no fixed formula
because of Kyma's flexible scaling.
Underlying Metrics
For CPU
2 0.48055555555555557 x 0.75
4 0.48055555555555557
8 0.48055555555555557 x 2
16 0.48055555555555557 x 4
32 0.48055555555555557 x 8
... ...
For Storage
1GB 0.00056423611
Examples
Your bill for Nodes shows 1800 capacity units charged for 4vCPU Nodes in a month.
This means that you were running roughly 1800 / 0.4806 = 3745.32 hours worth of 4vCPU nodes. Given that a month has
720 hours, this means you were running 3745.32/720 = 5.2 Nodes cluster for a full month.
Due to Kyma’s automatic scaling, 5.2 does not mean actual size. It means that during some hours in the month, the cluster
size was 4 nodes. At other times, there was more load, so the cluster autoscaled to 5 or 6 nodes, based on your
configurations. So your average cluster size for the full month was 5.2 Nodes.
Your bill for storage shows 200 capacity units charged for storage (32GB block) for the month.
This is custom documentation. For more information, please visit the SAP Help Portal 53
10/15/24, 3:53 PM
This means that you used 200 / 0.0181 = 11049.72 hours of 32GB storage blocks. Given that a month has 720 hours, this
means that you have used 11049.72/720 = 15,34 blocks of 32GB over the month. So, you used 15.34 * 32 = 491GB of
storage continuously during the month.
This implies that as you started using Kyma, you deployed more applications that used storage of various sizes, such as
4GB or 8GB.
Note that storage is provided in blocks of 32GB, so if you used 33 GB, you would be charged for 2 * 32GB, that is 64 GB.
Calculator
Find the Kyma price calculator on https://kyma-project.github.io/price-calculator/ and use it to estimate the costs for your
SAP BTP, Kyma runtime.
Note that the result is an estimate, and the monthly bill may vary depending on the actual hours and size of the Kyma cluster
(workload and storage) that was running in a month.
Glossary
Service Specifics
As soon as you instantiate a Kyma cluster, the basic costs for the empty cluster incurs.
Cost may then vary depending on the actual workloads and storage you consume per month.
Neo Environment
The Neo environment lets you develop HTML5, Java, and SAP HANA extended application services (SAP HANA XS) applications.
You can also use the UI Development Toolkit for HTML5 (SAPUI5) to develop rich user interfaces for modern web-based business
applications.
See also:
This is custom documentation. For more information, please visit the SAP Help Portal 54
10/15/24, 3:53 PM
Security, Neo Environment
Pay-As-You-Go or CPEA accounts with free tier service plans are open to customers, partners, and let you try out SAP
BTP in a per service defined time span for free. These account types enable you to test your scenarios and generally offer
the option to upgrade to paid service plans. These accounts also allow you to store data long-term and move projects to
production. You also get access to our community, including free technical resources such as tutorials and blog posts. For
more information, see Enterprise Accounts and Using Free Service Plans.
You can self-register for an enterprise account with free tier service plans. For more information, see Get an Account on
SAP BTP to Try Out Free Tier Service Plans .
Note
Only community support is available for free tier service plans and these are not subject to SLAs.
Note
The option to upgrade from free tier service plans to paid service plans is not yet available for all services and runtimes,
such as Kyma. See Using Free Service Plans to read more about upgrading from free tier service plans to paid service
plans.
A trial account lets you try out SAP BTP for free for 90 days. The services provided for the trial account allow restricted use
of the platform resources and services. Access is open to everyone. Trial accounts are intended for personal exploration,
your own non-productive testing, and evaluation of the services in accordance with SAP BTP trial terms and conditions .
A SAP BTP trial account must not be used for production use or team development. You are not permitted to use the trial
account in any productive or commercial manner.
You can self-register for a trial account. For more information on how to do that, see Get a Free Account on SAP BTP Trial
Free Tier and Always Free Tags in the SAP Discovery Center
In the SAP Discovery Center service catalog overview , some services display the tag Free Tier, which indicates the service is
offering a free tier service plan. Some services display the tag Always Free, which indicates the service is offering a service plan
that comes free of additional charges, as it is already included in your overall SAP BTP contract. You can use the filter function of
the SAP Discovery Center to filter for services that offer Free Tier and Always Free plans. The Always Free service plans include
the following note in their service plan description: "This service plan is included in the overall SAP Business Technology Platform
contract".
This is custom documentation. For more information, please visit the SAP Help Portal 55
10/15/24, 3:53 PM
Note
Always Free service plans might not be available in all regions or for all providers.
Trial Lifecycle
Familiarize yourself with the Trial Scope or try out one of our Starter Scenarios on the Tutorial Navigator .
Your 90-day trial period is divided in intervals. If you sign in to your trial account regularly, the intervals are extended
automatically for you by up to 30 days or until your overall 90-day trial is finished.
If you don't sign in to your trial account for 30 days or more, your account will be suspended. All suspended
accounts will be deleted and you won't be able to use applications or services.
After 90 days, your trial account is automatically deleted. But if you want to proactively delete your SAP BTP trial
account, you can navigate to the global accounts scope and select the Account Explorer page, then click the Delete
Trial Account button.
If you want to continue to use an SAP BTP trial account after deletion, you need to set up a new account.
If you want to explore SAP BTP without time limit, create an enterprise account with free tier service plans
allowing you to test your scenarios. See: Get an Account on SAP BTP to Try Out Free Tier Service Plans .
Caution
Environments enabled on your trial account may not be valid for your whole trial period. To learn about the validity period for
the Kyma environment, see About the Trial Account.
Trial Scope
A trial account enables you to explore the basic functionality of SAP BTP.
SAP BTP trial accounts use cloud management tools feature set B. For more information, see Cloud Management Tools —
Feature Set Overview.
SAP BTP trial accounts are available in several regions. For more information, see Regions.
You can create directories in your trial account. For more information, see Managing Directories Using the Cockpit
You can use productive and beta services. To consume beta services, you must enable the subaccount for beta features
during the subaccount creation or when you edit the subaccount details.
You can manage platform users by assigning them role collections. For more information, see Working with Role
Collections.
You can use 2 configured on-premise systems with the Cloud connector.
There’s no service level agreement with regards to the availability of the platform.
This is custom documentation. For more information, please visit the SAP Help Portal 56
10/15/24, 3:53 PM
You can use HDI containers in a shared SAP HANA database (only available on cf-us10).
For cleanup purposes, applications stop automatically on a daily basis. You need to manually restart them when needed.
Note
Applications are stopped at midnight (or some time later depending on server load) relative to the region in which you
created your trial account. If you're working in a time zone that is far from the region where your trial account was
created, then your applications may stop during business hours.
You can have a trial tenant of SAP Cloud identity Services, see Get Your Tenant.
Related Information
Getting Started with a Trial Account in the Cloud Foundry Environment
Getting Started with a Trial Account in the Kyma Environment
Enterprise Accounts
Enterprise accounts are usually associated with SAP customer or partner contracts and contain their purchased entitlements to
platform resources and services. However, it's also possible to create an enterprise account for personal exploration.
SAP BTP provides different types of global accounts, enterprise and trial. The type you choose determines pricing, conditions of
use, resources, available services, and hosts.
If you want to start out using services for free, you can create a trial account and only use free tier service plans: The major benefit
of using such an account for exploration purposes is that you can upgrade your services to productive use without losing any of
your data. Check out the Free Tier Services in SAP Discovery Center and learn the details about Using Free Service Plans in your
enterprise account.
Another way to start out using services for free is to create a trial account. But keep in mind that when you want to use your global
account productively, there’s no way to migrate your data from the trial account to a productive enterprise account. For more
information, see Trial Accounts and Free Tier.
Enterprise Accounts
The main features of enterprise accounts are described for use by customers and by partners in the following table:
Use case A global account that enables you to host productive, A global account that enables you to build
business-critical applications with 24/7 support. applications and to sell them to your customers.
You can purchase a global account just like any other If you want to start out exploring services for free,
SAP software. You can upgrade and refine your you can sign up for a Pay-As-You-Go for SAP BTP
resources later on. You can also contact your SAP global account and make use of the free tier services
sales representative and opt for a configuration, only. See Using Free Service Plans.
tailored to your needs.
This is custom documentation. For more information, please visit the SAP Help Portal 57
10/15/24, 3:53 PM
Limitations Resources according to your contract. Predefined resources according to your partner
package. You can purchase additional resources if
necessary.
Registration For more information about SAP Integration Suite Sign up to join the SAP Partner Program .
and SAP Extension Suite pricing, see
https://www.sap.com/products/extension-
suite/pricing.html and
https://www.sap.com/products/integration-
suite/pricing.html .
For the commercial models available for enterprise accounts, see Commercial Models.
Related Information
Getting Started in the Kyma Environment
Getting Started with a Customer Account in the ABAP Environment
Getting Started with an Enterprise Account in the Cloud Foundry Environment
Commercial Models
SAP BTP offers two different commercial models for enterprise accounts.
This is custom documentation. For more information, please visit the SAP Help Portal 58
10/15/24, 3:53 PM
Consumption-based commercial model: Your organization receives access to all current and future services that are
eligible for this model. You have complete flexibility to turn services on and off and to switch between services as your
business requires throughout the duration of your contract. This commercial model is available in the following flavors: SAP
BTP Enterprise Agreement (SAP BTPEA), Cloud Platform Enterprise Agreement (CPEA), and Pay-As-You-Go for SAP BTP.
Subscription-based commercial model: Your organization subscribes only to the services that you plan to use. You can
then use these services at a fixed cost, irrespective of consumption.
Note
You can use both commercial models, either in separate global accounts or in the same global account depending on your
business needs. Contact your SAP account executive or sales representative for more information. Note however that you
cannot mix more than one flavor of the consumption-based commercial model in the same global account.
For information about service availability, prices, and estimators, see https://www.sap.com/products/technology-
platform/solutions.html and https://www.sap.com/products/technology-platform/integration-suite/pricing.html . You can
also view the service catalog via the SAP Discovery Center .
With the consumption-based model, your organization purchases an entitlement to all current and future SAP BTP services that
are eligible for this model. Throughout the duration of your contract, you have complete flexibility to turn services on and off and to
switch between services as your business requires.
The consumption-based commercial model is available in the following flavors: the SAP BTPEA (SAP BTP Enterprise Agreement),
the CPEA (Cloud Platform Enterprise Agreement), and Pay-As-You-Go for SAP BTP. Each option is suited to different business
This is custom documentation. For more information, please visit the SAP Help Portal 59
10/15/24, 3:53 PM
situations and levels of financial commitment, as described in the table below. For additional information and clarifications, please
contact your account executive.
You get access to new SAP BTP services that are added to
the consumption-based service catalog.
Pay-As-You-Go for SAP BTP You have the same access to all the services that are
available in SAP BTPEA, but with a highly flexible zero-
commitment model – you pay nothing upfront and there is
no minimum usage requirement or annual commitment.
You pay only for the SAP BTP services that you want, when
you use them.
This is custom documentation. For more information, please visit the SAP Help Portal 60
10/15/24, 3:53 PM
Service charges are non-discountable.
If you want information about the Pay-As-You-Go for SAP BTP for
cloud test, demo, and development commercial model , go to the
SAP Partner Portal .
Note
In global accounts that use the consumption-based commercial model, SAP BTP, Cloud Foundry runtime is not listed in
the Entitlements pages in the SAP BTP cockpit. A technical limit of 200 GB of Cloud Foundry runtime memory is
assigned by default to every subaccount. The limit defines the maximum amount of runtime memory that can be used
in the subaccount. Note that the “Standard” plan in the consumption-based commercial model is a paid plan and that
you are billed based on the amount of Cloud Foundry runtime you consume. For more information on consumption
monitoring, see Consumption Monitoring.
If you need to increase this limit, report an incident to SAP support on the BC-NEO-CIS component. This also applies
to other services that have a technical quota limit.
Tip
You can monitor costs and service usage throughout the contract period. See Monitoring Usage and Consumption Costs in
Your Global Account.
As part of the free tier model for SAP BTP, some services offer free service plans that allow you to try out these services without
any additional charge within your SAP BTPEA, CPEA, or Pay-As-You-Go for SAP BTP global account. For more information, see
Using Free Service Plans.
To find frequently asked questions about the consumption-based commercial model, see the Frequently Asked Questions section
in https://www.sap.com/products/technology-platform/pricing.html .
Note
Depending on your business needs, you can combine the consumption-based commercial model with the subscription-based
commercial model in the same global account, or you can use both commercial models in the same global account. Contact
your SAP account executive or sales representative for more information. Note however that you cannot mix more than one
flavor of the consumption-based commercial model in the same global account.
Related Information
What Is the Subscription-Based Commercial Model?
Monitoring Usage and Consumption Costs in Your Global Account
View Subaccount Usage Analytics
Managing Global Accounts Using the Cockpit
This is custom documentation. For more information, please visit the SAP Help Portal 61
10/15/24, 3:53 PM
Managing Directories Using the Cockpit
Managing Subaccounts Using the Cockpit
Managing Entitlements and Quotas Using the Cockpit
To access additional services, at an extra cost, you can modify your contract via your sales representative or account
executive.
Your organization can renew the subscription at the end of the contract period.
For information about available services and pricing, see SAP Store .
You can also access the SAP BTP service catalog via the SAP Discovery Center to identify the availability of services by data
center, and also to determine licensing model compatibility per service plan.
Note that some services can be subscribed based on a user metric or a resource metric. For example, a Portal service can be
based on the number of site visits or user metrics. A resource-based metric is more common when dealing with a large number of
users; for example, suppliers accessing a portal to interact with your organization. Since it isn't always possible to predict how
many resources would be required upfront for a three-year period, you can increase your original order if resource usage exceeds
your subscribed quota. Using SAP BTP cockpit, you can view resource consumption within your global account on a monthly basis.
In the subscription-based model, you also get access to bundles or packages that comprise several related services and apps.
Most of the time, this works out to be more cost effective when compared to subscribing to individual SAP BTP services.
Note that you can use both consumption and subscription-based commercial models either in separate global accounts or in the
same global acccount depending on your business needs. Contact your SAP account executive or sales representative for more
information.
Related Information
What Is the Consumption-Based Commercial Model?
Monitoring Usage and Consumption Costs in Your Global Account
View Subaccount Usage Analytics
Managing Global Accounts Using the Cockpit
Managing Directories Using the Cockpit
This is custom documentation. For more information, please visit the SAP Help Portal 62
10/15/24, 3:53 PM
Managing Subaccounts Using the Cockpit
Managing Entitlements and Quotas Using the Cockpit
We offer free service plans for many services within SAP BTP. Free service plans are limited in scope and capacity. They are
designed to allow you and your team to explore new SAP BTP capabilities before committing to subscribing to a full capacity paid
service.
The free tier model for SAP BTP is added automatically to new and existing contracts using the consumption-based commercial
model. There, the free service plans are visible.
Note
The use of the consumption-based commercial model is subject to its availability in your country or region.
The consumption-based commercial model is available in the following flavors: the SAP BTPEA (SAP BTP Enterprise Agreement),
the CPEA (Cloud Platform Enterprise Agreement) and Pay-As-You-Go for SAP BTP. For more information, see What Is the
Consumption-Based Commercial Model?.
To try out services that participate in the free tier model for SAP BTP, create a service instance using the Free service plan offered
by the service.
Tip
To find out which services offer the free plans, see Discover Free Services. Here, you also find information on how to identify the
technical limitations of the free plan of each service. Access Free Services by assigning entitlements to subaccounts and
creating service instances.
Once you reach the technical limits of a service and want to continue using it, you must move to a paid service plan. Upgrading an
existing service instance from free tier to paid usually doesn't require creating a new service instance. Find out how to upgrade a
service plan at Upgrade to a Paid Service Plan.
Use of free tier service plans is subject to additional terms and conditions as provided in the Business Technology Platform
Supplemental Terms and Conditions Only community support is available for Free service plans and these aren't subject to
SLAs.
Free Tier services can be explored in the service catalog of SAP Discovery Center. A free tier service appears as a "Free" plan
offering for a service.
This is custom documentation. For more information, please visit the SAP Help Portal 63
10/15/24, 3:53 PM
On this page, you can see all available plans for this service, including the limitations of each plan. Plans that participate in
the free tier model for SAP BTP are labeled Free.
Note
The free tier model for SAP BTP is available for accounts that use the consumption-based commercial model.
2. Configure entitlements for the subaccount in which you want to use the free service plans. Select the service and choose
the free plan.
For more information, see Managing Entitlements and Quotas Using the Cockpit.
4. Find the service you want to try out and select it.
You find a description of the available service plans, including the free service plan. By clicking More, you find the scope and
limitations of the free plan for this service.
5. Create an instance of the service and select the free service plan.
For more information, see View and Manage Services from the Service Marketplace.
This is custom documentation. For more information, please visit the SAP Help Portal 64
10/15/24, 3:53 PM
Note
The option to upgrade from free tier service plans to paid service plans is not yet available for all services and runtimes, such as
Kyma. To use a paid service plan for Kyma runtime, you will need a new Kyma cluster. It is possible to have both - free and paid
clusters - in parallel.
Note
To update the ABAP environment to a paid service plan, you first need to configure entitlements and quotas for the ABAP
environment. You need at least the following entitlements assigned to your subaccount:
quota plans:
1 abap_compute_unit
2 hana_compute_unit
For more information, see Increasing the Quota for the ABAP Environment.
Note
It's not possible to switch from a paid plan to a free plan.
2. Find the instance of the service and click (Actions) and Update.
3. In the Update Instance dialog, change the plan to a paid service plan.
You can now use the service without the limitations of the free service plan.
Scope
The free tier model for SAP BTP is available for CPEA and Pay-As-You-Go for SAP BTP contracts. For more information, see
What Is the Consumption-Based Commercial Model?.
Services using the free tier service plans run on the same platform as paid services.
Services are technically limited. This limit depends on the service. You can find a description of the service plans in the
Service Marketplace in the cockpit or in the SAP Discovery Center .
Account Model
Learn more about the different types of accounts on SAP BTP and how they relate to each other.
This is custom documentation. For more information, please visit the SAP Help Portal 65
10/15/24, 3:53 PM
To learn more about managing your account model, see Account Administration.
Global Accounts
A global account is the realization of a contract you or your company has made with SAP.
A global account is used to manage subaccounts, members, entitlements and quotas. You receive entitlements and quotas to use
platform resources per global account and then distribute the entitlements and quotas to the subaccount for actual consumption.
There are two types of commercial models for global accounts: consumption-based model and subscription-based model. See
Commercial Models .
Global accounts are region- and environment-independent. Within a global account, you manage all of your subaccounts, which in
turn are specific to one region.
Subaccounts
Subaccounts let you structure a global account according to your organization’s and project’s requirements with regard to
members, authorizations, and entitlements.
A global account can contain one or more subaccounts in which you deploy applications, use services, and manage your
subscriptions. Subaccounts in a global account are independent from each other. This is important to consider with respect to
security, member management, data management, data migration, integration, and so on, when you plan your landscape and
overall architecture.
Each subaccount is associated with a region, which is the physical location where applications, data, or services are hosted. The
specific region is relevant when you deploy applications and access the SAP BTP cockpit using the corresponding cockpit URL.
The region assigned to your subaccount doesn't have to be directly related to your location. You could be located in the United
States, for example, but operate your subaccount in Europe.
The entitlements and quotas that have been purchased for a global account have to be assigned to the individual subaccounts.
Global accounts and subaccounts are completely independent of user accounts. For more information, see User and Member
Management.
This is custom documentation. For more information, please visit the SAP Help Portal 66
10/15/24, 3:53 PM
Subaccounts, Cloud Foundry Orgs and Kyma Clusters
When you enable the Cloud Foundry environment in one of your subaccounts, the system automatically creates a Cloud
Foundry org for you. The subaccount and the org have a 1:1 relationship and the same navigation level in the cockpit (even
though they may have different names). You can create spaces within that Cloud Foundry org. Spaces let you further break
down your account model and use services and functions in the Cloud Foundry environment.
For more information about Cloud Foundry orgs and spaces, see the Cloud Foundry documentation at
https://docs.cloudfoundry.org/concepts/roles.html .
When you enable the Kyma environment in one of your subaccounts, the system automatically creates a Kubernetes
cluster equipped with the latest version of the open-source project "Kyma" for you. The subaccount and the Kyma cluster
have a 1:1 relationship. You can create namespaces within that Kyma cluster. Namespaces let you further break down your
account model and use services and functions in the Kyma environment. For more information, see the Kubernetes
documentation at https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ .
Directories
With directories, you can organize and manage your subaccounts according to your technical and business needs.
A directory can contain directories and subaccounts to create a hierarchy. Using directories to group other directories and
subaccounts is optional - you can still create subaccounts directly under your global account.
You can create a hierarchical structure that is up to 7 levels deep. The highest level of a given path is always the global account and
the lowest is a subaccount, which means that you can have up to 5 levels of directories between the global account and the lowest
level subaccount.
This is custom documentation. For more information, please visit the SAP Help Portal 67
10/15/24, 3:53 PM
Monitor usage and costs for contracts that use the consumption-based commercial model
Optionally, you can also enable the following features in your directories:
Manage Entitlements: Enables the assignment of a quota for services and applications to the directory from the global
account quota, for distribution to the directory's subaccounts.
When you assign entitlements to a directory, you express the entitlements and maximum quota that can be distributed
across its children subaccounts. You also have the option to choose the auto-assignment of a set amount of quota to all
subaccounts created or moved to that directory. Subaccounts that are already in the directory when you select that option
will not be auto-assigned quota.
Note
If you've enabled the Manage Entitlements feature for a given directory, you must first assign the necessary
entitlements and maximum allowed quota from the global account to that directory. Then you can distribute this
"reserved" quota to any of the directory's child subaccounts.
Manage Authorizations: Enables authorization management for the directory. For example, it allows certain users to
manage directory entitlements. You can only use this feature in combination with the Manage Entitlements feature.
Related Information
Manage the Account Explorer Hierarchy
Configure Entitlements and Quotas for Directories
Configure Entitlements and Quotas for Subaccounts
Getting a Global Account
Setting Up Your Account Model
Managing Global Accounts Using the Cockpit
Managing Directories Using the Cockpit
Managing Subaccounts Using the Cockpit
Working with Global Accounts, Directories, and Subaccounts Using the btp CLI
Account Administration Using APIs of the SAP Cloud Management Service
This is custom documentation. For more information, please visit the SAP Help Portal 68
10/15/24, 3:53 PM
The hierarchical structure of global accounts and subaccounts lets you define an account model that accurately fits your business
and development needs. For example, if you want to separate development, testing, and productive usage, you can create a
subaccount for each of these scenarios in your global account. You can also create subaccounts for different development teams
or departments in your organizations.
For more information about the relationship between a global account and its subaccounts, see the graphic in Basic Platform
Concepts. For best practices, see Setting Up Your Account Model.
Note
The content in this section is only relevant for cloud management tools feature set B. For more information, see Cloud
Management Tools - Feature Set Overview.
The hierarchical structure of global accounts, directories, and subaccounts lets you define an account model that accurately fits
your business and development needs. For example, if you want to separate development, testing, and productive usage for
different departments in your organization, you can create a directory for each department, and within each directory, you group
subaccounts for development, testing, and production.
Labels
Labels are user-defined words or phrases that you can assign to various entities in SAP BTP to categorize them in your global
account, to identify them more easily.
For example, in the Account Explorer page in the cockpit, you can quickly filter for directories and subaccounts by label.
You can assign labels to these entities when you create or edit them using the SAP BTP cockpit, command line interface (btp CLI),
or REST APIs:
Directories
Subaccounts
Service instances
Environment instances
This is custom documentation. For more information, please visit the SAP Help Portal 69
10/15/24, 3:53 PM
Note
For environment instances, these custom labels are user defined and apply only to SAP BTP. They are not the same
labels that might be defined by your environment broker.
Labels are made up of a label name (also referred to as a key) and up to 10 values associated with the label. You can apply label
names and values in any way that suits your business and technical needs.
Multi-value labels make them useful for labels that typically have
Label Name: Contacts
more than one value assigned to them.
Labels can also be assigned with a name only and no value. In such
Label Name: For demo only
cases, the label behaves like tag.
Note that currently for service instances, labels must have at least Label Name: Audited
value.
Label Name: Flagged for deletion
Note
Labels replace what were previously called "custom properties". Custom properties supported only single values per label and
were available only to directories and subaccounts. As a result of the move to labels, all relevant commands in the SAP BTP
command line interface (btp CLI) and in the relevant REST APIs in the SAP Cloud Management service have been updated
accordingly. The custom-properties parameter in the btp CLI and the customProperties field in the relevant REST APIs
are deprecated.
You can assign labels when you create an entity, and then later add, change, or remove labels by editing the entity.
Tip
In the Account Explorer and Instances and Subscriptions pages in the SAP BTP cockpit, assigned labels are shown in
the Labels column. To display the column if it is not shown, click (Configure Table Columns).
In the Account Explorer page, you can view the labels that are assigned to a directory or subaccount by choosing the
More Info option of each directory and subaccount.
Assigned labels are also listed under the Labels tab when you display the Overview page of every directory and
subaccount.
This is custom documentation. For more information, please visit the SAP Help Portal 70
10/15/24, 3:53 PM
In the Account Explorer and Instances and Subscriptions pages, you can filter the displayed entities by their assigned
labels in the Search field.
In the Instances and Subscriptions page, you can also view the labels that are assigned to a subscription or instance by
expanding its details panel.
You cannot add the same label name more than once to the same entity.
Existing label names and values are offered as suggestions when you or anyone else assigns a label to other entities of the
same type in your global account.
When you view a subaccount in the cockpit, the subaccount also shows the labels that are assigned to its parent directory
and to other directories that are above it in the same path in your account structure. And in the Account Explorer, when you
filter by labels that are assigned to a directory, the subaccounts in that directory path are also listed. We refer to these as
inherited labels.
Label names and values are case-sensitive, which means you can create variants of the same label name with a different
casing; for example, My Label and My label can coexist as separate labels. We recommend that you avoid using
different casing or styling to create variants of the same names or values.
Related Links
Create a Subaccount
Create a Directory
Managing Service Resources Using the APIs of the SAP Service Manager
Each service has one or more service plans available. A service plan is the representation of the costs and benefits for a given
variant of a particular service. For instance, a database may be configured with various "T-shirt sizes", each of which is a different
service plan.
This is custom documentation. For more information, please visit the SAP Help Portal 71
10/15/24, 3:53 PM
Entitlements
An entitlement is your right to provision and consume a resource. In other words, entitlements are the service plans that you're
entitled to use.
Quotas
A quota represents the numeric quantity of a service plan that you're entitled to consume in your global account and its
subaccounts.
From the perspective of your SAP BTP global account contract, the global quota of a service plan can be defined as either fixed or
unlimited:
Fixed quota: The quota or allowance of the service plan is the upper limit at which the plan can be consumed collectively
across your global account. This is typical of global accounts that have the subscription-based commercial model
agreement.
Unlimited quota: There is no upper limit to how much the service plan can be used collectively across your global account.
This is typical of most services that are eligible to global accounts with a consumption-based commercial model
agreement (Cloud Platform Enterprise Agreement (CPEA) and Pay-As-You-Go for SAP BTP). At the end of the month, the
number of units used determines how much you are charged.
Regardless of whether the global quota of a plan on the global account level is fixed or unlimited, the specifics and properties of
each plan determines how its quota can be distributed by the global account admin to the subaccounts in your global account.
There are two types of quota assignments:
Numeric assignments: The global account admin assigns the plan to a subaccount and specifies the maximum quantity of
units from the global quota that can be consumed by the subaccount. Admins can use this assignment to limit users from
exceeding a specific quota for cost-controlling purposes. Typically, but not always, the assigned quota is directly related to
the number of instances that can be created in subaccounts for the assigned plan.
Non-numeric assignments: The global account admin does not assign a specific quantity but simply grants access to the
specific plan by assigning the plan to the subaccount. When the plan is assigned, it's available for use by the subaccount.
SaaS application assignments are typically non-numeric, whereby a subaccount can either subscribe to the app or not. For
services that fall into this category of non-numeric assignments, there is usually no limit to the number of instances that
can be created.
See also the sections below and Managing Entitlements and Quotas Using the Cockpit.
This is custom documentation. For more information, please visit the SAP Help Portal 72
10/15/24, 3:53 PM
Tip
You can also distribute entitlements to directories, and then redistribute to the subaccounts under the directories; however,
this is optional. By default, directories are not enabled to manage entitlements. This feature needs to be enabled per directory
by the global account administrator.
When assigning entitlements and quotas to directories, you also have the option to automatically assign a set amount of quota to
each new subaccount added to the directory. This option doesn’t apply to subaccounts that are already in the directory when you
select this option. The quota you assigned to the directory is then gradually distributed to all subaccounts that you add to that
directory, until it runs out. Once the directory quota runs out, if you add a new subaccount to that directory it won't get any quota
automatically anymore.
Since directories are only a way of grouping subaccounts, you can't consume a service at directory level. However, when you assign
entitlements and quotas from the global account to a directory, the quota you assigned is shown as used, even if there are no
subaccounts in that directory to consume the quota. You can think of it as a way to "reserve" quota and make sure it's not assigned
to other subaccounts or directories.
When you remove quotas or assignments from a directory or subaccount, they become available again at global account level and
can be assigned to other directories or subaccounts; unless the quota is reserved for a given directory then the freed quota
remains available only to that directory and its subaccounts.
Note
Before a subaccount admin can enable a quota-based environment, such as Kyma, the subaccount admin must first assign the
environment as an entitlement to the subaccount. Other environments, such as Cloud Foundry, are available by default to all
subaccounts, and therefore are not available as entitlements.
Quota Plans
In the Cloud Foundry environment, you can further distribute the quotas that are allocated to a subaccount. This is done by
creating space quota plans and assigning them to the spaces.
Space quota plans are optional and are used to limit how much each space can use, not to enable. If you don't create any space
quota plans, all spaces in a subaccount using the Cloud Foundry environment have access to all entitlements and quotas in that
subaccount. This means that one space could use up all the quota in a subaccount. If you want to prevent that from happening and
set a limit to how much each space can use from the total quota available in the subaccount, you can use quota plans and assign
them to spaces.
For more information on space quota plans in the Cloud Foundry environment, see:
https://docs.cloudfoundry.org/adminguide/quota-plans.html
Resource Providers
SAP BTP allows you to connect your global account in the SAP BTP Cockpit to your provider account from a non-SAP cloud
vendor, and consume remote service resources that you already own and which are supported by SAP through this channel.
This is custom documentation. For more information, please visit the SAP Help Portal 73
10/15/24, 3:53 PM
For example, if you’re subscribed to Amazon Web Services (AWS) and have already purchased services, such as PostgreSQL, you
can register the vendor as a resource provider in SAP BTP and consume this service across your subaccounts together with other
services offered by SAP.
SAP BTP currently supports the following vendors and their consumable services:
After you configure a new resource provider, its supported services are added as entitlements in your global account. In the
Entitlements page in the cockpit, you can then allocate the required services and quotas to the relevant directories and
subaccounts in your global account.
Related Information
Managing Entitlements and Quotas Using the Cockpit
Tutorial: Manage Entitlements on SAP BTP Trial
Troubleshooting: Entitlement and Quota Problems
User Accounts
A user account corresponds to a particular user in an identity provider. The user is always stored in an external identity provider,
such as a custom tenant of SAP Cloud Identity Services - Identity Authentication or the default identity provider.
User accounts enable users to log on to SAP BTP, access subaccounts, and to use applications according to the permissions
granted to them.
Note
A user name alone doesn't determine a concrete user account with associated authorizations, as you can have users with the
same user name in different identity providers. Accessible data and allowed operations also depend on the identity provider.
The concrete user is identified by the combination of user name and identity provider.
Example
There are two users with the same user name, which is the email address here. The two users with different identity providers
have different authorizations and can access different applications.
[email protected] from the custom identity provider has authorizations to access her favorite industrial
applications. She needs the logon with the custom identity provider for her actual work.
This is custom documentation. For more information, please visit the SAP Help Portal 74
10/15/24, 3:53 PM
[email protected] from the default identity provider has no authorizations.
Before diving into the different user and member management concepts, it's important to understand the difference between the
two types of users we’re referring to: platform users and business users.
Related Information
Working with Users
Roles and Role Collections
Attributes
Trust and Federation with Identity Providers
Platform Users
Platform users are usually developers, administrators or operators who deploy, administer, and troubleshoot applications and
services on SAP BTP. They’re the users that have full access and give certain permissions, for instance, at global account,
directory, or subaccount level. Members only have basic access.
Platform users who have administrative permissions can view or manage the list of global accounts, subaccounts, and
environments, such as Cloud Foundry orgs and spaces. Members have basic access to them using the SAP BTP cockpit, the SAP
BTP command-line interface (btp CLI), or environment-specific CLI, such as the Cloud Foundry (CF) CLI.
For platform users, there's a default identity provider. We expect that you have your own identity provider. We recommend that you
configure your custom tenant of SAP Cloud Identity Services as the identity provider and connect SAP Cloud Identity Services to
your own corporate identity provider.
Note
For China (Shanghai) and Government Cloud (US) regions, a different default identity provider is used, and you can't use SAP
Cloud Identity Services as identity provider in the global account.
If you want to use two-factor authentication in the China (Shanghai) region, see this blog article on SAP Community.
This is custom documentation. For more information, please visit the SAP Help Portal 75
10/15/24, 3:53 PM
Member Management
Member management refers to managing permissions for platform users. Members have only basic access to SAP BTP.
Member management happens at global account, directory, subaccount, and environment level. Members' permissions apply to
all operations that are associated with the global account, the organization, or the space, irrespective of the tool used. Depending
on the scope and the cloud management tools you're using, you manage members in different ways:
You manage global account members by You manage directory members by You manage subaccount members by
assigning role collections to platform users. assigning role collections to platform users. assigning role collections to platform users.
Use the following predefined role Use the following predefined role
collections: collections: Note
Neo subaccounts don’t use role
Global Account Administrator Directory Administrator
collections.
Global Account Viewer Directory Viewer
For more information, see Managing
Assign these role collections from the SAP Assign these role collections from the SAP Member Authorizations in the Neo
BTP cockpit or the btp CLI. BTP cockpit or the btp CLI. Environment.
See: See:
Use the predefined role collections, such as:
Role Collections and Roles in Global Role Collections and Roles in Global
Subaccount Administrator
Accounts, Directories, and Subaccounts Accounts, Directories, and Subaccounts
Subaccount Viewer
Add Members to Your Global Account Create Users
Assign these role collections from the SAP
Create Users Manage Users in Directories
BTP cockpit or the btp CLI.
See:
Create Users
Orgs Spaces
Manage org members on the Members page at environment level Manage space members on the Members page at space level in the
in the SAP BTP cockpit or with the Cloud Foundry CLI. SAP BTP cockpit or with the Cloud Foundry CLI.
A platform user added as an org member can be either an Org A platform user added as a space member can be either a Space
Manager or an Org Auditor or implicitly an Org User. Manager, Space Developer, Space Auditor, or Space Supporter.
See: See:
About Roles in the Cloud Foundry Environment About Roles in the Cloud Foundry Environment
https://docs.cloudfoundry.org/concepts/roles.html#roles https://docs.cloudfoundry.org/concepts/roles.html#roles
For more information on the Kyma environment, see Assign Roles in the Kyma Environment.
This is custom documentation. For more information, please visit the SAP Help Portal 76
10/15/24, 3:53 PM
Role collections group authorizations for resources and services. Your administrators assign these role collections to other
platform users to create new administrators. Role collections consist of individual roles. For more information on role collections,
roles, see the related link.
Role collections are account-specific. Role collections that exist in the global account don’t exist in the subaccounts. Likewise, role
collections in subaccounts aren’t available in the global account.
Note
Neo subaccounts don’t use role collections.
For more information, see Managing Member Authorizations in the Neo Environment.
Role Collections
You can use the default role collections, but you can’t change or delete them. SAP BTP provides the following administrator role
collections:
Subaccount Administrator
Directory Administrator
Destination Administrator
SAP BTP provides also viewer role collections for the global account and for subaccounts. In contrast to the administrator role
collections, viewer role collections only grant read access.
Subaccount Viewer
Directory Viewer
Note
This is custom documentation. For more information, please visit the SAP Help Portal 77
10/15/24, 3:53 PM
You can also use the command-line interface (CLI) for SAP BTP to assign authorizations. For more information on managing
authorizations, see the related link.
Global Account Admin Role for global account members with read-write authorizations for
core commercialization operations, such as updating global
accounts, setting entitlements, and creating, updating, and
deleting subaccounts.
Example
cis-central!b1
Global Account Usage Reporting Viewer Role for global account members with read-only authorizations for
core commercialization operations, such as viewing global account
usage information.
User and Role Administrator Manage authorizations, trusted identity providers, and users.
The xsuaa_admin role template provides this role. You find the role
template in the SAP BTP Cockpit if you choose the xsuaa!<suffix>
application identifier.
Example
xsuaa!tl
Example
cmp!b7
If you assign the Subaccount Administrator role collection to a user, you grant a user administration permission for a subaccount.
Cloud Connector Administrator Operate the data transmission tunnels used by the Cloud
connector.
This is custom documentation. For more information, please visit the SAP Help Portal 78
10/15/24, 3:53 PM
Subaccount Admin Role for subaccount members with read-write authorizations for
core commercialization operations, such as viewing subaccount
entitlements, and creating and deleting environment instances.
User and Role Administrator Manage authorizations, trusted identity providers, and users.
If you assign the Cloud Connector Administrator role collection to a user, you grant the user administration permissions for the
Cloud Connector in a subaccount.
Cloud Connector Administrator Operate the data transmission tunnels used by the Cloud
connector.
If you assign the Connectivity and Destination Administrator role collection to a user, you grant the user administration
permissions for the Cloud Connector and SAP Destination service in a subaccount.
Cloud Connector Administrator Operate the data transmission tunnels used by the Cloud
connector.
If you assign the Destination Administrator role collection to a user, you grant the user administration permissions for the SAP
Destination service in a subaccount.
If you assign the Subaccount Service Administrator role collection to a user, you grant the user administration permissions for
the Service Manager in a subaccount.
This is custom documentation. For more information, please visit the SAP Help Portal 79
10/15/24, 3:53 PM
If you assign the Global Account Viewer role collection to a user, you grant read access to the same information as the Global
Account Administrator role collection.
Global Account Viewer Role for global account members with read-only authorizations for
core commercialization operations, such as viewing global
accounts, subaccounts, entitlements, and regions.
Global Account Usage Reporting Viewer Role for global account members with read-only authorizations for
core commercialization operations, such as viewing global account
usage information.
User and Role Auditor Read-only access for authorizations, trusted identity providers, and
users.
If you assign the Subaccount Viewer role collection to a user, you restrict a user's viewer permission to the subaccounts.
Cloud Connector Auditor View the data transmission tunnels used by the Cloud connector to
communicate with back-end systems.
Subaccount Viewer Role for subaccount members with read-only authorizations for
core commercialization operations, such as viewing subaccount
entitlements, details of environment instances, and job results.
User and Role Auditor Read-only access for authorizations, trusted identity providers, and
users.
The Directory Administrator role collection grants a user administration permission for directories.
Directory Admin Role for directory members with read-write authorizations for core
commercialization operations, such as updating directories, setting
entitlements, and creating, updating, and deleting subaccounts.
This is custom documentation. For more information, please visit the SAP Help Portal 80
10/15/24, 3:53 PM
Directory Usage Reporting Viewer Role for directory members with read-only authorizations for core
commercialization operations, such as viewing directory usage
information.
User and Role Administrator Manage authorizations, trusted identity providers, and users.
The Directory Viewer role collection grants a user read access to the same information as the Directory Administrator role
collection.
Directory Usage Reporting Viewer Role for directory members with read-only authorizations for core
commercialization operations, such as viewing directory usage
information.
Directory Viewer Role for directory members with read-only authorizations for core
commercialization operations, such as viewing directories,
subaccounts, entitlements, and regions.
User and Role Auditor Read-only access for authorizations, trusted identity providers, and
users.
Roles
Create your own role collections by using the roles of the default role collections. The roles are based on role templates, which are
provided by applications. The application identifier refers to the application, which provides the role templates.
Example
The GlobalAccount_Admin role template provides the Global Account Admin role. You find the role template in the cockpit if
you choose the cis-central!<suffix> application identifier.
Example
cis-central!b1
The following table provides the information about the roles that are available.
Role Details
This is custom documentation. For more information, please visit the SAP Help Portal 81
10/15/24, 3:53 PM
Roles in Environments
If you've enabled environments in your subaccount, manage the roles for those environments. For more information, see:
Note
The ABAP environment uses the roles of the SAP BTP, Cloud Foundry Environment.
Related Information
User and Member Management
Working with Role Collections
Building Roles and Role Collections for Applications
Mapping Role Collections in the Subaccount
Managing Users and Their Authorizations Using the btp CLI
This is custom documentation. For more information, please visit the SAP Help Portal 82
10/15/24, 3:53 PM
Platform users perform technical development, operations, and administration tasks. They manage global accounts, directories,
and subaccounts using the SAP BTP cockpit and the SAP BTP CLI. They also develop and operate custom applications. By hosting
these users in your own identity provider, you gain a number of advantages over hosting them in SAP ID service or in SAP Universal
ID.
Integrate the management of these users with your broader identity management strategy, hosted on your own identity
providers. You control your own user lifecycle and single sign-on strategies throughout the entire landscape.
Enforce your own password and authentication policies, such as stronger passwords or multifactor authentication.
The following figure illustrates the architecture required for platform users. This configuration is independent of the default
configuration with SAP ID service. You can continue to use SAP ID service in parallel.
In the preceding figure, you enable trust between the SAP BTP global account and your corporate identity provider over your
tenant of SAP Cloud Identity Services - Identity Authentication. Trust is configured differently in the Kyma environment (see the
related link). For each global account, you choose the SAP Cloud Identity Services tenant to use as the identity provider for
platform users. For the platform identify provider, you can have up to three SAP Cloud Identity Services tenants per global
account. Multiple global accounts can share the same SAP Cloud Identity Services tenant. When you log on to a platform resource,
such as the cockpit, you indicate the SAP Cloud Identity Services tenant that you want to log on with. For example, to log on to the
cockpit, copy a URL parameter from the cockpit to identify the tenant:
https://cockpit.btp.cloud.sap/cockpit/?idp=<tenant>.accounts.ondemand.com
Once you’ve logged on, the cockpit displays any global accounts and subaccounts of which your platform user is a member.
A user identifier alone isn’t enough to identify a user. Additionally, you also need an identifier for an identity provider. The reason is
that the system treats users with the same name but from different identity providers as separate users.
For global accounts, directories, multi-environment subaccounts, and the Cloud Foundry environment, the user identifier is always
an email address, and the identifier of the identity provider is the origin key (alias for the trust configuration). For example, a
platform user in the default identity provider, SAP ID service, and another user in your corporate identity provider with the same
email address might have different authorizations.
Example
There are two users with the same email address. It is common practise that the two users with different identity providers
have different authorizations and can access different applications.
This is custom documentation. For more information, please visit the SAP Help Portal 83
10/15/24, 3:53 PM
[email protected] with the default identity provider isn't authorized for any subaccount.
[email protected] with the acme-platform custom identity provider is the administrator for multiple
subaccounts. The subaccounts are only visible when she logs on with the custom identity provider.
You can log on to the cockpit with both, but the cockpit displays different user information. This difference is because you’ve
logged on with different identity providers.
For Neo subaccounts, it is, by default, the P user ID for local SAP Cloud Identity Services users or whatever the corporate identity
provider connected to the SAP Cloud Identity Services tenant sends as subject. The identifier of the identity provider is the default
domain of the SAP Cloud Identity Services tenant, for example acme.accounts.ondemand.com. It is called "user base". For
more information, see Platform Identity Provider.
You also see this difference when assigning roles. You must provide the origin or user base in addition to the email address or user
ID of the user. When platform users use the Cloud Foundry command-line interface or service dashboards, they need to remember
the origin. You can choose your own origin, but the origin must be unique across all customers. We recommend that you use a
meaningful name that helps identify the target it points to.
In SAP Cloud Identity Services - Identity Authentication in Neo subaccounts, there's one application that represents SAP BTP
overall. So, if you have multiple global accounts with the same SAP Cloud Identity Services tenant, they all share the same
application in your SAP Cloud Identity Services tenant. Here customers typically configure settings such as the corporate identity
provider used for authentication and user attribute mapping between systems. For more information, see Map User Attributes
from a Corporate Identity Provider for Platform Users.
Related Information
Log On with a Custom Identity Provider to the Cloud Foundry Environment Using the Cloud Foundry Command-Line Interface
Establish Trust and Federation of Custom Identity Providers for Platform Users
Configure a Custom Identity Provider for Kyma
Note
For more information about the upgrade process itself, see SAP Note 3027721 .
Recommendation
Keep at least one user from the default identity provider in each account to still have access if there are ever issues with a
custom identity provider.
This is custom documentation. For more information, please visit the SAP Help Portal 84
10/15/24, 3:53 PM
Even though the default identity provider has been reactivated, the option to authenticate with the default identity provider is
hidden from business users. Business users are redirected to your custom identity provider. Hiding the default identity provider
ensures that the user experience for your business users remains the same. Users from the default identity provider can log on,
only if the users are authorized, in other words, users with existing shadow users.
For more information about shadow users, see Working with Users.
Note
Whether the default identity provider was reactivated or not, applications that share the default identity provider, such as SAP
Support Portal or your demo application in your subaccount, no longer require reauthentication, when you switch from one
application to the other. This change improves the single sign-on experience.
Administrator of global account Global Account Administrator in global In cloud management tools feature set A,
account and Subaccount Administrator in members of the global account have global
multi-environment subaccounts account administrator privileges. Such
users can create and manage subscriptions
for subaccounts.
Tip
To ensure that your global account
administrators still have these
authorizations, these users are also
assigned subaccount administrator
authorizations in all multi-environment
subaccounts of the global account. After
the move, consider if your global
account administrators really need
subaccount administrator access to all
your subaccounts.
Security administrator in multi- Subaccount Administrator in multi- Security administrators rely mostly on the
environment subaccount environment subaccount User & Role Administrator role for their
authorizations. In cloud management tools
feature set B, these authorizations are
This is custom documentation. For more information, please visit the SAP Help Portal 85
10/15/24, 3:53 PM
Mapping Cloud Foundry Authorizations Between Feature Set A and Feature Set B
The following table lists the roles and role collections a user receives, based on the Cloud Foundry roles the user had in cloud
management tools feature set A.
Mappings of Cloud Foundry Authorizations Between Feature Set A and Feature Set B
Business Users
Business users use the applications that are deployed to SAP BTP. For example, the end users of SaaS apps or services, such as
SAP Workflow service or SAP Cloud Integration, or end users of your custom applications are business users.
Application developers (platform users) create and deploy application-specific security artifacts for business users, such as
scopes. Administrators use these artifacts to assign roles, build role collections, and assign these role collections to business users
or user groups. In this way, they control the users' permissions in the application.
For business users, there's a default identity provider, too. We expect that you have your own identity provider. We recommend that
you configure your custom tenant of SAP Cloud Identity Services as the identity provider and connect SAP Cloud Identity Services
to your own corporate identity provider.
This is custom documentation. For more information, please visit the SAP Help Portal 86
10/15/24, 3:53 PM
User Management
User management refers to managing authentication and authorization for your business users.
2. Create shadow users in your subaccount for your business users in your identity provider.
When a user accesses a resource, SAP BTP redirects the user to the identity provider for authentication. You assign
authorizations to shadow users in SAP BTP.
3. Assign role collections either directly to users or map them to user groups.
The role collections were either delivered from the applications to which you subscribed or custom developed by your
team.
To learn more about user management, see Security Administration: Managing Authentication and Authorization.
Tools
SAP BTP includes many tools to help you develop and manage applications, and connect them to your on-premise systems.
Programming Languages
SAP BTP supports many different programming languages; the availability of each depends on the development
environment you're using.
Programming Models
Continuous Integration and Delivery (CI/CD)
Configure and run predefined continuous integration and delivery (CI/CD) pipelines that automatically build, test, and
deploy your code changes to speed up your development and delivery cycles.
APIs
Discover and consume APIs to manage, build, and extend the core capabilities of SAP BTP.
Cloud Management Tools — Feature Set Overview
Cloud management tools represent the group of technologies designed for managing SAP BTP.
Prerequisites and Restrictions
Find a list of the product prerequisites and restrictions for SAP BTP.
Tools
SAP BTP includes many tools to help you develop and manage applications, and connect them to your on-premise systems.
The availability of tools can depend on the cloud management tools feature set that you are running on. For more information, see
Cloud Management Tools — Feature Set Overview.
Tool Description
Account Administration in the Cockpit The SAP BTP cockpit is the web-based administration interface of
SAP BTP and provides access to a number of functions for
This is custom documentation. For more information, please visit the SAP Help Portal 87
10/15/24, 3:53 PM
Tool Description
Cloud Connector The Cloud Connector serves as the link between on-demand
applications in SAP BTP. This is the browser-based and existing on-
premise systems. You can control the resources available for the
cloud applications in those systems.
Command Line Interface for Cloud Foundry The Cloud Foundry command line interface enables you to work
with the Cloud Foundry environment to deploy and manage your
applications.
SAP BTP Command Line Interface The SAP BTP command line interface (btp CLI) is the command
line tool for convenient account management, such as managing
global accounts, directories, subaccounts, entitlements,
environment instances, multitenant application subscriptions, and
users and their authorizations.
Helm The package manager for Kubernetes, used for installing and
managing Kubernetes applications in form of Helm charts.
ABAP RESTful Application Programming Model The programming model that defines the architecture for efficient
end-to-end development of intrinsically SAP HANA-optimized
OData services (such as SAP Fiori apps) in the ABAP environment.
SAP BTP SDK for iOS The SAP BTP SDK for iOS is based on the Apple Swift programming
language for developing apps in the Xcode IDE and includes well-
defined layers (SDK frameworks, components, and platform
services) that simplify development of enterprise-ready mobile
native iOS apps. The SDK is tightly integrated with SAP Mobile
Services for Development and Operations.
SAP BTP SDK for Android The SAP BTP SDK for Android provides development tools for
creating native Android mobile applications that use SAP Mobile
Services. The SDK is based on the Java programming language and
is built on top of Google's Android SDK.
SAP Cloud SDK SAP Cloud SDK provides a layer of abstractions for features of SAP
BTP such as logging, multitenancy, and connectivity. It also
includes project templates for different execution environments
and implementations.
Eclipse Tool for the Cloud Foundry Environment The Eclipse plug-in for the Cloud Foundry environment is a Java-
based toolkit for Eclipse IDE that enables you to develop and deploy
Java and Spring applications in the Cloud Foundry environment
from Eclipse or Spring Tool Suite, as well as perform operations
such as logging, managing user roles, creating connectivity
destinations, and so on.
SAP Business Application Studio SAP Business Application Studio is the next generation of SAP Web
IDE - Develop, debug, test, and deploy SAP business applications.
This is custom documentation. For more information, please visit the SAP Help Portal 88
10/15/24, 3:53 PM
Tool Description
SAP Build SAP Build enables everyone, no matter the skill level, to create and
augment enterprise applications, process automations, and
business sites with drag-and-drop simplicity.
Service-Specific Tools The services that run on SAP BTP can come with service-specific
tools. For an overview of the services and their tools, see the SAP
Discovery Center .
Programming Languages
SAP BTP supports many different programming languages; the availability of each depends on the development environment
you're using.
Node.js
Python
Programming Models
ABAP Cloud
ABAP Cloud reflects the modern way to develop ABAP. It allows you to build lifecycle-stable and cloud-ready business applications,
services, and extensions.
ABAP Cloud provides tools and techniques that ensure cloud qualities, promotes new technologies, contains a cloud-optimized
subset of the ABAP language, and makes upgrade cycles easier by a clear separation between custom code and SAP code by only
using released APIs and objects. See .
CAP-based projects benefit from a primary focus on the domain. Instead of delving into overly technical disciplines, CAP focuses
on accelerated development and safeguarding investments in a world of rapidly changing cloud technologies.
This is custom documentation. For more information, please visit the SAP Help Portal 89
10/15/24, 3:53 PM
Here are some of the benefits that come with the SAP Cloud Application Programming Model (CAP):
Support for Visual Studio Code and SAP Business Application Studio tools
No runtimes lock-in
See .
Note
For links to all SAP solutions for CI/CD, blog posts, presentations, and tutorials, have a look at our Continuous Integration and
Delivery by SAP overview.
Continuous integration (CI) describes a software development process, in which various team members integrate their
contributions frequently into a single main line. Before each integration, the changes are verified through builds and automated
testing. Thereby, you can detect errors as quickly as possible and prevent integration problems before completing the
development.
The continuous delivery (CD) concept expands on the one of continuous integration. It adds the aspect that any change that has
successfully passed the tests is immediately ready to be deployed to production, both from a technical and a qualitative point of
view.
The following graphic shows the basic flow for continuous integration and delivery:
This is custom documentation. For more information, please visit the SAP Help Portal 90
10/15/24, 3:53 PM
For more information about the continuous integration and continuous delivery concepts, see What Are Continuous Integration
and Continuous Delivery?.
Use
Depending on your use case, you can choose between different CI/CD pipelines to help you implement continuous integration and
delivery in your software development.
SAP Continuous Integration and Delivery lets you configure and run predefined pipelines for the development of the following
applications:
Configure a CI/CD pipeline for the development of applications that follow the SAP Cloud Application Programming Model
in the Cloud Foundry runtime.
Configure a CI/CD pipeline for the development of SAPUI5/SAP Fiori applications in the Cloud Foundry runtime.
Configure a CI/CD pipeline for the development of SAPUI5/SAP Fiori applications in the Neo environment.
This is custom documentation. For more information, please visit the SAP Help Portal 91
10/15/24, 3:53 PM
Configure a CI/CD pipeline for the development of SAPUI5/SAP Fiori applications for the ABAP platform.
Configure a CI/CD pipeline for the development of SAP Cloud Integration artifacts in the Cloud Foundry runtime.
To learn more about the CI/CD pipelines supported by SAP Continuous Integration and Delivery and the stages each pipeline can
comprise, see Supported Pipelines.
3. Enable the API usage to connect SAP Continuous Integration and Delivery to other services, if necessary.
Note
Only administrators of SAP Continuous Integration and Delivery can configure the service.
1. Configure credentials for connecting SAP Continuous Integration and Delivery to other services (for example, GitHub,
GitLab, Bitbucket Server, or Azure Repos to clone your sources, and SAP BTP to deploy your built application).
Now you can create and modify your CI/CD jobs and monitor their outcome. If you want to automate your builds, you can
configure a webhook between your repository and the service. You can create and modify timed triggers for your jobs, if necessary.
For more information, see Initial Setup and Configuration, or follow the tutorial Configure and Run a Predefined SAP Continuous
Integration and Delivery (CI/CD) Pipeline .
This openSAP course introduces general DevOps approaches and key principles. Learn about the basic CI/CD principles
(week 1) and how to deliver cloud applications using CI/CD (week 3).
The CI/CD Introduction Guide provides you with basic knowledge for setting up and implementing continuous integration
and delivery processes. It gives an overview of the concepts and principles of CI/CD, explains both procedures and their
relation, and helps you plan your own CI/CD process.
This is custom documentation. For more information, please visit the SAP Help Portal 92
10/15/24, 3:53 PM
APIs
Discover and consume APIs to manage, build, and extend the core capabilities of SAP BTP.
An Application Programming Interface or API is an interface provided by an application for interacting with other applications.
APIs specify how software programs are able to exchange information with each other, even if designed and run by different
organizations. They facilitate interaction by selectively exposing certain functionality, allowing different apps, websites, and
devices to communicate effectively with each other. More importantly, APIs enable businesses to reach beyond regular business
channels and share data, content, and services directly to both B2B (business to business) and B2C (business to consumer)
clients, making UI development easy.
Offering Description
SAP BTP on SAP Business Accelerator Hub The SAP Business Accelerator Hub provides you with one central
repository for browsing and accessing APIs from SAP and selected
partners. Test APIs and try out mock data in your systems.
It is also the official place where REST and OData REST API
references are published.
API Management Capability within SAP Integration Suite With the API Management capability, you can build, manage,
publish, and monetize your own APIs within one secure and
scalable environment.
Software Development Kits (SDKs) The SDKs available for SAP BTP offer APIs to, for example,
accelerate enterprise app development.
For an overview of the available SDKs, see Tools.
Related Information
SAP API Style Guide
We're currently renovating and adding core functionalities to SAP BTP. As part of this process, we're upgrading enterprise
accounts from the existing cloud management tools feature set A to the renovated cloud management tools feature set B. We're
doing this upgrade as a phased rollout, so cloud management tools feature sets A and B will coexist for some time. For more
information about the account upgrade process and frequently-asked questions, see 3027721 .
How can I know which cloud management tools feature set I'm using?
There’s an easy way to check if you're currently using cloud management tools feature set A or B. Access the SAP BTP cockpit and
choose your username from the top right-hand corner of the screen. From the menu, select About to get information about the
cloud management tools feature set you're using.
This is custom documentation. For more information, please visit the SAP Help Portal 93
10/15/24, 3:53 PM
When using cloud management tools feature set A: Choose https://account.eu1.hana.ondemand.com to access the SAP BTP
cockpit.
When using cloud management tools feature set B: Choose https://cockpit.btp.cloud.sap to access the cockpit. Depending on
your own geo location this URL will redirect you to the closest regional Cockpit URL.
What are the differences between the two cloud management tools feature sets?
See:
Directories
Create a Directory
This is custom documentation. For more information, please visit the SAP Help Portal 94
10/15/24, 3:53 PM
See Labels.
Set entitlements
This is custom documentation. For more information, please visit the SAP Help Portal 95
10/15/24, 3:53 PM
See:
This is custom documentation. For more information, please visit the SAP Help Portal 96
10/15/24, 3:53 PM
the Subaccounts page from the left Once you're in a global account, the first page you see
hand-side navigation. is the Subaccounts page, from where you can directly
navigate to your subaccount — one less click needed.
See Navigate in the Cockpit
Usage and cost information for your global account is
displayed in the global account's Usage Analytics
page.
See:
This is custom documentation. For more information, please visit the SAP Help Portal 97
10/15/24, 3:53 PM
With feature set A, the Members tab With feature set B, you have a fine-grained
determines which users are global authorization concept for the management of global
administrators. These users can assign accounts. We deliver a set of role collections for the
or remove global administrator management of global accounts. If these role
membership to other users. collections don’t match your needs, you can configure
your own role collections using the authorizations we
See:
supply. For example, you have control over which
User and Member Management global account users can create subaccounts and
which can’t.
Add Members to Your Global Account
The Authorization and Trust Management (XSUAA)
Impact of Upgrading from Feature Set service is responsible for access management for
A to Feature Set B on User and Account global accounts. This service is the same service that
Management performs access management at the subaccount
level, although it’s a different instance of the service.
See:
See:
This is custom documentation. For more information, please visit the SAP Help Portal 99
10/15/24, 3:53 PM
Note
The overall trial period is 90 days and is divided in
intervals.
With feature set B, you can delete your SAP BTP trial
account. Simply navigate into your trial global account
by choosing Enter Your Trial Account on the trial
home page. Once you're on the Subaccounts page of
your global account, you will see a new button giving
you the option to delete your trial account.
Note
Cloud management tools feature set B applies also to the Neo environment. For more information about the scope offered with
the enhanced capabilities, see Working with Cloud Management Tools Feature Set B in the Neo Environment.
General Constraints
For information on constraints and default settings to consider when you deploy an application in the Cloud Foundry
environment, see http://docs.cloudfoundry.org/devguide/deploy-apps/large-app-deploy.html#limits_table .
SAP BTP exposes applications only via HTTPS. For security reasons, applications can’t be accessed via HTTP.
SAP BTP Tools for Java and SDK run in many operating environments with Java 7, and Java 8 that are supported by Eclipse.
However, SAP doesn’t systematically test all platforms.
SAP BTP Tools for Java must be installed on Eclipse IDE for Java EE developers.
For the platform development tools, SDK, Cloud connector, and SAP JVM, see https://tools.hana.ondemand.com/#cloud .
Browser Support
For a list of supported browsers for the SAP BTP cockpit, see Feature Scope Description.
For a list of supported browsers for developing SAPUI5 applications, see Browser and Platform Support.
To find out the browser support for a specific service, refer to the corresponding feature scope description.
For security reasons, SAP BTP doesn’t support TLS1.1 and older, SSL 3.0 and older, and RC4-based cipher suites. Make sure that
your browser supports at least TLS1.2 and modern ciphers (for example, AES).
Getting Started
Once you're familiar with the basic concepts of SAP BTP, you can start your first workflows or check out further resources that
help you get started quickly.
Onboarding Guide
The guide Best Practices for SAP BTP helps you plan your development projects on SAP BTP from setting up the correct
organizational structure to creating an account and security model, to developing and operating applications.
Additional Resources
The SAP Developer Center provides further resources to get you started:
This is custom documentation. For more information, please visit the SAP Help Portal 101
10/15/24, 3:53 PM
Related Information
SAP BTP Administrator's Guide
Access the Cockpit
This is custom documentation. For more information, please visit the SAP Help Portal 102