Anulowanie, porzucanie lub ukończenie żądania

Oznacz żądanie Microsoft Identity Manager (MIM) certificate management (CM) jako ukończone, anulowane lub porzucone.

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
PUT /CertificateManagement/api/v1.0/requests/{id}

Parametry URL

Właściwość Opis
identyfikator Wymagane. Identyfikator GUID żądania do ukończenia.

Nagłówki żądań

Aby uzyskać informacje o typowych nagłówkach żądań, zobacz Nagłówki żądań i odpowiedzi HTTP w sekcji Szczegóły usługi interfejsu API REST usługi CM.

Treść żądania

Treść żądania zawiera następujące właściwości:

Właściwość Opis
status Stan, na który ma być ustawione żądanie. Możliwe wartości to "Ukończono", "Anulowano" lub "Porzucone".

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ć informacje o typowych nagłówkach odpowiedzi, zobacz Http request and response headers (Nagłówki żądań i odpowiedzi HTTP) w te tematu CM REST API service details (Szczegółyusługi interfejsu API REST usługi CM).

Treść odpowiedzi

W przypadku powodzenia zwraca obiekt Microsoft.Clm.Shared.Requests.Request. Obiekt opisuje żądanie MIM cmdlet, które zostało oznaczone jako ukończone. Obiekt zawiera następujące właściwości:

Nazwa Opis
Komentarz Komentarz skojarzony z żądaniem MIM cmdł.
Ukończone Godzina ukończenia MIM cmdlet.
DataCollection Elementy zbierania danych skojarzone z żądaniem MIM ZARZĄDZANIA.
DataCollectionFlags Opcje zbierania danych dla żądania MIM ZARZĄDZANIA.
Flagi Opcje, które są skojarzone z MIM cmdł.
IsDataCollectionComplete Wartość logiczna wskazująca, czy zbieranie danych zostało ukończone dla MIM cmdlet.
IsEnrollmentAgent Wartość logiczna wskazująca, czy agent rejestracji jest wymagany do uruchomienia żądania MIM zarządzania.
IsSmartcard Wartość logiczna wskazująca, czy żądanie MIM ZARZĄDZANIA jest żądaniem karty inteligentnej, czy żądaniem profilu oprogramowania.
NewProfileUuid Tożsamość nowego profilu oprogramowania, który jest wytwarzanych przez żądanie MIM zarządzania.
NewSmartcardUuid Tożsamość nowej karty inteligentnej, która jest przypisana przez żądanie MIM zarządzania.
OldProfileUuid Tożsamość profilu oprogramowania, dla którego utworzono MIM cmdł.
OldSmartcardUuid Tożsamość karty inteligentnej, dla której utworzono MIM cmdł.
OriginatorUserUuid Tożsamość użytkownika, który pochodzi z żądania MIM zarządzania dostępem.
Priorytet Priorytet MIM żądania cmdł.
ProfileTemplateUuid Tożsamość szablonu profilu, dla którego utworzono MIM cmdł.
RequestType Typ żądania MIM CM.
SecurityDescriptor (Deskryptor zabezpieczeń) Deskryptor zabezpieczeń dla żądania MIM ZARZĄDZANIA.
Stan Stan żądania MIM zarządzania.
Przesłane Czas, o MIM żądania cmdł.
TargetUserUuid Tożsamość użytkownika docelowego dla żądania MIM ZARZĄDZANIA.
Identyfikator UUID Identyfikator żądania MIM zarządzania.

Przykład

Ta sekcja zawiera przykład oznaczania żądania jako ukończonego.

Przykład: Żądanie

PUT /certificatemanagement/api/v1.0/requests/a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099 HTTP/1.1


{
    "status":"Completed"
}

Przykład: Odpowiedź

HTTP/1.1 200 OK

{
    "Uuid":"a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099",
    "RequestType":1,
    "Status":8,
    "Flags":2,
    "DataCollection":[

    ],
    "DataCollectionFlags":32,
    "OriginatorUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
    "TargetUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
    "Submitted":"2015-07-07T23:36:21.93Z",
    "Completed":"2015-07-07T23:37:37.767Z",
    "NewProfileUuid":"b99ff38c-6653-471f-ae3c-325bb351a6bc",
    "OldProfileUuid":"00000000-0000-0000-0000-000000000000",
    "NewSmartcardUuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
    "OldSmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "Priority":0,
    "Comment":"",
    "ProfileTemplateUuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
    "SecurityDescriptor":"O:S-1-5-21-2127521184-1604012920-1887927527-14134865D:(D;;LC;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-5094533)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-5094534)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-5219125)(A;;SWRC;;;S-1-5-21-2127521184-1604012920-1887927527-5094533)(A;;RC;;;WD)(A;;CCDCLCSWSDRC;;;S-1-5-21-2127521184-1604012920-1887927527-14134865)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)(A;;CCDCSW;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000",
    "IsSmartcard":true,
    "IsEnrollmentAgent":false,
    "IsDataCollectionComplete":false
}

Zobacz też