Connexions uipaops

Syntaxe et options pour `uip aops connection` et `uip aops repo`, qui synchronisent les connexions de contrôle de code source et inspectent les référentiels découverts par leur intermédiaire.

uip aops connection gère les connexions SourceControl — le lien par locataire vers un fournisseur Git (GitHub ou Azure DevOps) que StudioAdmin utilise pour découvrir les référentiels, les projets d'automatisation et les solutions. uip aops repo inspecte les branches d'un référentiel unique et les fichiers de projet d'automatisation une fois que vous disposez d'un identificateur de référentiel provenant de connection repos. Voir la vue d'ensembleuip aops pour les concepts partagés et la répartition SC-service/CICD-service.

Remarque :

La création de la connexion est effectuée via l'interface utilisateur de StudioAdmin — cette CLI utilise uniquement les connexions déjà enregistrées par identifiant. Utilisez connection list pour découvrir les identificateurs, puis connection sync --wait pour en actualiser un.

Synthèse

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>]

liste des connexions uip aops

Répertorie chaque connexion de contrôle de code source visible par l'utilisateur actuel.

Format des données (--sortie json)

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

Utilisez le identifier renvoyé avec toutes les autres commandes connection, repo et project.

état de connexion uipaops

Récupérez l'état de synchronisation actuel des connexions.

Options

Long	Valeur (Value)	Description
--connection <id>	string	Filtrez sur un identificateur de connexion unique. Filtre côté client — l'API renvoie l'état de chaque connexion et les filtres CLI localement.

Format des données (--sortie json)

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

syncState est Success, Fail ou Broken.

synchronisation de la connexion uip aops

Déclenchez une synchronisation pour une connexion ou chaque connexion de l’organisation si [connection-id] est omis.

Arguments

Nom	Requis	Objectif
[connection-id]	non	Identificateur de connexion de connection list. Omettez de synchroniser chaque connexion dans l’organisation.

Options

Long	Valeur (Value)	Description
--wait	Drapeau	Interrogez le point de terminaison de l’état jusqu’à ce que la synchronisation atteigne un état terminal au lieu de revenir immédiatement.
--timeout <ms>	Integer	Durée d’attente maximale lorsque --wait est défini. Par défaut 300000 (5 minutes).
--poll-interval <ms>	Integer	Intervalle entre les interrogations d’état. Par défaut 2000.

Le point de terminaison du déclencheur renvoie immédiatement 202; sans --wait, le contrôle renvoie dès que la synchronisation est mise en file d'attente (Code: "ConnectionSyncStarted"). Avec --wait, un état terminal sans réussite (par exemple Broken) est signalé comme un échec, et non comme un succès.

Exemple

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

Format des données (--sortie json)

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

La synchronisation de chaque connexion (pas de connection-id) renvoie un tableau sous Data au lieu d'un objet.

suppression de la connexion uip aops

Supprimez une connexion de contrôle de code source par identifiant. Continu: les projets et solutions découverts via cette connexion ne sont plus accessibles.

Arguments

Nom	Requis	Objectif
<connection-id>	oui	Identificateur de connexion de connection list.

Options

Long	Description
-y, --yes	Requis. Confirme cette opération irréversible — la CLI ne s'affiche jamais.

Format des données (--sortie json)

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

référentiels de connexion uip aops

Répertoriez les référentiels visibles par une seule connexion.

Arguments

Nom	Requis	Objectif
<connection-id>	oui	Identificateur de connexion de connection list.

Options

Long	Valeur (Value)	Description
--azure-projects-ids <csv>	Séparé par des virgules	Affinez des identificateurs de projet Azure DevOps spécifiques. Connexions Azure uniquement.
--organization-identifier <name>	string	Étendue à une seule organisation Azure DevOps. Connexions Azure uniquement, pour les connexions inter-organisations.

Format des données (--sortie json)

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

uip aops - connexion en bloc

