EaaSI API

Emulation-as-a-Service stellt eine Reihe von RESTful API Endpoints Benutzer können mit einem API-Client (einschließlich curl``` oder andere HTTP-Anforderungstooling) verwenden, um Informationen zu erhalten und mit den Ressourcen, die in einem EaSI-Knoten vorhanden sind, zu interagieren.

Die EaaS/EaaSI API kann nützlich sein, um:

Authentication und Access Tokens

Die öffentliche API von EaaS kann Informationen über Umgebungen und Software in einem bestimmten EaaSI-Knoten zurückgeben. Benutzer mit einem Konto in diesem Knoten können die API auf Basis ihres einzigartigen Benutzerkontexts abfragen (z.B. Metadaten über Private Environments oder importierte Software-Ressourcen) indem Sie einen Zugriffstoken von Eaas Keycloak Authentifizierungsmodul erhalten.

Bemerkung

Wenn kein Zugriff auf Token/User-Kontext vorgesehen ist, können GET-Anfragen an die öffentliche API noch Metadaten auf veröffentlichte/öffentliche Ressourcen eines Knotens (Public Environments) zurückgeben.

Benutzer mit einem EaaSI-Konto können einen Zugriffstoken von ihrem Knoten erwerben, indem sie eine POST-Anfrage an ``https://[eaasi.domain]/auth/realms/master/protocol/openid-connect/token` senden, beispielsweise:

$ curl --request POST \
--url https://[eaasi.domain]/auth/realms/master/protocol/openid-connect/token \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data client_id=eaas \
--data grant_type=password \
--data username=[user] \
--data password=[password]

Sicher, alle Informationen in ````` mit den entsprechenden Werten / Informationen zu ersetzen. Token sind für eine Stunde standardmäßig gültig, danach müssen sie regeneriert oder erfrischt werden.

Eine gültige Anfrage sollte einen OAuth 2.0-Zugang zuken-Antwort erhalten. Der empfangene access_token‘-Eigenschaftswert kann dann im Header von nachfolgenden Anfragen an die EaaS-API bereitgestellt werden, beispielsweise:

curl --request GET \
--url 'https://[eaasi.domain]/emil/environment-repository/environments' \
--header 'Authorization: Bearer [access_token]' \
--header 'accept: application/json'

Öffentliche API

Alle öffentlichen EaaS API Endpunkte befinden sich unter der Basis-URL: https://[eaasi.domain]/emil``

Umwelt

GET /environment-repository/environments

Retrieves eine Liste aller verfügbaren Umgebungen im Knoten

Kopf anfordern:
  • Accept – Soll der Antwortinhaltstyp als „Appplication/json“ definieren

  • Authorization – optional OAuth-Token zu authentifizieren (notwendig, um private Umgebungen abzurufen)

Abfrageparameter:
  • detailed (boolean) – Wenn auf „true“ gesetzt wird, können Sie mit alle Metadaten, die mit jeder Umgebung verbunden sind, anstelle einer Übersicht anzeigen (siehe „Umwelt-Repository/Umwelten/[envId] ` Endpunktdokumentation unten für vollständige Details enthalten; „false“ standardmäßig)

  • localOnly (boolean) – Wenn auf „false“ gesetzt, gibt Metadaten, die mit öffentlichen Umgebungen verbunden sind, sichtbar zurück not Lokal an den Knoten („wahr“ standardmäßig gespeichert)

Status-Codes:
  • 200 OK – Eine Reihe von Umgebungen

