Compartir a través de


Obtener plantillas de perfil

Obtiene una lista de plantillas de perfil para las que el usuario especificado puede inscribirse. Este método devuelve una vista limitada de la plantilla de perfil. Los datos de plantilla de perfil devueltos deben ser suficientes para permitir que el usuario solicitante decida qué plantilla de perfil, si existe, debe inscribirse. Si no se especifica ningún flujo de trabajo y permiso, se devuelven todas las plantillas de perfil visibles para el usuario.

Nota:

Las direcciones URL de este artículo son relativas al nombre de host elegido durante la implementación de la API, como https://api.contoso.com.

Solicitud

Método URL de solicitud
OBTÉN /CertificateManagement/api/v1.0/profiletemplates? [targetuser]

Parámetros de dirección URL

Parámetro Descripción
targetuser Opcional. Especifica el usuario de destino para el que se devuelven las plantillas de perfil. Si no se especifica, se usa la identidad del usuario actual.

Nota: actualmente, solo se admite el usuario actual.

Encabezados de solicitud

Para obtener encabezados de solicitud comunes, consulte encabezados de solicitud y respuesta HTTP en detalles del servicio de API REST de CM.

Cuerpo de la solicitud

Ninguno.

Respuesta

En esta sección se describe la respuesta.

Códigos de respuesta

Código Descripción
200 De acuerdo
204 Sin contenido
500 Error interno

Encabezados de respuesta

Para obtener encabezados de respuesta comunes, consulte encabezados de solicitud y respuesta HTTP en detalles del servicio de API REST de CM.

Cuerpo de la respuesta

Si se ejecuta correctamente, devuelve una lista de objetos ProfileTemplateLimitedView con las siguientes propiedades:

Propiedad Tipo Descripción
Nombre cuerda / cadena Nombre para mostrar de la plantilla de perfil.
Descripción cuerda / cadena Descripción de la plantilla de perfil.
Uuid GUID Identificador de la plantilla de perfil.
IsSmartcardProfileTemplate bool Indica si la plantilla es una plantilla de perfil de tarjeta inteligente.
IsVirtualSmartcardProfileTemplate bool Indica si la plantilla de perfil requiere una tarjeta inteligente virtual.

Ejemplo

En esta sección se proporciona un ejemplo para obtener la lista de plantillas de perfil para el usuario especificado.

Ejemplo: solicitud

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

Ejemplo: respuesta

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