GraphRestClient class

Paquet:

azure-devops-extension-api

Classe de base qui doit être utilisée (dérivée de) pour effectuer des requêtes à des API REST VSS

Extends

RestClientBase

Constructeurs

GraphRestClient(IVssRestClientOptions)

Propriétés

RESOURCE_AREA_ID

Méthodes

addMembership(string, string)	Créez une appartenance entre un conteneur et un objet.
checkMembershipExistence(string, string)	Vérifiez si une relation d’appartenance entre un conteneur et un objet existe.
createGroup(GraphGroupCreationContext, string, string[])	Créez un groupe Azure DevOps ou matérialisez un groupe AAD existant.
createScope(GraphScopeCreationContext, string)
createServicePrincipal(GraphServicePrincipalCreationContext, string[])	Matérialisez un principal de service AAD existant dans le compte ADO.
createUser(GraphUserCreationContext, string[])	Matérialisez un utilisateur AAD ou MSA existant dans le compte ADO.
deleteAvatar(string)
deleteGroup(string)	Supprime un groupe Azure DevOps de tous ses groupes parents.
deleteScope(string)
deleteServicePrincipal(string)	Désactive un principal de service.
deleteUser(string)	Désactive un utilisateur.
getAvatar(string, AvatarSize, string)
getCachePolicies()
getDescriptor(string)	Résoudre une clé de stockage en descripteur
getFederatedProviderData(string, string, number)	Acquiert l’ensemble complet de données d’authentification du fournisseur fédéré disponibles pour le sujet du graphique et le nom du fournisseur donnés.
getGroup(string)	Obtenez un groupe par son descripteur.
getMemberByDescriptor(string)	Ce point de terminaison retourne un résultat pour tout membre qui n’a jamais été valide dans le système, même si le membre a été supprimé ou a eu toutes ses appartenances supprimées. La validité actuelle du membre est indiquée par le biais de sa propriété désactivée, qui est omise lorsque la valeur est false.
getMembership(string, string)	Obtenir une relation d’appartenance entre un conteneur et un objet.
getMembershipState(string)	Vérifiez si un objet est actif ou inactif.
getProviderInfo(string)
getScope(string)	Obtenir une étendue identifiée par son descripteur
getServicePrincipal(string)	Obtenez un principal de service par son descripteur.
getStorageKey(string)	Résolvez un descripteur en clé de stockage.
getSubject(string)	Résolvez un descripteur en un utilisateur, un groupe ou une étendue.
getUser(string)	Obtenez un utilisateur par son descripteur.
listMemberships(string, GraphTraversalDirection, number)	Obtenez toutes les appartenances où ce descripteur est membre de la relation.
lookupMembers(GraphSubjectLookup)	Obtient tous les membres demandés dans l’étendue actuelle (généralement l’organisation ou le compte).
lookupMembershipTraversals(GraphSubjectLookup, GraphTraversalDirection, number)	Parcourez les appartenances aux descripteurs d’objet donnés.
lookupSubjects(GraphSubjectLookup)	Résolvez les descripteurs pour les utilisateurs, les groupes ou les étendues (sujets) dans un lot.
querySubjects(GraphSubjectQuery)	Recherchez des utilisateurs Azure Devops ou/et des groupes. Les résultats seront retournés dans un lot sans plus de 100 sujets de graphe.
removeMembership(string, string)	Supprime une appartenance entre un conteneur et un objet.
requestAccess(any)
resolve(IdentityMappings)	Batch mappe une liste d’utilisateurs aux nouveaux utilisateurs.
setAvatar(Avatar, string)
translate(string, string)	Traduction d’identité : le point de terminaison de traduction est censé être utilisé par l’action de genève.
traverseMemberships(string, GraphTraversalDirection, number)	Parcourez les appartenances du descripteur d’objet donné.
updateGroup(string, JsonPatchDocument)	Mettez à jour les propriétés d’un groupe Azure DevOps.
updateScope(string, JsonPatchDocument)
updateServicePrincipal(GraphServicePrincipalUpdateContext, string)	Mappez un principal de service existant à un autre principal de service.
updateUser(GraphUserUpdateContext, string)	Mappez un utilisateur existant à un autre utilisateur.

Détails du constructeur

GraphRestClient(IVssRestClientOptions)

new GraphRestClient(options: IVssRestClientOptions)

Paramètres

options

IVssRestClientOptions

Détails de la propriété

RESOURCE_AREA_ID

static RESOURCE_AREA_ID: string

Valeur de propriété

string

Détails de la méthode

addMembership(string, string)

Créez une appartenance entre un conteneur et un objet.

function addMembership(subjectDescriptor: string, containerDescriptor: string): Promise<GraphMembership>

Paramètres

subjectDescriptor

string

Descripteur d’un groupe ou d’un utilisateur qui peut être l’objet enfant dans la relation.

containerDescriptor

string

Descripteur vers un groupe qui peut être le conteneur dans la relation.

Retours

Promise<GraphMembership>

checkMembershipExistence(string, string)

Vérifiez si une relation d’appartenance entre un conteneur et un objet existe.

function checkMembershipExistence(subjectDescriptor: string, containerDescriptor: string): Promise<boolean>

Paramètres

subjectDescriptor

string

Groupe ou utilisateur qui est un objet enfant de la relation.

containerDescriptor

string

Groupe qui est le conteneur dans la relation.

Retours

Promise<boolean>

createGroup(GraphGroupCreationContext, string, string[])

Créez un groupe Azure DevOps ou matérialisez un groupe AAD existant.

function createGroup(creationContext: GraphGroupCreationContext, scopeDescriptor?: string, groupDescriptors?: string[]): Promise<GraphGroup>

Paramètres

creationContext

GraphGroupCreationContext

Sous-ensemble du groupe de graphiques complet utilisé pour rechercher de manière unique l’objet du graphique dans un fournisseur externe.

scopeDescriptor

string

Descripteur référençant l’étendue (collection, projet) dans laquelle le groupe doit être créé. S’il est omis, il est créé dans l’étendue du compte ou de l’organisation englobant. Valide uniquement pour les groupes VSTS.

groupDescriptors

string[]

Liste séparée par des virgules de descripteurs référençant des groupes que vous souhaitez joindre au groupe de graphiques

Retours

Promise<GraphGroup>

createScope(GraphScopeCreationContext, string)

function createScope(creationContext: GraphScopeCreationContext, scopeDescriptor?: string): Promise<GraphScope>

Paramètres

creationContext

GraphScopeCreationContext

scopeDescriptor

string

Retours

Promise<GraphScope>

createServicePrincipal(GraphServicePrincipalCreationContext, string[])

Matérialisez un principal de service AAD existant dans le compte ADO.

function createServicePrincipal(creationContext: GraphServicePrincipalCreationContext, groupDescriptors?: string[]): Promise<GraphServicePrincipal>

Paramètres

creationContext

GraphServicePrincipalCreationContext

Sous-ensemble du principal de service de graphique complet utilisé pour rechercher de manière unique l’objet du graphique dans un fournisseur externe.

groupDescriptors

string[]

Liste séparée par des virgules de descripteurs de groupes que vous souhaitez joindre au principal du service graph

Retours

Promise<GraphServicePrincipal>

createUser(GraphUserCreationContext, string[])

Matérialisez un utilisateur AAD ou MSA existant dans le compte ADO.

function createUser(creationContext: GraphUserCreationContext, groupDescriptors?: string[]): Promise<GraphUser>

Paramètres

creationContext

GraphUserCreationContext

Sous-ensemble de l’utilisateur de graphe complet utilisé pour rechercher de manière unique l’objet du graphique dans un fournisseur externe.

groupDescriptors

string[]

Liste séparée par des virgules de descripteurs de groupes que vous souhaitez joindre à l’utilisateur de graphe

Retours

Promise<GraphUser>

deleteAvatar(string)

function deleteAvatar(subjectDescriptor: string): Promise<void>

Paramètres

subjectDescriptor

string

Retours

Promise<void>

deleteGroup(string)

Supprime un groupe Azure DevOps de tous ses groupes parents.

function deleteGroup(groupDescriptor: string): Promise<void>

Paramètres

groupDescriptor

string

Descripteur du groupe à supprimer.

Retours

Promise<void>

deleteScope(string)

function deleteScope(scopeDescriptor: string): Promise<void>

Paramètres

scopeDescriptor

string

Retours

Promise<void>

deleteServicePrincipal(string)

Désactive un principal de service.

function deleteServicePrincipal(servicePrincipalDescriptor: string): Promise<void>

Paramètres

servicePrincipalDescriptor

string

Descripteur du principal de service à supprimer.

Retours

Promise<void>

deleteUser(string)

Désactive un utilisateur.

function deleteUser(userDescriptor: string): Promise<void>

Paramètres

userDescriptor

string

Descripteur de l’utilisateur à supprimer.

Retours

Promise<void>

getAvatar(string, AvatarSize, string)

function getAvatar(subjectDescriptor: string, size?: AvatarSize, format?: string): Promise<Avatar>

Paramètres

subjectDescriptor

string

size

AvatarSize

format

string

Retours

Promise<Avatar>

getCachePolicies()

function getCachePolicies(): Promise<GraphCachePolicies>

Retours

Promise<GraphCachePolicies>

getDescriptor(string)

Résoudre une clé de stockage en descripteur

function getDescriptor(storageKey: string): Promise<GraphDescriptorResult>

Paramètres

storageKey

string

Clé de stockage de l’objet (utilisateur, groupe, étendue, etc.) à résoudre

Retours

Promise<GraphDescriptorResult>

getFederatedProviderData(string, string, number)

Acquiert l’ensemble complet de données d’authentification du fournisseur fédéré disponibles pour le sujet du graphique et le nom du fournisseur donnés.

function getFederatedProviderData(subjectDescriptor: string, providerName: string, versionHint?: number): Promise<GraphFederatedProviderData>

Paramètres

subjectDescriptor

string

le descripteur de l’objet de graphe pour lequel nous devons acquérir des données

providerName

string

nom du fournisseur pour lequel acquérir des données, par exemple « github.com »

versionHint

number

indicateur de version qui peut être utilisé pour l’accès concurrentiel du cache optimiste et pour prendre en charge les nouvelles tentatives sur les échecs de jeton d’accès ; notez qu’il s’agit d’un indicateur uniquement et ne garantit pas une version particulière sur la réponse

Retours

Promise<GraphFederatedProviderData>

getGroup(string)

Obtenez un groupe par son descripteur.

function getGroup(groupDescriptor: string): Promise<GraphGroup>

Paramètres

groupDescriptor

string

Descripteur du groupe de graphiques souhaité.

Retours

Promise<GraphGroup>

getMemberByDescriptor(string)

Ce point de terminaison retourne un résultat pour tout membre qui n’a jamais été valide dans le système, même si le membre a été supprimé ou a eu toutes ses appartenances supprimées. La validité actuelle du membre est indiquée par le biais de sa propriété désactivée, qui est omise lorsque la valeur est false.

function getMemberByDescriptor(memberDescriptor: string): Promise<GraphMember>

Paramètres

memberDescriptor

string

Descripteur du membre souhaité.

Retours

Promise<GraphMember>

getMembership(string, string)

Obtenir une relation d’appartenance entre un conteneur et un objet.

function getMembership(subjectDescriptor: string, containerDescriptor: string): Promise<GraphMembership>

Paramètres

subjectDescriptor

string

Descripteur à l’objet enfant dans la relation.

containerDescriptor

string

Descripteur vers le conteneur dans la relation.

Retours

Promise<GraphMembership>

getMembershipState(string)

Vérifiez si un objet est actif ou inactif.

function getMembershipState(subjectDescriptor: string): Promise<GraphMembershipState>

Paramètres

subjectDescriptor

string

Descripteur de l’objet (utilisateur, groupe, étendue, etc.) pour vérifier l’état de

Retours

Promise<GraphMembershipState>

getProviderInfo(string)

function getProviderInfo(userDescriptor: string): Promise<GraphProviderInfo>

Paramètres

userDescriptor

string

Retours

Promise<GraphProviderInfo>

getScope(string)

Obtenir une étendue identifiée par son descripteur

function getScope(scopeDescriptor: string): Promise<GraphScope>

Paramètres

scopeDescriptor

string

Descripteur qui identifie de manière unique une étendue.

Retours

Promise<GraphScope>

getServicePrincipal(string)

Obtenez un principal de service par son descripteur.

function getServicePrincipal(servicePrincipalDescriptor: string): Promise<GraphServicePrincipal>

Paramètres

servicePrincipalDescriptor

string

Descripteur du principal de service souhaité.

Retours

Promise<GraphServicePrincipal>

getStorageKey(string)

Résolvez un descripteur en clé de stockage.

function getStorageKey(subjectDescriptor: string): Promise<GraphStorageKeyResult>

Paramètres

subjectDescriptor

string

Retours

Promise<GraphStorageKeyResult>

getSubject(string)

Résolvez un descripteur en un utilisateur, un groupe ou une étendue.

function getSubject(subjectDescriptor: string): Promise<GraphSubject>

Paramètres

subjectDescriptor

string

Descripteur de l’objet souhaité.

Retours

Promise<GraphSubject>

getUser(string)

Obtenez un utilisateur par son descripteur.

function getUser(userDescriptor: string): Promise<GraphUser>

Paramètres

userDescriptor

string

Descripteur de l’utilisateur souhaité.

Retours

Promise<GraphUser>

listMemberships(string, GraphTraversalDirection, number)

Obtenez toutes les appartenances où ce descripteur est membre de la relation.

function listMemberships(subjectDescriptor: string, direction?: GraphTraversalDirection, depth?: number): Promise<GraphMembership[]>

Paramètres

subjectDescriptor

string

Récupérez toutes les appartenances directes de ce descripteur.

direction

GraphTraversalDirection

Valeur par défaut vers le haut.

depth

number

Nombre maximal de bords à parcourir vers le haut ou vers le bas de l’arborescence d’appartenances. Actuellement, la seule valeur prise en charge est « 1 ».

Retours

Promise<GraphMembership[]>

lookupMembers(GraphSubjectLookup)

Obtient tous les membres demandés dans l’étendue actuelle (généralement l’organisation ou le compte).

function lookupMembers(memberLookup: GraphSubjectLookup): Promise<{[key: string]: Graph.GraphMember}>

Paramètres

memberLookup

GraphSubjectLookup

Retours

Promise<{[key: string]: GraphMember}>

lookupMembershipTraversals(GraphSubjectLookup, GraphTraversalDirection, number)

Parcourez les appartenances aux descripteurs d’objet donnés.

function lookupMembershipTraversals(membershipTraversalLookup: GraphSubjectLookup, direction?: GraphTraversalDirection, depth?: number): Promise<{[key: string]: Graph.GraphMembershipTraversal}>

Paramètres

membershipTraversalLookup

GraphSubjectLookup

Récupérez les descendants/ancêtres de la liste des descripteurs en fonction de la direction.

direction

GraphTraversalDirection

La valeur par défaut est Unknown.

depth

number

La valeur par défaut est « 1 ».

Retours

Promise<{[key: string]: GraphMembershipTraversal}>

lookupSubjects(GraphSubjectLookup)

Résolvez les descripteurs pour les utilisateurs, les groupes ou les étendues (sujets) dans un lot.

function lookupSubjects(subjectLookup: GraphSubjectLookup): Promise<{[key: string]: Graph.GraphSubject}>

Paramètres

subjectLookup

GraphSubjectLookup

Liste de descripteurs qui spécifient un sous-ensemble de sujets à récupérer. Chaque descripteur identifie de manière unique le sujet dans toutes les étendues d’instance, mais seulement à un seul moment dans le temps.

Retours

Promise<{[key: string]: GraphSubject}>

querySubjects(GraphSubjectQuery)

Recherchez des utilisateurs Azure Devops ou/et des groupes. Les résultats seront retournés dans un lot sans plus de 100 sujets de graphe.

function querySubjects(subjectQuery: GraphSubjectQuery): Promise<GraphSubject[]>

Paramètres

subjectQuery

GraphSubjectQuery

La requête que nous allons utiliser pour effectuer une recherche comprend les éléments suivants : Requête : le terme de recherche. La recherche ne correspondra qu’à un préfixe. SubjectKind : « Utilisateur » ou « Groupe » peut être spécifié, à la fois ou scopeDescriptor : l’étendue non par défaut peut être spécifiée, c’est-à-dire le descripteur d’étendue du projet.

Retours

Promise<GraphSubject[]>

removeMembership(string, string)

Supprime une appartenance entre un conteneur et un objet.

function removeMembership(subjectDescriptor: string, containerDescriptor: string): Promise<void>

Paramètres

subjectDescriptor

string

Descripteur d’un groupe ou d’un utilisateur qui est le sujet enfant dans la relation.

containerDescriptor

string

Descripteur vers un groupe qui est le conteneur dans la relation.

Retours

Promise<void>

requestAccess(any)

function requestAccess(jsondocument: any): Promise<void>

Paramètres

jsondocument

any

Retours

Promise<void>

resolve(IdentityMappings)

Batch mappe une liste d’utilisateurs aux nouveaux utilisateurs.

function resolve(mappings: IdentityMappings): Promise<ResolveDisconnectedUsersResponse>

Paramètres

mappings

IdentityMappings

Liste des mappages.

Retours

Promise<ResolveDisconnectedUsersResponse>

setAvatar(Avatar, string)

function setAvatar(avatar: Avatar, subjectDescriptor: string): Promise<void>

Paramètres

avatar

Avatar

subjectDescriptor

string

Retours

Promise<void>

translate(string, string)

Traduction d’identité : le point de terminaison de traduction est censé être utilisé par l’action de genève.

function translate(masterId?: string, localId?: string): Promise<string>

Paramètres

masterId

string

localId

string

Retours

Promise<string>

traverseMemberships(string, GraphTraversalDirection, number)

Parcourez les appartenances du descripteur d’objet donné.

function traverseMemberships(subjectDescriptor: string, direction?: GraphTraversalDirection, depth?: number): Promise<GraphMembershipTraversal>

Paramètres

subjectDescriptor

string

Récupérez les descendants/ancêtres de ce descripteur en fonction de la direction.

direction

GraphTraversalDirection

La valeur par défaut est Unknown.

depth

number

La valeur par défaut est « 1 ».

Retours

Promise<GraphMembershipTraversal>

updateGroup(string, JsonPatchDocument)

Mettez à jour les propriétés d’un groupe Azure DevOps.

function updateGroup(groupDescriptor: string, patchDocument: JsonPatchDocument): Promise<GraphGroup>

Paramètres

groupDescriptor

string

Descripteur du groupe à modifier.

patchDocument

JsonPatchDocument

Document JSON+Patch contenant les champs à modifier.

Retours

Promise<GraphGroup>

updateScope(string, JsonPatchDocument)

function updateScope(scopeDescriptor: string, patchDocument: JsonPatchDocument): Promise<void>

Paramètres

scopeDescriptor

string

patchDocument

JsonPatchDocument

Retours

Promise<void>

updateServicePrincipal(GraphServicePrincipalUpdateContext, string)

Mappez un principal de service existant à un autre principal de service.

function updateServicePrincipal(updateContext: GraphServicePrincipalUpdateContext, servicePrincipalDescriptor: string): Promise<GraphServicePrincipal>

Paramètres

updateContext

GraphServicePrincipalUpdateContext

Sous-ensemble du principal de service de graphique complet utilisé pour rechercher de manière unique l’objet du graphique dans un fournisseur externe.

servicePrincipalDescriptor

string

Descripteur du principal de service à mettre à jour

Retours

Promise<GraphServicePrincipal>

updateUser(GraphUserUpdateContext, string)

Mappez un utilisateur existant à un autre utilisateur.

function updateUser(updateContext: GraphUserUpdateContext, userDescriptor: string): Promise<GraphUser>

Paramètres

updateContext

GraphUserUpdateContext

Sous-ensemble de l’utilisateur de graphe complet utilisé pour rechercher de manière unique l’objet du graphique dans un fournisseur externe.

userDescriptor

string

Descripteur de l’utilisateur à mettre à jour

Retours

Promise<GraphUser>