CoreRestClient class

Balíček:

azure-devops-extension-api

Základní třída, která by se měla použít (odvozená) k provádění požadavků na rozhraní REST API služby VSS

Extends

RestClientBase

Konstruktory

CoreRestClient(IVssRestClientOptions)

Vlastnosti

RESOURCE_AREA_ID

Metody

createConnectedService(WebApiConnectedServiceDetails, string)
createIdentityMru(IdentityData, string)
createOrUpdateProxy(Proxy)
createTeam(WebApiTeam, string)	Vytvořte tým v týmovém projektu.
deleteIdentityMru(IdentityData, string)
deleteProxy(string, string)
deleteTeam(string, string)	Odstraňte tým.
getAllTeams(boolean, number, number, boolean)	Získejte seznam všech týmů.
getConnectedServiceDetails(string, string)
getConnectedServices(string, ConnectedServiceKind)
getIdentityMru(string)
getProcessById(string)	Získejte proces podle ID.
getProcesses()	Získejte seznam procesů.
getProject(string, boolean, boolean)	Získejte projekt se zadaným ID nebo názvem, volitelně včetně funkcí.
getProjectCollection(string)	Získejte kolekci projektů se zadaným ID nebo názvem.
getProjectCollections(number, number)	Získejte odkazy na kolekci projektů pro tuto aplikaci.
getProjectHistoryEntries(number)	Získá historii změn projektu.
getProjectProperties(string, string[])	Získejte kolekci vlastností týmového projektu.
getProjects(any, number, number, number, boolean)	Získejte všechny projekty v organizaci, ke kterým má ověřený uživatel přístup.
getProjectsProperties(string[], string[])	Získejte kolekci vlastností týmového projektu pro více projektů.
getProjectTeamsByCategory(string, boolean, number, number)	Získá seznam uživatelů čitelných týmů v projektu a uživatel týmů je členem (vyloučen ze seznamu čitelného).
getProxies(string)
getTeam(string, string, boolean)	Získejte konkrétní tým.
getTeamMembersWithExtendedProperties(string, string, number, number)	Získejte seznam členů pro konkrétní tým.
getTeams(string, boolean, number, number, boolean)	Získejte seznam týmů.
queueCreateProject(TeamProject)	Zařadí projekt do fronty, který se má vytvořit. Pomocí GetOperation pravidelně kontrolovat stav projektu vytváření.
queueDeleteProject(string)	Zařadí projekt do fronty, který se má odstranit. Pomocí GetOperation pravidelně kontrolovat stav odstranění projektu.
removeProjectAvatar(string)	Odebere avatara projektu.
setProjectAvatar(ProjectAvatar, string)	Nastaví avatar pro projekt.
setProjectProperties(string, JsonPatchDocument)	Vytvoření, aktualizace a odstranění vlastností týmového projektu
updateIdentityMru(IdentityData, string)
updateProject(TeamProject, string)	Aktualizujte název, zkratku, popis nebo obnovení projektu existujícího projektu.
updateTeam(WebApiTeam, string, string)	Aktualizujte název a/nebo popis týmu.

Podrobnosti konstruktoru

CoreRestClient(IVssRestClientOptions)

new CoreRestClient(options: IVssRestClientOptions)

Parametry

options

IVssRestClientOptions

Podrobnosti vlastnosti

RESOURCE_AREA_ID

static RESOURCE_AREA_ID: string

Hodnota vlastnosti

string

Podrobnosti metody

createConnectedService(WebApiConnectedServiceDetails, string)

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

Parametry

connectedServiceCreationData

WebApiConnectedServiceDetails

projectId

string

Návraty

Promise<WebApiConnectedService>

createIdentityMru(IdentityData, string)

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

Parametry

mruData

IdentityData

mruName

string

Návraty

Promise<void>

createOrUpdateProxy(Proxy)

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

Parametry

proxy

Proxy

Návraty

Promise<Proxy>

createTeam(WebApiTeam, string)

Vytvořte tým v týmovém projektu.

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

Parametry

team

WebApiTeam

Data týmu použitá k vytvoření týmu.

projectId

string

Název nebo ID (GUID) týmového projektu, ve kterém se má tým vytvořit.

Návraty

Promise<WebApiTeam>

