Skip to main content

​
Overview

The service catalog registers every Xloud service endpoint so clients can discover the correct API URL for each service and region. It is included in every authentication token response, enabling the openstack CLI and Dashboard to route requests correctly without hard-coded URLs. Each catalog entry includes the service type, endpoint interface (public, internal, admin), region, and URL.
Administrator Access Required — This operation requires the admin role. Contact your Xloud administrator if you do not have sufficient permissions.

​
Catalog Structure

ConceptDescription
ServiceA registered Xloud service (compute, image, block-storage, network, etc.)
EndpointA URL for a specific service, interface type, and region combination
Interfacepublic (external clients), internal (service-to-service), or admin (administrative operations)
RegionLogical grouping for geographically or administratively separate deployments

​
View the Service Catalog

Navigate to Identity → Services to view all registered services, and Identity → Endpoints to view and manage endpoint URLs for each service.

​
Manage Endpoints

Create a public endpoint for Compute
openstack endpoint create \
  --region RegionOne \
  compute public https://api.<your-domain>:8774/v2.1
Create an internal endpoint
openstack endpoint create \
  --region RegionOne \
  compute internal http://10.0.1.71:8774/v2.1

​
Standard Service Registrations

The following services are registered during XDeploy deployment. Verify they are present after a fresh deployment or endpoint migration:
Service TypePublic PortDescription
identity5000Authentication and authorization
compute8774Virtual machine management
image9292Image and snapshot management
block-storage8776Persistent block volumes
network9696Virtual networking
object-store8080Object storage (if enabled)
load-balancer9876Load balancing (if enabled)
dns9001DNS as a Service (if enabled)
key-manager9311Secrets and key management (if enabled)

​
Verify Catalog After Endpoint Changes

After modifying endpoints, verify that clients can resolve the updated URLs:
Test catalog resolution
openstack --os-cloud admin catalog show compute
Verify CLI uses the correct endpoint
openstack server list -v 2>&1 | grep "GET http"

​
Next Steps

Domain Management

Manage the domains that own the users and projects accessing these services.

Admin Troubleshooting

Resolve service catalog misconfigurations and endpoint routing errors.

Authentication Backends

Configure the authentication drivers that issue tokens containing the service catalog.

Architecture

Understand how the service catalog fits into the authentication flow.