UIP-Aops-Verbindungen

Syntax und Optionen für „uip aops Connection“ und „uip aops repo“, die SourceControl-Verbindungen synchronisieren und die darüber erkannten Repositorys überprüfen.

uip aops connection verwaltet SourceControl-Verbindungen – der Link pro Mandant zu einem Git-Anbieter (GitHub oder Azure DevOps), den StudioAdmin zum Erkennen von Repositorys, Automatisierungsprojekten und Lösungen verwendet. uip aops repo überprüft die Verzweigungen und Automatisierungsprojektdateien eines einzelnen Repositorys, sobald Sie einen Repository-Bezeichner von connection repos haben. In der uip aops -Übersicht finden Sie gemeinsame Konzepte und die Aufteilung von SC-Service/CICD-Service.

Hinweis:

Die Verbindungserstellung wird über die StudioAdmin-Benutzeroberfläche durchgeführt – diese CLI verbraucht nur bereits bereitgestellte Verbindungen nach Bezeichnern. Verwenden Sie connection list, um Bezeichner zu erkennen, und connection sync --wait, um einen zu aktualisieren.

Zusammenfassung

uip aops connection list
uip aops connection state [--connection <id>]
uip aops connection sync [connection-id] [--wait] [--timeout <ms>] [--poll-interval <ms>]
uip aops connection delete <connection-id> -y
uip aops connection repos <connection-id> [--azure-projects-ids <csv>] [--organization-identifier <name>]
uip aops connection repos-bulk --ids <csv>
uip aops connection projects <connection-id> [--repository-ids <csv>] [--target-framework <name>] [--project-type <type>] [--azure-projects-ids <csv>] [--organization-identifier <name>] [--sort-by <field>] [--sort-order <asc|desc>] [--offset <n>] [--limit <n>] [--search <term>]
uip aops connection solutions <connection-id> [--offset <n>] [--limit <n>] [--search <term>]
uip aops connection azure-projects <connection-id> [--organization-identifier <name>]

uip aops repo branches <repo-id>
uip aops repo project-files <repo-id> [--reference <ref>]

UIP-Aops-Verbindungsliste

Listen Sie jede SourceControl-Verbindung auf, die für den aktuellen Benutzer sichtbar ist.

Datenform (--output json)

{
  "Code": "ConnectionList",
  "Data": [
    { "identifier": "f1e2d3c4-0000-0000-0000-000000000001", "name": "GitHub - main org", "type": "GitHub" }
  ]
}

Verwenden Sie das zurückgegebene identifier mit jedem anderen connection-, repo- und project -Befehl.

UIP-Aops-Verbindungsstatus

Rufen Sie den aktuellen Synchronisierungsstatus für Verbindungen ab.

Optionen

Long	Wert	Beschreibung
--connection <id>	string	Filtern Sie zu einem einzelnen Verbindungsbezeichner. Clientseitiger Filter – Die API gibt den Status jeder Verbindung zurück und die CLI filtert lokal.

Datenform (--output json)

{
  "Code": "ConnectionState",
  "Data": [
    { "identifier": "f1e2d3c4-0000-0000-0000-000000000001", "syncState": "Success", "syncingInProgress": false }
  ]
}

syncState ist Success, Fail oder Broken.

Synchronisierung der UIP-Aops-Verbindung

Lösen Sie eine Synchronisierung für eine Verbindung oder für jede Verbindung in der Organisation aus, wenn [connection-id] weggelassen wird.

Argumente

Name	Erforderlich	Zweck
[connection-id]	nein	Verbindungsbezeichner von connection list. Unterlassen Sie es, jede Verbindung in der Organisation zu synchronisieren.

Optionen

Long	Wert	Beschreibung
--wait	Markieren	Rufen Sie den Statusendpunkt ab, bis die Synchronisierung einen Endstatus erreicht, anstatt sofort zurückzukehren.
--timeout <ms>	Integer	Maximale Wartezeit, wenn --wait festgelegt ist. Standardmäßig: 300000 (5 Minuten).
--poll-interval <ms>	Integer	Intervall zwischen Statusabfragen. Der Standardwert ist 2000.

