Installed Extensions - Update

Riferimento

Service:: Extension Management

API Version:: 6.0-preview.1

Aggiornare un'estensione installata. In genere questa API viene usata per abilitare o disabilitare un'estensione.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
organization	path	True	string	Nome dell'organizzazione di Azure DevOps.
api-version	query	True	string	Versione dell'API da usare. Deve essere impostato su '6.0-preview.1' per usare questa versione dell'API.

Corpo della richiesta

Nome	Tipo	Descrizione
baseUri	string	URI usato come base per altri URI relativi definiti nell'estensione
constraints	ContributionConstraint[]	Elenco di vincoli condivisi definiti da questa estensione
contributionTypes	ContributionType[]	Elenco dei tipi di contributo definiti da questa estensione
contributions	Contribution[]	Elenco dei contributi effettuati da questa estensione
demands	string[]	Elenco di richieste esplicite richieste richieste da questa estensione
eventCallbacks	ExtensionEventCallbackCollection	Raccolta di endpoint che vengono chiamati quando si verificano eventi di estensione specifici
extensionId	string	ID dell'estensione descrittivo per questa estensione, univoco per un determinato server di pubblicazione.
extensionName	string	Nome visualizzato dell'estensione.
fallbackBaseUri	string	Posizione secondaria che può essere usata come base per altri URI relativi definiti nell'estensione
files	ExtensionFile[]	Questo è il set di file disponibili dall'estensione.
flags	ExtensionFlags	Flag di estensione rilevanti per i consumer di contributi
installState	InstalledExtensionState	Informazioni su questa particolare installazione dell'estensione
language	string	Nome impostazioni cultura lingua impostate dalla raccolta
lastPublished	string	Rappresenta la data/ora dell'ultimo aggiornamento delle estensioni nella raccolta. Ciò non significa che questa versione è stata aggiornata, il valore rappresenta le modifiche apportate a qualsiasi versione e a tutte le versioni dell'estensione.
licensing	ExtensionLicensing	Comportamento di questa estensione rispetto alle licenze
manifestVersion	number	Versione del formato/contenuto del manifesto dell'estensione
publisherId	string	ID univoco dell'autore di questa estensione
publisherName	string	Nome visualizzato del server di pubblicazione
registrationId	string	ID univoco per questa estensione (lo stesso ID viene usato per tutte le versioni di una singola estensione)
restrictedTo	string[]	Attestazioni utente predefinite applicate a tutti i contributi (ad eccezione di quelli specificati con restrizioni In modo esplicito) per controllare la visibilità di un contributo.
scopes	string[]	Elenco di tutti gli ambiti oauth richiesti da questa estensione
serviceInstanceType	string	ServiceInstanceType(Guid) del servizio VSTS che deve essere disponibile per un account affinché l'estensione venga installata
version	string	Versione di questa estensione

Risposte

Nome	Tipo	Descrizione
200 OK	InstalledExtension	operazione riuscita

Sicurezza

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

Nome	Descrizione
vso.extension_manage	Concede la possibilità di installare, disinstallare ed eseguire altre azioni amministrative nelle estensioni installate.

Definizioni

Nome	Descrizione
Contribution	Contributo individuale effettuato da un'estensione
ContributionConstraint	Specifica un vincolo che può essere utilizzato per includere/escludere in modo dinamico un determinato contributo
ContributionLicensingBehaviorType	In che modo l'inclusione di questo contributo deve cambiare in base alle licenze
ContributionPropertyDescription	Descrizione di una proprietà di un tipo di contributo
ContributionPropertyType	Tipo di valore utilizzato per questa proprietà
ContributionType	Tipo di contributo, fornito da uno schema json
ExtensionEventCallback	Classe base per un callback di eventi per un'estensione
ExtensionEventCallbackCollection	Raccolta di callback di eventi: endpoint chiamati quando si verificano eventi di estensione specifici.
ExtensionFile
ExtensionFlags	Flag di estensione rilevanti per i consumer di contributi
ExtensionLicensing	Modalità di gestione di un'estensione, inclusi i contributi in base alle licenze
ExtensionStateFlags	Stati di un'estensione installata
InstalledExtension	Rappresenta un'estensione VSTS insieme allo stato di installazione
InstalledExtensionState	Stato di un'estensione installata
InstalledExtensionStateIssue	Rappresenta un problema di installazione
InstalledExtensionStateIssueType	Tipo di problema di installazione (avviso, errore)
JObject	Rappresenta un oggetto JSON.
LicensingOverride	Esegue il mapping di un contributo a un comportamento di licenza