Antwort JSON Gegenstand:
  • envId (string) – Einzigartige ID (UUID) für eine Umweltressource

  • title (string) – Human lesbarer Name für eine Umweltressource

  • archive (string) – Indiziert das Speicherarchiv der Umgebung, eine von drei Optionen abhängig von seinem Netzwerkstatus (wirft „remote“ für Public, „public“ für Saved Locally, „default“ für Private)

  • owner (string) – Zeigt Benutzerkonto, das die Umwelt Ressource besitzt (entweder gibt „shared“ für Public oder Saved Local, oder eine UUID für bereitgestellte Benutzerkonto Private Environments)

  • objectId (string) – Wenn Umgebung ein Content Environment ist, gibt die UUID des zugehörigen Content Objekts zurück

  • objectArchive (string) – Wenn Umgebung ein Content Environment ist, gibt die UUID des Benutzerarchivs, das mit diesem verbunden ist Content (sollte gleich sein wie `owner`````UID)

  • envType (string) – Gibt „Objekt“ zurück, wenn Umwelt ein Content Environment ist, gibt „Basis“ für alle anderen

  • timestamp (string) – ISO 8601 Vollzeit-Zeitstempel für die Schaffung der Umwelt

  • description (string) – Die jüngste Beschreibung der Umwelt aus ihrer Geschichte (bei laufenden Emulation Access Sessions)

  • linuxRuntime (boolean) – Gibt an, ob die Umgebung eine für den Import und den Betrieb von Containern geeignete Linux-Laufzeit ist (eine EaaS-Funktion, die noch nicht in EaaSI-Knoten implementiert ist)

  • networkEnabled (boolean) – Gibt an, ob die Umwelt in der Lage ist, mit dem Live-Internet oder anderen Umgebungen zu vernetzen ( Letzteres ist eine EaaS-Funktion, die noch nicht in EaaSI-Knoten implementiert ist)

  • internetEnabled (boolean) – Gibt an, ob die Umgebung mit dem Live-Internet verbunden werden darf (kann nur „wahr“ sein, wenn networkEnabled` auch „wahr“ ist)

  • serviceContainer (boolean) – Gibt an, ob die Umgebung einen Container-Service darstellt (ein EaaS-Feature noch nicht in EaaSI-Knoten implementiert)

Beantwortung:

HTTP/1.1 200 OK
Content-Type: application/json

[
  {
  "envId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "title": "Windows 98 + Borland Quattro Pro 5.0",
  "archive": "default",
  "owner": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "envType": "base",
  "timestamp": "2022-04-27T17:45:45.922581Z",
  "description": "installed to C: drive",
  "linuxRuntime": false,
  "networkEnabled": true,
  "internetEnabled": true,
  "serviceContainer": false
  },
  {
  "envId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "title": "The Would-Be Gentleman",
  "archive": "default",
  "owner": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "objectId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "objectArchive": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "envType": "object",
  "timestamp": "2022-03-17T15:18:56.917042Z",
  "description": "unstuffed floppy image and copied contents to MacintoshHD",
  "linuxRuntime": false,
  "networkEnabled": false,
  "internetEnabled": false,
  "serviceContainer": false
  }
]
GET /environment-repository/environments/[envId]

Retrieves eine detaillierte Aufzeichnung einer einzigen Umgebung, wie durch eine bereitgestellte UUID definiert

Kopf anfordern:
  • Accept – Soll der Antwortinhaltstyp als „Appplication/json“ definieren

  • Authorization – optional OAuth-Token zu authentifizieren (notwendig, um private Umgebungen abzurufen)

Status-Codes:
  • 200 OK – Ein einziges Umwelt-JSON-Objekt

  • 400 Bad Request – Keine Umgebung mit der angegebenen UUID gefunden

Antwort JSON Gegenstand:
  • networking (object) – ein geschachteltes JSON-Objekt, das die emulierten Netzwerkfähigkeiten der Umwelt beschreibt

  • enableInternet (nested,boolean) – Gibt an, ob die Umgebung mit dem Live-Internet verbunden werden darf (kann nur „wahr“ sein, wenn networkEnabled` auch „wahr“ ist)

  • serverMode (nested,boolean) – EaaS Feature noch nicht in EaaSI-Knoten implementiert

  • localServerMode (nested,boolean) – EaaS Feature noch nicht in EaaSI-Knoten implementiert

  • enableSocks (nested,boolean) – EaaS Feature noch nicht in EaaSI-Knoten implementiert

  • connectEnvs (nested,boolean) – EaaS Feature noch nicht in EaaSI-Knoten implementiert

  • parentEnvId (string) – Wenn die Umwelt ein derivative ist, verweist dies auf die eindeutige ID (UUID) der Basisumgebung, die dieses Derivat direkt vor der

  • envId (string) – Einzigartige ID (UUID) für die Umweltressource

  • title (string) – Menschlicher Name für die Umweltressource

  • description (string) – Die jüngste Beschreibung der Umwelt aus ihrer Geschichte (bei laufenden Emulation Access Sessions)

  • emulator (string) – JavaBeans bean name for the emulator used by this Environment Resources

  • enableRelativeMouse (boolean) – Wenn „true“ die Einstellung „Relative Maus (Pointerlock)“ aktiviert (siehe:ref:environment_details)

  • enablePrinting (boolean) – Wenn „true“ die Einstellung „Umwelt kann Drucken“ aktiviert (siehe: Umwelt Details)

  • shutdownByOs (boolean) – Wenn „true“ die Einstellung „Requires Clean Shutdown“ aktiviert (siehe: Umwelt Details)

  • timeContext (string) –

  • canProcessAdditionalFiles (boolean) – EaaS Feature noch nicht in EaaSI-Knoten implementiert

  • archive (string) – Indiziert das Speicherarchiv der Umgebung, eine von drei Optionen abhängig von seinem Netzwerkstatus (wirft „remote“ für Public, „public“ für Saved Locally, „default“ für Private)

  • xpraEncoding (string) – Wenn useXpra` auf „wahr“ gesetzt ist, bestimmt dieser String die Art der Bildcodierung, die vom Xpra-Displayserver und Client („jpeg“ standardmäßig verwendet wird)

  • owner (string) – Zeigt Benutzerkonto, das die Umwelt Ressource besitzt (entweder gibt „shared“ für Public oder Saved Local, oder eine UUID für bereitgestellte Benutzerkonto Private Environments)

  • envType (string) – Gibt „Objekt“ zurück, wenn Umwelt ein Content Environment ist, gibt „Basis“ für alle anderen

  • revisions (array) – Wenn die ausgewählte Umgebung ein derivative ist, ein Sub-array der vorherigen Revisionen in der Geschichte der Umwelt (aus den letzten bis ältesten Revisionen)

  • id (string) – envId`` für die vorherige Umgebung in der Derivatkette

  • text (nested,string) – Die description```` für die vorherige Umgebung in der Derivatkette

  • archive – Das archive`` für die vorherige Umgebung in der Derivatkette

  • installedSoftwareIds (array) – Ein Sub-Array aller Software-Ressourcen, die mit dieser Umgebung verbunden sind. Könnte ein Betriebssystem-Installer enthalten, wenn die Umgebung ein base oder andere damit verbundene Software-Ressourcen ist, wenn die Umwelt ein :term:`derivative ist `

  • id – Die id`` jeder zugehörigen Software-Ressource

  • label (string) – Der human lesbare Name jeder zugehörigen Software-Ressource

  • archive – Das archiveId``` für das Speicherarchiv, in dem die zugehörige Software-Ressource gespeichert wird

  • nativeConfig (string) – Arbitrary string/flags hinzugefügt, um den Standard des konfigurierten Emulators, wenn Umgebung ausgeführt wird (siehe: Emulator Configuration)

  • useXpra (boolean) – Wenn „true“ die Einstellung „XPRA Video“ aktiviert (siehe: Umwelt Details)

  • useWebRTC (boolean) – Wenn „true“ die Einstellung „WebRTC Audio“ aktiviert (siehe: Umwelt Details)

  • containerName (string) – Name für die Docker Container passend zur angegebenen Emulatorbohne

  • drives (array) – Ein Subarray von JSON-Objekten, die jeweils die für diese Umgebung verfügbaren emulierten Laufwerke neu definieren

  • data (nested,string) – Wenn ein object oder Umgebungsbild an dieses Laufwerk gebunden ist, wird seine eindeutige ID (UUID) in diesem Bereich angezeigt (d.h. Systemlaufwerke oder ein Content Environment)

  • iface (nested,string) – Computerspeicher-Standard/Interface verwendet vom emulierten Laufwerk (Optionen sind „ide“ oder „Floppy“)

  • bus (nested,string) – Datenbusadressennummer, die vom emulierten Laufwerk verwendet wird

  • unit (nested,string) – Computerspeicher Buseinheit Adressennummer, die vom emulierten Laufwerk verwendet wird

  • type (nested,string) – Entsprechender physikalischer Medientyp für den emulierten Antrieb (unterlässt, welche Art von Ressourcenobjekten in diesen Antrieb geladen werden können; akzeptierte Werte sind „floppy“, „cdrom“, oder „disk“)

  • filesystem (nested,string) – Zeigt die vom emulierten Laufwerk akzeptierten Dateisystemtypen an (z.B. „ISO“ für „cdrom“-Laufwerke oder „fat12“ für „Floppy“)

  • boot (nested,boolean) – Kommuniziert den Emulator (falls möglich), dass dieser Antrieb als System/Boot-Laufwerk angezeigt werden soll (nur ein Antrieb in der Umgebungskonfiguration sollte „wahr“ markiert werden, sonst wird das Verhalten unvorhersehbar sein)

  • plugged (nested,boolean) –

  • timestamp (string) – ISO 8601 Vollzeit-Zeitstempel für die Schaffung der Umwelt

  • linuxRuntime (boolean) – Gibt an, ob die Umgebung eine für den Import und den Betrieb von Containern geeignete Linux-Laufzeit ist (EaaS-Feature noch nicht in EaaSI-Knoten implementiert)

  • isServiceContainer (boolean) – Gibt an, ob die Umgebung einen Containerdienst darstellt (EaaS-Feature noch nicht in EaaSI-Knoten implementiert)

