Cancelar, abandonar ou concluir uma solicitação
Marque uma solicitação de GERENCIAMENTO de Certificados (CM) do MIM (Microsoft Identity Manager) como concluída, cancelada ou abandonada.
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 |
---|---|
PUT | /CertificateManagement/api/v1.0/requests/{id} |
Parâmetros de URL
Propriedade | Descrição |
---|---|
id | Obrigatórios. O GUID da solicitação a concluir. |
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 |
---|---|
status | O status para o qual definir a solicitação. Os valores possíveis são "Concluído", "Cancelado" ou "Abandonado". |
Resposta
Esta seção descreve a resposta.
Códigos de resposta
Código | Descrição |
---|---|
200 | OK |
204 | Sem conteúdo |
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 êxito, retorna um objeto Microsoft.Clm.Shared.Requests.Request . O objeto descreve a solicitação do MIM CM que foi marcada como concluída. O objeto contém as seguintes propriedades:
Nome | Descrição |
---|---|
Comentário | O comentário associado à solicitação de MIM CM. |
Concluído | A hora em que a solicitação do MIM CMM foi concluída. |
DataCollection | Os itens de coleta de dados associados à solicitação do MIM CM. |
DataCollectionFlags | As opções de coleta de dados para a solicitação de MIM CM. |
Flags | As opções associadas à solicitação de MIM CM. |
IsDataCollectionComplete | Um valor booliano que indica se a coleta de dados foi concluída para a solicitação de MIM CM. |
IsEnrollmentAgent | Um valor booliano que indica se um agente de registro é necessário para executar a solicitação de MIM CM. |
IsSmartcard | Um valor booliano que indica se a solicitação de MIM CM é uma solicitação de cartão inteligente ou uma solicitação de perfil de software. |
NewProfileUuid | A identidade do novo perfil de software produzida pela solicitação de MIM CM. |
NewSmartcardUuid | A identidade do novo cartão inteligente atribuído pela solicitação de MIM CM. |
OldProfileUuid | A identidade do perfil de software para o qual a solicitação de MIM CM foi criada. |
OldSmartcardUuid | A identidade do cartão inteligente para o qual a solicitação de MIM CM foi criada. |
OriginatorUserUuid | A identidade do usuário que originou a solicitação MIM CM. |
Prioridade | A prioridade da solicitação de MIM CM. |
ProfileTemplateUuid | A identidade do modelo de perfil para o qual a solicitação de MIM CM foi criada. |
RequestType | O tipo de solicitação de MIM CM. |
SecurityDescriptor | O descritor de segurança para a solicitação de MIM CM. |
Status | O status da solicitação de MIM CM. |
Enviado | A hora em que a solicitação de MIM CMM foi enviada. |
TargetUserUuid | A identidade do usuário de destino para a solicitação de MIM CM. |
Uuid | O identificador para a solicitação de MIM CM. |
Exemplo
Esta seção fornece um exemplo para marcar uma solicitação como concluída.
Exemplo: Solicitação
PUT /certificatemanagement/api/v1.0/requests/a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099 HTTP/1.1
{
"status":"Completed"
}
Exemplo: resposta
HTTP/1.1 200 OK
{
"Uuid":"a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099",
"RequestType":1,
"Status":8,
"Flags":2,
"DataCollection":[
],
"DataCollectionFlags":32,
"OriginatorUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
"TargetUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
"Submitted":"2015-07-07T23:36:21.93Z",
"Completed":"2015-07-07T23:37:37.767Z",
"NewProfileUuid":"b99ff38c-6653-471f-ae3c-325bb351a6bc",
"OldProfileUuid":"00000000-0000-0000-0000-000000000000",
"NewSmartcardUuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
"OldSmartcardUuid":"00000000-0000-0000-0000-000000000000",
"Priority":0,
"Comment":"",
"ProfileTemplateUuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
"SecurityDescriptor":"O:S-1-5-21-2127521184-1604012920-1887927527-14134865D:(D;;LC;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-5094533)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-5094534)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-5219125)(A;;SWRC;;;S-1-5-21-2127521184-1604012920-1887927527-5094533)(A;;RC;;;WD)(A;;CCDCLCSWSDRC;;;S-1-5-21-2127521184-1604012920-1887927527-14134865)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)(A;;CCDCSW;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000",
"IsSmartcard":true,
"IsEnrollmentAgent":false,
"IsDataCollectionComplete":false
}