Endpoints - Get Service Endpoints With Refreshed Authentication
Obtiene los puntos de conexión de servicio y revisa los nuevos parámetros de autorización.
POST https://dev.azure.com/{organization}/{project}/_apis/serviceendpoint/endpoints?endpointIds={endpointIds}&api-version=7.1-preview.4Parámetros de identificador URI
| Nombre | En | Requerido | Tipo | Description |
|---|---|---|---|---|
|
organization
|
path | True |
string |
El nombre de la organización de Azure DevOps. |
|
project
|
path | True |
string |
Id. de proyecto o nombre del proyecto |
|
api-version
|
query | True |
string |
Versión de la API que se va a usar. Debe establecerse en "7.1-preview.4" para usar esta versión de la API. |
|
endpoint
|
query | True |
string array (uuid) |
Identificadores de los puntos de conexión de servicio. |
Cuerpo de la solicitud
| Nombre | Tipo | Description |
|---|---|---|
| body |
Ámbito, validez del token solicitado. |
Respuestas
| Nombre | Tipo | Description |
|---|---|---|
| 200 OK |
operación correcta |
Seguridad
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
| Nombre | Description |
|---|---|
| vso.serviceendpoint_manage | Concede la capacidad de leer, consultar y administrar puntos de conexión de servicio. |
Definiciones
| Nombre | Description |
|---|---|
|
Endpoint |
Representa la autorización usada para el punto de conexión de servicio. |
|
Identity |
|
| JObject |
Representa un objeto JSON. |
| JToken |
Representa un token JSON abstracto. |
|
Project |
|
|
Reference |
Clase que representa una colección de vínculos de referencia de REST. |
|
Refresh |
Especifique las propiedades para actualizar el objeto de autenticación del punto de conexión que se está consultando. |
|
Service |
Representa un punto de conexión que un trabajo de orquestación puede usar. |
|
Service |
EndpointAuthorization
Representa la autorización usada para el punto de conexión de servicio.
| Nombre | Tipo | Description |
|---|---|---|
| parameters |
object |
Obtiene o establece los parámetros del esquema de autorización seleccionado. |
| scheme |
string |
Obtiene o establece el esquema utilizado para la autenticación de punto de conexión de servicio. |
IdentityRef
| Nombre | Tipo | Description |
|---|---|---|
| _links |
Este campo contiene cero o más vínculos interesantes sobre el tema del grafo. Estos vínculos se pueden invocar para obtener relaciones adicionales o información más detallada sobre este tema del grafo. |
|
| descriptor |
string |
El descriptor es la forma principal de hacer referencia al asunto del grafo mientras se ejecuta el sistema. Este campo identificará de forma única el mismo asunto del grafo en cuentas y organizaciones. |
| directoryAlias |
string |
En desuso: se puede recuperar consultando el usuario de Graph al que se hace referencia en la entrada "self" del diccionario IdentityRef "_links". |
| displayName |
string |
Este es el nombre para mostrar no único del asunto del grafo. Para cambiar este campo, debe modificar su valor en el proveedor de origen. |
| id |
string |
|
| imageUrl |
string |
En desuso: disponible en la entrada "avatar" del diccionario "_links" de IdentityRef |
| inactive |
boolean |
En desuso: se puede recuperar consultando el estado de pertenencia de Graph al que se hace referencia en la entrada "membershipState" del diccionario GraphUser "_links". |
| isAadIdentity |
boolean |
En desuso: se puede deducir del tipo de asunto del descriptor (Descriptor.IsAadUserType/Descriptor.IsAadGroupType) |
| isContainer |
boolean |
En desuso: se puede deducir del tipo de sujeto del descriptor (Descriptor.IsGroupType) |
| isDeletedInOrigin |
boolean |
|
| profileUrl |
string |
En desuso: no en uso en la mayoría de las implementaciones preexistentes de ToIdentityRef |
| uniqueName |
string |
En desuso: use Domain+PrincipalName en su lugar. |
| url |
string |
Esta dirección URL es la ruta completa al recurso de origen de este tema del grafo. |
JObject
Representa un objeto JSON.
| Nombre | Tipo | Description |
|---|---|---|
| item |
Representa un token JSON abstracto. |
|
| type |
string |
Obtiene el tipo de nodo para este JToken. |
JToken
Representa un token JSON abstracto.
| Nombre | Tipo | Description |
|---|---|---|
| first |
Obtenga el primer token secundario de este token. |
|
| hasValues |
boolean |
Obtiene un valor que indica si este token tiene tokens secundarios. |
| item |
Representa un token JSON abstracto. |
|
| last |
Obtenga el último token secundario de este token. |
|
| next |
Obtiene el siguiente token relacionado de este nodo. |
|
| parent |
string |
Obtiene o establece el elemento primario. |
| path |
string |
Obtiene la ruta de acceso del token JSON. |
| previous |
Obtiene el token relacionado anterior de este nodo. |
|
| root |
Obtiene el JToken raíz de este JToken. |
|
| type |
string |
Obtiene el tipo de nodo para este JToken. |
ProjectReference
| Nombre | Tipo | Description |
|---|---|---|
| id |
string |
|
| name |
string |
ReferenceLinks
Clase que representa una colección de vínculos de referencia de REST.
| Nombre | Tipo | Description |
|---|---|---|
| links |
object |
Vista de solo lectura de los vínculos. Dado que los vínculos de referencia son de solo lectura, solo queremos exponerlos como de solo lectura. |
RefreshAuthenticationParameters
Especifique las propiedades para actualizar el objeto de autenticación del punto de conexión que se está consultando.
| Nombre | Tipo | Description |
|---|---|---|
| endpointId |
string |
EndpointId que necesita nuevos parámetros de autenticación |
| scope |
integer[] |
Ámbito del token solicitado. En el caso de las aplicaciones de Marketplace de GitHub, el ámbito contiene identificadores de repositorio. |
| tokenValidityInMinutes |
integer |
La autenticación del punto de conexión solicitado debe ser válida durante _ minutos. Los parámetros de autenticación no se actualizarán si el token contenido en el punto de conexión ya tiene un token activo. |
ServiceEndpoint
Representa un punto de conexión que un trabajo de orquestación puede usar.
| Nombre | Tipo | Description |
|---|---|---|
| administratorsGroup |
Se trata de un campo en desuso. |
|
| authorization |
Obtiene o establece los datos de autorización para comunicarse con el punto de conexión. |
|
| createdBy |
Obtiene o establece la referencia de identidad para el usuario que creó el punto de conexión de servicio. |
|
| data |
object |
|
| description |
string |
Obtiene o establece la descripción del punto de conexión. |
| groupScopeId |
string |
Se trata de un campo en desuso. |
| id |
string |
Obtiene o establece el identificador de este punto de conexión. |
| isReady |
boolean |
Indicador de estado de EndPoint |
| isShared |
boolean |
Indica si el punto de conexión de servicio se comparte con otros proyectos o no. |
| name |
string |
Obtiene o establece el nombre descriptivo del punto de conexión. |
| operationStatus |
Mensaje de error durante la creación o eliminación del punto de conexión |
|
| owner |
string |
El propietario del punto de conexión Los valores admitidos son "library", "agentcloud" |
| readersGroup |
Obtiene o establece la referencia de identidad para el grupo de lectores del punto de conexión de servicio. |
|
| serviceEndpointProjectReferences |
Todas las demás referencias de proyecto en las que se comparte el punto de conexión de servicio. |
|
| type |
string |
Obtiene o establece el tipo del extremo. |
| url |
string |
Obtiene o establece la dirección URL del punto de conexión. |
ServiceEndpointProjectReference
| Nombre | Tipo | Description |
|---|---|---|
| description |
string |
Obtiene o establece la descripción del punto de conexión de servicio. |
| name |
string |
Obtiene o establece el nombre del punto de conexión de servicio. |
| projectReference |
Obtiene o establece la referencia del proyecto del punto de conexión de servicio. |