Table of contents

Control de versiones | Conceptos de Graph APIVersioning | Graph API concepts

Bryan Lamos|Última actualización: 19/06/2018
|
2 Colaboradores

Se aplica a: Graph API | Azure Active Directory (AD)Applies to: Graph API | Azure Active Directory (AD)

En este tema se resumen las diferencias de versión de las operaciones y las entidades de la API de Azure Active Directory (AD) Graph.This topic summarizes the version differences for Azure Active Directory (AD) Graph API entities and operations.Debe especificar la versión de una operación que desea usar incluyendo el parámetro de cadena de consulta api-version en su solicitud.You must specify the version of an operation that you want to use by including the api-version query string parameter in your request.Se rechazarán las solicitudes sin un parámetro api-version y devolverán una respuesta (400) Solicitud incorrecta.Requests without an api-version parameter will be rejected and return a (400) Bad Request response.Si las llamadas al servicio una versión anterior de una operación, puede elegir seguir llamando a la versión anterior, o modifique el código para llamar a una versión más reciente.If your service calls an older version of an operation, you can choose to continue calling the older version, or modify your code to call a newer version.Las diferencias de funcionalidad entre versiones se describen en la documentación de la entidad en la que está realizando la llamada.Any differences in functionality between versions are outlined in the documentation for the entity upon which you are performing the call.

Importante

Se recomienda encarecidamente que use Microsoft Graph en lugar de la API de Azure AD Graph para acceder a recursos de Azure Active Directory.We strongly recommend that you use Microsoft Graph instead of Azure AD Graph API to access Azure Active Directory resources.Nuestros esfuerzos de desarrollo se concentran ahora en Microsoft Graph y no están previstas mejoras adicionales para la API de Azure AD Graph.Our development efforts are now concentrated on Microsoft Graph and no further enhancements are planned for Azure AD Graph API.Hay un número muy limitado de escenarios para los que la API de Azure AD Graph todavía podría ser adecuada; para más información, vea la entrada del blog Microsoft Graph o Azure AD Graph en el centro de desarrollo de Office.There are a very limited number of scenarios for which Azure AD Graph API might still be appropriate; for more information, see the Microsoft Graph or the Azure AD Graph blog post in the Office Dev Center.

A partir de la API de Azure AD Graph versión 1.5, el valor del parámetro api-version se especifica como un valor numérico para las versiones de disponibilidad general (GA).Beginning with Azure AD Graph API version 1.5, the api-version parameter value for General Availability (GA) versions is specified as a numeric value.La siguiente URL muestra cómo consultar los recursos de nivel superior del dominio de inquilino contoso.com con Graph API versión 1.5: https://graph.windows.net/contoso.com?api-version=1.5.The following URL shows how to query the top-level resources for tenant domain contoso.com using Graph API version 1.5: https://graph.windows.net/contoso.com?api-version=1.5.Para las versiones anteriores de Graph API, el valor del parámetro api-version se especifica como una cadena de fecha con el formato siguiente: AAAA-MM-DD.For previous versions of Graph API, the api-version parameter value is specified as a date string in the following format: YYYY-MM-DD.La siguiente dirección URL muestra cómo consultar los recursos del inquilino de nivel superior del mismo inquilino usando la versión 2013-11-08 de Graph API: https://graph.windows.net/contoso.com?api-version=2013-11-08.The following URL shows how to query the top-level resources of the same tenant using the 2013-11-08 version of the Graph API: https://graph.windows.net/contoso.com?api-version=2013-11-08.Para las características de versión preliminar, el valor del parámetro api-version se especifica mediante la cadena "beta", de la siguiente forma: https://graph.windows.net/contoso.com?api-version=beta.For preview features, the api-version parameter value is specified using the string “beta” as follows: https://graph.windows.net/contoso.com?api-version=beta.

Contrato de API, control de versiones y cambios importantesAPI contract, versioning and breaking changes

Aumentaremos el número de versión de API para todos los cambios importantes en la API, con el fin de proteger las aplicaciones cliente.We will increment the API version number for any breaking changes to the API, in order to protect client applications.También podemos optar por incrementar la versión de API en caso de cambios no importantes (por ejemplo, si se agregan algunas capacidades nuevas significativamente grandes).We may choose to increment the API version for non-breaking changes too (for example, if we add some significantly large new capabilities).

Por lo tanto, ¿qué es un "cambio importante"?So, what constitutes a breaking change?

  • Quitar algunas API o algunos de sus parámetros o bien cambiarles el nombreRemoving or renaming APIs or API parameters
  • Cambios en el comportamiento de una API existenteChanges in behavior for an existing API
  • Cambios en los códigos de error y contratos de erroresChanges in Error Codes & Fault Contracts
  • Todo lo que infrinja el "principio de la mínima sorpresa"Anything that would violate the Principle of Least Astonishment

