Udostępnij przez

Pobieranie danych profilu

Pobiera listę profilów certyfikatów oprogramowania dla użytkownika. Lista zawiera możliwe operacje, które mogą być wykonywane przez bieżącego użytkownika. Następnie można zainicjować żądanie dla dowolnej z określonych operacji.

Ważne

Serwer ustawia numer PIN tylko wtedy, gdy zasady szablonu profilu wskazują, że należy to zrobić. W przeciwnym razie użytkownik powinien podać numer PIN.

Uwaga

Adresy URL w tym artykule są powiązane z nazwą hosta wybraną podczas wdrażania interfejsu API, taką jak https://api.contoso.com.

Żądanie

Metoda Adres URL żądania
GET /CertificateManagement/api/v1.0/profiles
/CertificateManagement/api/v1.0/profiles/{id}
/CertificateManagement/api/v1.0/requests/{requestid}/profiles

Parametry URL

Parametr Opis
id Identyfikator (GUID) profilu do zwrócenia.
Identyfikator żądania Identyfikator żądania, dla którego mają być zwracane profile.

Parametry zapytania

Parametr Opis
stan Opcjonalny. Wskazuje stan profilów, dla których mają być pobierane dane. Możliwe typy stanów to "Active", "Approved", "Canceled", "Completed", "Denied", "Executing", "Failed", "None" i "Pending".
Jeśli nie określono żadnego stanu, wszystkie profile, niezależnie od stanu są zwracane.

Nagłówki zapytań

Aby uzyskać typowe nagłówki żądań, zobacz nagłówki żądań i odpowiedzi HTTP w szczegółach usługi interfejsu API REST CM.

Ciało żądania

Żaden.

Odpowiedź

W tej sekcji opisano odpowiedź.

Kody odpowiedzi

Kod Opis
200 OK
204 Brak zawartości
403 Zakazany
500 Błąd wewnętrzny

Nagłówki odpowiedzi

Aby uzyskać typowe nagłówki odpowiedzi, zobacz nagłówki żądań HTTP i odpowiedzi w szczegółach usługi API REST.

Ciało odpowiedzi

Po powodzeniu zwraca listę obiektów Microsoft.Clm.Shared.Profiles.Profile z następującymi właściwościami:

Nieruchomość / Majątek Opis
AssignedUserUuid Identyfikator użytkownika, któremu przypisano profil.
Komentarz Komentarz opisujący profil.
Flagi Flagi opisujące profil.
ParentProfileUuid Identyfikator starego profilu, który został zastąpiony przez profil.
PrimaryProfileUuid Identyfikator profilu podstawowego.
ProfileOperations Lista możliwych operacji, które mogą być wykonywane przez bieżącego użytkownika w profilu.
ProfileTemplateUuid Identyfikator szablonu profilu, który zawiera zasady i ustawienia, które zarządzają profilem.
ProfileTemplateVersion Wersja szablonu profilu w momencie utworzenia profilu.
Status Stan profilu.
Uuid Identyfikator profilu.

Przykład

W tej sekcji przedstawiono przykład pobierania danych profilu dla użytkownika.

Przykład: Żądanie

GET /certificatemanagement/api/v1.0/profiles?status=Active HTTP/1.1

Przykład: Odpowiedź

HTTP/1.1 200 OK

[
    {
        "Uuid":"c0dd5c7d-ec35-4346-baca-3ad711e9722f",
        "Status":2,
        "Flags":1,
        "ParentProfileUuid":"1c9e2606-fea2-4048-a6ac-b014e54c22df",
        "PrimaryProfileUuid":"00000000-0000-0000-0000-000000000000",
        "AssignedUserUuid":"0378a33b-8650-4713-a727-efd233903643",
        "ProfileTemplateUuid":"8f31803f-8afc-49bb-911d-402ec264b589",
        "ProfileTemplateVersion":8,
        "Comment":"",
        "ProfileOperations":[
            "renew",
            "disable",
            "recover"
        ]
    },
    {
        "Uuid":"5ad77b40-aa42-4533-9396-c9c59fd021a8",
        "Status":2,
        "Flags":1,
        "ParentProfileUuid":"00000000-0000-0000-0000-000000000000",
        "PrimaryProfileUuid":"00000000-0000-0000-0000-000000000000",
        "AssignedUserUuid":"0378a33b-8650-4713-a727-efd233903643",
        "ProfileTemplateUuid":"8f31803f-8afc-49bb-911d-402ec264b589",
        "ProfileTemplateVersion":8,
        "Comment":"",
        "ProfileOperations":[
            "renew",
            "disable",
            "recover"
        ]
    },
    {
        "Uuid":"ff342953-c444-4dc7-b144-f5515d6460c6",
        "Status":2,
        "Flags":1,
        "ParentProfileUuid":"00000000-0000-0000-0000-000000000000",
        "PrimaryProfileUuid":"00000000-0000-0000-0000-000000000000",
        "AssignedUserUuid":"0378a33b-8650-4713-a727-efd233903643",
        "ProfileTemplateUuid":"1e3a31fe-699b-4a6b-945c-18b83c985bc1",
        "ProfileTemplateVersion":9,
        "Comment":"",
        "ProfileOperations":[
            "renew",
            "disable"
        ]
    }
]

Zobacz też

  • Last updated on