Obter dados de perfil

Artigo
09/14/2023

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. Então pode ser iniciada uma solicitação para qualquer uma das operações especificadas.

Importante

O servidor define o PIN somente se a política de modelo de perfil indicar que ele deve ser feito. 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
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 para retornar.
requestId	O identificador da solicitação para o qual retornar os perfis.

Parâmetros de consulta

Parâmetro	Descrição
status	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 da solicitação

Para cabeçalhos de solicitação comuns, consulte Cabeçalhos de solicitação e resposta HTTP nos detalhes do serviço da API REST do CM.

Corpo da solicitação

Nenhum.

Resposta

Esta seçã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 Cabeçalhos de solicitação e resposta HTTP nos detalhes do serviço da API REST do CM.

Corpo da resposta

Em caso de êxito, retorna uma lista de objetos Microsoft.Clm.Shared.Profiles.Profile serializados em 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.
Flags	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 as configurações que controlam o perfil.
ProfileTemplateVersion	A versão do modelo de perfil no momento em que o perfil foi criado.
Status	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"
        ]
    }
]

Confira também

Classe Microsoft.Clm.Shared.Profiles.Profile

Compartilhar via