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 のバージョン。このバージョンの API を使用するには、これを '6.0-preview.1' に設定する必要があります。

要求本文

名前	型	説明
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 (1 つの拡張機能のすべてのバージョンで同じ ID が使用されます)
restrictedTo	string[]	コントリビューションの可視性を制御するために、すべてのコントリビューションに適用される既定のユーザー要求 (明示的に restrictedTo が指定されたものを除く)。
scopes	string[]	この拡張機能で必要なすべての oauth スコープの一覧
serviceInstanceType	string	拡張機能をインストールするためにアカウントで使用できる必要がある VSTS サービスの ServiceInstanceType(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[]	Includes は、このコントリビューションをターゲットリストに含める必要がある一連のコントリビューションです。
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'd です (コントリビューションを含めるために評価する必要があるグループは 1 つだけです)。
id	string	共有制約の完全修飾識別子
inverse	boolean	true の場合、フィルターの結果を否定します (適用されたフィルターが true ではなく false を返す場合は、コントリビューションを含めます)
name	string	IContributionFilter プラグインの名前
properties	JObject	コントリビューションフィルタークラスにフィードされるプロパティ
relationships	string[]	制約は、必要に応じて、コントリビューションで定義されている 1 つ以上のリレーションシップに適用できます。リレーションシップが定義されていない場合は、すべてのリレーションシップが制約に関連付けられます。つまり、制約が適用されている場合、既定の動作ではツリーからの寄与が完全に排除されます。

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	値は汎用 Dictionary/JObject/property bag です
double	string	値は double です
guid	string	値は GUID です
integer	string	値は整数です
object	string	値は任意の/カスタムオブジェクトです
string	string	値は文字列です
unknown	string	コントリビューションの種類が不明です (値は何でもかまいません)
uri	string	値は URI です

ContributionType

json スキーマによって指定されるコントリビューション型

名前	型	説明
description	string	コントリビューション/タイプの説明
id	string	コントリビューション/型の完全修飾識別子
indexed	boolean	この型のコントリビューションにクエリのインデックスを作成するかどうかを制御します。これにより、クライアントは、この型のコントリビューションを持つすべての拡張機能を検索できます。注: インデックス付きコントリビューションの種類を指定できるのは TrustedPartners のみです。
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	拡張機能は現在警告状態であり、エクスペリエンスが低下する可能性があります。エクスペリエンスの低下は、たとえば、暗黙的な要求がサポートされていないなど、検出された一部のインストールの問題によって発生する可能性があります。