Ultra Cloud Core 5G Policy Control Function, Release 2021.02 - API Reference First Published: 2021-05-03 Americas Headquarters Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA http://www.cisco.com Tel: 408 526-4000 800 553-NETS (6387) Fax: 408 527-0883 THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS. THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY. The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB's public domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California. NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS" WITH ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE. IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental. All printed copies and duplicate soft copies of this document are considered uncontrolled. See the current online version for the latest version. Cisco has more than 200 offices worldwide. Addresses and phone numbers are listed on the Cisco website at www.cisco.com/go/offices. Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: https://www.cisco.com/c/en/us/about/legal/trademarks.html. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1721R) © 2021 Cisco Systems, Inc. All rights reserved. CONTENTS PREFACE About this Guide vii Conventions Used vii Contacting Customer Support viii CHAPTER 1 Npcf_AMPolicyControl 1 OpenAPI 1 Info 1 Servers 1 Security 2 Paths 2 /policies 2 /policies/{polAssoId} 4 /policies/{polAssoId}/update 6 Components 7 CHAPTER 2 Nnrf_NFDiscovery 11 OpenAPI 11 Info 11 Servers 11 Security 12 Paths 12 /nf-instances 12 Components 17 External Docs 20 CHAPTER 3 Nnrf_NFManagement 21 Ultra Cloud Core 5G Policy Control Function, Release 2021.02 - API Reference iii Contents OpenAPI 21 Info 21 Servers 21 Security 22 Paths 22 /nf-instances 22 /nf-instances/{nfInstanceID} 23 /subscriptions 26 /subscriptions/{subscriptionID} 28 Components 30 External Docs 48 CHAPTER 4 Npcf_SMPolicyControl 49 OpenAPI 49 Info 49 Servers 49 Security 50 Paths 50 /sm-policies 50 /sm-policies/{smPolicyId} 52 /sm-policies/{smPolicyId}/update 53 /sm-policies/{smPolicyId}/delete 54 Components 55 External Docs 81 CHAPTER 5 Nchf_SpendingLimitControl 83 OpenAPI 83 Info 83 Servers 83 Security 84 Paths 84 /subscriptions 84 /subscriptions/{subscriptionId} 86 Components 88 Ultra Cloud Core 5G Policy Control Function, Release 2021.02 - API Reference iv Contents External Docs 90 CHAPTER 6 Nchf_SpendingLimitControl_Callbacks 91 OpenAPI 91 Info 91 Servers 91 Security 91 Paths 92 /npcf/callbacks/nchf-spendinglimitcontrol/v1/subscriptions/{subscriptionId}/notify 92 /npcf/callbacks/nchf-spendinglimitcontrol/v1/subscriptions/{subscriptionId}/terminate 93 Components 93 Ultra Cloud Core 5G Policy Control Function, Release 2021.02 - API Reference v Contents Ultra Cloud Core 5G Policy Control Function, Release 2021.02 - API Reference vi About this Guide This preface describes the Ultra Cloud Core 5G Policy Control Function API Reference, the document conventions, and the customer support details. • Conventions Used, on page vii • Contacting Customer Support, on page viii Conventions Used The following tables describe the conventions used throughout this documentation. Notice Type Description Information Note Provides information about important features or instructions. Caution Alerts you of potential damage to a program, device, or system. Warning Alerts you of potential personal injury or fatality. May also alert you of potential electrical hazards. Typeface Conventions Description Text represented as a screen display This typeface represents displays that appear on your terminal screen, for example: Login: Text represented as commands This typeface represents commands that you enter, for example: show ip access-list This document always gives the full form of a command in lowercase letters. Commands are not case sensitive. Ultra Cloud Core 5G Policy Control Function, Release 2021.02 - API Reference vii About this Guide Contacting Customer Support Typeface Conventions Description Text represented as a command variable This typeface represents a variable that is part of a command, for example: show card slot_number slot_number is a variable representing the desired chassis slot number. Text represented as menu or sub-menu names This typeface represents menus and sub-menus that you access within a software application, for example: Click the File menu, then click New Contacting Customer Support Use the information in this section to contact customer support. Refer to the support area of http://www.cisco.com for up-to-date product documentation or to submit a service request. A valid username and password are required to access this site. Please contact your Cisco sales or service representative for additional information. Ultra Cloud Core 5G Policy Control Function, Release 2021.02 - API Reference viii CHAPTER 1 Npcf_AMPolicyControl The PCF uses the Npcf_AMPolicyControl API to communicate with the Access and Mobility Management Function (AMF) over the N15 Interface. • OpenAPI, on page 1 • Info, on page 1 • Servers, on page 1 • Security, on page 2 • Paths, on page 2 • Components, on page 7 OpenAPI OpenAPI Version: 3.0.0 Info Description: Access and Mobility Policy Control Service API Version: "1.0.0" Title: Npcf_AMPolicyControl Servers URL: '{apiRoot}/npcf-am-policy-control/v1' Variables: API Root: Default: https://example.com Description: apiRoot as defined in subclause subclause 4.4 of 3GPP TS 29.501 Ultra Cloud Core 5G Policy Control Function, Release 2021.02 - API Reference 1 Npcf_AMPolicyControl Security Security - {} - oAuth2ClientCredentials: - npcf-am-policy-control Paths /policies Method: Post Request Body: Required/Optional: true Content: Application/JSON: Schema: Reference: '#/components/schemas/PolicyAssociationRequest' Responses: '201': Description: Created Content: Application/JSON: Schema: Reference: '#/components/schemas/PolicyAssociation' Headers: Location: description: 'Contains the URI of the newly created resource, according to the structure: {apiRoot}/npcf-am-policy-control/v1/policies/{polAssoId}' Required/Optional: true Schema: Type: string '400': Reference: 'TS29571_CommonData.yaml#/components/responses/400' '401': Reference: 'TS29571_CommonData.yaml#/components/responses/401' '403': Reference: 'TS29571_CommonData.yaml#/components/responses/403' '404': Reference: 'TS29571_CommonData.yaml#/components/responses/404' '411': Reference: 'TS29571_CommonData.yaml#/components/responses/411' '413': Reference: 'TS29571_CommonData.yaml#/components/responses/413' '415': Reference: 'TS29571_CommonData.yaml#/components/responses/415' Ultra Cloud Core 5G Policy Control Function, Release 2021.02 - API Reference 2 Npcf_AMPolicyControl /policies '429': Reference: 'TS29571_CommonData.yaml#/components/responses/429' '500': Reference: 'TS29571_CommonData.yaml#/components/responses/500' '503': Reference: 'TS29571_CommonData.yaml#/components/responses/503' Default: Reference: 'TS29571_CommonData.yaml#/components/responses/default' Callbacks: policyUpdateNotification: '{$request.body#/notificationUri}/update': Method: Post Request Body: Required/Optional: true Content: Application/JSON: Schema: Reference: '#/components/schemas/PolicyUpdate' Responses: '204': Description: No Content, Notification was succesfull '307': Description: temporary redirect '400': Reference: 'TS29571_CommonData.yaml#/components/responses/400' '401': Reference: 'TS29571_CommonData.yaml#/components/responses/401' '403': Reference: 'TS29571_CommonData.yaml#/components/responses/403' '404': Reference: 'TS29571_CommonData.yaml#/components/responses/404' '411': Reference: 'TS29571_CommonData.yaml#/components/responses/411' '413': Reference: 'TS29571_CommonData.yaml#/components/responses/413'