Obter dados de perfil
Obtém uma lista de perfis de certificado de software para um utilizador. A lista inclui as possíveis operações que podem ser realizadas pelo utilizador atual. Em seguida, pode ser iniciado um pedido para qualquer uma das operações especificadas.
Importante
O servidor define o PIN apenas se a política de modelo de perfil indicar que deve ser feito. Caso contrário, o utilizador deve fornecer o PIN.
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/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 devolver. |
| requestId | O identificador do pedido para o qual pretende devolver os perfis. |
Parâmetros de consulta
| Parâmetro | Description |
|---|---|
| status | Opcional. Indica o estado dos perfis para os quais obter dados. Os tipos de estado possíveis são "Ativo", "Aprovado", "Cancelado", "Concluído", "Negado", "Execução", "Falhado", "Nenhum" e "Pendente". Se não for especificado nenhum estado, todos os perfis, independentemente do estado, serão devolvidos. |
Cabeçalhos do pedido
Para obter cabeçalhos de pedidos comuns, veja Cabeçalhos de pedidos HTTP e resposta nos detalhes do serviço da API REST de 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 HTTP e resposta nos detalhes do serviço da API REST de CM.
Corpo da resposta
Com êxito, devolve uma lista de objetos Microsoft.Clm.Shared.Profiles.Profile serializados por JSON com as seguintes propriedades:
| Propriedade | Descrição |
|---|---|
| AssignedUserUuid | O identificador do utilizador a quem o perfil está 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 realizadas pelo utilizador atual no perfil. |
| ProfileTemplateUuid | O identificador do modelo de perfil que contém as políticas e definições que regem o perfil. |
| ProfileTemplateVersion | A versão do modelo de perfil no momento em que o perfil foi criado. |
| Estado | O estado do perfil. |
| Uuid | O identificador do perfil. |
Exemplo
Esta secção fornece um exemplo para obter os dados de perfil de um utilizador.
Exemplo: Pedido
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"
]
}
]