CoreRestClient class

Pakiet:

azure-devops-extension-api

Klasa bazowa, która powinna być używana (pochodna) do tworzenia żądań do interfejsów API REST usługi VSS

Extends

RestClientBase

Konstruktory

CoreRestClient(IVssRestClientOptions)

Właściwości

RESOURCE_AREA_ID

Metody

createConnectedService(WebApiConnectedServiceDetails, string)
createIdentityMru(IdentityData, string)
createOrUpdateProxy(Proxy)
createTeam(WebApiTeam, string)	Utwórz zespół w projekcie zespołowym.
deleteIdentityMru(IdentityData, string)
deleteProxy(string, string)
deleteTeam(string, string)	Usuwanie zespołu.
getAllTeams(boolean, number, number, boolean)	Pobierz listę wszystkich zespołów.
getConnectedServiceDetails(string, string)
getConnectedServices(string, ConnectedServiceKind)
getIdentityMru(string)
getProcessById(string)	Pobieranie procesu według identyfikatora.
getProcesses()	Pobieranie listy procesów.
getProject(string, boolean, boolean)	Pobierz projekt z określonym identyfikatorem lub nazwą, opcjonalnie łącznie z możliwościami.
getProjectCollection(string)	Pobierz kolekcję projektów z określonym identyfikatorem lub nazwą.
getProjectCollections(number, number)	Pobierz odwołania do kolekcji projektów dla tej aplikacji.
getProjectHistoryEntries(number)	Pobiera historię zmian w projekcie.
getProjectProperties(string, string[])	Pobierz kolekcję właściwości projektu zespołowego.
getProjects(any, number, number, number, boolean)	Pobierz wszystkie projekty w organizacji, do których ma dostęp uwierzytelniony użytkownik.
getProjectsProperties(string[], string[])	Pobierz kolekcję właściwości projektu zespołowego dla wielu projektów.
getProjectTeamsByCategory(string, boolean, number, number)	Pobiera listę zespołów czytelnych dla użytkowników w projekcie, a użytkownik zespołu jest członkiem grupy (wykluczonej z listy z możliwością odczytu).
getProxies(string)
getTeam(string, string, boolean)	Uzyskaj określony zespół.
getTeamMembersWithExtendedProperties(string, string, number, number)	Pobierz listę członków dla określonego zespołu.
getTeams(string, boolean, number, number, boolean)	Pobierz listę zespołów.
queueCreateProject(TeamProject)	Kolejkuje projekt do utworzenia. Użyj polecenia GetOperation , aby okresowo sprawdzać stan tworzenia projektu.
queueDeleteProject(string)	Kolejkuje projekt do usunięcia. Użyj polecenia GetOperation , aby okresowo sprawdzać stan projektu usuwania.
removeProjectAvatar(string)	Usuwa awatar dla projektu.
setProjectAvatar(ProjectAvatar, string)	Ustawia awatar dla projektu.
setProjectProperties(string, JsonPatchDocument)	Tworzenie, aktualizowanie i usuwanie właściwości projektu zespołowego.
updateIdentityMru(IdentityData, string)
updateProject(TeamProject, string)	Zaktualizuj nazwę istniejącego projektu, skrót, opis lub przywróć projekt.
updateTeam(WebApiTeam, string, string)	Zaktualizuj nazwę i/lub opis zespołu.

Szczegóły konstruktora

CoreRestClient(IVssRestClientOptions)

new CoreRestClient(options: IVssRestClientOptions)

Parametry

options

IVssRestClientOptions

Szczegóły właściwości

RESOURCE_AREA_ID

static RESOURCE_AREA_ID: string

Wartość właściwości

string

Szczegóły metody

createConnectedService(WebApiConnectedServiceDetails, string)

function createConnectedService(connectedServiceCreationData: WebApiConnectedServiceDetails, projectId: string): Promise<WebApiConnectedService>

Parametry

connectedServiceCreationData

WebApiConnectedServiceDetails

projectId

string

Zwraca

Promise<WebApiConnectedService>

createIdentityMru(IdentityData, string)

function createIdentityMru(mruData: IdentityData, mruName: string): Promise<void>

Parametry

mruData

IdentityData

mruName

string

Zwraca

Promise<void>

