Compartir a través de

Crear solicitud

  • Artículo

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

Parámetros de dirección URL

Ninguno.

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

El cuerpo de la solicitud contiene las siguientes propiedades:

Propiedad Descripción
profiletemplateuuid Necesario. GUID de la plantilla de perfil para el que el usuario está creando la solicitud.
datacollection Necesario. Recopilación de pares nombre-valor que representan los datos que debe proporcionar el inscrito. La recopilación de datos necesarios que deben proporcionarse se puede recuperar a partir de la directiva de flujo de trabajo de la plantilla de perfil. Se puede especificar una recopilación vacía.
Destino 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.
type Necesario. El tipo de solicitud que se está creando. Entre los tipos de solicitud disponibles se incluyen "Inscribir", "Duplicar", "OfflineUnblock", "OnlineUpdate", "Renovar", "Recuperar", "RecoverOnBehalf", "Restablecer", "Retirar", "Revocar", "Revocaciones", "Tarjetas temporales" y "Desbloquear".

Nota: No todos los tipos de solicitud se admiten en todas las plantillas de perfil. Por ejemplo, no se puede especificar la operación Desbloquear en una plantilla de perfil de software.
comment Necesario. 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.
priority 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.

Response

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