Contribution

Contributo individuale effettuato da un'estensione

Nome	Tipo	Descrizione
constraints	ContributionConstraint[]	Elenco di vincoli (filtri) da applicare alla disponibilità di questo contributo
description	string	Descrizione del contributo/tipo
id	string	Identificatore completo del contributo/tipo
includes	string[]	Include è un set di contributi che devono includere questo contributo nell'elenco delle destinazioni.
properties	JObject	Proprietà/attributi di questo contributo
restrictedTo	string[]	Elenco delle attestazioni richieste per consentire all'utente di visualizzare questo contributo (ad esempio anonimo, pubblico, membro...).
targets	string[]	ID dei contributi a cui è destinato questo contributo. (contributi padre)
type	string	ID del tipo di contributo
visibleTo	string[]	VisibleTo può essere usato per limitare chi può fare riferimento a un determinato contributo/tipo. Questo valore deve essere anche un elenco di autori o di accesso alle estensioni. Esempi: "ms" - Indica che solo l'autore "ms" può fare riferimento a questo. "ms.vss-web" - Significa che solo l'estensione "vss-web" del server di pubblicazione "ms" può fare riferimento a questo.

ContributionConstraint

Specifica un vincolo che può essere utilizzato per includere/escludere in modo dinamico un determinato contributo

Nome	Tipo	Descrizione
group	integer	Proprietà facoltativa che può essere specificata per raggruppare i vincoli. Tutti i vincoli all'interno di un gruppo sono AND'd insieme (tutti devono essere valutati su True per poter includere il contributo). I diversi gruppi di vincoli sono OR(solo un gruppo deve restituire True per includere il contributo).
id	string	Identificatore completo di un vincolo condiviso
inverse	boolean	Se true, negare il risultato del filtro (includere il contributo se il filtro applicato restituisce false anziché true)
name	string	Nome del plug-in IContributionFilter
properties	JObject	Proprietà immesse nella classe di filtro dei contributi
relationships	string[]	Facoltativamente, i vincoli possono essere applicati a una o più delle relazioni definite nel contributo. Se non vengono definite relazioni, tutte le relazioni vengono associate al vincolo. Ciò significa che il comportamento predefinito eliminerà completamente il contributo dall'albero se viene applicato il vincolo.

ContributionLicensingBehaviorType

In che modo l'inclusione di questo contributo deve cambiare in base alle licenze

Nome	Tipo	Descrizione
alwaysInclude	string	Includere sempre il contributo indipendentemente dal fatto che l'utente abbia o meno la licenza per l'estensione
onlyIfLicensed	string	Valore predefinito: includere il contributo solo se l'utente ha una licenza per l'estensione
onlyIfUnlicensed	string	Includere il contributo solo se l'utente non ha licenza per l'estensione

ContributionPropertyDescription

Descrizione di una proprietà di un tipo di contributo

Nome	Tipo	Descrizione
description	string	Descrizione della proprietà
name	string	Nome della proprietà
required	boolean	True se questa proprietà è obbligatoria
type	ContributionPropertyType	Tipo di valore utilizzato per questa proprietà

ContributionPropertyType

Tipo di valore utilizzato per questa proprietà

Nome	Tipo	Descrizione
array	string	Value è una matrice
boolean	string	Il valore è True o False
dateTime	string	Value è un oggetto DateTime
dictionary	string	Value è un contenitore generico dizionario/JObject/proprietà
double	string	Il valore è un valore double
guid	string	Value è un GUID
integer	string	Il valore è un numero intero
object	string	Value è un oggetto arbitrario/personalizzato
string	string	Il valore è una stringa
unknown	string	Il tipo di contributo è sconosciuto (il valore può essere qualsiasi elemento)
uri	string	Value è un URI

ContributionType

Tipo di contributo, fornito da uno schema json

Nome	Tipo	Descrizione
description	string	Descrizione del contributo/tipo
id	string	Identificatore completo del contributo/tipo
indexed	boolean	Controlla se i contributi di questo tipo hanno il tipo indicizzato per le query. Ciò consente ai client di trovare tutte le estensioni che hanno un contributo di questo tipo. NOTA: solo TrustedPartners è autorizzato a specificare tipi di contributi indicizzati.
name	string	Nome descrittivo del contributo/tipo
properties	<string, ContributionPropertyDescription>	Descrive le proprietà consentite per questo tipo di contributo
visibleTo	string[]	VisibleTo può essere usato per limitare chi può fare riferimento a un determinato contributo/tipo. Questo valore deve essere anche un elenco di autori o di accesso alle estensioni. Esempi: "ms" - Indica che solo l'autore "ms" può fare riferimento a questo. "ms.vss-web" - Significa che solo l'estensione "vss-web" del server di pubblicazione "ms" può fare riferimento a questo.

ExtensionEventCallback

Classe base per un callback di eventi per un'estensione

Nome	Tipo	Descrizione
uri	string	URI dell'endpoint che viene raggiunto quando si verifica un evento

ExtensionEventCallbackCollection

Raccolta di callback di eventi: endpoint chiamati quando si verificano eventi di estensione specifici.

Nome	Tipo	Descrizione
postDisable	ExtensionEventCallback	Facoltativa. Definisce un endpoint che viene chiamato tramite una richiesta POST per notificare che si è verificata una disabilitazione dell'estensione.
postEnable	ExtensionEventCallback	Facoltativa. Definisce un endpoint che viene chiamato tramite una richiesta POST per notificare che si è verificata un'estensione abilitata.
postInstall	ExtensionEventCallback	Facoltativa. Definisce un endpoint che viene chiamato tramite una richiesta POST per notificare che un'installazione dell'estensione è stata completata.
postUninstall	ExtensionEventCallback	Facoltativa. Definisce un endpoint che viene chiamato tramite una richiesta POST per notificare che si è verificata una disinstallazione dell'estensione.
postUpdate	ExtensionEventCallback	Facoltativa. Definisce un endpoint che viene chiamato tramite una richiesta POST per notificare che si è verificato un aggiornamento dell'estensione.
preInstall	ExtensionEventCallback	Facoltativa. Definisce un endpoint che viene chiamato tramite una richiesta POST per notificare che l'installazione di un'estensione sta per verificarsi. La risposta indica se procedere o interrompere.
versionCheck	ExtensionEventCallback	Per le estensioni a più versioni, definisce un endpoint che viene chiamato tramite una richiesta OPTIONS per determinare la versione specifica dell'estensione da usare

ExtensionFile

Nome	Tipo	Descrizione
assetType	string
language	string
source	string

ExtensionFlags

Flag di estensione rilevanti per i consumer di contributi

Nome	Tipo	Descrizione
builtIn	string	Un'estensione predefinita viene installata per tutti gli account VSTS per impostazione predefinita
trusted	string	L'estensione proviene da un editore completamente attendibile

ExtensionLicensing

Modalità di gestione di un'estensione, inclusi i contributi in base alle licenze

Nome	Tipo	Descrizione
overrides	LicensingOverride[]	Elenco dei contributi che deviano dal comportamento predefinito delle licenze

ExtensionStateFlags

Stati di un'estensione installata

Nome	Tipo	Descrizione
autoUpgradeError	string	Errore durante l'aggiornamento automatico. Ad esempio, se la nuova versione non supporta l'estensione non può essere aggiornata automaticamente.
builtIn	string	L'estensione è incorporata
disabled	string	L'estensione è disabilitata
error	string	L'estensione è attualmente in stato di errore
multiVersion	string	L'estensione ha più versioni
needsReauthorization	string	Gli ambiti di estensione sono stati modificati e l'estensione richiede la ri-autorizzazione
none	string	Nessun flag impostato
trusted	string	Le estensioni attendibili sono quelle che offrono funzionalità speciali. Questi tendono a provenire da Microsoft e non possono essere pubblicati dal pubblico generale. Nota: le estensioni BuiltIn sono sempre attendibili.
unInstalled	string	L'estensione non è installata. Questo è solo per le estensioni predefinite e non può essere impostato in caso contrario.
versionCheckError	string	Errore durante l'esecuzione del controllo della versione
warning	string	L'estensione è attualmente in uno stato di avviso, che può causare un'esperienza danneggiata. L'esperienza danneggiata può essere causata, ad esempio, da alcuni problemi di installazione rilevati, ad esempio richieste implicite non supportate.