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 |
|---|---|
| GET | /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 |
|---|---|
| id | Identificador (GUID) del perfil que se va a devolver. |
| requestId | Identificador de la solicitud a la que se van a devolver los perfiles. |
Parámetros de consulta
| Parámetro | Descripción |
|---|---|
| status | 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 ver los encabezados de solicitud comunes, consulte Encabezados de solicitud y respuesta HTTP en los detalles del servicio de LA API REST de CM.
Cuerpo de la solicitud
Ninguno.
Response
En esta sección se describe la respuesta.
Códigos de respuesta
| Código | Descripción |
|---|---|
| 200 | Aceptar |
| 204 | Sin contenido |
| 403 | Prohibido |
| 500 | Error interno |
Encabezados de respuesta
Para ver los encabezados de respuesta comunes, consulte Encabezados de solicitud y respuesta HTTP en los detalles del servicio de LA API REST de CM.
Response body
Si se ejecuta correctamente, devuelve una lista de objetos JSON serializados Microsoft.Clm.Shared.Profiles.Profile con las siguientes propiedades:
| Propiedad | Descripción |
|---|---|
| AssignedUserUuid | Identificador del usuario al que está asignado el perfil. |
| Comentario | Comentario que describe el perfil. |
| Marcas | Marcas que describen el perfil. |
| ParentProfileUuid | Identificador del perfil antiguo al que ha reemplazado el perfil. |
| PrimaryProfileUuid | Identificador del perfil principal. |
| ProfileOperations | Lista de las operaciones posibles que el usuario actual puede realizar 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"
]
}
]