Der Trigger-Endpunkt gibt 202 sofort zurück; Ohne --wait wird das Steuerelement zurückgegeben, sobald die Synchronisierung in die Warteschlange gestellt wird (Code: "ConnectionSyncStarted"). Mit --wait wird ein nicht erfolgreicher Endstatus (z. B. Broken) wird als Fehler gemeldet, nicht als Erfolg.

Beispiel

uip aops connection sync f1e2d3c4-0000-0000-0000-000000000001 --wait

Datenform (--output json)

{ "Code": "ConnectionSynced", "Data": { "identifier": "f1e2d3c4-0000-0000-0000-000000000001", "syncState": "Success", "syncingInProgress": false } }

Das Synchronisieren jeder Verbindung (kein connection-id) gibt ein Array unter Data anstelle eines Objekts zurück.

UIP-Aops-Verbindung löschen

Löschen Sie eine SourceControl-Verbindung nach Bezeichner. Endgültig – Die über diese Verbindung erkannten Projekte und Lösungen sind nicht mehr erreichbar.

Argumente

Name	Erforderlich	Zweck
<connection-id>	ja	Verbindungsbezeichner von connection list.

Optionen

Long	Beschreibung
-y, --yes	Erforderlich. Bestätigt diesen nicht rückgängig zu machenden Vorgang – die CLI fordert Sie nie auf.

Datenform (--output json)

{ "Code": "ConnectionDeleted", "Data": { "ConnectionId": "f1e2d3c4-0000-0000-0000-000000000001" } }

UIP-Aops-Verbindungs-Repositorys

Listen Sie Repositorys auf, die über eine einzelne Verbindung sichtbar sind.

Argumente

Name	Erforderlich	Zweck
<connection-id>	ja	Verbindungsbezeichner von connection list.

Optionen

Long	Wert	Beschreibung
--azure-projects-ids <csv>	durch Kommas getrennt sind	Einschränken auf bestimmte Azure DevOps-Projektbezeichner. Nur Azure-Verbindungen.
--organization-identifier <name>	string	Scope auf eine Azure DevOps-Organisation. Nur Azure-Verbindungen für organisationsübergreifende Verbindungen.

Datenform (--output json)

{ "Code": "ConnectionRepos", "Data": [ { "identifier": "abcd1234-0000-0000-0000-000000000001", "name": "automation-hub" } ] }

UIP-aops-Verbindungs-Repos-Massen

Rufen Sie Repositorys für mehrere Verbindungen in einer einzigen Runde ab.

Optionen

Long	Wert	Erforderlich	Beschreibung
--ids <csv>	durch Kommas getrennt sind	ja	Verbindungsbezeichner von connection list.

Datenform (--output json)

{
  "Code": "ConnectionReposBulk",
  "Data": [
    { "ConnectionId": "f1e2d3c4-0000-0000-0000-000000000001", "Repositories": [ { "identifier": "abcd1234-0000-0000-0000-000000000001", "name": "automation-hub" } ] }
  ]
}

Eine Zeile pro Verbindung – ConnectionId wird als einfacher Wert (kein normalisierter Schlüssel) beibehalten, sodass sie die Ausgabeformatierung beibehält und wieder in connection repos <id> übertragen wird.

UIP-Aops-Verbindungsprojekte

Listen Sie Automatisierungsprojekte auf, die über eine Verbindung erkannt wurden.

Argumente

Name	Erforderlich	Zweck
<connection-id>	ja	Verbindungsbezeichner von connection list.

Optionen

