Criar solicitação

Artigo
09/14/2023

Crie uma solicitação de GERENCIAMENTO de Certificados (CM) 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
POST	/CertificateManagement/api/v1.0/requests

Parâmetros de URL

Nenhum.

Cabeçalhos da solicitação

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

Corpo da solicitação

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

Propriedade	Descrição
profiletemplateuuid	Obrigatórios. O GUID do modelo de perfil para o qual o usuário está criando a solicitação.
datacollection	Obrigatórios. Uma coleção de pares de nome-valor representando os dados que devem ser fornecidos pelo registrando. 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 será criada. Se não for especificado, o destino usará como padrão o usuário atual.
tipo	Obrigatórios. O tipo de solicitação que está sendo criada. Os tipos de solicitação disponíveis incluem "Registrar", "Duplicar", "OfflineUnblock", "OnlineUpdate", "Renew", "Recover", "RecoverOnBehalf", "Reinstate", "Retire", "Revoke", "TemporaryCards" e "Unblock". 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.
comentário	Obrigatórios. 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.
priority	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 cabeçalhos de resposta comuns, consulte Cabeçalhos de solicitação e resposta HTTP nos detalhes do serviço da API REST do CM.

Corpo da resposta

Em caso de sucesso, retorna o URI da 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"
}

Compartilhar via