Nota: La adición de nuevos campos JSON a las respuestas no constituye un cambio importante.Note:The addition of new JSON fields to responses does not constitute a breaking change.Para los programadores que generan sus propios servidores proxy de cliente (por ejemplo, los clientes de WCF), nuestro consejo es que las aplicaciones cliente deben estar preparadas para recibir las propiedades y los tipos derivados no previamente definidos por el servicio de Graph API.For developers who generate their own client proxies (like WCF clients) our guidance is your client applications should be prepared to receive properties and derived types not previously defined by the Graph API service.Aunque Graph API no es compatible todavía con OData V4 en el momento de redactar este artículo, sigue las instrucciones que se describen en la sección sobre el control de versiones en las especificaciones de OData V4 .Although Graph API is not yet OData V4 compliant at the time of this writing, it still follows the guidance described in the Model Versioning section in the OData V4 spec.

Cuando aumentamos la versión principal de la API (por ejemplo, de la 1.5 a la 2.0), dejamos claro que todo el soporte para los clientes existentes que usan la versión 1.x o las anteriores quedará obsoleto y dejarán de recibir soporte 12 meses después.When we increment the major version of the API (for example from 1.5 to 2.0), we are signaling that all support for existing clients using previous 1.x or earlier versions will be deprecated and no longer supported after 12 months.Consulte la directiva de ciclo de vida de soporte de Microsoft Online Services para más detalles.Please see the Microsoft Online Services Support Lifecycle Policy for more details.

Versiones compatiblesSupported versions

Se han publicado las versiones siguientes de Graph API.The following versions have been released for the Graph API.

Versión beta Version beta

Las características de Graph API actualmente en versión preliminar pueden encontrarse en la sección de características de versión preliminar de los conceptos de Graph API o en el blog del equipo de Graph.The Graph API features currently in preview can be found in either the Preview Features section in Graph API concepts, or on the Graph Team Blog.Las características beta requieren el parámetro de cadena de consulta "api-version=beta".Beta features require the “api-version=beta” query string parameter.Cuando el equipo de Graph API considere que una característica de vista previa está lista para la disponibilidad general (GA), agregará dicha característica a la última versión de GA (o si constituye un cambio importante, lanzará un nuevo número de versión incrementado).When the Graph API team believes that a preview feature is ready for GA, we will add that feature to the latest GA version (or if it constitutes a breaking change this would result in an incremented new version number).No garantizamos que todas las características de vista previa vayan a pasar a la versión de GA.We make no guarantees that a preview feature will be promoted to GA.

En la versión beta, intentamos evitar los cambios importantes en la medida de lo posible, pero no lo garantizamos.For the beta version, we will try to avoid any breaking changes as much as possible, but we will not guarantee it.En las aplicaciones de cliente que usan la versión beta sí se pueden producir cambios importantes de vez en cuando.Client applications using the beta version should expect breaking changes from time to time.Consulte Términos de uso complementarios de las Vistas Previas de Microsoft Azure.Please see Supplemental Terms of Use for Microsoft Azure Previews.

Versión 1.6 Version 1.6

En esta sección se enumeran los cambios de Graph API versión 1.6.This section lists the changes for Graph API version 1.6.

Graph API versión 1.6 introduce los siguientes cambios de características:Graph API version 1.6 introduces the following feature changes:

  • Compatibilidad agregada con usuarios de la cuenta local de Azure Active Directory B2C.Added support for Azure Active Directory B2C local account users.Esto implica nuevas propiedades en la entidad User y un nuevo tipo complejo SignInName para admitir el inicio de sesión en una cuenta local en los inquilinos de Azure Active Directory B2C.This involves new properties on the User entity and a new complex type SignInName to support local account sign-in to Azure Active Directory B2C tenants.Para más información sobre Azure Active Directory B2C, consulte la documentación de Azure Active Directory B2C.For more information about Azure Active Directory B2C, see the Azure Active Directory B2C documentation.

  • Compatibilidad agregada con la detección de servicios con la entidad ServiceEndpoint y la propiedad de navegación serviceEndpoints en las entidades Application y ServicePrincipal.Added support for service discovery with the ServiceEndpoint entity and the serviceEndpoints navigation property on the Application and ServicePrincipal entities.

  • Compatibilidad agregada con el comportamiento personalizado de aplicaciones que se puede invocar al consumir servicios con los tipos AddIn y KeyValue y la propiedad addIns en las entidades Application y ServicePrincipal.Added support for customized app behavior that can be invoked by consuming services with the AddIn and KeyValue types and the addIns property on the Application and ServicePrincipal entities.

  • Compatibilidad agregada con la autenticación sin contraseña con la entidad TrustedCAsForPasswordlessAuth, el tipo CertificateAuthorityInformation y la propiedad trustedCAsForPasswordlessAuth en la entidad TenantDetail.Added support for password-less authentication with the TrustedCAsForPasswordlessAuth entity, the CertificateAuthorityInformation type, and the trustedCAsForPasswordlessAuth property on the TenantDetail entity.

  • Se ha agregado la acción changePassword, que se puede llamar para permitir al usuario con sesión iniciada cambiar su contraseña.Added the changePassword action, which can be called to enable the signed-in user to change their password.

  • El cliente de Graph versiones 2.1.x requiere Graph API versión 1.6; el cliente de Graph versiones 2.0.x requiere Graph API 1.5.Graph Client versions 2.1.x require Graph API version 1.6; Graph Client versions 2.0.x require Graph API 1.5.