createOrUpdateProxy(Proxy)

function createOrUpdateProxy(proxy: Proxy): Promise<Proxy>

Parametry

proxy

Proxy

Zwraca

Promise<Proxy>

createTeam(WebApiTeam, string)

Utwórz zespół w projekcie zespołowym.

function createTeam(team: WebApiTeam, projectId: string): Promise<WebApiTeam>

Parametry

team

WebApiTeam

Dane zespołu użyte do utworzenia zespołu.

projectId

string

Nazwa lub identyfikator (GUID) projektu zespołowego, w którym ma zostać utworzony zespół.

Zwraca

Promise<WebApiTeam>

deleteIdentityMru(IdentityData, string)

function deleteIdentityMru(mruData: IdentityData, mruName: string): Promise<void>

Parametry

mruData

IdentityData

mruName

string

Zwraca

Promise<void>

deleteProxy(string, string)

function deleteProxy(proxyUrl: string, site?: string): Promise<void>

Parametry

proxyUrl

string

site

string

Zwraca

Promise<void>

deleteTeam(string, string)

Usuwanie zespołu.

function deleteTeam(projectId: string, teamId: string): Promise<void>

Parametry

projectId

string

Nazwa lub identyfikator (GUID) projektu zespołowego zawierającego zespół do usunięcia.

teamId

string

Nazwa lub identyfikator zespołu do usunięcia.

Zwraca

Promise<void>

getAllTeams(boolean, number, number, boolean)

Pobierz listę wszystkich zespołów.

function getAllTeams(mine?: boolean, top?: number, skip?: number, expandIdentity?: boolean): Promise<WebApiTeam[]>

Parametry

mine

boolean

Jeśli wartość true, zwróć wszystkie zespoły, które żądają użytkownika, są członkami. W przeciwnym razie zwróć wszystkich użytkowników zespołów, którzy mają dostęp do odczytu.

top

number

Maksymalna liczba zespołów do powrotu.

skip

number

Liczba zespołów do pominięcia.

expandIdentity

boolean

Wartość wskazująca, czy należy rozwinąć informacje o tożsamości w wyniku obiektu WebApiTeam.

Zwraca

Promise<WebApiTeam[]>

getConnectedServiceDetails(string, string)

function getConnectedServiceDetails(projectId: string, name: string): Promise<WebApiConnectedServiceDetails>

Parametry

projectId

string

name

string

Zwraca

Promise<WebApiConnectedServiceDetails>

getConnectedServices(string, ConnectedServiceKind)

function getConnectedServices(projectId: string, kind?: ConnectedServiceKind): Promise<WebApiConnectedService[]>

Parametry

projectId

string

kind

ConnectedServiceKind

Zwraca

Promise<WebApiConnectedService[]>

getIdentityMru(string)

function getIdentityMru(mruName: string): Promise<IdentityRef[]>

Parametry

mruName

string

Zwraca

Promise<IdentityRef[]>

getProcessById(string)

Pobieranie procesu według identyfikatora.

function getProcessById(processId: string): Promise<Process>

Parametry

processId

string

Identyfikator procesu.

Zwraca

Promise<Process>

getProcesses()

Pobieranie listy procesów.

function getProcesses(): Promise<Process[]>

Zwraca

Promise<Process[]>

getProject(string, boolean, boolean)

Pobierz projekt z określonym identyfikatorem lub nazwą, opcjonalnie łącznie z możliwościami.

function getProject(projectId: string, includeCapabilities?: boolean, includeHistory?: boolean): Promise<TeamProject>

Parametry

projectId

string

includeCapabilities

boolean

Uwzględnij możliwości (takie jak kontrola źródła) w wyniku projektu zespołowego (wartość domyślna: false).

includeHistory

boolean

Wyszukaj w zmienionych nazwach projektów (które miały taką nazwę w przeszłości).

Zwraca

Promise<TeamProject>

getProjectCollection(string)

Pobierz kolekcję projektów z określonym identyfikatorem lub nazwą.

function getProjectCollection(collectionId: string): Promise<TeamProjectCollection>

Parametry

collectionId

string

Zwraca

Promise<TeamProjectCollection>

getProjectCollections(number, number)

