Hämta Data för användarprofilerGet Profile Data

Hämtar en lista över en användares programvara certifikatprofiler med en lista över möjliga åtgärder som kan utföras av den aktuella användaren.Gets a list of a user’s software certificate profiles with a list of possible operations that can be performed by the current user. Sedan kan du initiera en begäran för någon av de angivna åtgärderna.A request can then be initiated for any of the specified operations.

Obs: servern ställer in PIN-koden endast om mallen profilprincip anger att det ska göras.Note: The server will set the PIN only if the profile template policy indicates that it should be done. I annat fall måste användaren ange den.Otherwise, the user should supply it.

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/Profiles/CertificateManagement/api/v1.0/profiles
/ CertificateManagement/api/v1.0/profiles/{id}/CertificateManagement/api/v1.0/profiles/{id}
/CertificateManagement/API/v1.0/Requests/{RequestId}/Profiles/CertificateManagement/api/v1.0/requests/{requestid}/profiles

URL-parametrarURL Parameters

ParameterParameter BeskrivningDescription
IDid Identifierare (GUID) för profilen som ska returneras.The identifier (GUID) of the profile to return.
begärande-IDrequestId Identifierare för att returnera profiler för begäran.The identifier of the request to return the profiles for.

FrågeparametrarQuery Parameters

ParameterParameter BeskrivningDescription
statusstatus Valfritt.Optional. Anger status för profiler för att hämta data.Indicates the status of the profiles to retrieve data for. För möjliga statustyper är: ”aktiv”, ”godkänd”, ”avbrutits”, ”slutfört”, ”nekad”, ”körs”, ”misslyckades”, ”None” och ”väntande”.Possible status types are: "Active", "Approved", "Canceled", "Completed", "Denied", "Executing", "Failed", "None", and "Pending".
Om ingen status anges returneras alla profiler, oavsett status.If no status is specified, all profiles, 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

På lyckas, returneras en lista med JSON-serialiserad Microsoft.Clm.Shared.Profiles.Profile objekt med följande egenskaper:On success, returns a list of JSON-serialized Microsoft.Clm.Shared.Profiles.Profile objects with the following properties:

EgenskapProperty BeskrivningDescription
AssignedUserUuidAssignedUserUuid Identifierare för den användare som tilldelats profilen.The identifier of the user to whom the profile is assigned.
KommentarComment Kommentar som beskriver profilen.The comment that describes the profile.
FlaggorFlags Flaggor som beskriver profilen.The flags that describe the profile.
ParentProfileUuidParentProfileUuid Identifierare för den gamla profilen profilen har ersatt.The identifier of the old profile that the profile has replaced.
PrimaryProfileUuidPrimaryProfileUuid Identifierare för den primära profilen.The identifier of the primary profile.
ProfileOperationsProfileOperations Lista över möjliga åtgärder som kan utföras av den aktuella användaren på profilen.The list of possible operations that can be performed by the current user on the profile.
ProfileTemplateUuidProfileTemplateUuid Identifierare av Profilmall som innehåller de principer och inställningar som styr profilen.The identifier of the profile template that contains the policies and settings that govern the profile.
ProfileTemplateVersionProfileTemplateVersion Versionen av Profilmall när profilen har skapats.The version of the profile template at the time that the profile was created.
StatusStatus Status för profilen.The status of the profile.
UUIDUuid Profilens identifierare.The profile's identifier.

ExempelExample

BegäranRequest

GET /certificatemanagement/api/v1.0/profiles?status=Active HTTP/1.1

SvarResponse

HTTP/1.1 200 OK

[
    {
        "Uuid":"c0dd5c7d-ec35-4346-baca-3ad711e9722f",
        "Status":2,
        "Flags":1,
        "ParentProfileUuid":"1c9e2606-fea2-4048-a6ac-b014e54c22df",
        "PrimaryProfileUuid":"00000000-0000-0000-0000-000000000000",
        "AssignedUserUuid":"0378a33b-8650-4713-a727-efd233903643",
        "ProfileTemplateUuid":"8f31803f-8afc-49bb-911d-402ec264b589",
        "ProfileTemplateVersion":8,
        "Comment":"",
        "ProfileOperations":[
            "renew",
            "disable",
            "recover"
        ]
    },
    {
        "Uuid":"5ad77b40-aa42-4533-9396-c9c59fd021a8",
        "Status":2,
        "Flags":1,
        "ParentProfileUuid":"00000000-0000-0000-0000-000000000000",
        "PrimaryProfileUuid":"00000000-0000-0000-0000-000000000000",
        "AssignedUserUuid":"0378a33b-8650-4713-a727-efd233903643",
        "ProfileTemplateUuid":"8f31803f-8afc-49bb-911d-402ec264b589",
        "ProfileTemplateVersion":8,
        "Comment":"",
        "ProfileOperations":[
            "renew",
            "disable",
            "recover"
        ]
    },
    {
        "Uuid":"ff342953-c444-4dc7-b144-f5515d6460c6",
        "Status":2,
        "Flags":1,
        "ParentProfileUuid":"00000000-0000-0000-0000-000000000000",
        "PrimaryProfileUuid":"00000000-0000-0000-0000-000000000000",
        "AssignedUserUuid":"0378a33b-8650-4713-a727-efd233903643",
        "ProfileTemplateUuid":"1e3a31fe-699b-4a6b-945c-18b83c985bc1",
        "ProfileTemplateVersion":9,
        "Comment":"",
        "ProfileOperations":[
            "renew",
            "disable"
        ]
    }
]

Se ävenSee Also