Récupérer les référentiels pour plusieurs connexions dans un même aller-retour.

Options

Long	Valeur (Value)	Requis	Description
--ids <csv>	Séparé par des virgules	oui	Identificateurs de connexion de connection list.

Format des données (--sortie json)

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

Une ligne par connexion - ConnectionId est conservée sous forme de valeur simple (pas une clé normalisée) de sorte qu'elle survient au formatage de sortie et est renvoyée dans connection repos <id>.

projets de connexion uip aops

Répertorier les projets d’automatisation découverts via une connexion.

Arguments

Nom	Requis	Objectif
<connection-id>	oui	Identificateur de connexion de connection list.

Options

Long	Valeur (Value)	Description
--repository-ids <csv>	Séparé par des virgules	Recherchez des identificateurs de référentiel spécifiques à partir de connection repos.
--target-framework <name>	string	Filtre côté serveur sur l'infrastructure cible du projet.
--project-type <type>	string	Filtre côté serveur sur le type de projet (par ex. Process, Library, Agent).
--azure-projects-ids <csv>	Séparé par des virgules	Connexions Azure uniquement.
--organization-identifier <name>	string	Connexions Azure uniquement.
--sort-by <field>	string	Champ à utiliser pour trier (par exemple name, lastModifiedDate).
--sort-order <asc|desc>	ENUM	Sens de tri. Combiner avec --sort-by.
--offset <n>	Integer	Nombre à ignorer. Doit être un multiple de --limit. Par défaut 0.
--limit <n>	Integer	Maximum à renvoyer. Par défaut 10.
--search <term>	string	Filtre de sous-chaînes côté serveur pour le nom du projet.

Exemples

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

Format des données (--sortie json)

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

solutions de connexion uip aops

Répertoriez les solutions Studio découvertes via une connexion.

Arguments

Nom	Requis	Objectif
<connection-id>	oui	Identificateur de connexion de connection list.

Options

Long	Valeur (Value)	Description
--offset <n>	Integer	Nombre à ignorer. Doit être un multiple de --limit. Par défaut 0.
--limit <n>	Integer	Maximum à renvoyer. Par défaut 20.
--search <term>	string	Filtre de sous-chaînes côté serveur sur le nom de la solution.

Format des données (--sortie json)

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

Connexion uip aops Azure-projects

Répertorie les projets Azure DevOps accessibles via une connexion Azure. Les connexions GitHub renvoient toujours une liste vide.

Arguments

Nom	Requis	Objectif
<connection-id>	oui	Identifiant de connexion Azure de connection list.

Options

Long	Valeur (Value)	Description
--organization-identifier <name>	string	Étendue à une seule organisation Azure DevOps, pour les connexions s'étendant sur plusieurs.

Format des données (--sortie json)

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

référentiel aops uip

Inspectez un référentiel déjà réaffiché via connection repos <connection-id>.

branches du référentiel aops uip

Répertorier les branches d'un référentiel.

Arguments

Nom	Requis	Objectif
<repo-id>	oui	Identifiant du référentiel de connection repos <connection-id>.

Format des données (--sortie json)

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

Utilisez la branche Name comme --reference sur repo project-files, project content, etc.

fichiers-projets uip aops

Répertoriez les fichiers de projet d'automatisation (project.json racines) dans le référentiel à une référence donnée.

Arguments

Nom	Requis	Objectif
<repo-id>	oui	Identifiant du référentiel de connection repos <connection-id>.

Options

Long	Valeur (Value)	Description
--reference <ref>	branche/balise/hachage	Par défaut, l' HEAD de la branche par défaut.

Format des données (--sortie json)

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

Associé

• uip aops — Vue d'ensemble et concepts.
• projects — inspecter un projet ou une solution une fois découvert ici.
• pipelines — définissez et exécutez les pipelines CI/CD par rapport à un projet découvert.

Voir également

• Options globales
• Codes de sortie