Obter modelos de perfil

Artigo
09/14/2023

Obtém uma lista de modelos de perfil para os quais o usuário especificado pode se registrar. Esse método retorna uma exibição limitada do modelo de perfil. Os dados do modelo de perfil retornados devem ser suficientes para permitir que o usuário solicitante decida para qual modelo de perfil, se houver, ele precisa se registrar. Se nenhum fluxo de trabalho e permissão forem especificados, todos os modelos de perfil visíveis para o usuário serão retornados.

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

Parâmetros de URL

Parâmetro	Descrição
targetuser	Opcional. Especifica o usuário de destino para o qual retornar os modelos de perfil. Se não for especificado, a identidade do usuário atual será usada. Observação: atualmente, apenas o usuário atual tem suporte.

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
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 ProfileTemplateLimitedView com as seguintes propriedades:

Propriedade	Tipo	Descrição
Nome	cadeia de caracteres	O nome de exibição do modelo de perfil.
Descrição	string	A descrição para o modelo de perfil.
Uuid	Guid	O identificador para o modelo de perfil.
IsSmartcardProfileTemplate	bool	Indica se o modelo é um modelo de perfil de cartão inteligente.
IsVirtualSmartcardProfileTemplate	bool	Indica se o modelo de perfil requer um cartão inteligente virtual.

Exemplo

Esta seção fornece um exemplo para obter a lista de modelos de perfil para o usuário especificado.

Exemplo: Solicitação

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

Compartilhar via