Administración y CI

Administre espacios de trabajo, equipos, miembros, créditos y tokens de automatización específicos.


Espacios de trabajo y equipos

epismo workspace create --handle team
epismo workspace update <workspace-id> --handle new-name
epismo workspace checkout <workspace-id>
epismo workspace use acme
epismo -w acme workspace member list
epismo workspace member list
epismo workspace member upsert <user-id> --role admin
epismo workspace member delete <user-id>

epismo team list
epismo team create --name "Website" --description "Marketing and docs"
epismo team update <team-id> --name "Website launch"
epismo team member list --team-id <team-id>
epismo team member add <user-id> --team-id <team-id>
epismo team member delete <user-id> --team-id <team-id>

epismo workspace checkout <workspace-id> inicia un checkout de suscripción alojado. Si el espacio tiene una cancelación programada para el final del periodo de facturación actual, reanuda la suscripción existente en lugar de crear otra.

Los roles del espacio de trabajo son propietario, administrador y miembro. Una referencia de espacio de trabajo es un ID exacto o un handle único como acme; use --workspace/-w para una sustitución de un comando, EPISMO_WORKSPACE para un shell o trabajo y workspace use solo para guardar un valor predeterminado. Los equipos son principios privados compartidos dentro del espacio de trabajo seleccionado. Los comandos de miembros aceptan formularios masivos admitidos; utilice --help para obtener la forma exacta del argumento actual.

Créditos

epismo credit balance
epismo credit checkout --quantity 500

El contexto de ejecución resuelto determina qué saldo se lee o se compra. Verifique whoami y el espacio de trabajo actual antes de un trabajo automatizado grande. Una solicitud con control de crédito puede devolver 402 cuando el contexto seleccionado no tiene saldo suficiente.

tokens de CI

epismo token create --workspace-id <workspace-id>
EPISMO_TOKEN=<access-token> epismo whoami

Almacene tokens en un administrador secreto, nunca en una entrada de caso, definición de playbook, registro, repositorio o historial de shell. Un EPISMO_TOKEN con ámbito de espacio de trabajo limita el acceso a su espacio; no use un valor de --workspace en conflicto. Asigne a cada entorno de automatización su propio token para que pueda rotarse sin interrumpir las sesiones personales.

Un equipo puede conectar varios espacios de trabajo. Solo los participantes del equipo que sean propietarios o administradores de su espacio conectado pueden enviar, listar o revocar invitaciones al equipo. El destinatario inicia sesión con el correo de la invitación y elige un espacio existente o crea uno; el remitente no elige el destino. Aceptar conecta el espacio y añade al destinatario, no a todos sus miembros. Aceptar en un espacio ya conectado al equipo devuelve HTTP 409 sin consumir la invitación. Use la gestión de miembros del equipo para añadir participantes en ese espacio. Cada espacio administra sus participantes. Un mismo usuario puede participar desde varios espacios; eliminar su membresía en uno conserva su participación en los demás. Desconectar elimina su conexión y participantes sin afectar las demás. El acceso mediante el equipo requiere que el espacio de participación y el origen del recurso sigan conectados. Los permisos directos a usuarios permanecen. Las invitaciones caducan a los catorce días; reenviar cierra la anterior. La conexión no elimina los requisitos de suscripción del espacio.

epismo -w <sender-workspace> team invite <team-id> --emails customer@example.com
epismo -w <sender-workspace> team invitation list <team-id>
epismo team invitation get <token>
epismo -w <recipient-workspace> team invitation accept <token>
epismo -w <workspace> team invitation revoke <team-id> <invitation-id>
epismo -w <workspace> team disconnect <team-id>
epismo workspace create --handle <handle> --team-invitation-token <token>

Propiedad, responsabilidad y ciclo de vida

Antes de eliminar un miembro, un Owner o Admin puede previsualizar y ejecutar el traspaso de Casos, mantenimiento de Playbooks y permisos. Las aprobaciones abiertas se transfieren solo si se solicita; las completadas y la autoría permanecen como historial. Elija un sucesor actual y revise la vista previa. workspace member handover <workspace-id> --member-id <user-id> --successor-id <user-id> previsualiza por defecto; use --preview=false para ejecutar y conceder edición explícita al sucesor. Elimine la membresía por separado con workspace member delete --workspace-id <workspace-id> <user-id> y repita el traspaso con --preview=false --finalize para limpiar cambios intermedios. Finalize exige que la membresía ya esté eliminada; no elimina al miembro. La eliminación revoca la autoridad correspondiente del Equipo y de administración del Espacio. El traspaso inicial conserva los permisos directos; la eliminación los revoca sobre los recursos de ese Espacio y la finalización repite la limpieza de permisos añadidos entretanto. Se conservan los permisos personales y de otros Espacios.

La solicitud HTTP de traspaso usa ahora memberId, successorId y transferApprovals. La respuesta contiene los recuentos cases, playbooks, tasks, approvals y suggestions. El comando de traspaso de CLI necesita una versión compatible con este contrato.