Obtenir des rôles PAM

Article
09/14/2023

Utilisé par un compte privilégié pour énumérer les rôles PAM pour lesquels le compte est un candidat.

Notes

Les URL de cet article sont relatives au nom d’hôte choisi pendant le déploiement de l’API, par exemple https://api.contoso.com.

Requête

Méthode	URL de demande
GET	/api/pamresources/pamroles

Paramètres de requête

Paramètre	Description
$filter	facultatif. Spécifiez l’une des propriétés de rôle PAM dans une expression de filtre pour renvoyer une liste filtrée de réponses. Pour plus d’informations sur les opérateurs pris en charge, consultez Filtrage dans les détails du service d’API REST PAM.
v	facultatif. Version de l'API. Si elle n’est pas incluse, la version actuelle (la plus récente) de l’API est utilisée. Pour plus d’informations, consultez Gestion de version dans les détails du service d’API REST PAM.

En-têtes de requête

Pour connaître les en-têtes de requête courants, consultez En-têtes de requête et de réponse HTTP dans les détails du service d’API REST PAM.

Corps de la demande

Aucun.

response

Cette section décrit la réponse.

Codes de réponse

Code	Description
200	OK
401	Non autorisé
403	Interdit
408	Délai d’expiration de la demande
500	Erreur interne du serveur
503	Service indisponible

En-têtes de réponse

Pour connaître les en-têtes de requête courants, consultez En-têtes de requête et de réponse HTTP dans les détails du service d’API REST PAM.

Response body

Une réponse réussie contient une collection d’un ou plusieurs rôles PAM, chacun ayant les propriétés suivantes :

Propriété	Description
RoleID	Identificateur unique (GUID) du rôle PAM.
DisplayName	Nom d'affichage du rôle PAM dans le service MIM.
Description	Description du rôle PAM dans le service MIM.
TTL	Délai d'expiration maximal en secondes des droits d'accès du rôle.
AvailableFrom	Heure la plus ancienne de la journée où une demande est activée.
AvailableTo	Heure la plus récente de la journée à laquelle une demande est activée.
MFAEnabled	Valeur booléenne qui indique si les demandes d'activation pour ce rôle nécessitent une stimulation d'authentification multifacteur.
ApprovalEnabled	Valeur booléenne qui indique si les demandes d'activation pour ce rôle doivent être approuvées par un propriétaire de rôle.
DisponibilitéWindowEnabled	Valeur booléenne qui indique si le rôle ne peut être activé que pendant un intervalle de temps spécifié.

Exemple

Cette section fournit un exemple pour obtenir les rôles PAM.

Exemple : requête

GET /api/pamresources/pamroles HTTP/1.1

Exemple : Réponse

HTTP/1.1 200 OK

{
    "odata.metadata":"http://localhost:8086/api/pamresources/%24metadata#pamroles",
    "value":[
        {
            "RoleId":"00000000-0000-0000-0000-000000000000",
            "DisplayName":"Allow AD Access ",
            "Description":null,
            "TTL":"3600",
            "AvailableFrom":"0001-01-01T00:00:00",
            "AvailableTo":"0001-01-01T00:00:00",
            "MFAEnabled":false,
            "ApprovalEnabled":false,
            "AvailabilityWindowEnabled":false
        },
        {
            "RoleId":"00000000-0000-0000-0000-000000000000",
            "DisplayName":"ApprovalRole",
            "Description":null,
            "TTL":"3600",
            "AvailableFrom":"0001-01-01T00:00:00",
            "AvailableTo":"0001-01-01T00:00:00",
            "MFAEnabled":false,
            "ApprovalEnabled":true,
            "AvailabilityWindowEnabled":false
        }
    ]
}

Partager via