Aggiornare lo stato della smart card

Articolo
09/14/2023

Aggiornamenti lo stato di una smart card.

Nota

Gli URL di questo articolo sono relativi al nome host scelto durante la distribuzione api, ad esempio https://api.contoso.com.

Richiesta

Metodo	URL richiesta
GET	/CertificateManagement/api/v1.0/requests/{reqid}/smartcards/{scid}

Parametri URL

Parametro	Descrizione
reqid	Obbligatorio. Identificatore di richiesta specifico per Microsoft Identity Manager (MIM) Certificate Management (CM).
scid	Obbligatorio. Identificatore della smart card specifico di MIM CM. Il valore corrisponde al campo "uuid" nell'oggetto Microsoft.Clm.Shared.Smartcards.Smartcards.

Intestazioni della richiesta

Per le intestazioni di richiesta comuni, vedere Intestazioni di richiesta HTTP e risposta nei dettagli del servizio API REST CM.

Testo della richiesta

Il corpo della richiesta contiene le proprietà seguenti:

Proprietà	Descrizione
status	Stato su cui impostare la richiesta, ad esempio "Ritiro".

Risposta

Questa sezione descrive la risposta.

Codici di risposta

Codice	Descrizione
200	OK
204	Nessun contenuto
403	Accesso negato
500	Errore interno

Intestazioni di risposta

Per le intestazioni di risposta comuni, vedere Intestazioni di richiesta HTTP e risposta nei dettagli del servizio API REST CM.

Corpo della risposta

In caso di esito positivo, restituisce un oggetto Microsoft.Clm.Shared.Smartcards.Smartcard serializzato nel formato JSON con le proprietà seguenti:

Nome	Descrizione
AssignedUserUuid	Identificatore dell'utente a cui è assegnata la smart card.
Atr	Stringa ATR (Answer To Reset) di smart card per la scheda in fase di inizializzazione.
Commento	Il commento che descrive la smart card.
Flags	I flag che descrivono la smart card.
Middleware	Il middleware per la smart card.
ParentSmartcardUuid	Identificatore della smart card precedente sostituita dalla smart card.
PermanentSmartcardUuid	Identificatore della smart card permanente associata alla smart card.
PrimarySmartcardUuid	Identificatore della smart card primaria.
ProfileTemplateUuid	Identificatore del modello di profilo che contiene criteri e impostazioni che controllano la smart card.
ProfileTemplateVersion	La versione del modello di profilo al momento della creazione del profilo della smart card.
SerialNumber	Numero di serie della smart card.
Stato	Lo stato della smart card.
Uuid	Identificatore del profilo della smart card.

Esempio

Questa sezione fornisce un esempio per aggiornare lo stato di una smart card.

Esempio: Richiesta

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

Esempio: Risposta

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

Vedi anche

Classe Microsoft.Clm.Shared.Smartcards.Smartcard

Condividi tramite