Compartilhar via

Criar solicitação

Crie uma solicitação de CM (Gerenciamento de Certificados) do MIM (Microsoft Identity Manager).

Observação

As URLs neste artigo são relativas ao nome do host escolhido durante a implantação da API, como https://api.contoso.com.

Solicitação

Método URL da solicitação
PUBLICAR /CertificateManagement/api/v1.0/requests

Parâmetros de URL

Nenhum.

Cabeçalhos de solicitação

Para obter cabeçalhos de solicitação comuns, consulte cabeçalhos de solicitação HTTP e de resposta nos detalhes do serviço da API REST CM.

Corpo da solicitação

O corpo da solicitação contém as seguintes propriedades:

Propriedade Descrição
profiletemplateuuid Obrigatório O GUID do modelo de perfil para o qual o usuário está criando a solicitação.
datacollection Obrigatório Uma coleção de pares nome-valor que representa os dados que devem ser fornecidos pelo registrador. A coleção 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.
destino Opcional. O GUID do usuário de destino para o qual a solicitação deve ser criada. Se não for especificado, o destino será o padrão para o usuário atual.
tipo Obrigatório O tipo de solicitação que está sendo criada. Os tipos de solicitação disponíveis incluem "Registrar", "Duplicar", "OfflineUnblock", "OnlineUpdate", "Renovar", "Recuperar", "RecoverOnBehalf", "Reintegrar", "Aposentar", "Revogar", "Cartões Temporários" e "Desbloquear".

Observação: nem todos os tipos de solicitação têm suporte em todos os modelos de perfil. Por exemplo, você não pode especificar a operação Desbloquear em um modelo de perfil de software.
comment Obrigatório Quaisquer comentários que possam ser inseridos pelo usuário. A política de fluxo de trabalho define se a propriedade de comentário é necessária. Uma cadeia de caracteres vazia pode ser especificada.
prioridade Opcional. A prioridade da solicitação. Se não for especificado, a prioridade de solicitação padrão, conforme determinado pelas configurações do modelo de perfil, será usada.

Resposta

Esta seçã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, consulte cabeçalhos de solicitação e resposta HTTP em detalhes do serviço da API REST do CM.

Corpo da resposta

Com êxito, retorna o URI para a solicitação recém-criada.

Exemplo

Esta seção fornece um exemplo para criar solicitações de registro e desbloqueio.

Exemplo: Solicitação 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: Solicitação 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: Solicitação 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"
}

Consulte também

  • Last updated on