Atualizar o status do cartão inteligente
Atualizações o status de um cartão inteligente.
Observação
As URLs neste artigo são relativas ao nome do host escolhido durante a implantação da API, como https://api.contoso.com
.
Solicitação
Método | URL da solicitação |
---|---|
GET | /CertificateManagement/api/v1.0/requests/{reqid}/smartcards/{scid} |
Parâmetros de URL
Parâmetro | Descrição |
---|---|
reqid | Obrigatórios. O identificador de solicitação específico para Microsoft Identity Manager (MIM) Gerenciamento de Certificados (CM). |
scid | Obrigatórios. O identificador de cartão inteligente específico do MIM CM. O valor corresponde ao campo "uuid" no objeto Microsoft.Clm.Shared.Smartcards.Smartcard . |
Cabeçalhos da solicitação
Para cabeçalhos de solicitação comuns, consulte Cabeçalhos de solicitação e resposta HTTP nos detalhes do serviço da API REST do CM.
Corpo da solicitação
O corpo da solicitação contém as seguintes propriedades:
Propriedade | Descrição |
---|---|
status | O status para o qual definir a solicitação, como "Desativado". |
Resposta
Esta seção descreve a resposta.
Códigos de resposta
Código | Descrição |
---|---|
200 | OK |
204 | Sem conteúdo |
403 | Proibido |
500 | Erro Interno |
Cabeçalhos de resposta
Para cabeçalhos de resposta comuns, consulte Cabeçalhos de solicitação e resposta HTTP nos detalhes do serviço da API REST do CM.
Corpo da resposta
Em caso de sucesso, retorna um objeto Microsoft.Clm.Shared.Smartcards.Smartcard serializado para JSON com as seguintes propriedades:
Nome | Descrição |
---|---|
AssignedUserUuid | O identificador do usuário a quem o cartão inteligente é atribuído. |
Atr | A cadeia de ATR (resposta à redefinição) do cartão inteligente para o cartão que atualmente está sendo inicializado. |
Comentário | O comentário que descreve o cartão inteligente. |
Flags | Os sinalizadores que descrevem o cartão inteligente. |
Middleware | O middleware para o cartão inteligente. |
ParentSmartcardUuid | O identificador do cartão inteligente antigo que o cartão inteligente substituiu. |
PermanentSmartcardUuid | O identificador do cartão inteligente permanente que está associado ao cartão inteligente. |
PrimarySmartcardUuid | O identificador do cartão inteligente primário. |
ProfileTemplateUuid | O identificador do modelo de perfil que contém as políticas e as configurações que controlam o cartão inteligente. |
ProfileTemplateVersion | A versão do modelo de perfil no momento em que o perfil de cartão inteligente foi criado. |
SerialNumber | O número de série do cartão inteligente. |
Status | O status do cartão inteligente. |
Uuid | O identificador do perfil do cartão inteligente. |
Exemplo
Esta seção fornece um exemplo para atualizar o status de um cartão inteligente.
Exemplo: Solicitação
PUT /certificatemanagement/api/v1.0/requests/b105403d-d021-41ea-9f11-be3d677d229e/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9 HTTP/1.1
Exemplo: resposta
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"
}