Table of contents

Správa verzí | Rozhraní Graph API konceptyVersioning | Graph API concepts

Bryan Lamos|Poslední aktualizace: 19. 6. 2018
|
1 Přispěvatel

Platí pro: Graph API | Azure Active Directory (AD)Applies to: Graph API | Azure Active Directory (AD)

Toto téma shrnuje rozdíly verze entity Azure Active Directory (AD) Graph API a operace.This topic summarizes the version differences for Azure Active Directory (AD) Graph API entities and operations.Je nutné zadat verzi operace, kterou chcete použít zahrnutím api-version parametr řetězce ve vaší žádosti dotazu.You must specify the version of an operation that you want to use by including the api-version query string parameter in your request.Požadavky bez api-version parametr se odmítne a vrátit (400) – chybný požadavek odpovědi.Requests without an api-version parameter will be rejected and return a (400) Bad Request response.Volá-li služby starší verze operace, můžete rozhodnout pokračovat v volání starší verze, nebo upravit na volání na novější verzi.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.Žádné rozdíly ve funkcích mezi verzemi jsou uvedeny v dokumentaci pro entitu, na kterém provádíte volání.Any differences in functionality between versions are outlined in the documentation for the entity upon which you are performing the call.

Důležité

Důrazně doporučujeme použít Microsoft Graph místo Azure AD Graph API pro přístup k prostředkům Azure Active Directory.We strongly recommend that you use Microsoft Graph instead of Azure AD Graph API to access Azure Active Directory resources.Náš vývojový program jsou nyní soustředit na Microsoft Graph a dále jsou plánované pro Azure AD Graph API.Our development efforts are now concentrated on Microsoft Graph and no further enhancements are planned for Azure AD Graph API.Je velmi omezený počet scénářů, pro které Azure AD Graph API může být vhodné; Další informace najdete v tématu Microsoft Graph nebo Azure AD Graph příspěvku na blogu v Office Dev Center.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.

Od verze Azure AD Graph API verze 1.5, api-version hodnota parametru pro verze obecné dostupnosti (GA) je zadán jako číselná hodnota.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.Následující adresa URL ukazuje, jak zadat dotaz na nejvyšší úrovni prostředky pro klienta doménu contoso.com pomocí rozhraní Graph API verze 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.Pro předchozí verze rozhraní Graph API api-version hodnota parametru je zadán jako řetězec datum v následujícím formátu: rrrr-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.Následující adresa URL ukazuje, jak zadat dotaz na nejvyšší úrovni prostředky stejné klienta pomocí rozhraní Graph API verze 2013 – 11-08: 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.Pro funkce verze preview api-version je zadaná hodnota parametru pomocí řetězce "beta" následujícím způsobem: 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.

Rozhraní API kontrakt, Správa verzí a nejnovější změnyAPI contract, versioning and breaking changes

Jsme se zvýší číslo verze rozhraní API pro všechny nejnovější změny rozhraní API za účelem ochrany klientské aplikace.We will increment the API version number for any breaking changes to the API, in order to protect client applications.Jsme rozhodnout se zvýší verze rozhraní API pro pevné změny příliš (například pokud přidáme některé výrazně velké nové funkce).We may choose to increment the API version for non-breaking changes too (for example, if we add some significantly large new capabilities).

Ano co se považuje za narušující změně?So, what constitutes a breaking change?

  • Odebrání nebo přejmenování parametry rozhraní API a rozhraní APIRemoving or renaming APIs or API parameters
  • Změny v chování pro existující rozhraní APIChanges in behavior for an existing API
  • Změny v kódy chyb a selhání kontraktyChanges in Error Codes & Fault Contracts
  • Všechno, co by způsobila porušení Princip nejnižších AstonishmentAnything that would violate the Principle of Least Astonishment

Poznámka:: Přidání nové pole JSON k odpovědím nepředstavuje narušující změně.Note:The addition of new JSON fields to responses does not constitute a breaking change.Naše doprovodné materiály pro vývojáře, kteří generovat vlastní proxy klienta (například klienti WCF) je, že klientské aplikace by měla být připraveny na přijetí vlastnosti a definované dříve službou rozhraní Graph API odvozené typy.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.I když rozhraní Graph API ještě není kompatibilní s v době psaní tohoto textu OData V4, stále dodržovat pokyny popsané v části Model správy verzí v specifikace 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.

