Atribuir encaminhamentoProfile
Namespace: microsoft.graph.networkaccess
Importante
As APIs na versão /beta
no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Atribua um perfil de encaminhamento a uma rede remota existente. Para criar uma rede remota com o perfil de encaminhamento de tráfego, consulte Criar remoteNetwork.
Essa API está disponível nas seguintes implantações nacionais de nuvem.
Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Permissões
Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas 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ão menos privilegiada | Permissões privilegiadas mais altas |
---|---|---|
Delegado (conta corporativa ou de estudante) | Sem suporte. | Sem suporte. |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Aplicativo | Sem suporte. | Sem suporte. |
Para fazer alterações, o usuário de chamada também deve receber pelo menos uma das seguintes funções de Microsoft Entra.
- Administrador global de acesso seguro
- Administrador de Segurança
Solicitação HTTP
PATCH /networkAccess/connectivity/remoteNetworks/{remoteNetworkId}/forwardingProfiles
Cabeçalhos de solicitação
Nome | Descrição |
---|---|
Autorização | {token} de portador. Obrigatório. |
Content-Type | application/json. Obrigatório. |
Corpo da solicitação
No corpo da solicitação, forneça uma representação JSON do objeto microsoft.graph.networkaccess.forwardingProfile .
Você pode especificar as propriedades a seguir ao associar um encaminhamentoProfile a uma rede remota.
Propriedade | Tipo | Descrição |
---|---|---|
id | Cadeia de caracteres | ID do perfil de encaminhamento. Herdado de microsoft.graph.networkaccess.profile. Obrigatório. |
Resposta
Se tiver êxito, este método retornará um código de resposta OK 200
.
Exemplos
Para obter a ID de perfis de encaminhamento da sua organização, consulte este artigo – Encaminhar listaProfiles.
Solicitação
O exemplo a seguir mostra uma solicitação.
PATCH https://graph.microsoft.com/beta/networkAccess/connectivity/remoteNetworks/{remoteNetworkId}/forwardingProfiles
Content-Type: application/json
{
"@context": "#$delta",
"value": [
{
"id": "1adaf535-1e31-4e14-983f-2270408162bf"
}
]
}
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de