diff --git a/services/managing-services.html.md.erb b/services/managing-services.html.md.erb index 09ec7cd1..24ea0608 100644 --- a/services/managing-services.html.md.erb +++ b/services/managing-services.html.md.erb @@ -53,6 +53,8 @@ OK User-provided service instances provide a way for developers to bind apps with services that are not available in their Cloud Foundry Marketplace. For more information, see User-provided service instances. +

The cf create-service command uses CAPI V3 and creates asynchronous jobs. To wait for the create operation to complete before continuing, use the --wait flag. For more information, see the cf create-service reference.

+ When multiple brokers provide two or more services with the same name, you must specify the broker by including the -b BROKER flag in the cf create-service command. ### Arbitrary parameters @@ -100,6 +102,8 @@ cf services The output from running this command includes any bound apps and the state of the last requested operation for the service instance. +

To improve performance when you have many service instances, use --no-apps to skip retrieving bound app information. Use --wait to wait for any in-progress operation to complete. For more information, see the cf services reference.

+
 $ cf services
 Getting services in org my-org / space test as user@example.com...
@@ -117,13 +121,16 @@ Details include dashboard urls, if applicable, and operation start and last upda
 
 $ cf service mydb
 
-service instance:       mydb
-service:                p-mysql
+name:                   mydb
+guid:                   abcd1234-ef56-7890-abcd-ef1234567890
+type:                   managed
+broker tags:
+offering:               p-mysql
 plan:                   100mb
 description:            mysql databases on demand
-documentation url:
-dashboard:              https://p-mysql.example.com/manage/instances/abcd-ef12-3456
-service broker:         mysql-broker
+documentation:
+dashboard url:          https://p-mysql.example.com/manage/instances/abcd-ef12-3456
+broker:                 mysql-broker
 
 This service is not shared.
 
@@ -311,22 +318,28 @@ To upgrade your service instances:
     otherdb   p-mysql   medium                create succeeded   mysql-broker   no
     
-2. Upgrade the service instance using the `--upgrade` flag: +2. Upgrade the service instance by running: ```console - cf update-service SERVICE-INSTANCE-NAME --upgrade + cf upgrade-service SERVICE-INSTANCE-NAME ``` For example:
-    $ cf update-service mydb --upgrade
-    You are about to update mydb.
+    $ cf upgrade-service mydb
+    You are about to upgrade mydb.
     Warning: This operation might run long and block further operations on the service until complete.
-    Really update service mydb? [yN]: y
+    Really upgrade service mydb? [yN]: y
     OK
     
+ To skip the confirmation prompt, use the `--force` flag: + + ```console + cf upgrade-service mydb --force + ``` + ## Delete a service instance