Antwort:

HTTP/1.1 200 OK
Content-Type: application/json

{
"networking": {
  "enableInternet": false,
  "serverMode": false,
  "localServerMode": false,
  "enableSocks": false,
  "connectEnvs": false
  },
"parentEnvId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"envId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"title": "Windows 98 + Borland Quattro Pro 5.0",
"description": "installed to C: drive",
"emulator": "Qemu",
"enableRelativeMouse": false,
"enablePrinting": true,
"shutdownByOs": false,
"timeContext": "1628524787526",
"canProcessAdditionalFiles": false,
"archive": "default",
"xpraEncoding": "jpeg",
"owner": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"envType": "base",
"revisions": [
    {
    "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "text": "removed daylight savings time pop-up",
    "archive": "default"
    },
    {
    "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "text": "fixed Plug n Play BIOS warning, rebooted to add Soundblaster card",
    "archive": "public"
    },
    {
    "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.xml",
    "text": "n.a.",
    "archive": "public"
    }
  ],
"installedSoftwareIds": [
    {
    "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "label": "Windows98SE",
    "archive": "zero conf"
    },
    {
    "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "label": "Borland Quattro Pro 5.0",
    "archive": "zero conf"
    }
  ],
"nativeConfig": "-usb -usbdevice tablet -vga cirrus -soundhw sb16 -net nic,model=pcnet",
"useXpra": false,
"useWebRTC": false,
"containerName": "qemu-system",
"drives": [
    {
    "data": "binding://xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "iface": "ide",
    "bus": "0",
    "unit": "0",
    "type": "disk",
    "boot": true,
    "plugged": true
    },
    {
    "iface": "floppy",
    "bus": "0",
    "unit": "0",
    "type": "floppy",
    "filesystem": "fat12",
    "boot": false,
    "plugged": false
    },
    {
    "iface": "ide",
    "bus": "0",
    "unit": "1",
    "type": "cdrom",
    "filesystem": "ISO",
    "boot": false,
    "plugged": false
    }
  ],
"timestamp": "2022-04-27T17:45:45.922581Z",
"linuxRuntime": false,
"isServiceContainer": false
}

