Designar los contactos operativos del tenant
Indica al operador de la plataforma a quién contactar en tu tenant: un contacto para los avisos de servicio y mantenimiento, y otro para los incidentes y avisos de seguridad.
Quién puede hacerlo
Un administrador del tenant, desde código. Reemplazar los contactos requiere el permiso admin.tenant.operational-contact.manage, que tiene el rol de administrador del tenant. Leerlos requiere admin.tenant.operational-contact.read, que también tienen los demás roles integrados del tenant.
- Una sesión de acceso de soporte lee los contactos como los lee el tenant, y no puede reemplazarlos en ningún tipo de despliegue.
- Un administrador de la plataforma no los reemplaza directamente sobre el tenant; el personal de la plataforma los lee en la propia lectura del tenant de la plataforma.
Ninguna pantalla de la consola ofrece esta tarea.
Antes de empezar
- Hay dos categorías, con un contacto como máximo cada una:
OPERATIONS: avisos de servicio y mantenimiento;SECURITY: incidentes y avisos de seguridad.
- Cada contacto es un nombre, una dirección de correo electrónico y, de forma opcional, un número de teléfono. Prefiere el nombre y el buzón de un equipo a los de una persona, para que el contacto siga vigente aunque cambie el personal.
- Los límites, contados en caracteres, no en bytes:
- el nombre tiene de 1 a 128 caracteres, no está en blanco y ocupa una sola línea;
- la dirección de correo está bien formada y tiene como máximo 254 caracteres (RFC 5321);
- el número de teléfono, si se indica, está en formato E.164 (ITU-T E.164): un signo más y como máximo 15 dígitos.
- La solicitud reemplaza todo el conjunto guardado: una categoría que omites pierde su contacto, y una lista vacía quita todos los contactos.
- Un tenant cerrado conserva sus contactos y no acepta ningún reemplazo.
Pasos
- Lee los contactos actuales:
GET /api/v3/admin/tenants/{tenantId}/operational-contacts. La respuesta siempre llevacontacts, una lista vacía cuando no hay ninguno designado. -
Envía todo el conjunto que quieres guardar:
PUT /api/v3/admin/tenants/{tenantId}/operational-contactscon un cuerpo como{ "contacts": [ {"category": "OPERATIONS", "name": "Platform Operations", "email": "[email protected]", "phone": "+14155550100"}, {"category": "SECURITY", "name": "Security Operations Center", "email": "[email protected]"} ] } -
Para quitar todos los contactos, envía
{"contacts": []}.
Qué ves cuando funcionó
La respuesta es 200 con el conjunto guardado, en el orden de las categorías, tal como lo devuelve la lectura; un contacto sin número de teléfono no lleva el miembro phone. Cada contacto que el reemplazo crea, cambia o quita queda registrado en la auditoría de tu tenant con su valor anterior y posterior, todos con un mismo identificador de correlación. Volver a enviar el conjunto guardado no cambia nada ni registra nada.
Si falla
| Qué ves | Causa | Qué hacer |
|---|---|---|
400, con el detalle que nombra el miembro | Dos contactos de una misma categoría, más de dos contactos, una categoría distinta de OPERATIONS o SECURITY, un nombre en blanco o demasiado largo, una dirección de correo mal formada o demasiado larga, o un número de teléfono fuera de E.164. No se cambia nada | Corrige el miembro indicado |
403 | No tienes el permiso para reemplazar los contactos, actúas en una sesión de acceso de soporte (impersonation-operation-forbidden), o eres un administrador de la plataforma que actúa directamente sobre el tenant | Pide a un administrador del tenant que los reemplace desde su propia sesión |
404 | El tenant está cerrado o no es uno al que puedas dirigirte | Comprueba el identificador del tenant |
503 con Retry-After | Otro reemplazo de los contactos, o un cambio del propio tenant, retuvo el tenant más de 5 segundos. No se cambió nada | Vuelve a intentarlo después del tiempo indicado |
Sin la consola
| Superficie | Cómo |
|---|---|
| CLI de administración | Ninguna |
| Admin SDK | Ninguno |
| API | GET /api/v3/admin/tenants/{tenantId}/operational-contacts (operación getTenantOperationalContacts) |
| API | PUT /api/v3/admin/tenants/{tenantId}/operational-contacts con contacts (operación replaceTenantOperationalContacts) |
Relacionado
- Cambiar el nombre de tu tenant: cambia el nombre que ven tus usuarios.
Estas páginas están en inglés: