Compartir a través de

Crear solicitud

Cree una solicitud de administración de certificados (CM) de Microsoft Identity Manager (MIM).

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
PUBLICAR /CertificateManagement/api/v1.0/requests

Parámetros de dirección URL

Ninguno.

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

El cuerpo de la solicitud contiene las siguientes propiedades:

Propiedad Descripción
profiletemplateuuid Obligatorio. GUID de la plantilla de perfil para la que el usuario está creando la solicitud.
datacollection Obligatorio. Colección de pares de nombre-valor que representa los datos que va a proporcionar el inscribido. La colección de datos necesarios que se deben proporcionar se puede recuperar de la directiva de flujo de trabajo de la plantilla de perfil. Se puede especificar una colección vacía.
objetivo Opcional. GUID del usuario de destino para el que se va a crear la solicitud. Si no se especifica, el destino tiene como valor predeterminado el usuario actual.
tipo Obligatorio. Tipo de solicitud que se está creando. Los tipos de solicitud disponibles incluyen "Inscribir", "Duplicar", "OfflineUnblock", "OnlineUpdate", "Renovar", "Recuperar", "RecoverOnBehalf", "Restablecer", "Retirar", "Revocar", "Revocar", "Tarjetas temporales" y "Desbloquear".

Nota: no todos los tipos de solicitud se admiten en todas las plantillas de perfil. Por ejemplo, no puede especificar la operación Desbloquear en una plantilla de perfil de software.
comentario Obligatorio. Cualquier comentario que pueda escribir el usuario. La directiva de flujo de trabajo define si la propiedad comment es necesaria. Se puede especificar una cadena vacía.
prioridad Opcional. Prioridad de la solicitud. Si no se especifica, se usa la prioridad de solicitud predeterminada, determinada por la configuración de la plantilla de perfil.

Respuesta

En esta sección se describe la respuesta.

Códigos de respuesta

Código Descripción
201 Creado
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 el URI de la solicitud recién creada.

Ejemplo

En esta sección se proporciona un ejemplo para crear solicitudes de inscripción y desbloqueo.

Ejemplo: Solicitud 1

POST /CertificateManagement/api/v1.0/requests HTTP/1.1

{
    "datacollection":"[]",
    "type":"Enroll",
    "profiletemplateuuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
    "comment":""
}

Ejemplo: Respuesta 1

HTTP/1.1 201 Created

"api/v1.0/requests/a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099"

Ejemplo: Solicitud 2

POST /CertificateManagement/api/v1.0/requests HTTP/1.1

{  
    "datacollection":"[]",
    "type":"Unblock",
    "smartcard":"17cf063d-e337-4aa9-a822-346554ddd3c9",
    "comment":""
}

Ejemplo: Respuesta 2

HTTP/1.1 201 Created

"api/v1.0/requests/0c96d73f-967b-420e-854a-43ad2a1504bc"

Ejemplo: Solicitud 3

POST /CertificateManagement/api/v1.0/requests HTTP/1.1

{
    "profiletemplateuuid" : "97CD65FA-AF4B-4587-9309-0DD6BFD8B4E1",
    "datacollection":
    [
        {"name" : "pavle"},
        {"city" : "seattle"}
    ],
    "target" : "97CC3493-F556-4C9B-9D8B-982434201527",
    "type" : "Enroll",
    "comment" : "LALALALA",
    "priority" :  "4"
}

Consulte también