Pobierz odwołania do kolekcji projektów dla tej aplikacji.

function getProjectCollections(top?: number, skip?: number): Promise<TeamProjectCollectionReference[]>

Parametry

top

number

skip

number

Zwraca

Promise<TeamProjectCollectionReference[]>

getProjectHistoryEntries(number)

Pobiera historię zmian w projekcie.

function getProjectHistoryEntries(minRevision?: number): Promise<ProjectInfo[]>

Parametry

minRevision

number

Minimalny numer poprawki, który ma być zwracany w historii.

Zwraca

Promise<ProjectInfo[]>

getProjectProperties(string, string[])

Pobierz kolekcję właściwości projektu zespołowego.

function getProjectProperties(projectId: string, keys?: string[]): Promise<ProjectProperty[]>

Parametry

projectId

string

Identyfikator projektu zespołowego.

keys

string[]

Rozdzielany przecinkami ciąg nazw właściwości projektu zespołowego. Obsługiwane są symbole wieloznaczne ("?" i "*"). Jeśli żaden klucz nie zostanie określony, zostaną zwrócone wszystkie właściwości.

Zwraca

Promise<ProjectProperty[]>

getProjects(any, number, number, number, boolean)

Pobierz wszystkie projekty w organizacji, do których ma dostęp uwierzytelniony użytkownik.

function getProjects(stateFilter?: any, top?: number, skip?: number, continuationToken?: number, getDefaultTeamImageUrl?: boolean): Promise<PagedList<TeamProjectReference>>

Parametry

stateFilter

any

Filtrowanie projektów zespołowych w określonym stanie projektu zespołowego (ustawienie domyślne: WellFormed).

top

number

skip

number

continuationToken

number

Wskaźnik pokazujący, ile projektów zostało już pobranych.

getDefaultTeamImageUrl

boolean

Zwraca

Promise<PagedList<TeamProjectReference>>

getProjectsProperties(string[], string[])

Pobierz kolekcję właściwości projektu zespołowego dla wielu projektów.

function getProjectsProperties(projectIds: string[], properties?: string[]): Promise<ProjectProperties[]>

Parametry

projectIds

string[]

Rozdzielany przecinkami ciąg identyfikatorów projektów zespołowych

properties

string[]

Zwraca

Promise<ProjectProperties[]>

getProjectTeamsByCategory(string, boolean, number, number)

Pobiera listę zespołów czytelnych dla użytkowników w projekcie, a użytkownik zespołu jest członkiem grupy (wykluczonej z listy z możliwością odczytu).

function getProjectTeamsByCategory(projectId: string, expandIdentity?: boolean, top?: number, skip?: number): Promise<CategorizedWebApiTeams>

Parametry

projectId

string

Nazwa lub identyfikator (GUID) projektu zespołowego zawierającego zespoły do pobrania.

expandIdentity

boolean

Wartość wskazująca, czy należy rozwinąć informacje o tożsamości w wyniku obiektu WebApiTeam.

top

number

Maksymalna liczba zespołów do powrotu.

skip

number

Liczba zespołów do pominięcia.

Zwraca

Promise<CategorizedWebApiTeams>

getProxies(string)

function getProxies(proxyUrl?: string): Promise<Proxy[]>

Parametry

proxyUrl

string

Zwraca

Promise<Proxy[]>

getTeam(string, string, boolean)

Uzyskaj określony zespół.

function getTeam(projectId: string, teamId: string, expandIdentity?: boolean): Promise<WebApiTeam>

Parametry

projectId

string

Nazwa lub identyfikator (GUID) projektu zespołowego zawierającego zespół.

teamId

string

Nazwa lub identyfikator (GUID) zespołu.

expandIdentity

boolean

Wartość wskazująca, czy należy rozwinąć informacje o tożsamości w wyniku obiektu WebApiTeam.

Zwraca

Promise<WebApiTeam>

getTeamMembersWithExtendedProperties(string, string, number, number)

Pobierz listę członków dla określonego zespołu.

function getTeamMembersWithExtendedProperties(projectId: string, teamId: string, top?: number, skip?: number): Promise<TeamMember[]>

Parametry

projectId

string

Nazwa lub identyfikator (GUID) projektu zespołowego, do którego należy zespół.

