5 Configuration API Specifications
Configuration REST APIs are exposed directly on the nudr-config microservice of UDR, and it does not use Ingress Gateway for traffic (OAM traffic). These APIs are consumed by CNC Console GUI. For more information about APIs, see Oracle Communications Cloud Native Core, Unified Data Repository User Guide.
5.1 Configuration APIs for UDR Microservices
This section describes the configuration APIs for UDR microservices.
Table 5-1 Configuration APIs for UDR microservices
HTTP Method | Sample REST Request URL | Sample Response | Possible Error Codes |
---|---|---|---|
GET | http://ocudr-nudr-config.myudr:5001/nudr-config/v1/udr.nudrservice.cfg/DR-SERVICE |
Result Code: 200 OK Payload
|
NA |
GET | http://ocudr-nudr-config.myudr:5001/nudr-config/v1/udr.notifyservice.cfg/NOTIFY-SERVICE |
Result Code: 200 OK Payload
|
NA |
GET | http://ocudr-nudr-config.myudr:5001/nudr-config/v1/udr.global.cfg/GLOBAL |
Result Code: 200 OK Payload
|
NA |
GET | http://ocudr-nudr-config.myudr:5001/nudr-config/v1/udr.diamgateway.cfg/DIAMETER-GATEWAY |
Result Code: 200 OK Payload
|
NA |
GET | http://ocudr-nudr-config.myudr:5001/nudr-config/v1/udr.biservice.cfg/BULK_IMPORT |
Result Code: 200 OK Payload
|
NA |
GET | http://ocudr-nudr-config.myudr:5001/nudr-config/v1/udr.ondemand.cfg/ON-DEMAND |
Result Code: 200 OK Payload
|
NA |
GET | http://localhost:8081/nudr-config/v1/udr.diamgateway.congestion.cfg/DGW-CONGESTION |
Result Code: 200 OK Payload
|
NA |
GET | http://ocudr-nudr-config.myudr:5001/nudr-config/v1/udr.nudrprovservice.cfg/DR-PROV-SERVICE |
Result Code: 200 OK Payload
|
NA |
GET | http://ocudr-nudr-config.myudr:5001/nudr-config/v1/udr.bulkimportservice.cfg/BULK_IMPORT_CFG |
Result Code: 200 OK Payload
|
NA |
GET | http://ocudr-nudr-config.myudr:5001/nudr-config/v1/udr.exporttool.cfg/EXPORT_TOOL_CFG |
Result Code: 200 OK Payload
|
NA |
GET | http://ocudr-nudr-config.myudr:5001/udr/nf-common-component/v1/operationalState |
Result Code: 200 OK Payload
|
|
GET | http://ocudr-nudr-config.myudr:5001/udr/nf-common-component/v1/operationalStateHistory If offset is set to any value greater than 0 then it will return an empty array Value of the limit
greater than 5 displays only 5 records with query
params: |
Result Code: 200 OK Payload
|
|
GET | http://ocudr-nudr-config.myudr:5001/nudr-config/v1/migrationtool.status.cfg/MIGRATION_TOOL_STATUS |
|
404 Not Found: Data field does not exist 400 Bad Request |
GET | http:ocudr-nudr-config.myudr:5001/nudr-config/v1/migration.tool.cfg/MIGRATION_TOOL |
Note: The subscriber migration ranges cannot be modified. |
404 Not Found: Data field does not exist 400 Bad Request |
GET | http://ocudr-nudr-config.myudr:5001/nudr-config/v1/udr.exporttoolfilestatus.cfg/EXPORT_TOOL_FILE_STATUS |
Result Code: 200 OK Payload
|
|
GET | http://ocudr-nudr-config.myudr:5001/nudr-config/v1/udr.exporttoolstatus.cfg/EXPORT_TOOL_STATUS |
Result Code: 200 OK Payload
|
|
GET | http://ocudr-nudr-config.myudr:5001/nudr-config/v1/udr.exporttoolstatus.cfg/EXPORT_TOOL_STATUS/export-2023-01-16T14:12:33 |
Result Code: 200 OK Payload
|
|
PUT |
|
Result Code: 200 OK Payload
|
|
PUT | http://ocudr-nudr-config.myudr:5001/nudr-config/v1/udr.bulkimportservice.cfg/BULK_IMPORT_CFG |
Result Code: 200 OK Payload
|
|
PUT | http://ocudr-nudr-config.myudr:5001/nudr-config/v1/udr.exporttool.cfg/EXPORT_TOOL_CFG |
Result Code: 200 OK Payload
|
|
PUT |
|
Result Code: 200 OK Payload
|
|
PUT |
|
Result Code: 200 OK payload
|
|
PUT |
|
Result Code: 200 OK payload
|
|
PUT |
|
200 OK payload
Note: Do not change the default value of
|
|
PUT | http://ocudr-nudr-config.myudr:5001/nudr-config/v1/udr.nudrprovservice.cfg/DR-PROV-SERVICE |
Result Code: 200 OK Payload
|
|
PUT | http://ocudr-nudr-config.myudr:5001/nudr-config/v1/udr.ondemand.cfg/ON-DEMAND |
Result Code: 200 OK Payload
|
|
PUT | http://ocudr-nudr-config.myudr:5001/nudr-config/v1/udr.bulkimportservice.cfg/BULK_IMPORT_CFG |
Result Code: 200 OK Payload
|
|
PUT |
http://ocudr-nudr-config.myudr:5001/udr/nf-common-component/v1/operationalState |
Result Code: 200 OK Payload
|
|
PUT | http://ocudr-nudr-config.myudr:5001/nudr-config/v1/migration.tool.cfg/MIGRATION_TOOL |
Result Code: 200 OK Payload
|
|
DELETE |
http://ocudr-nudr-config.myudr:5001/nudr-config/v1/udr.exporttoolstatus.cfg/EXPORT_TOOL_STATUS/export-2023-01-16T14:12:33 |
Result Code: 200 OK |
|
5.2 Configuration APIs for Common Services
This section describes the configuration APIs for common services.
Table 5-2 Common Services Configuration APIs
HTTP Method | Sample Request REST URL | Sample Response |
---|---|---|
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/oauthvalidatorconfiguration Payload
|
200 OK Response Body
|
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/oauthvalidatorconfiguration |
200 OK Response Body
|
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/oauthvalidatorconfiguration Payload
|
200 OK Response Body
|
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/oauthvalidatorconfiguration |
200 OK Response Body
|
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/serverheaderdetails To enable: Payload
To disable: Payload
|
200 OK |
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/serverheaderdetails |
200 OK Response Body
|
PATCH | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/serverheaderdetails Payload
|
200 OK |
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/serverheaderdetails To enable: Payload
To disable: Payload
|
200 OK |
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/serverheaderdetails |
200 OK
|
PATCH | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/serverheaderdetails
|
200 OK |
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/useragentheadervalidation To enable: Payload
To disable: Payload
|
|
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/useragentheadervalidation |
200 OK
|
PATCH | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/useragentheadervalidation
|
200 OK |
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/useragentheadervalidation To enable: Payload
To disable: Payload
|
200 OK |
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/useragentheadervalidation |
200 OK
|
PATCH | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/useragentheadervalidation
|
200 OK |
PUT | http://localhost:8081/udr/nf-common-component/v1/nrf-client-nfmanagement/nfProfileList Request
|
200 OK |
GET | http://localhost:8081/udr/nf-common-component/v1/nrf-client-nfmanagement/nfProfileList |
200 OK
|
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/podprotection
or http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/podprotection
Note: You can use the URI for both signaling and provisioning by changing the igw in the URI address to igw-sig or igw-prov respectively. |
200 OK |
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/podprotection
or http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/podprotection Note: You can use the URI for both signaling and provisioning by changing the igw in the URI address to igw-sig or igw-prov respectively. |
200 OK
|
5.2.1 Ingress Gateway Signaling APIs
Table 5-3 Common Services Configuration APIs
HTTP Method | Sample Request REST URL | Sample Response |
---|---|---|
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/configurableerrorcodes
|
200 OK Response Body
|
PATCH | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/configurableerrorcodes
|
200 OK |
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/configurableerrorcodes
|
200 OK |
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/ocpolicymapping
|
200 OK Response Body
|
PATCH | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/ocpolicymapping
|
200 OK |
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/ocpolicymapping Payload
|
200 OK Response Body |
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/errorcodeprofiles
|
200 OK |
PATCH | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/errorcodeprofiles
|
200 OK |
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/errorcodeprofiles
|
200 OK |
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/errorcodeserieslist
|
200 OK |
PATCH | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/errorcodeserieslist
|
200 OK |
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/errorcodeserieslist
|
200 OK |
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/messagelogging
|
200 OK |
PATCH | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/messagelogging
|
200 OK |
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/messagelogging
|
200 OK |
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/oauthvalidatorconfiguration
|
200 OK |
PATCH | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/oauthvalidatorconfiguration
|
200 OK |
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/oauthvalidatorconfiguration
|
200 OK |
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/ocdiscardpolicies
|
200 OK |
PATCH | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/ocdiscardpolicies
|
200 OK |
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/ocdiscardpolicies
|
200 OK |
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/routesconfiguration
|
200 OK |
PATCH | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/routesconfiguration
|
200 OK |
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-sig/routesconfiguration
|
200 OK |
5.2.2 Ingress Gateway Provisioning APIs
This section describes the configuration APIs for Ingress Gateway Provisioning.
Table 5-4 Common Services Configuration APIs
HTTP Method | Sample Request REST URL | Sample Response |
---|---|---|
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/configurableerrorcodes
|
200 OK Response Body
|
PATCH | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/configurableerrorcodes
|
200 OK |
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/configurableerrorcodes
|
200 OK |
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/ocpolicymapping
|
200 OK Response Body
|
PATCH | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/ocpolicymapping
|
200 OK |
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/ocpolicymapping
|
200 OK |
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/errorcodeprofiles
|
200 OK |
PATCH | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/errorcodeprofiles
|
200 OK |
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/errorcodeprofiles
|
200 OK |
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/errorcodeserieslist
|
200 OK |
PATCH | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/errorcodeserieslist
|
200 OK |
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/errorcodeserieslist
|
200 OK |
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/messagelogging
|
200 OK |
PATCH | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/messagelogging
|
200 OK |
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/messagelogging
|
200 OK |
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/oauthvalidatorconfiguration
|
200 OK |
PATCH | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/oauthvalidatorconfiguration
|
200 OK |
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/oauthvalidatorconfiguration
|
200 OK |
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/ocdiscardpolicies
|
200 OK |
PATCH | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/ocdiscardpolicies
|
200 OK |
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/ocdiscardpolicies
|
200 OK |
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/routesconfiguration
|
200 OK |
PATCH | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/routesconfiguration
|
200 OK |
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/igw-prov/routesconfiguration
|
200 OK |
5.2.3 Egress Gateway APIs
This section describes the configuration APIs for Egress Gateway.
Table 5-5 Common Services Configuration APIs
HTTP Method | Sample Request REST URL | Sample Response |
---|---|---|
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/configurableerrorcodes
|
200 OK Response Body
|
PATCH | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/configurableerrorcodes
|
200 OK Response Body
|
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/configurableerrorcodes
|
200 OK |
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/errorcodeprofiles
|
200 OK Response Body
|
PATCH | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/errorcodeprofiles
|
200 OK Response Body
|
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/errorcodeprofiles
|
200 OK |
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/messagelogging
|
200 OK Response Body
|
PATCH | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/messagelogging
|
200 OK Response Body
|
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/messagelogging
|
200 OK |
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/forwardheaderdetails
|
200 OK Response Body
|
PATCH | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/forwardheaderdetails
|
200 OK Response Body
|
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/forwardheaderdetails
|
200 OK |
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/peerconfiguration
|
200 OK Response Body
|
PATCH | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/peerconfiguration
|
200 OK Response Body
|
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/peerconfiguration
|
200 OK |
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/peersetconfiguration
|
200 OK Response Body
|
PATCH | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/peersetconfiguration
|
200 OK Response Body
|
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/peersetconfiguration
|
200 OK |
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/retryprofile
|
200 OK Response Body
|
PATCH | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/retryprofile
|
200 OK Response Body
|
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/retryprofile
|
200 OK |
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/routesconfiguration
|
200 OK Response Body
|
PATCH | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/routesconfiguration
|
200 OK Response Body
|
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/routesconfiguration
|
200 OK |
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/sbiroutingerroractionsets
|
200 OK
|
PATCH | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/sbiroutingerroractionsets
|
200 OK
|
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/sbiroutingerroractionsets
|
200 OK |
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/sbiroutingerrorcriteriasets
|
200 OK
|
PATCH | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/sbiroutingerrorcriteriasets
|
200 OK
|
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/sbiroutingerrorcriteriasets
|
200 OK |
PUT | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/useragentheader
|
200 OK
|
PATCH | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/useragentheader
|
200 OK
|
GET | http://<nudr-config svc
IP>:<port>/udr/nf-common-component/v1/egw/useragentheader
|
200 OK |
5.2.4 Configuration APIs for Overload Handling
This section describes the configuration APIs on Ingress Gateway and perf-info microservices for overload handling.
Table 5-6 Configuration APIs on Ingress Gateway for Overload Handling
HTTP Method | Sample Request REST URL | Sample Response |
---|---|---|
PUT |
igw-sig URL:
oc policy
mapping
igw-prov URL:
oc policy
mapping
|
Response is same as Request payload. |
PUT |
igw-sig URL:
igw-prov URL:
For payload, see PUT - OC Discard Policy. |
Response is same as Request payload. |
PUT |
igw-sig URL:
igw-prov URL:
For payload, see PUT - Error Code Profiles. |
Response is same as Request payload. |
PUT |
igw-sig URL:
igw-prov URL:
For payload, see PUT - Routes Configuration. |
Response is same as Request payload. |
PUT |
igw-sig URL:
igw-prov URL:
error code series
|
Response is same as Request payload. |
Table 5-7 Configuration APIs on perf-info for Overload Handling
HTTP Method | Sample Request REST URL | Sample Response |
---|---|---|
PUT |
URL:
For payload, see PUT - Overload Threshold Configuration |
Response is same as Request payload. |
For more information about the Overload Handling configurable parameters, see Oracle Communications Cloud Native Core Unified Data Repository Installation and Upgrade Guide.
5.2.5 Configuration APIs for Rate Limit
This section describes the configuration APIs on Ingress Gateway for rate limiting feature.
Table 5-8 Configuration APIs on Ingress Gateway for Rate Limiting
HTTP Method | Sample Request REST URL | Sample Response | Notes |
---|---|---|---|
PUT |
URL:
routesconfiguration
|
routesconfiguration
|
Response is same as request |
PUT |
URL: http://10.75.229.75:31187/udr/nf-common-component/v1/igw/routelevelratelimiting routelevelratelimiting
|
routelevelratelimiting
|
Response is same as request |
PUT |
URL:
errorcodeprofiles
|
errorcodeprofiles
|
Response is same as request |
5.2.5.1 Default Configuration Details for Rate Limit
The default configuration details for rate limit are:
Important:
The default deployment setup includes two Ingress Gateways and two DR pods. The following default rates are derived based on this deployment setup. If you want to scale up the pods, then adjust or configure the route rates accordingly. The route rates are available under routesconfiguration of http://10.75.229.75:31187/udr/nf-common-component/v1/igw/routesconfiguration.- RouteId-Path - traffic_mapping_http - nudr-dr
Table 5-9 Method wise Rate Details
Method Rate GET 200 PUT 300 POST 200 PATCH 200 DELETE 200 - RouteId-Path - traffic_mapping_http_prov - nudr-dr-prov
Table 5-10 Method wise Rate Details
Method Rate GET 200 PUT 300 POST 200 PATCH 200 DELETE 200 - RouteId-Path - traffic_mapping_http_group - nudr-group-id-map
Table 5-11 Method wise Rate Details
Method Rate GET 1350 - RouteId-Path - traffic_mapping_http_group_prov - nudr-group-id-map-prov
Table 5-12 Method wise Rate Details
Method Rate GET 800 PUT 200 DELETE 200 - RouteId-Path - traffic_mapping_http_slf_group_prov - slf-group-prov
Table 5-13 Method wise Rate Details
Method Rate GET 800 PUT 200 DELETE 200
5.3 Configuration APIs for Subscriber Bulk Import Tool and Subscriber Export Tool
Table 5-14 Configuration APIs for Subscriber Bulk Import Tool
HTTP Method | Sample Request REST URL | Sample Response | Notes |
---|---|---|---|
POST | URL:
http://10.75.229.157:31725/nudr-config/v1/import
|
Result Code: 201 Created Payload Import resource id: 552a4328-21ec-43aa-a460-58ce1df407ae |
This is the first step to initiate import. |
GET | URL :
http://10.75.229.157:31725/nudr-config/v1/import
|
Result Code: 200 OK
Payload
|
This API is to get the existing import id.
404 Not Found 500 Internal Server Error |
GET |
URL:
Import resource id: 552a4328-21ec-43aa-a460-58ce1df407ae |
Result Code: 200 OK Payload
|
This is the second step. Keep calling this API until "percentage": "100" |
GET | URL:
http://10.75.229.157:31725/nudr-config/v1/import/552a4328-21ec-43aa-a460-58ce1df407ae/report Import resource id: 552a4328-21ec-43aa-a460-58ce1df407ae |
Result Code: 200 OK Payload
|
This is the third step. This API gives complete import report. |
Table 5-15 Configuration APIs for Subscriber Export Tool.
HTTP Method | Sample Request REST URL | Sample Response | Notes |
---|---|---|---|
POST |
|
Result Code: 201 Created Payload Export resource id: 3e470fab-e131-4dbe-be67-ba7391729254 |
This is the first step to initiate export. |
GET | To export all services :
http://10.75.229.157:31725/nudr-config/v1/export |
Result Code: 200 OK
Payload
|
This API is to get the existing export id.
Possible error codes 404 Not Found 500 Internal Server Error |
GET |
URI:
Export resource id: 3e470fab-e131-4dbe-be67-ba7391729254 |
Result Code: 200 OK Payload
|
This is the second step. Keep calling this API until "percentage": "100". |
GET |
URI:
Export resource id: 3e470fab-e131-4dbe-be67-ba7391729254 |
Result Code: 200 OK Payload
|
This is the third step. This API gives complete export report. |
GET |
URI:
Export resource id: 3e470fab-e131-4dbe-be67-ba7391729254 |
Result Code: 200 OK exportedFiles_ 1.12.0_20210706080247.zip |
This is the fourth step. This API is used to download exported zip file. |
For more information about the Subscriber Bulk Import Tool and Subscriber Export Tool configurable parameters, see Oracle Communications Cloud Native Core Unified Data Repository User Guide.
5.4 Configuration APIs for Loglevel
This section describes the configuration APIs for loglevel.
Table 5-16 Configuration APIs for Loglevel
HTTP Method | Sample Request REST URL | Sample Response | Notes |
---|---|---|---|
GET | URI:
http://10.75.229.168:32310/nudr-config/v1/nudr-drservice/logging |
Result Code: 200 OK Payload
|
NA |
GET | http://10.75.229.168:32310/nudr-config/v1/nudr-notify-service/logging |
Result Code: 200 OK Payload
|
NA |
GET | http://10.75.229.168:32310/nudr-config/v1/nudr-diameterproxy/logging |
Result Code: 200 OK Payload
|
NA |
GET | http://10.75.229.168:32310/nudr-config/v1/diam-gateway/logging |
Result Code: 200 OK Payload
|
NA |
GET | http://10.75.229.168:32310/nudr-config/v1/nudr-ondemand-migration/logging |
Result Code: 200 OK Payload
|
NA |
GET | http://10.75.229.168:32527/udr/nf-common-component/v1/igw-sig/logging |
Result Code: 200 OK Payload
|
NA |
GET | http://10.75.229.168:32527/udr/nf-common-component/v1/igw-prov/logging |
Result Code: 200 OK Payload
|
NA |
GET | http://10.75.229.168:32527/udr/nf-common-component/v1/egw/logging |
Result Code: 200 OK Payload
|
NA |
GET | http://10.75.229.168:32527/udr/nf-common-component/v1/alt-route/logging |
Result Code: 200 OK Payload
|
NA |
GET |
|
200 OK Response
|
|
GET | http://10.75.229.168:31867/nudr-config/v1/all/logging |
Result Code: 200 OK Payload
|
NA |
GET | http://10.75.229.168:32310/nudr-config/v1/nudr-dr-provservice/logging |
Result Code: 200
OK
|
NA |
GET |
http://10.75.229.168:32310/nudr-config/v1/nudr-bulk-import/logging |
Result Code: 200
OK
|
NA |
GET | http://10.75.229.168:32310/nudr-config/v1/nudr-export-tool/logging |
200 Created Payload
|
NA |
GET | http://10.75.180.253:30601/nudr-config/v1/nudr-config/logging |
200 Created Payload
|
NA |
PUT |
URI:
|
201 Created Payload
|
|
PUT |
|
201 Created Payload
|
|
PUT | http://10.75.229.168:32310/nudr-config/v1/nudr-diameterproxy/logging |
201 Created Payload
|
|
PUT |
|
201 Created Payload
|
|
PUT |
|
201 Created Payload
|
|
PUT |
|
200 OK Payload
|
|
PUT | http://10.75.229.168:32527/udr/nf-common-component/v1/igw-prov/logging |
200 OK Payload
|
|
PUT |
|
200 OK Payload
|
|
PUT |
|
200 OK Payload
|
|
PUT |
|
200 OK Response
|
|
PUT | http://10.75.229.168:32310/nudr-config/v1/nudr-dr-provservice/logging |
201 created Payload
|
|
PUT |
http://10.75.229.168:32310/nudr-config/v1/nudr-bulk-import/logging |
201 created Payload
|
|
PUT | http://10.75.229.168:32310/nudr-config/v1/nudr-export-tool/logging |
201 created Payload
|
|
PUT | http://10.75.180.253:30601/nudr-config/v1/nudr-config/logging |
201 created Payload
|
|
5.5 List of Errors and their Details
The list of errors and their details are as follows:
Table 5-17 Error Code Catalogue
Error Details | Possible Causes | Corrective Actions |
---|---|---|
Error Code: E550 HTTP Response Code: 404 Category: CFG Error Description: The import or export ResourceId or report not found |
Provided import or export ResourceId is incorrect. The import or export report with the provided ResourceId is not found. |
Check if the provided import or export ResourceId is correct. |
Error Code: E551 HTTP Response Code: 500 Category: CFG Error Description: Retrieving the report or status of import or export when the operation is still in progress. |
Retrieving the report or status of import or export when the operation is still in progress. |
Try after the existing import or export is completed. |
Error Code: E552 HTTP Response Code: 500 Category: CFG Error Description:The import or exportt report is not generated. |
The import or export report creation failed. |
NA |
Error Code: E553 HTTP Response Code: 400 Category: CFG Error Description: Empty or incorrect MO passed. |
Empty MO value passed or the passed MO value is incorrect. |
Provide a valid MO value. |
Error Code: E554 HTTP Response Code: 400 Category: CFG Error Description: The file provided for the import has unsupported file format or file content. |
Import file other than ZIP file format is provided. Error reading zip stream or unable to extract contents of file. |
Check and upload the file with supported format and file content. |
E555
HTTP Response Code: 500 Category: CFG Error Description: Another import or export operation request is in progress. |
Another import or export request is in progress. |
You must wait for previous requests to complete before performing another import or export operation. |
Error Code: E556 HTTP Response Code: 500 Category: CFG Error Description: Unable to download exported data |
Could not create exported JSON files. |
NA |
Error Code: E557 HTTP Response Code: 400 Category: CFG Error Description: Controlled Shutdown feature is disabled |
Controlled shutdown feature is disabled when updating OperationalStatus. |
Enable the controlled shutdown feature. |
Error Code: E558 HTTP Response Code: 400 Category: CFG Error Description: Invalid OperationalState |
Invalid OperationalState provided. |
Provide operationalState with "NORMAL" or "COMPLETE_SHUTDOWN" |
Error Code: E559 HTTP Response Code: 403 Category: CFG Error Description: Read only field can not be modified. |
Tried to modify a read only field. |
NA |
Error Code: E560 HTTP Response Code: 400 Category: CFG Error Description: Invalid URI sent from client. |
The URI in the request is invalid or does not comply to the specification. |
Check the specification for the correct URI. |
Error Code: E561 HTTP Response Code: 415 Category: CFG Error Description: Unsupported Media Type Header |
The handleHttpMediaType is not supported. |
Content type header is incorrect. |
Error Code: E562 HTTP Response Code: 406 Category: CFG Error Description: Media type header not acceptable. |
The handleHttpMediaType is not supported. |
Accept header is incorrect. |
Error Code: E564 HTTP Response Code: 400 Category: CFG Error Description: Invalid schema content supplied or schema validation failed. |
Schema update request payload, json content is invalid. The request payload json content does not comply to schema defined. |
Check the schema for correctness and formatting issues. |
Error Code: E565 HTTP Response Code: 404 Category: CFG Error Description: Data field does not exist. |
The request sent for unavailable service configuration data. | Check if the service key or id used is valid. |
Error Code: E566 HTTP Response Code: 404 Category: CFG Error Description: NF Operational State not found. |
NF Operational status is not found. | NA |
Error Code: E567 HTTP Response Code: 404 Category: CFG Error Description: Operational State History not present for the limit. |
Operational State History for the limit is not found. |
NA |
Error Code: E568 HTTP Response Code: 404 Category: CFG Error Description: NF score not available. |
NF score not available. | NA |
Error Code: E569 HTTP Response Code: 400 Category: CFG Error Description: Peer identity must be unique |
Multiple peers with same identity is received. |
Make sure to use unique for every diam serverpeer. |
Error Code: E570 HTTP Response Code: 500 Category: DB Error Description: SQL Command Grammar Error |
SQL statement syntax issues. |
Check the logs for more details. |
Error Code: E571 HTTP Response Code: 500 Category: DB Error Description: Resource accessed in an invalid fashion. |
Database fetch failure. |
Check the logs for more details. |
Error Code: E572 HTTP Response Code: 500 Category: DB Error Description: Permission denied to requested resource on the database. |
Database access failed due to permission issues. |
Check the logs for more details. |
Error Code: E573 HTTP Response Code: 503 Category: DB Error Description: Database table or resource not accessible. |
Data retrieval from database failed. |
Check the database availability and connectivity. Check the logs for more information on SQL state. |
Error Code: E574 HTTP Response Code: 503 Category: DB Error Description: Transient database access issue. |
Data retrieval from database failed. |
Check the database availability and connectivity. Check the logs for more information on SQL state. |
Error Code: E575 HTTP Response Code: 503 Category: DB Error Description: Cannot acquire lock on database resource. |
Data retrieval from database failed. |
Check the database state and database. Check the logs for more information on SQL state. |
Error Code: E576 HTTP Response Code: 400 Category: CFG Error Description: Insertion or update of invalid records to database. |
Internal SQL transaction failures due to invalid records not matching table schema. |
Check the content shared in payload from where the content is formed for insertion or update. |
Error Code: E577 HTTP Response Code: 404 Category: CFG Error Description: Resource fetch from database failed. |
Exception occurred during resource fetch from database. |
Check the logs for more information on failures. |
Error Code: E578 HTTP Response Code: 400 Category: CFG Error Description: Invalid payload. |
Internal JSON format data formation failure or invalid parameters passed, or, empty payload is passed. |
Check for any missing required parameters in the payload or check for provided empty payload. |
Error Code: E579 HTTP Response Code: 400 Category: CFG Error Description: Invalid format of data |
Invalid payload. Parameter with number type is not set correctly. |
Check the number or integer parameters are correct in the payload. |
Error Code: E580 HTTP Response Code: 405 Category: CFG Error Description: Operation not allowed. |
REST API used does not support the requested operation type. |
Check the specification for the allowed operations for provided REST API in request. |
Error Code: E581 HTTP Response Code: 500 Category: CFG Error Description: Internal server error |
Unidentified internal server errors. |
Check the logs for more details. |
Error Code: E582 HTTP Response Code: 400 Category: CFG Error Description: Subscriber export ranges are not valid. |
The provided start range value is greater than the end range value. |
Provide the correct values for start range and end range. |