Obter perfis de cartão inteligente

Obtém uma lista de perfis de cartão inteligente para um usuário. A lista inclui as possíveis operações que podem ser executadas pelo usuário atual. Em seguida, uma solicitação pode ser iniciada para qualquer uma das operações especificadas.

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
Conseguir	/CertificateManagement/api/v1.0/smartcards /CertificateManagement/api/v1.0/smartcards/{smartcarduuid}

Parâmetros de URL

Propriedade	Descrição
smartcarduuid	Opcional. A UUID do cartão inteligente, conforme indicado pelo CM (Gerenciamento de Certificados) do Microsoft Identity Manager (MIM). O valor corresponde ao campo "uuid" no objeto Microsoft.Clm.Shared.Smartcards.Smartcards.Smartcard.

Parâmetros de consulta

Propriedade	Descrição
cardid	Opcional. A UUID do cartão inteligente, conforme indicado pelo MIM CM. O valor corresponde ao campo "uuid" no objeto Microsoft.Clm.Shared.Smartcards.Smartcards.Smartcard.

Cabeçalhos de solicitação

Para obter cabeçalhos de solicitação comuns, consulte cabeçalhos de solicitação HTTP e de resposta nos detalhes do serviço da API REST CM.

Corpo da solicitação

Nenhum.

Resposta

Esta seção descreve a resposta.

Códigos de resposta

Código	Descrição
200	OKEY
204	Nenhum conteúdo
403	Proibido
500	Erro Interno

Cabeçalhos de resposta

Para obter cabeçalhos de resposta comuns, consulte cabeçalhos de solicitação e resposta HTTP em detalhes do serviço da API REST do CM.

Corpo da resposta

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

Nome	Descrição
AssignedUserUuid	O identificador do usuário ao qual o cartão inteligente é atribuído.
Atr	A cadeia de caracteres ATR (resposta a redefinição) do cartão inteligente que está sendo inicializada no momento.
Comentário	O comentário que descreve o cartão inteligente.
Sinalizadores	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 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 de cartão inteligente foi criado.
Número de Série	O número de série do cartão inteligente.
Situação	O status do cartão inteligente.
Uuid	O identificador do perfil de cartão inteligente.

Exemplo

Esta seção fornece um exemplo para obter perfis de cartão inteligente para um usuário.

Exemplo: Solicitação 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: Solicitação 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"
}

Consulte também

• classe Microsoft.Clm.Shared.Smartcards.Smartcard