Compartilhar via

Criar microsoftTunnelServer

  • 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 microsoftTunnelServer .

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/{microsoftTunnelSiteId}/microsoftTunnelServers

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 microsoftTunnelServer.

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

Propriedade Tipo Descrição
id Cadeia de caracteres O identificador exclusivo do servidor gerido. Este ID é atribuído no momento do registo. Suportes: $filter, $select, $top, $skip $orderby. $search não é suportado. Somente leitura.
displayName Cadeia de caracteres O nome a apresentar do servidor. É o mesmo que o nome do anfitrião durante o registo e pode ser alterado mais tarde. Suportes: $filter, $select, $top, $skip $orderby. $search não é suportado. O comprimento máximo permitido é de 200 carateres.
tunnelServerHealthStatus microsoftTunnelServerHealthStatus Indica o Estado de funcionamento do servidor a partir da hora da última avaliação. O estado de funcionamento é avaliado a cada 60 segundos e os valores possíveis são: desconhecido, em bom estado de funcionamento, mau estado de funcionamento, aviso, offline, upgradeInProgress, upgradeFailed. Suportes: $filter, $select, $top, $skip $orderby. $search não é suportado. Somente leitura. Os valores possíveis são: unknown, healthy, unhealthy, warning, offline, upgradeInProgress, upgradeFailed, unknownFutureValue.
lastCheckinDateTime DateTimeOffset Indica quando o servidor deu entrada pela última vez. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite em UTC no dia 1º de janeiro de 2014 teria esta aparência: '2014-01-01T00:00:00Z'. Suportes: $filter, $select, $top, $skip $orderby. $search não é suportado como Só de leitura.
agentImageDigest Cadeia de caracteres O resumo da imagem atual do agente em execução neste servidor. Suportes: $filter, $select, $top, $skip $orderby. $search não é suportado. Somente leitura.
serverImageDigest Cadeia de caracteres O resumo da imagem do servidor atual em execução neste servidor. Suportes: $filter, $select, $top, $skip $orderby. $search não é suportado. Somente leitura.
deploymentMode microsoftTunnelDeploymentMode Modo de implementação do servidor do Microsoft Tunnel. O valor é definido quando o servidor é registado. Os valores possíveis são standaloneRootful, standaloneRootless, podRootful, podRootless. Valor predefinido: standaloneRootful. Suportes: $filter, $select, $top, $skip $orderby. $search não é suportado. Somente leitura. Os valores possíveis são: standaloneRootful, standaloneRootless, podRootful, podRootless, unknownFutureValue.

Resposta

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

Exemplo

Solicitação

Este é um exemplo da solicitação.

POST https://graph.microsoft.com/beta/deviceManagement/microsoftTunnelSites/{microsoftTunnelSiteId}/microsoftTunnelServers
Content-type: application/json
Content-length: 355

{
  "@odata.type": "#microsoft.graph.microsoftTunnelServer",
  "displayName": "Display Name value",
  "tunnelServerHealthStatus": "healthy",
  "lastCheckinDateTime": "2017-01-01T00:02:46.0431416-08:00",
  "agentImageDigest": "Agent Image Digest value",
  "serverImageDigest": "Server Image Digest value",
  "deploymentMode": "standaloneRootless"
}

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: 404

{
  "@odata.type": "#microsoft.graph.microsoftTunnelServer",
  "id": "b5cf0aee-0aee-b5cf-ee0a-cfb5ee0acfb5",
  "displayName": "Display Name value",
  "tunnelServerHealthStatus": "healthy",
  "lastCheckinDateTime": "2017-01-01T00:02:46.0431416-08:00",
  "agentImageDigest": "Agent Image Digest value",
  "serverImageDigest": "Server Image Digest value",
  "deploymentMode": "standaloneRootless"
}