Když jsme zvýšit hlavní verzi rozhraní API (například ze 1.5 na 2.0), jsme jsou signalizace, všechny podporu pro existující klienty pomocí předchozí 1.x nebo starší verze, bude zastaralá a již není podporována po dobu 12 měsíců.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.Podrobnosti najdete zásadách životního cyklu podpory Online služeb Microsoft další podrobnosti.Please see the Microsoft Online Services Support Lifecycle Policy for more details.

Podporované verzeSupported versions

V následujících verzích byly vydány pro rozhraní Graph API.The following versions have been released for the Graph API.

Beta verze Version beta

Funkce rozhraní Graph API aktuálně ve verzi preview lze nalézt v buď funkce verze Preview část v koncepty rozhraní Graph API nebo na Blog týmu grafu.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.Beta verze funkce vyžadují "verze api-version = beta" parametr řetězce dotazu.Beta features require the “api-version=beta” query string parameter.Když týmem rozhraní Graph API dochází k závěru, že je funkce Náhled připravený pro GA, přidáme této funkce na nejnovější verzi GA (nebo pokud se považuje za narušující změny, které to by způsobilo zvýšena nové číslo verze).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).Provedeme žádné záruky, že všeobecné bude povýšen funkce previewWe make no guarantees that a preview feature will be promoted to GA.

Beta verze pokusíme Vyhněte se co nejvíce všechny nejnovější změny, ale nebude Zaručujeme.For the beta version, we will try to avoid any breaking changes as much as possible, but we will not guarantee it.Čas od času klientským aplikacím pomocí beta verze očekávat nejnovější změny.Client applications using the beta version should expect breaking changes from time to time.Najdete v tématu doplňkové podmínky použití pro Microsoft Azure Preview.Please see Supplemental Terms of Use for Microsoft Azure Previews.

Verzi 1.6 Version 1.6

Tato část obsahuje seznam změn pro rozhraní Graph API verze 1.6.This section lists the changes for Graph API version 1.6.

Graf rozhraní API verze 1.6 zavádí následující změny funkcí:Graph API version 1.6 introduces the following feature changes:

Změny entityEntity changes

EntityEntityZměnit popisChange Description
aplikaceApplicationPřidat addIns vlastnosti, která definuje vlastní chování, které využívání služby můžete využít k volání aplikace v konkrétní kontexty.Added the addIns property, which defines custom behavior that a consuming service can use to call an app in specific contexts.

Přidat třídy serviceEndpoints navigační vlastnost, která obsahuje kolekci koncové body služby, které jsou k dispozici pro zjišťování.Added the serviceEndpoints navigation property, which contains the collection of service endpoints that are available for discovery.
LicenseDetailLicenseDetailNová entita, který obsahuje licenční informace pro uživatele.New entity that contains license details for a user.
koncového bodu službyServiceEndpointNová entita, která obsahuje informace o zjišťování služby.New entity that contains service discovery information.
ServicePrincipalServicePrincipalPřidat addIns vlastnosti, která definuje vlastní chování, které využívání služby můžete využít k volání aplikace v konkrétní kontexty.Added the addIns property, which defines custom behavior that a consuming service can use to call an app in specific contexts.

Přidat třídy serviceEndpoints navigační vlastnost, která obsahuje kolekci koncové body služby, které jsou k dispozici pro zjišťování.Added the serviceEndpoints navigation property, which contains the collection of service endpoints that are available for discovery.
SubscribedSkuSubscribedSkuPřidat AppliesTo – vlastnost.Added the appliesTo property.
TenantDetailTenantDetailPřidat trustedCAsForPasswordlessAuth vlastnosti, která obsahuje sadu certifikačních autorit, které slouží k ověření řetězu při provádění ověřování bez hesla.Added the trustedCAsForPasswordlessAuth property, which contains the set of certificate authorities used to validate the trust chain while performing password-less authentication.
TrustedCAsForPasswordlessAuthTrustedCAsForPasswordlessAuthNová entita, která představuje sadu certifikačních autorit k ověření řetězu při ověřování bez hesla.New entity that represents a set of certificate authorities to validate the trust chain while performing password-less authentication.
uživateleUserPřidat creationType vlastnosti, která slouží k označení, že uživatel je místní účet.Added the creationType property, which is used to indicate that the user is a local account.