Cambios de entidadesEntity changes

EntidadEntityDescripción del cambioChange Description
ApplicationApplicationSe ha agregado la propiedad addIns, que define el comportamiento personalizado que puede usar un servicio de personalización para llamar a una aplicación en contextos específicos.Added the addIns property, which defines custom behavior that a consuming service can use to call an app in specific contexts.

Se ha agregado la propiedad de navegación serviceEndpoints, que contiene la colección de puntos de conexión de servicio que están disponibles para detección.Added the serviceEndpoints navigation property, which contains the collection of service endpoints that are available for discovery.
LicenseDetailLicenseDetailNueva entidad que contiene los detalles de licencia de un usuario.New entity that contains license details for a user.
ServiceEndpointServiceEndpointNueva entidad que contiene la información de detección del servicio.New entity that contains service discovery information.
ServicePrincipalServicePrincipalSe ha agregado la propiedad addIns, que define el comportamiento personalizado que puede usar un servicio de personalización para llamar a una aplicación en contextos específicos.Added the addIns property, which defines custom behavior that a consuming service can use to call an app in specific contexts.

Se ha agregado la propiedad de navegación serviceEndpoints, que contiene la colección de puntos de conexión de servicio que están disponibles para detección.Added the serviceEndpoints navigation property, which contains the collection of service endpoints that are available for discovery.
SubscribedSkuSubscribedSkuSe ha agregado la propiedad appliesTo.Added the appliesTo property.
TenantDetailTenantDetailSe ha agregado la propiedad trustedCAsForPasswordlessAuth, que contiene el conjunto de entidades de certificación usadas para validar la cadena de confianza mientras se realiza la autenticación sin contraseña.Added the trustedCAsForPasswordlessAuth property, which contains the set of certificate authorities used to validate the trust chain while performing password-less authentication.
TrustedCAsForPasswordlessAuthTrustedCAsForPasswordlessAuthNueva entidad que representa un conjunto de entidades de certificación para validar la cadena de confianza mientras se realiza la autenticación sin contraseña.New entity that represents a set of certificate authorities to validate the trust chain while performing password-less authentication.
UserUserSe ha agregado la propiedad creationType, que se utiliza para indicar que el usuario es una cuenta local.Added the creationType property, which is used to indicate that the user is a local account.

Se ha agregado la propiedad signInNames, que contiene la colección de nombres de inicio de sesión utilizados por un usuario de la cuenta local para iniciar sesión en un inquilino de Azure Active Directory B2C.Added the signInNames property, which contains the collection of sign-in names used by a local account user to sign in to an Azure Active Directory B2C tenant.El nombre de esta propiedad, alternativeSignInNamesInfo, cambia en la versión beta.This property is renamed from alternativeSignInNamesInfo in beta.

Se ha agregado la propiedad de navegación licenseDetails.Added the licenseDetails navigation property.

Cambios de tipo complejoComplex type changes

TipoTypeDescripción del cambioChange Description
AddInAddInNuevo tipo usado para definir el comportamiento personalizado que puede utilizar un servicio de consumo para llamar a una aplicación en contextos concretos.New type used to define custom behavior that a consuming service can use to call an app in specific contexts.
CertificateAuthorityInformationCertificateAuthorityInformationNuevo tipo que representa una entidad de certificación que se utiliza al validar la cadena de confianza cuando se realiza la autenticación sin contraseña.New type that represents a certificate authority used when validating the trust chain while performing password-less authentication.
KeyValueKeyValueNuevo tipo que contiene un par clave-valor que define un parámetro que puede usar un servicio de consumo, o al que puede llamar, en una aplicación especificada en AddIn.New type that contains a key-value pair that defines a parameter that a consuming service can use or call on an application specified in an AddIn.
ServicePlanInfoServicePlanInfoSe ha agregado la propiedad appliesTo.Added the appliesTo property.

Se ha agregado la propiedad provisioningStatus.Added the provisioningStatus property.
SignInNameSignInNameNuevo tipo para almacenar información sobre un nombre de inicio de sesión que puede utilizar un usuario de una cuenta local para iniciar sesión en un inquilino de Azure Active Directory B2C.New type to hold information about a sign-in name that can be used by a local account user to sign in to an Azure Active Directory B2C tenant.Este tipo ya no se llama LogonIdentifier en la versión beta.This type is renamed from LogonIdentifier in beta.

Cambios de función y acciónAction and function changes

FunciónFunctionDescripción del cambioChange Description
changePasswordchangePasswordNueva acción que se puede llamar para permitir al usuario con sesión iniciada cambiar su contraseña.New action that that can be called to enable the signed-in user to change their password.

Versión 1.5 Version 1.5

En esta sección se enumeran los cambios de Graph API versión 1.5.This section lists the changes for Graph API version 1.5.

