共用方式為


GraphRestClient class

應該使用 (衍生自) 的基類,向 VSS REST API 提出要求

Extends

建構函式

GraphRestClient(IVssRestClientOptions)

屬性

RESOURCE_AREA_ID

方法

addMembership(string, string)

建立容器與主體之間的新成員資格。

checkMembershipExistence(string, string)

檢查容器與主體之間的成員資格關聯性是否存在。

createGroup(GraphGroupCreationContext, string, string[])

建立新的 Azure DevOps 群組,或具體化現有的 AAD 群組。

createScope(GraphScopeCreationContext, string)
createServicePrincipal(GraphServicePrincipalCreationContext, string[])

將現有的 AAD 服務主體具體化為 ADO 帳戶。

createUser(GraphUserCreationContext, string[])

將現有的 AAD 或 MSA 使用者具體化為 ADO 帳戶。

deleteAvatar(string)
deleteGroup(string)

從其所有父群組中移除 Azure DevOps 群組。

deleteScope(string)
deleteServicePrincipal(string)

停用服務主體。

deleteUser(string)

停用使用者。

getAvatar(string, AvatarSize, string)
getCachePolicies()
getDescriptor(string)

將記憶體金鑰解析為描述項

getFederatedProviderData(string, string, number)

取得指定圖形主體和提供者名稱可用的一組完整同盟提供者驗證數據。

getGroup(string)

依其描述項取得群組。

getMemberByDescriptor(string)

此端點會傳回系統中任何已有效成員的結果,即使成員自已刪除或已刪除其所有成員資格也一樣。 成員的目前有效性會透過其停用的屬性來表示,當 false 時省略。

getMembership(string, string)

取得容器和主體之間的成員資格關聯性。

getMembershipState(string)

檢查主旨為使用中或非使用中。

getProviderInfo(string)
getScope(string)

取得其描述元所識別的範圍

getServicePrincipal(string)

依描述項取得服務主體。

getStorageKey(string)

將描述項解析為記憶體金鑰。

getSubject(string)

將描述項解析為使用者、群組或範圍。

getUser(string)

依其描述項取得使用者。

listMemberships(string, GraphTraversalDirection, number)

取得此描述元是關聯性中成員的所有成員資格。

lookupMembers(GraphSubjectLookup)

取得目前範圍中的所有要求成員, (通常是組織或帳戶) 。

lookupMembershipTraversals(GraphSubjectLookup, GraphTraversalDirection, number)

周游指定主體描述元的成員資格。

lookupSubjects(GraphSubjectLookup)

將描述項解析為批次中 (主體) 的使用者、群組或範圍。

querySubjects(GraphSubjectQuery)

適用於 Azure Devops 使用者或/和群組的 搜尋。 結果會以不超過 100 個圖表主體的批次傳回。

removeMembership(string, string)

刪除容器和主體之間的成員資格。

requestAccess(any)
resolve(IdentityMappings)

批次將使用者清單對應至新使用者。

setAvatar(Avatar, string)
translate(string, string)

身分識別翻譯 - 翻譯端點應該由 geneva 動作使用。

traverseMemberships(string, GraphTraversalDirection, number)

周游指定主體描述元的成員資格。

updateGroup(string, JsonPatchDocument)

更新 Azure DevOps 群組的屬性。

updateScope(string, JsonPatchDocument)
updateServicePrincipal(GraphServicePrincipalUpdateContext, string)

將現有的服務主體對應至不同的服務主體。

updateUser(GraphUserUpdateContext, string)

將現有用戶對應至不同的使用者。

建構函式詳細資料

GraphRestClient(IVssRestClientOptions)

new GraphRestClient(options: IVssRestClientOptions)

參數

屬性詳細資料

RESOURCE_AREA_ID

static RESOURCE_AREA_ID: string

屬性值

string

方法詳細資料

addMembership(string, string)

建立容器與主體之間的新成員資格。

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

參數

subjectDescriptor

string

可以是關聯性中子主體之群組或使用者的描述項。

containerDescriptor

string

可以是關聯性中容器之群組的描述項。

傳回

Promise<GraphMembership>

checkMembershipExistence(string, string)

檢查容器與主體之間的成員資格關聯性是否存在。

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

參數

subjectDescriptor

string

屬於關聯性子主體的群組或使用者。

containerDescriptor

string

屬於關聯性中容器的群組。

傳回

Promise<boolean>

createGroup(GraphGroupCreationContext, string, string[])

