Udostępnij przez

Tworzenie żądania usługi PAM

Używane przez uprzywilejowane konto do podniesienia poziomu do roli PAM.

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
Bez znajomości kontekstu, w którym "POST" jest używany, nie mogę zaproponować dokładnego tłumaczenia. Jeżeli dotyczy HTTP, pozostaw jako "POST". /api/pamresources/pamrequests

Parametry zapytania

Parametr Opis
Uzasadnienie Opcjonalny. Podana przez użytkownika przyczyna żądania podniesienia uprawnień.
Identyfikator roli To jest wymagane. Unikatowy identyfikator (GUID) roli PAM w celu podniesienia poziomu do.
Żądany czas wygaśnięcia To jest wymagane. Żądany czas wygaśnięcia w sekundach.
RequestedTime Opcjonalny. Czas podniesienia uprawnień.
v Opcjonalny. Wersja interfejsu API. Jeśli nie zostanie uwzględniona, zostanie użyta bieżąca (ostatnio wydana) wersja interfejsu API. Aby uzyskać więcej informacji, zobacz Przechowywanie wersji w usłudze interfejsu API REST usługi PAM.

Uwaga

Można określić uzasadnienie, RoleId, requestedTTLi RequestedTime parametrów 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 zapytań

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

Ciało żądania

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

Odpowiedź

W tej sekcji opisano odpowiedź.

Kody odpowiedzi

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

Nagłówki odpowiedzi

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

Ciało odpowiedzi

Pomyślna odpowiedź zawiera obiekt żądania PAM o następujących właściwościach:

Nieruchomość Opis
Identyfikator żądania Unikatowy identyfikator (GUID) dla żądania PAM.
Identyfikator twórcy Unikatowy identyfikator (GUID) w usłudze MIM dla konta, które utworzyło żądanie.
Uzasadnienie Przyczyna podniesienia uprawnień.
CreationTime Czas tworzenia żądania.
TworzenieMethod Metoda użyta do utworzenia żądania.
Czas wygaśnięcia Czas wygaśnięcia żądania.
Identyfikator roli Unikatowy identyfikator (GUID) roli PAM.
Żądany czas wygaśnięcia Żądany limit czasu wygaśnięcia w sekundach.
RequestedTime Żądany czas podniesienia uprawnień.
RequestStatus Stan żądania. Możliwe wartości to "Processing", "Active", "Closed", "Closing", "Expired", "PendingApproval", "PendingMFA" i "Rejected".

Przykład

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

Przykład: żądanie 1

POST /api/pamresources/pamrequests?Justification=Sample+Reason&RoleId=00000000-0000-0000-0000-000000000000&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":"00000000-0000-0000-0000-000000000000",
    "RequestedTTL":"7200",
    "RequestedTime":"2015-07-12T06:40:00Z",
    "RequestStatus":"PendingApproval"
}

Przykład: żądanie 2

POST /api/pamresources/pamrequests?Justification=&RoleId=00000000-0000-0000-0000-000000000000&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":"00000000-0000-0000-0000-000000000000",
    "RequestedTTL":"3600",
    "RequestedTime":"2015-07-12T06:07:27.7229894Z",
    "RequestStatus":"PendingApproval"
}
  • Last updated on