Criar pedido

Artigo
09/14/2023

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

Nota

Os URLs neste artigo são relativos ao nome do anfitrião escolhido durante a implementação da API, como https://api.contoso.com.

Pedir

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

Parâmetros de URL

Nenhum.

Cabeçalhos do pedido

Para obter cabeçalhos de pedidos comuns, veja Cabeçalhos de pedidos HTTP e resposta nos detalhes do serviço da API REST de CM.

Corpo do pedido

O corpo do pedido contém as seguintes propriedades:

Propriedade	Descrição
profiletemplateuuid	Obrigatório. O GUID do modelo de perfil para o qual o utilizador está a criar o pedido.
datacollection	Obrigatório. Uma coleção de pares name-value que representam os dados que serão fornecidos pelo inscrito. A recolha de dados necessários que têm de ser fornecidos pode ser obtida a partir da política de fluxo de trabalho do modelo de perfil. Pode especificar uma coleção vazia.
destino	Opcional. O GUID do utilizador de destino para o qual o pedido deve ser criado. Se não for especificado, o destino é predefinido para o utilizador atual.
tipo	Obrigatório. O tipo de pedido que está a ser criado. Os tipos de pedido disponíveis incluem "Enroll", "Duplicate", "OfflineUnblock", "OnlineUpdate", "Renew", "Recover", "RecoverOnBehalf", "Reinstate", "Retire", "Revoke", "TemporaryCards" e "Unblock". Nota: nem todos os tipos de pedido são suportados em todos os modelos de perfil. Por exemplo, não pode especificar a operação Desbloquear 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. Pode especificar uma cadeia vazia.
prioridade	Opcional. A prioridade do pedido. Se não for especificado, é utilizada a prioridade do pedido predefinido, conforme determinado 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 obter cabeçalhos de resposta comuns, veja Cabeçalhos de pedidos HTTP e resposta nos detalhes do serviço da API REST de CM.

Corpo da resposta

Com êxito, devolve o URI do pedido criado recentemente.

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"
}

Partilhar via