[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"doc-detail-166254-en":3,"doc-seo-166254-105":30,"detail-sidebar-cat-1-en-105":92},{"code":4,"msg":5,"data":6},0,"success",{"doc_id":7,"user_id":8,"nickname":9,"user_avatar":10,"doc_module":11,"category_id":12,"category_name":13,"doc_title":14,"doc_description":15,"doc_content":16,"file_id":17,"file_url":18,"file_type":19,"file_size":20,"view_count":4,"is_deleted":4,"is_public":11,"is_downloadable":11,"audit_status":11,"page_count":21,"language":22,"language_code":23,"site_id":24,"html_lang":23,"table_of_contents":25,"faqs":26,"seo_title":27,"seo_description":15,"update_tm":28,"read_time":29},166254,962085662650,"Dozel","https://ap-avatar.wpscdn.com/davatar_29158cc5080c5b710cf443261637dec0",1,158,"General","Paragon Insights REST API 编排指南 - 介绍","This guide explains how to integrate Paragon Insights with a network service orchestrator using the Paragon Insights REST API. The RESTful interface follows OpenAPI/Swagger 2.0 conventions to enable efficient orchestration of Paragon Insights operations. It describes Paragon Insights as a programmable device diagnostics and network analytics platform that aggregates time-sensitive telemetry, supports closed-loop automation, and delivers actionable insights. It also covers identity management and the REST-based authentication workflow required to obtain tokens for subsequent API calls.","Published\n2023-05-22\nREST API Orchestration Guide\nfor Paragon Insights\n\u000f\n\u000f\nIntroduction\nThis documentation describes how to integrate Paragon Insights with a network service orchestrator via the Paragon Insights REST API. This is a RESTful API that adheres to the standardized OpenAPI/Swagger 2.0 definition format, thereby enabling easy and efficient orchestration of Paragon Insights operations.\nConventions\nThe following abbreviations are used in this document:\n\u000f\nOverview\nParagon Insights is a highly automated and programmable device-level diagnostics and network analytics tool that provides consistent and coherent operational intelligence across network deployments. Paragon Insights integrates multiple data collection methods (such as Junos Telemetry Interface (JTI), NETCONF, syslog, and SNMP) to aggregate and correlate large volumes of time-sensitive telemetry data, thereby providing a multidimensional and predictive view of the network. Additionally, Paragon Insights translates troubleshooting, maintenance, and real-time analytics into an intuitive user experience to give network operators actionable insights into the health of individual devices and of the overall network.\nParagon Insights offers closed-loop automation. The automation workflow can be divided into following steps.\n\u0013 INCLUDEPICTURE \"https://www.juniper.net/documentation/images/g301000-g301999/g301020.png\" \\* MERGEFORMATINET \u0014\n\u0015\nDefine—The user defines the health parameters of key network elements through customizable key performance indicators (KPIs), rules, and playbooks, by using the tools provided by Paragon Insights.\nCollect—Paragon Insights collects rule-based telemetry data from multiple devices using the collection methods specified for the different network devices.\nStore—Paragon Insights stores time-sensitive telemetry data in a time-series database (TSDB). This allows users to query, perform operations on, and write new data back to the database, days, or even weeks after the initial storage.\nAnalyze—Paragon Insights analyzes telemetry data based on the specified KPIs, rules, and playbooks.\nVisualize—Paragon Insights provides multiple ways for you to visualize the aggregated telemetry data through its web-based GUI to gain actionable and predictive insights into the health of your devices and the overall network.\nNotify—Paragon Insights notifies you through the GUI and notification alarms when problems in individual devices or in the network are detected.\nAct—Paragon Insights performs user-defined actions to help resolve and proactively prevent network problems.\nIdentity Management\nThe authentication of user is defined through following entities:\nRoles : This is a collection of capabilities. A capability represent the service and method associated with it\nScopes: It provides a context for assigning roles to user. User is assigned role on a scope that will be used for RBAC enforcement.\nScopes can be hierarchical, for example:\nService Provider (this is default scope for Paragon Insights )\nOperating Company (OpCo)\nTenant\nDepartment\nUsers : An account created with Paragon. The user can be associated with multiple scope and the access is controlled thorough the rules mapped to that scope.\nThe authentication works using these concept\nUser login through registered credentials, it returns a list of scopes and a token for next step\nUser can now try opening a login session with any one of the available scope (scope_id) and token provided\nUpon successful authentication it will return the available capabilities for that session along with token (id_token).\nThe id_token will be used for any further API call.\nManaging through REST API\nThe above workflow can be managed through REST APIs. Each REST API operation consists of an HTTP method (for example, GET, PUT, POST, or DELETE) applied to a URL with a specified syntax. The operations are divided into two categories:\nAuthentication\nAll the APIs are protected with IAM policies. To access the API the user should gene","cbCaiv9BDM2R0Y7d","https://ap.wps.com/l/cbCaiv9BDM2R0Y7d","docx",242660,38,"English","en",105,"# Introduction\n## Conventions\n## Overview\n## Closed-loop automation workflow\n## Identity Management\n## Managing through REST API\n## Authentication","[{\"question\":\"Paragon Insights REST API 用于什么集成场景？\",\"answer\":\"用于将 Paragon Insights 与网络服务编排器进行集成，通过REST API编排对 Paragon Insights 的操作。该API遵循 OpenAPI/Swagger 2.0 规范，便于高效调用。\"},{\"question\":\"Paragon Insights 的闭环自动化流程包含哪些步骤？\",\"answer\":\"流程包括：Define、Collect、Store、Analyze、Visualize、Notify、Act。它从定义健康参数与规则开始，采集并存储遥测数据，再分析、可视化、通知并执行用户定义的动作。\"},{\"question\":\"如何通过 REST API 获取后续调用所需的身份令牌？\",\"answer\":\"先使用有效凭据调用认证接口获取 scope 信息，并在成功后得到 token。后续API调用时，用获取到的 id_token 放入REST请求头（x-iam-token）以访问受保护的API。\"}]","Paragon Insights REST API 编排指南 - 介绍 | DOCX",1788188004,13,{"code":4,"msg":31,"data":32},"ok",{"site_id":24,"language":23,"slug":33,"title":14,"keywords":34,"description":15,"schema_data":35,"social_meta":87,"head_meta":89,"extra_data":91,"updated_unix":28},"paragon-insights-rest-api-orchestration-guide-introduction","",{"@graph":36,"@context":86},[37,54,69],{"@type":38,"itemListElement":39},"BreadcrumbList",[40,44,48,51],{"item":41,"name":42,"@type":43,"position":11},"https://docshare.wps.com","Home","ListItem",{"item":45,"name":46,"@type":43,"position":47},"https://docshare.wps.com/template/","Template",2,{"item":49,"name":13,"@type":43,"position":50},"https://docshare.wps.com/template/general/",3,{"item":52,"name":14,"@type":43,"position":53},"https://docshare.wps.com/template/paragon-insights-rest-api-orchestration-guide-introduction/166254/",4,{"url":52,"name":14,"@type":55,"author":56,"headline":14,"publisher":58,"fileFormat":61,"inLanguage":23,"description":15,"dateModified":62,"datePublished":63,"encodingFormat":61,"isAccessibleForFree":64,"interactionStatistic":65},"DigitalDocument",{"name":9,"@type":57},"Person",{"url":41,"name":59,"@type":60},"DocShare","Organization","application/vnd.openxmlformats-officedocument.wordprocessingml.document","2026-09-01","2026-08-31",true,{"@type":66,"interactionType":67,"userInteractionCount":11},"InteractionCounter",{"@type":68},"ViewAction",{"@type":70,"mainEntity":71},"FAQPage",[72,78,82],{"name":73,"@type":74,"acceptedAnswer":75},"Paragon Insights REST API 用于什么集成场景？","Question",{"text":76,"@type":77},"用于将 Paragon Insights 与网络服务编排器进行集成，通过REST API编排对 Paragon Insights 的操作。该API遵循 OpenAPI/Swagger 2.0 规范，便于高效调用。","Answer",{"name":79,"@type":74,"acceptedAnswer":80},"Paragon Insights 的闭环自动化流程包含哪些步骤？",{"text":81,"@type":77},"流程包括：Define、Collect、Store、Analyze、Visualize、Notify、Act。它从定义健康参数与规则开始，采集并存储遥测数据，再分析、可视化、通知并执行用户定义的动作。",{"name":83,"@type":74,"acceptedAnswer":84},"如何通过 REST API 获取后续调用所需的身份令牌？",{"text":85,"@type":77},"先使用有效凭据调用认证接口获取 scope 信息，并在成功后得到 token。后续API调用时，用获取到的 id_token 放入REST请求头（x-iam-token）以访问受保护的API。","https://schema.org",{"og:url":52,"og:type":88,"og:title":14,"og:site_name":59,"og:description":15},"article",{"robots":90,"canonical":52},"index,follow",{"doc_id":7,"site_id":24},{"code":4,"msg":5,"data":93},[94,99,104,109,114,119,124,129,134],{"id":95,"doc_module":11,"doc_module_name":46,"category_name":96,"show_sort_weight":97,"slug":98},11,"Presentations",90,"presentations",{"id":100,"doc_module":11,"doc_module_name":46,"category_name":101,"show_sort_weight":102,"slug":103},12,"Resumes",80,"resumes",{"id":105,"doc_module":11,"doc_module_name":46,"category_name":106,"show_sort_weight":107,"slug":108},14,"Invoices",70,"invoices",{"id":110,"doc_module":11,"doc_module_name":46,"category_name":111,"show_sort_weight":112,"slug":113},15,"Posters",60,"posters",{"id":115,"doc_module":11,"doc_module_name":46,"category_name":116,"show_sort_weight":117,"slug":118},16,"Social Media",50,"social-media",{"id":120,"doc_module":11,"doc_module_name":46,"category_name":121,"show_sort_weight":122,"slug":123},17,"Forms",40,"forms",{"id":125,"doc_module":11,"doc_module_name":46,"category_name":126,"show_sort_weight":127,"slug":128},18,"Letters",30,"letters",{"id":130,"doc_module":11,"doc_module_name":46,"category_name":131,"show_sort_weight":132,"slug":133},21,"Paper Templates",5,"papers-templates",{"id":12,"doc_module":11,"doc_module_name":46,"category_name":13,"show_sort_weight":4,"slug":135},"general-158"]