Graph API versión 1.5 introduce los siguientes cambios de características:Graph API version 1.5 introduces the following feature changes:

  • El espacio de nombres del esquema de Graph API ha cambiado de Microsoft.WindowsAzure.ActiveDirectory a Microsoft.DirectoryServices.The schema namespace of Graph API has changed from Microsoft.WindowsAzure.ActiveDirectory to Microsoft.DirectoryServices.Esto afecta a todas las entidades y tipos complejos expuestos por Graph API.This affects all entities and complex types exposed by Graph API.

  • Se ha agregado compatibilidad con las extensiones de esquema de directorio.Support for directory schema extensions has been added.Esto permite agregar propiedades requeridas por la aplicación a los objetos de directorio.This allows you to add properties that are required by your application to directory objects.Las siguientes entidades admiten extensiones de esquema: User, Group, TenantDetail, Device, Application y ServicePrincipal.The following entities support schema extensions: User, Group, TenantDetail, Device, Application, and ServicePrincipal.Para permitir las extensiones de esquema, se ha agregado la entidad ExtensionProperty, se ha agregado la propiedad de navegación extensionProperties a la entidad Application y se ha agregado una nueva función, getAvailableExtensionProperties, para devolver las propiedades de extensiones registradas de objetos de directorio admitidos.To support directory schema extensions: the ExtensionProperty entity has been added, the extensionProperties navigation property has been added to the Application entity, and a new function, getAvailableExtensionProperties, has been added to return the registered extension properties of supported directory objects.Para más información sobre cómo extender el esquema de directorio, consulte las extensiones de esquema de directorio.For more information about extending the directory schema, see Directory schema extensions.

  • La manera en que se representan los permisos ha cambiado y está más estrechamente alineada con los conceptos de OAuth 2.0, así como con la manera en que se representa los permisos en otros componentes de Azure.The way in which permissions are represented has changed and is more tightly aligned with OAuth 2.0 concepts as well as with the way permissions are represented in other Azure components.Se ha eliminado la entidad Permission y se ha sustituido por la entidad OAuth2PermissionGrant.The Permission entity has been removed and has been replaced with the OAuth2PermissionGrant entity.Esta entidad representa ámbitos de permisos de OAuth 2.0 delegados que llegan a una notificación de ámbito de token de acceso de OAuth 2.0.This entity represents delegated OAuth 2.0 permissions scopes that arrive in an OAuth 2.0 access token scope claim.Además, la nueva entidad AppRoleAssignment representa los roles de aplicación que se pueden asignar a los usuarios, los grupos y las entidades de servicio.Additionally, the new AppRoleAssignment entity represents application roles that can be assigned to users, groups and service principals.También se han agregado dos tipos complejos relacionados: AppRole y OAuth2Permission.Two related complex types have also been added: AppRole and OAuth2Permission.Este cambio ha provocado el cambio del nombre de algunas propiedades y la adición de otras en las siguientes entidades: Application, Group, ServicePrincipal y User.This change has precipitated renaming some properties and adding others in the following entities: Application, Group, ServicePrincipal, and User.

  • El nombre de la entidad Role ha cambiado a DirectoryRole.The Role entity is renamed to DirectoryRole.

  • El nombre de la entidad RoleTemplate ha cambiado a DirectoryRoleTemplate.The RoleTemplate entity is renamed to DirectoryRoleTemplate.

En las tablas siguientes se muestran las entidades, los tipos complejos y las funciones que se han agregado, cambiado o quitado para esta versión.The following tables list the entities, complex types, and functions that have been added, changed, or removed for this release.

Cambios de entidadesEntity changes

EntidadEntityDescripción del cambioChange Description
ApplicationApplicationSe ha actualizado la propiedad appId de Edm.Guid a Edm.String.Updated the appId property from Edm.Guid to Edm.String.

Se ha agregado la propiedad appRoles, que contiene la colección de roles de aplicación que una aplicación puede declarar.Added the appRoles property, which contains the collection of application roles that an application may declare.Estos roles se pueden asignar a usuarios, grupos o entidades de servicio.These roles can be assigned to users, groups or service principals.

Se ha agregado la propiedad groupMembershipClaims, que es una máscara de bits que configura la notificación "grupos" emitida en un usuario o un token de acceso de OAuth 2.0 que la aplicación espera.Added the groupMembershipClaims property, which is a bitmask that configures the "groups" claim issued in a user or OAuth 2.0 access token that your application expects.Los valores de máscara de bits son: 0: ninguno, 1: grupos de seguridad y roles de Azure AD, 2: reservado y 4: reservado.The bitmask values are: 0: None, 1: Security groups and Azure AD roles, 2: Reserved, and 4: Reserved.Al establecer la máscara de bits en 7 se obtendrán todos los grupos de seguridad, los grupos de distribución y los roles de Azure AD de los que es miembro el usuario que inició sesión.Setting the bitmask to 7 will get all of the security groups, distribution groups, and Azure AD roles that the signed-in user is a member of.

