Installed Extensions - Update

参考

Service:: Extension Management

API Version:: 6.0-preview.1

更新已安装的扩展。通常，此 API 用于启用或禁用扩展。

PATCH https://extmgmt.dev.azure.com/{organization}/_apis/extensionmanagement/installedextensions?api-version=6.0-preview.1

URI 参数

名称	在	必需	类型	说明
organization	path	True	string	Azure DevOps 组织的名称。
api-version	query	True	string	要使用的 API 版本。这应设置为“6.0-preview.1”才能使用此版本的 API。

请求正文

名称	类型	说明
baseUri	string	用作扩展中定义的其他相对 URI 的基的 URI
constraints	ContributionConstraint[]	此扩展定义的共享约束列表
contributionTypes	ContributionType[]	此扩展定义的贡献类型列表
contributions	Contribution[]	此扩展所做的贡献列表
demands	string[]	此扩展所需的显式要求列表
eventCallbacks	ExtensionEventCallbackCollection	特定扩展事件发生时调用的终结点的集合
extensionId	string	此扩展的友好扩展 ID - 对于给定发布者是唯一的。
extensionName	string	扩展的显示名称。
fallbackBaseUri	string	可用作扩展中定义的其他相对 URI 的基位置的辅助位置
files	ExtensionFile[]	这是扩展提供的一组文件。
flags	ExtensionFlags	与贡献使用者相关的扩展标志
installState	InstalledExtensionState	有关此扩展的特定安装的信息
language	string	库设置的语言区域性名称
lastPublished	string	这表示上次在库中更新扩展的日期/时间。这并不意味着此版本已更新，值表示对扩展的任何版本和所有版本的更改。
licensing	ExtensionLicensing	此扩展在许可方面的行为方式
manifestVersion	number	扩展清单格式/内容的版本
publisherId	string	此扩展的发布者的唯一 ID
publisherName	string	发布者的显示名称
registrationId	string	此扩展的唯一 ID (同一 ID 用于单个扩展的所有版本)
restrictedTo	string[]	默认用户声明应用于所有贡献 (但已指定 restrictedTo 显式) 以控制贡献的可见性。
scopes	string[]	此扩展所需的所有 oauth 作用域的列表
serviceInstanceType	string	ServiceInstanceType (VSTS 服务的 Guid) ，必须可供帐户使用才能安装扩展
version	string	此扩展的版本

响应

名称	类型	说明
200 OK	InstalledExtension	成功的操作

安全性

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Scopes

名称	说明
vso.extension_manage	授予安装、卸载和对已安装扩展执行其他管理操作的能力。

定义

名称	说明
Contribution	由延期做出的个人贡献
ContributionConstraint	指定可用于动态包含/排除给定贡献的约束
ContributionLicensingBehaviorType	此贡献的包含应如何根据许可而变化
ContributionPropertyDescription	有关贡献类型的属性的说明
ContributionPropertyType	用于此属性的值的类型
ContributionType	由 json 架构提供的贡献类型
ExtensionEventCallback	扩展的事件回调的基类
ExtensionEventCallbackCollection	事件回调的集合 - 特定扩展事件发生时调用的终结点。
ExtensionFile
ExtensionFlags	与贡献使用者相关的扩展标志
ExtensionLicensing	扩展应如何处理基于许可的包括贡献
ExtensionStateFlags	已安装扩展的状态
InstalledExtension	表示 VSTS 扩展及其安装状态
InstalledExtensionState	已安装扩展的状态
InstalledExtensionStateIssue	表示安装问题
InstalledExtensionStateIssueType	安装问题类型 (警告、错误)
JObject	表示 JSON 对象。
LicensingOverride	映射对许可行为的贡献

Contribution

由延期做出的个人贡献

名称	类型	说明
constraints	ContributionConstraint[]	应应用于此贡献可用性的约束 (筛选器) 列表
description	string	贡献/类型的说明
id	string	贡献/类型的完全限定标识符
includes	string[]	包括是一组贡献，应将此贡献包含在其目标列表中。
properties	JObject	此贡献的属性/属性
restrictedTo	string[]	要求声明的列表，以便用户查看此贡献 (如匿名、公共、成员...) 。
targets	string[]	此贡献目标 () 的 ID。 (家长贡献)
type	string	贡献类型的 ID
visibleTo	string[]	VisibleTo 可用于限制可以引用给定贡献/类型的人员。此值应为发布者列表，或者扩展访问也受到限制。示例：“ms”- 表示只有“ms”发布者可以引用此名称。 “ms.vss-web” - 表示只有“ms”发布者的“vss-web”扩展可以引用此内容。

ContributionConstraint

指定可用于动态包含/排除给定贡献的约束

名称	类型	说明
group	integer	一个可选属性，可以指定用于将约束组合在一起。组中的所有约束都是 AND 在一起 (必须将所有约束计算为 True，才能将贡献包含在) 。不同的约束组是 OR (只有一个组需要评估为 True，才能将贡献包含在) 。
id	string	共享约束的完全限定标识符
inverse	boolean	如果为 true，则否定筛选器的结果 (如果应用的筛选器返回 false 而不是 true，则包括贡献)
name	string	IContributionFilter 插件的名称
properties	JObject	馈送到贡献筛选器类的属性
relationships	string[]	可以选择性地将约束应用于贡献中定义的一个或多个关系。如果未定义任何关系，则所有关系都与约束相关联。这意味着，如果应用约束，默认行为将完全消除树的贡献。

ContributionLicensingBehaviorType

此贡献的包含应如何根据许可而变化

名称	类型	说明
alwaysInclude	string	无论用户是否获得扩展许可，始终包含贡献
onlyIfLicensed	string	默认值 - 仅当用户获得扩展许可时，才包括贡献
onlyIfUnlicensed	string	仅当用户未获得扩展的许可时，才包括贡献

ContributionPropertyDescription

有关贡献类型的属性的说明

名称	类型	说明
description	string	属性的说明
name	string	属性的名称
required	boolean	如果此属性是必需的，则为 True
type	ContributionPropertyType	用于此属性的值的类型

ContributionPropertyType

用于此属性的值的类型

名称	类型	说明
array	string	值是数组
boolean	string	值为 True 或 False
dateTime	string	值是 DateTime 对象
dictionary	string	值是泛型字典/JObject/属性包
double	string	值为双精度值
guid	string	值是 GUID
integer	string	值是整数
object	string	值是任意/自定义对象
string	string	值是字符串
unknown	string	贡献类型未知 (值可以是任何)
uri	string	值是 URI

ContributionType

由 json 架构提供的贡献类型

名称	类型	说明
description	string	贡献/类型的说明
id	string	贡献/类型的完全限定标识符
indexed	boolean	控制此类型的贡献是否为查询编制了类型索引。这允许客户端查找具有此类型贡献的所有扩展。注意：仅允许 TrustedPartner 指定索引贡献类型。
name	string	贡献/类型的友好名称
properties	<string, ContributionPropertyDescription>	描述此贡献类型的允许属性
visibleTo	string[]	VisibleTo 可用于限制可以引用给定贡献/类型的人员。此值应为发布者列表，或者扩展访问也受到限制。示例：“ms”- 表示只有“ms”发布者可以引用此名称。 “ms.vss-web” - 表示只有“ms”发布者的“vss-web”扩展可以引用此内容。

ExtensionEventCallback

扩展的事件回调的基类

名称	类型	说明
uri	string	事件发生时命中的终结点的 URI

ExtensionEventCallbackCollection

事件回调的集合 - 特定扩展事件发生时调用的终结点。

