User Entitlements - Get User Entitlement

Referencia

Servicio:: Member Entitlement Management

Versión de la API:: 5.1-preview.2

Obtener derechos de usuario para un usuario.

GET https://vsaex.dev.azure.com/{organization}/_apis/userentitlements/{userId}?api-version=5.1-preview.2

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
organization	path	True	string	El nombre de la organización de Azure DevOps.
userId	path	True	string uuid	Identificador del usuario.
api-version	query	True	string	Versión de la API que se va a usar. Debe establecerse en "5.1-preview.2" para usar esta versión de la API.

Respuestas

Nombre	Tipo	Description
200 OK	UserEntitlement	operación correcta

Seguridad

oauth2

Tipo: oauth2
Flujo: accessCode
Dirección URL de autorización: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Dirección URL del token: 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

Ámbitos

Nombre	Description
vso.memberentitlementmanagement	Concede la capacidad de leer a los usuarios, sus licencias, así como proyectos y extensiones a los que pueden acceder.

Ejemplos

Solicitud de ejemplo

HTTP

GET https://vsaex.dev.azure.com/{organization}/_apis/userentitlements/fe2f1bdb-9779-491a-a6f6-c6e9322cfb00?api-version=5.1-preview.2

Respuesta de muestra

status code:: 200

{
  "id": "fe2f1bdb-9779-491a-a6f6-c6e9322cfb00",
  "user": {
    "subjectKind": "user",
    "metaType": "member",
    "domain": "14c5367e-ee12-4c94-98b8-b52c1fe3cfb1",
    "principalName": "user1@fabrikam.com",
    "mailAddress": "user1@fabrikam.com",
    "origin": "aad",
    "originId": "00000000-0000-0000-0000-000000000000",
    "displayName": "User 1",
    "_links": {
      "self": {
        "href": "https://vssps.dev.azure.com/fabrikam/_apis/graph/users/aad.wUGM3IDZ1UTZzczNtkTZmJWLiRzY30yNyE2MtcDNmFTOzMjY"
      },
      "memberships": {
        "href": "https://vssps.dev.azure.com/fabrikam/_apis/graph/memberships/aad.wUGM3IDZ1UTZzczNtkTZmJWLiRzY30yNyE2MtcDNmFTOzMjY"
      },
      "membershipState": {
        "href": "https://vssps.dev.azure.com/fabrikam/_apis/graph/membershipstates/aad.wUGM3IDZ1UTZzczNtkTZmJWLiRzY30yNyE2MtcDNmFTOzMjY"
      },
      "storageKey": {
        "href": "https://vssps.dev.azure.com/fabrikam/_apis/graph/storagekeys/aad.wUGM3IDZ1UTZzczNtkTZmJWLiRzY30yNyE2MtcDNmFTOzMjY"
      }
    },
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/graph/users/aad.wUGM3IDZ1UTZzczNtkTZmJWLiRzY30yNyE2MtcDNmFTOzMjY",
    "descriptor": "aad.wUGM3IDZ1UTZzczNtkTZmJWLiRzY30yNyE2MtcDNmFTOzMjY"
  },
  "accessLevel": {
    "licensingSource": "account",
    "accountLicenseType": "stakeholder",
    "msdnLicenseType": "none",
    "licenseDisplayName": "Stakeholder",
    "status": "active",
    "statusMessage": "",
    "assignmentSource": "unknown"
  },
  "lastAccessedDate": "0001-01-01T00:00:00Z",
  "projectEntitlements": [],
  "extensions": [],
  "groupAssignments": []
}

Definiciones

