Compartilhar via

Solicitação GET

Obtém uma ou mais solicitações de CM (Gerenciamento de Certificados) do Microsoft Identity Manager (MIM) especificadas.

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
Conseguir /CertificateManagement/api/v1.0/requests/{id}

Parâmetros de URL

Propriedade Descrição
id Opcional. O GUID de uma solicitação a ser recuperada.

Parâmetros de consulta

Propriedade Descrição
targetuser Opcional. O usuário de destino da solicitação. Se nenhum destino for especificado, todas as solicitações, independentemente do usuário de destino, serão retornadas.

Observação: há suporte apenas para o valor "atual".
estado Opcional. Indica o status da solicitação a ser recuperada. Os tipos de status possíveis são "Aprovado", "Cancelado", "Concluído", "Negado", "Executando", "Com Falha", "Nenhum" e "Pendente".
Se nenhum status for especificado, todas as solicitações, independentemente do status, serão retornadas.

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

Nenhum.

Resposta

Esta seção descreve a resposta.

Códigos de resposta

Código Descrição
200 OKEY
204 Nenhum conteúdo
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 um ou mais objetos Request com as seguintes propriedades:

Nome Descrição
Comentário O comentário associado à solicitação MIM CM.
Concluído A hora em que a solicitação do MIM CM foi concluída.
DataCollection Os itens de coleta de dados associados à solicitação MIM CM.
DataCollectionFlags As opções de coleta de dados para a solicitação do MIM CM.
Sinalizadores As opções associadas à solicitação MIM CM.
IsDataCollectionComplete Um valor booliano que indica se a coleta de dados foi concluída para a solicitação do MIM CM.
IsEnrollmentAgent Um valor booliano que indica se um agente de registro é necessário para executar a solicitação do MIM CM.
IsSmartcard Um valor booliano que indica se a solicitação 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 produzido pela solicitação MIM CM.
NewSmartcardUuid A identidade do novo cartão inteligente atribuído pela solicitação MIM CM.
OldProfileUuid A identidade do perfil de software para o qual a solicitação MIM CM foi criada.
OldSmartcardUuid A identidade do cartão inteligente para o qual a solicitação MIM CM foi criada.
OriginatorUserUuid A identidade do usuário que originou a solicitação MIM CM.
Prioridade A prioridade da solicitação do MIM CM.
ProfileTemplateUuid A identidade do modelo de perfil para o qual a solicitação MIM CM foi criada.
RequestType O tipo da solicitação do MIM CM.
SecurityDescriptor O descritor de segurança para a solicitação MIM CM.
Situação O status da solicitação do MIM CM.
Enviado A hora em que a solicitação do MIM CM foi enviada.
TargetUserUuid A identidade do usuário de destino para a solicitação MIM CM.
Uuid O identificador para a solicitação do MIM CM.

Exemplo

Esta seção fornece um exemplo para obter as solicitações de CM do MIM especificadas.

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

Consulte também

  • Last updated on