Disabling for an environment

Disabling for an environment terminates the cloud infrastructure that was created as part of the enablement process.

About this task

When you disable for an environment, you can specify whether to preserve your environment event history. Preserving the event history retains your environment event history and allows you to view past events even after the environment has been disabled. Regardless of whether you choose to preserve the event history, you can enable for an environment again after a successful disablement operation.

Steps

  1. In , from the Environments page, select the environment you want to disable.
  2. Click Manage DataFlow from the Environment Details pane.

    You are redirected to the Manage DataFlow page.

  3. From the Actions menu, select Disable DataFlow.
  4. Specify whether you want to Preserve event history.
  5. Enter the environment name to confirm.
  6. Select Disable to initiate the disablement process.

Example

Before you begin

  • You have installed CDP CLI.
  • Run cdp df list-services to get the service-crn.
  1. To disable for an environment, enter:
    
    cdp df disable-service 
    --service-crn [***SERVICE_CRN***] 
    [--persist] [--no-persist] 
    [--terminate-deployments] [--no-terminate-deployments]
                   [help]

Where:

  • service-crn – Provides the value you identified when you run cdp df list-services.
  • [--persist] [--no-persist] – Select one to specify whether you want to preserve environment history.
  • [--terminate-deployments] [--no-terminate-deployments] – Specifies whether you want to gracefully terminate deployments associated with this environment. Regardless of this setting all associated deployments will be terminated when you disable

Result

When you successfully disable for an environment, your result will be similar to:


{
  "status": {
    "state": "DISABLING",
    "message": "Disabling DataFlow",
    "detailedState": "TERMINATING_DEPLOYMENTS"
  }
}

Next steps

Disabling for an environment can take up to 30 minutes.