Compartir a través de

Obtención de datos de perfil

Obtiene una lista de perfiles de certificado de software para un usuario. La lista incluye las posibles operaciones que puede realizar el usuario actual. Después, se puede iniciar una solicitud para cualquiera de las operaciones especificadas.

Importante

El servidor establece el PIN solo si la directiva de plantilla de perfil indica que debe realizarse. De lo contrario, el usuario debe proporcionar el PIN.

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/profiles
/CertificateManagement/api/v1.0/profiles/{id}
/CertificateManagement/api/v1.0/requests/{requestid}/profiles

Parámetros de dirección URL

Parámetro Descripción
identificación Identificador (GUID) del perfil que se va a devolver.
ID de solicitud Identificador de la solicitud para la que se devuelven los perfiles.

Parámetros de consulta

Parámetro Descripción
estado Opcional. Indica el estado de los perfiles para los que se van a recuperar los datos. Los tipos de estado posibles son "Active", "Approved", "Canceled", "Completed", "Denied", "Executing", "Failed", "None" y "Pending".
Si no se especifica ningún estado, se devuelven todos los perfiles, independientemente del estado.

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
403 Prohibido
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 Microsoft.Clm.Shared.Profiles.Profile con las siguientes propiedades:

Propiedad Descripción
AssignedUserUuid Identificador del usuario al que se asigna el perfil.
Comentario Comentario que describe el perfil.
Flags Marcas que describen el perfil.
ParentProfileUuid Identificador del perfil antiguo que ha reemplazado el perfil.
PrimaryProfileUuid Identificador del perfil principal.
ProfileOperations Lista de posibles operaciones que puede realizar el usuario actual en el perfil.
ProfileTemplateUuid Identificador de la plantilla de perfil que contiene las directivas y la configuración que rigen el perfil.
ProfileTemplateVersion Versión de la plantilla de perfil en el momento en que se creó el perfil.
Estado Estado del perfil.
Uuid Identificador del perfil.

Ejemplo

En esta sección se proporciona un ejemplo para obtener los datos de perfil de un usuario.

Ejemplo: solicitud

GET /certificatemanagement/api/v1.0/profiles?status=Active HTTP/1.1

Ejemplo: respuesta

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 también

  • Last updated on