teamId

string

Nazwa lub identyfikator (GUID) zespołu .

top

number

skip

number

Zwraca

Promise<TeamMember[]>

getTeams(string, boolean, number, number, boolean)

Pobierz listę zespołów.

function getTeams(projectId: string, mine?: boolean, top?: number, skip?: number, expandIdentity?: boolean): Promise<WebApiTeam[]>

Parametry

projectId

string

mine

boolean

Jeśli wartość true zwraca wszystkie zespoły żądające użytkownika, w przeciwnym razie zwróć dostęp do odczytu wszystkich użytkowników zespołów.

top

number

Maksymalna liczba zespołów do powrotu.

skip

number

Liczba zespołów do pominięcia.

expandIdentity

boolean

Wartość wskazująca, czy należy rozwinąć informacje o tożsamości w wyniku obiektu WebApiTeam.

Zwraca

Promise<WebApiTeam[]>

queueCreateProject(TeamProject)

Kolejkuje projekt do utworzenia. Użyj polecenia GetOperation , aby okresowo sprawdzać stan tworzenia projektu.

function queueCreateProject(projectToCreate: TeamProject): Promise<OperationReference>

Parametry

projectToCreate

TeamProject

Projekt do utworzenia.

Zwraca

Promise<OperationReference>

queueDeleteProject(string)

Kolejkuje projekt do usunięcia. Użyj polecenia GetOperation , aby okresowo sprawdzać stan projektu usuwania.

function queueDeleteProject(projectId: string): Promise<OperationReference>

Parametry

projectId

string

Identyfikator projektu do usunięcia.

Zwraca

Promise<OperationReference>

removeProjectAvatar(string)

Usuwa awatar dla projektu.

function removeProjectAvatar(projectId: string): Promise<void>

Parametry

projectId

string

Identyfikator lub nazwa projektu.

Zwraca

Promise<void>

setProjectAvatar(ProjectAvatar, string)

Ustawia awatar dla projektu.

function setProjectAvatar(avatarBlob: ProjectAvatar, projectId: string): Promise<void>

Parametry

avatarBlob

ProjectAvatar

Obiekt danych obiektu blob awatara do przekazania.

projectId

string

Identyfikator lub nazwa projektu.

Zwraca

Promise<void>

setProjectProperties(string, JsonPatchDocument)

Tworzenie, aktualizowanie i usuwanie właściwości projektu zespołowego.

function setProjectProperties(projectId: string, patchDocument: JsonPatchDocument): Promise<void>

Parametry

projectId

string

Identyfikator projektu zespołowego.

patchDocument

JsonPatchDocument

Dokument poprawki JSON reprezentujący tablicę operacji właściwości. Aby uzyskać więcej informacji na temat poprawki JSON, zobacz RFC 6902. Zaakceptowane czasowniki operacji to Dodaj i Usuń, gdzie polecenie Add jest używane zarówno do tworzenia, jak i aktualizowania właściwości. Ścieżka składa się z ukośnika i nazwy właściwości.

Zwraca

Promise<void>

updateIdentityMru(IdentityData, string)

function updateIdentityMru(mruData: IdentityData, mruName: string): Promise<void>

Parametry

mruData

IdentityData

mruName

string

Zwraca

Promise<void>

updateProject(TeamProject, string)

Zaktualizuj nazwę istniejącego projektu, skrót, opis lub przywróć projekt.

function updateProject(projectUpdate: TeamProject, projectId: string): Promise<OperationReference>

Parametry

projectUpdate

TeamProject

Aktualizacje projektu. Aby przywrócić projekt, należy ustawić stan wellFormed.

projectId

string

Identyfikator projektu do zaktualizowania.

Zwraca

Promise<OperationReference>

updateTeam(WebApiTeam, string, string)

Zaktualizuj nazwę i/lub opis zespołu.

function updateTeam(teamData: WebApiTeam, projectId: string, teamId: string): Promise<WebApiTeam>

Parametry

teamData

WebApiTeam

projectId

string

Nazwa lub identyfikator (GUID) projektu zespołowego zawierającego zespół do zaktualizowania.

teamId

string

Nazwa identyfikatora zespołu do zaktualizowania.

Zwraca

Promise<WebApiTeam>