Pobieranie danych profilu

  • Artykuł

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
identyfikator Identyfikator (GUID) profilu do zwrócenia.
requestId Identyfikator żądania, dla którego mają być zwracane profile.

Parametry zapytania

Parametr Opis
status 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 stanu, wszystkie profile, niezależnie od stanu są zwracane.

Nagłówki żądań

Aby zapoznać się z typowymi nagłówkami żądań, zobacz Nagłówki żądań HTTP i odpowiedzi w szczegółach usługi interfejsu API REST zarządzania konfiguracją.

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

Typowe nagłówki odpowiedzi można znaleźć w temacie Http request and response headers in CM REST API details (Nagłówki żądań HTTP i odpowiedzi w szczegółach usługi interfejsu API REST zarządzania konfiguracją).

Treść odpowiedzi

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

Właściwość 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.
Stan Stan profilu.
Identyfikator UUID Identyfikator profilu.

Przykład

Ta sekcja zawiera 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ż