Endpoints - Update Service Endpoints

Riferimento

Service:: Service Endpoint

API Version:: 7.1-preview.4

Aggiornare gli endpoint di servizio.

PUT https://dev.azure.com/{organization}/_apis/serviceendpoint/endpoints?api-version=7.1-preview.4

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. Questa opzione deve essere impostata su '7.1-preview.4' per usare questa versione dell'API.

Corpo della richiesta

Nome	Tipo	Descrizione
body	ServiceEndpoint[]	Nomi degli endpoint di servizio da aggiornare.

Risposte

Nome	Tipo	Descrizione
200 OK	ServiceEndpoint[]	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.serviceendpoint_manage	Concede la possibilità di leggere, eseguire query e gestire gli endpoint di servizio.

Esempio

Update service endpoints

Sample Request

HTTP

PUT https://dev.azure.com/{organization}/_apis/serviceendpoint/endpoints?api-version=7.1-preview.4

[
  {
    "data": {},
    "id": "5e47a0d8-c745-44f8-8f93-784f18ff31c4",
    "name": "UpdatedMyNewServiceEndpoint",
    "type": "Generic",
    "url": "https://myserver",
    "createdBy": {
      "displayName": "Chuck Reinhart",
      "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/e18a1f0a-b112-67fd-a9e0-e3bb081da49e",
      "_links": {
        "avatar": {
          "href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.ZTE4YTFmMGEtYjExMi03N2ZkLWE5ZTAtZTNiYjA4MWRhNDll"
        }
      },
      "id": "e18a1f0a-b112-67fd-a9e0-e3bb081da49e",
      "uniqueName": "fabfiber@outlook.com",
      "imageUrl": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.ZTE4YTFmMGEtYjExMi03N2ZkLWE5ZTAtZTNiYjA4MWRhNDll",
      "descriptor": "msa.ZTE4YTFmMGEtYjExMi03N2ZkLWE5ZTAtZTNiYjA4MWRhNDll"
    },
    "description": "",
    "authorization": {
      "parameters": {
        "username": "myusername"
      },
      "scheme": "UsernamePassword"
    },
    "isShared": false,
    "isReady": true,
    "owner": "Library",
    "serviceEndpointProjectReferences": [
      {
        "projectReference": {
          "id": "c7e5f0b3-71fa-4429-9fb3-3321963a7c06",
          "name": "TestProject"
        },
        "name": "MyNewServiceEndpoint"
      }
    ]
  }
]

Sample Response

Status code:: 200

{
  "count": 1,
  "value": [
    {
      "data": {},
      "id": "5e47a0d8-c745-44f8-8f93-784f18ff31c4",
      "name": "UpdatedMyNewServiceEndpoint",
      "type": "Generic",
      "url": "https://myserver",
      "createdBy": {
        "displayName": "Chuck Reinhart",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/e18a1f0a-b112-67fd-a9e0-e3bb081da49e",
        "_links": {
          "avatar": {
            "href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.ZTE4YTFmMGEtYjExMi03N2ZkLWE5ZTAtZTNiYjA4MWRhNDll"
          }
        },
        "id": "e18a1f0a-b112-67fd-a9e0-e3bb081da49e",
        "uniqueName": "fabfiber@outlook.com",
        "imageUrl": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.ZTE4YTFmMGEtYjExMi03N2ZkLWE5ZTAtZTNiYjA4MWRhNDll",
        "descriptor": "msa.ZTE4YTFmMGEtYjExMi03N2ZkLWE5ZTAtZTNiYjA4MWRhNDll"
      },
      "description": "",
      "authorization": {
        "parameters": {
          "username": "myusername"
        },
        "scheme": "UsernamePassword"
      },
      "isShared": false,
      "isReady": true,
      "owner": "Library",
      "serviceEndpointProjectReferences": [
        {
          "projectReference": {
            "id": "c7e5f0b3-71fa-4429-9fb3-3321963a7c06",
            "name": "TestProject"
          },
          "name": "MyNewServiceEndpoint"
        }
      ]
    }
  ]
}

Definizioni

Nome	Descrizione
EndpointAuthorization	Rappresenta l'autorizzazione usata per l'endpoint di servizio.
IdentityRef
JObject	Rappresenta un oggetto JSON.
JToken	Rappresenta un token JSON astratto.
ProjectReference
ReferenceLinks	Classe da rappresentare una raccolta di collegamenti di riferimento REST.
ServiceEndpoint	Rappresenta un endpoint che può essere usato da un processo di orchestrazione.
ServiceEndpointProjectReference

EndpointAuthorization

Rappresenta l'autorizzazione usata per l'endpoint di servizio.

Nome	Tipo	Descrizione
parameters	object	Ottiene o imposta i parametri per lo schema di autorizzazione selezionato.
scheme	string	Ottiene o imposta lo schema usato per l'autenticazione dell'endpoint di servizio.

