Obter modelos de perfil

Artigo
09/14/2023

Obtém uma lista de modelos de perfil para os quais o utilizador especificado pode inscrever-se. Este método devolve uma vista limitada do modelo de perfil. Os dados do modelo de perfil devolvidos devem ser suficientes para permitir que o utilizador requerente decida para que modelo de perfil, se existir, tem de se inscrever. Se não forem especificados fluxos de trabalho e permissões, serão devolvidos todos os modelos de perfil visíveis para o utilizador.

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/profiletemplates? [targetuser]

Parâmetros de URL

Parâmetro	Description
targetuser	Opcional. Especifica o utilizador de destino para o qual pretende devolver modelos de perfil. Se não for especificado, é utilizada a identidade do utilizador atual. Nota: atualmente, apenas o utilizador atual é suportado.

Cabeçalhos do pedido

Para obter os cabeçalhos de pedidos comuns, veja Cabeçalhos de pedidos e respostas HTTP nos detalhes do serviço da API REST do 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
500	Erro Interno

Cabeçalhos de resposta

Para obter cabeçalhos de resposta comuns, veja Cabeçalhos de pedidos e respostas HTTP nos detalhes do serviço API REST do CM.

Corpo da resposta

Com êxito, devolve uma lista de objetos ProfileTemplateLimitedView com as seguintes propriedades:

Propriedade	Tipo	Descrição
Name	string	O nome a apresentar do modelo de perfil.
Description	cadeia (de carateres)	A descrição do modelo de perfil.
Uuid	GUID	O identificador do modelo de perfil.
IsSmartcardProfileTemplate	bool	Indica se o modelo é um modelo de perfil de smart card.
IsVirtualSmartcardProfileTemplate	bool	Indica se o modelo de perfil requer um smart card virtual.

Exemplo

Esta secção fornece um exemplo para obter a lista de modelos de perfil para o utilizador especificado.

Exemplo: Pedido

GET /certificatemanagement/api/v1.0/profiletemplates HTTP/1.1

Exemplo: Resposta

HTTP/1.1 200 OK

[
    {
        "Name":"FIM CM Sample Profile Template",
        "Description":"Description of the template goes here",
        "Uuid":"12bd5120-86a2-4ee1-8d05-131066871578",
        "IsSmartcardProfileTemplate":false,
        "IsVirtualSmartcardProfileTemplate":false
    },
    {
        "Name":"FIM CM Sample Smart Card Logon Profile Template",
        "Description":"Description of the template goes here",
        "Uuid":"2b7044cf-aa96-4911-b886-177947e9271b",
        "IsSmartcardProfileTemplate":true,
        "IsVirtualSmartcardProfileTemplate":false
    }
]

Partilhar via