Stay organized with collections
Save and categorize content based on your preferences.
Name
kf create-service - Create a service instance from a marketplace template.
Synopsis
kf create-service SERVICE PLAN SERVICE_INSTANCE [-c PARAMETERS_AS_JSON] [-b service-broker] [-t TAGS] [flags]
Description
Create service creates a new ServiceInstance using a template from the marketplace.
Examples
# Creates a new instance of a db-service with the name mydb, plan silver, and provisioning configuration
kf create-service db-service silver mydb -c '{"ram_gb":4}'
# Creates a new instance of a db-service from the broker named local-broker
kf create-service db-service silver mydb -c ~/workspace/tmp/instance_config.json -b local-broker
# Creates a new instance of a db-service with the name mydb and override tags
kf create-service db-service silver mydb -t "list, of, tags"
Flags
--async
Do not wait for the action to complete on the server before returning.
-b, --broker=string
Name of the service broker that will create the instance.
-h, --help
help for create-service
-c, --parameters=string
JSON object or path to a JSON file containing configuration parameters (default "{}").
-t, --tags=string
User-defined tags to differentiate services during injection.
--timeout=duration
Amount of time to wait for the operation to complete. Valid units are "s", "m", "h". (default 30m0s)
Inherited flags
These flags are inherited from parent commands.
--as=string
Username to impersonate for the operation.
--as-group=strings
Group to impersonate for the operation. Include this flag multiple times to specify multiple groups.
--config=string
Path to the Kf config file to use for CLI requests.
--kubeconfig=string
Path to the kubeconfig file to use for CLI requests.
--log-http
Log HTTP requests to standard error.
--space=string
Space to run the command against. This flag overrides the currently targeted Space.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# kf create-service\n\n### Name\n\n`kf create-service` - Create a service instance from a marketplace template.\n\n### Synopsis\n\n```\nkf create-service SERVICE PLAN SERVICE_INSTANCE [-c PARAMETERS_AS_JSON] [-b service-broker] [-t TAGS] [flags]\n```\n\n### Description\n\nCreate service creates a new ServiceInstance using a template from the marketplace.\n\n### Examples\n\n```\n # Creates a new instance of a db-service with the name mydb, plan silver, and provisioning configuration\n kf create-service db-service silver mydb -c '{\"ram_gb\":4}'\n \n # Creates a new instance of a db-service from the broker named local-broker\n kf create-service db-service silver mydb -c ~/workspace/tmp/instance_config.json -b local-broker\n \n # Creates a new instance of a db-service with the name mydb and override tags\n kf create-service db-service silver mydb -t \"list, of, tags\"\n```\n\n### Flags\n\n`--async`\n: Do not wait for the action to complete on the server before returning.\n\n`-b, --broker=`\u003cvar translate=\"no\"\u003estring\u003c/var\u003e\n: Name of the service broker that will create the instance.\n\n`-h, --help`\n: help for create-service\n\n`-c, --parameters=`\u003cvar translate=\"no\"\u003estring\u003c/var\u003e\n: JSON object or path to a JSON file containing configuration parameters (default \"{}\").\n\n`-t, --tags=`\u003cvar translate=\"no\"\u003estring\u003c/var\u003e\n: User-defined tags to differentiate services during injection.\n\n`--timeout=`\u003cvar translate=\"no\"\u003eduration\u003c/var\u003e\n: Amount of time to wait for the operation to complete. Valid units are \"s\", \"m\", \"h\". (default 30m0s)\n\n### Inherited flags\n\nThese flags are inherited from parent commands.\n\n`--as=`\u003cvar translate=\"no\"\u003estring\u003c/var\u003e\n: Username to impersonate for the operation.\n\n`--as-group=`\u003cvar translate=\"no\"\u003estrings\u003c/var\u003e\n: Group to impersonate for the operation. Include this flag multiple times to specify multiple groups.\n\n`--config=`\u003cvar translate=\"no\"\u003estring\u003c/var\u003e\n: Path to the Kf config file to use for CLI requests.\n\n`--kubeconfig=`\u003cvar translate=\"no\"\u003estring\u003c/var\u003e\n: Path to the kubeconfig file to use for CLI requests.\n\n`--log-http`\n: Log HTTP requests to standard error.\n\n`--space=`\u003cvar translate=\"no\"\u003estring\u003c/var\u003e\n: Space to run the command against. This flag overrides the currently targeted Space."]]
