Intelligens kártya állapotának frissítése

  • Cikk

Frissítések intelligens kártya állapotát.

Megjegyzés

A cikkben szereplő URL-címek az API-telepítés során kiválasztott gazdagépnévhez (például https://api.contoso.com) kapcsolódnak.

Kérés

Metódus URL-cím kérése
GET /CertificateManagement/api/v1.0/requests/{reqid}/smartcards/{scid}

URL-paraméterek

Paraméter Leírás
reqid Kötelező. A Microsoft Identity Manager (MIM) tanúsítványkezelésére (CM) jellemző kérésazonosító.
scid Kötelező. A MIM CM-re jellemző intelligenskártya-azonosító. Az érték a Microsoft.Clm.Shared.Smartcards.Smartcard objektum "uuid" mezőjének felel meg.

Kérésfejlécek

A gyakori kérésfejlécekért lásd: HTTP-kérés- és válaszfejlécek a CM REST API szolgáltatás részleteiben.

A kérés törzse

A kérelem törzse a következő tulajdonságokat tartalmazza:

Tulajdonság Leírás
status A kérés beállításának állapota, például "Kivezetve".

Reagálás

Ez a szakasz a választ ismerteti.

Válaszkódok

Code Description
200 OK
204 Nincs tartalom
403 Forbidden
500 Belső hiba

Válaszfejlécek

A gyakori válaszfejlécekért lásd: HTTP-kérés- és válaszfejlécek a CM REST API szolgáltatás részleteiben.

Választörzs

Sikeres végrehajtás esetén egy JSON-Serialized Microsoft.Clm.Shared.Smartcards.Smartcards.Smartcard objektumot ad vissza a következő tulajdonságokkal:

Név Leírás
AssignedUserUuid Annak a felhasználónak az azonosítója, amelyhez az intelligens kártya hozzá van rendelve.
Atr Az inicializálás alatt álló kártya válasz-visszaállítás (ATR) sztringje.
Megjegyzés Az intelligens kártyát leíró megjegyzés.
Zászlók Az intelligens kártyát leíró jelzők.
Közbenső szoftver Az intelligens kártya köztes szoftvere.
ParentSmartcardUuid Annak a régi intelligens kártyának az azonosítója, amelyet az intelligens kártya lecserélt.
PermanentSmartcardUuid Az intelligens kártyához társított állandó intelligens kártya azonosítója.
PrimarySmartcardUuid Az elsődleges intelligens kártya azonosítója.
ProfileTemplateUuid Az intelligens kártyát szabályozó szabályzatokat és beállításokat tartalmazó profilsablon azonosítója.
ProfileTemplateVersion A profilsablon verziója az intelligenskártya-profil létrehozásakor.
Sorozatszám Az intelligens kártya sorozatszáma.
Állapot Az intelligens kártya állapota.
Uuid Az intelligenskártya-profil azonosítója.

Példa

Ez a szakasz egy intelligens kártya állapotának frissítésére mutat be példát.

Példa: Kérelem

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

Példa: Válasz

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

Lásd még