建立新的 Azure DevOps 群組,或具體化現有的 AAD 群組。

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

參數

creationContext
GraphGroupCreationContext

用來唯一在外部提供者中尋找圖表主體之完整圖形群組的子集。

scopeDescriptor

string

參考範圍 (集合的描述元,專案) 應該在其中建立群組。 如果省略,將會在封入帳戶或組織的範圍內建立。 僅適用於 VSTS 群組。

groupDescriptors

string[]

參考圖表群組之描述元的逗號分隔清單

傳回

Promise<GraphGroup>

createScope(GraphScopeCreationContext, string)

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

參數

creationContext
GraphScopeCreationContext
scopeDescriptor

string

傳回

Promise<GraphScope>

createServicePrincipal(GraphServicePrincipalCreationContext, string[])

將現有的 AAD 服務主體具體化為 ADO 帳戶。

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

參數

creationContext
GraphServicePrincipalCreationContext

用來唯一在外部提供者中尋找圖形主體之完整圖形服務主體的子集。

groupDescriptors

string[]

您要圖表服務主體加入之群組的逗號分隔描述項清單

傳回

createUser(GraphUserCreationContext, string[])

將現有的 AAD 或 MSA 使用者具體化為 ADO 帳戶。

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

參數

creationContext
GraphUserCreationContext

用來唯一在外部提供者中尋找圖形主體之完整圖形使用者的子集。

groupDescriptors

string[]

您想要讓圖形使用者加入之群組描述元的逗號分隔清單

傳回

Promise<GraphUser>

deleteAvatar(string)

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

參數

subjectDescriptor

string

傳回

Promise<void>

deleteGroup(string)

從其所有父群組中移除 Azure DevOps 群組。

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

參數

groupDescriptor

string

要刪除之群組的描述項。

傳回

Promise<void>

deleteScope(string)

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

參數

scopeDescriptor

string

傳回

Promise<void>

deleteServicePrincipal(string)

停用服務主體。

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

參數

servicePrincipalDescriptor

string

要刪除之服務主體的描述項。

傳回

Promise<void>

deleteUser(string)

停用使用者。

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

參數

userDescriptor

string

要刪除之使用者的描述項。

傳回

Promise<void>

getAvatar(string, AvatarSize, string)

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

參數

subjectDescriptor

string

size
AvatarSize
format

string

傳回

Promise<Avatar>

getCachePolicies()

function getCachePolicies(): Promise<GraphCachePolicies>

傳回

getDescriptor(string)

將記憶體金鑰解析為描述項

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

參數

storageKey

string

要解析之主體的儲存金鑰 (使用者、群組、範圍等 )

傳回

getFederatedProviderData(string, string, number)

取得指定圖形主體和提供者名稱可用的一組完整同盟提供者驗證數據。

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

參數

subjectDescriptor

string

我們應該取得數據的圖形主體描述元

providerName

string

要取得數據的提供者名稱,例如“github.com”

versionHint

number

版本提示,可用於開放式快取並行存取,並支援存取令牌失敗的重試;請注意,這是僅限提示,且不保證回應的特定版本

傳回

getGroup(string)

依其描述項取得群組。

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

參數

groupDescriptor

string

所需圖形群組的描述項。

傳回

Promise<GraphGroup>

getMemberByDescriptor(string)

此端點會傳回系統中任何已有效成員的結果,即使成員自已刪除或已刪除其所有成員資格也一樣。 成員的目前有效性會透過其停用的屬性來表示,當 false 時省略。

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

參數

memberDescriptor

string

所需成員的描述項。

傳回

Promise<GraphMember>

getMembership(string, string)

取得容器和主體之間的成員資格關聯性。

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

參數

subjectDescriptor

string

關聯性中子主體的描述項。

containerDescriptor

string

關聯性中容器的描述項。

傳回

Promise<GraphMembership>

getMembershipState(string)

檢查主旨為使用中或非使用中。

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

參數

subjectDescriptor

string

要檢查狀態的主體描述元 (使用者、群組、範圍等 )

傳回

getProviderInfo(string)

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

參數

userDescriptor

string

傳回

getScope(string)

取得其描述元所識別的範圍

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

參數

scopeDescriptor

string

可唯一識別範圍的描述項。

傳回

Promise<GraphScope>

getServicePrincipal(string)

依描述項取得服務主體。

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

參數

servicePrincipalDescriptor

string

所需服務主體的描述項。

傳回

getStorageKey(string)

將描述項解析為記憶體金鑰。

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