名称	类型	说明
postDisable	ExtensionEventCallback	可选。定义一个终结点，该终结点通过 POST 请求调用，以通知已禁用扩展。
postEnable	ExtensionEventCallback	可选。定义一个终结点，该终结点通过 POST 请求调用，以通知扩展启用已发生。
postInstall	ExtensionEventCallback	可选。定义通过 POST 请求调用的终结点，以通知扩展安装已完成。
postUninstall	ExtensionEventCallback	可选。定义一个终结点，该终结点通过 POST 请求调用，以通知扩展卸载已发生。
postUpdate	ExtensionEventCallback	可选。定义一个终结点，该终结点通过 POST 请求调用，以通知扩展更新已发生。
preInstall	ExtensionEventCallback	可选。定义一个终结点，该终结点通过 POST 请求调用，以通知即将进行扩展安装。响应指示是继续还是中止。
versionCheck	ExtensionEventCallback	对于多版本扩展，定义通过 OPTIONS 请求调用的终结点，以确定要使用的扩展的特定版本

ExtensionFile

名称	类型	说明
assetType	string
language	string
source	string

ExtensionFlags

与贡献使用者相关的扩展标志

名称	类型	说明
builtIn	string	默认情况下，为所有 VSTS 帐户安装内置扩展
trusted	string	该扩展来自完全信任的发布者

ExtensionLicensing

扩展应如何处理基于许可的包括贡献

名称	类型	说明
overrides	LicensingOverride[]	偏离默认许可行为的贡献列表

ExtensionStateFlags

已安装扩展的状态

名称	类型	说明
autoUpgradeError	string	执行自动升级时出错。例如，如果新版本要求不支持，则无法自动升级扩展。
builtIn	string	扩展是内置的
disabled	string	已禁用扩展
error	string	扩展当前处于错误状态
multiVersion	string	扩展具有多个版本
needsReauthorization	string	扩展范围已更改，扩展需要重新授权
none	string	未设置标志
trusted	string	受信任的扩展是具有特殊功能的扩展。这些内容往往来自 Microsoft，不能由公众发布。注意：BuiltIn 扩展始终受信任。
unInstalled	string	未安装扩展。这仅适用于内置扩展，否则无法设置。
versionCheckError	string	执行版本检查时出错
warning	string	扩展当前处于警告状态，这可能会导致体验降级。例如，检测到某些安装问题（例如不支持隐式需求）可能会导致体验降级。

InstalledExtension

表示 VSTS 扩展及其安装状态

名称	类型	说明
baseUri	string	用作扩展中定义的其他相对 URI 的基的 URI
constraints	ContributionConstraint[]	此扩展定义的共享约束列表
contributionTypes	ContributionType[]	此扩展定义的贡献类型列表
contributions	Contribution[]	此扩展所做的贡献列表
demands	string[]	此扩展所需的显式要求列表
eventCallbacks	ExtensionEventCallbackCollection	特定扩展事件发生时调用的终结点的集合
extensionId	string	此扩展的友好扩展 ID - 对于给定发布者是唯一的。
extensionName	string	扩展的显示名称。
fallbackBaseUri	string	可用作扩展中定义的其他相对 URI 的基位置的辅助位置
files	ExtensionFile[]	这是扩展提供的一组文件。
flags	ExtensionFlags	与贡献使用者相关的扩展标志
installState	InstalledExtensionState	有关此扩展的特定安装的信息
language	string	库设置的语言区域性名称
lastPublished	string	这表示上次在库中更新扩展的日期/时间。这并不意味着此版本已更新，值表示对扩展的任何版本和所有版本的更改。
licensing	ExtensionLicensing	此扩展在许可方面的行为方式
manifestVersion	number	扩展清单格式/内容的版本
publisherId	string	此扩展的发布者的唯一 ID
publisherName	string	发布者的显示名称
registrationId	string	此扩展的唯一 ID (同一 ID 用于单个扩展的所有版本)
restrictedTo	string[]	默认用户声明应用于所有贡献 (但已指定 restrictedTo 显式) 以控制贡献的可见性。
scopes	string[]	此扩展所需的所有 oauth 作用域的列表
serviceInstanceType	string	ServiceInstanceType (VSTS 服务的 Guid) ，必须可供帐户使用才能安装扩展
version	string	此扩展的版本

InstalledExtensionState