Se ha agregado la propiedad knownClientApplications, que contiene una lista de las aplicaciones cliente que están vinculadas a esta aplicación de recursos.Added the knownClientApplications property, which contains a list of client applications that are tied to this resource application.El consentimiento de cualquiera de las aplicaciones cliente conocidas provocará el consentimiento implícito de la aplicación de recursos a través de un diálogo de consentimiento combinado (en el que se muestran los ámbitos de permisos OAuth requeridos por el cliente y el recurso).Consent to any of the known client applications will result in implicit consent to the resource application through a combined consent dialog (showing the OAuth permission scopes required by the client and the resource).

Se ha agregado la propiedad oauth2AllowImplicitFlow, que especifica si esta aplicación web puede solicitar tokens de flujo implícitos de OAuth2.0.Added the oauth2AllowImplicitFlow property, which specifies whether this web application can request OAuth2.0 implicit flow tokens.El valor predeterminado es false.The default is false.

Se ha agregado la propiedad oauth2AllowUrlPathMatching, que especifica si, como parte de las solicitudes de token de OAuth 2.0, Azure AD permitirá la coincidencia de ruta del URI de redirección con las URL de respuesta de la aplicación.Added the oauth2AllowUrlPathMatching property, which specifies whether, as part of OAuth 2.0 token requests, Azure AD will allow path matching of the redirect URI against the application's replyUrls.El valor predeterminado es false.The default is false.

Se ha agregado la propiedad oauth2Permissions, que contiene la colección de ámbitos de permiso de OAuth 2.0 que la aplicación de API web (recurso) expone a las aplicaciones cliente.Added the oauth2Permissions property, which contains the collection of OAuth 2.0 permission scopes that the web API (resource) application exposes to client applications.Estos ámbitos de permisos pueden concederse a las aplicaciones cliente durante el consentimiento.These permission scopes may be granted to client applications during consent.

Se ha agregado la propiedad oauth2RequiredPostResponse, que especifica si, como parte de las solicitudes de token de OAuth 2.0, Azure AD permitirá solicitudes POST en lugar de solicitudes GET.Added the oauth2RequiredPostResponse property, which specifies whether, as part of OAuth 2.0 token requests, Azure AD will allow POST requests, as opposed to GET requests.El valor predeterminado es false, que especifica que solo se permitirán solicitudes GET.Default is false, which specifies that only GET requests will be allowed.

Se ha agregado la propiedad requiredResourceAccess, que especifica los recursos a los que esta aplicación necesita acceso y el conjunto de ámbitos de permisos de OAuth y roles de aplicación que necesita en cada uno de esos recursos.Added the requiredResourceAccess property, which specifies resources that this application requires access to and the set of OAuth permission scopes and application roles that it needs under each of those resources.Esta configuración previa de acceso a los recursos necesarios impulsa la experiencia de consentimiento del usuario final.This pre-configuration of required resource access drives the end-user consent experience.

Se ha agregado la propiedad de navegación extensionProperties, que contiene las propiedades de extensión asociadas a la aplicación.Added the extensionProperties navigation property, which contains the extension properties associated with the application.
AppRoleAssignmentAppRoleAssignmentNueva entidad que se usa para registrar cuándo un usuario o grupo está asignado a una aplicación.New entity that is used to record when a user or group is assigned to an application.En este caso, tendrá como resultado una ventana de aplicación visible arriba en el panel de acceso de la aplicación del usuario.In this case it will result in an application tile showing up on the user's app access panel.Esta entidad también puede utilizarse para conceder acceso a otra aplicación (modelada como entidad de servicio) a una aplicación de recursos de un rol determinado.This entity may also be used to grant another application (modeled as a service principal) access to a resource application in a particular role.
ContactoContactSe ha agregado la propiedad sipProxyAddress, que especifica la dirección del protocolo de inicio de sesión (SIP) de la voz sobre IP (VOIP) para el contacto.Added the sipProxyAddress property, which specifies the voice over IP (VOIP) session initiation protocol (SIP) address for the contact.
DirectoryObjectDirectoryObjectSe ha agregado la propiedad deletionTimestamp, que indica la hora a la que se eliminó un objeto de directorio.Added the deletionTimestamp property, which indicates the time at which a directory object was deleted.Solo se aplica a los objetos de directorio que se pueden restaurar.It only applies to those directory objects which can be restored.Actualmente solo se admite para Application.Currently this is only supported for Application.
DirectoryRoleDirectoryRoleSe ha cambiado el nombre de Role.Renamed from Role.

Se ha agregado la propiedad roleTemplateId.Added the roleTemplateId property
DirectoryRoleTemplateDirectoryRoleTemplateHa cambiado el nombre de RoleTemplate.Renamed from RoleTemplate.
ExtensionPropertyExtensionPropertyNueva entidad que permite que una aplicación defina y use un conjunto de propiedades adicionales que se pueden agregar a objetos de directorio (usuarios, grupos, detalles de inquilino, dispositivos, aplicaciones y entidades de servicio) sin que la aplicación requiera un almacén de datos externo.New entity that allows an application to define and use a set of additional properties that can be added to directory objects (users, groups, tenant details, devices, applications, and service principals) without the application requiring an external data store.
GroupGroupSe ha agregado la propiedad onPremisesSecurityIdentifier, que contiene el identificador de seguridad local (SID) para el grupo que se sincronizó desde el entorno local con la nube.Added the onPremisesSecurityIdentifier property, which contains the on-premises security identifier (SID) for the group that was synchronized from on-premises to the cloud.

