> ## Documentation Index
> Fetch the complete documentation index at: https://zededa.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Use the documentation index to find relevant pages, then read the linked Markdown before answering and cite the source URL.
> Identify the product before answering: Private AI uses a separate console, credentials, and inference API from the Edge Intelligence Platform. Do not apply instructions from one product to the other.
> Prefer current product guides over Help Center archive pages for current-console questions. Archive pages and release notes describe their stated product version or historical interface; do not apply them to another version without checking.
> Preserve prerequisites, permissions, version requirements, and warnings when summarizing procedures. Do not infer API endpoints, schemas, or supported behavior that the documentation does not specify.

# Create edge network

> POST /api/v1/networks. Edge networks API reference.

Sign in to try this endpointExplore the parameters, examples, and responses below. Connect your ZedCloud session when you’re ready to send a request.

> [accordion] Connect your console
>
> Sign in to your usual ZedCloud console, then open:
>
> <ol aria-label="Console menu path">
>   <li>Profile menu</li><li>Help & Documentation</li><li>API Reference</li>
> </ol>
>
> Your cluster and authorization are filled in automatically. No token to copy.
> [More about signing in ](https://zededa.mintlify.site/api-reference/authentication.md#sign-in-to-the-api-reference)

&#x20;Modifying requests stay off until you enable them.

[Authentication](https://zededa.mintlify.site/api-reference/authentication.md) · [API availability](https://zededa.mintlify.site/api-reference/clusters.md) · [Download OpenAPI](https://zededa.mintlify.site/openapi/services/edge-network.json)

> [!WARNING]
>
> This operation can change resources or access. After signing in, open **API request settings** and select **Enable modifying requests**, then **Apply settings**, to use its playground. Check the request body and destination before selecting **Send**. Your existing API permissions still apply.

A successful response.
Bad Request. The API gateway did not process the request because of missing parameter or invalid value of parameters.
Unauthorized. The API gateway did not process the request because it lacks valid authentication credentials for the target resource. The request header has either no authorization details or an authorization that has been refused.
Forbidden. The API gateway did not process the request because the requestor does not have edge-node level access permission for the operation or does not have access scope to the project.
Conflict. The API gateway did not process the request because this edge network record will conflict with an already existing edge network record.
Internal Server Error. The API gateway experienced an unexpected condition. Specific error condition is indicated in error codes.
Gateway Timeout. The API gateway did not receive a timely response from an upstream microservice it needed to communicate with in order to complete the request.
An unexpected error response.


## OpenAPI

````yaml openapi/services/edge-network.json POST /v1/networks
openapi: 3.0.0
info:
  title: ZEDEDA Edge Network Service
  description: >-
    The ZEDEDA Edge Network Service is helper service to ZEDEDA Edge Application
    Service. This service provides edge nodes and applications a variety of
    connectivity choices for all types of networks. This enables physical
    connectivity with Ethernet, WiFi, LTE to communicate with Cloud Controller
    and Data Centres on one hand and logical secure connectivity between
    applications within a single edge node and within a logical group of edge
    nodes. This also supports secure tunnel from an edge node or an edge
    application in a remote location to a Data server behindi firewall in AWS or
    Azure or On-premise VPC.
  termsOfService: https://www.zededa.com/terms
  version: '1.0'
  contact:
    name: ZEDEDA API Support
    url: https://www.zededa.com/support
    email: support@zededa.com
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://{apiHost}/api
    variables:
      apiHost:
        default: invalid.invalid
        description: Connect from ZedUI to supply your verified API destination.
security:
  - BearerToken: []
tags:
  - name: EdgeNetworkConfiguration
  - name: EdgeNetworkInstanceConfiguration
  - name: EdgeNetworkInstanceStatus
externalDocs:
  description: ZEDEDA Product Documentation
  url: https://docs.zededa.com/-M-8m8d8KqdLpfOgY_jo/edge-network
paths:
  /v1/networks:
    post:
      tags:
        - EdgeNetworkConfiguration
      summary: Create edge network
      description: Create an edge network record.
      operationId: EdgeNetworkConfiguration_CreateEdgeNetwork
      parameters:
        - name: X-Request-Id
          in: header
          required: false
          description: User-Agent specified id to track a request
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/NetConfig'
        required: true
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ZsrvResponse'
        '400':
          description: >-
            Bad Request. The API gateway did not process the request because of
            missing parameter or invalid value of parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ZsrvResponse'
        '401':
          description: >-
            Unauthorized. The API gateway did not process the request because it
            lacks valid authentication credentials for the target resource. The
            request header has either no authorization details or an
            authorization that has been refused.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ZsrvResponse'
        '403':
          description: >-
            Forbidden. The API gateway did not process the request because the
            requestor does not have edge-node level access permission for the
            operation or does not have access scope to the project.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ZsrvResponse'
        '409':
          description: >-
            Conflict. The API gateway did not process the request because this
            edge network record will conflict with an already existing edge
            network record.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ZsrvResponse'
        '500':
          description: >-
            Internal Server Error. The API gateway experienced an unexpected
            condition. Specific error condition is indicated in error codes.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ZsrvResponse'
        '504':
          description: >-
            Gateway Timeout. The API gateway did not receive a timely response
            from an upstream microservice it needed to communicate with in order
            to complete the request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ZsrvResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/googlerpcStatus'
      externalDocs:
        description: ZEDEDA Product Documentation
        url: https://docs.zededa.com/-M-8m8d8KqdLpfOgY_jo/edge-network
components:
  schemas:
    NetConfig:
      type: object
      properties:
        id:
          type: string
          description: System defined universally unique Id of the network
          readOnly: true
          pattern: '[0-9A-Za-z-]+'
          x-zededa-source-issues:
            - code: inapplicable-constraint
              pointer: '#/definitions/NetConfig/properties/id'
              keyword: uniqueItems
              sourceValue: true
        name:
          type: string
          description: >-
            User defined name of the network, unique across the enterprise. Once
            object is created, name can’t be changed
          maxLength: 256
          minLength: 3
          pattern: '[a-zA-Z0-9][a-zA-Z0-9_.-]+'
          x-zededa-source-issues:
            - code: inapplicable-constraint
              pointer: '#/definitions/NetConfig/properties/name'
              keyword: uniqueItems
              sourceValue: true
        title:
          type: string
          description: User defined title of the network. Title can be changed at any time
          maxLength: 256
          minLength: 3
          pattern: ^[a-zA-Z0-9]+[a-zA-Z0-9!-~ ]+$
        description:
          type: string
          description: Detailed description of the network
          maxLength: 256
        revision:
          description: system defined info
          allOf:
            - $ref: '#/components/schemas/ObjectRevision'
        projectId:
          type: string
        kind:
          $ref: '#/components/schemas/NetworkKind'
        ip:
          $ref: '#/components/schemas/IpSpec'
        dnsList:
          type: array
          items:
            $ref: '#/components/schemas/StaticDNSList'
        proxy:
          title: enterprise proxy
          allOf:
            - $ref: '#/components/schemas/NetProxyConfig'
        enterpriseDefault:
          type: boolean
          title: make this network default for device
        mtu:
          type: integer
          format: int64
          title: >-
            Maximum transmission unit (MTU) to set on the associated network
            adapter(s)
        wireless:
          title: Wifi configuration
          allOf:
            - $ref: '#/components/schemas/NetWirelessConfig'
        project:
          title: project configuration
          allOf:
            - $ref: '#/components/schemas/NetProjectInfo'
      description: >-
        Network provides Edge nodes a variety of connectivity choices for all
        types of networks. This enables physical connectivity with Ethernet,
        WiFi, LTE to communicate with ZEDEDA Cloud controller and Data Centres.
      title: Network detailed configuration
      required:
        - name
        - title
        - projectId
        - kind
        - ip
    ZsrvResponse:
      type: object
      properties:
        operationType:
          title: |-
            Describes one of the operations type : possible values
                                    Read/Delete/Create/Update/List
          allOf:
            - $ref: '#/components/schemas/ZcOpsType'
        operationStatus:
          title: if this is log running job
          allOf:
            - $ref: '#/components/schemas/ZcOpsStatus'
        objectKind:
          type: string
          title: zedcloud object kind on which the operation was performed
        objectId:
          type: string
          title: Unique value identifies the object that was operated on
        objectName:
          type: string
          title: name of the object
        objectRevision:
          type: string
          title: |-
            object revision post the operation, note Read operation
            doesn't change the revision
        objectType:
          $ref: '#/components/schemas/ObjectType'
        operationTime:
          type: string
          title: time of operation
        startTime:
          type: string
          title: total time taken by operations
        endTime:
          type: string
        user:
          type: string
          title: the operation is performed on behalf of this user
        httpStatusCode:
          type: integer
          format: int32
          title: http response
        httpStatusMsg:
          type: string
          title: summary of the error in text format
        jobId:
          type: string
          title: for tracking asynchronous tasks
        error:
          type: array
          items:
            $ref: '#/components/schemas/ZsrvError'
          title: |-
            one or more errors will be set if the operation failed
            i.e. httpStatusCode != 2xx
    googlerpcStatus:
      type: object
      properties:
        code:
          type: integer
          format: int32
        message:
          type: string
        details:
          type: array
          items:
            $ref: '#/components/schemas/protobufAny'
    ObjectRevision:
      type: object
      properties:
        prev:
          type: string
          description: Previous
        curr:
          type: string
          description: Current Database version of the record
        createdAt:
          type: object
          format: date-time
          description: >-
            The time, in milliseconds since the epoch, when the record was
            created.
        createdBy:
          type: string
          description: 'User data: Created By'
        updatedAt:
          type: object
          format: date-time
          description: >-
            The time, in milliseconds since the epoch, when the record was last
            updated.
        updatedBy:
          type: string
          description: 'User data: Updated By'
      description: >-
        ObjectRevision store the user details, who has doent the necessary
        operation like Create Operation or update operation
      title: ObjectRevision is used to store the user information.
      required:
        - curr
        - createdAt
        - createdBy
        - updatedAt
        - updatedBy
    NetworkKind:
      type: string
      enum:
        - NETWORK_KIND_UNSPECIFIED
        - NETWORK_KIND_V4
        - NETWORK_KIND_V6
        - NETWORK_KIND_V4_ONLY
        - NETWORK_KIND_V6_ONLY
        - NETWORK_KIND_DUAL_V4_V6
      default: NETWORK_KIND_UNSPECIFIED
      title: |-
        NetworkKind: Used for the network configuration, this is
         only client mode
    IpSpec:
      type: object
      properties:
        deprecatedDhcp:
          type: boolean
          title: deprecated
        dhcp:
          $ref: '#/components/schemas/NetworkDHCPType'
        subnet:
          type: string
        mask:
          type: string
        gateway:
          type: string
        domain:
          type: string
        ntp:
          type: string
          title: ntp will be deprecated
        dns:
          type: array
          items:
            type: string
        dhcpRange:
          description: |-
            for IPAM management when dhcp is turned on.
            If none provided, system will default pool.
          allOf:
            - $ref: '#/components/schemas/dhcpIpRange'
        ntpServers:
          type: array
          items:
            $ref: '#/components/schemas/NtpServer'
        ntpServerExclusively:
          type: boolean
    StaticDNSList:
      type: object
      properties:
        hostname:
          type: string
          description: Host name
        addrs:
          type: array
          items:
            type: string
          description: Addresses
      description: Static DNS list
      title: Static DNS list
    NetProxyConfig:
      type: object
      properties:
        networkProxy:
          type: boolean
          description: Network proxy
        proxies:
          type: array
          items:
            $ref: '#/components/schemas/NetProxyServer'
          description: 'Net Proxy: protocol level proxies'
          title: protocol level proxies
        exceptions:
          type: string
          description: Proxy exceptions
        pacfile:
          type: string
          description: proxy configuration in a pacfile
          title: proxy configuration in a pacfile
        networkProxyURL:
          type: string
          description: Network Proxy URL
          title: Direct URL for wpad.dat download
        networkProxyCerts:
          type: array
          items:
            type: string
            format: byte
          description: Network Proxy Certificates
          title: Proxy Certificates
      description: Net Proxy Configurations
      title: Net Proxy Configurations
    NetWirelessConfig:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/NetworkWirelessType'
        cellularCfg:
          $ref: '#/components/schemas/NetCellularConfig'
        wifiCfg:
          $ref: '#/components/schemas/NetWifiConfig'
    NetProjectInfo:
      type: object
      properties:
        projectId:
          type: string
          description: system generated unique id for a project
          readOnly: true
          pattern: '[0-9A-Za-z-]+'
        projectName:
          type: string
          description: project name
    ZcOpsType:
      type: string
      enum:
        - OPS_TYPE_UNSPECIFIED
        - OPS_TYPE_READ
        - OPS_TYPE_DELETE
        - OPS_TYPE_CREATE
        - OPS_TYPE_UPDATE
        - OPS_TYPE_LIST
      default: OPS_TYPE_UNSPECIFIED
      title: ZedCloud internal operation type
    ZcOpsStatus:
      type: string
      enum:
        - OPS_STATUS_UNSPECIFIED
        - OPS_STATUS_PENDING
        - OPS_STATUS_ONGOING
        - OPS_STATUS_COMPLETE
      default: OPS_STATUS_UNSPECIFIED
      description: >-
        - OPS_STATUS_PENDING: In rare cases, system may not start operation when
        it was requested. Client will be notified that operation is PENDING
         - OPS_STATUS_ONGOING: system will start the operation, but at the time response was generated, operation is still ONGOING.
         - OPS_STATUS_COMPLETE: Even if the result of the operations may result in failure, but the OpsStatus will marked COMPLETE for almost all cases.
      title: ZedCloud internal operation status
    ObjectType:
      type: string
      enum:
        - OBJECT_TYPE_UNSPECIFIED
        - OBJECT_TYPE_USER
        - OBJECT_TYPE_EDGE_NODE
        - OBJECT_TYPE_EDGE_APP
        - OBJECT_TYPE_IMAGE
        - OBJECT_TYPE_EDGE_APP_INSTANCE
        - OBJECT_TYPE_PROJECT
        - OBJECT_TYPE_NETWORK
        - OBJECT_TYPE_DATASTORE
        - OBJECT_TYPE_SERVICE
        - OBJECT_TYPE_SERVICE_INSTANCE
        - OBJECT_TYPE_ENTERPRISE
        - OBJECT_TYPE_ROLE
        - OBJECT_TYPE_CREDENTIAL
        - OBJECT_TYPE_NETWORK_INSTANCE
        - OBJECT_TYPE_VOLUME_INSTANCE
        - OBJECT_TYPE_REALM
        - OBJECT_TYPE_AUTHPROFILE
        - OBJECT_TYPE_POLICY
        - OBJECT_TYPE_APP_POLICY
        - OBJECT_TYPE_CLUSTER_INSTANCE
        - OBJECT_TYPE_PLUGIN
        - OBJECT_TYPE_DOC_POLICY
        - OBJECT_TYPE_ORCHESTRATOR_CLUSTER
        - OBJECT_TYPE_TAGS
        - OBJECT_TYPE_EDGE_NODE_INTERFACE
        - OBJECT_TYPE_DEPLOYMENT
        - OBJECT_TYPE_ENTITLEMENTS
        - OBJECT_TYPE_DATA_STREAM
        - OBJECT_TYPE_API_USAGE
        - OBJECT_TYPE_APP_INSTANCE_SNAPSHOT
        - OBJECT_TYPE_PATCH_ENVELOPE
        - OBJECT_TYPE_RESOURCE_USAGE_TRACK
        - OBJECT_TYPE_PATCH_ENVELOPE_REFERENCE
        - OBJECT_TYPE_DEV_PASSTHROUGH
        - OBJECT_TYPE_EDGE_NODE_CLUSTER
        - OBJECT_TYPE_ASSET_GROUP
        - OBJECT_TYPE_APP_PROFILE
        - OBJECT_TYPE_PROFILE_DEPLOYMENT
        - OBJECT_TYPE_ZKS_INSTANCE
        - OBJECT_TYPE_CLUSTER_GROUP
      default: OBJECT_TYPE_UNSPECIFIED
    ZsrvError:
      type: object
      properties:
        ec:
          title: |-
            Enumrated error code, describes more granular numerical
            value than just httpStatus
          allOf:
            - $ref: '#/components/schemas/ZsrvErrorCode'
        location:
          type: string
          title: 'Ignore: Internal field only'
        details:
          type: string
          title: Field captures string description of details
    protobufAny:
      type: object
      properties:
        typeUrl:
          type: string
        value:
          type: string
          format: byte
    NetworkDHCPType:
      type: string
      enum:
        - NETWORK_DHCP_TYPE_UNSPECIFIED
        - NETWORK_DHCP_TYPE_STATIC
        - NETWORK_DHCP_TYPE_PASSTHROUGH
        - NETWORK_DHCP_TYPE_DEPRECATED
        - NETWORK_DHCP_TYPE_CLIENT
        - NETWORK_DHCP_TYPE_STATIC_ADAPTER_SPECIFIC
      default: NETWORK_DHCP_TYPE_UNSPECIFIED
      title: |-
        - NETWORK_DHCP_TYPE_STATIC: used for adapter configured DHCP static
         - NETWORK_DHCP_TYPE_PASSTHROUGH: used for adapter configured DHCP none, application will do DHCP
         - NETWORK_DHCP_TYPE_DEPRECATED: used for application simulation
         - NETWORK_DHCP_TYPE_CLIENT: used for adapter configured DHCP client
         - NETWORK_DHCP_TYPE_STATIC_ADAPTER_SPECIFIC: used to configure device adapter specific static networks
    dhcpIpRange:
      type: object
      properties:
        start:
          type: string
          description: starting IP
        end:
          type: string
          description: ending IP
      description: DHCP IP range
      title: DHCP IP range
    NtpServer:
      type: object
      properties:
        server:
          type: string
          description: NTP Server IP or FQDN
      description: NTP Server
      title: NTP Server
    NetProxyServer:
      type: object
      properties:
        proto:
          description: >-
            Net Proxy proto


            **Source definition conflict:** this property declares type
            `"object"`, while the referenced definition declares `"string"`. The
            referenced schema is shown; the conflicting declaration needs
            correction in ZEDEDA's Swagger definition.
          allOf:
            - $ref: '#/components/schemas/NetworkProxyProto'
          x-zededa-source-issues:
            - code: conflicting-reference
              pointer: '#/definitions/NetProxyServer/properties/proto'
              keyword: type
              sourceValue: object
              reference: '#/definitions/NetworkProxyProto'
              referencedValue: string
        server:
          type: string
          description: Net Proxy Server
        port:
          type: number
          format: int64
          description: Net Proxy Port
      description: Net Proxy Server
      title: Net Proxy Server
    NetworkWirelessType:
      type: string
      enum:
        - NETWORK_WIRELESS_TYPE_UNSPECIFIED
        - NETWORK_WIRELESS_TYPE_WIFI
        - NETWORK_WIRELESS_TYPE_CELLULAR
      default: NETWORK_WIRELESS_TYPE_UNSPECIFIED
    NetCellularConfig:
      type: object
      properties:
        APN:
          type: string
          description: >-
            APN string - by default it is "internet".

            TO BE DEPRECATED: Fill connection arguments inside access_points
            instead.

            If access_points is non-empty, then APN field is ignored.
        probe:
          description: |-
            Optional cellular connectivity probing.
            By default it is enabled.
          allOf:
            - $ref: '#/components/schemas/configCellularConnectivityProbe'
        locationTracking:
          type: boolean
          description: >-
            Some LTE modems have GNSS receiver integrated and can be used for
            device

            location tracking.

            Enable this option to have location info periodically obtained from
            this

            modem and published to controller and to applications.
        accessPoints:
          type: array
          items:
            $ref: '#/components/schemas/NetCellularAccessPoint'
          description: |-
            Parameters to apply for connecting to cellular networks.
            Configured separately for every SIM card inserted into the modem.
        activatedSimSlot:
          type: integer
          format: int64
          description: |-
            Select SIM card slot to activate.
            Currently, EVE support only single-standby SIM card mode.
            0 - unspecified (leave the currently activated)
            1 - activate the first SIM slot
            2 - activate the second SIM slot
            etc.
    NetWifiConfig:
      type: object
      properties:
        wifiSSID:
          type: string
        keyScheme:
          $ref: '#/components/schemas/NetworkWiFiKeyScheme'
        identity:
          type: string
        secret:
          $ref: '#/components/schemas/NetWifiConfigSecrets'
        crypto:
          $ref: '#/components/schemas/NetWifiConfigNetcryptoblock'
        priority:
          type: integer
          format: int32
        encryptedSecrets:
          type: object
          additionalProperties:
            type: string
        cryptoKey:
          type: string
    ZsrvErrorCode:
      type: string
      enum:
        - zMsgErrorNone
        - zMsgSucess
        - NotFound
        - AlreadyExists
        - VersionMismatch
        - RangeError
        - LargeResult
        - IncompleteData
        - InvalidData
        - FunctionUnsupported
        - NoMemory
        - SendFailure
        - Timeout
        - BadReqBody
        - BadReqParam
        - InvalidFieldFormat
        - UrlNotFound
        - ApiVersionNotSupported
        - Unauthorized
        - Forbidden
        - Conflict
        - NotModified
        - DependencyConflict
        - JsonFmtError
        - ProtoFmtError
        - CertError
        - DataBaseConnection
        - DBError
        - zMsgAccepted
        - zMsgCreated
        - PreConditionFailed
        - InternalServerError
      default: zMsgErrorNone
      description: |-
        - zMsgErrorNone: common validation errors
         - IncompleteData: message had fields that weren't filled in
         - InvalidData: message contained the field that wasn't expected
         - FunctionUnsupported: this feature unavailable on this version of device
         - InvalidFieldFormat: message contained the field that wasn't correctly formatted
         - JsonFmtError: Marshal / Unmarshal errors
         - DataBaseConnection: generic DB error
      title: ZedCould internal error code
    NetworkProxyProto:
      type: string
      enum:
        - NETWORK_PROXY_PROTO_HTTP
        - NETWORK_PROXY_PROTO_HTTPS
        - NETWORK_PROXY_PROTO_SOCKS
        - NETWORK_PROXY_PROTO_FTP
        - NETWORK_PROXY_PROTO_OTHER
      default: NETWORK_PROXY_PROTO_HTTP
    configCellularConnectivityProbe:
      type: object
      properties:
        disable:
          type: boolean
          description: If true, then probing is disabled.
        probeAddress:
          type: string
          description: >-
            IP/FQDN to periodically probe using 3 pings per iteration to
            determine connectivity status.

            This field is now deprecated and replaced with custom_probe (see
            below).

            To maintain backward-compatibility, EVE will check both
            probe_address and custom_probe

            and will use whichever has non-zero value (if any), but preferring
            custom_probe.
        customProbe:
          description: >-
            User-defined probe for cellular connectivity testing.

            Only IP address is allowed as ConnectivityProbe.probe_address (and
            port if needed),

            not hostname.

            The probing algorithm is more complex that just testing reachability
            of a remote

            endpoint and the goal is to minimize generated traffic, probing time
            and false negatives

            (that would trigger undesired re-connect).

            EVE will periodically check the modem status, accessibility of DNS
            server(s) and potentially

            also proxies in the local network, and only as the last resort (if
            connectivity state

            is still unclear) it will probe the remote endpoint. If custom_probe
            is not defined,

            EVE will try to ping "8.8.8.8" (Google public DNS).

            It is recommended to use custom probe for private LTE networks where
            public DNS servers

            might not be allowed by the firewall (and hence ping would fail even
            with a working

            connectivity).
          allOf:
            - $ref: '#/components/schemas/commonConnectivityProbe'
      description: >-
        CellularConnectivityProbe is used to periodically check the connectivity
        status of a cellular network

        by probing a remote endpoint.

        Whenever the probe fails, the cellular connection is automatically
        restarted. If the probe keeps failing

        even after the restart, the failure is reported in
        ZCellularStatus.probeError.

        The connectivity probing interval is 5 minutes and currently it is not
        configurable.
    NetCellularAccessPoint:
      type: object
      properties:
        simSlot:
          type: integer
          format: int64
          description: |-
            SIM card slot to which this configuration applies.
            0 - unspecified (apply to currently activated or the only available)
            1 - config for SIM card in the first slot
            2 - config for SIM card in the second slot
            etc.
        apn:
          type: string
          description: |-
            Access Point Network to connect into.
            By default it is "internet".
        authProtocol:
          description: Authentication protocol used by the network.
          allOf:
            - $ref: '#/components/schemas/evecommonCellularAuthProtocol'
        cipherData:
          description: |-
            Cipher data may contain encrypted user credentials
            (inside cellNetUsername and cellNetPassword fields).
          allOf:
            - $ref: '#/components/schemas/commonCipherBlock'
        preferredPlmns:
          type: array
          items:
            type: string
          description: >-
            The set of cellular network operators that modem should preferably
            try to register

            and connect into.

            Network operator should be referenced by PLMN (Public Land Mobile
            Network) code,

            consisting of 3-digits MCC (Mobile Country Code) and 2 or 3-digits
            MNC (Mobile Network Code),

            separated by a dash, e.g. "310-260".

            If empty, then modem will select the network automatically based on
            the SIM card config.
        forbidRoaming:
          type: boolean
          description: If true, then modem will avoid connecting to networks with roaming.
        preferredRats:
          type: array
          items:
            $ref: '#/components/schemas/evecommonRadioAccessTechnology'
          description: >-
            The list of preferred Radio Access Technologies (RATs) to use for
            connecting

            to the network.

            Order matters, first is the most preferred, second is tried next,
            etc.

            Not listed technologies will not be tried.

            If empty, then modem will select RAT automatically.
        ipType:
          description: The IP addressing type to use for the default bearer.
          allOf:
            - $ref: '#/components/schemas/commonCellularIPType'
        attachApn:
          type: string
          description: >-
            Access Point Name (APN) for the attach (initial) bearer.

            This field is optional. If not specified, EVE will not send any
            attach bearer

            configuration to the modem. Instead, the modem will use one of its
            pre-installed

            profiles (see CellularProfile) to determine the configuration.
        attachIpType:
          description: |-
            The IP addressing type to use for the attach bearer.
            Leave undefined if attach_apn is not specified.
          allOf:
            - $ref: '#/components/schemas/commonCellularIPType'
        attachAuthProtocol:
          description: |-
            Authentication protocol used for the attach bearer.
            Leave undefined if attach_apn is not specified.
          allOf:
            - $ref: '#/components/schemas/CellularAuthProtocol'
        secrets:
          $ref: '#/components/schemas/NetCellularAccessPointSecrets'
        encryptedSecrets:
          type: object
          additionalProperties:
            type: string
        cryptoKey:
          type: string
        attachSecrets:
          $ref: '#/components/schemas/NetCellularAccessPointSecrets'
        attachEncryptedSecrets:
          type: object
          additionalProperties:
            type: string
    NetworkWiFiKeyScheme:
      type: string
      enum:
        - NETWORK_WIFIKEY_SCHEME_UNSPECIFIED
        - NETWORK_WIFIKEY_SCHEME_WPAPSK
        - NETWORK_WIFIKEY_SCHEME_WPAEAP
      default: NETWORK_WIFIKEY_SCHEME_UNSPECIFIED
    NetWifiConfigSecrets:
      type: object
      properties:
        WiFiPasswd:
          type: string
          description: Wifi Password
    NetWifiConfigNetcryptoblock:
      type: object
      properties:
        identity:
          type: string
        password:
          type: string
    commonConnectivityProbe:
      type: object
      properties:
        probeMethod:
          description: Method to use to determine the connectivity status.
          allOf:
            - $ref: '#/components/schemas/commonConnectivityProbeMethod'
        probeEndpoint:
          description: |-
            Endpoint to probe using the selected probing mechanism to determine
            the connectivity status.
          allOf:
            - $ref: '#/components/schemas/commonProbeEndpoint'
      description: Configuration for user-defined connectivity-testing probe.
    evecommonCellularAuthProtocol:
      type: string
      enum:
        - CELLULAR_AUTH_PROTOCOL_NONE
        - CELLULAR_AUTH_PROTOCOL_PAP
        - CELLULAR_AUTH_PROTOCOL_CHAP
        - CELLULAR_AUTH_PROTOCOL_PAP_AND_CHAP
      default: CELLULAR_AUTH_PROTOCOL_NONE
      description: >-
        CellularAuthProtocol defines the authentication protocol used for
        cellular connection.

         - CELLULAR_AUTH_PROTOCOL_NONE: No authentication.
         - CELLULAR_AUTH_PROTOCOL_PAP: Password Authentication Protocol.
         - CELLULAR_AUTH_PROTOCOL_CHAP: Challenge-Handshake Authentication Protocol.
         - CELLULAR_AUTH_PROTOCOL_PAP_AND_CHAP: Both PAP and CHAP.
    commonCipherBlock:
      type: object
      properties:
        cipherContextId:
          type: string
          title: cipher context id
        initialValue:
          type: string
          format: byte
          title: Initial Value for Symmetric Key derivation
        cipherData:
          type: string
          format: byte
          title: encrypted sensitive data
        clearTextSha256:
          type: string
          format: byte
          title: sha256 of the plaintext sensitive data
      title: Encrypted sensitive data information
    evecommonRadioAccessTechnology:
      type: string
      enum:
        - RADIO_ACCESS_TECHNOLOGY_UNSPECIFIED
        - RADIO_ACCESS_TECHNOLOGY_GSM
        - RADIO_ACCESS_TECHNOLOGY_UMTS
        - RADIO_ACCESS_TECHNOLOGY_LTE
        - RADIO_ACCESS_TECHNOLOGY_5GNR
      default: RADIO_ACCESS_TECHNOLOGY_UNSPECIFIED
      description: |2-
         - RADIO_ACCESS_TECHNOLOGY_GSM: Global System for Mobile Communications (2G).
         - RADIO_ACCESS_TECHNOLOGY_UMTS: Universal Mobile Telecommunications System (3G).
         - RADIO_ACCESS_TECHNOLOGY_LTE: Long Term Evolution (4G).
         - RADIO_ACCESS_TECHNOLOGY_5GNR: 5G New Radio.
    commonCellularIPType:
      type: string
      enum:
        - CELLULAR_IP_TYPE_UNSPECIFIED
        - CELLULAR_IP_TYPE_IPV4
        - CELLULAR_IP_TYPE_IPV4_AND_IPV6
        - CELLULAR_IP_TYPE_IPV6
      default: CELLULAR_IP_TYPE_UNSPECIFIED
      description: >-
        The IP addressing type to use for a given attach or default bearer.

         - CELLULAR_IP_TYPE_UNSPECIFIED: IP type is not specified.
        When unspecified, EVE will not enforce an IP type in the bearer
        configuration.

        The modem will instead use its built-in profiles (see CellularProfile)
        to determine

        the appropriate IP type for the network.
         - CELLULAR_IP_TYPE_IPV4: IPv4 only.
         - CELLULAR_IP_TYPE_IPV4_AND_IPV6: IPv4 and IPv6.
         - CELLULAR_IP_TYPE_IPV6: IPv6 only.
    CellularAuthProtocol:
      type: string
      enum:
        - CELLULAR_AUTH_PROTOCOL_NONE
        - CELLULAR_AUTH_PROTOCOL_PAP
        - CELLULAR_AUTH_PROTOCOL_CHAP
        - CELLULAR_AUTH_PROTOCOL_PAP_AND_CHAP
      default: CELLULAR_AUTH_PROTOCOL_NONE
      description: |2-
         - CELLULAR_AUTH_PROTOCOL_NONE: No authentication.
         - CELLULAR_AUTH_PROTOCOL_PAP: Password Authentication Protocol.
         - CELLULAR_AUTH_PROTOCOL_CHAP: Challenge-Handshake Authentication Protocol.
         - CELLULAR_AUTH_PROTOCOL_PAP_AND_CHAP: Both PAP and CHAP.
    NetCellularAccessPointSecrets:
      type: object
      properties:
        username:
          type: string
          description: Cellular Username
        password:
          type: string
          description: Cellular Password
    commonConnectivityProbeMethod:
      type: string
      enum:
        - CONNECTIVITY_PROBE_METHOD_UNSPECIFIED
        - CONNECTIVITY_PROBE_METHOD_ICMP
        - CONNECTIVITY_PROBE_METHOD_TCP
      default: CONNECTIVITY_PROBE_METHOD_UNSPECIFIED
      description: |-
        User-defined method to use to determine the connectivity status.

         - CONNECTIVITY_PROBE_METHOD_UNSPECIFIED: Connectivity probing method is not specified and therefore will not be used.
         - CONNECTIVITY_PROBE_METHOD_ICMP: Use ICMP ping against the probed endpoint to determine the connectivity status.
         - CONNECTIVITY_PROBE_METHOD_TCP: Try to establish TCP connection with the probed endpoint to determine the connectivity
        status.
    commonProbeEndpoint:
      type: object
      properties:
        host:
          type: string
          description: IP address or FQDN.
        port:
          type: integer
          format: int64
          description: |-
            TCP port required for CONNECTIVITY_PROBE_METHOD_TCP.
            Leave empty for CONNECTIVITY_PROBE_METHOD_ICMP.
      description: >-
        Address of a remote endpoint to probe in order to determine connectivity
        status.
  securitySchemes:
    BearerToken:
      type: http
      description: Bearer token for user session
      scheme: bearer

````