deleteIdentityMru(IdentityData, string)

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

Parametry

mruData

IdentityData

mruName

string

Návraty

Promise<void>

deleteProxy(string, string)

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

Parametry

proxyUrl

string

site

string

Návraty

Promise<void>

deleteTeam(string, string)

Odstraňte tým.

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

Parametry

projectId

string

Název nebo IDENTIFIKÁTOR (GUID) týmového projektu obsahujícího tým, který má být odstraněn.

teamId

string

Název nebo ID týmu, které chcete odstranit.

Návraty

Promise<void>

getAllTeams(boolean, number, number, boolean)

Získejte seznam všech týmů.

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

Parametry

mine

boolean

Pokud je hodnota true, vraťte všechny týmy, které požadují uživatele, jsou členy. V opačném případě vrátit přístup ke čtení má všichni uživatelé týmů.

top

number

Maximální počet týmů, které se mají vrátit.

skip

number

Počet týmů, které se mají přeskočit

expandIdentity

boolean

Hodnota označující, zda chcete rozbalit informace o identitě ve výsledku WebApiTeam objektu.

Návraty

Promise<WebApiTeam[]>

getConnectedServiceDetails(string, string)

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

Parametry

projectId

string

name

string

Návraty

Promise<WebApiConnectedServiceDetails>

getConnectedServices(string, ConnectedServiceKind)

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

Parametry

projectId

string

kind

ConnectedServiceKind

Návraty

Promise<WebApiConnectedService[]>

getIdentityMru(string)

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

Parametry

mruName

string

Návraty

Promise<IdentityRef[]>

getProcessById(string)

Získejte proces podle ID.

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

Parametry

processId

string

ID procesu.

Návraty

Promise<Process>

getProcesses()

Získejte seznam procesů.

function getProcesses(): Promise<Process[]>

Návraty

Promise<Process[]>

getProject(string, boolean, boolean)

Získejte projekt se zadaným ID nebo názvem, volitelně včetně funkcí.

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

Parametry

projectId

string

includeCapabilities

boolean

Do výsledku týmového projektu zahrňte možnosti (například správa zdrojového kódu) (výchozí hodnota: nepravda).

includeHistory

boolean

Hledání v přejmenovaných projektech (které měly tento název v minulosti).

Návraty

Promise<TeamProject>

getProjectCollection(string)

Získejte kolekci projektů se zadaným ID nebo názvem.

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

Parametry

collectionId

string

Návraty

Promise<TeamProjectCollection>

getProjectCollections(number, number)

Získejte odkazy na kolekci projektů pro tuto aplikaci.

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

Parametry

top

number

skip

number

Návraty

Promise<TeamProjectCollectionReference[]>

getProjectHistoryEntries(number)

Získá historii změn projektu.

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

Parametry

minRevision

number

Minimální číslo revize, které se má vrátit v historii.

Návraty

Promise<ProjectInfo[]>

getProjectProperties(string, string[])

Získejte kolekci vlastností týmového projektu.

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

Parametry

projectId

string

ID týmového projektu.

keys

string[]

Řetězec vlastností týmového projektu oddělený čárkami. Podporují se zástupné znaky ("?" a "*"). Pokud není zadán žádný klíč, vrátí se všechny vlastnosti.

Návraty

Promise<ProjectProperty[]>

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

Získejte všechny projekty v organizaci, ke kterým má ověřený uživatel přístup.

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

Parametry

stateFilter

any

Filtrování týmových projektů v konkrétním stavu týmového projektu (výchozí hodnota: WellFormed)

top

number

skip

number

continuationToken

number

Ukazatel, který ukazuje, kolik projektů už bylo načteno.

getDefaultTeamImageUrl

boolean

Návraty

Promise<PagedList<TeamProjectReference>>

getProjectsProperties(string[], string[])

Získejte kolekci vlastností týmového projektu pro více projektů.

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

Parametry

projectIds

string[]

Řetězec ID týmového projektu oddělený čárkami

properties

string[]

Návraty

Promise<ProjectProperties[]>

getProjectTeamsByCategory(string, boolean, number, number)

Získá seznam uživatelů čitelných týmů v projektu a uživatel týmů je členem (vyloučen ze seznamu čitelného).

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

Parametry

projectId

string