IdentityRef

Nome	Tipo	Descrizione
_links	ReferenceLinks	Questo campo contiene zero o più collegamenti interessanti sull'oggetto grafico. Questi collegamenti possono essere richiamati per ottenere relazioni aggiuntive o informazioni più dettagliate su questo argomento grafico.
descriptor	string	Il descrittore è il modo principale per fare riferimento all'oggetto del grafico durante l'esecuzione del sistema. Questo campo identificherà in modo univoco lo stesso soggetto grafo in account e organizzazioni.
directoryAlias	string	Deprecato: può essere recuperato eseguendo query sull'utente Graph a cui si fa riferimento nella voce "self" del dizionario IdentityRef "_links"
displayName	string	Si tratta del nome visualizzato non univoco dell'oggetto grafico. Per modificare questo campo, è necessario modificarlo nel provider di origine.
id	string
imageUrl	string	Deprecato - Disponibile nella voce "avatar" del dizionario IdentityRef "_links"
inactive	boolean	Deprecato: può essere recuperato eseguendo una query sullo stato di appartenenza Graph a cui fa riferimento nella voce "membershipState" del dizionario GraphUser "_links"
isAadIdentity	boolean	Deprecato: può essere dedotto dal tipo di soggetto del descrittore (Descrittore.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Deprecato: può essere dedotto dal tipo di soggetto del descrittore (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	Deprecato : non in uso nella maggior parte delle implementazioni preesistenti di ToIdentityRef
uniqueName	string	Deprecato: usare invece Domain+PrincipalName
url	string	Questo URL è la route completa alla risorsa di origine di questo oggetto grafico.

JObject

Rappresenta un oggetto JSON.

Nome	Tipo	Descrizione
item	JToken	Rappresenta un token JSON astratto.
type	string	Ottiene il tipo di nodo per questo JToken.

JToken

Rappresenta un token JSON astratto.

Nome	Tipo	Descrizione
first	JToken	Ottenere il primo token figlio di questo token.
hasValues	boolean	Ottiene un valore che indica se questo token ha token figlio.
item	JToken	Rappresenta un token JSON astratto.
last	JToken	Ottenere l'ultimo token figlio di questo token.
next	JToken	Ottiene il token di pari livello successivo di questo nodo.
parent	string	Ottiene o imposta l'elemento padre.
path	string	Ottiene il percorso del token JSON.
previous	JToken	Ottiene il token di pari livello precedente di questo nodo.
root	JToken	Ottiene la radice JToken di questo JToken.
type	string	Ottiene il tipo di nodo per questo JToken.

ProjectReference

Nome	Tipo	Descrizione
id	string
name	string

ReferenceLinks

Classe da rappresentare una raccolta di collegamenti di riferimento REST.

Nome	Tipo	Descrizione
links	object	Visualizzazione di lettura dei collegamenti. Poiché i collegamenti di riferimento sono in sola lettura, si vuole esporre solo i collegamenti di riferimento come sola lettura.

ServiceEndpoint

Rappresenta un endpoint che può essere usato da un processo di orchestrazione.

Nome	Tipo	Descrizione
administratorsGroup	IdentityRef	Si tratta di un campo deprecato.
authorization	EndpointAuthorization	Ottiene o imposta i dati di autorizzazione per la comunicazione con l'endpoint.
createdBy	IdentityRef	Ottiene o imposta il riferimento all'identità per l'utente che ha creato l'endpoint del servizio.
data	object
description	string	Ottiene o imposta la descrizione dell'endpoint.
groupScopeId	string	Si tratta di un campo deprecato.
id	string	Ottiene o imposta l'identificatore di questo endpoint.
isReady	boolean	Indicatore di stato endPoint
isShared	boolean	Indica se l'endpoint del servizio è condiviso con altri progetti o meno.
name	string	Ottiene o imposta il nome descrittivo dell'endpoint.
operationStatus	JObject	Messaggio di errore durante la creazione/eliminazione dell'endpoint
owner	string	Il proprietario dei valori supportati dell'endpoint è "library", "agentcloud"
readersGroup	IdentityRef	Ottiene o imposta il riferimento all'identità per il gruppo di lettori dell'endpoint del servizio.
serviceEndpointProjectReferences	ServiceEndpointProjectReference[]	Tutti gli altri riferimenti al progetto in cui è condiviso l'endpoint del servizio.
type	string	Ottiene o imposta il tipo di endpoint.
url	string	Ottiene o imposta l'URL dell'endpoint.

ServiceEndpointProjectReference

Nome	Tipo	Descrizione
description	string	Ottiene o imposta la descrizione dell'endpoint del servizio.
name	string	Ottiene o imposta il nome dell'endpoint del servizio.
projectReference	ProjectReference	Ottiene o imposta il riferimento al progetto dell'endpoint del servizio.

Condividi tramite