Service Catalog

Overview

The service catalog registers every Polystack 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 Polystack administrator if you do not have sufficient permissions.

Catalog Structure

Concept	Description
Service	A registered Polystack service (compute, image, block-storage, network, etc.)
Endpoint	A URL for a specific service, interface type, and region combination
Interface	`public` (external clients), `internal` (service-to-service), or `admin` (administrative operations)
Region	Logical grouping for geographically or administratively separate deployments

View the Service Catalog

Dashboard
CLI

Navigate to Global Setting > System Info to view all registered services, and Global Setting > System Info to view and manage endpoint URLs for each service.

List all registered services

openstack service list

List all endpoints

openstack endpoint list

List endpoints for a specific service

openstack endpoint list --service compute

Show the current token's service catalog

openstack catalog list

Manage Endpoints

Create endpoint
Update endpoint
Delete endpoint

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

Update an existing endpoint URL

openstack endpoint set \
  --url https://api.<your-domain>:8774/v2.1 \
  <ENDPOINT_ID>

Disable an endpoint

openstack endpoint set --disable <ENDPOINT_ID>

Delete an endpoint

openstack endpoint delete <ENDPOINT_ID>

Deleting an endpoint makes the associated service undiscoverable via the catalog. Clients that rely on catalog discovery will fail to resolve the service URL. Always ensure a replacement endpoint is registered before removing an existing one.

Standard Service Registrations

The following services are registered during the deployment console deployment. Verify they are present after a fresh deployment or endpoint migration:

Service Type	Public Port	Description
`identity`	5000	Authentication and authorization
`compute`	8774	Virtual machine management
`image`	9292	Image and snapshot management
`block-storage`	8776	Persistent block volumes
`network`	9696	Virtual networking
`object-store`	8080	Object storage (if enabled)
`load-balancer`	9876	Load balancing (if enabled)
`dns`	9001	DNS as a Service (if enabled)
`key-manager`	9311	Secrets 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.

Core Services

Other Services

Overview

Catalog Structure

View the Service Catalog

Manage Endpoints

Standard Service Registrations

Verify Catalog After Endpoint Changes

Next Steps

Domain Management

Admin Troubleshooting

Authentication Backends

Architecture

​Overview

​Catalog Structure

​View the Service Catalog

​Manage Endpoints

​Standard Service Registrations

​Verify Catalog After Endpoint Changes

​Next Steps

Domain Management

Admin Troubleshooting

Authentication Backends

Architecture

Overview

Catalog Structure

View the Service Catalog

Manage Endpoints

Standard Service Registrations

Verify Catalog After Endpoint Changes

Next Steps