Condividi tramite

Endpoints - Update Service Endpoint

  • Riferimento
Service:
Service Endpoint
API Version:
7.1-preview.4

Aggiornare l'endpoint del servizio

PUT https://dev.azure.com/{organization}/_apis/serviceendpoint/endpoints/{endpointId}?api-version=7.1-preview.4
With optional parameters: 
PUT https://dev.azure.com/{organization}/_apis/serviceendpoint/endpoints/{endpointId}?operation={operation}&api-version=7.1-preview.4

Parametri dell'URI

Nome In Necessario Tipo Descrizione
endpointId
 path True

string

uuid

ID endpoint dell'endpoint da aggiornare
organization
 path True

string

Nome dell'organizzazione di Azure DevOps.
api-version
 query True

string

Versione dell'API da usare. Deve essere impostato su '7.1-preview.4' per usare questa versione dell'API.
operation
 query

string

tipo di operazione

Corpo della richiesta

Nome Tipo Descrizione
administratorsGroup

IdentityRef

Si tratta di un campo deprecato.
authorization

EndpointAuthorization

Ottiene o imposta i dati di autorizzazione per comunicare 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 di EndPoint
isShared

boolean

Indica se l'endpoint di 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 dell'endpoint I valori supportati sono "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.

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 endpoint

Sample Request

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

{
  "data": {},
  "id": "5e47a0d8-c745-44f8-8f93-784f18ff31c4",
  "name": "UpdatedServiceEndpoint",
  "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": "myupdatedusername",
      "password": "myupdatedpassword"
    },
    "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 
{
  "data": {},
  "id": "5e47a0d8-c745-44f8-8f93-784f18ff31c4",
  "name": "UpdatedServiceEndpoint",
  "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": "myupdatedusername",
      "password": null
    },
    "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 utilizzata per l'endpoint di servizio.
IdentityRef
JObject

Rappresenta un oggetto JSON.
JToken

Rappresenta un token JSON astratto.
ProjectReference
ReferenceLinks

Classe per 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 utilizzata 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 utilizzato per l'autenticazione dell'endpoint di servizio.

IdentityRef

Nome Tipo Descrizione
_links

ReferenceLinks

Questo campo contiene zero o più collegamenti interessanti sull'oggetto del grafico. Questi collegamenti possono essere richiamati per ottenere relazioni aggiuntive o informazioni più dettagliate su questo oggetto grafico.
descriptor

string

Il descrittore è il modo principale per fare riferimento all'oggetto del grafo mentre il sistema è in esecuzione. Questo campo identificherà in modo univoco lo stesso oggetto grafico in account e organizzazioni.
directoryAlias

string

Deprecato: può essere recuperato eseguendo una query sull'utente graph a cui si fa riferimento nella voce "self" del dizionario "_links" IdentityRef
displayName

string

Si tratta del nome visualizzato non univoco dell'oggetto del grafico. Per modificare questo campo, è necessario modificarne il valore 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 si fa riferimento nella voce "membershipState" del dizionario GraphUser "_links"
isAadIdentity

boolean

Deprecato: può essere dedotto dal tipo di soggetto del descrittore (Descriptor.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 il JToken radice di questo JToken.
type

string

Ottiene il tipo di nodo per questo JToken.

ProjectReference

Nome Tipo Descrizione
id

string

name

string

Classe per rappresentare una raccolta di collegamenti di riferimento REST.

Nome Tipo Descrizione
links

object

Visualizzazione di sola lettura dei collegamenti. Poiché i collegamenti di riferimento sono di sola lettura, è consigliabile esporli solo come di 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 comunicare 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 di EndPoint
isShared

boolean

Indica se l'endpoint di 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 dell'endpoint I valori supportati sono "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.