OpenShift docs are moving and will soon only be available at docs.redhat.com, the home of all Red Hat product documentation. Explore the new docs experience today.
  1. Documentation
    2. history bug_report picture_as_pdf
×

Destroying a hosted cluster on AWS

You can destroy a hosted cluster and its managed cluster resource on Amazon Web Services (AWS) by using the command-line interface (CLI).

Destroying a hosted cluster on AWS by using the CLI

You can use the command-line interface (CLI) to destroy a hosted cluster on Amazon Web Services (AWS).

Procedure

  1. Delete the managed cluster resource on multicluster engine Operator by running the following command:

    $ oc delete managedcluster <hosted_cluster_name> (1)
    1 Replace <hosted_cluster_name> with the name of your cluster.

  2. Delete the hosted cluster and its backend resources by running the following command:

    $ hcp destroy cluster aws  \
  --name <hosted_cluster_name> \(1)
  --infra-id <infra_id> \(2)
  --role-arn <arn_role> \(3)
  --sts-creds <path_to_sts_credential_file> \(4)
  --base-domain <basedomain> (5)
    1 Specify the name of your hosted cluster, for instance, example.
    2 Specify the infrastructure name for your hosted cluster.
    3 Specify the Amazon Resource Name (ARN), for example, arn:aws:iam::820196288204:role/myrole.
    4 Specify the path to your AWS Security Token Service (STS) credentials file, for example, /home/user/sts-creds/sts-creds.json.
    5 Specify your base domain, for example, example.com.

    If your session token for AWS Security Token Service (STS) is expired, retrieve the STS credentials in a JSON file named sts-creds.json by running the following command:

    $ aws sts get-session-token --output json > sts-creds.json