Get-Anforderung

Artikel
03/22/2025

Ruft eine oder mehrere angegebene Microsoft Identity Manager (MIM)-Zertifikatverwaltungsanforderungen (CM) ab.

Hinweis

Die URLs in diesem Artikel beziehen sich auf den Hostnamen, der während der API-Bereitstellung ausgewählt wird, z. B. https://api.contoso.com.

Anfrage

Methode	Anforderungs-URL
ERHALTEN/Bekommen	/CertificateManagement/api/v1.0/requests/{id}

URL-Parameter

Eigentum	BESCHREIBUNG
id	Wahlfrei. Die GUID einer abzurufenden Anforderung.

Abfrageparameter

Eigentum	BESCHREIBUNG
targetuser	Wahlfrei. Der Zielbenutzer der Anforderung. Wenn kein Ziel angegeben ist, werden unabhängig vom Zielbenutzer alle Anforderungen zurückgegeben. Hinweis: Derzeit wird nur der Wert "current" unterstützt.
Status	Wahlfrei. Gibt den Status der abzurufenden Anforderung an. Die möglichen Statustypen sind "Genehmigt", "Abgebrochen", "Abgeschlossen", "Abgelehnt", "Ausführen", "Fehlgeschlagen", "Keine" und "Ausstehend". Wenn kein Status angegeben ist, werden alle Anforderungen unabhängig vom Status zurückgegeben.

Anforderungsheader

Allgemeine Anforderungsheader finden Sie unter HTTP-Anforderungs- und Antwortheader in CM-REST-API-Dienstdetails.

Anfragekörper

Keiner.

Antwort

In diesem Abschnitt wird die Antwort beschrieben.

Antwortcodes

Code	BESCHREIBUNG
200	OKAY
204	Kein Inhalt
403	Verboten
500	Interner Fehler

Antwortheader

Allgemeine Antwortheader finden Sie unter HTTP-Anforderungs- und Antwortheader in CM REST API-Dienstdetails.

Antwortkörper

Gibt bei Erfolg mindestens ein Request-Objekte mit den folgenden Eigenschaften zurück:

Name	BESCHREIBUNG
Kommentar	Der Kommentar, der der MIM CM-Anforderung zugeordnet ist.
Abgeschlossen	Die Zeit, zu der die MIM CM-Anforderung abgeschlossen wurde.
DataCollection	Die Datensammlungselemente, die der MIM CM-Anforderung zugeordnet sind.
DataCollectionFlags	Die Optionen für die Datensammlung für die MIM CM-Anforderung.
Flaggen	Die Optionen, die der MIM CM-Anforderung zugeordnet sind.
IsDataCollectionComplete	Ein boolescher Wert, der angibt, ob die Datensammlung für die MIM CM-Anforderung abgeschlossen wurde.
IsEnrollmentAgent	Ein boolescher Wert, der angibt, ob ein Registrierungs-Agent zum Ausführen der MIM CM-Anforderung erforderlich ist.
IsSmartcard	Ein boolescher Wert, der angibt, ob die MIM CM-Anforderung eine Smartcardanforderung oder eine Softwareprofilanforderung ist.
NewProfileUuid	Die Identität des neuen Softwareprofils, das von der MIM CM-Anforderung erstellt wird.
NewSmartcardUuid	Die Identität der neuen Smartcard, die von der MIM CM-Anforderung zugewiesen wird.
OldProfileUuid	Die Identität des Softwareprofils, für das die MIM CM-Anforderung erstellt wurde.
OldSmartcardUuid	Die Identität der Smartcard, für die die MIM CM-Anforderung erstellt wurde.
OriginatorUserUuid	Die Identität des Benutzers, der die MIM CM-Anforderung stammte.
Priorität	Die Priorität der MIM-CM-Anforderung.
ProfileTemplateUuid	Die Identität der Profilvorlage, für die die MIM CM-Anforderung erstellt wurde.
Anfragetyp	Der Typ der MIM CM-Anforderung.
SecurityDescriptor	Der Sicherheitsdeskriptor für die MIM CM-Anforderung.
Status	Der Status der MIM CM-Anforderung.
Vorgelegt	Die Zeit, zu der die MIM CM-Anforderung gesendet wurde.
TargetUserUuid	Die Identität des Zielbenutzers für die MIM CM-Anforderung.
Uuid	Der Bezeichner für die MIM CM-Anforderung.

Beispiel

Dieser Abschnitt enthält ein Beispiel zum Abrufen der angegebenen MIM CM-Anforderungen.

Beispiel: Anforderung 1

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

Beispiel: Antwort 1

HTTP/1.1 200 OK

{
    "Uuid":"a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099",
    "RequestType":1,
    "Status":3,
    "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":"0001-01-01T00:00:00",
    "NewProfileUuid":"00000000-0000-0000-0000-000000000000",
    "OldProfileUuid":"00000000-0000-0000-0000-000000000000",
    "NewSmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "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
}

Beispiel: Anforderung 2

GET /certificatemanagement/api/v1.0/requests/0c96d73f-967b-420e-854a-43ad2a1504bc HTTP/1.1

Beispiel: Antwort 2

HTTP/1.1 200 OK

{
    "Uuid":"0c96d73f-967b-420e-854a-43ad2a1504bc",
    "RequestType":5,
    "Status":3,
    "Flags":2,
    "DataCollection":[
        {
            "Name":"Sample Data Item",
            "Value":null
        }
    ],
    "DataCollectionFlags":32,
    "OriginatorUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
    "TargetUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
    "Submitted":"2015-07-07T23:40:33.133Z",
    "Completed":"0001-01-01T00:00:00",
    "NewProfileUuid":"b99ff38c-6653-471f-ae3c-325bb351a6bc",
    "OldProfileUuid":"b99ff38c-6653-471f-ae3c-325bb351a6bc",
    "NewSmartcardUuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
    "OldSmartcardUuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
    "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;;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",
    "IsSmartcard":true,
    "IsEnrollmentAgent":false,
    "IsDataCollectionComplete":false
}

Freigeben über