Compartilhar via


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"
        ]
    }
]

Consulte também