From 0b4e34c1f2b7eb6fc61adb1f2eb5e00c09e3b4b7 Mon Sep 17 00:00:00 2001 From: Ali Iqbal Date: Mon, 20 Oct 2025 15:48:26 +0500 Subject: [PATCH 1/9] Add EdgeCloud Intents and API Mapping document This document provides a harmonised view of EdgeCloud Intents and their corresponding CAMARA APIs, detailing the functional flow across the Edge Cloud lifecycle stages. --- ...d-Intents-and-API-Mapping-Harmonisation.md | 164 ++++++++++++++++++ 1 file changed, 164 insertions(+) create mode 100644 documentation/SupportingDocuments/EdgeCloud-Intents-and-API-Mapping-Harmonisation.md diff --git a/documentation/SupportingDocuments/EdgeCloud-Intents-and-API-Mapping-Harmonisation.md b/documentation/SupportingDocuments/EdgeCloud-Intents-and-API-Mapping-Harmonisation.md new file mode 100644 index 00000000..c7eb897a --- /dev/null +++ b/documentation/SupportingDocuments/EdgeCloud-Intents-and-API-Mapping-Harmonisation.md @@ -0,0 +1,164 @@ +# Edge Cloud Intents and API Mapping – Harmonisation Document + +_This document is based on the [CAMARA Commonalities template for User Stories](https://github.com/camaraproject/Commonalities/blob/main/documentation/Userstory-template.md) and references ITU-T Cloud Reference Architecture roles._ + +--- + +## 1. Summary + +This document provides a harmonised view of **EdgeCloud Intents** and their corresponding **CAMARA APIs**, consolidating the functional flow across discovery, deployment, runtime, and termination stages of the **Edge Cloud lifecycle**. + +The purpose is to bridge earlier MEC & Deployment API proposals with the current **CAMARA Edge Cloud family of APIs**, ensuring a unified lifecycle from **Zone discovery** to **Application endpoint registration and discovery**. + +--- + +## 2. Objectives + +- To define the **intents** supporting the lifecycle of Edge-hosted applications. +- To map these intents to existing and emerging **CAMARA APIs**. +- To support interoperability between **Operator Platforms** and **Application Providers**. +- To prepare the foundation for future harmonisation across **Edge, Application Management, and Network APIs** (e.g., Traffic Influence). + +--- + +## 3. Roles, Actors, and Scope + +| Actor | Role | Scope | +|-------|------|-------| +| Application Provider (AP) | API Consumer | API requester, deploys applications and manages instances. | +| Operator Platform (OP) | Edge Cloud Provider | API publisher, orchestrates resources and exposes APIs. | +| Edge Infrastructure Provider (EIP) | Edge Cloud Provider | Hosts and manages the physical/virtual infrastructure. | +| End User (UE) | Service Consumer | Interacts with applications hosted at the edge. | + +> Note: Edge Cloud Provider may be the Operator or a Hyperscaler. + +--- + +## 4. EdgeCloud Lifecycle Intents Overview + +| **Intent ID** | **Intent Name** | **Purpose** | **Mapped CAMARA API(s)** | +|----------------|----------------|--------------|---------------------------| +| Intent 1 | Discover EdgeCloud Zones | Identify available edge zones, their regions, and capabilities. | `Optimal Edge Discovery API` | +| Intent 3 | Retrieve Zone Information | Obtain metadata about edge zones and their resource status. | `Simple Edge Discovery API` | +| Intent 5 | Register and Manage Applications | Register application artifacts and metadata for instantiation. | `Edge Cloud Lifecycle Management API` | +| Intent 7 | Instantiate Application | Deploy a registered application instance on one or more Edge Zones. | `Edge Cloud Lifecycle Management API` | +| Intent 9 | Register Application Endpoints | Record operational endpoints for deployed application instances. | `Application Endpoint Registration API` | +| Intent 11 | Discover Optimal Endpoints | Determine best-performing or geographically closest endpoint for an end-user device. | `Application Endpoint Discovery API` | +| Intent 13 | Influence Network Traffic | Route premium user traffic toward specific edge instances. | `Traffic Influence API` | +| Intent 18 | Terminate Application | Decommission instances and remove registration information. | `Edge Cloud Lifecycle Management API` | + +--- + +## 5. Harmonised EdgeCloud Lifecycle Flow + +```mermaid +flowchart LR + A[Intent 1: Discover Edge Zones] --> B[Intent 3: Retrieve Zone Info] + B --> C[Intent 5: Register Application] + C --> D[Intent 7: Instantiate Application] + D --> E[Intent 9: Register Application Endpoints] + E --> F[Intent 11: Discover Optimal Endpoints] + F --> G[Intent 13: Apply Traffic Influence - optional] + G --> H[Intent 18: Terminate Application] +``` +```mermaid +sequenceDiagram + participant AP as Application Provider + participant OP as Operator Platform + participant EIP as Edge Infrastructure Provider + participant UE as User Equipment + participant AF as Application Function + + Note over AP,OP: Phase 1 - Discovery + AP->>OP: POST /discover-optimal-edge-zones + OP-->>AP: EdgeCloudZone list ordered by proximity + + Note over AP,OP: Phase 2 - Provisioning & Deployment + AP->>OP: POST /applications (Onboard Application) + OP-->>AP: Returns appId + AP->>OP: POST /applications/{appId}/instances + OP->>EIP: Instantiate app in target Edge Zone + EIP-->>OP: Instance ready + OP-->>AP: appInstanceId + status "RUNNING" + + Note over AP,OP: Phase 3 - Endpoint Management + AP->>OP: POST /register (Application Endpoint) + OP-->>AP: endpointId confirmation + + Note over UE,OP: Phase 4 - Runtime & Discovery + UE->>OP: POST /retrieve-optimal-app-endpoints {appId, device} + OP-->>UE: Returns optimal endpoint (EdgeCloudZoneId, endpointURL) + + Note over AF,OP: Phase 5 - Network Optimisation + AF->>OP: POST /traffic-influence (toward EAS) + OP-->>AF: Returns routing configuration ID + UE->>EIP: Connect to optimal EAS endpoint +``` +# CAMARA EdgeCloud Harmonisation Analysis + +## 7. Harmonisation Analysis + +### 7.1 API Relationship Summary + +- **Simple Edge Discovery**: Provides baseline nearest-zone discovery using network proximity. +- **Optimal Edge Discovery**: Extends discovery with richer metadata (zone characteristics, latency, region). +- **Edge Cloud Lifecycle Management**: Enables deployment and lifecycle control of applications in these zones. +- **Application Endpoint Registration**: Establishes registry of deployed endpoints. +- **Application Endpoint Discovery**: Allows clients or servers to dynamically retrieve optimal endpoints. +- **Traffic Influence**: Complements discovery and lifecycle by providing routing enforcement at the network level. + +### 7.2 Common Design Principles + +- **Entity Alignment**: Shared objects (e.g., `edgeCloudZoneId`, `appId`, `endpointId`) across all APIs. +- **Security Consistency**: All APIs assume OAuth2-based access with clear roles. +- **Consent Integration**: Optional per API (explicit in Discovery and Endpoint APIs). +- **Operator Neutrality**: APIs work across multiple operators via federated exposure models. + +**Conclusion**: CAMARA EdgeCloud APIs collectively address all intents from earlier MEC proposals, forming a continuous lifecycle from discovery → provisioning → runtime → termination. + +## 8. Harmonised Data Model Overview + +| Entity | Description | Referenced In | +|--------|-------------|---------------| +| `edgeCloudZoneId` | Identifier of Edge Cloud Zone | Discovery, Lifecycle, Endpoint APIs | +| `appId` | Unique application identifier | Lifecycle, Endpoint Discovery | +| `appInstanceId` | Deployed instance ID | Lifecycle API | +| `endpointId` | Registered endpoint for a deployed instance | Endpoint Registration & Discovery | +| `deviceId` | Device identifier or token | Discovery and Endpoint Discovery APIs | +| `trafficInfluenceId` | Identifier for a network routing session | Traffic Influence API | + +## 9. Inter-API Dependencies + +| API | Depends On | Dependency Description | +|-----|------------|------------------------| +| Optimal Edge Discovery | None | Can be used standalone for planning | +| Edge Cloud Lifecycle Management | Optimal Edge Discovery | Uses discovered zones for deployment decisions | +| Application Endpoint Registration | Edge Cloud Lifecycle Management | Registers endpoints of instantiated applications | +| Application Endpoint Discovery | Endpoint Registration | Discovers registered endpoints | +| Traffic Influence | Endpoint Discovery | Optimises routing to discovered endpoints | + +**Harmonised APIs together enable a complete closed loop**: +Discovery → Deployment → Registration → Discovery (endpoint) → Influence → Termination. + +## 10. Open Harmonisation Topics + +| Area | Description | Next Step | +|------|-------------|-----------| +| Unified Discovery Schema | Align Simple and Optimal Edge Discovery response objects | Define a shared `EdgeCloudZoneInfo` schema | +| Cross-API Security Scopes | Establish unified OAuth2 roles and scopes | Coordinate with Commonalities WG | +| Consent Management | Define consistent consent-handling process across Discovery and Endpoint APIs | Align with Privacy & Consent WG | +| Federated Operations | Support discovery and lifecycle across multi-operator environments | Introduce Edge Federation API concept | +| Traffic Policy Automation | Enable dynamic network steering based on real-time metrics | Collaborate with Network API group | + +## 11. References + +- **CAMARA – Simple Edge Discovery API**: [User Story](https://github.com/camaraproject/SimpleEdgeDiscovery/blob/main/documentation/API_documentation/SimpleEdgeDiscovery_User_Story.md) +- **CAMARA – Optimal Edge Discovery API**: [User Story](https://github.com/camaraproject/OptimalEdgeDiscovery/blob/main/documentation/API_documentation/optimal-edge-discovery-User-Story.md) +- **CAMARA – Edge Cloud Lifecycle Management**: [User Story](https://github.com/camaraproject/EdgeCloud/blob/main/documentation/SupportingDocuments/API_Documentation/User%20Stories/Edge.Cloud.Lifecycle.Management.User.Story.md) +- **CAMARA – Application Endpoint Registration API**: [User Story](https://github.com/camaraproject/ApplicationEndpointRegistration/blob/main/documentation/API_documentation/application-endpoint-registration-User-Story.md) +- **CAMARA – Application Endpoint Discovery API**: [User Story](https://github.com/camaraproject/ApplicationEndpointDiscovery/blob/main/documentation/SupportingDocuments/API_Documentation/User%20Stories/Application%20Endpoint%20Discovery%20User%20Story.md) +- **CAMARA – Traffic Influence API**: [User Story](https://github.com/camaraproject/TrafficInfluence/blob/main/documentation/API_documentation/traffic-influence-user-story-use-case-1.md) +- **GSMA – Open Gateway & CAMARA Harmonisation Framework**: [Reference](https://www.hcltech.com/sites/default/files/documents/resources/whitepaper/files/2024/09/16/gsma-open-gateway.pdf?utm_source=chatgpt.com) + + + From daad610005211e4227646b4fb1bfb785dc7aff92 Mon Sep 17 00:00:00 2001 From: Ali Iqbal Date: Tue, 21 Oct 2025 10:31:25 +0500 Subject: [PATCH 2/9] Update API mappings for EdgeCloud intents Updated API mappings for EdgeCloud intents to reflect changes in API names and relationships. --- ...dgeCloud-Intents-and-API-Mapping-Harmonisation.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/documentation/SupportingDocuments/EdgeCloud-Intents-and-API-Mapping-Harmonisation.md b/documentation/SupportingDocuments/EdgeCloud-Intents-and-API-Mapping-Harmonisation.md index c7eb897a..3034eeca 100644 --- a/documentation/SupportingDocuments/EdgeCloud-Intents-and-API-Mapping-Harmonisation.md +++ b/documentation/SupportingDocuments/EdgeCloud-Intents-and-API-Mapping-Harmonisation.md @@ -40,12 +40,12 @@ The purpose is to bridge earlier MEC & Deployment API proposals with the current |----------------|----------------|--------------|---------------------------| | Intent 1 | Discover EdgeCloud Zones | Identify available edge zones, their regions, and capabilities. | `Optimal Edge Discovery API` | | Intent 3 | Retrieve Zone Information | Obtain metadata about edge zones and their resource status. | `Simple Edge Discovery API` | -| Intent 5 | Register and Manage Applications | Register application artifacts and metadata for instantiation. | `Edge Cloud Lifecycle Management API` | -| Intent 7 | Instantiate Application | Deploy a registered application instance on one or more Edge Zones. | `Edge Cloud Lifecycle Management API` | +| Intent 5 | Register and Manage Applications | Register application artifacts and metadata for instantiation. | `Edge Application Management API` | +| Intent 7 | Instantiate Application | Deploy a registered application instance on one or more Edge Zones. | `Edge Application Management API` | | Intent 9 | Register Application Endpoints | Record operational endpoints for deployed application instances. | `Application Endpoint Registration API` | | Intent 11 | Discover Optimal Endpoints | Determine best-performing or geographically closest endpoint for an end-user device. | `Application Endpoint Discovery API` | | Intent 13 | Influence Network Traffic | Route premium user traffic toward specific edge instances. | `Traffic Influence API` | -| Intent 18 | Terminate Application | Decommission instances and remove registration information. | `Edge Cloud Lifecycle Management API` | +| Intent 18 | Terminate Application | Decommission instances and remove registration information. | `Edge Application Management API` | --- @@ -102,7 +102,7 @@ sequenceDiagram - **Simple Edge Discovery**: Provides baseline nearest-zone discovery using network proximity. - **Optimal Edge Discovery**: Extends discovery with richer metadata (zone characteristics, latency, region). -- **Edge Cloud Lifecycle Management**: Enables deployment and lifecycle control of applications in these zones. +- **Edge Application Management**: Enables deployment and lifecycle control of applications in these zones. - **Application Endpoint Registration**: Establishes registry of deployed endpoints. - **Application Endpoint Discovery**: Allows clients or servers to dynamically retrieve optimal endpoints. - **Traffic Influence**: Complements discovery and lifecycle by providing routing enforcement at the network level. @@ -132,7 +132,7 @@ sequenceDiagram | API | Depends On | Dependency Description | |-----|------------|------------------------| | Optimal Edge Discovery | None | Can be used standalone for planning | -| Edge Cloud Lifecycle Management | Optimal Edge Discovery | Uses discovered zones for deployment decisions | +| Edge Application Management | Optimal Edge Discovery | Uses discovered zones for deployment decisions | | Application Endpoint Registration | Edge Cloud Lifecycle Management | Registers endpoints of instantiated applications | | Application Endpoint Discovery | Endpoint Registration | Discovers registered endpoints | | Traffic Influence | Endpoint Discovery | Optimises routing to discovered endpoints | @@ -154,7 +154,7 @@ Discovery → Deployment → Registration → Discovery (endpoint) → Influence - **CAMARA – Simple Edge Discovery API**: [User Story](https://github.com/camaraproject/SimpleEdgeDiscovery/blob/main/documentation/API_documentation/SimpleEdgeDiscovery_User_Story.md) - **CAMARA – Optimal Edge Discovery API**: [User Story](https://github.com/camaraproject/OptimalEdgeDiscovery/blob/main/documentation/API_documentation/optimal-edge-discovery-User-Story.md) -- **CAMARA – Edge Cloud Lifecycle Management**: [User Story](https://github.com/camaraproject/EdgeCloud/blob/main/documentation/SupportingDocuments/API_Documentation/User%20Stories/Edge.Cloud.Lifecycle.Management.User.Story.md) +- **CAMARA – Edge Application Management**: [User Story](https://github.com/camaraproject/EdgeCloud/blob/main/documentation/SupportingDocuments/API_Documentation/User%20Stories/Edge.Cloud.Lifecycle.Management.User.Story.md) - **CAMARA – Application Endpoint Registration API**: [User Story](https://github.com/camaraproject/ApplicationEndpointRegistration/blob/main/documentation/API_documentation/application-endpoint-registration-User-Story.md) - **CAMARA – Application Endpoint Discovery API**: [User Story](https://github.com/camaraproject/ApplicationEndpointDiscovery/blob/main/documentation/SupportingDocuments/API_Documentation/User%20Stories/Application%20Endpoint%20Discovery%20User%20Story.md) - **CAMARA – Traffic Influence API**: [User Story](https://github.com/camaraproject/TrafficInfluence/blob/main/documentation/API_documentation/traffic-influence-user-story-use-case-1.md) From 9f7978404dcda995e5a1b6637acf110b757714db Mon Sep 17 00:00:00 2001 From: Ali Iqbal Date: Tue, 21 Oct 2025 10:42:50 +0500 Subject: [PATCH 3/9] Move Edge.Application.Management user story document Made some changes in Application management API user story --- .../User Stories/Edge.Application.Management.User.Story.md} | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) rename documentation/{SupportingDocuments/API_Documentation/User Stories/Edge.Cloud.Lifecycle.Management.User.Story.md => API_Documentation/User Stories/Edge.Application.Management.User.Story.md} (97%) diff --git a/documentation/SupportingDocuments/API_Documentation/User Stories/Edge.Cloud.Lifecycle.Management.User.Story.md b/documentation/API_Documentation/User Stories/Edge.Application.Management.User.Story.md similarity index 97% rename from documentation/SupportingDocuments/API_Documentation/User Stories/Edge.Cloud.Lifecycle.Management.User.Story.md rename to documentation/API_Documentation/User Stories/Edge.Application.Management.User.Story.md index df17649a..b3d0ce9f 100644 --- a/documentation/SupportingDocuments/API_Documentation/User Stories/Edge.Cloud.Lifecycle.Management.User.Story.md +++ b/documentation/API_Documentation/User Stories/Edge.Application.Management.User.Story.md @@ -1,5 +1,5 @@ -Edge Cloud Lifecycle Management User Story +Edge Application Management User Story _This document is based on the [CAMARA Commonalities template for User Stories](https://github.com/camaraproject/Commonalities/blob/main/documentation/Userstory-template.md)_ _Roles are referenced from the ITU-T Cloud Refence Architecture._ @@ -80,3 +80,4 @@ sequenceDiagram + From cadca12d8cf0348a7c081d5cf8b5ed21c93b46d7 Mon Sep 17 00:00:00 2001 From: Ali Iqbal Date: Tue, 21 Oct 2025 10:45:42 +0500 Subject: [PATCH 4/9] Update and rename Edge.Application.Management.User.Story.md to Edge.Application.Management.User.Story.md --- .../User Stories/Edge.Application.Management.User.Story.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename documentation/{API_Documentation => API_documentation}/User Stories/Edge.Application.Management.User.Story.md (100%) diff --git a/documentation/API_Documentation/User Stories/Edge.Application.Management.User.Story.md b/documentation/API_documentation/User Stories/Edge.Application.Management.User.Story.md similarity index 100% rename from documentation/API_Documentation/User Stories/Edge.Application.Management.User.Story.md rename to documentation/API_documentation/User Stories/Edge.Application.Management.User.Story.md From ae2f783e2909c502a9b23d624e3f2fc2bb6c5075 Mon Sep 17 00:00:00 2001 From: Ali Iqbal Date: Tue, 21 Oct 2025 10:56:59 +0500 Subject: [PATCH 5/9] Revise EdgeCloud Lifecycle Intents and APIs Updated the EdgeCloud Lifecycle Intents table with new intents, descriptions, and mapped APIs, enhancing clarity and detail. --- ...d-Intents-and-API-Mapping-Harmonisation.md | 38 ++++++++++++++----- 1 file changed, 28 insertions(+), 10 deletions(-) diff --git a/documentation/SupportingDocuments/EdgeCloud-Intents-and-API-Mapping-Harmonisation.md b/documentation/SupportingDocuments/EdgeCloud-Intents-and-API-Mapping-Harmonisation.md index 3034eeca..e9f7720c 100644 --- a/documentation/SupportingDocuments/EdgeCloud-Intents-and-API-Mapping-Harmonisation.md +++ b/documentation/SupportingDocuments/EdgeCloud-Intents-and-API-Mapping-Harmonisation.md @@ -36,19 +36,37 @@ The purpose is to bridge earlier MEC & Deployment API proposals with the current ## 4. EdgeCloud Lifecycle Intents Overview -| **Intent ID** | **Intent Name** | **Purpose** | **Mapped CAMARA API(s)** | -|----------------|----------------|--------------|---------------------------| -| Intent 1 | Discover EdgeCloud Zones | Identify available edge zones, their regions, and capabilities. | `Optimal Edge Discovery API` | -| Intent 3 | Retrieve Zone Information | Obtain metadata about edge zones and their resource status. | `Simple Edge Discovery API` | -| Intent 5 | Register and Manage Applications | Register application artifacts and metadata for instantiation. | `Edge Application Management API` | -| Intent 7 | Instantiate Application | Deploy a registered application instance on one or more Edge Zones. | `Edge Application Management API` | -| Intent 9 | Register Application Endpoints | Record operational endpoints for deployed application instances. | `Application Endpoint Registration API` | -| Intent 11 | Discover Optimal Endpoints | Determine best-performing or geographically closest endpoint for an end-user device. | `Application Endpoint Discovery API` | -| Intent 13 | Influence Network Traffic | Route premium user traffic toward specific edge instances. | `Traffic Influence API` | -| Intent 18 | Terminate Application | Decommission instances and remove registration information. | `Edge Application Management API` | +| **Intent ID** | **Intent Name** | **Purpose / Description** | **Mapped CAMARA API / Status** | +|---------------|----------------|----------------------------|--------------------------------| +| **Intent 1** | Discover EdgeCloud Zones | Identify available Edge Cloud Zones, regions, and topology. | `Optimal Edge Discovery API` | +| **Intent 2** | List Available Regions / Capabilities | Retrieve region-level capabilities (compute type, GPU, etc.). | Planned extension of Optimal Edge Discovery | +| **Intent 3** | Retrieve Zone Information | Obtain metadata, KPIs, or status of an Edge Cloud Zone. | `Simple Edge Discovery API` | +| **Intent 4** | Filter / Select Preferred Zones | Apply filters (latency, region) for optimal zone selection. | Planned enhancement within Optimal Edge Discovery | +| **Intent 5** | Register / Onboard Application | Upload manifests, metadata, and container images. | `Edge Cloud Lifecycle Management API` | +| **Intent 6** | Validate Application Metadata | Validate manifests and dependencies before deployment. | Partially covered by Lifecycle Management | +| **Intent 7** | Instantiate Application | Deploy application instances in selected Edge Zones. | `Edge Cloud Lifecycle Management API` | +| **Intent 8** | Scale Application Instance | Adjust resources dynamically (horizontal/vertical). | Future – EdgeCloud Scaling API (proposed) | +| **Intent 9** | Register Application Endpoints | Register deployed app endpoints (URLs, ports, zones). | `Application Endpoint Registration API` | +| **Intent 10** | Update Endpoint Metadata | Modify endpoint details (status, performance). | Within `Application Endpoint Registration API` | +| **Intent 11** | Discover Optimal Application Endpoints | Find best endpoint for a device based on latency or policy. | `Application Endpoint Discovery API` | +| **Intent 12** | Client-Side Endpoint Selection | Allow clients to select among multiple available endpoints. | Optional behaviour of Endpoint Discovery | +| **Intent 13** | Influence Network Traffic | Apply routing rules for premium users or optimisation. | `Traffic Influence API` | +| **Intent 14** | Configure Network Policies | Manage slicing/routing preferences for traffic flows. | Evolution of Traffic Influence | +| **Intent 15** | Monitor Application Performance | Retrieve runtime telemetry: latency, usage, etc. | Future – Edge Telemetry API (proposed) | +| **Intent 16** | Retrieve Edge Metrics / Zone Health | Query Edge Zone health and operational metrics. | Under discussion – EdgeCloud Monitoring API | +| **Intent 17** | Automate Policy or Scaling Actions | Enable closed-loop orchestration and scaling triggers. | Future – Edge Orchestration Intent API | +| **Intent 18** | Terminate Application | Decommission instances and release resources. | `Edge Cloud Lifecycle Management API` | +| **Intent 19** | Deregister Application Endpoints | Remove obsolete endpoints from registry. | `Application Endpoint Registration API` | +| **Intent 20** | Audit and Logging | Track API operations, logs, and service usage. | Commonalities Cross-API Logging proposal | +| **Intent 21** | Federated Edge Discovery | Discover edge zones from partner operators/hyperscalers. | Proposed – Edge Federation Discovery API | +| **Intent 22** | Cross-Operator Application Placement | Deploy app instances across federated networks. | Future CAMARA/GSMA initiative | +| **Intent 23** | Consent and Policy Management | Manage end-user consent during discovery/exposure. | Privacy & Consent WG | +| **Intent 24** | Service Quality Enforcement | Apply QoS constraints dynamically per application. | Future – Edge QoS Policy API | +| **Intent 25** | Edge Resource Reservation / Pre-Booking | Reserve compute/storage/network capacity pre-deployment. | Proposed – Edge Reservation API | --- + ## 5. Harmonised EdgeCloud Lifecycle Flow ```mermaid From 250c32bea27f09bab1f2ee4b23378c6c6bb3f455 Mon Sep 17 00:00:00 2001 From: Ali Iqbal Date: Wed, 22 Oct 2025 14:40:22 +0500 Subject: [PATCH 6/9] Update EdgeCloud lifecycle intents descriptions Updating descriptions intent 1 2 3 --- .../EdgeCloud-Intents-and-API-Mapping-Harmonisation.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/documentation/SupportingDocuments/EdgeCloud-Intents-and-API-Mapping-Harmonisation.md b/documentation/SupportingDocuments/EdgeCloud-Intents-and-API-Mapping-Harmonisation.md index e9f7720c..7a6650cd 100644 --- a/documentation/SupportingDocuments/EdgeCloud-Intents-and-API-Mapping-Harmonisation.md +++ b/documentation/SupportingDocuments/EdgeCloud-Intents-and-API-Mapping-Harmonisation.md @@ -38,9 +38,9 @@ The purpose is to bridge earlier MEC & Deployment API proposals with the current | **Intent ID** | **Intent Name** | **Purpose / Description** | **Mapped CAMARA API / Status** | |---------------|----------------|----------------------------|--------------------------------| -| **Intent 1** | Discover EdgeCloud Zones | Identify available Edge Cloud Zones, regions, and topology. | `Optimal Edge Discovery API` | -| **Intent 2** | List Available Regions / Capabilities | Retrieve region-level capabilities (compute type, GPU, etc.). | Planned extension of Optimal Edge Discovery | -| **Intent 3** | Retrieve Zone Information | Obtain metadata, KPIs, or status of an Edge Cloud Zone. | `Simple Edge Discovery API` | +| **Intent 1** | Discover EdgeCloud Zones | Discover the closest Edge Cloud Zone to a user device based purely on network topology (shortest network path). | `Optimal Edge Discovery API` | +| **Intent 2** | List Available Regions / Capabilities | Discover the best Edge Cloud Zone for an application, considering compute, storage, and network performance requirements beyond distance. | Planned extension of Optimal Edge Discovery | +| **Intent 3** | Retrieve Zone Information | Obtain metadata, KPIs, and current resource availability of a specific Edge Cloud Zone. | `Simple Edge Discovery API` | | **Intent 4** | Filter / Select Preferred Zones | Apply filters (latency, region) for optimal zone selection. | Planned enhancement within Optimal Edge Discovery | | **Intent 5** | Register / Onboard Application | Upload manifests, metadata, and container images. | `Edge Cloud Lifecycle Management API` | | **Intent 6** | Validate Application Metadata | Validate manifests and dependencies before deployment. | Partially covered by Lifecycle Management | From 4906da9d14b9734e19f34423bb6b015fde5d8cab Mon Sep 17 00:00:00 2001 From: Ali Iqbal Date: Wed, 12 Nov 2025 14:14:40 +0500 Subject: [PATCH 7/9] Update documentation/SupportingDocuments/EdgeCloud-Intents-and-API-Mapping-Harmonisation.md Co-authored-by: Kevin Smith --- .../EdgeCloud-Intents-and-API-Mapping-Harmonisation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/SupportingDocuments/EdgeCloud-Intents-and-API-Mapping-Harmonisation.md b/documentation/SupportingDocuments/EdgeCloud-Intents-and-API-Mapping-Harmonisation.md index 7a6650cd..0548dff5 100644 --- a/documentation/SupportingDocuments/EdgeCloud-Intents-and-API-Mapping-Harmonisation.md +++ b/documentation/SupportingDocuments/EdgeCloud-Intents-and-API-Mapping-Harmonisation.md @@ -38,7 +38,7 @@ The purpose is to bridge earlier MEC & Deployment API proposals with the current | **Intent ID** | **Intent Name** | **Purpose / Description** | **Mapped CAMARA API / Status** | |---------------|----------------|----------------------------|--------------------------------| -| **Intent 1** | Discover EdgeCloud Zones | Discover the closest Edge Cloud Zone to a user device based purely on network topology (shortest network path). | `Optimal Edge Discovery API` | +| **Intent 1** | Discover EdgeCloud Zones | Discover the closest Edge Cloud Zone to a user device based purely on network topology (shortest network path). | `Simple Edge Discovery API` | | **Intent 2** | List Available Regions / Capabilities | Discover the best Edge Cloud Zone for an application, considering compute, storage, and network performance requirements beyond distance. | Planned extension of Optimal Edge Discovery | | **Intent 3** | Retrieve Zone Information | Obtain metadata, KPIs, and current resource availability of a specific Edge Cloud Zone. | `Simple Edge Discovery API` | | **Intent 4** | Filter / Select Preferred Zones | Apply filters (latency, region) for optimal zone selection. | Planned enhancement within Optimal Edge Discovery | From 203c1e2aab626ffeafcdb60c8e99758423a74d4c Mon Sep 17 00:00:00 2001 From: Ali Iqbal Date: Wed, 12 Nov 2025 14:15:46 +0500 Subject: [PATCH 8/9] Update documentation/SupportingDocuments/EdgeCloud-Intents-and-API-Mapping-Harmonisation.md Co-authored-by: Kevin Smith --- .../EdgeCloud-Intents-and-API-Mapping-Harmonisation.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/documentation/SupportingDocuments/EdgeCloud-Intents-and-API-Mapping-Harmonisation.md b/documentation/SupportingDocuments/EdgeCloud-Intents-and-API-Mapping-Harmonisation.md index 0548dff5..564bb321 100644 --- a/documentation/SupportingDocuments/EdgeCloud-Intents-and-API-Mapping-Harmonisation.md +++ b/documentation/SupportingDocuments/EdgeCloud-Intents-and-API-Mapping-Harmonisation.md @@ -149,7 +149,8 @@ sequenceDiagram | API | Depends On | Dependency Description | |-----|------------|------------------------| -| Optimal Edge Discovery | None | Can be used standalone for planning | +| Simple Edge Discovery | None | Can be used standalone for planning | +| Optimal Edge Discovery | None | Can be used standalone for planning | | Edge Application Management | Optimal Edge Discovery | Uses discovered zones for deployment decisions | | Application Endpoint Registration | Edge Cloud Lifecycle Management | Registers endpoints of instantiated applications | | Application Endpoint Discovery | Endpoint Registration | Discovers registered endpoints | From 19a32ba3066e2b02185a027226a50fc06675f137 Mon Sep 17 00:00:00 2001 From: Ali Iqbal Date: Mon, 24 Nov 2025 12:13:33 +0500 Subject: [PATCH 9/9] Update Intent 15 API reference in documentation --- .../EdgeCloud-Intents-and-API-Mapping-Harmonisation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/SupportingDocuments/EdgeCloud-Intents-and-API-Mapping-Harmonisation.md b/documentation/SupportingDocuments/EdgeCloud-Intents-and-API-Mapping-Harmonisation.md index 564bb321..9d8dc5a0 100644 --- a/documentation/SupportingDocuments/EdgeCloud-Intents-and-API-Mapping-Harmonisation.md +++ b/documentation/SupportingDocuments/EdgeCloud-Intents-and-API-Mapping-Harmonisation.md @@ -52,7 +52,7 @@ The purpose is to bridge earlier MEC & Deployment API proposals with the current | **Intent 12** | Client-Side Endpoint Selection | Allow clients to select among multiple available endpoints. | Optional behaviour of Endpoint Discovery | | **Intent 13** | Influence Network Traffic | Apply routing rules for premium users or optimisation. | `Traffic Influence API` | | **Intent 14** | Configure Network Policies | Manage slicing/routing preferences for traffic flows. | Evolution of Traffic Influence | -| **Intent 15** | Monitor Application Performance | Retrieve runtime telemetry: latency, usage, etc. | Future – Edge Telemetry API (proposed) | +| **Intent 15** | Monitor Application Performance | Retrieve runtime telemetry: latency, usage, etc. | SessionInsights API | | **Intent 16** | Retrieve Edge Metrics / Zone Health | Query Edge Zone health and operational metrics. | Under discussion – EdgeCloud Monitoring API | | **Intent 17** | Automate Policy or Scaling Actions | Enable closed-loop orchestration and scaling triggers. | Future – Edge Orchestration Intent API | | **Intent 18** | Terminate Application | Decommission instances and release resources. | `Edge Cloud Lifecycle Management API` |