Überprüfen Sie die Eindeutigkeit des App-Namens

API-Referenz zur Überprüfung, ob ein bereitgestellter App-Routingname innerhalb der Organisation eindeutig ist.

Prüft, ob ein angegebener Routingname für bereitgestellte Apps innerhalb der Organisation eindeutig ist. Wenn der Name bereits verwendet wird, gibt die Antwort auch die bereitgestellte App zurück, die ihn enthält.

API-Endpunkt

GET <BaseURL>/models/deployed/apps/uniquename/check/{routingName}

Für den Stammendpunktpfad siehe Basis-URL .

Anforderungsheader

Kopfzeile	Wert
Autorisierung	Inhaber <your-access-token>
X-UiPath-Internal-TenantId	<tenant_id>

Hinweis:

Ersetzen Sie alle Werte zwischen den spitzen Klammern <...> durch die entsprechenden Anwendungsfallwerte.

Das <access_token> ist dasjenige, das Sie erhalten haben, als Sie die externe Anwendung mit dem Scope Apps oder Apps.Read autorisiert haben. Es ist 1 Stunde lang verfügbar, dann müssen Sie ein neues generieren oder ein Aktualisierungstoken anfordern.

Pfadvariablen

Pfadvariable	Datentyp	Beschreibung
RoutingName (erforderlich)	string	Der Routingname, der auf Eindeutigkeit geprüft werden soll.

Antworten

200 OK

Wenn der Routingname verfügbar ist, ist occupiedBy null:

{
  "isUnique": true,
  "occupiedBy": null
}

Wenn der Routingname bereits verwendet wird, gibt occupiedBy die bereitgestellte App zurück, die ihn enthält:

{
  "isUnique": false,
  "occupiedBy": {
    "id": "string",
    "systemName": "string",
    "title": "string",
    "deploymentTitle": "string",
    "deploymentDescription": "string",
    "deployVersion": 1,
    "semVersion": "string",
    "dateDeployed": "string",
    "deploymentFolder": {
      "key": "string",
      "id": 1,
      "displayName": "string",
      "fullyQualifiedName": "string"
    },
    "isAppPublic": false,
    "isLatestVersion": true,
    "isResourceActivated": true,
    "routingName": "string"
  }
}

Feld	Datentyp	Beschreibung
Ist eindeutig	boolean	true wenn der Routingname verfügbar ist, false wenn er bereits verwendet wird.
BesetztVon	object	Die bereitgestellte App, die den Routingnamen enthält. null wenn isUnique true ist. Kann auch null sein, wenn isUnique false ist, wenn die App, die den Namen enthält, nicht geladen werden konnte.
besetzt von.id	string	Die Bereitstellungs-ID der App.
besetztBy.systemName	string	Der Systemname der App.
BelegtBy.Title	string	Der Titel der veröffentlichten App.
BelegtBy.deploymentTitle	string	Der Name, den die App bei ihrer Bereitstellung erhalten hat.
besetztBy.deploymentDescription	string	Die Beschreibung der bereitgestellten App.
besetztBy.deployVersion	number	Die bereitgestellte Versionsnummer.
besetztBy.semVersion	string	Die semantische Version der bereitgestellten App.
besetzt von.dateBereitgestellt	string	Das Datum und die Uhrzeit der Bereitstellung der App im ISO 8601-Format.
besetzt von.deploymentFolder	object	Der Ordner, in dem die App bereitgestellt wird.
besetztBy.deploymentFolder.key	string	Der Ordnerschlüssel.
besetztBy.deploymentFolder.id	number	Die Ordner-ID.
besetztBy.deploymentFolder.anzeigeName	string	Der Anzeigename des Ordners.
besetztBy.deploymentFolder.vollQualifiedName	string	Der vollständige Pfad des Ordners.
BelegtBy.isAppÖffentlich	boolean	true wenn die App öffentlich zugänglich ist.
BelegtBy.isLatestVersion	boolean	true wenn die bereitgestellte Version die letzte veröffentlichte Version ist.
besetztBy.isResourceActivated	boolean	false Wenn die bereitgestellte App deaktiviert ist. Eine deaktivierte App behält weiterhin ihren Routingnamen. Nicht in jeder App vorhanden. Wenn das Feld fehlt, ist die App aktiv.
BelegtBy.outingName	string	Der in der App-URL verwendete Routingname.

400 Ungültige Anforderung

Die Pfadvariable routingName ist leer oder enthält nur Leerzeichen.

401 Nicht autorisiert

Sie sind nicht authentifiziert. Stellen Sie sicher, dass Sie ein gültiges Zugriffstoken mit dem Scope Apps oder Apps.Read verwenden.

403 Forbidden

Sie sind nicht berechtigt, die Eindeutigkeit des App-Namens in der angegebenen Organisation zu überprüfen.