Compartir a través de

Actualizar el estado de la tarjeta inteligente

Actualiza el estado de una tarjeta inteligente.

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/{reqid}/smartcards/{scid}

Parámetros de dirección URL

Parámetro Descripción
reqid Obligatorio. Identificador de solicitud específico de Administración de certificados (CM) de Microsoft Identity Manager (MIM).
scid Obligatorio. Identificador de tarjeta inteligente específico de MIM CM. El valor corresponde al campo "uuid" del objeto Microsoft.Clm.Shared.Smartcards.Smartcard.

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
estado Estado en el que se va a establecer la solicitud, como "Retirado".

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 un objeto JSON-Serialized Microsoft.Clm.Shared.Smartcards.Smartcard con las siguientes propiedades:

Nombre Descripción
AssignedUserUuid Identificador del usuario al que se asigna la tarjeta inteligente.
Atr Cadena de respuesta a restablecimiento de tarjeta inteligente (ATR) para la tarjeta que se está inicializando actualmente.
Comentario Comentario que describe la tarjeta inteligente.
Flags Marcas que describen la tarjeta inteligente.
Middleware Middleware para la tarjeta inteligente.
ParentSmartcardUuid Identificador de la tarjeta inteligente antigua que ha reemplazado la tarjeta inteligente.
PermanentSmartcardUuid Identificador de la tarjeta inteligente permanente asociada a la tarjeta inteligente.
PrimarySmartcardUuid Identificador de la tarjeta inteligente principal.
ProfileTemplateUuid Identificador de la plantilla de perfil que contiene las directivas y la configuración que rigen la tarjeta inteligente.
ProfileTemplateVersion Versión de la plantilla de perfil en el momento en que se creó el perfil de tarjeta inteligente.
Número de serie. Número de serie de la tarjeta inteligente.
Estado Estado de la tarjeta inteligente.
Uuid Identificador del perfil de tarjeta inteligente.

Ejemplo

En esta sección se proporciona un ejemplo para actualizar el estado de una tarjeta inteligente.

Ejemplo: solicitud

PUT /certificatemanagement/api/v1.0/requests/b105403d-d021-41ea-9f11-be3d677d229e/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9 HTTP/1.1

Ejemplo: respuesta

HTTP/1.1 200 OK

{
    "Uuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
    "Status":6,
    "Flags":1,
    "ParentSmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "PrimarySmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "PermanentSmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "AssignedUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
    "ProfileTemplateUuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
    "ProfileTemplateVersion":46,
    "Comment":"",
    "SerialNumber":"{bc88f13f-83ba-4037-8262-46eba1291c6e}",
    "Middleware":"MSBaseCSP",
    "Atr":"3b8d0180fba000000397425446590301c8"
}

Consulte también

  • Last updated on