Saltar al contenido principal

WORKSPACE_AND_APIKEYS_ORCHESTRATOR

API_SEC_LOG: ORCHESTRATOR_ACTIVE

Los Workspaces son contenedores lógicos seguros de aislamiento que separan entornos, proyectos y pipelines de Azure DevOps, centralizando sus métricas DORA y desgloses de facturación en una consola unificada.

01_WORKSPACE_PROVISIONING​

Aprovisiona, audita y administra tus entornos corporativos a nivel de infraestructura:

A. Listar Espacios de Trabajo​

  • Endpoint: GET /admin/workspace/list
  • Descripción: Retorna todos los espacios donde el operador autenticado es miembro activo. Se utiliza directamente para poblar el menú desplegable del Sidebar.

B. Crear Nuevo Workspace​

  • Endpoint: POST /admin/workspace/create
  • Payload de Creación:
{
  "workspaceName": "Núcleo de Despliegue",
  "initials": "NUD",
  "colors": "green",
  "description": "Workspace de producción para microservicios de pasarela",
  "plan": "Enterprise"
}

02_API_KEYS_GOVERNANCE_SYSTEM​

Para permitir que scripts de bash locales, automatizaciones de Jenkins, orquestadores externos o canales de Slack consuman métricas del sistema de manera autónoma, puedes aprovisionar API Keys dedicadas:

1. Listar Claves Activas​

  • Endpoint: GET /apikey/list/{workspaceId}

2. Crear Nueva API Key​

  • Endpoint: POST /apikey/create
  • Payload (JSON):
{
  "name": "Local_SRE_Monitor_Token",
  "workspaceId": 1,
  "slackId": "integracion-alertas-slack",
  "notificationEmails": "[\"sre-alerts@empresa.com\"]"
}
  • Respuesta: Retorna el secreto crudo de la API Key (solo visible durante la creación).

3. Revocar API Key (Eliminar)​

  • Endpoint: DELETE /apikey/{id}/{workspaceId}
  • Efecto: Anula de manera inmediata y definitiva el acceso de dicho token para cualquier llamada externa.

03_API_KEY_METADATA_AUDIT​

Para auditar la actividad de tus integraciones, la plataforma rastrea el volumen de solicitudes mensuales canalizadas por cada API Key del Workspace.

  • Endpoint: GET /admin/reports/getApiKeyMonthlyUsage
  • Parámetros: workspaceId={id} (vía Query Params)
  • Respuesta JSON:
{
  "apiKeyId": 14,
  "name": "Local_SRE_Monitor_Token",
  "requestsConsumedThisMonth": 2480,
  "monthlyLimit": 10000,
  "lastRequestDate": "2026-06-19T21:40:15.000Z"
}