Hämta-begäranGet Request

Hämtar ett eller flera angivna MIM CM-begäranden.Gets one or more specified MIM CM requests.

Obs: URL: er som visas i det här avsnittet är i förhållande till värdnamnet valt under distributionen av API, till exempel: https://api.contoso.com.Note: URLs shown in this topic are relative to the hostname chosen during API deployment; for example: https://api.contoso.com.

BegäranRequest

MetodMethod URL-begäranRequest URL
GETGET / CertificateManagement/api/v1.0/requests/{id}/CertificateManagement/api/v1.0/requests/{id}

URL-parametrarURL Parameters

EgenskapProperty BeskrivningDescription
IDid Valfritt.Optional. GUID för en begäran om att hämta.The GUID of a request to retrieve.

FrågeparametrarQuery Parameters

EgenskapProperty BeskrivningDescription
målanvändaretargetuser Valfritt.Optional. Målanvändaren för begäran.The target user of the request. Om inget mål anges returneras alla begäranden oavsett målanvändare.If no target is specified, all requests, regardless of the target user, will be returned.
Obs: endast ”aktuella” stöds för närvarande.Note: Only “current” is currently supported.
statusstatus Valfritt.Optional. Anger status för begäran om att hämta.Indicates the status of the request to retrieve. För möjliga statustyper är: godkänd, avbruten, slutförd, nekas, Executing, misslyckades, ingen, och väntande.Possible status types are: Approved, Canceled, Completed, Denied, Executing, Failed, None, and Pending.
Om ingen status anges returneras alla begäranden oavsett status.If no status is specified, all requests, regardless of status will be returned.

Huvuden för begäranRequest Headers

Vanliga begärandehuvuden finns HTTP-begäran och svarshuvuden i CM REST API-tjänsteinformation.For common request headers, see HTTP Request and Response Headers in CM REST API Service Details.

BegärandetextenRequest Body

ingetnone

SvarResponse

SvarskoderResponse Codes

KodCode BeskrivningDescription
200200 OKOK
204204 Inget innehållNo content
403403 Tillåts inteForbidden
500500 Internt felInternal Error

SvarsrubrikerResponse Headers

Vanliga svarshuvuden finns HTTP-begäran och svarshuvuden i CM REST API-tjänsteinformation.For common response headers, see HTTP Request and Response Headers in CM REST API Service Details.

SvarstextenResponse Body

Returnerar en eller flera på lyckades, begära objekt med följande egenskaper:On success, returns one or more Request objects with the following properties:

NamnName BeskrivningDescription
KommentarComment Kommentaren som är associerad med MIM CM-begäran.The comment that is associated with the MIM CM request.
SlutförtCompleted Den tid som MIM CM-begäran slutfördes.The time that the MIM CM request was completed.
DataCollectionDataCollection Dataobjekt som är associerade med MIM CM-begäran för samlingen.The data collection items that are associated with the MIM CM request.
DataCollectionFlagsDataCollectionFlags Alternativ för datainsamling för MIM CM-begäran.The options for data collection for the MIM CM request.
FlaggorFlags De alternativ som är associerade med MIM CM-begäran.The options that are associated with the MIM CM request.
IsDataCollectionCompleteIsDataCollectionComplete Ett booleskt värde som anger om datainsamlingen har slutförts för MIM CM-begäran.A Boolean value that indicates if the data collection has been completed for the MIM CM request.
IsEnrollmentAgentIsEnrollmentAgent Ett booleskt värde som anger om en registreringsagent krävs för att köra MIM CM-begäran.A Boolean value that indicates if an enrollment agent is required to run the MIM CM request.
IsSmartcardIsSmartcard Ett booleskt värde som anger om MIM CM-begäran är en begäran om smartkort eller en programvarubegäran profil.A Boolean value that indicates if the MIM CM request is a smart card request or a software profile request.
NewProfileUuidNewProfileUuid Identiteten för den nya profilen för programvara som produceras av MIM CM-begäran.The identity of the new software profile that is produced by the MIM CM request.
NewSmartcardUuidNewSmartcardUuid Identiteten för den nya smartkort som tilldelats av MIM CM-begäran.The identity of the new smart card that is assigned by the MIM CM request.
OldProfileUuidOldProfileUuid Identiteten för programvara profilen som MIM CM-begäran har skapats.The identity of the software profile for which the MIM CM request was created.
OldSmartcardUuidOldSmartcardUuid Identitet för smartkortet som MIM CM-begäran har skapats.The identity of the smart card for which the MIM CM request was created.
OriginatorUserUuidOriginatorUserUuid Identiteten för den användare som skickade begäran MIM CMThe identity of the user who originated the MIM CM request
PrioritetPriority MIM CM-begäran prioritet.The MIM CM request's priority.
ProfileTemplateUuidProfileTemplateUuid Identitet av Profilmall som MIM CM-begäran har skapats.The identity of the profile template for which the MIM CM request was created.
RequestTypeRequestType Typ av MIM CM-begäran.The type of the MIM CM request.
AdtagentSecurityDescriptor Säkerhetsbeskrivningen för MIM CM-begäran.The security descriptor for the MIM CM request.
StatusStatus Status för MIM CM-begäran.The status of the MIM CM request.
Har skickatsSubmitted Den tid som MIM CM-begäran har skickats.The time that the MIM CM request was submitted.
TargetUserUuidTargetUserUuid Identiteten för målanvändaren för MIM CM-begäran.The identity of the target user for the MIM CM request.
UUIDUuid Identifierare för MIM CM-begäran.The identifier for the MIM CM request.

ExempelExample

Begäran 1Request 1

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

Svar 1Response 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
}```       
###Request 2

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

###Response 2

HTTP/1.1 200 OKHTTP/1.1 200 OK

{”Uuid”: ”0c96d73f-967b-420e-854a-43ad2a1504bc”, ”RequestType”: 5, ”Status”: 3, ”flaggor”: 2, ”DataCollection”: [{”Name”: ”Exempeldataobjekt”, ”värde”: null}], ”DataCollectionFlags”: 32, ”OriginatorUserUuid”: ”8f1590dc-d932-4b66-8e68-2e91c5880780”, ”TargetUserUuid”: ”8f1590dc-d932-4b66-8e68-2e91c5880780”, ”in” ”: 2015-07-07T23:40:33.133Z”, ”slutförd” ”: 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”, ”prioritet”: 0, ”Comment” ”:”, ”ProfileTemplateUuid”: ”a039b4d0-5ce8-4eff-8651-181c6576fda3”, ”Adtagent” ”: O:S-1-5-21-2127521184-1604012920-1887927527 14134865 D:(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; D CSW;; 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}{ "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 }


##See Also

- [Microsoft.Clm.Provision.FindOperations.FindRequest Method](http://msdn.microsoft.com/library/windows/desktop/microsoft.clm.provision.findoperations.findrequests.aspx)
- [Microsoft.Clm.Shared.RequestPermission Enumeration](http://msdn.microsoft.com/library/windows/desktop/microsoft.clm.shared.requestpermission.aspx)
- [Microsoft.Clm.Shared.Requests.Request Class](https://msdn.microsoft.com/library/windows/desktop/microsoft.clm.shared.requests.request.aspx)