cd_delete.md

copyright	lastupdated	keywords	subcollection
years 2020	2020-06-03	ibmcloud, resource, service instance, restore, CLI tool, IBM Cloud	ContinuousDelivery

{:shortdesc: .shortdesc} {:new_window: target="_blank"} {:external: target="_blank" .external} {:codeblock: .codeblock} {:pre: .pre} {:screen: .screen} {:tip: .tip} {:note: .note} {:important: .important} {:download: .download} {:help: data-hd-content-type='help'} {:support: data-reuse='support'}

Deleting a {{site.data.keyword.contdelivery_short}} service instance

{: #delete_cd_service} {: help} {: support}

You can delete a {{site.data.keyword.contdelivery_short}} service instance by using either the {{site.data.keyword.cloud_notm}} console or the {{site.data.keyword.cloud_notm}} CLI. {: shortdesc}

To delete a {{site.data.keyword.contdelivery_short}} service instance, you must have either the Administrator or Editor user permissions.

Deleting an instance of the {{site.data.keyword.contdelivery_short}} service impacts your ability to use tool integrations within toolchains that are contained in the same region and resource group as the deleted service instance. For more information about this limitation, see Plan limitations and usage. {: important}

Deleting a service instance from the console

{: #deleting_cd_console}

1. Log in to {{site.data.keyword.cloud_notm}}{:external}.
2. Go to the Resource list{: external} for your {{site.data.keyword.cloud_notm}} account.
3. In the Services section, locate the active {{site.data.keyword.contdelivery_short}} service instance.
4. From the {{site.data.keyword.contdelivery_short}} service instance's Actions menu, click Delete.
5. Click Delete to confirm that you want to delete the {{site.data.keyword.contdelivery_short}} service.

Deleting a service instance by using the CLI

{: #deleting_cd_cli}

• To view service instances, run the ibmcloud resource service-instances command:

  ~$ ibmcloud resource service-instances
  

  {: codeblock}

• To delete the service instance, run the ibmcloud resource service-instance-delete command:

  ~$ ibmcloud resource service-instance-delete <name or id of service instance>
  

  {: codeblock}

Restoring a deleted service instance

{: #restoring_cd_instance}

After you delete an instance of the {{site.data.keyword.contdelivery_short}} service, you can restore the deleted service instance within the data retention period of seven days. After the seven-day period expires, the service instance is permanently deleted.

To view which service instances are available for restoration, use the ibmcloud resource reclamations command. To restore a deleted service, use the ibmcloud resource reclamation-restore command. If you try to restore a deleted service and an active {{site.data.keyword.contdelivery_short}} service instance exists, the restoration is blocked. To view the details for a resource reclamation, use the ibmcloud resource reclamation command, with the --output JSON option.

You can have one active instance of {{site.data.keyword.contdelivery_short}} only in a region and resource group. After you delete an instance of the {{site.data.keyword.contdelivery_short}} service from a region and resource group, you can use one of the following options to create a service instance again:

• Restore the deleted service instance within the data retention period of seven days.
• Permanently remove the deleted service instance by using the ibmcloud resource reclamation-delete command, and then create a {{site.data.keyword.contdelivery_short}} service instance again.