Compartir a través de

numberAssignment: updateNumber

Espacio de nombres: microsoft.graph.teamsAdministration

Este método se usa para actualizar un número existente con atributos opcionales. Los atributos admitidos actualmente son locationId, networkSiteIdy reverseNumberLookupOptions.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet
✅ ❌ ❌ ❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) TeamsTelephoneNumber.ReadWrite.All No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación TeamsTelephoneNumber.ReadWrite.All No disponible.

Solicitud HTTP

POST /admin/teams/telephoneNumberManagement/numberAssignments/updateNumber

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON de los parámetros.

En la tabla siguiente se enumeran los parámetros necesarios al llamar a esta acción.

Parámetro Tipo Description
telephoneNumber Cadena Obligatorio. Número de teléfono que se va a asignar.
locationId Cadena Indica el identificador de dirección de emergencia establecido en el número de teléfono. Al pasar una cadena vacía, se borra locationId, mientras que al pasar null o no incluir el campo se conserva el valor existente.
networkSiteId Cadena Indica el networkSiteId actualizado. Use una cadena vacía para borrar el networkSiteId existente o use null/omita el campo para conservar el valor existente.
reverseNumberLookupOptions Colección string Este parámetro se usa para controlar el comportamiento de la búsqueda inversa de números (RNL) de un número de teléfono. Cuando RNL contiene skipInternalVoip, una llamada interna a este número de teléfono no intenta pasar a través de VoIP interno a través de la búsqueda inversa de números en Microsoft Teams. En su lugar, la llamada establece a través de la conectividad de red telefónica conmutada (RTC) externa directamente.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK.

Ejemplos

Ejemplo 1: Actualización del identificador de ubicación

Solicitud

En el ejemplo siguiente se muestra una solicitud de actualización locationId de un número de teléfono.

POST https://graph.microsoft.com/v1.0/admin/teams/telephoneNumberManagement/numberAssignments/updateNumber
Content-Type: application/json

{
  "telephoneNumber": "+12061234567",
  "locationId": "93cb8a70-b4af-41df-9928-d07607e21776",
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

HTTP/1.1 200 OK

Ejemplo 2: Actualización del identificador de sitio de red

Solicitud

En el ejemplo siguiente se muestra una solicitud de actualización networkSiteId de un número de teléfono.

POST https://graph.microsoft.com/v1.0/admin/teams/telephoneNumberManagement/numberAssignments/updateNumber
Content-Type: application/json

{
  "telephoneNumber": "+12061234567",
  "networkSiteId": "fff21455-0f84-4a6b-babd-0a9b46971a62",
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

HTTP/1.1 200 OK

Ejemplo 3: Actualización de las opciones de búsqueda de números inversos

Solicitud

En el ejemplo siguiente se muestra una solicitud de actualización reverseNumberLookupOptions para el número de teléfono asociado a la cuenta de recursos.

POST https://graph.microsoft.com/v1.0/admin/teams/telephoneNumberManagement/numberAssignments/updateNumber
Content-Type: application/json

{
  "telephoneNumber": "+12061234567",
  "reverseNumberLookupOptions": ["skipInternalVoip"],
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

HTTP/1.1 200 OK

Ejemplo 4: Borrar identificador de ubicación

Solicitud

En el ejemplo siguiente se muestra una solicitud de actualización locationId de un número de teléfono.

POST https://graph.microsoft.com/v1.0/admin/teams/telephoneNumberManagement/numberAssignments/updateNumber
Content-Type: application/json

{
  "telephoneNumber": "+12061234567",
  "locationId": "",
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

HTTP/1.1 200 OK
  • Last updated on