Název nebo ID (GUID) týmového projektu obsahujícího týmy, které se mají načíst.

expandIdentity

boolean

Hodnota označující, zda chcete rozbalit informace o identitě ve výsledku WebApiTeam objektu.

top

number

Maximální počet týmů, které se mají vrátit.

skip

number

Počet týmů, které se mají přeskočit

Návraty

Promise<CategorizedWebApiTeams>

getProxies(string)

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

Parametry

proxyUrl

string

Návraty

Promise<Proxy[]>

getTeam(string, string, boolean)

Získejte konkrétní tým.

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

Parametry

projectId

string

Název nebo ID (GUID) týmového projektu obsahujícího tým.

teamId

string

Název nebo IDENTIFIKÁTOR (GUID) týmu.

expandIdentity

boolean

Hodnota označující, zda chcete rozbalit informace o identitě ve výsledku WebApiTeam objektu.

Návraty

Promise<WebApiTeam>

getTeamMembersWithExtendedProperties(string, string, number, number)

Získejte seznam členů pro konkrétní tým.

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

Parametry

projectId

string

Název nebo ID (GUID) týmového projektu, do které tým patří.

teamId

string

Název nebo ID (GUID) týmu .

top

number

skip

number

Návraty

Promise<TeamMember[]>

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

Získejte seznam týmů.

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

Parametry

projectId

string

mine

boolean

Pokud je pravda, vrátí všechny týmy žádající o uživatele člena, v opačném případě vrátí přístup ke čtení všem uživatelům týmů.

top

number

Maximální počet týmů, které se mají vrátit.

skip

number

Počet týmů, které se mají přeskočit

expandIdentity

boolean

Hodnota označující, zda chcete rozbalit informace o identitě ve výsledku WebApiTeam objektu.

Návraty

Promise<WebApiTeam[]>

queueCreateProject(TeamProject)

Zařadí projekt do fronty, který se má vytvořit. Pomocí GetOperation pravidelně kontrolovat stav projektu vytváření.

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

Parametry

projectToCreate

TeamProject

Projekt, který chcete vytvořit.

Návraty

Promise<OperationReference>

queueDeleteProject(string)

Zařadí projekt do fronty, který se má odstranit. Pomocí GetOperation pravidelně kontrolovat stav odstranění projektu.

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

Parametry

projectId

string

ID projektu, který chcete odstranit.

Návraty

Promise<OperationReference>

removeProjectAvatar(string)

Odebere avatara projektu.

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

Parametry

projectId

string

ID nebo název projektu.

Návraty

Promise<void>

setProjectAvatar(ProjectAvatar, string)

Nastaví avatar pro projekt.

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

Parametry

avatarBlob

ProjectAvatar

Datový objekt objekt blob avataru, který se má nahrát.

projectId

string

ID nebo název projektu.

Návraty

Promise<void>

setProjectProperties(string, JsonPatchDocument)

Vytvoření, aktualizace a odstranění vlastností týmového projektu

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

Parametry

projectId

string

ID týmového projektu.

patchDocument

JsonPatchDocument

Dokument opravy JSON, který představuje pole operací vlastností. Další podrobnosti o opravě JSON najdete v dokumentu RFC 6902. Akceptované operace jsou Příkazy Přidat a Odebrat, kde Add slouží k vytváření a aktualizaci vlastností. Cesta se skládá z lomítka a názvu vlastnosti.

Návraty

Promise<void>

updateIdentityMru(IdentityData, string)

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

Parametry

mruData

IdentityData

mruName

string

Návraty

Promise<void>

updateProject(TeamProject, string)

Aktualizujte název, zkratku, popis nebo obnovení projektu existujícího projektu.

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

Parametry

projectUpdate

TeamProject

Aktualizace projektu. Stav musí být nastaven na wellFormed pro obnovení projektu.

projectId

string

ID projektu, který se má aktualizovat.

Návraty

Promise<OperationReference>

updateTeam(WebApiTeam, string, string)

Aktualizujte název a/nebo popis týmu.

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

Parametry

teamData

WebApiTeam

projectId

string

Název nebo ID (GUID) týmového projektu obsahujícího tým, který se má aktualizovat.

teamId

string

Název ID týmu, který se má aktualizovat.

Návraty

Promise<WebApiTeam>