Nombre	Description
AccessLevel	Licencia asignada a un usuario
AccountLicenseType	Tipo de licencia de cuenta (por ejemplo, Express, Parte interesada, etc.)
AccountUserStatus	Estado del usuario en la cuenta
AssignmentSource	Origen de asignación de la licencia (por ejemplo, Grupo, Desconocido, etc.
Extension	Una extensión asignada a un usuario
GraphGroup	Entidad de grupo de grafos
GraphUser	Entidad de usuario de Graph
Group	Grupo de proyectos (por ejemplo, Colaborador, Lector, etc.)
GroupEntitlement	Una entidad de grupo con propiedades adicionales, incluidas su licencia, extensiones y pertenencia a proyectos
GroupLicensingRuleStatus	Estado de la regla de grupo.
GroupType	Tipo de grupo
LicensingSource	Origen de licencias (por ejemplo, Cuenta. MSDN, etc.)
MsdnLicenseType	Tipo de licencia de MSDN (por ejemplo, Visual Studio Professional, Visual Studio Enterprise, etc.)
ProjectEntitlement	Relación entre un proyecto y los permisos efectivos del usuario en ese proyecto.
ProjectPermissionInherited	Si el usuario hereda los permisos de un proyecto a través de una pertenencia a grupos de Azure DevOps o AAD.
ProjectRef	Referencia a un proyecto
ReferenceLinks	Clase que representa una colección de vínculos de referencia de REST.
TeamRef	Referencia a un equipo
UserEntitlement	Una entidad de usuario con propiedades adicionales, incluidas sus licencias, extensiones y pertenencia a proyectos

AccessLevel

Object

Licencia asignada a un usuario

Nombre	Tipo	Description
accountLicenseType	AccountLicenseType	Tipo de licencia de cuenta (por ejemplo, Express, Parte interesada, etc.)
assignmentSource	AssignmentSource	Origen de asignación de la licencia (por ejemplo, Grupo, Desconocido, etc.
licenseDisplayName	string	Nombre para mostrar de la licencia
licensingSource	LicensingSource	Origen de licencias (por ejemplo, Cuenta. MSDN, etc.)
msdnLicenseType	MsdnLicenseType	Tipo de licencia de MSDN (por ejemplo, Visual Studio Professional, Visual Studio Enterprise, etc.)
status	AccountUserStatus	Estado del usuario en la cuenta
statusMessage	string	Mensaje de estado.

AccountLicenseType

Enumeration

Tipo de licencia de cuenta (por ejemplo, Express, Parte interesada, etc.)

Valor	Description
advanced
earlyAdopter
express
none
professional
stakeholder

AccountUserStatus

Enumeration

Estado del usuario en la cuenta

Valor	Description
active	El usuario ha iniciado sesión al menos una vez en la cuenta de VSTS
deleted	El administrador de la cuenta de VSTS quita el usuario de la cuenta de VSTS.
disabled	El usuario no puede iniciar sesión; usado principalmente por el administrador para quitar temporalmente un usuario debido a la ausencia o a la reasignación de licencias
expired	El usuario puede iniciar sesión; se usa principalmente cuando la licencia está en estado expirado y se proporciona un período de gracia
none
pending	El usuario está invitado a unirse a la cuenta de VSTS por el administrador de la cuenta de VSTS, pero aún no se ha registrado o iniciado sesión.
pendingDisabled	El usuario está deshabilitado; si se vuelve a habilitar, seguirán estando en estado Pendiente.

AssignmentSource

Enumeration

Origen de asignación de la licencia (por ejemplo, Grupo, Desconocido, etc.

Valor	Description
groupRule
none
unknown

Extension

Object

Una extensión asignada a un usuario

Nombre	Tipo	Description
assignmentSource	AssignmentSource	Origen de asignación para esta extensión. Es decir, asignado explícitamente o desde una regla de grupo.
id	string	Identificador de la galería de la extensión.
name	string	Nombre descriptivo de esta extensión.
source	LicensingSource	Origen de esta asignación de extensión. Por ejemplo: msdn, account, none, etc.

GraphGroup

Object

Entidad de grupo de grafos

Nombre	Tipo	Description
_links	ReferenceLinks	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.
description	string	Una frase corta para ayudar a los lectores humanos a desambiguar grupos con nombres similares
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.
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.
domain	string	Representa el nombre del contenedor de origen para un miembro de grafo. (Para MSA, este es "Windows Live ID", para AD el nombre del dominio, para AAD el tenantID del directorio, para los grupos de VSTS ScopeId, etc.)
legacyDescriptor	string	[Solo uso interno] El descriptor heredado está aquí en caso de que tenga que acceder a la versión anterior de IMS mediante el descriptor de identidad.
mailAddress	string	Dirección de correo electrónico del registro de un miembro de grafo determinado. Puede ser diferente del nombre principal.
origin	string	Tipo de proveedor de origen para el identificador de origen (por ejemplo: AD, AAD, MSA)
originId	string	Identificador único del sistema de origen. Normalmente, un sid, un identificador de objeto o un GUID. Las operaciones de vinculación y desvinculación pueden hacer que este valor cambie para un usuario porque el usuario no está respaldado por un proveedor diferente y tiene un identificador único diferente en el nuevo proveedor.
principalName	string	Este es el nombre principal de este miembro del grafo del proveedor de origen. El proveedor de origen puede cambiar este campo a lo largo del tiempo y no se garantiza que sea inmutable durante la vida del miembro del grafo por VSTS.
subjectKind	string	Este campo identifica el tipo del asunto del grafo (por ejemplo, Grupo, Ámbito, Usuario).
url	string	Esta dirección URL es la ruta completa al recurso de origen de este tema del grafo.

GraphUser

Object

Entidad de usuario de Graph

Nombre	Tipo	Description
_links	ReferenceLinks	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	Nombre corto, generalmente único para el usuario en el directorio de respaldo. Para los usuarios de AAD, esto corresponde al alias de correo, que suele ser similar a la parte de la dirección de correo del usuario antes del signo @ . Para los usuarios de GitHub, esto corresponde al identificador de usuario de GitHub.
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.
domain	string	Representa el nombre del contenedor de origen para un miembro de grafo. (Para MSA, este es "Windows Live ID", para AD el nombre del dominio, para AAD el tenantID del directorio, para los grupos de VSTS ScopeId, etc.)
isDeletedInOrigin	boolean	Cuando es true, el grupo se ha eliminado en el proveedor de identidades.
legacyDescriptor	string	[Solo uso interno] El descriptor heredado está aquí en caso de que tenga que acceder a la versión anterior de IMS mediante el descriptor de identidad.
mailAddress	string	Dirección de correo electrónico del registro de un miembro de grafo determinado. Puede ser diferente del nombre principal.
metaType	string	Meta type del usuario en el origen, como "member", "guest", etc. Consulte UserMetaType para obtener el conjunto de valores posibles.
origin	string	Tipo de proveedor de origen para el identificador de origen (por ejemplo: AD, AAD, MSA)
originId	string	Identificador único del sistema de origen. Normalmente, un sid, un identificador de objeto o un GUID. Las operaciones de vinculación y desvinculación pueden hacer que este valor cambie para un usuario porque el usuario no está respaldado por un proveedor diferente y tiene un identificador único diferente en el nuevo proveedor.
principalName	string	Este es el nombre principal de este miembro del grafo del proveedor de origen. El proveedor de origen puede cambiar este campo a lo largo del tiempo y no se garantiza que sea inmutable durante la vida del miembro del grafo por VSTS.
subjectKind	string	Este campo identifica el tipo del asunto del grafo (por ejemplo, Grupo, Ámbito, Usuario).
url	string	Esta dirección URL es la ruta completa al recurso de origen de este tema del grafo.

Group

Object

Grupo de proyectos (por ejemplo, Colaborador, Lector, etc.)

Nombre	Tipo	Description
displayName	string	Nombre para mostrar del grupo
groupType	GroupType	Tipo de grupo

GroupEntitlement

Object

Una entidad de grupo con propiedades adicionales, incluidas su licencia, extensiones y pertenencia a proyectos

Nombre	Tipo	Description
extensionRules	Extension[]	Reglas de extensión.
group	GraphGroup	Referencia de miembro.
id	string	Identificador único que coincide con el identificador de GraphMember.
lastExecuted	string	[Readonly] La última vez que se ejecutó la regla de licencias de grupo (independientemente de si se realizaron cambios).
licenseRule	AccessLevel	Regla de licencia.
members	UserEntitlement[]	Miembros del grupo. Solo se usa al crear un nuevo grupo.
projectEntitlements	ProjectEntitlement[]	Relación entre un proyecto y los permisos efectivos del miembro en ese proyecto.
status	GroupLicensingRuleStatus	Estado de la regla de grupo.

GroupLicensingRuleStatus

Enumeration

Estado de la regla de grupo.

Valor	Description
applied	Se aplica la regla
applyPending	La regla se crea o actualiza, pero la aplicación está pendiente
incompatible	La regla de grupo no era compatible
unableToApply	La regla no se pudo aplicar inesperadamente y se debe reintentar

GroupType

Enumeration

Tipo de grupo

Valor	Description
custom
projectAdministrator
projectContributor
projectReader
projectStakeholder

LicensingSource

Enumeration

Origen de licencias (por ejemplo, Cuenta. MSDN, etc.)

Valor	Description
account
auto
msdn
none
profile
trial

MsdnLicenseType

Enumeration

Tipo de licencia de MSDN (por ejemplo, Visual Studio Professional, Visual Studio Enterprise, etc.)

Valor	Description
eligible
enterprise
none
platforms
premium
professional
testProfessional
ultimate

ProjectEntitlement

Object

Relación entre un proyecto y los permisos efectivos del usuario en ese proyecto.

Nombre	Tipo	Description
assignmentSource	AssignmentSource	Origen de asignación (por ejemplo, Grupo o Desconocido).
group	Group	Grupo de proyectos (por ejemplo, Colaborador, Lector, etc.)
projectPermissionInherited	ProjectPermissionInherited	Si el usuario hereda permisos para un proyecto a través de una pertenencia a grupos de Azure DevOps o AAD.
projectRef	ProjectRef	Referencia del proyecto
teamRefs	TeamRef[]	Referencia del equipo.

ProjectPermissionInherited

Enumeration

Si el usuario hereda los permisos de un proyecto a través de una pertenencia a grupos de Azure DevOps o AAD.

Valor	Description
inherited
notInherited
notSet

ProjectRef

Object

Referencia a un proyecto

Nombre	Tipo	Description
id	string	Identificador de proyecto.
name	string	Nombre del proyecto.

ReferenceLinks

Object

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.

TeamRef

Object

Referencia a un equipo

Nombre	Tipo	Description
id	string	Identificador de equipo
name	string	Nombre de equipo