Software

GET /software-repository/descriptions

Erprobt eine leichte Liste von Software-Ressourcen

Kopf anfordern:
  • Accept – Soll der Antwortinhaltstyp als „Appplication/json“ definieren

  • Authorization – OAuth-Token zu authentifizieren (notwendig, um Private Software Ressourcen abzurufen)

Status-Codes:
  • 200 OK – Eine Reihe von Software

Antwort JSON Gegenstand:
  • id (string) – Einzigartige ID (UUID) für diese Software-Ressource

  • label (string) – Human lesbarer Name für eine Software-Ressource

  • isPublic (boolean) – Gibt an, ob die Software-Ressource veröffentlicht wurde (die Software-Ressourcen wurden noch nicht ordnungsgemäß in EaaSI implementiert; dieser Wert sollte „false“ sein)

  • archiveId (string) – Name für das Speicherarchiv, in dem das Software-Objekt aufbewahrt wird; sollte für alle privaten Software-Ressourcen „zero conf“ sein

  • isOperatingSystem (boolean) – Zeigt an, ob die Software-Ressource während des Ressourcenimports als Betriebssystem-Installer identifiziert wurde (verfügbar über Demo UI, aber noch nicht in den EaaSI UI-Importprozess integriert; sollte „false“ sein, aber bestimmte ältere Objekte können „wahr“ anzeigen)

Beantwortung:

HTTP/1.1 200 OK
Content-Type: application/json

[
  {
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "label": "Microsoft Money 95",
  "isPublic": false,
  "archiveId": "zero conf",
  "isOperatingSystem": false
  },
  {
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "label": "Advanced_DB_Master_3.0",
  "isPublic": false,
  "archiveId": "zero conf",
  "isOperatingSystem": false
  }
]
GET /software-repository/descriptions/[id]