Přidat signInNames vlastnosti, která obsahuje kolekci názvů přihlášení použili uživatel místní účet k přihlášení do klienta 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.Tato vlastnost je přejmenován ze alternativeSignInNamesInfo ve verzi beta.This property is renamed from alternativeSignInNamesInfo in beta.

Přidat licenseDetails navigační vlastnost.Added the licenseDetails navigation property.

Komplexní typ změnyComplex type changes

TypTypeZměnit popisChange Description
doplněkAddInNový typ se používá k definování vlastní chování, které využívání služby můžete využít k volání aplikace v konkrétní kontexty.New type used to define custom behavior that a consuming service can use to call an app in specific contexts.
CertificateAuthorityInformationCertificateAuthorityInformationNový typ, který představuje certifikační autorita používaná při ověření řetězu při provádění ověřování bez hesla.New type that represents a certificate authority used when validating the trust chain while performing password-less authentication.
KeyValueKeyValueNový typ, který obsahuje pár klíč hodnota, která definuje parametr, který využívání služby můžete použít nebo volání aplikace zadané v doplněk.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.
ServicePlanInfoServicePlanInfoPřidat AppliesTo – vlastnost.Added the appliesTo property.

Přidat provisioningStatus vlastnost.Added the provisioningStatus property.
SignInNameSignInNameNový typ uchovávání informací o název přihlášení, který lze použít uživatel místní účet pro přihlášení k klienta služby 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.Tento typ je přejmenován ze LogonIdentifier ve verzi beta.This type is renamed from LogonIdentifier in beta.

Akce a funkce změnyAction and function changes

FunkceFunctionZměnit popisChange Description
Změna hesla bylachangePasswordNová akce, kterou lze volat pro povolení přihlášeného uživatele Chcete-li změnit své heslo.New action that that can be called to enable the signed-in user to change their password.

Verze 1.5 Version 1.5

Tato část obsahuje seznam změn pro rozhraní Graph API verze 1.5.This section lists the changes for Graph API version 1.5.

Graf rozhraní API verze 1.5 zavádí následující změny funkcí:Graph API version 1.5 introduces the following feature changes:

  • Obor názvů schématu rozhraní Graph API se změnil z Microsoft.WindowsAzure.ActiveDirectory k Microsoft.DirectoryServices.The schema namespace of Graph API has changed from Microsoft.WindowsAzure.ActiveDirectory to Microsoft.DirectoryServices.To ovlivní všechny entity a komplexní typy vystavené rozhraní Graph API.This affects all entities and complex types exposed by Graph API.

  • Byla přidána podpora pro rozšíření schématu adresáře.Support for directory schema extensions has been added.To umožňuje přidávat vlastnosti, které vyžaduje vaše aplikace a objektů adresáře.This allows you to add properties that are required by your application to directory objects.Následující entity, které podporují rozšíření schématu: uživatele, skupiny, TenantDetail, zařízení, aplikace, a ServicePrincipal.The following entities support schema extensions: User, Group, TenantDetail, Device, Application, and ServicePrincipal.Pro podporu rozšíření schématu adresáře: ExtensionProperty přidala entity extensionProperties navigační vlastnost byla přidána do aplikaceentitu a nové funkce, getAvailableExtensionProperties, byla přidána na vrátit vlastnosti registrovaných rozšíření podporovány objekty adresáře.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.Další informace o rozšíření schématu adresáře najdete v tématu rozšíření schématu adresáře.For more information about extending the directory schema, see Directory schema extensions.

  • Způsob, ve kterém jsou reprezentované oprávnění se změnil a je, že více naprosto v souladu s koncepty OAuth 2.0, a také s oprávněními způsob, jak jsou reprezentována v součásti 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.Oprávnění entity, byla odebrána a nahradilo OAuth2PermissionGrant entity.The Permission entity has been removed and has been replaced with the OAuth2PermissionGrant entity.Tato entita představuje delegované obory oprávnění OAuth 2.0, které dorazí v deklaraci identity tokenu oboru přístupu OAuth 2.0.This entity represents delegated OAuth 2.0 permissions scopes that arrive in an OAuth 2.0 access token scope claim.Kromě toho nové AppRoleAssignment entity představuje aplikační role, které lze přiřadit k uživatele, skupiny a objekty služby.Additionally, the new AppRoleAssignment entity represents application roles that can be assigned to users, groups and service principals.Dva spojené, komplexní typy také byly přidány: aplikační role a OAuth2Permission.Two related complex types have also been added: AppRole and OAuth2Permission.Tato změna má vysráží přejmenování některé vlastnosti a přidání jiné v následujících entit: aplikace, skupiny, ServicePrincipala uživatele.This change has precipitated renaming some properties and adding others in the following entities: Application, Group, ServicePrincipal, and User.

  • Role entity je přejmenován na DirectoryRole.The Role entity is renamed to DirectoryRole.

  • Šablony role entity je přejmenován na DirectoryRoleTemplate.The RoleTemplate entity is renamed to DirectoryRoleTemplate.

V následujících tabulkách jsou uvedeny entity, komplexní typy a funkce, které byly přidány, změnit nebo odebrat pro tuto verzi.The following tables list the entities, complex types, and functions that have been added, changed, or removed for this release.

Změny entityEntity changes

EntityEntityZměnit popisChange Description
aplikaceApplicationAktualizovat appId vlastnost z Edm.Guid na Edm.String.Updated the appId property from Edm.Guid to Edm.String.

Přidat appRoles vlastnosti, která obsahuje kolekci aplikační role, které aplikace může deklarovat.Added the appRoles property, which contains the collection of application roles that an application may declare.Tyto role lze přiřadit na uživatele, skupiny nebo objekty služby.These roles can be assigned to users, groups or service principals.

Přidat groupMembershipClaims vlastnost, která je bitová maska, která nakonfiguruje "skupiny" deklarace identity vystavené v uživatele nebo přístupový token OAuth 2.0, který očekává vaší aplikace.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.Bitová maska hodnoty jsou: 0: None, 1: skupin zabezpečení a role se službou Azure AD, 2: vyhrazené a 4: vyhrazené.The bitmask values are: 0: None, 1: Security groups and Azure AD roles, 2: Reserved, and 4: Reserved.Nastavení bitové masky do 7, získají všechny skupiny zabezpečení, distribuční skupiny a role Azure AD, které je přihlášený uživatel členem.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.

Přidat knownClientApplications vlastnosti, která obsahuje seznam klientských aplikací, které jsou svázané s této prostředků aplikace.Added the knownClientApplications property, which contains a list of client applications that are tied to this resource application.Souhlas s žádné známé klientské aplikace bude výsledkem implicitní souhlasu prostředků aplikace prostřednictvím kombinované souhlasu dialogové okno (zobrazující obory oprávnění OAuth vyžadují klienta a prostředek).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).

Přidat oauth2AllowImplicitFlow vlastnosti, která určuje, zda tato webová aplikace může požadovat tokeny OAuth2.0 implicitního toku.Added the oauth2AllowImplicitFlow property, which specifies whether this web application can request OAuth2.0 implicit flow tokens.Výchozí hodnota je false.The default is false.

Přidat oauth2AllowUrlPathMatching vlastnosti, která určuje, zda, v rámci žádostí o token OAuth 2.0, Azure AD bude umožňovat cesta shody se identifikátor URI přesměrování proti replyUrls aplikace.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.Výchozí hodnota je false.The default is false.

Přidat oauth2Permissions vlastnosti, která obsahuje kolekci obory oprávnění OAuth 2.0, které zpřístupní webové aplikace rozhraní API (prostředků) pro klientské aplikace.Added the oauth2Permissions property, which contains the collection of OAuth 2.0 permission scopes that the web API (resource) application exposes to client applications.Tyto obory oprávnění může být poskytnuta pro klientské aplikace během souhlasu.These permission scopes may be granted to client applications during consent.

Přidat oauth2RequiredPostResponse vlastnost, která určuje, zda v rámci žádostí o token OAuth 2.0, Azure AD umožní požadavků POST a požadavky 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.Výchozí hodnota je false, která určuje, že pouze GET požadavky, bude možné.Default is false, which specifies that only GET requests will be allowed.

