Compartilhar via

Criar tíquete

Descrição da API

Cria um novo pedido de suporte.

Atualmente, a adição de anexos não é suportada através da API. Para adicionar um ficheiro a um pedido de suporte existente, visite a página Pedidos de serviço no Microsoft Intune centro de administração.

A visualização e a adição de conteúdos a debates não são atualmente suportadas através da API.

Pré-requisitos

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
Delegated Não aplicável
Application MmdSupport.ReadWrite

Solicitação HTTP

POST https://mmdls.microsoft.com/support/odata/v1/tickets

Cabeçalhos de solicitação

Cabeçalho Valor
Autorização Portador {token} (Obrigatório)
Aceitar application/json

Corpo da solicitação

Não forneça um corpo de solicitação para esse método.

Propriedade Obrigatório Tipo Descrição
title Verdadeiro Cadeia de caracteres Breve descrição da pergunta ou problema.
description Verdadeiro Cadeia de caracteres Descrição detalhada.
type Verdadeiro TicketType Tipo de permissão.
category Verdadeiro TicketCategory Categoria de pedidos de suporte.
subcategoria Verdadeiro Cadeia de caracteres Subcategoria da permissão.
usersOrDevicesImpacted Int32 Número de utilizadores/dispositivos afetados.
businessImpact Cadeia de caracteres Descrever o impacto comercial
issueFirstNoticed Cadeia de caracteres Hora em que o problema foi notado pela primeira vez.
issueReproduced Booliano O problema é reproduzível em dispositivos não Geridos pela Microsoft.
endUserSupportEngaged Booliano O suporte do utilizador final foi interativado.
resolução de problemasPassos Cadeia de caracteres Descrição dos passos de remediação realizados.
voltar a processarPassos Cadeia de caracteres Passos para reproduzir o problema.
severity Verdadeiro Nível de Severidade Gravidade da permissão.
contact Verdadeiro CaseContact Objeto de contacto de caso.
givenName Verdadeiro Cadeia de caracteres Nome próprio.
surname Verdadeiro Cadeia de caracteres Apelido.m
email Verdadeiro Cadeia de caracteres Email endereço.
phoneNumber Verdadeiro Cadeia de caracteres Número do telefone.

Resposta

Se for bem-sucedido, este método devolve um código de resposta 200 OK e uma lista de dispositivos no corpo da resposta.

Exemplo 1: criar um pedido de suporte para pedir informações

Criar um pedido de pedido de suporte

Segue-se um exemplo do pedido HTTP.

POST https://mmdls.microsoft.com/support/odata/v1/tickets

Segue-se um exemplo do pedido JSON.

{ 
    "title": "Title", 
    "description": "Description of ticket", 
    "type": "RequestForInformation", 
    "category": "Devices", 
    "subcategory": "Hardware", 
    "severity": 4, 
    "contact": { 
        "givenName": "John", 
        "surname": "Doe", 
        "email": "jd@contoso.com", 
        "phoneNumber": "phone number"
    } 
}

Criar resposta de pedido de suporte

Segue-se um exemplo da resposta JSON.

{ 
    "@odata.context": "https://mmd-support-prod-nam.trafficmanager.net/odata/v1/$metadata#Tickets/$entity", 
    "title": "Title", 
    "description": "Description", 
    "isPartner": false, 
    "type": "RequestForInformation", 
    "category": "Devices", 
    "subcategory": "Hardware", 
    "compromiseIndicator": null, 
    "usersOrDevicesImpacted": null, 
    "relatedAlerts": null, 
    "businessImpact": null, 
    "issueFirstNoticed": null, 
    "issueReproduced": null, 
    "endUserSupportEngaged": null, 
    "troubleshootingSteps": null, 
    "nextActionOwner": "Microsoft", 
    "nextActionTime": null, 
    "reproSteps": null, 
    "id": "Ticket Number", 
    "severity": 4, 
    "state": "active", 
    "createdDateTime": "2021-12-14T04:28:18Z", 
    "resolvedDateTime": null, 
    "contact": { 
        "id": "Unique Id", 
        "givenName": "John", 
        "surname": "Doe", 
        "email": "jd@contoso.com", 
        "phoneNumber": "phone number", 
        "preferredLanguageId": "" 
    }, 
    "emails": [], 
    "attachments": [], 
    "notes": [] 
}

Exemplo 2: Criar um pedido de suporte para pedir uma alteração

