Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Obtiene una o varias solicitudes de Administración de certificados (CM) de Microsoft Identity Manager (MIM) especificadas.
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/requests/{id} |
Parámetros de dirección URL
| Propiedad | Descripción |
|---|---|
| identificación | Opcional. GUID de una solicitud que se va a recuperar. |
Parámetros de consulta
| Propiedad | Descripción |
|---|---|
| targetuser | Opcional. Usuario de destino de la solicitud. Si no se especifica ningún destino, se devuelven todas las solicitudes, independientemente del usuario de destino. Nota: actualmente solo se admite el valor "actual". |
| estado | Opcional. Indica el estado de la solicitud que se va a recuperar. Los tipos de estado posibles son "Aprobado", "Cancelado", "Completado", "Denegado", "En ejecución", "Error", "Ninguno" y "Pendiente". Si no se especifica ningún estado, se devuelven todas las solicitudes, 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 uno o varios objetos Request con las siguientes propiedades:
| Nombre | Descripción |
|---|---|
| Comentario | Comentario asociado a la solicitud de MIM CM. |
| Completado | Hora en que se completó la solicitud de MIM CM. |
| DataCollection | Los elementos de recopilación de datos asociados a la solicitud de MIM CM. |
| DataCollectionFlags | Las opciones de recopilación de datos para la solicitud de MIM CM. |
| Flags | Las opciones asociadas a la solicitud de MIM CM. |
| IsDataCollectionComplete | Valor booleano que indica si la recopilación de datos se ha completado para la solicitud de MIM CM. |
| IsEnrollmentAgent | Valor booleano que indica si se requiere un agente de inscripción para ejecutar la solicitud de MIM CM. |
| IsSmartcard | Valor booleano que indica si la solicitud de MIM CM es una solicitud de tarjeta inteligente o una solicitud de perfil de software. |
| NewProfileUuid | Identidad del nuevo perfil de software generado por la solicitud de MIM CM. |
| NewSmartcardUuid | Identidad de la nueva tarjeta inteligente asignada por la solicitud de MIM CM. |
| OldProfileUuid | Identidad del perfil de software para el que se creó la solicitud de MIM CM. |
| OldSmartcardUuid | Identidad de la tarjeta inteligente para la que se creó la solicitud de MIM CM. |
| OriginorUserUuid | Identidad del usuario que originó la solicitud de MIM CM. |
| Prioridad | Prioridad de la solicitud de MIM CM. |
| ProfileTemplateUuid | Identidad de la plantilla de perfil para la que se creó la solicitud de MIM CM. |
| RequestType | Tipo de la solicitud de MIM CM. |
| SecurityDescriptor | Descriptor de seguridad de la solicitud de MIM CM. |
| Estado | Estado de la solicitud de MIM CM. |
| Presentado | Hora en que se envió la solicitud de MIM CM. |
| TargetUserUuid | Identidad del usuario de destino para la solicitud de MIM CM. |
| Uuid | Identificador de la solicitud de MIM CM. |
Ejemplo
En esta sección se proporciona un ejemplo para obtener las solicitudes de MIM CM especificadas.
Ejemplo: Solicitud 1
GET /certificatemanagement/api/v1.0/requests/a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099 HTTP/1.1
Ejemplo: Respuesta 1
HTTP/1.1 200 OK
{
"Uuid":"a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099",
"RequestType":1,
"Status":3,
"Flags":2,
"DataCollection":[
],
"DataCollectionFlags":32,
"OriginatorUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
"TargetUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
"Submitted":"2015-07-07T23:36:21.93Z",
"Completed":"0001-01-01T00:00:00",
"NewProfileUuid":"00000000-0000-0000-0000-000000000000",
"OldProfileUuid":"00000000-0000-0000-0000-000000000000",
"NewSmartcardUuid":"00000000-0000-0000-0000-000000000000",
"OldSmartcardUuid":"00000000-0000-0000-0000-000000000000",
"Priority":0,
"Comment":"",
"ProfileTemplateUuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
"SecurityDescriptor":"O:S-1-5-21-2127521184-1604012920-1887927527-14134865D:(D;;LC;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-5094533)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-5094534)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-5219125)(A;;SWRC;;;S-1-5-21-2127521184-1604012920-1887927527-5094533)(A;;RC;;;WD)(A;;CCDCLCSWSDRC;;;S-1-5-21-2127521184-1604012920-1887927527-14134865)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)(A;;CCDCSW;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000",
"IsSmartcard":true,
"IsEnrollmentAgent":false,
"IsDataCollectionComplete":false
}
Ejemplo: Solicitud 2
GET /certificatemanagement/api/v1.0/requests/0c96d73f-967b-420e-854a-43ad2a1504bc HTTP/1.1
Ejemplo: Respuesta 2
HTTP/1.1 200 OK
{
"Uuid":"0c96d73f-967b-420e-854a-43ad2a1504bc",
"RequestType":5,
"Status":3,
"Flags":2,
"DataCollection":[
{
"Name":"Sample Data Item",
"Value":null
}
],
"DataCollectionFlags":32,
"OriginatorUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
"TargetUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
"Submitted":"2015-07-07T23:40:33.133Z",
"Completed":"0001-01-01T00:00:00",
"NewProfileUuid":"b99ff38c-6653-471f-ae3c-325bb351a6bc",
"OldProfileUuid":"b99ff38c-6653-471f-ae3c-325bb351a6bc",
"NewSmartcardUuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
"OldSmartcardUuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
"Priority":0,
"Comment":"",
"ProfileTemplateUuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
"SecurityDescriptor":"O:S-1-5-21-2127521184-1604012920-1887927527-14134865D:(D;;LC;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)(A;;SWRC;;;S-1-5-21-2127521184-1604012920-1887927527-5094533)(A;;RC;;;WD)(A;;CCDCLCSWSDRC;;;S-1-5-21-2127521184-1604012920-1887927527-14134865)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)(A;;CCDCSW;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)\u0000\u0000\u0000\u0000\u0000\u0000",
"IsSmartcard":true,
"IsEnrollmentAgent":false,
"IsDataCollectionComplete":false
}