Cancelar, abandonar ou concluir um pedido

Artigo
09/14/2023

Marque um pedido de Gestão de Certificados (CM) Microsoft Identity Manager (MIM) como concluído, cancelado ou abandonado.

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

Parâmetros de URL

Propriedade	Descrição
ID	Obrigatório. O GUID do pedido a concluir.

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

O corpo do pedido contém as seguintes propriedades:

Propriedade	Descrição
status	O estado para definir o pedido como. Os valores possíveis são "Concluído", "Cancelado" ou "Abandonado".

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

Após o êxito, devolve um objeto Microsoft.Clm.Shared.Requests.Request . O objeto descreve o pedido CM do MIM que foi marcado como concluído. O objeto contém 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 marcar um pedido como concluído.

Exemplo: Pedido

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
}

Partilhar via