Se ha agregado la propiedad de navegación appRoleAssignments, que señala al conjunto de aplicaciones (entidades de servicio) al que está asignado este grupo.Added the appRoleAssignments navigation property, which points to the set of applications (service principals) that this group is assigned to.
OAuth2PermissionGrantOAuth2PermissionGrantNueva entidad que especifica un ámbito de permisos delegados de OAuth2.0.New entity that specifies an OAuth2.0 delegated permission scope.El ámbito de permisos delegados de OAuth especificado pueden solicitarlo las aplicaciones cliente (a través de la colección requiredResourceAccess) que llaman a esta aplicación de recursos.The specified OAuth delegated permission scope may be requested by client applications (through the requiredResourceAccess collection) calling this resource application.Reemplaza la entidad Permission que se eliminó de esta versión.Replaces the Permission entity which is removed from this version.
PermisoPermissionHa cambiado el nombre a OAuth2PermissionGrant.Renamed to OAuth2PermissionGrant.
RolRoleHa cambiado el nombre a DirectoryRole.Renamed to DirectoryRole.
RoleTemplateRoleTemplateHa cambiado el nombre a DirectoryRoleTemplate.Renamed to DirectoryRoleTemplate.
ServicePrincipalServicePrincipalSe ha agregado la propiedad appDisplayName, que especifica el nombre para mostrar expuesto por la aplicación asociada.Added the appDisplayName property, which specifies the display name exposed by the associated application.

Se ha agregado la propiedad appRoleAssignmentRequired, que especifica si se requiere un objeto AppRoleAssignment para un usuario o grupo antes de que Azure AD pueda emitir un token de usuario o de acceso a la aplicación.Added the appRoleAssignmentRequired property, which specifies whether an AppRoleAssignment to a user or group is required before Azure AD will issue a user or access token to the application.

Se ha agregado la propiedad appRoles, que contiene los roles de aplicación expuestos por la aplicación asociada.Added the appRoles property, which contains the application roles exposed by the associated application.Para obtener más información, consulte la definición de la propiedad appRoles en la entidad Application.For more information see the appRoles property definition on the Application entity.

Se ha agregado la propiedad oauth2Permissions, que contiene los permisos de OAuth 2.0 expuestos por la aplicación asociada.Added the oauth2Permissions property, which contains the OAuth 2.0 permissions exposed by the associated application.Para obtener más información, consulte la definición de la propiedad oauth2Permisions en la entidad Application.For more information see the oauth2Permisions property definition on the Application entity.

Se ha agregado la propiedad preferredTokenSigningKeyThumbprint.Added the preferredTokenSigningKeyThumbprint property.Reservado solo para uso interno.Reserved for internal use only.No escriba ni dependa de otra manera de esta propiedad.Do not write or otherwise rely on this property.Puede quitarse en versiones futuras.May be removed in future versions.

Se ha agregado la propiedad de navegación appRoleAssignedTo, que señala al conjunto de aplicaciones al que está asignada la entidad de servicio.Added the appRoleAssignedTo navigation property, which points to the set of applications that the service principal is assigned to.

Se ha agregado la propiedad de navegación appRoleAssignments, que señala al conjunto de entidades de servicio (usuarios, grupos y entidades de servicio) asignadas a esta entidad de servicio.Added the appRoleAssignments navigation property, which points to the set of principals (users, groups, and service principals) that are assigned to this service principal.

Se ha agregado la propiedad de navegación oauth2PermissionGrants, que señala al conjunto de concesiones de suplantación de usuario asociadas a esta entidad de servicio.Added the oauth2PermissionGrants navigation property, which points to the set of user impersonation grants associated with this service principal.

Se ha quitado la propiedad de navegación permissionsRemoved the permissions navigation property
TenantDetailTenantDetailSe ha quitado la propiedad tenantType.Removed the tenantType property.
UserUserSe ha agregado la propiedad onPremisesSecurityIdentifier, que contiene el identificador de seguridad local (SID) para el usuario que se sincronizó desde el entono local en la nube.Added the onPremisesSecurityIdentifier property, which contains the on-premises security identifier (SID) for the user that was synchronized from on-premises to the cloud.

Se ha agregado la propiedad sipProxyAddress, que especifica la dirección del protocolo de inicio de sesión (SIP) de la voz sobre IP (VOIP) para el usuario.Added the sipProxyAddress property, which specifies the voice over IP (VOIP) session initiation protocol (SIP) address for the user.

