Resorting Instance CR .md

README.md

@@ -950,7 +950,38 @@ Do not call this API with the service-operator-access plan credentials.
 
 <b>Attention: **Use this option only for cleanup purposes for a cluster that's no longer available.** Applying it to an active and available cluster may result in unintended resource leftovers in your cluster.</b>
 
+### I can see my service instance in SAP BTP, but not its corresponding custom resource in my cluster. How can I restore the custom resource?
 
+Let's break down how to recover your Kubernetes custom resource that exists in SAP BTP but not in your Kubernetes cluster:
+
+#### Background
+
+The service instance in SAP BTP acts as the source of truth for your CR's configuration and state. By recreating the CR in Kubernetes with the exact same name, namespace, and cluster ID, you do not trigger the provisioning of a new service instance, but essentially re-establish the link between the Kubernetes representation and its existing counterpart in SAP BTP.
+
+#### Steps
+
+1. Retrieve CR Details:
+
+a) Access the service instance representing your CR in SAP BTP.
+
+b) Obtain the following details from the service instance:
+
+- The name of the custom resource.
+- The Kubernetes namespace where the CR should reside.
+
+2. Recreate the CR:
+
+a) If you have a YAML definition or manifest for your CR, ensure it includes the exact name and namespace you retrieved from the SAP BTP service instance. 
+
+b) Use `kubectl apply -f <your_cr_manifest.yaml>` to create the CR in your Kubernetes cluster.
+
+3. Verify:
+
+a) Use `kubectl get <your_cr_kind> <your_cr_name> -n <your_namespace>` to verify that the CR is successfully created in Kubernetes.
+
+b) Check the service instance in SAP BTP to confirm that it now recognizes the re-established connection with the CR in Kubernetes.
+
+c) If the connection is not re-established, verify that the cluster ID in your Kubernetes cluster matches the one associated with the SAP BTP service instance. You can find the cluster ID in the context details visible in the cockpit or BTP CLI. If the IDs don't match, reconfigure your cluster with the correct ID.
 
 
 You're welcome to raise issues related to feature requests, or bugs, or give us general feedback on this project's GitHub Issues page.