Long	Wert	Beschreibung
--repository-ids <csv>	durch Kommas getrennt sind	Enge auf bestimmte Repository-Bezeichner von connection repos.
--target-framework <name>	string	Serverseitiger Filter im Projektzielframework.
--project-type <type>	string	Serverseitiger Filter für Projekttyp (z. B. Process, Library, Agent).
--azure-projects-ids <csv>	durch Kommas getrennt sind	Nur Azure-Verbindungen.
--organization-identifier <name>	string	Nur Azure-Verbindungen.
--sort-by <field>	string	Feld, nach dem sortiert werden soll (z. B name, lastModifiedDate).
--sort-order <asc|desc>	ENUM	Sortierrichtung. Kombinieren Sie mit --sort-by.
--offset <n>	Integer	Zu überspringende Zahl. Muss ein Mehrfaches von --limit sein. Der Standardwert ist 0.
--limit <n>	Integer	Zurückzugebendes Maximum. Der Standardwert ist 10.
--search <term>	string	Serverseitiger Teilzeichenfolgenfilter für den Projektnamen.

Beispiele

uip aops connection projects f1e2d3c4-0000-0000-0000-000000000001

uip aops connection projects f1e2d3c4-0000-0000-0000-000000000001 \
  --repository-ids abcd1234-0000-0000-0000-000000000001 --sort-by name --sort-order asc

Datenform (--output json)

{
  "Code": "ConnectionProjects",
  "Data": [
    { "ProjectId": "9999dddd-0000-0000-0000-000000000001", "Name": "Invoice Processing", "Description": "Daily invoice ingest", "Type": "Process", "Repository": "automation-hub" }
  ]
}

UIP-Aops-Verbindungslösungen

Listen Sie Studio-Lösungen auf, die über eine Verbindung erkannt wurden.

Argumente

Name	Erforderlich	Zweck
<connection-id>	ja	Verbindungsbezeichner von connection list.

Optionen

Long	Wert	Beschreibung
--offset <n>	Integer	Zu überspringende Zahl. Muss ein Mehrfaches von --limit sein. Der Standardwert ist 0.
--limit <n>	Integer	Zurückzugebendes Maximum. Der Standardwert ist 20.
--search <term>	string	Serverseitiger Teilzeichenfolgenfilter für den Lösungsnamen.

Datenform (--output json)

{ "Code": "ConnectionSolutions", "Data": { "result": [] } }

UIP-Aops-Verbindung „Azure-Projekte“.

Listen Sie Azure DevOps-Projekte auf, die über eine Azure-Verbindung erreichbar sind. GitHub-Verbindungen geben immer eine leere Liste zurück.

Argumente

Name	Erforderlich	Zweck
<connection-id>	ja	Azure-Verbindungsbezeichner von connection list.

Optionen

Long	Wert	Beschreibung
--organization-identifier <name>	string	Scope auf eine Azure DevOps-Organisation für mehrere Verbindungen.

Datenform (--output json)

{ "Code": "ConnectionAzureProjects", "Data": [] }

UIP-Aops-Repository

Inspizieren Sie ein Repository, das bereits über connection repos <connection-id> angezeigt wurde.

UIP-AOPS-Repository-Verzweigungen

Listen Sie Verzweigungen für ein Repository auf.

Argumente

Name	Erforderlich	Zweck
<repo-id>	ja	Repository-Bezeichner von connection repos <connection-id>.

Datenform (--output json)

{ "Code": "RepoBranches", "Data": [ { "Name": "main", "Main": true }, { "Name": "release", "Main": false } ] }

Verwenden Sie die Verzweigung Name als --reference in repo project-files, project content usw.

UIP-Aops-Repo-Projektdateien

Listen Sie Automatisierungsprojektdateien (project.json Stammstamm) im Repository unter einem bestimmten Verweis auf.

Argumente

Name	Erforderlich	Zweck
<repo-id>	ja	Repository-Bezeichner von connection repos <connection-id>.

Optionen

Long	Wert	Beschreibung
--reference <ref>	branch/Tag/SHA	Die Standardeinstellung ist HEAD der Standardverzweigung.

Datenform (--output json)

{ "Code": "RepoProjectFiles", "Data": [] }

Zugehörig

• uip aops – Übersicht und Konzepte.
• projects – überprüfen Sie ein Projekt oder eine Lösung, sobald sie hier entdeckt wurden.
• pipelines – Definieren und Ausführen von CI/CD-Pipelines für ein erkanntes Projekt.

Siehe auch

• Globale Optionen
• Exitcodes