numberAssignment: updateNumber

Namespace: microsoft.graph.teamsAdministration

Esse método é usado para atualizar um número existente com atributos opcionais. Os atributos com suporte no momento são locationId, networkSiteIde reverseNumberLookupOptions.

Essa API está disponível nas seguintes implantações de nuvem nacional.

Serviço global	Governo dos EUA L4	US Government L5 (DOD)	China operada pela 21Vianet
✅	❌	❌	❌

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão	Permissões menos privilegiadas	Permissões com privilégios mais elevados
Delegado (conta corporativa ou de estudante)	TeamsTelephoneNumber.ReadWrite.All	Indisponível.
Delegado (conta pessoal da Microsoft)	Sem suporte.	Sem suporte.
Application	TeamsTelephoneNumber.ReadWrite.All	Indisponível.

Solicitação HTTP

POST /admin/teams/telephoneNumberManagement/numberAssignments/updateNumber

Cabeçalhos de solicitação

Nome	Descrição
Autorização	{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type	application/json. Obrigatório.

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON dos parâmetros.

A tabela a seguir lista os parâmetros necessários quando você chama essa ação.

Parâmetro	Tipo	Descrição
telephoneNumber	Cadeia de caracteres	Obrigatório. O número de telefone que se pretende atribuir.
locationId	Cadeia de caracteres	Indica o identificador de endereço de emergência definido no número de telefone. Passar uma cadeia de caracteres vazia limpa o locationId, enquanto passar `null` ou não incluir o campo preserva o valor existente.
networkSiteId	Cadeia de caracteres	Indica o networkSiteId atualizado. Use uma cadeia de caracteres vazia para limpar o networkSiteId existente ou use `null`/omite o campo para preservar o valor existente.
reverseNumberLookupOptions	String collection	Esse parâmetro é usado para controlar o comportamento da RNL (pesquisa inversa de número) de um número de telefone. Quando o RNL contém `skipInternalVoip`, uma chamada interna para esse número de telefone não tenta passar pelo VoIP interno por meio da pesquisa reversa de número no Microsoft Teams. Em vez disso, a chamada é estabelecida por meio da conectividade PSTN (Rede Telefônica Pública Comutada) externa diretamente.

Resposta

Se tiver êxito, este método retornará um código de resposta 200 OK.

Exemplos

Exemplo 1: atualizar ID de localização

Solicitação

O exemplo a seguir mostra uma solicitação de atualização locationId de um número de telefone.

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

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


// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Admin.Teams.TelephoneNumberManagement.NumberAssignments.MicrosoftGraphTeamsAdministrationUpdateNumber;

var requestBody = new UpdateNumberPostRequestBody
{
	TelephoneNumber = "+12061234567",
	LocationId = "93cb8a70-b4af-41df-9928-d07607e21776",
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Admin.Teams.TelephoneNumberManagement.NumberAssignments.MicrosoftGraphTeamsAdministrationUpdateNumber.PostAsync(requestBody);



// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  graphadmin "github.com/microsoftgraph/msgraph-sdk-go/admin"
	  //other-imports
)

requestBody := graphadmin.NewUpdateNumberPostRequestBody()
telephoneNumber := "+12061234567"
requestBody.SetTelephoneNumber(&telephoneNumber) 
locationId := "93cb8a70-b4af-41df-9928-d07607e21776"
requestBody.SetLocationId(&locationId) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.Admin().Teams().TelephoneNumberManagement().NumberAssignments().MicrosoftGraphTeamsAdministrationUpdateNumber().Post(context.Background(), requestBody, nil)


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

com.microsoft.graph.admin.teams.telephonenumbermanagement.numberassignments.microsoftgraphteamsadministrationupdatenumber.UpdateNumberPostRequestBody updateNumberPostRequestBody = new com.microsoft.graph.admin.teams.telephonenumbermanagement.numberassignments.microsoftgraphteamsadministrationupdatenumber.UpdateNumberPostRequestBody();
updateNumberPostRequestBody.setTelephoneNumber("+12061234567");
updateNumberPostRequestBody.setLocationId("93cb8a70-b4af-41df-9928-d07607e21776");
graphClient.admin().teams().telephoneNumberManagement().numberAssignments().microsoftGraphTeamsAdministrationUpdateNumber().post(updateNumberPostRequestBody);


const options = {
	authProvider,
};

const client = Client.init(options);

const updateNumber = {
  telephoneNumber: '+12061234567',
  locationId: '93cb8a70-b4af-41df-9928-d07607e21776',
};

await client.api('/admin/teams/telephoneNumberManagement/numberAssignments/updateNumber')
	.post(updateNumber);


<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Admin\Teams\TelephoneNumberManagement\NumberAssignments\MicrosoftGraphTeamsAdministrationUpdateNumber\UpdateNumberPostRequestBody;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new UpdateNumberPostRequestBody();
$requestBody->setTelephoneNumber('+12061234567');
$requestBody->setLocationId('93cb8a70-b4af-41df-9928-d07607e21776');

$graphServiceClient->admin()->teams()->telephoneNumberManagement()->numberAssignments()->microsoftGraphTeamsAdministrationUpdateNumber()->post($requestBody)->wait();


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.admin.teams.telephonenumbermanagement.numberassignments.microsoft_graph_teams_administration_update_number.update_number_post_request_body import UpdateNumberPostRequestBody
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = UpdateNumberPostRequestBody(
	telephone_number = "+12061234567",
	location_id = "93cb8a70-b4af-41df-9928-d07607e21776",
)

await graph_client.admin.teams.telephone_number_management.number_assignments.microsoft_graph_teams_administration_update_number.post(request_body)

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 200 OK

Exemplo 2: atualizar a ID do site de rede

Solicitação

O exemplo a seguir mostra uma solicitação de atualização networkSiteId de um número de telefone.

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

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


// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Admin.Teams.TelephoneNumberManagement.NumberAssignments.MicrosoftGraphTeamsAdministrationUpdateNumber;

var requestBody = new UpdateNumberPostRequestBody
{
	TelephoneNumber = "+12061234567",
	NetworkSiteId = "fff21455-0f84-4a6b-babd-0a9b46971a62",
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Admin.Teams.TelephoneNumberManagement.NumberAssignments.MicrosoftGraphTeamsAdministrationUpdateNumber.PostAsync(requestBody);



// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  graphadmin "github.com/microsoftgraph/msgraph-sdk-go/admin"
	  //other-imports
)

requestBody := graphadmin.NewUpdateNumberPostRequestBody()
telephoneNumber := "+12061234567"
requestBody.SetTelephoneNumber(&telephoneNumber) 
networkSiteId := "fff21455-0f84-4a6b-babd-0a9b46971a62"
requestBody.SetNetworkSiteId(&networkSiteId) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.Admin().Teams().TelephoneNumberManagement().NumberAssignments().MicrosoftGraphTeamsAdministrationUpdateNumber().Post(context.Background(), requestBody, nil)


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

com.microsoft.graph.admin.teams.telephonenumbermanagement.numberassignments.microsoftgraphteamsadministrationupdatenumber.UpdateNumberPostRequestBody updateNumberPostRequestBody = new com.microsoft.graph.admin.teams.telephonenumbermanagement.numberassignments.microsoftgraphteamsadministrationupdatenumber.UpdateNumberPostRequestBody();
updateNumberPostRequestBody.setTelephoneNumber("+12061234567");
updateNumberPostRequestBody.setNetworkSiteId("fff21455-0f84-4a6b-babd-0a9b46971a62");
graphClient.admin().teams().telephoneNumberManagement().numberAssignments().microsoftGraphTeamsAdministrationUpdateNumber().post(updateNumberPostRequestBody);


const options = {
	authProvider,
};

const client = Client.init(options);

const updateNumber = {
  telephoneNumber: '+12061234567',
  networkSiteId: 'fff21455-0f84-4a6b-babd-0a9b46971a62',
};

await client.api('/admin/teams/telephoneNumberManagement/numberAssignments/updateNumber')
	.post(updateNumber);


<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Admin\Teams\TelephoneNumberManagement\NumberAssignments\MicrosoftGraphTeamsAdministrationUpdateNumber\UpdateNumberPostRequestBody;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new UpdateNumberPostRequestBody();
$requestBody->setTelephoneNumber('+12061234567');
$requestBody->setNetworkSiteId('fff21455-0f84-4a6b-babd-0a9b46971a62');

$graphServiceClient->admin()->teams()->telephoneNumberManagement()->numberAssignments()->microsoftGraphTeamsAdministrationUpdateNumber()->post($requestBody)->wait();


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.admin.teams.telephonenumbermanagement.numberassignments.microsoft_graph_teams_administration_update_number.update_number_post_request_body import UpdateNumberPostRequestBody
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = UpdateNumberPostRequestBody(
	telephone_number = "+12061234567",
	network_site_id = "fff21455-0f84-4a6b-babd-0a9b46971a62",
)

await graph_client.admin.teams.telephone_number_management.number_assignments.microsoft_graph_teams_administration_update_number.post(request_body)

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 200 OK

Exemplo 3: atualizar opções de pesquisa inversa de número

Solicitação

O exemplo a seguir mostra uma solicitação de atualização reverseNumberLookupOptions do número de telefone associado à conta de recurso.

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

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


// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Admin.Teams.TelephoneNumberManagement.NumberAssignments.MicrosoftGraphTeamsAdministrationUpdateNumber;

var requestBody = new UpdateNumberPostRequestBody
{
	TelephoneNumber = "+12061234567",
	ReverseNumberLookupOptions = new List<string>
	{
		"skipInternalVoip",
	},
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Admin.Teams.TelephoneNumberManagement.NumberAssignments.MicrosoftGraphTeamsAdministrationUpdateNumber.PostAsync(requestBody);



// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  graphadmin "github.com/microsoftgraph/msgraph-sdk-go/admin"
	  //other-imports
)

requestBody := graphadmin.NewUpdateNumberPostRequestBody()
telephoneNumber := "+12061234567"
requestBody.SetTelephoneNumber(&telephoneNumber) 
reverseNumberLookupOptions := []string {
	"skipInternalVoip",
}
requestBody.SetReverseNumberLookupOptions(reverseNumberLookupOptions)

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.Admin().Teams().TelephoneNumberManagement().NumberAssignments().MicrosoftGraphTeamsAdministrationUpdateNumber().Post(context.Background(), requestBody, nil)


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

com.microsoft.graph.admin.teams.telephonenumbermanagement.numberassignments.microsoftgraphteamsadministrationupdatenumber.UpdateNumberPostRequestBody updateNumberPostRequestBody = new com.microsoft.graph.admin.teams.telephonenumbermanagement.numberassignments.microsoftgraphteamsadministrationupdatenumber.UpdateNumberPostRequestBody();
updateNumberPostRequestBody.setTelephoneNumber("+12061234567");
LinkedList<String> reverseNumberLookupOptions = new LinkedList<String>();
reverseNumberLookupOptions.add("skipInternalVoip");
updateNumberPostRequestBody.setReverseNumberLookupOptions(reverseNumberLookupOptions);
graphClient.admin().teams().telephoneNumberManagement().numberAssignments().microsoftGraphTeamsAdministrationUpdateNumber().post(updateNumberPostRequestBody);


const options = {
	authProvider,
};

const client = Client.init(options);

const updateNumber = {
  telephoneNumber: '+12061234567',
  reverseNumberLookupOptions: ['skipInternalVoip'],
};

await client.api('/admin/teams/telephoneNumberManagement/numberAssignments/updateNumber')
	.post(updateNumber);


<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Admin\Teams\TelephoneNumberManagement\NumberAssignments\MicrosoftGraphTeamsAdministrationUpdateNumber\UpdateNumberPostRequestBody;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new UpdateNumberPostRequestBody();
$requestBody->setTelephoneNumber('+12061234567');
$requestBody->setReverseNumberLookupOptions(['skipInternalVoip', 	]);

$graphServiceClient->admin()->teams()->telephoneNumberManagement()->numberAssignments()->microsoftGraphTeamsAdministrationUpdateNumber()->post($requestBody)->wait();


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.admin.teams.telephonenumbermanagement.numberassignments.microsoft_graph_teams_administration_update_number.update_number_post_request_body import UpdateNumberPostRequestBody
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = UpdateNumberPostRequestBody(
	telephone_number = "+12061234567",
	reverse_number_lookup_options = [
		"skipInternalVoip",
	],
)

await graph_client.admin.teams.telephone_number_management.number_assignments.microsoft_graph_teams_administration_update_number.post(request_body)

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 200 OK

Exemplo 4: limpar ID de localização

Solicitação

O exemplo a seguir mostra uma solicitação de atualização locationId de um número de telefone.

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

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


// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Admin.Teams.TelephoneNumberManagement.NumberAssignments.MicrosoftGraphTeamsAdministrationUpdateNumber;

var requestBody = new UpdateNumberPostRequestBody
{
	TelephoneNumber = "+12061234567",
	LocationId = "",
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Admin.Teams.TelephoneNumberManagement.NumberAssignments.MicrosoftGraphTeamsAdministrationUpdateNumber.PostAsync(requestBody);



// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  graphadmin "github.com/microsoftgraph/msgraph-sdk-go/admin"
	  //other-imports
)

requestBody := graphadmin.NewUpdateNumberPostRequestBody()
telephoneNumber := "+12061234567"
requestBody.SetTelephoneNumber(&telephoneNumber) 
locationId := ""
requestBody.SetLocationId(&locationId) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.Admin().Teams().TelephoneNumberManagement().NumberAssignments().MicrosoftGraphTeamsAdministrationUpdateNumber().Post(context.Background(), requestBody, nil)


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

com.microsoft.graph.admin.teams.telephonenumbermanagement.numberassignments.microsoftgraphteamsadministrationupdatenumber.UpdateNumberPostRequestBody updateNumberPostRequestBody = new com.microsoft.graph.admin.teams.telephonenumbermanagement.numberassignments.microsoftgraphteamsadministrationupdatenumber.UpdateNumberPostRequestBody();
updateNumberPostRequestBody.setTelephoneNumber("+12061234567");
updateNumberPostRequestBody.setLocationId("");
graphClient.admin().teams().telephoneNumberManagement().numberAssignments().microsoftGraphTeamsAdministrationUpdateNumber().post(updateNumberPostRequestBody);


const options = {
	authProvider,
};

const client = Client.init(options);

const updateNumber = {
  telephoneNumber: '+12061234567',
  locationId: '',
};

await client.api('/admin/teams/telephoneNumberManagement/numberAssignments/updateNumber')
	.post(updateNumber);


<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Admin\Teams\TelephoneNumberManagement\NumberAssignments\MicrosoftGraphTeamsAdministrationUpdateNumber\UpdateNumberPostRequestBody;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new UpdateNumberPostRequestBody();
$requestBody->setTelephoneNumber('+12061234567');
$requestBody->setLocationId('');

$graphServiceClient->admin()->teams()->telephoneNumberManagement()->numberAssignments()->microsoftGraphTeamsAdministrationUpdateNumber()->post($requestBody)->wait();


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.admin.teams.telephonenumbermanagement.numberassignments.microsoft_graph_teams_administration_update_number.update_number_post_request_body import UpdateNumberPostRequestBody
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = UpdateNumberPostRequestBody(
	telephone_number = "+12061234567",
	location_id = "",
)

await graph_client.admin.teams.telephone_number_management.number_assignments.microsoft_graph_teams_administration_update_number.post(request_body)

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 200 OK

Comentários

Esta página foi útil?

Last updated on 2026-08-24

numberAssignment: updateNumber

Permissões

Solicitação HTTP

Cabeçalhos de solicitação

Corpo da solicitação

Resposta

Exemplos

Exemplo 1: atualizar ID de localização

Solicitação

Resposta

Exemplo 2: atualizar a ID do site de rede

Solicitação

Resposta

Exemplo 3: atualizar opções de pesquisa inversa de número

Solicitação

Resposta

Exemplo 4: limpar ID de localização

Solicitação

Resposta

Comentários

Recursos adicionais