Atualizar estado do smart card

Artigo
09/14/2023

Atualizações o estado de um smart card.

Nota

Os URLs neste artigo são relativos ao nome do anfitrião escolhido durante a implementação da API, como https://api.contoso.com.

Pedir

Método	URL do Pedido
GET	/CertificateManagement/api/v1.0/requests/{reqid}/smartcards/{scid}

Parâmetros de URL

Parâmetro	Description
reqid	Obrigatório. O identificador do pedido específico da Gestão de Certificados (CM) Microsoft Identity Manager (MIM).
scid	Obrigatório. O identificador do smart card específico do CM do MIM. O valor corresponde ao campo "uuid" no objeto Microsoft.Clm.Shared.Smartcards.Smartcard .

Cabeçalhos do pedido

Para obter os cabeçalhos de pedidos comuns, veja Cabeçalhos de pedidos e respostas HTTP nos detalhes do serviço da API REST do CM.

Corpo do pedido

O corpo do pedido contém as seguintes propriedades:

Propriedade	Descrição
status	O estado para definir o pedido como, por exemplo, "Descontinuado".

Resposta

Esta secçã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 obter cabeçalhos de resposta comuns, veja Cabeçalhos de pedidos e respostas HTTP nos detalhes do serviço API REST do CM.

Corpo da resposta

Com êxito, devolve um objeto JSON-Serialized Microsoft.Clm.Shared.Smartcards.Smartcard com as seguintes propriedades:

Nome	Descrição
AssignedUserUuid	O identificador do utilizador ao qual o smart card está atribuído.
Atr	A cadeia de resposta a reposição (ATR) do smart card para o cartão que está atualmente a ser inicializado.
Comentário	O comentário que descreve o smart card.
Sinalizadores	Os sinalizadores que descrevem o smart card.
Middleware	O middleware do smart card.
ParentSmartcardUuid	O identificador do smart card antigo que o smart card substituiu.
PermanentSmartcardUuid	O identificador do smart card permanente associado ao smart card.
PrimarySmartcardUuid	O identificador do smart card principal.
ProfileTemplateUuid	O identificador do modelo de perfil que contém as políticas e definições que regem o smart card.
ProfileTemplateVersion	A versão do modelo de perfil no momento em que o perfil do smart card foi criado.
SerialNumber	O número de série do smart card.
Estado	O estado do smart card.
Uuid	O identificador do perfil de smart card.

Exemplo

Esta secção fornece um exemplo para atualizar o estado de um smart card.

Exemplo: Pedido

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

Ver também

Microsoft.Clm.Shared.Smartcards.Smartcard class (Classe Microsoft.Clm.Shared.Smartcards.Smartcard)

Partilhar via