Obter dados de perfil

Artigo
09/14/2023

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

Ver também

Microsoft.Clm.Shared.Profiles.Profile class (Classe Microsoft.Clm.Shared.Profiles.Profiles.Profile)

Partilhar via