The domain name cannot be created because it is already reserved by another domain

Products

• VMware Tanzu Application Service

Issue/Introduction

When creating a private subdomain in an organization, you may encounter a failure stating the subdomain is already reserved by another domain.

 

For example:

cf create-private-domain org1 dev.example.net

Creating private domain dev.example.net for org org1 as [email protected]...
The domain name "dev.example.net" cannot be created because "example.net" is already reserved by another domain
FAILED

 

What are Private domains?

Private domains allow members of an organization to create routes for privately registered domain names. Private domains can be shared with other orgs and spaces. These are called shared private domains and are not the same as shared domains. 

When using private domains, you can have routes with the same host name and domain name across different orgs and spaces. This cannot be done with shared domains.

Cause

The cause of this failure is the existing private domain (example.net) is owned by another org.

Requirements for parent and child domains

In the domain example-app.shared-domain.example.com, shared-domain.example.com is the parent domain of subdomain example-app. The following list describes requirements for creating domains:

• You can only create a private domain that is parent to a private subdomain.
• You can create a shared domain that is parent to either a shared or a private subdomain.

The domain foo.example-app.shared-domain.example.com is the child subdomain of example-app.shared-domain.example.com. The following list describes requirements for creating subdomains:

• You can create a private subdomain for a private parent domain only if the domains belong to the same org.
• You can create a private subdomain for a shared parent domain.
• You can only create a shared subdomain for a shared parent domain.
• You cannot create a shared subdomain for a private parent domain.

Resolution

Find the organization where the private parent domain was created and create the private subdomain in that organization.