GraphRestClient class

Pacchetto:

azure-devops-extension-api

Classe di base da usare (derivata da) per effettuare richieste alle API REST vss

Extends

RestClientBase

Costruttori

GraphRestClient(IVssRestClientOptions)

Proprietà

RESOURCE_AREA_ID

Metodi

addMembership(string, string)	Creare una nuova appartenenza tra un contenitore e un oggetto.
checkMembershipExistence(string, string)	Verificare se esiste una relazione di appartenenza tra un contenitore e un oggetto.
createGroup(GraphGroupCreationContext, string, string[])	Creare un nuovo gruppo di Azure DevOps o materializzare un gruppo AAD esistente.
createScope(GraphScopeCreationContext, string)
createServicePrincipal(GraphServicePrincipalCreationContext, string[])	Materializzare un'entità servizio AAD esistente nell'account ADO.
createUser(GraphUserCreationContext, string[])	Materializzare un utente AAD o MSA esistente nell'account ADO.
deleteAvatar(string)
deleteGroup(string)	Rimuove un gruppo di Azure DevOps da tutti i gruppi padre.
deleteScope(string)
deleteServicePrincipal(string)	Disabilita un'entità servizio.
deleteUser(string)	Disabilita un utente.
getAvatar(string, AvatarSize, string)
getCachePolicies()
getDescriptor(string)	Risolvere una chiave di archiviazione in un descrittore
getFederatedProviderData(string, string, number)	Acquisisce il set completo di dati di autenticazione del provider federato disponibili per l'oggetto del grafo e il nome del provider specificati.
getGroup(string)	Ottenere un gruppo in base al descrittore.
getMemberByDescriptor(string)	Questo endpoint restituisce un risultato per qualsiasi membro che sia mai stato valido nel sistema, anche se il membro è stato eliminato o ha eliminato tutte le appartenenze. La validità corrente del membro viene indicata tramite la relativa proprietà disabilitata, che viene omessa quando false.
getMembership(string, string)	Ottenere una relazione di appartenenza tra un contenitore e un oggetto.
getMembershipState(string)	Controllare se un oggetto è attivo o inattivo.
getProviderInfo(string)
getScope(string)	Ottenere un ambito identificato dal descrittore
getServicePrincipal(string)	Ottenere un'entità servizio dal descrittore.
getStorageKey(string)	Risolvere un descrittore in una chiave di archiviazione.
getSubject(string)	Risolvere un descrittore in un utente, un gruppo o un ambito.
getUser(string)	Ottenere un utente in base al descrittore.
listMemberships(string, GraphTraversalDirection, number)	Ottiene tutte le appartenenze in cui questo descrittore è un membro della relazione.
lookupMembers(GraphSubjectLookup)	Ottiene tutti i membri richiesti nell'ambito corrente (in genere organizzazione o account).
lookupMembershipTraversals(GraphSubjectLookup, GraphTraversalDirection, number)	Attraversa le appartenenze dei descrittori del soggetto specificati.
lookupSubjects(GraphSubjectLookup)	Risolvere i descrittori in utenti, gruppi o ambiti (soggetti) in un batch.
querySubjects(GraphSubjectQuery)	Cercare utenti o/e gruppi di Azure Devops. I risultati verranno restituiti in un batch con non più di 100 soggetti a grafo.
removeMembership(string, string)	Elimina un'appartenenza tra un contenitore e un oggetto.
requestAccess(any)
resolve(IdentityMappings)	Eseguire il mapping di un elenco di utenti a nuovi utenti.
setAvatar(Avatar, string)
translate(string, string)	Identity Translation: l'endpoint di traduzione dell'identità deve essere usato dall'azione ginevra.
traverseMemberships(string, GraphTraversalDirection, number)	Attraversa le appartenenze del descrittore del soggetto specificato.
updateGroup(string, JsonPatchDocument)	Aggiornare le proprietà di un gruppo di Azure DevOps.
updateScope(string, JsonPatchDocument)
updateServicePrincipal(GraphServicePrincipalUpdateContext, string)	Eseguire il mapping di un'entità servizio esistente a un'entità servizio diversa.
updateUser(GraphUserUpdateContext, string)	Eseguire il mapping di un utente esistente a un utente diverso.

Dettagli costruttore

GraphRestClient(IVssRestClientOptions)

new GraphRestClient(options: IVssRestClientOptions)

Parametri

options

IVssRestClientOptions

Dettagli proprietà

RESOURCE_AREA_ID

static RESOURCE_AREA_ID: "bb1e7ec9-e901-4b68-999a-de7012b920f8" = "bb1e7ec9-e901-4b68-999a-de7012b920f8"

Valore della proprietà

"bb1e7ec9-e901-4b68-999a-de7012b920f8"

Dettagli metodo

addMembership(string, string)

Creare una nuova appartenenza tra un contenitore e un oggetto.

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

Parametri

subjectDescriptor

string

Descrittore di un gruppo o di un utente che può essere l'oggetto figlio nella relazione.

containerDescriptor

string

Descrittore di un gruppo che può essere il contenitore nella relazione.

Valori restituiti

Promise<GraphMembership>

checkMembershipExistence(string, string)

Verificare se esiste una relazione di appartenenza tra un contenitore e un oggetto.

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

Parametri

subjectDescriptor

string

Gruppo o utente figlio della relazione.

containerDescriptor

string

Gruppo che è il contenitore nella relazione.

Valori restituiti

Promise<boolean>

createGroup(GraphGroupCreationContext, string, string[])

Creare un nuovo gruppo di Azure DevOps o materializzare un gruppo AAD esistente.

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

Parametri

creationContext

GraphGroupCreationContext

Sottoinsieme del gruppo di gragrafi completo usato per trovare in modo univoco l'oggetto del grafo in un provider esterno.

scopeDescriptor

string

Descrittore che fa riferimento all'ambito (raccolta, progetto) in cui deve essere creato il gruppo. Se omesso, verrà creato nell'ambito dell'account o dell'organizzazione contenitore. Valido solo per i gruppi VSTS.

groupDescriptors

string[]

Elenco delimitato da virgole di descrittori che fanno riferimento ai gruppi a cui si vuole aggiungere il gruppo di graffi

Valori restituiti

Promise<GraphGroup>

createScope(GraphScopeCreationContext, string)

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

Parametri

creationContext

GraphScopeCreationContext

scopeDescriptor

string

Valori restituiti

Promise<GraphScope>

createServicePrincipal(GraphServicePrincipalCreationContext, string[])

Materializzare un'entità servizio AAD esistente nell'account ADO.

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

Parametri

creationContext

GraphServicePrincipalCreationContext

Subset dell'entità servizio a grafo completa usata per trovare in modo univoco l'oggetto del grafo in un provider esterno.

groupDescriptors

string[]

Elenco delimitato da virgole di descrittori di gruppi a cui si vuole aggiungere l'entità servizio graph

Valori restituiti

Promise<GraphServicePrincipal>

createUser(GraphUserCreationContext, string[])

Materializzare un utente AAD o MSA esistente nell'account ADO.

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

Parametri

creationContext

GraphUserCreationContext

Sottoinsieme dell'utente del grafico completo usato per trovare in modo univoco l'oggetto del grafo in un provider esterno.

groupDescriptors

string[]

Elenco delimitato da virgole di descrittori di gruppi a cui si vuole aggiungere l'utente del grafico

Valori restituiti

Promise<GraphUser>

deleteAvatar(string)

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

Parametri

subjectDescriptor

string

Valori restituiti

Promise<void>

deleteGroup(string)

Rimuove un gruppo di Azure DevOps da tutti i gruppi padre.

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

Parametri

groupDescriptor

string

Descrittore del gruppo da eliminare.

Valori restituiti

Promise<void>

deleteScope(string)

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

Parametri

scopeDescriptor

string

Valori restituiti

Promise<void>

deleteServicePrincipal(string)

Disabilita un'entità servizio.

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

Parametri

servicePrincipalDescriptor

string

Descrittore dell'entità servizio da eliminare.

Valori restituiti

Promise<void>

deleteUser(string)

Disabilita un utente.

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

Parametri

userDescriptor

string

Descrittore dell'utente da eliminare.

Valori restituiti

Promise<void>

getAvatar(string, AvatarSize, string)

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

Parametri

subjectDescriptor

string

size

AvatarSize

format

string

Valori restituiti

Promise<Avatar>

getCachePolicies()

function getCachePolicies(): Promise<GraphCachePolicies>

Valori restituiti

Promise<GraphCachePolicies>

getDescriptor(string)

Risolvere una chiave di archiviazione in un descrittore

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

Parametri

storageKey

string

Chiave di archiviazione dell'oggetto (utente, gruppo, ambito e così via) da risolvere

Valori restituiti

Promise<GraphDescriptorResult>

getFederatedProviderData(string, string, number)

Acquisisce il set completo di dati di autenticazione del provider federato disponibili per l'oggetto del grafo e il nome del provider specificati.

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

Parametri

subjectDescriptor

string

descrittore dell'oggetto del grafo per cui è necessario acquisire i dati

providerName

string

nome del provider per cui acquisire i dati, ad esempio "github.com"

versionHint

number

un hint di versione che può essere usato per la concorrenza della cache ottimistica e per supportare i tentativi in caso di errori dei token di accesso; si noti che si tratta solo di un hint e non garantisce una versione specifica nella risposta

Valori restituiti

Promise<GraphFederatedProviderData>

getGroup(string)

Ottenere un gruppo in base al descrittore.

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

Parametri

groupDescriptor

string

Descrittore del gruppo di gragrafi desiderato.

Valori restituiti

Promise<GraphGroup>

getMemberByDescriptor(string)

Questo endpoint restituisce un risultato per qualsiasi membro che sia mai stato valido nel sistema, anche se il membro è stato eliminato o ha eliminato tutte le appartenenze. La validità corrente del membro viene indicata tramite la relativa proprietà disabilitata, che viene omessa quando false.

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

Parametri

memberDescriptor

string

Descrittore del membro desiderato.

Valori restituiti

Promise<GraphMember>

getMembership(string, string)

Ottenere una relazione di appartenenza tra un contenitore e un oggetto.

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

Parametri

subjectDescriptor

string

Descrittore dell'oggetto figlio nella relazione.

containerDescriptor

string

Descrittore del contenitore nella relazione.

Valori restituiti

Promise<GraphMembership>

getMembershipState(string)

Controllare se un oggetto è attivo o inattivo.

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

Parametri

subjectDescriptor

string

Descrittore dell'oggetto (utente, gruppo, ambito e così via) per controllare lo stato di

Valori restituiti

Promise<GraphMembershipState>

getProviderInfo(string)

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

Parametri

userDescriptor

string

Valori restituiti

Promise<GraphProviderInfo>

getScope(string)

Ottenere un ambito identificato dal descrittore

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

Parametri

scopeDescriptor

string

Descrittore che identifica in modo univoco un ambito.

Valori restituiti

Promise<GraphScope>

getServicePrincipal(string)

Ottenere un'entità servizio dal descrittore.

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

Parametri

servicePrincipalDescriptor

string

Descrittore dell'entità servizio desiderata.

Valori restituiti

Promise<GraphServicePrincipal>

getStorageKey(string)

Risolvere un descrittore in una chiave di archiviazione.

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

Parametri

subjectDescriptor

string

Valori restituiti

Promise<GraphStorageKeyResult>

getSubject(string)

Risolvere un descrittore in un utente, un gruppo o un ambito.

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

Parametri

subjectDescriptor

string

Descrittore dell'oggetto desiderato.

Valori restituiti

Promise<GraphSubject>

getUser(string)

Ottenere un utente in base al descrittore.

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

Parametri

userDescriptor

string

Descrittore dell'utente desiderato.

Valori restituiti

Promise<GraphUser>

listMemberships(string, GraphTraversalDirection, number)

Ottiene tutte le appartenenze in cui questo descrittore è un membro della relazione.

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

Parametri

subjectDescriptor

string

Recuperare tutte le appartenenze dirette di questo descrittore.

direction

GraphTraversalDirection

Il valore predefinito è Up.

depth

number

Numero massimo di bordi da attraversare verso l'alto o verso il basso dell'albero delle appartenenze. Attualmente l'unico valore supportato è '1'.

Valori restituiti

Promise<GraphMembership[]>

lookupMembers(GraphSubjectLookup)

Ottiene tutti i membri richiesti nell'ambito corrente (in genere organizzazione o account).

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

Parametri

memberLookup

GraphSubjectLookup

Valori restituiti

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

lookupMembershipTraversals(GraphSubjectLookup, GraphTraversalDirection, number)

Attraversa le appartenenze dei descrittori del soggetto specificati.

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

Parametri

membershipTraversalLookup

GraphSubjectLookup

Recuperare i discendenti/predecessori dell'elenco di descrittori in base alla direzione.

direction

GraphTraversalDirection

Il valore predefinito è Unknown.

depth

number

Il valore predefinito è '1'.

Valori restituiti

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

lookupSubjects(GraphSubjectLookup)

Risolvere i descrittori in utenti, gruppi o ambiti (soggetti) in un batch.

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

Parametri

subjectLookup

GraphSubjectLookup

Elenco di descrittori che specifica un subset di soggetti da recuperare. Ogni descrittore identifica in modo univoco l'oggetto in tutti gli ambiti dell'istanza, ma solo in un singolo punto nel tempo.

Valori restituiti

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

querySubjects(GraphSubjectQuery)

Cercare utenti o/e gruppi di Azure Devops. I risultati verranno restituiti in un batch con non più di 100 soggetti a grafo.

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

Parametri

subjectQuery

GraphSubjectQuery

La query che verrà usata per la ricerca include quanto segue: Query: il termine di ricerca. La ricerca sarà solo prefisso corrispondente. SubjectKind: è possibile specificare "User" o "Group", entrambi o ScopeDescriptor: è possibile specificare un ambito non predefinito, ad esempio descrittore dell'ambito del progetto

Valori restituiti

Promise<GraphSubject[]>

removeMembership(string, string)

Elimina un'appartenenza tra un contenitore e un oggetto.

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

Parametri

subjectDescriptor

string

Descrittore di un gruppo o di un utente che è l'oggetto figlio nella relazione.

containerDescriptor

string

Descrittore di un gruppo che è il contenitore nella relazione.

Valori restituiti

Promise<void>

requestAccess(any)

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

Parametri

jsondocument

any

Valori restituiti

Promise<void>

resolve(IdentityMappings)

Eseguire il mapping di un elenco di utenti a nuovi utenti.

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

Parametri

mappings

IdentityMappings

Elenco di mapping.

Valori restituiti

Promise<ResolveDisconnectedUsersResponse>

setAvatar(Avatar, string)

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

Parametri

avatar

Avatar

subjectDescriptor

string

Valori restituiti

Promise<void>

translate(string, string)

Identity Translation: l'endpoint di traduzione dell'identità deve essere usato dall'azione ginevra.

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

Parametri

masterId

string

localId

string

Valori restituiti

Promise<string>

traverseMemberships(string, GraphTraversalDirection, number)

Attraversa le appartenenze del descrittore del soggetto specificato.

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

Parametri

subjectDescriptor

string

Recuperare i discendenti/predecessori di questo descrittore a seconda della direzione.

direction

GraphTraversalDirection

Il valore predefinito è Unknown.

depth

number

Il valore predefinito è '1'.

Valori restituiti

Promise<GraphMembershipTraversal>

updateGroup(string, JsonPatchDocument)

Aggiornare le proprietà di un gruppo di Azure DevOps.

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

Parametri

groupDescriptor

string

Descrittore del gruppo da modificare.

patchDocument

JsonPatchDocument

Documento JSON+Patch contenente i campi da modificare.

Valori restituiti

Promise<GraphGroup>

updateScope(string, JsonPatchDocument)

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

Parametri

scopeDescriptor

string

patchDocument

JsonPatchDocument

Valori restituiti

Promise<void>

updateServicePrincipal(GraphServicePrincipalUpdateContext, string)

Eseguire il mapping di un'entità servizio esistente a un'entità servizio diversa.

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

Parametri

updateContext

GraphServicePrincipalUpdateContext

Subset dell'entità servizio a grafo completa usata per trovare in modo univoco l'oggetto del grafo in un provider esterno.

servicePrincipalDescriptor

string

Descrittore dell'entità servizio da aggiornare

Valori restituiti

Promise<GraphServicePrincipal>

updateUser(GraphUserUpdateContext, string)

Eseguire il mapping di un utente esistente a un utente diverso.

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

Parametri

updateContext

GraphUserUpdateContext

Sottoinsieme dell'utente del grafico completo usato per trovare in modo univoco l'oggetto del grafo in un provider esterno.

userDescriptor

string

Descrittore dell'utente da aggiornare

Valori restituiti

Promise<GraphUser>