參數

subjectDescriptor

string

傳回

getSubject(string)

將描述項解析為使用者、群組或範圍。

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

參數

subjectDescriptor

string

所需主旨的描述項。

傳回

Promise<GraphSubject>

getUser(string)

依其描述項取得使用者。

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

參數

userDescriptor

string

所需使用者的描述項。

傳回

Promise<GraphUser>

listMemberships(string, GraphTraversalDirection, number)

取得此描述元是關聯性中成員的所有成員資格。

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

參數

subjectDescriptor

string

擷取此描述元的所有直接成員資格。

direction
GraphTraversalDirection

預設值為 Up。

depth

number

要向上或向下周游成員資格樹狀結構的最大邊緣數目。 目前唯一支援的值是 『1』。

傳回

Promise<GraphMembership[]>

lookupMembers(GraphSubjectLookup)

取得目前範圍中的所有要求成員, (通常是組織或帳戶) 。

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

參數

memberLookup
GraphSubjectLookup

傳回

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

lookupMembershipTraversals(GraphSubjectLookup, GraphTraversalDirection, number)

周游指定主體描述元的成員資格。

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

參數

membershipTraversalLookup
GraphSubjectLookup

根據方向擷取描述項清單的子系/上階。

direction
GraphTraversalDirection

預設值為 [未知]。

depth

number

預設值為 '1'。

傳回

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

lookupSubjects(GraphSubjectLookup)

將描述項解析為批次中 (主體) 的使用者、群組或範圍。

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

參數

subjectLookup
GraphSubjectLookup

描述項清單,指定要擷取的主體子集。 每個描述項可唯一識別所有實例範圍的主旨,但只在單一時間點。

傳回

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

querySubjects(GraphSubjectQuery)

適用於 Azure Devops 使用者或/和群組的 搜尋。 結果會以不超過 100 個圖表主體的批次傳回。

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

參數

subjectQuery
GraphSubjectQuery

我們將用來搜尋的查詢包含下列專案:查詢:搜尋字詞。 搜尋只會是前置詞比對。 SubjectKind:可以指定 “User” 或 “Group”,也可以同時指定 ScopeDescriptor:可以指定非預設範圍,亦即專案範圍描述元

傳回

Promise<GraphSubject[]>

removeMembership(string, string)

刪除容器和主體之間的成員資格。

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

參數

subjectDescriptor

string

關聯性中子主體之群組或使用者的描述項。

containerDescriptor

string

關聯性中容器之群組的描述項。

傳回

Promise<void>

requestAccess(any)

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

參數

jsondocument

any

傳回

Promise<void>

resolve(IdentityMappings)

批次將使用者清單對應至新使用者。

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

參數

mappings
IdentityMappings

對應清單。

傳回

setAvatar(Avatar, string)

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

參數

avatar
Avatar
subjectDescriptor

string

傳回

Promise<void>

translate(string, string)

身分識別翻譯 - 翻譯端點應該由 geneva 動作使用。

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

參數

masterId

string

localId

string

傳回

Promise<string>

traverseMemberships(string, GraphTraversalDirection, number)

周游指定主體描述元的成員資格。

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

參數

subjectDescriptor

string

根據方向擷取這個描述元的子系/祖系。

direction
GraphTraversalDirection

預設值為 [未知]。

depth

number

預設值為 '1'。

傳回

updateGroup(string, JsonPatchDocument)

更新 Azure DevOps 群組的屬性。

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

參數

groupDescriptor

string

要修改之群組的描述項。

patchDocument
JsonPatchDocument

JSON+Patch 檔,其中包含要改變的欄位。

傳回

Promise<GraphGroup>

updateScope(string, JsonPatchDocument)

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

參數

scopeDescriptor

string

patchDocument
JsonPatchDocument

傳回

Promise<void>

updateServicePrincipal(GraphServicePrincipalUpdateContext, string)

將現有的服務主體對應至不同的服務主體。

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

參數

updateContext
GraphServicePrincipalUpdateContext

用來在外部提供者中唯一尋找圖形主體的完整圖表服務主體子集。

servicePrincipalDescriptor

string

要更新之服務主體的描述項

傳回

updateUser(GraphUserUpdateContext, string)

將現有用戶對應至不同的使用者。

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

參數

updateContext
GraphUserUpdateContext

用來在外部提供者中唯一尋找圖表主體的完整圖形用戶子集。

userDescriptor

string

要更新之使用者的描述項

傳回

Promise<GraphUser>