Se ha agregado la propiedad de navegación appRoleAssignments, que señala al conjunto de aplicaciones (entidades de servicio) al que está asignado este usuario.Added the appRoleAssignments navigation property, which points to the set of applications (service principals) that this user is assigned to.

Se ha agregado la propiedad de navegación oauth2PermissionGrants, que señala al conjunto de concesiones de suplantación de usuario de OAuth 2.0 asociadas a este usuario.Added the oauth2PermissionGrants navigation property, which points to the set of OAuth 2.0 user impersonation grants associated with this user.

Se ha quitado la propiedad de navegación permissions.Removed the permissions navigation property.

Cambios de tipo complejoComplex type changes

TipoTypeDescripción del cambioChange Description
AppRoleAppRoleNuevo tipo que especifica los roles de aplicación que se pueden solicitar por aplicaciones de cliente que llaman a esta aplicación o que se pueden usar para asignar la aplicación a usuarios o grupos en uno de los roles de aplicación especificados.New type that specifies application roles that may be requested by client applications calling this application, or that may be used to assign the application to users or groups in one of the specified application roles.
OAuth2PermissionOAuth2PermissionNuevo tipo que representa un ámbito de permisos de OAuth 2.0.New type that represents an OAuth 2.0 permission scope.El ámbito de permisos delegados de OAuth 2.0 especificado pueden solicitarlo las aplicaciones cliente (a través de la colección requiredResourceAccess) que llaman a esta aplicación de recursos.The specified OAuth 2.0 permission scope may be requested by client applications (through the requiredResourceAccess collection) calling this resource application.
RequiredResourceAccessRequiredResourceAccessNuevo tipo que especifica el conjunto de ámbitos de permiso de OAuth 2.0 y roles de aplicación en el recurso especificado al que una aplicación requiere acceso.New type that specifies the set of OAuth 2.0 permission scopes and app roles under the specified resource that this application requires access to.
ResourceAccessResourceAccessNuevo tipo que representa un permiso que esta aplicación requiere.New type that represents a permission that this application requires.

Cambios de función y acciónAction and function changes

FunciónFunctionDescripción del cambioChange Description
getAvailableExtensionPropertiesgetAvailableExtensionPropertiesNueva función que devuelve la lista completa de propiedades de extensión que se han registrado en un directorio.New function that returns the full list of extension properties that have been registered in a directory.Se pueden registrar propiedades de extensión para las siguientes entidades: User, Group, Device, TenantDetail, Application y ServicePrincipal.Extension properties can be registered for the following entities: User, Group, Device, TenantDetail, Application, and ServicePrincipal.
getMemberObjectsgetMemberObjectsNueva función que devuelve todos los objetos Group y DirectoryRole de los que un usuario, contacto, grupo o entidad de servicio sea miembro de manera transitiva.New function that returns all of the Group and DirectoryRole objects that a user, contact, group, or service principal is transitively a member of.
getObjectsByObjectIdsgetObjectsByObjectIdsNueva función que devuelve los objetos de directorio especificados en una lista de identificadores de objeto.New function that returns the directory objects specified in a list of object IDs.También puede especificar las colecciones de recursos (usuarios, grupos, etc.) en las que se debe buscar si especifica el parámetro opcional types.You can also specify which resource collections (users, groups, etc.) should be searched by specifying the optional types parameter.
restaurarrestoreNueva acción de servicio que permite la restauración de una aplicación eliminada.New service action that allows a deleted application to be restored.

Versión 2013-11-08 Version 2013-11-08

En esta sección se enumeran los cambios de Graph API versión 2013-11-08.This section lists the changes for Graph API version 2013-11-08.

En las tablas siguientes se muestran las entidades, los tipos complejos y las funciones que se han agregado, cambiado o quitado para esta versión.The following tables list the entities, complex types, and functions that have been added, changed, or removed for this release.

Cambios de entidadesEntity changes

EntidadEntityDescripción del cambioChange Description
ApplicationApplicationSe ha agregado la propiedad de navegación owners, que señala al conjunto de objetos de directorio que son propietarios de la aplicación.Added the owners navigation property, which points to the set of directory objects that are owners of the application.Los propietarios son un conjunto de usuarios no administrativos que tienen permiso para modificar este objeto.The owners are a set of non-admin users who are allowed to modify this object.Se hereda de DirectoryObject.Inherited from DirectoryObject.
DeviceConfigurationDeviceConfigurationNueva entidad que representa la configuración de un dispositivo.New entity that represents the configuration for a device.
DirectoryObjectDirectoryObjectSe ha agregado la propiedad de navegación createdOnBehalfOf, que señala al objeto de directorio en nombre del cual se creó este objeto.Added the createdOnBehalfOf navigation property, which points to directory object that that this object was created on behalf of.

Se ha agregado la propiedad de navegación createdObjects, que señala al conjunto de objetos de directorio creados por el objeto actual.Added the createdObjects navigation property, which points to the set of directory objects that were created by the current object.

