Skip to content

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

  1. Lee los contactos actuales: GET /api/v3/admin/tenants/{tenantId}/operational-contacts. La respuesta siempre lleva contacts, una lista vacía cuando no hay ninguno designado.
  2. Envía todo el conjunto que quieres guardar: PUT /api/v3/admin/tenants/{tenantId}/operational-contacts con un cuerpo como

    {
      "contacts": [
        {"category": "OPERATIONS", "name": "Platform Operations",
         "email": "[email protected]", "phone": "+14155550100"},
        {"category": "SECURITY", "name": "Security Operations Center",
         "email": "[email protected]"}
      ]
    }
    
  3. 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

Estas páginas están en inglés: