Conexiones UIP AOPs

Sintaxis y opciones para `conexión de uip aops` y `repo de uip aops`, que sincronizan las conexiones de SourceControl e inspeccionan los repositorios descubiertos a través de ellas.

uip aops connection las conexiones de SourceControl : el enlace por tenant a un proveedor de Git (GitHub o Azure DevOps) que StudioAdmin utiliza para descubrir repositorios, proyectos de automatización y soluciones. uip aops repo inspecciona las ramas de un solo repositorio y los archivos de proyecto de automatización una vez que tienes un identificador de repositorio de connection repos. Consulta la descripción generaluip aops de los conceptos compartidos y la división de servicio SC/servicio CICD.

Nota:

La creación de conexiones se realiza a través de la IU de StudioAdmin: esta CLI solo consume conexiones ya aprovisionadas por identificador. Usa connection list para descubrir identificadores y luego connection sync --wait para actualizar uno.

Sinopsis

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

lista de conexiones de uip aops

Enumera todas las conexiones de ControlDeOrigen visibles para el usuario actual.

Forma de datos (--json de salida)

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

Utiliza el identifier devuelto con cualquier otro comando connection, repo y project.

estado de conexión de uip aops

Obtener el estado de sincronización actual para las conexiones.

Opciones

Largo	Valor	Descripción
--connection <id>	String	Filtrar a un único identificador de conexión. Filtro del lado del cliente: la API devuelve el estado de cada conexión y la CLI filtra localmente.

Forma de datos (--json de salida)

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

syncState es Success, Fail o Broken.

sincronización de conexión uip aops

Desencadena una sincronización para una conexión, o cada conexión en la organización si se omite [connection-id].

Argumentos

Nombre	Obligatorio	Propósito
[connection-id]	No	Identificador de conexión de connection list. Omita sincronizar cada conexión en la organización.

Opciones

Largo	Valor	Descripción
--wait	Marca	Sondea el punto final de estado hasta que la sincronización alcance un estado terminal en lugar de volver inmediatamente.
--timeout <ms>	Entero	Tiempo máximo de espera cuando se establece --wait. Predeterminado 300000 (5 minutos).
--poll-interval <ms>	Entero	Intervalo entre encuestas de estado. Predeterminado 2000.

El punto final del desencadenador devuelve 202 inmediatamente; sin --wait, el control vuelve tan pronto como la sincronización se pone en cola (Code: "ConnectionSyncStarted"). Con --wait, un estado terminal no correcto (por ejemplo Broken) se informa como un error, no como un éxito.

Ejemplo

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

Forma de datos (--json de salida)

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

Sincronizar cada conexión (ninguna connection-id) devuelve una matriz bajo Data en lugar de un objeto.

eliminación de conexión uip aops

Eliminar una conexión de ControlDeOrigen por identificador. Permanente: los proyectos y soluciones descubiertos a través de esta conexión ya no son accesibles.

Argumentos

Nombre	Obligatorio	Propósito
<connection-id>	Sí	Identificador de conexión de connection list.

Opciones

Largo	Descripción
-y, --yes	Obligatorio. Confirma esta operación irreversible: la CLI nunca solicita.

Forma de datos (--json de salida)

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

repositorios de conexión de uip aops

Enumera los repositorios visibles a través de una sola conexión.

Argumentos

Nombre	Obligatorio	Propósito
<connection-id>	Sí	Identificador de conexión de connection list.

Opciones

Largo	Valor	Descripción
--azure-projects-ids <csv>	separados por comas	Limitar a identificadores de proyecto específicos de Azure DevOps. Solo conexiones de Azure.
--organization-identifier <name>	String	Ámbito a una organización de Azure DevOps. Solo conexiones de Azure, para conexiones entre organizaciones.

Forma de datos (--json de salida)

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

conexión uip aops repos-bulk

Obtener repositorios para varias conexiones en un solo viaje de ida y vuelta.

Opciones

Largo	Valor	Obligatorio	Descripción
--ids <csv>	separados por comas	Sí	Identificadores de conexión de connection list.

Forma de datos (--json de salida)

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

Una fila por conexión: ConnectionId se mantiene como un valor simple (no una clave normalizada) para que sobreviva al formato de salida y se realimente a connection repos <id>.

proyectos de conexión de uip aops

Enumerar los proyectos de automatización descubiertos a través de una conexión.

Argumentos

Nombre	Obligatorio	Propósito
<connection-id>	Sí	Identificador de conexión de connection list.

Opciones

Largo	Valor	Descripción
--repository-ids <csv>	separados por comas	Limitar a identificadores de repositorio específicos de connection repos.
--target-framework <name>	String	Filtro del lado del servidor en el marco de destino del proyecto.
--project-type <type>	String	Filtro del lado del servidor en el tipo de proyecto (por ejemplo Process, Library, Agent).
--azure-projects-ids <csv>	separados por comas	Solo conexiones de Azure.
--organization-identifier <name>	String	Solo conexiones de Azure.
--sort-by <field>	String	Campo por el que ordenar (p. ej. name, lastModifiedDate).
--sort-order <asc|desc>	ENUM	Ordenar dirección. Combinar con --sort-by.
--offset <n>	Entero	Número a omitir. Debe ser un múltiplo de --limit. Predeterminado 0.
--limit <n>	Entero	Máximo a devolver. Predeterminado 10.
--search <term>	String	Filtro de subcadena del lado del servidor en el nombre del proyecto.

Ejemplos

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

Forma de datos (--json de salida)

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

soluciones de conexión uip aops

Enumerar las soluciones de Studio descubiertas a través de una conexión.

Argumentos

Nombre	Obligatorio	Propósito
<connection-id>	Sí	Identificador de conexión de connection list.

Opciones

Largo	Valor	Descripción
--offset <n>	Entero	Número a omitir. Debe ser un múltiplo de --limit. Predeterminado 0.
--limit <n>	Entero	Máximo a devolver. Predeterminado 20.
--search <term>	String	Filtro de subcadena del lado del servidor en el nombre de la solución.

Forma de datos (--json de salida)

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

Conexión de uip aops a proyectos-azure

Enumerar proyectos de Azure DevOps accesibles a través de una conexión de Azure. Las conexiones de GitHub siempre devuelven una lista vacía.

Argumentos

Nombre	Obligatorio	Propósito
<connection-id>	Sí	Identificador de conexión de Azure de connection list.

Opciones

Largo	Valor	Descripción
--organization-identifier <name>	String	Ámbito a una organización de Azure DevOps, para conexiones que abarcan varias.

Forma de datos (--json de salida)

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

repositorio de uip aops

Inspecciona un repositorio ya mostrado a través de connection repos <connection-id>.

ramas del repositorio de uip aops

Enumerar ramas para un repositorio.

Argumentos

Nombre	Obligatorio	Propósito
<repo-id>	Sí	Identificador del repositorio de connection repos <connection-id>.

Forma de datos (--json de salida)

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

Usa la rama Name como --reference en repo project-files, project content, etc.

uip aops repo archivos-proyecto

Enumera los archivos del proyecto de automatización (project.json raíces) en el repositorio en una referencia determinada.

Argumentos

Nombre	Obligatorio	Propósito
<repo-id>	Sí	Identificador del repositorio de connection repos <connection-id>.

Opciones

Largo	Valor	Descripción
--reference <ref>	rama/etiqueta/SHA	El valor predeterminado es el HEAD de la rama predeterminada.

Forma de datos (--json de salida)

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

Relacionado

• uip aops : descripción general y conceptos.
• projects : inspecciona un proyecto o solución una vez descubierto aquí.
• pipelines : define y ejecuta procesos de CI/CD en un proyecto descubierto.

Ver también

• Opciones globales
• Códigos de salida