Returns an OES connection by its connection ID. For use only by OES clients.
Error scenarios:
-
400: Invalid Request Error
-
Occurs when the request parameters are invalid or malformed
-
Examples: Invalid UUID format for connectionId, invalid enterpriseId format
-
401: Authentication Error
-
Occurs when the request is not authorized.
-
Examples: Caller is not a member of the enterprise.
-
403: Permission Denied Error
-
Occurs when the authenticated client doesn't have necessary permissions.
-
Examples: Enterprise does not have OES license.
-
404: Not Found Error
-
Occurs when the specified connection cannot be found.
-
Examples: Connection ID doesn't exist, connection doesn't belong to this client.
-
500: Internal Server Error
-
Occurs when there's an unexpected server error processing the request.
-
Examples: Database connection issues, transient network errors.