> ## 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. # Get Cluster Instances kubeconfig by name. > GET /api/v1/cluster/instances/name/{name}/status/kubeconfig. Orchestrator 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: > >
    >
  1. Profile menu
  2. Help & Documentation
  3. API Reference
    4. >
> > 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) 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/orchestrator.json) A successful response. 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 application level access permission for the operation or does not have access scope to the project. Not Found. The API gateway did not process the request because the requested resource could not be found. 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/orchestrator.json GET /v1/cluster/instances/name/{name}/status/kubeconfig openapi: 3.0.0 info: title: ZEDEDA Orchestrator Service description: >- The ZEDEDA Orchestrator Service is part of ZEDEDA Edge Orchestration Platform. Orchestrator service defines the user facing APIs to interact with a third-party client (e.x. Azure, Rancher). 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: ClusterInstanceConfiguration - name: ClusterInstanceStatus - name: ThirdPartyPluginManagement - name: DataStreamConfigs - name: AzureDeployments - name: APIUsageTracking externalDocs: description: ZEDEDA Product Documentation url: https://docs.zededa.com/-M-8m8d8KqdLpfOgY_jo/cluster-instance-management paths: /v1/cluster/instances/name/{name}/status/kubeconfig: get: tags: - ClusterInstanceStatus summary: Get Cluster Instances kubeconfig by name. description: Get status kubeconfig of an Cluster Instances by name. operationId: ClusterInstanceStatus_GetClusterInstanceKubeconfigByName parameters: - name: name description: >- User defined name of the cluster instance, unique across the enterprise. Once cluster instance is created, name can’t be changed in: path required: true schema: type: string - name: X-Request-Id in: header required: false description: User-Agent specified id to track a request schema: type: string responses: '200': description: A successful response. content: application/json: schema: $ref: '#/components/schemas/ClusterInstStatusMsg' '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 application level access permission for the operation or does not have access scope to the project. content: application/json: schema: $ref: '#/components/schemas/ZsrvResponse' '404': description: >- Not Found. The API gateway did not process the request because the requested resource could not be found. 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/cluster-instance-management components: schemas: ClusterInstStatusMsg: type: object properties: id: type: string description: System defined universally unique Id of the cluster instance readOnly: true pattern: '[0-9A-Za-z-]+' x-zededa-source-issues: - code: inapplicable-constraint pointer: '#/definitions/ClusterInstStatusMsg/properties/id' keyword: uniqueItems sourceValue: true name: type: string description: >- User defined name of the cluster instance, unique across the enterprise. Once cluster instance 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/ClusterInstStatusMsg/properties/name' keyword: uniqueItems sourceValue: true title: type: string description: >- User defined title of the cluster instance. Title can be changed at any time maxLength: 256 minLength: 3 pattern: ^[a-zA-Z0-9]+[a-zA-Z0-9!-~ ]+$ tags: type: object additionalProperties: type: string description: >- Tags are name/value pairs that enable you to categorize resources. Tag names are case insensitive with max_length 512 and min_length 3. Tag values are case sensitive with max_length 256 and min_length 3. maxLength: 32 pattern: ^[^<%&?/\>]+$ clusterType: description: Type of cluster allOf: - $ref: '#/components/schemas/ClusterType' projectId: type: string description: project id which the given cluster instance belong to adminState: description: SPU details allOf: - $ref: '#/components/schemas/AdminState' runState: description: operation status allOf: - $ref: '#/components/schemas/ClusterRunState' clusterPolicyId: type: string description: System defined universally unique Id of the cluster policy readOnly: true pattern: '[0-9A-Za-z-]+' x-zededa-source-issues: - code: inapplicable-constraint pointer: '#/definitions/ClusterInstStatusMsg/properties/clusterPolicyId' keyword: uniqueItems sourceValue: true minEdgeDevices: type: number format: int64 description: Minimum number of edge device required for the cluster instance maxEdgeDevices: type: number format: int64 description: Maximum number of edge device allowed in the cluster instance minServerNodes: type: number format: int64 description: Minimum number of server nodes required for the cluster instance maxServerNodes: type: number format: int64 description: Maximum number of server nodes allowed in the cluster instance minAgentNodes: type: number format: int64 description: Minimum number of agent nodes required for the cluster instance maxAgentNodes: type: number format: int64 description: Maximum number of agent nodes allowed in the cluster instance edgeNodeSummaries: type: array items: $ref: '#/components/schemas/DeviceStatusSummaryMsg' description: Device summaries memory: description: memory summary allOf: - $ref: '#/components/schemas/MemorySummary' storage: description: storage summary allOf: - $ref: '#/components/schemas/StorageSummary' cpu: description: CPU details allOf: - $ref: '#/components/schemas/CpuSummary' serverNodeSummaries: type: array items: $ref: '#/components/schemas/AppInstStatusSummaryMsg' description: Cluster Server Nodes (appInstances) summaries agentNodeSummaries: type: array items: $ref: '#/components/schemas/AppInstStatusSummaryMsg' description: Cluster Agent Nodes (appInstances) summaries nodesJobName: type: string description: Name of the job object tracking ClusterNodes deployment maxLength: 256 minLength: 3 pattern: '[a-zA-Z0-9][a-zA-Z0-9_.-]+' x-zededa-source-issues: - code: inapplicable-constraint pointer: '#/definitions/ClusterInstStatusMsg/properties/nodesJobName' keyword: uniqueItems sourceValue: true orchestratorClusterID: type: string description: Orchestrator cluster object ID maxLength: 256 orchestratorClusterRunState: description: Orchestrator cluster object's state allOf: - $ref: '#/components/schemas/RunState' orchestratorClusterErrMsg: description: Error message from Orchestrator cluster object allOf: - $ref: '#/components/schemas/OrchestratorObjectError' orchestratorClusterWarnMsg: description: Warning message from Orchestrator cluster object allOf: - $ref: '#/components/schemas/OrchestratorObjectError' rawOrchestratorClusterStatus: type: string description: Raw status of Orchestrator cluster object maxLength: 256 edgeNodeJobNames: type: array items: type: string description: >- Array of job names which are tracking dynamic device addition/deletion nodeRefreshJobNames: type: array items: type: string description: Array of job names which are tracking cluster nodes refresh action nodesJobID: type: string description: ID of the job object tracking ClusterNodes deployment readOnly: true pattern: '[0-9A-Za-z-]+' x-zededa-source-issues: - code: inapplicable-constraint pointer: '#/definitions/ClusterInstStatusMsg/properties/nodesJobID' keyword: uniqueItems sourceValue: true tmcStatus: $ref: '#/components/schemas/TMCClusterStatus' description: ClusterInstanceStatusMsg encapsulates the status of an cluster instance title: Cluster instance status message 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' ClusterType: type: string enum: - CLUSTER_TYPE_UNSPECIFIED - CLUSTER_TYPE_K3S - CLUSTER_TYPE_TKG_ATTACH default: CLUSTER_TYPE_UNSPECIFIED title: |- - CLUSTER_TYPE_K3S: cluster type is k3s - CLUSTER_TYPE_TKG_ATTACH: cluster type is TKG, with subtype ATTACH AdminState: type: string enum: - ADMIN_STATE_UNSPECIFIED - ADMIN_STATE_CREATED - ADMIN_STATE_DELETED - ADMIN_STATE_ACTIVE - ADMIN_STATE_INACTIVE - ADMIN_STATE_REGISTERED - ADMIN_STATE_ARCHIVED - ADMIN_STATE_DELETION_PENDING default: ADMIN_STATE_UNSPECIFIED description: |- - ADMIN_STATE_CREATED: Entity Created in the controller - ADMIN_STATE_DELETED: Entity Deleted in the controller - ADMIN_STATE_ACTIVE: Entity Activated in the controller - ADMIN_STATE_INACTIVE: Entity Deactivated in the controller - ADMIN_STATE_REGISTERED: Specific to Edge-node - Edge-node Registered with the controller - ADMIN_STATE_ARCHIVED: Entity Archived in the controller - ADMIN_STATE_DELETION_PENDING: Entity was marked as Deleted but not yet deleted in the controller title: AdminState - On update, please update AdminState_HttpRequest as well ClusterRunState: type: string enum: - CLUSTER_RUN_STATE_UNSPECIFIED - CLUSTER_RUN_STATE_INIT - CLUSTER_RUN_STATE_PROVISIONING_SEED_SERVER - CLUSTER_RUN_STATE_PROVISIONED_SEED_SERVER - CLUSTER_RUN_STATE_UNHEALTHY - CLUSTER_RUN_STATE_PROVISIONING_NODES - CLUSTER_RUN_STATE_HEALTHY - CLUSTER_RUN_STATE_PARTIALLY_HEALTHY - CLUSTER_RUN_STATE_OFFLINE default: CLUSTER_RUN_STATE_UNSPECIFIED description: |- - CLUSTER_RUN_STATE_INIT: Cluster Initializing - CLUSTER_RUN_STATE_PROVISIONING_SEED_SERVER: Cluster Provisioning seed server - CLUSTER_RUN_STATE_PROVISIONED_SEED_SERVER: Cluster Provisioned seed server - CLUSTER_RUN_STATE_UNHEALTHY: Cluster unhealthy - CLUSTER_RUN_STATE_PROVISIONING_NODES: Cluster Provisioning node - CLUSTER_RUN_STATE_HEALTHY: Cluster healthy - CLUSTER_RUN_STATE_PARTIALLY_HEALTHY: Cluster partially healthy - CLUSTER_RUN_STATE_OFFLINE: Cluster offline title: Run-time state of an object, reported by EVE DeviceStatusSummaryMsg: type: object properties: name: type: string id: type: string adminState: $ref: '#/components/schemas/AdminState' runState: $ref: '#/components/schemas/RunState' tags: type: object additionalProperties: type: string description: >- Tags are name/value pairs that enable you to categorize resources. Tag names are case insensitive with max_length 512 and min_length 3. Tag values are case sensitive with max_length 256 and min_length 3. title: deprecated = 5; maxLength: 32 pattern: ^[^<%&?/\>]+$ netStatusList: type: array items: $ref: '#/components/schemas/NetworkStatus' swInfo: type: array items: $ref: '#/components/schemas/DeviceSWInfo' minfo: $ref: '#/components/schemas/ZManufacturerInfo' dinfo: $ref: '#/components/schemas/DeviceInfo' Memory: description: Memory - OBSOLETE. Use memorySummary instead. allOf: - $ref: '#/components/schemas/MemorySummary' Storage: $ref: '#/components/schemas/StorageSummary' Cpu: $ref: '#/components/schemas/CpuSummary' devError: type: array items: $ref: '#/components/schemas/DeviceError' projectId: type: string title: type: string clusterID: type: string description: >- System defined universally unique clusterInstance ID, unique across the enterprise. maxLength: 256 minLength: 3 pattern: '[a-zA-Z0-9][a-zA-Z0-9_.-]+' x-zededa-source-issues: - code: inapplicable-constraint pointer: '#/definitions/DeviceStatusSummaryMsg/properties/clusterID' keyword: uniqueItems sourceValue: true memorySummary: description: Device memory Info allOf: - $ref: '#/components/schemas/DeviceMemorySummary' debugKnob: type: boolean title: debug knob expiry time debugKnobExpiryTime: type: string format: date-time projectName: type: string description: Project name to which device is associated with appInstCount: type: integer format: int64 description: App instance count that is actively running on the device location: type: string description: Device location edgeviewActive: type: boolean description: Device edgeview session active projectType: description: Tag group type allOf: - $ref: '#/components/schemas/TagType' clusterNodeStatus: description: Cluster node status allOf: - $ref: '#/components/schemas/ClusterNodeStatus' enrolledCertsStatus: description: Enrolled certificate status from the device allOf: - $ref: '#/components/schemas/EnrolledCertStatus' MemorySummary: type: object properties: TotalMB: type: number format: double description: Total memory for the device in MBs UsedMB: type: number format: double description: Total memory used by the device in MBs within allocated memory AllocatedMB: type: number format: double description: Total allocated memory in MBs description: Memory Summary title: Memory Summary StorageSummary: type: object properties: TotalMB: type: number format: double description: Total Storage for the device in MBs UsedMB: type: number format: double description: How much is used within the allocated total storage AllocatedMB: type: number format: double description: Total reserved for running applications + temp. images etc sharedStorageSummary: type: array items: $ref: '#/components/schemas/SharedStorageSummary' description: Shared storage summary Id: type: string description: Id Name: type: string description: Name description: Storage Summary title: Storage Summary CpuSummary: type: object properties: Utilization: type: number format: double description: CPU Utilization description: CPU Summary title: CPU Summary AppInstStatusSummaryMsg: type: object properties: id: type: string description: System defined universally unique Id of the app instance readOnly: true pattern: '[0-9A-Za-z-]+' x-zededa-source-issues: - code: inapplicable-constraint pointer: '#/definitions/AppInstStatusSummaryMsg/properties/id' keyword: uniqueItems sourceValue: true name: type: string description: >- User defined name of the app instance, unique across the enterprise. Once app instance 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/AppInstStatusSummaryMsg/properties/name' keyword: uniqueItems sourceValue: true deviceId: type: string description: >- User defined name of the device, unique across the enterprise. Once device 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/AppInstStatusSummaryMsg/properties/deviceId' keyword: uniqueItems sourceValue: true appId: type: string description: >- User defined name of the edge app, unique across the enterprise. Once edge app 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/AppInstStatusSummaryMsg/properties/appId' keyword: uniqueItems sourceValue: true tags: type: object additionalProperties: type: string description: >- Tags are name/value pairs that enable you to categorize resources. Tag names are case insensitive with max_length 512 and min_length 3. Tag values are case sensitive with max_length 256 and min_length 3. maxLength: 32 pattern: ^[^<%&?/\>]+$ adminState: description: SPU details allOf: - $ref: '#/components/schemas/AdminState' clusterID: type: string description: >- System defined universally unique clusterInstance ID, unique across the enterprise. maxLength: 256 minLength: 3 pattern: '[a-zA-Z0-9][a-zA-Z0-9_.-]+' x-zededa-source-issues: - code: inapplicable-constraint pointer: '#/definitions/AppInstStatusSummaryMsg/properties/clusterID' keyword: uniqueItems sourceValue: true runState: description: operation status allOf: - $ref: '#/components/schemas/RunState' Memory: description: memory summary allOf: - $ref: '#/components/schemas/MemorySummary' Storage: description: storage summary allOf: - $ref: '#/components/schemas/StorageSummary' swState: description: sotware state allOf: - $ref: '#/components/schemas/SWState' Cpu: description: cpu summary allOf: - $ref: '#/components/schemas/CpuSummary' projectId: type: string description: >- User defined name of the project, unique across the enterprise. Once project 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/AppInstStatusSummaryMsg/properties/projectId' keyword: uniqueItems sourceValue: true title: type: string description: >- User defined title of the app instance. Title can be changed at any time maxLength: 256 minLength: 3 pattern: ^[a-zA-Z0-9]+[a-zA-Z0-9!-~ ]+$ appType: description: type of app allOf: - $ref: '#/components/schemas/AppType' deploymentType: description: 'type of deployment for the app, eg: azure, k3s, standalone' allOf: - $ref: '#/components/schemas/DeploymentType' memorySummary: description: memory summary allOf: - $ref: '#/components/schemas/AppInstMemorySummary' swInfo: type: array items: $ref: '#/components/schemas/SWInfo' description: Software details appName: type: string description: >- User defined name of the edge app, unique across the enterprise. Once edge app 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/AppInstStatusSummaryMsg/properties/appName' keyword: uniqueItems sourceValue: true projectName: type: string description: >- User defined name of the project, unique across the enterprise. Once project 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/AppInstStatusSummaryMsg/properties/projectName' keyword: uniqueItems sourceValue: true deviceName: type: string description: >- User defined name of the device, unique across the enterprise. Once device 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/AppInstStatusSummaryMsg/properties/deviceName' keyword: uniqueItems sourceValue: true netStatusList: type: array items: $ref: '#/components/schemas/NetworkStatus' description: network status list description: AppInstStatusSummaryMsg stores the summary of the app instance status title: App instance status summary RunState: type: string enum: - RUN_STATE_UNSPECIFIED - RUN_STATE_ONLINE - RUN_STATE_HALTED - RUN_STATE_INIT - RUN_STATE_REBOOTING - RUN_STATE_OFFLINE - RUN_STATE_UNKNOWN - RUN_STATE_UNPROVISIONED - RUN_STATE_PROVISIONED - RUN_STATE_SUSPECT - RUN_STATE_DOWNLOADING - RUN_STATE_RESTARTING - RUN_STATE_PURGING - RUN_STATE_HALTING - RUN_STATE_ERROR - RUN_STATE_VERIFYING - RUN_STATE_LOADING - RUN_STATE_CREATING_VOLUME - RUN_STATE_BOOTING - RUN_STATE_MAINTENANCE_MODE - RUN_STATE_START_DELAYED - RUN_STATE_BASEOS_UPDATING - RUN_STATE_PREPARING_POWEROFF - RUN_STATE_POWERING_OFF - RUN_STATE_PREPARED_POWEROFF default: RUN_STATE_UNSPECIFIED description: |- - RUN_STATE_ONLINE: Entity Online - RUN_STATE_HALTED: Entity Halted - RUN_STATE_INIT: Entity Initializing - RUN_STATE_REBOOTING: Entity Rebooting - RUN_STATE_OFFLINE: Entity Offline - RUN_STATE_UNKNOWN: Entity state Unknown - RUN_STATE_UNPROVISIONED: Entity Unprovisioned - RUN_STATE_PROVISIONED: Entity Provisioned - RUN_STATE_SUSPECT: Entity Suspect - RUN_STATE_DOWNLOADING: Edge-node downloading entity artifacts - RUN_STATE_RESTARTING: Entity Restarting - RUN_STATE_PURGING: Entity Purging - RUN_STATE_HALTING: Entity Halting - RUN_STATE_ERROR: Entity encountered an error - RUN_STATE_VERIFYING: Verification of downloaded Artifacts in Progress. - RUN_STATE_LOADING: Loading of Artifacts into local datastore in Progress. - RUN_STATE_CREATING_VOLUME: Volume creation from artifacts in Progress - RUN_STATE_BOOTING: Entity booting up - RUN_STATE_MAINTENANCE_MODE: Entity maintenance mode - RUN_STATE_START_DELAYED: Application start delayed as per configuration - RUN_STATE_BASEOS_UPDATING: Device BaseOs Update in Progress - RUN_STATE_PREPARING_POWEROFF: device preparing power off - shutting down all app instances - RUN_STATE_POWERING_OFF: device powering off from local profile server - RUN_STATE_PREPARED_POWEROFF: device prepared power off - all app instances are shut down title: RunState - On update, please update RunState_HttpRequest as well OrchestratorObjectError: type: object properties: description: type: string description: Description of the error severity: type: string description: Severity of the error objectName: type: string description: Name of the orchestrator object description: >- OrchestratorObjectError store the error occurred at the Orchestrator object title: >- OrchestratorObjectError is used to store the error details of the Orchestrator object. required: - description - severity - objectName TMCClusterStatus: type: object properties: health: description: Cluster health allOf: - $ref: '#/components/schemas/TMCClusterStatusHealth' status: description: Cluster status allOf: - $ref: '#/components/schemas/TMCClusterStatusStatus' version: type: string description: Cluster TinyTKG version clusterGroupName: type: string description: Cluster group name title: Status of TMC cluster 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 NetworkStatus: type: object properties: up: type: boolean description: Network Status flag macAddr: type: string description: mac Address ifName: type: string description: ifName ipAddrs: type: array items: type: string description: Array of IP addresses defaultRouters: type: array items: type: string description: Default Routers dns: type: object description: DNS Configuration allOf: - $ref: '#/components/schemas/DNSInfo' location: type: object description: Geo Location Details allOf: - $ref: '#/components/schemas/GeoLocation' uplink: type: boolean description: Uplink flag proxy: type: object description: Network Proxy status allOf: - $ref: '#/components/schemas/NetProxyStatus' errInfo: type: object description: Network error details allOf: - $ref: '#/components/schemas/DeviceError' gpsLocation: type: object description: Location from GNSS receivers on WWAN type adapters allOf: - $ref: '#/components/schemas/GPSLocation' cellular: type: object description: Cellular network status allOf: - $ref: '#/components/schemas/CellularStatus' mtu: type: integer format: int64 description: Network MTU pnacStatus: description: PNAC 802.1X authentication status for this port title: PNAC (802.1X) authentication status for this port allOf: - $ref: '#/components/schemas/PNACPortStatus' configSource: description: Identifies the source of this network port configuration allOf: - $ref: '#/components/schemas/commonPortConfigSource' description: NetworkStatus is used to store the Network status title: NetworkStatus is used to store the Network Status DeviceSWInfo: type: object properties: activated: type: boolean partitionLabel: type: string partitionDevice: type: string partitionState: type: string status: $ref: '#/components/schemas/SWState' shortVersion: type: string longVersion: type: string swError: $ref: '#/components/schemas/DeviceError' downloadProgress: type: integer format: int64 swStatus: $ref: '#/components/schemas/DeviceSWStatus' swSubStatus: $ref: '#/components/schemas/DeviceSWSubStatus' swSubStatusStr: type: string subStatusProgress: type: integer format: int64 isLTS: type: boolean description: flag to indicate device running LTS eve version or not ZManufacturerInfo: type: object properties: manufacturer: type: string productName: type: string version: type: string serialNumber: type: string uuid: type: string compatible: type: string biosVendor: type: string biosVersion: type: string biosReleaseDate: type: string hSMStatus: $ref: '#/components/schemas/DeviceHWSecurityModuleStatus' hSMInfo: type: string endorsementKey: type: string DeviceInfo: type: object properties: machineArch: type: string cpuArch: type: string platform: type: string nCpu: type: integer format: int64 memMB: type: string format: uint64 storageMB: type: string format: uint64 DeviceError: type: object properties: description: type: string description: Description of the error severity: type: string description: Severity of the error allOf: - $ref: '#/components/schemas/Severity' timestamp: type: object format: date-time description: Timestamp at which error had occurred entities: type: array items: $ref: '#/components/schemas/DeviceEntity' description: objects referenced by the description or retry_condition retryCondition: type: string description: condition for retry description: DeviceError store the error occurred at the device side title: DeviceError is used to store the error details of the hardware. required: - description - severity - timestamp - entities DeviceMemorySummary: type: object properties: deviceMemoryMB: type: number format: double description: Total memory on the device. title: deviceMemoryMB >= allocatedForAppsMB + allocatedForEveMB allocatedAppsMB: type: number format: double description: Total memory allocated to app instances. allocatedEveMB: type: number format: double description: Total memory allocated to EVE on the device. usedEveMB: type: number format: double description: Memory currently used by EVE on the device. title: usedByEveMB <= allocatedForEveMB availableForNewApps: type: number format: double description: Memory Available for new app-instances on the device. title: >- availableForNewApps = deviceMemoryMB - ( allocatedForAppsMB + allocatedForEveMB ) description: DeviceMemorySummary encapsulates the memory status of the device. title: Device Memory Information message TagType: type: string enum: - TAG_TYPE_UNSPECIFIED - TAG_TYPE_GENERIC - TAG_TYPE_PROJECT - TAG_TYPE_AZURE - TAG_TYPE_DEPLOYMENT default: TAG_TYPE_UNSPECIFIED description: |- - TAG_TYPE_UNSPECIFIED: Unspecified - TAG_TYPE_GENERIC: Generic resource group - TAG_TYPE_PROJECT: Project resource group - TAG_TYPE_AZURE: Project resource group - TAG_TYPE_DEPLOYMENT: Project with deployment title: Resource group types ClusterNodeStatus: type: object properties: age: type: integer format: int64 internalIP: type: string conditions: type: string nodeType: $ref: '#/components/schemas/ClusterNodeType' EnrolledCertStatus: type: string enum: - ENROLLED_CERT_STATUS_UNSPECIFIED - ENROLLED_CERT_STATUS_AVAILABLE - ENROLLED_CERT_STATUS_PENDING - ENROLLED_CERT_STATUS_RENEWAL_PENDING - ENROLLED_CERT_STATUS_EXPIRED - ENROLLED_CERT_STATUS_REVOKED - ENROLLED_CERT_STATUS_ENROLLMENT_FAILED - ENROLLED_CERT_STATUS_RENEWAL_FAILED - ENROLLED_CERT_STATUS_INVALID_CONFIG default: ENROLLED_CERT_STATUS_UNSPECIFIED description: |- Certificate lifecycle and availability status as reported by the device. - ENROLLED_CERT_STATUS_AVAILABLE: Certificate is present, valid, and usable for authentication. - ENROLLED_CERT_STATUS_PENDING: Certificate enrollment is in progress and not yet complete. - ENROLLED_CERT_STATUS_RENEWAL_PENDING: Certificate is present and still valid, but a renewal request is in progress and not yet completed. - ENROLLED_CERT_STATUS_EXPIRED: Certificate has expired (the current time is past notAfter). Renewal may have failed; see err for related errors. - ENROLLED_CERT_STATUS_REVOKED: Certificate has been revoked or is otherwise considered invalid. - ENROLLED_CERT_STATUS_ENROLLMENT_FAILED: Certificate enrollment failed and no valid certificate is available. - ENROLLED_CERT_STATUS_RENEWAL_FAILED: A certificate is currently present but the most recent renewal attempt failed. - ENROLLED_CERT_STATUS_INVALID_CONFIG: Certificate configuration is invalid or malformed, preventing enrollment or renewal. SharedStorageSummary: type: object properties: Id: type: string description: Id Name: type: string description: Name AllocatedMB: type: number format: double description: Allocated Storage in MBs UsedMB: type: number format: double description: How much is used within the allocated total storage description: Shared Storage Summary title: Shared Storage Summary SWState: type: string enum: - SW_STATE_UNSPECIFIED - SW_STATE_INITIAL - SW_STATE_DOWNLOAD_IN_PROGRESS - SW_STATE_DOWNLOADED - SW_STATE_VERIFIED - SW_STATE_INSTALLED - SW_STATE_BOOTING - SW_STATE_RUNNING - SW_STATE_HALTING - SW_STATE_HALTED - SW_STATE_REFRESHING - SW_STATE_PURGING - SW_STATE_RESOLVING_TAG - SW_STATE_RESOLVED_TAG - SW_STATE_CREATING_VOLUME - SW_STATE_CREATED_VOLUME - SW_STATE_VERIFYING - SW_STATE_LOADING - SW_STATE_LOADED - SW_STATE_AWAITNETWORKINSTANCE default: SW_STATE_UNSPECIFIED description: |- - SW_STATE_RESOLVING_TAG: Prior to DOWNLOAD_STARTED we go through these: Resolving an image tag - SW_STATE_RESOLVED_TAG: Tag has been resolved/failed - SW_STATE_CREATING_VOLUME: Prior to INSTALLED we go through these: Volume create in progress - SW_STATE_CREATED_VOLUME: Volume create done/failed - SW_STATE_VERIFYING: Verification in-progress - SW_STATE_LOADING: Loading blob in CAS - SW_STATE_LOADED: Loaded blob in CAS - SW_STATE_AWAITNETWORKINSTANCE: Wait for network instance title: State of EVE/Edge Application software AppType: type: string enum: - APP_TYPE_UNSPECIFIED - APP_TYPE_VM - APP_TYPE_VM_RUNTIME - APP_TYPE_CONTAINER - APP_TYPE_MODULE - APP_TYPE_DOCKER_COMPOSE default: APP_TYPE_UNSPECIFIED description: type of app bundle. DeploymentType: type: string enum: - DEPLOYMENT_TYPE_UNSPECIFIED - DEPLOYMENT_TYPE_STAND_ALONE - DEPLOYMENT_TYPE_AZURE - DEPLOYMENT_TYPE_K3S - DEPLOYMENT_TYPE_AWS - DEPLOYMENT_TYPE_K3S_AZURE - DEPLOYMENT_TYPE_K3S_AWS - DEPLOYMENT_TYPE_VMWARE_VCE - DEPLOYMENT_TYPE_VMWARE_TKG_ATTACH - DEPLOYMENT_TYPE_DOCKER_RUNTIME default: DEPLOYMENT_TYPE_UNSPECIFIED AppInstMemorySummary: type: object properties: AllocatedMB: type: number format: double description: Total memory allocated for the App instance. title: |- AllocatedMB - Total memory allocated to the App Instance. Normally, AllocatedMB >= UsedMB + AvailableMB UsedMB: type: number format: double description: Total memory used by the App within allocated memory AvailableMB: type: number format: double description: Available / Free memory in the App description: Memory Information for the App Instance. title: App Instance Memory Summary SWInfo: type: object properties: version: type: string description: software version hash: type: string description: software hash state: description: Software state allOf: - $ref: '#/components/schemas/SWState' disk: type: string description: software disk downloadProgress: type: number format: int64 description: download progress imageName: type: string description: image name description: Software Information title: Software Information TMCClusterStatusHealth: type: string enum: - TMC_CLUSTER_HEALTH_UNKNOWN - TMC_CLUSTER_HEALTH_HEALTHY - TMC_CLUSTER_HEALTH_WARNING - TMC_CLUSTER_HEALTH_UNHEALTHY - TMC_CLUSTER_HEALTH_DISCONNECTED - TMC_CLUSTER_HEALTH_OVER_LIMIT default: TMC_CLUSTER_HEALTH_UNKNOWN TMCClusterStatusStatus: type: string enum: - TMC_CLUSTER_STATUS_UNKNOWN - TMC_CLUSTER_STATUS_PENDING - TMC_CLUSTER_STATUS_PROCESSING - TMC_CLUSTER_STATUS_CREATING - TMC_CLUSTER_STATUS_READY - TMC_CLUSTER_STATUS_DELETING - TMC_CLUSTER_STATUS_ERROR - TMC_CLUSTER_STATUS_DETACHING - TMC_CLUSTER_STATUS_UPGRADING - TMC_CLUSTER_STATUS_UPGRADE_FAILED - TMC_CLUSTER_STATUS_UPDATING - TMC_CLUSTER_STATUS_OVER_LIMIT - TMC_CLUSTER_STATUS_READY_TO_ATTACH - TMC_CLUSTER_STATUS_ATTACH_COMPLETE default: TMC_CLUSTER_STATUS_UNKNOWN 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 DNSInfo: type: object properties: servers: type: array items: type: string description: Array of dns server domain: type: string description: domain name search: type: array items: type: string description: Array of search strings description: 'DNSInfo is used to store Domain Name Server configuration. ' title: DNSInfo consists of DNS Configurations. required: - servers - domain - search GeoLocation: type: object properties: underlayIP: type: string description: Single IP address, either in IPv4 or in IPv6 format hostname: type: string description: Host name city: type: string description: City region: type: string description: Region country: type: string description: >- Country code consisting of 2 capital letters as per ISO 3166-1 alpha2 standard loc: type: string description: >- Ordered pair of (latitude, longitude) separated by comma (,). Latitude is the horizontal component used for geographic positioning; it is the angle between 0° (the equator) and ±90° (north or south) at the poles measured in decimal degrees. It is the first value in an ordered pair. A negative number denotes a location south of the equator; a positive number is north. Longitude is the vertical component used for geographic positioning; it is the angle between 0° (the Prime Meridian) and ±180° (westward or eastward) measured in decimal degrees. It is the second number in an ordered pair. A negative number indicates a location west of Greenwich, England; a positive number east. org: type: string description: >- The name of the recipient, firm, or company at this geographical location. postal: type: string description: Postal code (ZIP code for USA) of the geographical location latlong: type: string description: 'Deprecated field: comma, separated lat, long' freeloc: type: string description: Free formatted location string description: >- Geographic location of an edge node determined by a variety of data collection mechanisms (e.g. network routing addresses or internal GPS devices). title: Geographic location of an edge node NetProxyStatus: type: object properties: networkProxy: type: boolean description: Use pacfile (Auto discover or manual upload) title: Enable, the proxy configuration coming from network proxies: type: array items: $ref: '#/components/schemas/NetProxyServer' description: protocol level proxies title: protocol level proxies exceptions: type: string description: 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 wpadProxyURL: type: string description: WPAD Proxy URL description: NetProxyStatus is used to store the proxy configurations title: NetProxyStatus is used to store the proxy configurations GPSLocation: type: object properties: latitude: type: number format: double description: Latitude longitude: type: number format: double description: Longitude altitude: type: number format: double description: Altitude from mean sea level timestamp: type: object format: date-time description: UTC timestamp horizontalReliability: type: number format: int64 description: Horizontal reliability verticalReliability: type: number format: int64 description: Vertical reliability horizontalUncertainty: type: number format: double description: Horizontal uncertainty verticalUncertainty: type: number format: double description: Vertical uncertainty logicalLabel: type: string description: Logical label of the adapter used to get GPS coordinates CellularStatus: type: object properties: providers: type: array items: $ref: '#/components/schemas/NetworkProvider' description: List of network providers modem: type: object description: Modem detail allOf: - $ref: '#/components/schemas/ModemDetail' simCards: type: array items: $ref: '#/components/schemas/SIMCard' description: List of SIM Cards description: CellularStatus contains status information for a single cellular network title: CellularStatus contains status information for a single cellular network PNACPortStatus: type: object properties: enabled: type: boolean description: Whether 802.1X authentication is enabled on this port supplicantState: description: 802.1X supplicant state allOf: - $ref: '#/components/schemas/PNACSupplicantState' lastAuthTimestamp: type: string format: date-time description: Timestamp of the most recent successful 802.1X authentication. err: type: object description: Supplicant authentication error details allOf: - $ref: '#/components/schemas/DeviceError' description: >- PNACPortStatus reports the 802.1X authentication status of a network port. commonPortConfigSource: type: object properties: origin: description: Indicates where EVE obtained the network config. allOf: - $ref: '#/components/schemas/commonNetworkConfigOrigin' submittedAt: type: string format: date-time description: >- Timestamp when this port’s configuration was originally submitted or created at its source. Meaning depends on the origin: - Controller, LOC, bootstrap: timestamp provided by the controller. - Local override.json: when the file was first loaded by EVE. - Last-resort: when EVE generated the fallback config. - LPS modifications: when the modified config was received. - TUI: when the user submitted the configuration. This is different from DevicePortStatus.timePriority, which is used to compare and prioritize different sources of network configuration (and may be synthetic for some sources, e.g. year 2000 for override.json, epoch 0 for last-resort). By contrast, submitted_at represents when this port’s configuration first came into existence, regardless of when or whether the device applied it. Note: this is a per-port timestamp. The underlying network config may cover multiple ports, but only the portion relevant to this port is reflected here. description: >- PortConfigSource describes the origin of the configuration used for a network port. It helps distinguish between controller-provided, locally-modified, or initial configs. DeviceSWStatus: type: string enum: - DEVICE_SW_STATUS_UNSPECIFIED - DEVICE_SW_STATUS_DOWNLOADING - DEVICE_SW_STATUS_DOWNLOADDONE - DEVICE_SW_STATUS_UPDATING - DEVICE_SW_STATUS_UPDATED - DEVICE_SW_STATUS_FALLBACK - DEVICE_SW_STATUS_FAILED default: DEVICE_SW_STATUS_UNSPECIFIED DeviceSWSubStatus: type: string enum: - DEVICE_SW_SUB_STATUS_UNSPECIFIED - DEVICE_SW_SUB_STATUS_DOWNLOAD_IN_PROGRESS - DEVICE_SW_SUB_STATUS_VERIFY_IN_PROGRESS - DEVICE_SW_SUB_STATUS_UPDATE_INITIALIZING - DEVICE_SW_SUB_STATUS_UPDATE_REBOOTING - DEVICE_SW_SUB_STATUS_UPDATE_TESTING - DEVICE_SW_SUB_STATUS_UPDATE_NEED_TEST_CONFIRM - DEVICE_SW_SUB_STATUS_UPDATE_DEFERRED default: DEVICE_SW_SUB_STATUS_UNSPECIFIED DeviceHWSecurityModuleStatus: type: string enum: - DEVICE_HW_SECURITY_MODULE_STATUS_UNSPECIFIED - DEVICE_HW_SECURITY_MODULE_STATUS_NOT_FOUND - DEVICE_HW_SECURITY_MODULE_STATUS_DISABLED - DEVICE_HW_SECURITY_MODULE_STATUS_ENABLED default: DEVICE_HW_SECURITY_MODULE_STATUS_UNSPECIFIED Severity: type: string enum: - SEVERITY_UNSPECIFIED - SEVERITY_NOTICE - SEVERITY_WARNING - SEVERITY_ERROR default: SEVERITY_UNSPECIFIED title: Severity tells the severity type DeviceEntity: type: object properties: entity: $ref: '#/components/schemas/Entity' entityId: type: string entityName: type: string ClusterNodeType: type: string enum: - CLUSTER_NODE_TYPE_UNSPECIFIED - CLUSTER_NODE_TYPE_MASTER - CLUSTER_NODE_TYPE_WORKER - CLUSTER_NODE_TYPE_TIE_BREAKER default: CLUSTER_NODE_TYPE_UNSPECIFIED 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 NetworkProvider: type: object properties: plmn: type: string description: PLMN code name: type: string description: Human-friendly name rat: type: string description: Radio Access Technology allOf: - $ref: '#/components/schemas/RadioAccessTechnology' roaming: type: boolean description: Is Roaming ON connectedAt: type: string format: date-time description: Time when was the connection established description: NetworkProvider describes a cellular Network Provider title: NetworkProvider describes a cellular Network Provider ModemDetail: type: object properties: manufacturer: type: string description: Modem manufacturer model: type: string description: Modem model firmwareVersion: type: string description: Modem firmware version imei: type: string description: Modem IMEI operatingState: type: string description: Modem operating state allOf: - $ref: '#/components/schemas/ZCellularOperatingState' controlProtocol: type: string description: Modem control protocol allOf: - $ref: '#/components/schemas/ZCellularControlProtocol' description: ModemDetail describes a cellular Modem title: ModemDetail describes a cellular Modem SIMCard: type: object properties: slotNumber: type: number format: int64 description: Slot number slotActivated: type: boolean description: Is Slot activated iccid: type: string description: Integrated Circuit Card Identifier imsi: type: string description: International Mobile Subscriber Identity state: type: string description: Current state of the SIM card description: SIMCard describes a SIM slot title: SIMCard describes a SIM slot PNACSupplicantState: type: string enum: - PNAC_SUPPLICANT_STATE_UNSPECIFIED - PNAC_SUPPLICANT_STATE_DISCONNECTED - PNAC_SUPPLICANT_STATE_CONNECTING - PNAC_SUPPLICANT_STATE_AUTHENTICATING - PNAC_SUPPLICANT_STATE_AUTHENTICATED - PNAC_SUPPLICANT_STATE_FAILED - PNAC_SUPPLICANT_STATE_HELD default: PNAC_SUPPLICANT_STATE_UNSPECIFIED description: |- PNACSupplicantState describes the 802.1X supplicant state for PNAC. - PNAC_SUPPLICANT_STATE_DISCONNECTED: Supplicant is idle or link is down; no authentication in progress. - PNAC_SUPPLICANT_STATE_CONNECTING: Link is up and the supplicant is initiating authentication. - PNAC_SUPPLICANT_STATE_AUTHENTICATING: Active EAP authentication exchange is in progress. - PNAC_SUPPLICANT_STATE_AUTHENTICATED: Authentication completed successfully; port is authorized. - PNAC_SUPPLICANT_STATE_FAILED: Authentication failed and access was not granted. - PNAC_SUPPLICANT_STATE_HELD: Supplicant is in a held or backoff state following repeated failures. commonNetworkConfigOrigin: type: string enum: - NETWORK_CONFIG_ORIGIN_UNSPECIFIED - NETWORK_CONFIG_ORIGIN_CONTROLLER - NETWORK_CONFIG_ORIGIN_BOOTSTRAP - NETWORK_CONFIG_ORIGIN_OVERRIDE - NETWORK_CONFIG_ORIGIN_LASTRESORT - NETWORK_CONFIG_ORIGIN_TUI - NETWORK_CONFIG_ORIGIN_LOC - NETWORK_CONFIG_ORIGIN_LPS default: NETWORK_CONFIG_ORIGIN_UNSPECIFIED description: >- NetworkConfigOrigin enumerates all possible origins of a network port configuration. - NETWORK_CONFIG_ORIGIN_UNSPECIFIED: Unknown or unset origin. - NETWORK_CONFIG_ORIGIN_CONTROLLER: Config received from the controller. - NETWORK_CONFIG_ORIGIN_BOOTSTRAP: Initial device config embedded in the EVE installer, signed by the controller. - NETWORK_CONFIG_ORIGIN_OVERRIDE: Manually created JSON config injected into the installer. - NETWORK_CONFIG_ORIGIN_LASTRESORT: Fallback configuration automatically generated to enable DHCP on all Ethernet ports. Used when no network config is available or when "network.fallback.any.eth" is enabled and none of the existing configs provide controller connectivity. - NETWORK_CONFIG_ORIGIN_TUI: Config entered via the terminal UI (TUI). - NETWORK_CONFIG_ORIGIN_LOC: Configuration signed by the controller and delivered through the Local Operator Console (LOC) in an air-gapped environment. - NETWORK_CONFIG_ORIGIN_LPS: Config changes made locally through the Local Profile Server (LPS). Entity: type: string enum: - ENTITY_UNSPECIFIED - ENTITY_BASE_OS - ENTITY_SYSTEM_ADAPTER - ENTITY_VAULT - ENTITY_ATTESTATION - ENTITY_APP_INSTANCE - ENTITY_PORT - ENTITY_NETWORK - ENTITY_NETWORK_INSTANCE - ENTITY_CONTENT_TREE - ENTITY_CONTENT_BLOB - ENTITY_VOLUME default: ENTITY_UNSPECIFIED description: |- - ENTITY_UNSPECIFIED: Invalid Device Entity - ENTITY_BASE_OS: Base OS entity - ENTITY_SYSTEM_ADAPTER: System Adapter Entity - ENTITY_VAULT: Vault Entity - ENTITY_ATTESTATION: Attestation Entity - ENTITY_APP_INSTANCE: App Instance Entity - ENTITY_PORT: Port Entity - ENTITY_NETWORK: Network Entity - ENTITY_NETWORK_INSTANCE: Network Instance Entity - ENTITY_CONTENT_TREE: ContentTree Entity - ENTITY_CONTENT_BLOB: Blob Entity - ENTITY_VOLUME: VOLUME Entity title: Edge node components 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 RadioAccessTechnology: 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. ZCellularOperatingState: type: string enum: - Z_CELLULAR_OPERATING_STATE_UNSPECIFIED - Z_CELLULAR_OPERATING_STATE_OFFLINE - Z_CELLULAR_OPERATING_STATE_RADIO_OFF - Z_CELLULAR_OPERATING_STATE_ONLINE - Z_CELLULAR_OPERATING_STATE_ONLINE_AND_CONNECTED - Z_CELLULAR_OPERATING_STATE_UNRECOGNIZED default: Z_CELLULAR_OPERATING_STATE_UNSPECIFIED ZCellularControlProtocol: type: string enum: - Z_CELLULAR_CONTROL_PROTOCOL_UNSPECIFIED - Z_CELLULAR_CONTROL_PROTOCOL_QMI - Z_CELLULAR_CONTROL_PROTOCOL_MBIM default: Z_CELLULAR_CONTROL_PROTOCOL_UNSPECIFIED securitySchemes: BearerToken: type: http description: Bearer token for user session scheme: bearer ````