create-account-05f96cf.md

create-account

Creates a new subaccount with an automatically generated unique ID as subaccount technical name and the specified display name and assigns the user as a subaccount owner. The user is authorized against the existing subaccount passed as --account parameter. Optionally, you can clone an existing subaccount configuration to save time and effort.

Remember:

SAP Business Technology Platform, Neo environment will sunset on December 31, 2028, subject to terms of customer or partner contracts.

For more information, see SAP Note 3351844.

Tip:

This documentation refers to SAP Business Technology Platform, Neo environment. If you are looking for documentation about other environments, see SAP Business Technology Platform ↗️.

neo create-account --display-name <subaccount_display_name> --account <subaccount_technical_name> --user <e-mail_or_user> --host <host> --clone <cloning_options>

Note:

If you clone an existing extension subaccount, the new subaccount will not be an extension subaccount but a regular one. The new subaccount will not have the trust and destination settings typical for extension subaccounts.

Parameters

To list all parameters available for this command, execute neo help create-account in the command line.

Required
-a, --account	Subaccount technical name Specify an existing subaccount of which you are already a member. Type: string (up to 30 characters; lowercase letters and numbers, starting with a letter)
-n, --display-name	Subaccount display name If you want to create a subaccount whose display name has intervals, use quotes when executing the command. For example: neo ... --display-name "Display Name with Intervals" Type: string (up to 255 characters)
-u, --user	Use your email, SAP ID or user name Type: string
-p, --password	To protect your password, enter it only when prompted by the console client and not explicitly as a parameter in the properties file or the command line. Type: string
-h, --host	Enter a region host. Type: URL. For acceptable values see Regions and Hosts Available for the Neo Environment
--clone	(Optional) List of settings that will be copied (re-created) from the existing subaccount into the new subaccount. A comma separated list of values, which are as follows: trust members destinations all Each value combination is acceptable, for example, trust,members or all. If specified, all the configurations of the passed type(s) will be cloned to the newly created subaccount. Tip: We recommend listing explicitly the required cloning options instead of using --clone all in automated scripts. This will ensure backward compatibility in case the available cloning options, enveloped by all, change in future releases.

Example

neo create-account --account mysubaccount --display-name mynewsubaccount --user myuser --host hana.ondemand.com

Cloning Existing Subaccounts

You may choose among the following cloning options:

Cloning Option	Description
all	All settings (trust, members and destinations) from the existing subaccount will be copied into the new one. Caution: The list of cloned configurations might be extended in the future.
trust	The following trust settings will be re-created in the new subaccount similarly to the relevant settings in the existing subaccount: Trusted Identity Authentication tenants - the new subaccount will have trust to the Identity Authentication tenants registered in the existing subaccount. The respective Identity Authentication tenants, in turn, will automatically register a new service provider corresponding to the new SAP BTP subaccount. Note: SAP BTP will generate a new pair of key and certificate on behalf of the new subaccount. Remember to replace them with your proprietary key and certificate when using the subaccount for productive purposes. All other trust settings (for example, trusted on-premise identity providers) from the existing subaccount will not be copied into the new subaccount. Note: If you do not have any trusted Identity Authentication tenants in the existing subaccount, cloning the trust settings will result in trust with SAP ID Service (as default identity provider) in the new subaccount.
members	All members with their roles from the existing subaccount will be copied into the new one.
destinations	All destinations from the existing subaccount will be created into the new one. In addition, the relevant certificates and passwords for the destinations will also be cloned so the destination configurations will be fully functional in the new subaccount.

Example of cloning an existing subaccount to create a new subaccount with the same trust settings and existing destinations:

neo create-account --account mysubaccount --display-name mynewsubaccount --user myuser --host hana.ondemand.com --clone trust,destinations