Pedir uma alteração

Segue-se um exemplo do pedido HTTP.

POST https://mmdls.microsoft.com/support/odata/v1/tickets

Segue-se um exemplo do pedido JSON.

{ 
    "title": "Title", 
    "description": "Description of ticket", 
    "type": "ChangeRequest", 
    "category": "Devices", 
    "subcategory": " Deployment groups assignment", 
    "severity": 4, 
    "contact": { 
        "givenName": "John", 
        "surname": "Doe", 
        "email": "jd@contoso.com", 
        "phoneNumber": "phone number"
    } 
}

Pedir uma resposta de alteração

Segue-se um exemplo da resposta JSON.

{ 
    "@odata.context": "https://mmd-support-prod-nam.trafficmanager.net/odata/v1/$metadata#Tickets/$entity", 
    "title": "Title", 
    "description": "Description", 
    "isPartner": false, 
    "type": "ChangeRequest", 
    "category": "Devices", 
    "subcategory": " Deployment groups assignment", 
    "compromiseIndicator": null, 
    "usersOrDevicesImpacted": null, 
    "relatedAlerts": null, 
    "businessImpact": null, 
    "issueFirstNoticed": null, 
    "issueReproduced": null, 
    "endUserSupportEngaged": null, 
    "troubleshootingSteps": null, 
    "nextActionOwner": "Microsoft", 
    "nextActionTime": null, 
    "reproSteps": null, 
    "id": "Ticket Number", 
    "severity": 4, 
    "state": "active", 
    "createdDateTime": "2021-12-14T04:28:18Z", 
    "resolvedDateTime": null, 
    "contact": { 
        "id": "Unique Id", 
        "givenName": "John", 
        "surname": "Doe", 
        "email": "jd@contoso.com", 
        "phoneNumber": "phone number", 
        "preferredLanguageId": "" 
    }, 
    "emails": [], 
    "attachments": [], 
    "notes": [] 
}

Exemplo 3: Criar um pedido de suporte para um incidente

Pedido de pedido de suporte a incidentes

Segue-se um exemplo do pedido HTTP:

POST https://mmdls.microsoft.com/support/odata/v1/tickets

Segue-se um exemplo do pedido JSON:

{ 
    "title": "Title", 
    "description": "Description of ticket", 
    "type": "Incident", 
    "category": "Devices", 
    "subcategory": "Configuration/Policy", 
    "usersOrDevicesImpacted": 100, 
    "businessImpact": "Business Impact", 
    "issueFirstNoticed": "2021-10-06T07:00:00Z", 
    "issueReproduced": true, 
    "endUserSupportEngaged": true, 
    "troubleshootingSteps": "Describe any troubleshooting steps performed.", 
    "severity": 4, 
    "contact": { 
        "givenName": "John", 
        "surname": "Doe", 
        "email": "jd@contoso.com", 
        "phoneNumber": "+1 888" 
    } 
}

Resposta a pedido de suporte a incidentes

Segue-se um exemplo da resposta JSON.

{ 
    "@odata.context": "https://mmd-support-prod-nam.trafficmanager.net/odata/v1/$metadata#Tickets/$entity", 
    "title": "Title", 
    "description": "Description", 
    "isPartner": true, 
    "type": "Incident", 
    "category": "Devices", 
    "subcategory": "Configuration/Policy", 
    "compromiseIndicator": null, 
    "usersOrDevicesImpacted": 100, 
    "relatedAlerts": null, 
    "businessImpact": "Business Impact", 
    "issueFirstNoticed": "2021-10-06T07:00:00Z", 
    "issueReproduced": true, 
    "endUserSupportEngaged": true, 
    "troubleshootingSteps": "Describe any troubleshooting steps performed.", 
    "nextActionOwner": "Microsoft", 
    "nextActionTime": null, 
    "reproSteps": null, 
    "id": "Ticket Number", 
    "severity": 4, 
    "state": "active", 
    "createdDateTime": "2021-12-14T04:28:18Z", 
    "resolvedDateTime": null, 
    "contact": { 
        "id": "Unique Id", 
        "givenName": "John", 
        "surname": "Doe", 
        "email": "jd@contoso.com", 
        "phoneNumber": "phone number", 
        "preferredLanguageId": "" 
    }, 
    "emails": [], 
    "attachments": [], 
    "notes": [] 
}