共用方式為


ServiceEndpointRestClient class

應該用來對 VSS REST API 提出要求的基類(衍生自)

Extends

建構函式

ServiceEndpointRestClient(IVssRestClientOptions)

屬性

RESOURCE_AREA_ID

方法

addServiceEndpointExecutionRecords(ServiceEndpointExecutionRecordsInput, string)

新增服務端點執行記錄。

createAadOAuthRequest(string, string, AadLoginPromptOption, string, boolean)
createOAuthConfiguration(OAuthConfigurationParams)
createServiceEndpoint(ServiceEndpoint)

建立新的服務端點

deleteOAuthConfiguration(string)
deleteServiceEndpoint(string, string[], boolean)

刪除服務端點

executeServiceEndpointRequest(ServiceEndpointRequest, string, string)

服務端點所定義 GET 要求的 Proxy。

getAzureManagementGroups()

傳回 Azure 訂用帳戶的清單

getAzureSubscriptions()

傳回 Azure 訂用帳戶的清單

getOAuthConfiguration(string)
getOAuthConfigurations(string, OAuthConfigurationActionFilter)
getServiceEndpointDetails(string, string, ServiceEndpointActionFilter, boolean)

取得服務端點詳細數據。

getServiceEndpointExecutionRecords(string, string, number, number)

取得服務端點執行記錄。

getServiceEndpoints(string, string, string[], string[], string, boolean, boolean, ServiceEndpointActionFilter)

取得服務端點。

getServiceEndpointsByNames(string, string[], string, string[], string, boolean, boolean)

依名稱取得服務端點。

getServiceEndpointsWithRefreshedAuthentication(RefreshAuthenticationParameters[], string, string[])

取得服務端點並修補新的授權參數

getServiceEndpointTypes(string, string)

取得服務端點類型。

getVstsAadTenantId()
queryServiceEndpoint(DataSourceBinding, string)

服務端點所定義 GET 要求的 Proxy。 要求是使用服務端點中的數據源進行授權。 回應會使用 XPath/Json 型選取器進行篩選。

querySharedProjects(string, string)
shareEndpointWithProject(string, string, string)
shareServiceEndpoint(ServiceEndpointProjectReference[], string)

跨專案共用服務端點

updateOAuthConfiguration(OAuthConfigurationParams, string)
updateServiceEndpoint(ServiceEndpoint, string, string)

更新服務端點

updateServiceEndpoints(ServiceEndpoint[])

更新服務端點。

建構函式詳細資料

ServiceEndpointRestClient(IVssRestClientOptions)

new ServiceEndpointRestClient(options: IVssRestClientOptions)

參數

屬性詳細資料

RESOURCE_AREA_ID

static RESOURCE_AREA_ID: string

屬性值

string

方法詳細資料

addServiceEndpointExecutionRecords(ServiceEndpointExecutionRecordsInput, string)

新增服務端點執行記錄。

function addServiceEndpointExecutionRecords(input: ServiceEndpointExecutionRecordsInput, project: string): Promise<ServiceEndpointExecutionRecord[]>

參數

input
ServiceEndpointExecutionRecordsInput

要新增的服務端點執行記錄。

project

string

項目識別碼或項目名稱

傳回

createAadOAuthRequest(string, string, AadLoginPromptOption, string, boolean)

function createAadOAuthRequest(tenantId: string, redirectUri: string, promptOption?: AadLoginPromptOption, completeCallbackPayload?: string, completeCallbackByAuthCode?: boolean): Promise<string>

參數

tenantId

string

redirectUri

string

promptOption
AadLoginPromptOption
completeCallbackPayload

string

completeCallbackByAuthCode

boolean

傳回

Promise<string>

createOAuthConfiguration(OAuthConfigurationParams)

function createOAuthConfiguration(configurationParams: OAuthConfigurationParams): Promise<OAuthConfiguration>

參數

configurationParams
OAuthConfigurationParams

傳回

createServiceEndpoint(ServiceEndpoint)

建立新的服務端點

function createServiceEndpoint(endpoint: ServiceEndpoint): Promise<ServiceEndpoint>

參數

endpoint
ServiceEndpoint

要建立的服務端點

傳回

Promise<ServiceEndpoint>

deleteOAuthConfiguration(string)

function deleteOAuthConfiguration(configurationId: string): Promise<OAuthConfiguration>

參數

configurationId

string

傳回

deleteServiceEndpoint(string, string[], boolean)

刪除服務端點

function deleteServiceEndpoint(endpointId: string, projectIds: string[], deep?: boolean): Promise<void>

參數

endpointId

string

要刪除之端點的端點標識碼

projectIds

string[]

需要刪除端點的項目識別碼

deep

boolean

刪除端點所建立的spn

傳回

Promise<void>

executeServiceEndpointRequest(ServiceEndpointRequest, string, string)

服務端點所定義 GET 要求的 Proxy。

function executeServiceEndpointRequest(serviceEndpointRequest: ServiceEndpointRequest, project: string, endpointId: string): Promise<ServiceEndpointRequestResult>

參數

serviceEndpointRequest
ServiceEndpointRequest

服務端點要求。

project

string

項目識別碼或項目名稱

endpointId

string

服務端點的標識碼。

傳回

getAzureManagementGroups()

傳回 Azure 訂用帳戶的清單

function getAzureManagementGroups(): Promise<AzureManagementGroupQueryResult>

傳回

getAzureSubscriptions()

傳回 Azure 訂用帳戶的清單

function getAzureSubscriptions(): Promise<AzureSubscriptionQueryResult>

傳回

getOAuthConfiguration(string)

function getOAuthConfiguration(configurationId: string): Promise<OAuthConfiguration>

參數

configurationId

string

傳回

getOAuthConfigurations(string, OAuthConfigurationActionFilter)

function getOAuthConfigurations(endpointType?: string, actionFilter?: OAuthConfigurationActionFilter): Promise<OAuthConfiguration[]>

參數

endpointType

string

傳回

Promise<OAuthConfiguration[]>

getServiceEndpointDetails(string, string, ServiceEndpointActionFilter, boolean)

取得服務端點詳細數據。

function getServiceEndpointDetails(project: string, endpointId: string, actionFilter?: ServiceEndpointActionFilter, loadConfidetantialData?: boolean): Promise<ServiceEndpoint>

參數

project

string

項目識別碼或項目名稱

endpointId

string

服務端點的標識碼。

actionFilter
ServiceEndpointActionFilter

服務連線的動作篩選。 它會指定可在服務連線上執行的動作。

loadConfidetantialData

boolean

旗標以包含服務端點的機密詳細數據。 這是僅供內部使用。

傳回

Promise<ServiceEndpoint>

getServiceEndpointExecutionRecords(string, string, number, number)

取得服務端點執行記錄。

function getServiceEndpointExecutionRecords(project: string, endpointId: string, top?: number, continuationToken?: number): Promise<PagedList<ServiceEndpointExecutionRecord>>

參數

project

string

項目識別碼或項目名稱

endpointId

string

服務端點的標識碼。

top

number

要取得的服務端點執行記錄數目。

continuationToken

number

由先前呼叫這個方法所傳回的接續令牌,可用來傳回下一組記錄

傳回

getServiceEndpoints(string, string, string[], string[], string, boolean, boolean, ServiceEndpointActionFilter)

取得服務端點。

function getServiceEndpoints(project: string, type?: string, authSchemes?: string[], endpointIds?: string[], owner?: string, includeFailed?: boolean, includeDetails?: boolean, actionFilter?: ServiceEndpointActionFilter): Promise<ServiceEndpoint[]>

參數

project

string

項目識別碼或項目名稱

type

string

服務端點的類型。

authSchemes

string[]

用於服務端點的授權配置。

endpointIds

string[]

服務端點的標識碼。

owner

string

服務端點的擁有者。

includeFailed

boolean

服務端點的失敗旗標。

includeDetails

boolean

旗標以包含服務端點的詳細數據。 這是僅供內部使用,而且所有其他要求的旗標會被視為 false

actionFilter
ServiceEndpointActionFilter

“actionFilter” 參數可讓用戶評估要求者許可權,並擷取符合指定條件的端點清單,確保只會根據其許可權傳回相關的端點

傳回

Promise<ServiceEndpoint[]>

getServiceEndpointsByNames(string, string[], string, string[], string, boolean, boolean)

依名稱取得服務端點。

function getServiceEndpointsByNames(project: string, endpointNames: string[], type?: string, authSchemes?: string[], owner?: string, includeFailed?: boolean, includeDetails?: boolean): Promise<ServiceEndpoint[]>

參數

project

string

項目識別碼或項目名稱

endpointNames

string[]

服務端點的名稱。

type

string

服務端點的類型。

authSchemes

string[]

用於服務端點的授權配置。

owner

string

服務端點的擁有者。

includeFailed

boolean

服務端點的失敗旗標。

includeDetails

boolean

旗標以包含服務端點的詳細數據。 這是僅供內部使用,而且所有其他要求的旗標會被視為 false

傳回

Promise<ServiceEndpoint[]>

getServiceEndpointsWithRefreshedAuthentication(RefreshAuthenticationParameters[], string, string[])

取得服務端點並修補新的授權參數

function getServiceEndpointsWithRefreshedAuthentication(refreshAuthenticationParameters: RefreshAuthenticationParameters[], project: string, endpointIds: string[]): Promise<ServiceEndpoint[]>

參數

refreshAuthenticationParameters

RefreshAuthenticationParameters[]

範圍,所要求的令牌有效性。

project

string

項目識別碼或項目名稱

endpointIds

string[]

服務端點的標識碼。

傳回

Promise<ServiceEndpoint[]>

getServiceEndpointTypes(string, string)

取得服務端點類型。

function getServiceEndpointTypes(type?: string, scheme?: string): Promise<ServiceEndpointType[]>

參數

type

string

服務端點的類型。

scheme

string

服務端點的配置。

傳回

Promise<ServiceEndpointType[]>

getVstsAadTenantId()

function getVstsAadTenantId(): Promise<string>

傳回

Promise<string>

queryServiceEndpoint(DataSourceBinding, string)

服務端點所定義 GET 要求的 Proxy。 要求是使用服務端點中的數據源進行授權。 回應會使用 XPath/Json 型選取器進行篩選。

function queryServiceEndpoint(binding: DataSourceBinding, project: string): Promise<string[]>

參數

binding
DataSourceBinding

描述要擷取的數據源。

project

string

項目識別碼或項目名稱

傳回

Promise<string[]>

querySharedProjects(string, string)

function querySharedProjects(endpointId: string, project: string): Promise<ProjectReference[]>

參數

endpointId

string

project

string

傳回

Promise<ProjectReference[]>

shareEndpointWithProject(string, string, string)

function shareEndpointWithProject(endpointId: string, fromProject: string, withProject: string): Promise<void>

參數

endpointId

string

fromProject

string

withProject

string

傳回

Promise<void>

shareServiceEndpoint(ServiceEndpointProjectReference[], string)

跨專案共用服務端點

function shareServiceEndpoint(endpointProjectReferences: ServiceEndpointProjectReference[], endpointId: string): Promise<void>

參數

endpointProjectReferences

ServiceEndpointProjectReference[]

目標專案的項目參考詳細數據

endpointId

string

要共用之端點的端點標識碼

傳回

Promise<void>

updateOAuthConfiguration(OAuthConfigurationParams, string)

function updateOAuthConfiguration(configurationParams: OAuthConfigurationParams, configurationId: string): Promise<OAuthConfiguration>

參數

configurationParams
OAuthConfigurationParams
configurationId

string

傳回

updateServiceEndpoint(ServiceEndpoint, string, string)

更新服務端點

function updateServiceEndpoint(endpoint: ServiceEndpoint, endpointId: string, operation?: string): Promise<ServiceEndpoint>

參數

endpoint
ServiceEndpoint

已更新端點的數據

endpointId

string

要更新之端點的端點標識碼

operation

string

作業類型

傳回

Promise<ServiceEndpoint>

updateServiceEndpoints(ServiceEndpoint[])

更新服務端點。

function updateServiceEndpoints(endpoints: ServiceEndpoint[]): Promise<ServiceEndpoint[]>

參數

endpoints

ServiceEndpoint[]

要更新的服務端點名稱。

傳回

Promise<ServiceEndpoint[]>