Retrieves Beschreibung für eine einzelne Software-Ressource, wie durch die bereitgestellte UUID definiert

Kopf anfordern:
  • Accept – Soll der Antwortinhaltstyp als „Appplication/json“ definieren

  • Authorization – OAuth-Token zu authentifizieren (notwendig, um Private Software Ressourcen abzurufen)

Status-Codes:
Antwort JSON Gegenstand:
  • id (string) – Einzigartige ID (UUID) für diese Software-Ressource

  • label (string) – Human lesbarer Name für diese Software-Ressource

  • isPublic (boolean) – Gibt an, ob diese Software-Ressource veröffentlicht wurde (die Software-Ressourcen wurden noch nicht ordnungsgemäß in EaaSI implementiert; dieser Wert sollte „false“)

  • archiveId (string) – Name für das Speicherarchiv, in dem das Software-Objekt aufbewahrt wird; sollte für alle privaten Software-Ressourcen „zero conf“ sein

  • isOperatingSystem (boolean) – Zeigt an, ob die Software-Ressource während des Ressourcenimports als Betriebssystem-Installer identifiziert wurde (verfügbar über Demo UI, aber noch nicht in den EaaSI UI-Importprozess integriert; sollte „false“ sein, aber bestimmte ältere Objekte können „wahr“ anzeigen)

Beantwortung:

HTTP/1.1 200 OK
Content-Type: application/json

  {
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "label": "Microsoft Money 95",
  "isPublic": false,
  "archiveId": "zero conf",
  "isOperatingSystem": false
  }
GET /software-repository/packages

Retrieves eine detailliertere Reihe von Software-Objekten, einschließlich zugehöriger Dateiformate

Kopf anfordern:
  • Accept – Soll der Antwortinhaltstyp als „Appplication/json“ definieren

  • Authorization – OAuth-Token zu authentifizieren (notwendig, um Private Software Ressourcen abzurufen)

Status-Codes:
  • 200 OK – Eine Reihe von Software

Antwort JSON Gegenstand:
  • id (string) – Einzigartige ID (UUID) für diese Software-Ressource

  • objectId (string) – Einzigartige ID (UUID) für dieses Software-Objekt (sollte wie id sein)

  • label (string) – Human lesbarer Name für eine Software-Ressource

  • licenseInformation (string) – Offenes Feld zur Definition von relevanten Software-Lizenzinformationen

  • allowedInstances (integer) – Definiert, wie viele koncurrent Emulationssitzungen mit diesem Software-Objekt ausgeführt werden können (Standard ist „-1“, Anzeige unlimited Sitzungen)

  • nativeFMTs (array) – Eine Reihe von Dateiformaten PUIDs, die mit diesem Software-Objekt manuell zugewiesen wurden, als Formate, die in Umgebungen, die mit dieser Software-Ressource verbunden sind, nativer dargestellt werden können (siehe Universal Virtual Interactor (Experimental))

  • importFMTs (array) – Eine Reihe von Dateiformaten PUIDs, die mit diesem Software-Objekt manuell zugewiesen wurden, als Formate, die speziell importiert in Umgebungen, die mit dieser Software-Ressource verbunden sind (vor allem experimentell, zur Untersuchung der automatisierten Migration)

  • exportFMTs (array) – Eine Reihe von Dateiformaten PUIDs, die mit diesem Software-Objekt manuell zugewiesen wurden, als Formate, die speziell exportiert aus Umgebungen, die mit dieser Software-Ressource verbunden sind (vor allem experimentell, zur Untersuchung der automatisierten Migration)

  • archiveId (string) – Name für das Speicherarchiv, in dem das Software-Objekt aufbewahrt wird; sollte für alle privaten Software-Ressourcen „zero conf“ sein

  • isPublic (boolean) – Gibt an, ob die Software-Ressource veröffentlicht wurde (die Software-Ressourcen wurden noch nicht ordnungsgemäß in EaaSI implementiert; dieser Wert sollte „false“ sein)

  • isOperatingSystem (boolean) – Zeigt an, ob die Software-Ressource während des Ressourcenimports als Betriebssystem-Installer identifiziert wurde (verfügbar über Demo UI, aber noch nicht in den EaaSI UI-Importprozess integriert; sollte „false“ sein, aber bestimmte ältere Objekte können „wahr“ anzeigen)

