Obtenha perfis de cartões inteligentes

Obtém uma lista de perfis de cartões inteligentes para um utilizador. A lista inclui as possíveis operações que podem ser realizadas pelo utilizador atual. Em seguida, pode ser iniciado um pedido para qualquer uma das operações especificadas.

Nota

Os URLs deste artigo são relativos ao nome de anfitrião escolhido durante a implantação da API, tais como https://api.contoso.com .

Pedir

Método URL do Pedido
GET /CertificadoManagement/api/v1.0/smartcards
/CertificadoManagement/api/v1.0/smartcards/{smartcarduuid}

Parâmetros de URL

Propriedade Descrição
smartcarduuid Opcional. O cartão inteligente UUID, tal como denotado pela Microsoft Identity Manager (MIM) Certificate Management (CM). O valor corresponde ao campo "uuid" no objeto Microsoft.Clm.Shared.Smartcards.Smartcards.Smartcard.

Parâmetros de consulta

Propriedade Descrição
cardid Opcional. O cartão inteligente UUID como denotado por MIM CM. O valor corresponde ao campo "uuid" no objeto Microsoft.Clm.Shared.Smartcards.Smartcards.Smartcard.

Cabeçalhos do pedido

Para cabeçalhos de pedido comuns, consulte os cabeçalhos de pedido e resposta HTTP nos dados do serviço cm REST API.

Corpo do pedido

Nenhum.

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 cabeçalhos de resposta comuns, consulte os cabeçalhos de pedido e resposta HTTP nos dados do serviço cm REST API.

Corpo da resposta

No sucesso, devolve um JSON-Serialized objeto Microsoft.Clm.Shared.Smartcards.Smartcards com as seguintes propriedades:

Nome Descrição
Designadou O identificador do utilizador a quem o cartão inteligente é atribuído.
Atr A cadeia de resposta a reset (ATR) do cartão que está atualmente a ser inicializada.
Comentário O comentário que descreve o cartão inteligente.
Sinalizadores As bandeiras que descrevem o cartão inteligente.
Middleware O middleware para o cartão inteligente.
ParentSmartcardUuid O identificador do antigo cartão inteligente que o cartão inteligente substituiu.
PermanenteSmartcarduuid 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 configurações que regem o cartão inteligente.
ProfileTemplateVersion A versão do modelo de perfil no momento em que o perfil do cartão inteligente foi criado.
SerialNumber O número de série do cartão inteligente.
Estado O estado do cartão inteligente.
Uuid O identificador do perfil do cartão inteligente.

Exemplo

Esta secção fornece um exemplo para obter perfis de cartões inteligentes para um utilizador.

Exemplo: Pedido 1

GET /certificatemanagement/api/v1.0/smartcards?cardid=d1ef6869-5517-42a0-8f05-16ca1a0b834d HTTP/1.1

Exemplo: Resposta 1

HTTP/1.1 200 OK

{
    "Uuid":"438d1b30-f3b4-4bed-85fa-285e08605ba7",
    "Status":3,
    "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":"{d1ef6869-5517-42a0-8f05-16ca1a0b834d}",
    "Middleware":"MSBaseCSP",
    "Atr":"3b8d0180fba000000397425446590301c8"
}

Exemplo: Pedido 2

GET /certificatemanagement/api/v1.0/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9 HTTP/1.1

Exemplo: Resposta 2

HTTP/1.1 200 OK

{
    "Uuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
    "Status":2,
    "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