Compartilhar via

Criar microsoftTunnelSite

  • Artigo

Namespace: microsoft.graph

Importante: As APIs do Microsoft Graph na versão /beta estão sujeitas a alterações; a utilização de produção não é suportada.

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.

Crie um novo objeto microsoftTunnelSite .

Esta API está disponível nas seguintes implementações de cloud nacionais.

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

Permissões

Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante) DeviceManagementConfiguration.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte.
Application DeviceManagementConfiguration.ReadWrite.All

Solicitação HTTP

POST /deviceManagement/microsoftTunnelSites

Cabeçalhos de solicitação

Cabeçalho Valor
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Aceitar application/json

Corpo da solicitação

No corpo do pedido, forneça uma representação JSON para o objeto microsoftTunnelSite.

A tabela seguinte mostra as propriedades necessárias quando cria o microsoftTunnelSite.

Propriedade Tipo Descrição
id Cadeia de caracteres O identificador exclusivo do ID do site. $Insert, $skip $top não é suportado. Somente leitura.
displayName Cadeia de caracteres O nome a apresentar do site. Esta propriedade é necessária quando um site é criado.
description Cadeia de caracteres Descrição do site (opcional)
publicAddress Cadeia de caracteres O nome de domínio público ou endereço IP do site
upgradeWindowUtcOffsetInMinutes Int32 O fuso horário do site representado como um desvio de minutos da UTC
upgradeWindowStartTime TimeOfDay Hora de início do dia da janela de atualização do site
upgradeWindowEndTime TimeOfDay Hora de fim do dia da janela de atualização do site
upgradeAutomaticamente Booliano A definição de atualização automática do site. Verdadeiro para atualizações automáticas, falso para controlo manual
atualização Disponível Booliano O site fornece o estado de quando uma atualização está disponível
internalNetworkProbeUrl Cadeia de caracteres URL da Pesquisa de Acesso à Rede Interna do site
roleScopeTagIds Coleção de cadeias de caracteres Lista de Etiquetas de Âmbito para esta instância de Entidade

Resposta

Se for bem-sucedido, este método devolve um 201 Created código de resposta e um objeto microsoftTunnelSite no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

POST https://graph.microsoft.com/beta/deviceManagement/microsoftTunnelSites
Content-type: application/json
Content-length: 524

{
  "@odata.type": "#microsoft.graph.microsoftTunnelSite",
  "displayName": "Display Name value",
  "description": "Description value",
  "publicAddress": "Public Address value",
  "upgradeWindowUtcOffsetInMinutes": 15,
  "upgradeWindowStartTime": "12:01:27.3030000",
  "upgradeWindowEndTime": "11:57:17.9830000",
  "upgradeAutomatically": true,
  "upgradeAvailable": true,
  "internalNetworkProbeUrl": "https://example.com/internalNetworkProbeUrl/",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ]
}

Resposta

Veja a seguir um exemplo da resposta. Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão. Todas as propriedades serão retornadas de uma chamada real.

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 573

{
  "@odata.type": "#microsoft.graph.microsoftTunnelSite",
  "id": "b2f7dc3e-dc3e-b2f7-3edc-f7b23edcf7b2",
  "displayName": "Display Name value",
  "description": "Description value",
  "publicAddress": "Public Address value",
  "upgradeWindowUtcOffsetInMinutes": 15,
  "upgradeWindowStartTime": "12:01:27.3030000",
  "upgradeWindowEndTime": "11:57:17.9830000",
  "upgradeAutomatically": true,
  "upgradeAvailable": true,
  "internalNetworkProbeUrl": "https://example.com/internalNetworkProbeUrl/",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ]
}