Přidat requiredResourceAccess vlastnosti, která určuje prostředky, které tato aplikace vyžaduje přístup k a sadu obory oprávnění OAuth a aplikační role, které je nutné v každém z těchto prostředků.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.Tato předběžná konfigurace přístupu požadovaný prostředek jednotky souhlasu činnost koncového uživatele.This pre-configuration of required resource access drives the end-user consent experience.

Přidat extensionProperties navigační vlastnost, která obsahuje vlastnosti rozšíření, které jsou přidružené k aplikaci.Added the extensionProperties navigation property, which contains the extension properties associated with the application.
AppRoleAssignmentAppRoleAssignmentNová entita, která se používá k záznamu, zda uživatel nebo skupina je přiřazena k aplikaci.New entity that is used to record when a user or group is assigned to an application.V takovém případě je výsledkem bude dlaždici aplikace zobrazen až na panel přístupu aplikace uživatele.In this case it will result in an application tile showing up on the user's app access panel.Tuto entitu lze také udělit jinou aplikaci (modelován jako objekt služby) přístup k aplikaci prostředků v konkrétní roli.This entity may also be used to grant another application (modeled as a service principal) access to a resource application in a particular role.
Obraťte se naContactPřidat sipProxyAddress vlastnosti, která určuje hlasu přes IP (VOIP) relace spuštění protocol (SIP) adresa kontaktu.Added the sipProxyAddress property, which specifies the voice over IP (VOIP) session initiation protocol (SIP) address for the contact.
DirectoryObjectDirectoryObjectPřidat deletionTimestamp vlastnosti, která označuje čas, kdy byl odstraněn objekt adresáře.Added the deletionTimestamp property, which indicates the time at which a directory object was deleted.Platí jenom pro tyto objekty adresáře, které může být obnovena.It only applies to those directory objects which can be restored.Aktuálně je podporováno pouze pro aplikace.Currently this is only supported for Application.
DirectoryRoleDirectoryRolePřejmenovat z Role.Renamed from Role.

Přidat roleTemplateId vlastnostAdded the roleTemplateId property
DirectoryRoleTemplateDirectoryRoleTemplatePřejmenovat z šablony role.Renamed from RoleTemplate.
ExtensionPropertyExtensionPropertyNová entita, která umožňuje aplikaci definice a používání sadu další vlastnosti, které mohou být přidány do objektů adresáře (uživatelé, skupiny, podrobnosti o klientovi, zařízení, aplikací a objekty služby) bez nutnosti externím úložišti aplikace.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.
skupinyGroupPřidat onPremisesSecurityIdentifier vlastnosti, která obsahuje místní identifikátor zabezpečení (SID) pro skupinu, které se synchronizovaly z místní do cloudu.Added the onPremisesSecurityIdentifier property, which contains the on-premises security identifier (SID) for the group that was synchronized from on-premises to the cloud.

Přidat appRoleAssignments navigační vlastnost, která odkazuje na sadu aplikací (objekty služby), které tato skupina je přiřazena k.Added the appRoleAssignments navigation property, which points to the set of applications (service principals) that this group is assigned to.
OAuth2PermissionGrantOAuth2PermissionGrantNové entity, který určuje OAuth2.0 delegovaná oprávnění oboru.New entity that specifies an OAuth2.0 delegated permission scope.Zadaný OAuth oboru delegovaná oprávnění mohou být vyžádány klientskými aplikacemi (prostřednictvím requiredResourceAccess kolekce) volání této prostředků aplikace.The specified OAuth delegated permission scope may be requested by client applications (through the requiredResourceAccess collection) calling this resource application.Nahradí oprávnění entity, který je odebraný z této verze.Replaces the Permission entity which is removed from this version.
OprávněníPermissionPřejmenované na OAuth2PermissionGrant.Renamed to OAuth2PermissionGrant.
RoleRolePřejmenované na DirectoryRole.Renamed to DirectoryRole.
RoleTemplateRoleTemplatePřejmenované na DirectoryRoleTemplate.Renamed to DirectoryRoleTemplate.
ServicePrincipalServicePrincipalPřidat appDisplayName vlastnosti, která určuje zobrazovaný název vystavené v přidružené aplikaci.Added the appDisplayName property, which specifies the display name exposed by the associated application.

