Commit c89c2e37 authored by Dimitrios Gogos's avatar Dimitrios Gogos
Browse files

docs: update edge_cloud_zone_id description to clarify zone pinning behavior... 

docs: update edge_cloud_zone_id description to clarify zone pinning behavior and its impact on Traffic Influence notifications
parent d69f4f71

oeg/persistence-model.md

+2 −1
Changes for oeg/persistence-model.md: 2 added lines, 1 removed line.
Original line number Diff line number Diff line
@@ -321,7 +321,7 @@ Indexes: `BTREE(operation_id)`, `BTREE(tenant_id)`. 
| `traffic_influence_id` | UUID PK | OEG-minted; the CAMARA `trafficInfluenceID` **and** SRM's `service_instance.id` |

| `operation_id` | UUID FK -> `operations` | The **activate** operation that created this row |

| `app_registration_id` | UUID FK -> `app_registrations` | Resolved from the request's CAMARA `appId`; supplies `service_specification_id` on the command (ADR-0011) |

| `edge_cloud_zone_id` | UUID | NULLABLE; the requested CAMARA `edgeCloudZoneId` → command `zone_id` |

| `edge_cloud_zone_id` | UUID | NULLABLE; the zone OEG pins on the activate command (`zone_id`): the requested CAMARA `edgeCloudZoneId`, else the zone resolved from `edgeCloudRegion` or `appInstanceId` (an `edgeCloudRegion` with no zones, or an `appInstanceId` SRM cannot resolve, is rejected `404`, never sent unpinned). SRM realizes the policy only inside a pinned zone (ADR-0045), so this is also the policy's zone; it scopes the `ready` `app_instances` reported as `selected_appInstanceId` on the `active` notification (only the requested one when `appInstanceId` was given). NULL when the request names no location — SRM then chooses the control path and no instance is reported as selected |

| `edge_cloud_region` | VARCHAR(256) | NULLABLE; the requested CAMARA `edgeCloudRegion`, resolved to a zone before the command is built |

| `source_port` | INTEGER | NULLABLE; from `sourceTrafficFilters.sourcePort` |

| `destination_port` | INTEGER | NULLABLE; from `destinationTrafficFilters.destinationPort` |
@@ -526,3 +526,4 @@ Ship JWT validation, `ErrorInfo`, one async deploy path, `GET /platform/v1/opera 
| Version | Date | Summary |

|---------|------|---------|

| 2.0 | 2026-07-07 | OOP Release 2.0. |

| 2.0 | 2026-09-11 | `traffic_influences.edge_cloud_zone_id` stores the zone pinned on the activate command rather than only the requested `edgeCloudZoneId`, and scopes `selected_appInstanceId` on the Traffic Influence notification. |
 
 No newline at end of file