Configuring REST Endpoints
This section describes how to configure the IP address, port numbers, and other attributes for a REST endpoint.
Note | Configuration changes to REST EP cause the endpoint to automatically restart. Cisco recommends making such changes only within the maintenance window. |
Before configuring the external IP addresses for the PCF REST endpoints, make sure that you configure and deploy the IP addresses using the SMI Deployer.
To configure REST endpoint, use the following configuration in the Policy Ops Center console:
config
rest-endpoint
interface [ n7 | n15 | n25 | n28 | nnrf ]
ip interface_ip_address
port interface_port_number
ips ip_address
port port_number
http-connection-limit maximum_inbound_connection_count
replicas replica_count
inbound-request-timeout-ms inbound_timeout
outbound-request-timeout-ms outbound_timeout
repository repository_address
tracing-service-name tracing_service
uri-scheme uri_scheme
end
NOTES:
-
For each rest-enpoint, use a separate rest-endpoint ip_address command.
-
interface [ n7 | n15 | n25 | n28 | nnrf ] – Specifies the interface name and IP address that is configured for the external IP. interface_name ip_address must include the interface name such as N7, N36, N28, and NNRF.
-
ip interface_ip_address – Specifies the IP address that is assigned for the interface.
-
port interface_port_number – Specifies the port number for the interface.
For example, to enable the N15 interface allocate resources such as IP and port number. Once the interface is configured, the PCF-AMF traffic can pass through N15.
-
-
ips ip_address – Specifies the IP address that is assigned as a REST endpoint external IP address.
-
port port_number – Specifies the port number for the REST endpoint.
-
http-connection-limit maximum_inbound_connection_count – Specifies the maximum number of inbound HTTP connections that the REST endpoint server must accept. Default value is 200.
-
replicas replica_count – Specifies the number of instances of the service-based interface.
-
inbound-request-timeout-ms inbound_timeout – Configures the timeout period after which the inbound request expires. You can configure a single inbound_timeout value for all the configured interfaces or the single interface.
-
outbound-request-timeout-ms outbound_timeout – Configures the timeout period after which the outbound request expires. You can configure a single outbound_timeout value for all the configured interfaces or the single interface.
-
repository repository_address – Configures a repository that the network interface optimizes.
-
tracing-service-name tracing_service – Specifies the service that is used for tracing purpose.
-
uri-scheme uri_scheme – Specifies the URI scheme as HTTP or HTTPs.
Note | If the configured IP address is not accessible, then PCF fails to connect with the other NFs and reports an error message in the service as "Failed to allocate IP for "pcf/udr-rest-ep": no available IPs". |