Criar pedido

Criar um pedido de Microsoft Identity Manager (MIM) de Gestão de Certificados (CM).

Nota

Os URLs deste artigo são relativos ao nome de anfitrião escolhido durante a implantação da API, tais como https://api.contoso.com .

Pedir

Método URL do Pedido
POST /CertificadosManagement/api/v1.0/requests

Parâmetros de URL

Nenhum.

Cabeçalhos do pedido

Para cabeçalhos de pedido comuns, consulte os cabeçalhos de pedido e resposta HTTP nos dados do serviço cm REST API.

Corpo do pedido

O organismo de pedido contém as seguintes propriedades:

Propriedade Descrição
profiletemplateuid Obrigatório. O GUID do modelo de perfil que o utilizador está a criar o pedido.
recolha de dados Obrigatório. Uma recolha de pares de valor-nome que representam os dados que devem ser fornecidos pela inscrição. A recolha de dados necessários que devem ser fornecidos pode ser recuperada da política de fluxo de trabalho do modelo de perfil. Uma coleção vazia pode ser especificada.
alvo Opcional. O GUIA do utilizador-alvo para o qual o pedido deve ser criado. Se não for especificado, o alvo é padrão para o utilizador atual.
tipo Obrigatório. O tipo de pedido que está a ser criado. Os tipos de pedidos disponíveis incluem "Matriculado", "Duplicado", "OfflineUnblock", "OnlineUpdate", "Renovar", "Recuperar", "Recuperar Metade", "Reintegrar", "Aposentar", "Revogar", "Cartões Temporários" e "Desbloquear".

Nota: Nem todos os tipos de pedidos são suportados em todos os modelos de perfil. Por exemplo, não é possível especificar a operação Desbloqueio num modelo de perfil de software.
comentário Obrigatório. Quaisquer comentários que possam ser introduzidos pelo utilizador. A política de fluxo de trabalho define se a propriedade de comentário é necessária. Uma corda vazia pode ser especificada.
prioridade Opcional. A prioridade do pedido. Se não for especificado, é utilizada a prioridade de pedido por defeito, determinada pelas definições do modelo de perfil.

Resposta

Esta secção descreve a resposta.

Códigos de resposta

Código Descrição
201 Criado
403 Proibido
500 Erro Interno

Cabeçalhos de resposta

Para cabeçalhos de resposta comuns, consulte os cabeçalhos de pedido e resposta HTTP nos dados do serviço cm REST API.

Corpo da resposta

No sucesso, devolve o URI para o pedido recém-criado.

Exemplo

Esta secção fornece um exemplo para criar pedidos de inscrição e desbloqueio.

Exemplo: Pedido 1

POST /CertificateManagement/api/v1.0/requests HTTP/1.1

{
    "datacollection":"[]",
    "type":"Enroll",
    "profiletemplateuuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
    "comment":""
}

Exemplo: Resposta 1

HTTP/1.1 201 Created

"api/v1.0/requests/a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099"

Exemplo: Pedido 2

POST /CertificateManagement/api/v1.0/requests HTTP/1.1

{  
    "datacollection":"[]",
    "type":"Unblock",
    "smartcard":"17cf063d-e337-4aa9-a822-346554ddd3c9",
    "comment":""
}

Exemplo: Resposta 2

HTTP/1.1 201 Created

"api/v1.0/requests/0c96d73f-967b-420e-854a-43ad2a1504bc"

Exemplo: Pedido 3

POST /CertificateManagement/api/v1.0/requests HTTP/1.1

{
    "profiletemplateuuid" : "97CD65FA-AF4B-4587-9309-0DD6BFD8B4E1",
    "datacollection":
    [
        {"name" : "pavle"},
        {"city" : "seattle"}
    ],
    "target" : "97CC3493-F556-4C9B-9D8B-982434201527",
    "type" : "Enroll",
    "comment" : "LALALALA",
    "priority" :  "4"
}

Ver também