Endpoints - Get Service Endpoints With Refreshed Authentication
Obtient les points de terminaison de service et corriger les nouveaux paramètres d’autorisation
POST https://dev.azure.com/{organization}/{project}/_apis/serviceendpoint/endpoints?endpointIds={endpointIds}&api-version=7.1-preview.4Paramètres URI
| Nom | Dans | Obligatoire | Type | Description |
|---|---|---|---|---|
|
organization
|
path | True |
string |
Nom de l’organisation Azure DevOps. |
|
project
|
path | True |
string |
ID de projet ou nom du projet |
|
api-version
|
query | True |
string |
Version de l’API à utiliser. Cette valeur doit être définie sur « 7.1-preview.4 » pour utiliser cette version de l’API. |
|
endpoint
|
query | True |
string array (uuid) |
ID des points de terminaison de service. |
Corps de la demande
| Nom | Type | Description |
|---|---|---|
| body |
Étendue, Validité du jeton demandé. |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
opération réussie |
Sécurité
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
| Nom | Description |
|---|---|
| vso.serviceendpoint_manage | Accorde la possibilité de lire, d’interroger et de gérer des points de terminaison de service. |
Définitions
| Nom | Description |
|---|---|
|
Endpoint |
Représente l’autorisation utilisée pour le point de terminaison de service. |
|
Identity |
|
| JObject |
Représente un objet JSON. |
| JToken |
Représente un jeton JSON abstrait. |
|
Project |
|
|
Reference |
Classe pour représenter une collection de liens de référence REST. |
|
Refresh |
Spécifier les propriétés d’actualisation de l’objet d’authentification de point de terminaison interrogé |
|
Service |
Représente un point de terminaison qui peut être utilisé par un travail d’orchestration. |
|
Service |
EndpointAuthorization
Représente l’autorisation utilisée pour le point de terminaison de service.
| Nom | Type | Description |
|---|---|---|
| parameters |
object |
Obtient ou définit les paramètres du schéma d’autorisation sélectionné. |
| scheme |
string |
Obtient ou définit le schéma utilisé pour l’authentification du point de terminaison de service. |
IdentityRef
| Nom | Type | Description |
|---|---|---|
| _links |
Ce champ contient zéro ou plus de liens intéressants sur l’objet du graphique. Ces liens peuvent être appelés pour obtenir des relations supplémentaires ou des informations plus détaillées sur ce sujet de graphique. |
|
| descriptor |
string |
Le descripteur est le principal moyen de référencer l’objet du graphique pendant l’exécution du système. Ce champ identifie de manière unique le même sujet de graphique dans les comptes et les organisations. |
| directoryAlias |
string |
Déconseillé : peut être récupéré en interrogeant l’utilisateur Graph référencé dans l’entrée « self » du dictionnaire IdentityRef « _links » |
| displayName |
string |
Il s’agit du nom d’affichage non unique de l’objet du graphique. Pour modifier ce champ, vous devez modifier sa valeur dans le fournisseur source. |
| id |
string |
|
| imageUrl |
string |
Déprécié : disponible dans l’entrée « avatar » du dictionnaire IdentityRef « _links » |
| inactive |
boolean |
Déconseillé : peut être récupéré en interrogeant l’état d’appartenance Graph référencé dans l’entrée « membershipState » du dictionnaire GraphUser « _links » |
| isAadIdentity |
boolean |
Déprécié : peut être déduit du type d’objet du descripteur (Descriptor.IsAadUserType/Descriptor.IsAadGroupType) |
| isContainer |
boolean |
Déprécié : peut être déduit du type d’objet du descripteur (Descriptor.IsGroupType) |
| isDeletedInOrigin |
boolean |
|
| profileUrl |
string |
Déconseillé : non utilisé dans la plupart des implémentations préexistantes de ToIdentityRef |
| uniqueName |
string |
Déconseillé : utilisez à la place Domain+PrincipalName |
| url |
string |
Cette URL est l’itinéraire complet vers la ressource source de ce sujet de graphique. |
JObject
Représente un objet JSON.
| Nom | Type | Description |
|---|---|---|
| item |
Représente un jeton JSON abstrait. |
|
| type |
string |
Obtient le type de nœud pour ce JToken. |
JToken
Représente un jeton JSON abstrait.
| Nom | Type | Description |
|---|---|---|
| first |
Obtenez le premier jeton enfant de ce jeton. |
|
| hasValues |
boolean |
Obtient une valeur indiquant si ce jeton a des jetons enfants. |
| item |
Représente un jeton JSON abstrait. |
|
| last |
Obtenez le dernier jeton enfant de ce jeton. |
|
| next |
Obtient le jeton frère suivant de ce nœud. |
|
| parent |
string |
Obtient ou définit le parent. |
| path |
string |
Obtient le chemin du jeton JSON. |
| previous |
Obtient le jeton frère précédent de ce nœud. |
|
| root |
Obtient la racine JToken de ce JToken. |
|
| type |
string |
Obtient le type de nœud pour ce JToken. |
ProjectReference
| Nom | Type | Description |
|---|---|---|
| id |
string |
|
| name |
string |
ReferenceLinks
Classe pour représenter une collection de liens de référence REST.
| Nom | Type | Description |
|---|---|---|
| links |
object |
Vue en lecture seule des liens. Étant donné que les liens référence sont en lecture seule, nous voulons uniquement les exposer en lecture seule. |
RefreshAuthenticationParameters
Spécifier les propriétés d’actualisation de l’objet d’authentification de point de terminaison interrogé
| Nom | Type | Description |
|---|---|---|
| endpointId |
string |
EndpointId qui a besoin de nouveaux paramètres d’authentification |
| scope |
integer[] |
Étendue du jeton demandé. Pour les applications de la Place de marché GitHub, l’étendue contient des ID de dépôt |
| tokenValidityInMinutes |
integer |
L’authentification de point de terminaison demandée doit être valide pendant _ minutes. Les paramètres d’authentification ne sont pas actualisés si le jeton contenu dans le point de terminaison a déjà un jeton actif. |
ServiceEndpoint
Représente un point de terminaison qui peut être utilisé par un travail d’orchestration.
| Nom | Type | Description |
|---|---|---|
| administratorsGroup |
Il s’agit d’un champ déconseillé. |
|
| authorization |
Obtient ou définit les données d’autorisation pour la conversation avec le point de terminaison. |
|
| createdBy |
Obtient ou définit la référence d’identité pour l’utilisateur qui a créé le point de terminaison de service. |
|
| data |
object |
|
| description |
string |
Obtient ou définit la description du point de terminaison. |
| groupScopeId |
string |
Il s’agit d’un champ déconseillé. |
| id |
string |
Obtient ou définit l’identificateur de ce point de terminaison. |
| isReady |
boolean |
Indicateur d’état EndPoint |
| isShared |
boolean |
Indique si le point de terminaison de service est partagé avec d’autres projets ou non. |
| name |
string |
Obtient ou définit le nom convivial du point de terminaison. |
| operationStatus |
Message d’erreur lors de la création/suppression du point de terminaison |
|
| owner |
string |
Propriétaire du point de terminaison Les valeurs prises en charge sont « library », « agentcloud » |
| readersGroup |
Obtient ou définit la référence d’identité pour le groupe de lecteurs du point de terminaison de service. |
|
| serviceEndpointProjectReferences |
Toutes les autres références de projet où le point de terminaison de service est partagé. |
|
| type |
string |
Obtient ou définit le type du point de terminaison. |
| url |
string |
Obtient ou définit l’URL du point de terminaison. |
ServiceEndpointProjectReference
| Nom | Type | Description |
|---|---|---|
| description |
string |
Obtient ou définit la description du point de terminaison de service. |
| name |
string |
Obtient ou définit le nom du point de terminaison de service. |
| projectReference |
Obtient ou définit la référence de projet du point de terminaison de service. |