Obter pedido

Obtém um ou mais pedidos de Microsoft Identity Manager (MIM) de Gestão de Certificados (CM).

Nota

Os URLs deste artigo são relativos ao nome de anfitrião escolhido durante a implantação da API, tais como https://api.contoso.com .

Pedir

Método URL do Pedido
GET /CertificadoManagement/api/v1.0/requests/{id}

Parâmetros de URL

Propriedade Descrição
ID Opcional. O GUID de um pedido de recuperação.

Parâmetros de consulta

Propriedade Descrição
targetuser Opcional. O utilizador-alvo do pedido. Se não for especificado nenhum alvo, todos os pedidos, independentemente do utilizador-alvo, serão devolvidos.

Nota:Apenas o valor "corrente" está atualmente suportado.
status Opcional. Indica o estado do pedido de recuperação. Os tipos de estado possíveis são "Aprovados", "Cancelados", "Concluídos", "Negados", "Executando", "Falhado", "Nenhum" e "Pendente".
Se não for especificado qualquer estado, todos os pedidos, independentemente do estado, serão devolvidos.

Cabeçalhos do pedido

Para cabeçalhos de pedido comuns, consulte os cabeçalhos de pedido e resposta HTTP nos dados do serviço cm REST API.

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 cabeçalhos de resposta comuns, consulte os cabeçalhos de pedido e resposta HTTP nos dados do serviço cm REST API.

Corpo da resposta

No sucesso, devolve um ou mais objetos de pedido com as seguintes propriedades:

Nome Descrição
Comentário O comentário que está associado ao pedido MIM CM.
Concluído O momento em que o pedido de cm MIM foi concluído.
DataCollection Os itens de recolha de dados associados ao pedido de cm MIM.
DataCollectionFlags As opções de recolha de dados para o pedido de cm MIM.
Sinalizadores As opções associadas ao pedido de cm MIM.
IsDataCollectionComplete Um valor Boolean que indica se a recolha de dados foi concluída para o pedido de CM MIM.
IsEnrollmentAgent Um valor Boolean que indica se um agente de inscrição é obrigado a executar o pedido de CM MIM.
IsSmartcard Um valor Boolean que indica se o pedido de CM MIM é um pedido de cartão inteligente ou um pedido de perfil de software.
NewProfileUuid A identidade do novo perfil de software que é produzido pelo pedido MIM CM.
NewSmartcardUuid A identidade do novo cartão inteligente que é atribuído pelo pedido MIM CM.
OldProfileUuid Foi criada a identidade do perfil de software para o qual foi criado o pedido de CM MIM.
OldSmartcarduuid Foi criada a identidade do cartão inteligente para o qual foi criado o pedido de CM MIM.
OriginatorUserUuid A identidade do utilizador que originou o pedido de cm MIM.
Prioridade A MIM prioridade do pedido cm.
ProfileTemplateUuid A identidade do modelo de perfil para o qual foi criado o pedido de CM MIM.
RequestType O tipo de pedido de CM MIM.
Descriturão de Segurança O descritor de segurança do pedido de cm MIM.
Estado O estado do pedido de MIM CM.
Submetido Foi apresentado o momento em que o pedido de cm MIM foi apresentado.
TargetUserUuid A identidade do utilizador-alvo para o pedido de MIM CM.
Uuid O identificador do pedido de cm MIM.

Exemplo

Esta secção fornece um exemplo para obter os pedidos de CM 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
}

Ver também