Obter pedido
Obtém um ou mais pedidos de Gestão de Certificados (CM) de Microsoft Identity Manager (MIM) especificados.
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 |
|---|---|
| GET | /CertificateManagement/api/v1.0/requests/{id} |
Parâmetros de URL
| Propriedade | Descrição |
|---|---|
| ID | Opcional. O GUID de um pedido a obter. |
Parâmetros de consulta
| Propriedade | Descrição |
|---|---|
| targetuser | Opcional. O utilizador de destino do pedido. Se não for especificado nenhum destino, todos os pedidos, independentemente do utilizador de destino, são devolvidos. Nota: apenas o valor "atual" é atualmente suportado. |
| status | Opcional. Indica o estado do pedido a obter. Os tipos de estado possíveis são "Aprovado", "Cancelado", "Concluído", "Negado", "A Executar", "Falhado", "Nenhum" e "Pendente". Se não for especificado nenhum estado, todos os pedidos, independentemente do estado, são devolvidos. |
Cabeçalhos do pedido
Para obter os cabeçalhos de pedidos comuns, veja Cabeçalhos de pedidos e respostas HTTP nos detalhes do serviço da API REST do CM.
Corpo do pedido
Nenhum.
Resposta
Esta secçã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 obter cabeçalhos de resposta comuns, veja Cabeçalhos de pedidos e respostas HTTP nos detalhes do serviço API REST do CM.
Corpo da resposta
Com êxito, devolve um ou mais objetos de Pedido com as seguintes propriedades:
| Nome | Descrição |
|---|---|
| Comentário | O comentário associado ao pedido cm do MIM. |
| Concluído | A hora em que o pedido CM do MIM foi concluído. |
| DataCollection | Os itens de recolha de dados que estão associados ao pedido CM do MIM. |
| DataCollectionFlags | As opções de recolha de dados para o pedido CM do MIM. |
| Sinalizadores | As opções que estão associadas ao pedido CM do MIM. |
| IsDataCollectionComplete | Um valor booleano que indica se a recolha de dados foi concluída para o pedido CM do MIM. |
| IsEnrollmentAgent | Um valor booleano que indica se é necessário um agente de inscrição para executar o pedido CM do MIM. |
| IsSmartcard | Um valor booleano que indica se o pedido CM do MIM é um pedido de smart card ou um pedido de perfil de software. |
| NewProfileUuid | A identidade do novo perfil de software produzido pelo pedido CM do MIM. |
| NewSmartcardUuid | A identidade do novo smart card que é atribuído pelo pedido CM do MIM. |
| OldProfileUuid | A identidade do perfil de software para o qual o pedido CM do MIM foi criado. |
| OldSmartcardUuid | A identidade do smart card para o qual o pedido CM do MIM foi criado. |
| OriginatorUserUuid | A identidade do utilizador que originou o pedido CM do MIM. |
| Prioridade | A prioridade do pedido CM do MIM. |
| ProfileTemplateUuid | A identidade do modelo de perfil para o qual o pedido CM do MIM foi criado. |
| RequestType | O tipo do pedido CM do MIM. |
| SecurityDescriptor | O descritor de segurança do pedido CM do MIM. |
| Estado | O estado do pedido CM do MIM. |
| Submetido | A hora em que o pedido CM do MIM foi submetido. |
| TargetUserUuid | A identidade do utilizador de destino para o pedido CM do MIM. |
| Uuid | O identificador do pedido CM do MIM. |
Exemplo
Esta secção fornece um exemplo para obter os pedidos de CM do MIM especificados.
Exemplo: Pedido 1
GET /certificatemanagement/api/v1.0/requests/a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099 HTTP/1.1
Exemplo: Resposta 1
HTTP/1.1 200 OK
{
"Uuid":"a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099",
"RequestType":1,
"Status":3,
"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":"0001-01-01T00:00:00",
"NewProfileUuid":"00000000-0000-0000-0000-000000000000",
"OldProfileUuid":"00000000-0000-0000-0000-000000000000",
"NewSmartcardUuid":"00000000-0000-0000-0000-000000000000",
"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
}
Exemplo: Pedido 2
GET /certificatemanagement/api/v1.0/requests/0c96d73f-967b-420e-854a-43ad2a1504bc HTTP/1.1
Exemplo: Resposta 2
HTTP/1.1 200 OK
{
"Uuid":"0c96d73f-967b-420e-854a-43ad2a1504bc",
"RequestType":5,
"Status":3,
"Flags":2,
"DataCollection":[
{
"Name":"Sample Data Item",
"Value":null
}
],
"DataCollectionFlags":32,
"OriginatorUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
"TargetUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
"Submitted":"2015-07-07T23:40:33.133Z",
"Completed":"0001-01-01T00:00:00",
"NewProfileUuid":"b99ff38c-6653-471f-ae3c-325bb351a6bc",
"OldProfileUuid":"b99ff38c-6653-471f-ae3c-325bb351a6bc",
"NewSmartcardUuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
"OldSmartcardUuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
"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;;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",
"IsSmartcard":true,
"IsEnrollmentAgent":false,
"IsDataCollectionComplete":false
}