Uzyskiwanie 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ą względne względem nazwy hosta wybranej podczas wdrażania interfejsu API, takiej 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
identyfikator Identyfikator (GUID) profilu do zwrócenia.
Requestid Identyfikator żądania, dla których mają być zwracane profile.

Parametry zapytania

Parametr Opis
status Opcjonalny. Wskazuje stan profilów, dla których mają zostać pobrane dane. Możliwe typy stanu to "Aktywne", "Zatwierdzone", "Anulowane", "Zakończone", "Odmowa", "Wykonywanie", "Niepowodzenie", "Brak" i "Oczekujące".
Jeśli stan nie zostanie określony, zostaną zwrócone wszystkie profile, niezależnie od stanu.

Nagłówki żądań

Aby uzyskać typowe nagłówki żądań, zobacz Http request and response headers (Nagłówki żądań i odpowiedzi HTTP) w tesłudze.

Treść żądania

Brak.

Reakcja

W tej sekcji opisano odpowiedź.

Kody odpowiedzi

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

Nagłówki odpowiedzi

Aby uzyskać typowe nagłówki odpowiedzi, zobacz Http request and response headers (Nagłówki żądań i odpowiedzi HTTP) w tesłudze.

Treść odpowiedzi

W przypadku powodzenia zwraca listę obiektów Microsoft.Clm.Shared.Profiles.Profile serializowanych w pliku JSON z następującymi właściwościami:

Właściwość Opis
AssignedUserUuid Identyfikator użytkownika, do którego 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 określają profil.
ProfileTemplateVersion Wersja szablonu profilu w momencie utworzenia profilu.
Stan Stan profilu.
Identyfikator UUID Identyfikator profilu.

Przykład

Ta sekcja zawiera przykład, w których można pobrać dane 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ż