Přidat appRoleAssignmentRequired vlastnosti, která určuje, jestli AppRoleAssignment pro uživatele nebo skupiny se vyžaduje, aby Azure AD vydá uživatele nebo přístupový token aplikace.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.

Přidat appRoles vlastnosti, která obsahuje aplikaci role vystavené v přidružené aplikaci.Added the appRoles property, which contains the application roles exposed by the associated application.Další informace najdete v článku appRoles definici vlastnosti na aplikace entity.For more information see the appRoles property definition on the Application entity.

Přidat oauth2Permissions vlastnosti, která obsahuje oprávnění OAuth 2.0 vystavené v přidružené aplikaci.Added the oauth2Permissions property, which contains the OAuth 2.0 permissions exposed by the associated application.Další informace najdete v článku oauth2Permisions definici vlastnosti na aplikace entity.For more information see the oauth2Permisions property definition on the Application entity.

Přidat preferredTokenSigningKeyThumbprint vlastnost.Added the preferredTokenSigningKeyThumbprint property.Vyhrazené jenom pro interní použití.Reserved for internal use only.Zápis nebo jinak spoléhají na tuto vlastnost.Do not write or otherwise rely on this property.Může v budoucích verzích odebrána.May be removed in future versions.

Přidat appRoleAssignedTo navigační vlastnost, která odkazuje na sadu aplikací, které je přiřazen objektu služby.Added the appRoleAssignedTo navigation property, which points to the set of applications that the service principal is assigned to.

Přidat appRoleAssignments navigační vlastnost, která odkazuje na sadu objekty (uživatelé, skupiny a objekty služby), které jsou přiřazeny k této instanční objekt.Added the appRoleAssignments navigation property, which points to the set of principals (users, groups, and service principals) that are assigned to this service principal.

Přidat oauth2PermissionGrants navigační vlastnost, která odkazuje na sadu uděluje zosobnění uživatele přidružené k této instanční objekt.Added the oauth2PermissionGrants navigation property, which points to the set of user impersonation grants associated with this service principal.

Odebrat oprávnění navigační vlastnostRemoved the permissions navigation property
TenantDetailTenantDetailOdebrat vlastnost tenantType.Removed the tenantType property.
uživateleUserPřidat onPremisesSecurityIdentifier vlastnosti, která obsahuje místní identifikátor zabezpečení (SID) pro uživatele, který se synchronizovaly z místní do cloudu.Added the onPremisesSecurityIdentifier property, which contains the on-premises security identifier (SID) for the user that was synchronized from on-premises to the cloud.

Přidat sipProxyAddress vlastnosti, která určuje hlasu přes IP (VOIP) relace spuštění protocol (SIP) adresy uživatele.Added the sipProxyAddress property, which specifies the voice over IP (VOIP) session initiation protocol (SIP) address for the user.

Přidat appRoleAssignments navigační vlastnost, která odkazuje na sadu aplikací (objekty služby), které je přiřazen tento uživatel.Added the appRoleAssignments navigation property, which points to the set of applications (service principals) that this user is assigned to.

Přidat oauth2PermissionGrants navigační vlastnost, která odkazuje na sadu uděluje zosobnění uživatele OAuth 2.0 přidružené k tomuto uživateli.Added the oauth2PermissionGrants navigation property, which points to the set of OAuth 2.0 user impersonation grants associated with this user.

Odebrat oprávnění navigační vlastnost.Removed the permissions navigation property.

Komplexní typ změnyComplex type changes

TypTypeZměnit popisChange Description
aplikační roleAppRoleNový typ, který určuje aplikační role, které mohou být vyžádány klientskými aplikacemi volání této aplikace nebo která může být použita k přiřazení aplikace k uživatelům nebo skupinám v jedné z rolí zadané aplikace.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.
OAuth2PermissionOAuth2PermissionNový typ, který představuje rozsah oprávnění OAuth 2.0.New type that represents an OAuth 2.0 permission scope.Zadaný obor oprávnění OAuth 2.0 mohou být vyžádány klientskými aplikacemi (prostřednictvím requiredResourceAccess kolekce) volání této prostředků aplikace.The specified OAuth 2.0 permission scope may be requested by client applications (through the requiredResourceAccess collection) calling this resource application.
RequiredResourceAccessRequiredResourceAccessNový typ, který určuje sadu obory oprávnění OAuth 2.0 a aplikace rolí v zadaný prostředek, který vyžaduje přístup k této aplikaci.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.
resourceAccessResourceAccessNový typ, který představuje oprávnění, které se tato aplikace vyžaduje.New type that represents a permission that this application requires.

