Tworzenie żądania PAM

Używany przez uprzywilejowane konto do podnieść do roli PAM.

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
POST /api/pamresources/pamrequests

Parametry zapytania

Parametr Opis
Uzasadnienie Opcjonalny. Przyczyna żądania podniesienia uprawnień dostarczona przez użytkownika.
RoleId Wymagane. Unikatowy identyfikator (GUID) roli PAM, do których należy podnieść.
Żądany czas wygaśnięcia Wymagane. Żądany czas wygaśnięcia, w sekundach.
Żądana czas Opcjonalny. Czas podnieść uprawnienia.
v Opcjonalny. Wersja interfejsu API. Jeśli nie zostanie uwzględniony, zostanie użyta bieżąca (ostatnio wydana) wersja interfejsu API. Aby uzyskać więcej informacji, zobacz Versioning in PAM REST API service details (Obsługa wersji w usłudze interfejsu API REST usługi PAM).

Uwaga

Parametry Justification, RoleId,RequestedTTLi RequestedTime można określić jako właściwości w treści żądania, a nie jako parametry zapytania. Parametr v można określić tylko jako parametr zapytania.

Nagłówki żądań

Typowe nagłówki żądań można znaleźć w sekcji Http request and response headers (Nagłówki żądań i odpowiedzi HTTP) w tesłudze szczegółów usługi interfejsu API REST usługi PAM.

Treść żądania

Opcjonalny. Parametry Justification, RoleId, RequestedTTLi RequestedTime można określić jako właściwości treści żądania, zamiast określać je w ciągu zapytania adresu URL.

Reakcja

W tej sekcji opisano odpowiedź.

Kody odpowiedzi

Kod Opis
200 OK
401 Brak autoryzacji
403 Forbidden
408 Limit czasu żądania
500 Wewnętrzny błąd serwera
503 Usługa niedostępna

Nagłówki odpowiedzi

Typowe nagłówki żądań można znaleźć w sekcji Http request and response headers (Nagłówki żądań i odpowiedzi HTTP) w tesłudze szczegółów usługi interfejsu API REST usługi PAM.

Treść odpowiedzi

Pomyślna odpowiedź zawiera obiekt żądania PAM z następującymi właściwościami:

Właściwość Opis
RequestID Unikatowy identyfikator (GUID) dla żądania PAM.
CreatorID Unikatowy identyfikator (GUID) w usłudze MIM dla konta, które utworzyło żądanie.
Uzasadnienie Przyczyna podniesienia uprawnień.
CreationTime Czas utworzenia żądania.
CreationMethod Metoda użyta do utworzenia żądania.
ExpirationTime Czas wygaśnięcia żądania.
RoleID Unikatowy identyfikator (GUID) roli PAM.
Żądany czas wygaśnięcia Żądany limit czasu wygaśnięcia w sekundach.
Żądana czas Żądany czas podniesienia uprawnień.
RequestStatus Stan żądania. Możliwe wartości to "Przetwarzanie", "Aktywne", "Zamknięte", "Zamykanie", "Wygasłe", "PendingApproval", "PendingMFA" i "Odrzucone".

Przykład

Ta sekcja zawiera przykłady tworzenia żądania PAM.

Przykład: Żądanie 1

POST /api/pamresources/pamrequests?Justification=Sample+Reason&RoleId=c28eab4a-95cf-4c08-a153-d5e8a9e660cd&RequestedTTL=7200&RequestedTime=2015%2F07%2F11+23%3A40 HTTP/1.1

Przykład: Odpowiedź 1

HTTP/1.1 201 Created

{  
    "odata.metadata":"http://localhost:8086/api/pamresources/%24metadata#pamrequests/@Element",
    "RequestId":"c0112f13-b16b-40ad-b547-07f23a7fba52",
    "CreatorID":"73257e5e-00b3-4309-a330-f1e607ff113a",
    "Justification":"Sample Reason",
    "CreationTime":"2015-07-11T23:38:09.036164-07:00",
    "CreationMethod":"PAM Web API",
    "ExpirationTime":"0001-01-01T00:00:00",
    "RoleId":"c28eab4a-95cf-4c08-a153-d5e8a9e660cd",
    "RequestedTTL":"7200",
    "RequestedTime":"2015-07-12T06:40:00Z",
    "RequestStatus":"PendingApproval"
}

Przykład: Żądanie 2

POST /api/pamresources/pamrequests?Justification=&RoleId=c28eab4a-95cf-4c08-a153-d5e8a9e660cd&RequestedTTL=3600&RequestedTime= HTTP/1.1

Przykład: Odpowiedź 2

HTTP/1.1 201 Created

{
    "odata.metadata":"http://localhost:8086/api/pamresources/%24metadata#pamrequests/@Element",
    "RequestId":"504f9c49-00db-42bd-a157-ee5664617189",
    "CreatorID":"73257e5e-00b3-4309-a330-f1e607ff113a",
    "Justification":null,
    "CreationTime":"2015-07-11T23:07:30.2200123-07:00",
    "CreationMethod":"PAM Web API",
    "ExpirationTime":"0001-01-01T00:00:00",
    "RoleId":"c28eab4a-95cf-4c08-a153-d5e8a9e660cd",
    "RequestedTTL":"3600",
    "RequestedTime":"2015-07-12T06:07:27.7229894Z",
    "RequestStatus":"PendingApproval"
}