docs-cf-admin/listing-feature-flags.html.md.erb at master · dieucao/docs-cf-admin · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
---
title: Feature Flags
---

<strong><%= modified_date %></strong>

Feature flags are switches that you set using the Cloud Controller API.
They allow an administrator to turn on or off functional sections of code, or features, of an application without deploying new code. Use feature flags to enable or disable features available to users.

## <a id='flags'></a>Feature Flags ##

There are nine feature flags that you can set. They are all enabled by default except `user_org_creation` and `diego_docker`. When disabled, these features are only available to administrators.

* `user_org_creation`: Any user can create an organization via the API. minimum CC API version: 2.12
* `private_domain_creation`: An organization manager can create private domains for that organization. minimum CC API version: 2.12
* `app_bits_upload`: Space developers can upload app bits. minimum CC API version: 2.12
* `app_scaling`: Space developers can perform scaling operations (i.e. change memory, disk, or instances). minimum CC API version: 2.12
* `route_creation`: Space developers can create routes in a space. minimum CC API version: 2.12
* `service_instance_creation`: Space developers can create service instances in a space. minimum CC API version: 2.12
* `diego_docker`: Space developers can push docker apps. minimum CC API version 2.33
* `set_roles_by_username`: Org Managers and Space Managers can add roles by username. minimum CC API version: 2.37
* `unset_roles_by_username`: Org Managers and Space Managers can remove roles by username. minimum CC API version: 2.37

## <a id='commands'></a>Feature Flag Commands ##

### Get All Feature Flags ###

`cf feature-flags`

### Get status of a Feature Flag ###

`cf feature-flag FEATURE_FLAG_NAME `

### Enable a Feature Flag ###

`cf enable-feature-flag FEATURE_FLAG_NAME`

### Disable a Feature Flag ###

`cf disable-feature-flag FEATURE_FLAG_NAME`

To view the feature flag commands, review the **Feature Flags** section of the [Cloud Foundry API documentation](http://apidocs.cloudfoundry.org).