Aktualizace stavu čipové karty
Aktualizace stav čipové karty.
Poznámka
Adresy URL v tomto článku jsou relativní k názvu hostitele zvolenému během nasazování rozhraní API, například https://api.contoso.com.
Žádost
| Metoda | Adresa URL požadavku |
|---|---|
| GET | /CertificateManagement/api/v1.0/requests/{reqid}/smartcards/{scid} |
Parametry adresy URL
| Parametr | Popis |
|---|---|
| reqid | Povinná hodnota. Identifikátor požadavku, který je specifický pro Microsoft Identity Manager (MIM) Certificate Management (CM). |
| Scid | Povinná hodnota. Identifikátor čipové karty, který je specifický pro MIM CM. Hodnota odpovídá poli "uuid" v objektu Microsoft.Clm.Shared.Smartcards.Smartcard . |
Hlavičky požadavku
Běžné hlavičky požadavků najdete v tématu Hlavičky požadavků HTTP a odpovědí v podrobnostech o službě CM REST API.
Text požadavku
Text požadavku obsahuje následující vlastnosti:
| Vlastnost | Popis |
|---|---|
| status | Stav, na který se má požadavek nastavit, například "Vyřazeno". |
Odpověď
Tato část popisuje odpověď.
Kódy odpovědí
| Kód | Description |
|---|---|
| 200 | OK |
| 204 | Žádný obsah |
| 403 | Forbidden |
| 500 | Vnitřní chyba |
Hlavičky odpovědi
Běžné hlavičky odpovědi najdete v tématu Hlavičky požadavků HTTP a odpovědí v podrobnostech o službě CM REST API.
Text odpovědi
Při úspěchu vrátí JSON-Serialized objektu Microsoft.Clm.Shared.Smartcards.Smartcard s následujícími vlastnostmi:
| Název | Description |
|---|---|
| PřiřazenýuserUuid | Identifikátor uživatele, kterému je čipová karta přiřazena. |
| Atr | Řetězec odpovědi a obnovení (ATR) čipové karty pro kartu, která se právě inicializuje. |
| Komentář | Komentář, který popisuje čipovou kartu. |
| Příznaky | Příznaky, které popisují čipovou kartu. |
| Middleware | Middleware pro čipovou kartu. |
| ParentSmartcardUuid | Identifikátor staré čipové karty, kterou čipová karta nahradila. |
| PermanentSmartcardUuid | Identifikátor trvalé čipové karty, která je přidružena k čipové kartě. |
| PrimárníSmartcardUuid | Identifikátor primární čipové karty. |
| ProfilTemplateUuid | Identifikátor šablony profilu, která obsahuje zásady a nastavení, která řídí čipovou kartu. |
| ProfileTemplateVersion | Verze šablony profilu v době vytvoření profilu čipové karty |
| SerialNumber | Sériové číslo čipové karty |
| Stav | Stav čipové karty. |
| Uuid | Identifikátor profilu čipové karty. |
Příklad
Tato část obsahuje příklad aktualizace stavu čipové karty.
Příklad: Žádost
PUT /certificatemanagement/api/v1.0/requests/b105403d-d021-41ea-9f11-be3d677d229e/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9 HTTP/1.1
Příklad: Odpověď
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"
}