Akce a funkce změnyAction and function changes

FunkceFunctionZměnit popisChange Description
getAvailableExtensionPropertiesgetAvailableExtensionPropertiesNové funkce, která vrátí úplný seznam vlastností rozšíření, které byly zaregistrovány v adresáři.New function that returns the full list of extension properties that have been registered in a directory.Vlastnosti rozšíření se dají registrovat pro následující entity: uživatele, skupiny, zařízení, TenantDetail, aplikace, a ServicePrincipal.Extension properties can be registered for the following entities: User, Group, Device, TenantDetail, Application, and ServicePrincipal.
getMemberObjectsgetMemberObjectsNové funkce, která vrátí všechny skupiny a DirectoryRole objekty, uživatele, kontaktů, skupinu nebo objekt služby je přechodně členem.New function that returns all of the Group and DirectoryRole objects that a user, contact, group, or service principal is transitively a member of.
getObjectsByObjectIdsgetObjectsByObjectIdsNové funkce, která vrátí objekty adresáře uvedené v seznamu identifikátorů objektu.New function that returns the directory objects specified in a list of object IDs.Můžete také určit, které kolekce prostředků (uživatelů, skupin atd.) mají vyhledávány zadáním volitelného typy parametr.You can also specify which resource collections (users, groups, etc.) should be searched by specifying the optional types parameter.
ObnovenírestoreNové služby akce, která umožňuje odstraněné aplikace k obnovení.New service action that allows a deleted application to be restored.

Verze 2013. 11 08 Version 2013-11-08

Tato část obsahuje seznam změn pro rozhraní Graph API verze 2013. 11 08.This section lists the changes for Graph API version 2013-11-08.

V následujících tabulkách jsou uvedeny entity, komplexní typy a funkce, které byly přidány, změnit nebo odebrat pro tuto verzi.The following tables list the entities, complex types, and functions that have been added, changed, or removed for this release.

Změny entityEntity changes

EntityEntityZměnit popisChange Description
aplikaceApplicationPřidat vlastníky navigační vlastnost, která odkazuje na sadu objektů adresáře, které jsou vlastníci aplikace.Added the owners navigation property, which points to the set of directory objects that are owners of the application.Vlastníci představují sadu uživatelů bez oprávnění správce, kteří mohou k úpravě tohoto objektu.The owners are a set of non-admin users who are allowed to modify this object.Zděděno z DirectoryObject.Inherited from DirectoryObject.
DeviceConfigurationDeviceConfigurationNová entita, která reprezentuje konfiguraci pro zařízení.New entity that represents the configuration for a device.
DirectoryObjectDirectoryObjectPřidat createdOnBehalfOf navigační vlastnost, která odkazuje na adresář objektu, který tento objekt byl vytvořen jménem.Added the createdOnBehalfOf navigation property, which points to directory object that that this object was created on behalf of.

Přidat createdObjects navigační vlastnost, která odkazuje na sadu objektů adresáře, které byly vytvořeny pomocí aktuálního objektu.Added the createdObjects navigation property, which points to the set of directory objects that were created by the current object.

Přidat vlastníky navigační vlastnost, která odkazuje na sadu objektů adresáře, které jsou vlastníky aktuálního objektu.Added the owners navigation property, which points to the set of directory objects that are owners of the current object.Vlastníci představují sadu uživatelů bez oprávnění správce, kteří mohou k úpravě tohoto objektu.The owners are a set of non-admin users who are allowed to modify this object.

Přidat ownedObjects navigační vlastnost, která odkazuje na sadu objektů adresáře, které jsou vlastněny aktuálního objektu.Added the ownedObjects navigation property, which points to the set of directory objects that are owned by the current object.

