Saltar al contenido principal

kobana dashboards portal-user-mappings

Consultar mapeo de usuarios del portal

Comandos de kobana dashboards portal-user-mappings. Toda opción global (Opciones globales) vale aquí.

ComandoHTTPDescripción
portal-user-mappingsGET /v1/portal_user_mappingsConsultar mapeo de usuarios del portal
portal-user-mappings updatePUT /v1/portal_user_mappingsMapear entidad a usuarios del portal
portal-user-mappings deleteDELETE /v1/portal_user_mappingsEliminar mapeo de usuarios del portal

portal-user-mappings​

Consultar mapeo de usuarios del portal

kobana dashboards portal-user-mappings [OPCIONES] [COMANDO]

GET /v1/portal_user_mappings

La entidad que alimenta a los usuarios del portal del workspace (mapping, null si no hay, con el resultado de la última sincronización) y las entidades que pueden mapearse, con sus campos.

Encabezados

NombreTipoObligatorioDescripción
X-Workspace-IdstringnoWorkspace en el que actúa la llamada: el id o el public_id que se muestran en Workspaces en el panel. Dentro de la organización del token, los datos viven en workspaces. Puede omitirse mientras la organización tenga un único workspace; con dos o más, omitirlo devuelve 400 workspace_required. Un workspace que no es de la organización devuelve 403 unknown_workspace. Con un token de persona, solo los workspaces a los que ella tiene acceso (los propietarios de la organización alcanzan todos); los demás devuelven 403 workspace_access_denied.

Respuestas

HTTPDescripción
200El mapeo.
404Recurso no encontrado en la organización actual.

portal-user-mappings update​

Mapear entidad a usuarios del portal

kobana dashboards portal-user-mappings update [OPCIONES]

PUT /v1/portal_user_mappings

Mapea una entidad: un usuario del portal por correo de sus registros, con el ID del titular tomado de un campo. Reemplaza el mapeo anterior y sincroniza en el acto (devuelve stats); las próximas sincronizaciones de la entidad mantienen a los usuarios al día.

Encabezados

NombreTipoObligatorioDescripción
X-Workspace-IdstringnoWorkspace en el que actúa la llamada: el id o el public_id que se muestran en Workspaces en el panel. Dentro de la organización del token, los datos viven en workspaces. Puede omitirse mientras la organización tenga un único workspace; con dos o más, omitirlo devuelve 400 workspace_required. Un workspace que no es de la organización devuelve 403 unknown_workspace. Con un token de persona, solo los workspaces a los que ella tiene acceso (los propietarios de la organización alcanzan todos); los demás devuelven 403 workspace_access_denied.

Cuerpo de la solicitud

NombreTipoObligatorioDescripción
entity_type_idstring (uuid)síLa entidad cuyos registros se convierten en usuarios del portal.
tenant_id_field_keystringsí
email_field_keystringsí
name_field_keystringno

Otros campos y objetos anidados: kobana schema dashboards.portal-user-mappings.update.

Respuestas

HTTPDescripción
200El mapeo guardado y el resultado de la sincronización.
400El cuerpo de la solicitud falló en la validación.
404Recurso no encontrado en la organización actual.
422Entidad o campo inválido (p. ej., entidad que sincroniza al acceder).

portal-user-mappings delete​

Eliminar mapeo de usuarios del portal

kobana dashboards portal-user-mappings delete [OPCIONES]

DELETE /v1/portal_user_mappings

Deja de sincronizar; los usuarios ya creados permanecen.

Encabezados

NombreTipoObligatorioDescripción
X-Workspace-IdstringnoWorkspace en el que actúa la llamada: el id o el public_id que se muestran en Workspaces en el panel. Dentro de la organización del token, los datos viven en workspaces. Puede omitirse mientras la organización tenga un único workspace; con dos o más, omitirlo devuelve 400 workspace_required. Un workspace que no es de la organización devuelve 403 unknown_workspace. Con un token de persona, solo los workspaces a los que ella tiene acceso (los propietarios de la organización alcanzan todos); los demás devuelven 403 workspace_access_denied.

Respuestas

HTTPDescripción
200Mapeo eliminado (deleted: false si no había).
404Recurso no encontrado en la organización actual.