Obter dados de perfil
Obtém uma lista de perfis de certificado de software para um usuário. A lista inclui as possíveis operações que podem ser executadas pelo usuário atual. Em seguida, uma solicitação pode ser iniciada para qualquer uma das operações especificadas.
Importante
O servidor define o PIN somente se a política de modelo de perfil indicar que ela deve ser feita. Caso contrário, o usuário deverá fornecer o PIN.
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/profiles /CertificateManagement/api/v1.0/profiles/{id} /CertificateManagement/api/v1.0/requests/{requestid}/profiles |
Parâmetros de URL
Parâmetro | Descrição |
---|---|
id | O identificador (GUID) do perfil a ser retornado. |
requestId | O identificador da solicitação para a qual retornar os perfis. |
Parâmetros de consulta
Parâmetro | Descrição |
---|---|
estado | Opcional. Indica o status dos perfis para os quais recuperar dados. Os tipos de status possíveis são "Ativo", "Aprovado", "Cancelado", "Concluído", "Negado", "Executando", "Com Falha", "Nenhum" e "Pendente". Se nenhum status for especificado, todos os perfis, independentemente do status, serão retornados. |
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 uma lista de objetos microsoft.Clm.Shared.Profiles.Profile serial izados por JSON com as seguintes propriedades:
Propriedade | Descrição |
---|---|
AssignedUserUuid | O identificador do usuário ao qual o perfil é atribuído. |
Comentário | O comentário que descreve o perfil. |
Sinalizadores | Os sinalizadores que descrevem o perfil. |
ParentProfileUuid | O identificador do perfil antigo que o perfil substituiu. |
PrimaryProfileUuid | O identificador do perfil primário. |
ProfileOperations | A lista de possíveis operações que podem ser executadas pelo usuário atual no perfil. |
ProfileTemplateUuid | O identificador do modelo de perfil que contém as políticas e configurações que regem o perfil. |
ProfileTemplateVersion | A versão do modelo de perfil no momento em que o perfil foi criado. |
Situação | O status do perfil. |
Uuid | O identificador do perfil. |
Exemplo
Esta seção fornece um exemplo para obter os dados de perfil de um usuário.
Exemplo: Solicitação
GET /certificatemanagement/api/v1.0/profiles?status=Active HTTP/1.1
Exemplo: Resposta
HTTP/1.1 200 OK
[
{
"Uuid":"c0dd5c7d-ec35-4346-baca-3ad711e9722f",
"Status":2,
"Flags":1,
"ParentProfileUuid":"1c9e2606-fea2-4048-a6ac-b014e54c22df",
"PrimaryProfileUuid":"00000000-0000-0000-0000-000000000000",
"AssignedUserUuid":"0378a33b-8650-4713-a727-efd233903643",
"ProfileTemplateUuid":"8f31803f-8afc-49bb-911d-402ec264b589",
"ProfileTemplateVersion":8,
"Comment":"",
"ProfileOperations":[
"renew",
"disable",
"recover"
]
},
{
"Uuid":"5ad77b40-aa42-4533-9396-c9c59fd021a8",
"Status":2,
"Flags":1,
"ParentProfileUuid":"00000000-0000-0000-0000-000000000000",
"PrimaryProfileUuid":"00000000-0000-0000-0000-000000000000",
"AssignedUserUuid":"0378a33b-8650-4713-a727-efd233903643",
"ProfileTemplateUuid":"8f31803f-8afc-49bb-911d-402ec264b589",
"ProfileTemplateVersion":8,
"Comment":"",
"ProfileOperations":[
"renew",
"disable",
"recover"
]
},
{
"Uuid":"ff342953-c444-4dc7-b144-f5515d6460c6",
"Status":2,
"Flags":1,
"ParentProfileUuid":"00000000-0000-0000-0000-000000000000",
"PrimaryProfileUuid":"00000000-0000-0000-0000-000000000000",
"AssignedUserUuid":"0378a33b-8650-4713-a727-efd233903643",
"ProfileTemplateUuid":"1e3a31fe-699b-4a6b-945c-18b83c985bc1",
"ProfileTemplateVersion":9,
"Comment":"",
"ProfileOperations":[
"renew",
"disable"
]
}
]