Beantwortung:

HTTP/1.1 200 OK
Content-Type: application/json

[
  {
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "objectId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "label": "Microsoft Money 95",
  "licenseInformation": "Proprietary commercial",
  "allowedInstances": 1,
  "nativeFMTs": ["fmt/38", "fmt/138", "fmt/57"],
  "importFMTs": ["x-fmt/18", " x-fmt/13"],
  "exportFMTs": ["x-fmt/18", "fmt/15"],
  "archiveId": "zero conf",
  "isPublic": false,
  "isOperatingSystem": false
  },
  {
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "objectId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "label": "Advanced_DB_Master_3.0",
  "licenseInformation": "License key: xxx-xxxxx",
  "allowedInstances": -1,
  "nativeFMTs": ["fmt/38", "fmt/138", "fmt/57"],
  "importFMTs": ["x-fmt/18", " x-fmt/13"],
  "exportFMTs": ["x-fmt/18", "fmt/15"],
  "archiveId": "zero conf",
  "isPublic": false,
  "isOperatingSystem": false
  }
]
GET /software-repository/packages/[id]

Retrieves eine detailliertere Ansicht einer einzigen Software-Ressource, wie durch die bereitgestellte UUID definiert

Kopf anfordern:
  • Accept – Soll der Antwortinhaltstyp als „Appplication/json“ definieren

  • Authorization – OAuth-Token zu authentifizieren (notwendig, um Private Software Ressourcen abzurufen)

Status-Codes:
Antwort JSON Gegenstand:
  • id (string) – Einzigartige ID (UUID) für diese Software-Ressource

  • objectId (string) – Einzigartige ID (UUID) für dieses Software-Objekt (sollte wie id sein)

  • label (string) – Human lesbarer Name für diese Software-Ressource

  • licenseInformation (string) – Offenes Feld zur Definition von relevanten Software-Lizenzinformationen

  • allowedInstances (integer) – Definiert, wie viele koncurrent Emulationssitzungen mit diesem Software-Objekt ausgeführt werden können (Standard ist „-1“, Anzeige unlimited Sitzungen)

  • nativeFMTs (array) – Eine Reihe von Dateiformaten PUIDs, die mit diesem Software-Objekt manuell zugewiesen wurden, als Formate, die in Umgebungen, die mit dieser Software-Ressource verbunden sind, nativer dargestellt werden können (siehe Universal Virtual Interactor (Experimental))

  • importFMTs (array) – Eine Reihe von Dateiformaten PUIDs, die mit diesem Software-Objekt manuell zugewiesen wurden, als Formate, die speziell importiert in Umgebungen, die mit dieser Software-Ressource verbunden sind (vor allem experimentell, zur Untersuchung der automatisierten Migration)

  • exportFMTs (array) – Eine Reihe von Dateiformaten PUIDs, die mit diesem Software-Objekt manuell zugewiesen wurden, als Formate, die speziell exportiert aus Umgebungen, die mit dieser Software-Ressource verbunden sind (vor allem experimentell, zur Untersuchung der automatisierten Migration)

  • archiveId (string) – Name für das Speicherarchiv, in dem das Software-Objekt aufbewahrt wird; sollte für alle privaten Software-Ressourcen „zero conf“ sein

  • isPublic (boolean) – Gibt an, ob die Software-Ressource veröffentlicht wurde (die Software-Ressourcen wurden noch nicht ordnungsgemäß in EaaSI implementiert; dieser Wert sollte „false“ sein)

  • isOperatingSystem (boolean) – Zeigt an, ob die Software-Ressource während des Ressourcenimports als Betriebssystem-Installer identifiziert wurde (verfügbar über Demo UI, aber noch nicht in den EaaSI UI-Importprozess integriert; sollte „false“ sein, aber bestimmte ältere Objekte können „wahr“ anzeigen)

Beantwortung:

HTTP/1.1 200 OK
Content-Type: application/json

  {
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "objectId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "label": "Microsoft Money 95",
  "licenseInformation": "Proprietary commercial",
  "allowedInstances": 1,
  "nativeFMTs": ["fmt/38", "fmt/138", "fmt/57"],
  "importFMTs": ["x-fmt/18", " x-fmt/13"],
  "exportFMTs": ["x-fmt/18", "fmt/15"],
  "archiveId": "zero conf",
  "isPublic": false,
  "isOperatingSystem": false
  }