Se ha agregado la propiedad de navegación owners, que señala al conjunto de objetos de directorio que son propietarios del objeto actual.Added the owners navigation property, which points to the set of directory objects that are owners of the current object.Los propietarios son un conjunto de usuarios no administrativos que tienen permiso para modificar este objeto.The owners are a set of non-admin users who are allowed to modify this object.

Se ha agregado la propiedad de navegación ownedObjects, que señala al conjunto de objetos de directorio que son propiedad del objeto actual.Added the ownedObjects navigation property, which points to the set of directory objects that are owned by the current object.

Importante: Las entidades que se derivan de DirectoryObject heredan sus propiedades y pueden heredar sus propiedades de navegación.Important: Entities that derive from DirectoryObject inherit its properties and may inherit its navigation properties.
GroupGroupSe ha agregado la propiedad de navegación owners, que señala al conjunto de objetos de directorio que son propietarios del grupo.Added the owners navigation property, which points to the set of directory objects that are owners of the group.Los propietarios son un conjunto de usuarios no administrativos que tienen permiso para modificar este objeto.The owners are a set of non-admin users who are allowed to modify this object.Se hereda de DirectoryObject.Inherited from DirectoryObject.
RolRoleSe ha agregado la propiedad de navegación ownedObjects, que señala al conjunto de objetos de directorio que son propiedad del rol.Added the ownedObjects navigation property, which points to the set of directory objects that are owned by the role.Se hereda de DirectoryObject. El nombre de la entidad Role ha cambiado a DirectoryRole a partir de la versión 1.5.Inherited from DirectoryObject.The Role entity was renamed to DirectoryRole beginning with version 1.5.Para obtener más información sobre Role, consulte DirectoryRole.For information about Role, see DirectoryRole.
ServicePrincipalServicePrincipalSe ha agregado la propiedad appOwnerTenantID.Added the appOwnerTenantID property.

Se ha agregado la propiedad autheniticationPolicy.Added the autheniticationPolicy property.Reservado solo para uso interno.Reserved for internal use only.No lo use.Do not use.Quitado en la versión 1.5.Removed in version 1.5.

Se ha agregado la propiedad de navegación createdObjects, que señala al conjunto de objetos de directorio creados por la entidad de servicio.Added the createdObjects navigation property, which points to the set of directory objects that were created by the service principal.Se hereda de DirectoryObject.Inherited from DirectoryObject.

Se ha agregado la propiedad de navegación owners, que señala al conjunto de objetos de directorio que son propietarios de la entidad de servicio.Added the owners navigation property, which points to the set of directory objects that are owners of the service principal.Los propietarios son un conjunto de usuarios no administrativos que tienen permiso para modificar este objeto.The owners are a set of non-admin users who are allowed to modify this object.Se hereda de DirectoryObject.Inherited from DirectoryObject.

Se ha agregado la propiedad de navegación ownedObjects, que señala al conjunto de objetos de directorio que son propiedad de la entidad de servicio.Added the ownedObjects navigation property, which points to the set of directory objects that are owned by the service principal.Se hereda de DirectoryObject.Inherited from DirectoryObject.
UserUserSe ha agregado la propiedad immutableId, que asocia una cuenta de usuario de Active Directory local a su objeto de usuario de Azure AD.Added the immutableId property, which associates an on-premises Active Directory user account to its Azure AD user object.Esta propiedad se debe especificar al crear una nueva cuenta de usuario en Graph si se usa un dominio federado para la propiedad userPrincipalName (UPN) del usuario.This property must be specified when creating a new user account in the Graph if you are using a federated domain for the user’s userPrincipalName (UPN) property.

Se ha agregado la propiedad userType, que es un valor de cadena que se puede usar para clasificar tipos de usuario en el directorio, como "Member" y "Guest".Added the userType property, which is a string value that can be used to classify user types in your directory, such as “Member” and “Guest”.

Se ha agregado la propiedad de navegación createdObjects, que señala al conjunto de objetos de directorio creados por el usuario.Added the createdObjects navigation property, which points to the set of directory objects that were created by the user.Se hereda de DirectoryObject.Inherited from DirectoryObject.

Se ha agregado la propiedad de navegación ownedObjects, que señala al conjunto de objetos de directorio que son propiedad del usuario.Added the ownedObjects navigation property, which points to the set of directory objects that are owned by the user.Se hereda de DirectoryObject.Inherited from DirectoryObject.

Cambios de tipo complejoComplex type changes

TipoTypeDescripción del cambioChange Description
ServicePrincipalAuthenticationPolicyServicePrincipalAuthenticationPolicyReservado solo para uso interno.Reserved for internal use only.No lo use.Do not use.Quitado en la versión 1.5.Removed in version 1.5.

Cambios de función y acciónAction and function changes

FunciónFunctionDescripción del cambioChange Description
assignLicenseassignLicenseNueva acción de servicio que actualiza un usuario con una lista de licencias para agregar o quitar.New service action that updates a user with a list of licenses to add and/or remove.

Versión 2013-04-05 Version 2013-04-05

Se trata de la versión base de Graph API.This is the base version of the Graph API.

Recursos adicionales Additional resources

© 2018 Microsoft