Working with Global Accounts, Directories, and Subaccounts Using the btp CLI

Use the SAP BTP command line interface (btp CLI) to manage operations with global accounts, directories, and subaccounts.

Working with Global Accounts

Task	Run the command...	Command help
Get details about a global account, and the account structure (directories and subaccounts) of the global account.	`btp get accounts/global-account`	btp get accounts/global-account
Update the display name and/or description of a global account.	`btp update accounts/global-account`	btp update accounts/global-account

For more information, see Global Accounts ↗️.

Working with Directories

Directories allow you to organize and manage your subaccounts according to your technical and business needs.

Tip:

By default, all commands are executed in the global account you're logged in to. To change the target to a directory, use btp target -dir <my-directory-id>. See Set a Target for Subsequent Commands with btp target.

Task	Run the command...	Command help
Get details about a directory and list the subaccounts and subdirectories in the directory	`btp get accounts/directory`	btp get accounts/directory
Create a directory	`btp create accounts/directory`	btp create accounts/directory
Update a directory	`btp update accounts/directory`	btp update accounts/directory
Delete a directory	`btp delete accounts/directory`	btp delete accounts/directory
Change the set of enabled features (user and entitlement management) for a directory	`btp enable accounts/directory`	btp enable accounts/directory
List the user-defined labels assigned to a directory	`btp list accounts/labels`	btp list accounts/label
List the custom properties assigned to a directory Note: Custom properties are deprecated. Custom properties support only single values per key and are now replaced by the string array `labels`, which supports multiple values per key. Use `btp list accounts/labels` instead.	`btp list accounts/custom-property`	btp list accounts/custom-property

For more information, see Directories.

Working with Subaccounts

Tip:

By default, all commands are executed in the global account you're logged in to. To change the target to a subaccount, use btp target -sa <my-subaccount-id>. See Set a Target for Subsequent Commands with btp target.

Task	Run the command...	Command help
List all subaccounts in a global account	`btp list accounts/subaccount`	btp list accounts/subaccount
Get details about a subaccount	`btp get accounts/subaccount`	btp get accounts/subaccount
Create a subaccount	`btp create accounts/subaccount`	btp create accounts/subaccount
Update a subaccount	`btp update accounts/subaccount`	btp update accounts/subaccount
Delete a subaccount	`btp delete accounts/subaccount`	btp delete accounts/subaccount
Move a subaccount	`btp move accounts/subaccount`	btp move accounts/subaccount
List the user-defined labels assigned to a subaccount	`btp list accounts/labels`	btp list accounts/label
List the custom properties assigned to a subaccount Note: Custom properties are deprecated. Custom properties support only single values per key and are now replaced by the string array `labels`, which supports multiple values per key. Use `btp list accounts/labels` instead.	`btp list accounts/custom-property`	btp list accounts/custom-property
Get all available regions for global account	`btp list accounts/available-region`	btp list accounts/available-region