Důležité: entity, které jsou odvozeny od DirectoryObject dědit jeho vlastnosti a jeho navigační vlastnosti mohou dědit.Important: Entities that derive from DirectoryObject inherit its properties and may inherit its navigation properties.
skupinyGroupPřidat vlastníky navigační vlastnost, která odkazuje na sadu objektů adresáře, které jsou vlastníky skupiny.Added the owners navigation property, which points to the set of directory objects that are owners of the group.Vlastníci představují sadu uživatelů bez oprávnění správce, kteří mohou k úpravě tohoto objektu.The owners are a set of non-admin users who are allowed to modify this object.Zděděno z DirectoryObject.Inherited from DirectoryObject.
RoleRolePřidat ownedObjects navigační vlastnost, která odkazuje na sadu objektů adresáře, které jsou vlastněny roli.Added the ownedObjects navigation property, which points to the set of directory objects that are owned by the role.Zděděno z DirectoryObject. Role entity byla přejmenována na DirectoryRole od verze 1.5.Inherited from DirectoryObject.The Role entity was renamed to DirectoryRole beginning with version 1.5.Informace o Role, najdete v části DirectoryRole.For information about Role, see DirectoryRole.
ServicePrincipalServicePrincipalPřidat appOwnerTenantID vlastnost.Added the appOwnerTenantID property.

Přidat autheniticationPolicy vlastnost.Added the autheniticationPolicy property.Vyhrazené jenom pro interní použití.Reserved for internal use only.Nepoužívejte.Do not use.Odebrat verze 1.5.Removed in version 1.5.

Přidat createdObjects navigační vlastnost, která odkazuje na sadu objektů adresáře, které byly vytvořeny instanční objekt.Added the createdObjects navigation property, which points to the set of directory objects that were created by the service principal.Zděděno z DirectoryObject.Inherited from DirectoryObject.

Přidat vlastníky navigační vlastnost, která odkazuje na sadu objektů adresáře, které jsou vlastníky instanční objekt.Added the owners navigation property, which points to the set of directory objects that are owners of the service principal.Vlastníci představují sadu uživatelů bez oprávnění správce, kteří mohou k úpravě tohoto objektu.The owners are a set of non-admin users who are allowed to modify this object.Zděděno z DirectoryObject.Inherited from DirectoryObject.

Přidat ownedObjects navigační vlastnost, která odkazuje na sadu objektů adresáře, které jsou vlastněny instanční objekt.Added the ownedObjects navigation property, which points to the set of directory objects that are owned by the service principal.Zděděno z DirectoryObject.Inherited from DirectoryObject.
uživateleUserPřidat immutableId vlastnosti, která přidruží uživatelský účet místní služby Active Directory k jeho objektu uživatele Azure AD.Added the immutableId property, which associates an on-premises Active Directory user account to its Azure AD user object.Tato vlastnost je nutné zadat při vytváření nového uživatelského účtu v grafu, pokud používáte federovanou doménu pro uživatele userPrincipalName vlastnost (UPN).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.

Přidat userType vlastnost, která je řetězcová hodnota, kterou můžete použít ke klasifikaci typy uživatelů ve vašem adresáři, jako je například "Člen" a "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”.

Přidat createdObjects navigační vlastnost, která odkazuje na sadu objektů adresáře, které byly vytvořeny uživatelem.Added the createdObjects navigation property, which points to the set of directory objects that were created by the user.Zděděno z DirectoryObject.Inherited from DirectoryObject.

Přidat ownedObjects navigační vlastnost, která odkazuje na sadu objektů adresáře, které jsou vlastněny uživatele.Added the ownedObjects navigation property, which points to the set of directory objects that are owned by the user.Zděděno z DirectoryObject.Inherited from DirectoryObject.

Komplexní typ změnyComplex type changes

TypTypeZměnit popisChange Description
ServicePrincipalAuthenticationPolicyServicePrincipalAuthenticationPolicyVyhrazené jenom pro interní použití.Reserved for internal use only.Nepoužívejte.Do not use.Odebrat verze 1.5.Removed in version 1.5.

Akce a funkce změnyAction and function changes

FunkceFunctionZměnit popisChange Description
assignLicenseassignLicenseNové služby akce, která aktualizuje seznam licencí, které chcete přidat nebo odebrat uživatele.New service action that updates a user with a list of licenses to add and/or remove.

Verze 2013-04-05 Version 2013-04-05

Toto je základní verzi rozhraní Graph API.This is the base version of the Graph API.

Další zdroje informací Additional resources

© 2018 Microsoft