共用方式為

實體和複雜類型參考 | Graph API 參考

  • 發行項

**適用於︰**Graph API | Azure Active Directory

本主題討論 Graph API 所公開的實體和複雜類型。

Graph API 是 OData 3.0 相容的 REST API，可讓您以程式設計方式存取 Azure Active Directory 中的目錄物件，例如使用者、群組、組織連絡人和應用程式。

重要

您也可以透過 Microsoft Graph 取得 Azure AD Graph API 功能，這個統一 API 同時也包含如 Outlook、OneDrive、OneNote、Planner 和 Office Graph 等其他 Microsoft 服務 API，讓您可以使用單一的存取權杖透過單一端點存取所有 API。

實體參考

應用程式實體

代表應用程式。 將驗證工作委外給 Azure AD 的任何應用程式必須在目錄中註冊。 這涉及向 Azure AD 說明您的應用程式，包括它所在的 URL、驗證之後傳送回覆的 URL、用來識別應用程式的 URI 等。 如需詳細資訊，請參閱在 Azure AD 中註冊應用程式的基本概念。 繼承自 DirectoryObject。

屬性

宣告屬性

Name 類型 支援 說明
addIns Collection(AddIn) POST, GET, PATCH 定義取用服務可用來在特定內容中呼叫應用程式的自訂行為。 例如，可以轉譯檔案資料流的應用程式可能會為其 "FileHandler" 功能設定 addIns 屬性。 這可讓如 Office 365 等服務在使用者目前正在處理的文件內容中呼叫應用程式。

注意：需要 1.6 版。
appId 1.5 版中為 Edm.String

舊版中為 Edm.Guid		 GET ($filter) 應用程式的唯一識別碼。
appRoles Collection(AppRole) POST, GET, PATCH 應用程式可以宣告的應用程式角色的集合。 這些角色可以指派給使用者、群組或服務主體。

注意︰需要 1.5 版，不可為 Null。
availableToOtherTenants Edm.Boolean POST, GET ($filter), PATCH 若與其他租用戶共用應用程式，則為 true；否則為 false。
deletionTimestamp Edm.DateTime GET 從租用戶刪除應用程式的時間。 如果應用程式尚未刪除，就會傳回 null。 已刪除的應用程式可以從 /deletedApplications 資源集合讀取。 繼承自 DirectoryObject。

注意：需要 1.5 版或更新版本。
displayName Edm.String POST (必要), GET, PATCH 應用程式的顯示名稱。
errorUrl Edm.String POST, GET, PATCH
groupMembershipClaims Edm.String POST, GET, PATCH 位元遮罩，用來設定應用程式預期的使用者或 OAuth 2.0 存取權杖中發出的「群組」宣告。 位元遮罩值如下︰0︰無；1︰安全性群組和 Azure AD 角色；2︰已保留；4︰已保留。 將位元遮罩設為 7 可取得登入之使用者所屬的所有安全性群組、通訊群組和 Azure AD 目錄角色。

注意：需要 1.5 版。
首頁 Edm.String POST, GET, PATCH 應用程式首頁的 URL。
identifierUris Collection(Edm.String) POST, GET ($filter), PATCH 識別應用程式的 URI。 如需詳細資訊，請參閱應用程式物件和服務主體物件。

注意︰不可為 Null，多重值屬性的篩選條件運算式需要 any 運算子；如需詳細資訊，請參閱Supported Queries, Filters, and Paging Options。
keyCredentials Collection(KeyCredential) POST, GET, PATCH 與應用程式相關聯的金鑰認證集合

注意：不可為 Null
knownClientApplications Collection(Edm.Guid) POST, GET, PATCH 繫結至這個資源應用程式的用戶端應用程式。 同意任何已知的用戶端應用程式會導致透過結合的同意對話方塊 (顯示用戶端和資源所需的 OAuth 權限範圍)，隱含地同意資源應用程式。

注意︰需要 1.5 版，不可為 Null。
logoutUrl Edm.String POST, GET, PATCH
mainLogo Edm.Stream POST, GET, PATCH 應用程式的主要標誌。

注意：不可為 Null
oauth2AllowImplicitFlow Edm.Boolean POST, GET, PATCH 指定此 Web 應用程式是否可以要求 OAuth2.0 隱含流程權杖。 預設值為 false。

注意︰需要 1.5 版，不可為 Null。
oauth2AllowUrlPathMatching Edm.Boolean POST, GET, PATCH 在 OAuth 2.0 權杖要求中，指定 Azure AD 是否允許根據應用程式的 replyUrls 來比對重新導向 URI 的路徑。 預設值為 false。

注意︰需要 1.5 版，不可為 Null。
oauth2Permissions Collection(OAuth2Permission) POST, GET, PATCH Web API (資源) 應用程式公開給用戶端應用程式的 OAuth 2.0 權限範圍的集合。 這些權限範圍可以在同意期間授與用戶端應用程式。

注意︰需要 1.5 版，不可為 Null。
oauth2RequiredPostResponse Edm.Guid POST, GET, PATCH 在 OAuth 2.0 權杖要求中，指定 Azure AD 是否允許 POST 要求，而不是 GET 要求。 預設值是 false，指定只允許 GET 要求。

注意︰需要 1.5 版，不可為 Null。
objectId Edm.Guid GET 應用程式的唯一識別碼。 繼承自 DirectoryObject。

注意：索引鍵、不可變、不可為 Null、唯一
objectType Edm.String GET 識別此物件類型的字串。 對於應用程式，這個值一律是 "Application"。 繼承自 DirectoryObject。
passwordCredentials Collection(PasswordCredential) POST, GET, PATCH 與應用程式相關聯的密碼認證集合。

注意：不可為 Null
publicClient Edm.Boolean POST、GET 指定此應用程式是否為公用的用戶端 (例如行動裝置上執行的已安裝應用程式)。 預設值為 false。
recordConsentConditions Edm.String GET 請勿使用。 可能會在未來版本中移除

注意：需要 1.6 版。
replyUrls Collection(Edm.String) POST, GET, PATCH 指定使用者權杖傳送到以登入的 URL，或 OAuth 2.0 授權碼和存取權杖傳送到的重新導向 URI。

注意：不可為 Null
requiredResourceAccess Collection(RequiredResourceAccess) POST, GET, PATCH 指定此應用程式需要存取的資源，以及它在每個資源下所需的一組 OAuth 權限範圍和應用程式角色。 這樣預先設定必要的資源存取權可決定同意體驗。

注意︰需要 1.5 版，不可為 Null。
samlMetadataUrl Edm.String POST, GET, PATCH 應用程式 SAML 中繼資料的 URL。

導覽屬性

Name 收件者 多重性
(來源/目的地)		 說明
extensionProperties ExtensionProperty */* 與應用程式相關聯的延伸模組屬性。 需要 1.5 或更新版本。
owners DirectoryObject */* 代表應用程式擁有者的目錄物件。 擁有者是一組允許修改此物件的非系統管理員使用者。 需要 2013-11-08 版本或更新版本。 繼承自 DirectoryObject。
serviceEndpoints serviceEndpoint 1/* 適用於探索的服務端點。 如需詳細資訊，請參閱 ServiceEndpoint 主題。 HTTP 方法︰POST、GET 和 DELETE。 需要 1.6 版或更新版本。

注意︰不支援未列出的繼承導覽屬性。 傳送到不支援之導覽屬性的要求會傳回「400 不正確的要求」****。

支援的作業

下列為應用程式支援的作業 (HTTP 方法位於括弧內)：

  • 建立 (POST)
  • 讀取 (READ)
  • 更新 (PATCH)
  • 刪除 (DELETE)

應用程式導覽屬性支援下列作業。 並非每個導覽屬性都支援所有作業。

  • 讀取 (READ)
  • 更新 (POST)
  • 刪除 (DELETE)

應用程式上可呼叫下列動作。

  • restore 可還原已刪除的應用程式。 需要 1.5 版或更新版本。

AppRoleAssignment 實體

當使用者或群組指派給應用程式時用來記錄。 在此情況下，角色指派會導致使用者的應用程式存取面板上顯示應用程式磚。 此實體也可用來授權另一個應用程式 (模擬成服務主體) 以特定的角色存取資源應用程式。 您可以建立、讀取、更新和刪除角色指派。 繼承自 DirectoryObject。

重要：在 1.5 版中引進。

屬性

宣告屬性

Name 類型 支援 說明
creationTimestamp Edm.DateTime GET 建立授權的時間。
deletionTimestamp Edm.DateTime GET 此屬性對應用程式角色指派而言無效，一律會傳回 null。 繼承自 DirectoryObject。

注意：需要 1.5 版或更新版本。
id Edm.Guid POST (必要), GET, PATCH 指派給主體的角色識別碼。 這個角色必須由目標資源應用程式 resourceId 在其 appRoles 屬性中宣告。 當資源未宣告任何權限時，就必須指定預設識別碼 (零 GUID)。

注意：不可為 Null。
principalDisplayName Edm.String GET 已獲授與存取權之主體的顯示名稱。
objectId Edm.String GET 應用程式角色指派的唯一識別碼。 繼承自 DirectoryObject。

注意：索引鍵、不可變、不可為 Null、唯一。
objectType Edm.String GET 識別此物件類型的字串。 對於應用程式角色指派，這個值一律是 "AppRoleAssignment"。 繼承自 DirectoryObject。
principalId Edm.Guid POST (必要), GET, PATCH 要授與存取權之主體的唯一識別碼 (objectId)。

注意：必要。
principalType Edm.String GET 主體的類型。 這可以是 "User"、"Group" 或 "ServicePrincipal"。
resourceDisplayName Edm.String GET 已獲指派之資源的顯示名稱。
resourceId Edm.Guid POST (必要), GET, PATCH 已獲指派之目標資源 (服務主體) 的唯一識別碼 (objectId)。

導覽屬性
無。

注意︰不支援未列出的繼承導覽屬性。 傳送到不支援之導覽屬性的要求會傳回「400 不正確的要求」****。

Contact 實體

代表組織連絡人。 繼承自 DirectoryObject。

組織連絡人代表不在您公司目錄中的使用者。 他們是擁有郵件功能的實體，且通常代表公司或組織外部的個人。 您無法使用 Azure AD 驗證組織連絡人，也無法對其指派授權。

您可以透過使用 Azure AD Connect 與內部部署目錄同步處理，在您的租用戶中建立組織連絡人，或是透過 Exchange Online 管理入口網站或 Exchange Online PowerShell Cmdlet 來建立。 如需 Azure AD Connect 的詳細資訊，請參閱整合內部部署身分識別與 Azure Active Directory。 如需 Exchange Online 管理工具的詳細資訊，請參閱 Exchange Online 的安裝和管理。

您無法使用 Graph API 來建立組織連絡人。 不過，您可以更新及刪除目前不是從內部部署目錄同步處理的連絡人；也就是 dirSyncEnabled 屬性是 null 或 false 的連絡人。 您無法更新或刪除 dirSyncEnabled 屬性是 true 的連絡人。

注意︰組織連絡人是代表外部使用者的目錄實體。 它們不應該與 O365 Outlook 個人連絡人混淆。

屬性

宣告屬性

Name 類型 支援 說明
城市 Edm.String GET ($filter), PATCH 連絡人所在的縣市。
國家/地區 Edm.String GET ($filter), PATCH 連絡人所在的國家/地區。
deletionTimestamp Edm.DateTime GET 此屬性對連絡人而言無效，一律會傳回 null。 繼承自 DirectoryObject。

注意：需要 1.5 版或更新版本。
department Edm.String GET ($filter), PATCH 連絡人工作的部門名稱。
dirSyncEnabled Edm.Boolean GET ($filter) 若此物件從內部部署目錄同步處理，則為 true；若此物件原本從內部部署目錄同步處理但已不再同步處理，則為 false；如果此物件從未自內部部署目錄同步處理 (預設值)，則為 null。
displayName Edm.String GET ($filter), PATCH 連絡人的顯示名稱。
facsimileTelephoneNumber Edm.String GET, PATCH 連絡人的商務傳真機電話號碼。
givenName Edm.String GET ($filter), PATCH 連絡人的名字。
jobTitle Edm.String GET ($filter), PATCH 連絡人的職稱。
lastDirSyncTime Edm.DateTime GET ($filter) 指出此物件上次與內部部署目錄進行同步處理的時間。
mail Edm.String GET ($filter) 連絡人的 SMTP 位址，例如 "jeff@contoso.onmicrosoft.com"。
mailNickname Edm.String GET ($filter), PATCH 連絡人的郵件別名。
行動 Edm.String GET, PATCH 連絡人的主要行動電話號碼。
objectId Edm.String GET 連絡人的唯一識別碼。 繼承自 DirectoryObject。

注意：索引鍵、不可變、不可為 Null、唯一。
objectType Edm.String GET 識別此物件類型的字串。 對於連絡人，這個值一律是 "Contact"。 繼承自 DirectoryObject。
physicalDeliveryOfficeName Edm.String GET, PATCH 連絡人工作地點的辦公室位置。
postalCode Edm.String GET, PATCH 連絡人郵寄地址的郵遞區號。 郵遞區號會依連絡人的國家/地區而定。 在美國，此屬性包含了郵遞區號 (ZIP Code)。
provisioningErrors Collection(ProvisioningError) GET, PATCH 導致無法成功佈建這名連絡人的錯誤詳細資料的集合。

注意：不可為 Null
proxyAddresses Collection(Edm.String) GET ($filter) 注意︰唯一、不可為 Null，多重值屬性的篩選條件運算式需要 any 運算子；如需詳細資訊，請參閱Supported Queries, Filters, and Paging Options。
sipProxyAddress Edm.String GET 指定連絡人的 voice over IP (VOIP) 工作階段初始通訊協定 (SIP) 位址。

注意：需要 1.5 版或更新版本。
狀態 Edm.String GET ($filter), PATCH 連絡人地址所屬的州/省。
streetAddress Edm.String GET, PATCH 連絡人工作地點的街道地址。
surname Edm.String GET ($filter), PATCH 連絡人的姓氏。
telephoneNumber Edm.String GET, PATCH 連絡人工作地點的主要電話號碼。
thumbnailPhoto Edm.Stream GET, PATCH 連絡人的相片縮圖顯示。

注意：不可為 Null

導覽屬性

| Name | 收件者 | 多重性
(來源/目的地) | 說明 | |:-----|:---|:----------------------------|:------------| | manager | DirectoryObject

(僅支援 User 和 Contact 物件。) | /0..1 | 擔任這名連絡人管理員的使用者或連絡人。 繼承自 DirectoryObject。

HTTP 方法：GET、PUT、DELETE | | directReports | DirectoryObject

(僅支援 User 和 Contact 物件。) | */* | 這名連絡人的直屬員工。 (使用者及連絡人的 manager 屬性設定為這名連絡人。)繼承自 DirectoryObject。

HTTP 方法：GET | | memberOf | DirectoryObject

(僅支援 Group 物件。) | */* | 這名連絡人隸屬為其成員的群組。 繼承自 DirectoryObject。

HTTP 方法：GET | 注意︰不支援未列出的繼承導覽屬性。 傳送到不支援之導覽屬性的要求會傳回「400 不正確的要求」***。

支援的作業

下列為連絡人支援的作業 (各項作業所使用的 HTTP 方法位於括號內)：

  • 讀取 (GET)
  • 更新 (PATCH)：僅適用於未從內部部署目錄同步處理的連絡人 (dirSyncEnabled 是 null 或 false)。
  • 刪除 (DELETE)

連絡人導覽屬性支援下列作業，並非每個導覽屬性都支援所有作業。

  • 讀取 (GET)
  • 更新 (PUT)：僅適用於未從內部部署目錄同步處理之連絡人 (dirSyncEnabled 是 null 或 false) 的 manager 屬性。
  • 刪除 (DELETE)：僅適用於未從內部部署目錄同步處理之連絡人 (dirSyncEnabled 是 null 或 false) 的 manager 屬性。

在連絡人上可以呼叫下列動作和函數：

  • checkMemberGroups 可檢查連絡人在群組清單中的成員資格。 此檢查可移轉。
  • getMemberGroups 可傳回連絡人隸屬的群組清單。 此檢查可移轉。
  • isMemberOf 可檢查連絡人是否為指定群組的成員。 此檢查可移轉。

備註

連絡人是擁有郵件功能的實體，無法使用 Graph API 加以建立。 可更新，但僅限於 dirSyncEnabled 屬性設為 null 或 false 的連絡人才支援更新。 可刪除連絡人。

Contract 實體

只存在於合作夥伴租用戶中。 合作夥伴租用戶是屬於 Microsoft 合作夥伴的 Azure AD 租用戶，這些 Microsoft 合作夥伴可以是 Office 365 同步發佈、Microsoft 雲端解決方案提供者或 Microsoft Advisor 夥伴計劃的一部分。 代表合作夥伴租用戶與客戶租用戶的現有合作關係。 唯讀。 繼承自 DirectoryObject。

重要：在 1.5 版中引進。

屬性

宣告屬性

Name 類型 支援 說明
contractType Edm.String GET 合約類型。 可能的值為：
  • "SyndicationPartner"，指出獨家轉售 O365 和 Intune 給此客戶並為其管理的合作夥伴。 他們可以轉售給其客戶並提供支援。
  • "BreadthPartner"，指出可為此客戶提供系統管理支援的合作夥伴。 不過，此合作夥伴不可以轉售給客戶。
  • "ResellerPartner"，指出類似於同步發佈合作夥伴，但沒有租用戶獨佔存取權的合作夥伴。 在同步發佈的情況下，客戶無法向 Microsoft 或其他合作夥伴購買額外的 Direct 訂閱。
customerContextId Edm.Guid GET ($filter) 此合作關係所參考之客戶租用戶的唯一識別碼。 對應至客戶租用戶之 TenantDetail 物件的 objectId 屬性。
defaultDomainName Edm.String GET ($filter) 客戶租用戶之預設網域名稱的複本。 與客戶建立合作關係時，會建立此複本。 它不會在客戶租用戶的預設網域名稱變更時自動更新。
deletionTimestamp Edm.DateTime GET 此屬性對合約而言無效，一律會傳回 null。 繼承自 DirectoryObject。

注意：需要 1.5 版或更新版本。
displayName Edm.String GET ($filter) 客戶租用戶之顯示名稱的複本。 與客戶建立合作關係時，會建立此複本。 它不會在客戶租用戶的顯示名稱變更時自動更新。
objectType Edm.String GET 識別此物件類型的字串。 這個值一律是 “Contract”。 繼承自 DirectoryObject。
objectId Edm.String GET 合作關係的唯一識別碼。 繼承自 DirectoryObject。

注意：索引鍵、不可變、不可為 Null、唯一。

導覽屬性
無。

注意︰不支援未列出的繼承導覽屬性。 傳送到不支援之導覽屬性的要求會傳回「400 不正確的要求」****。

支援的作業

下列為合約支援的作業 (各項作業所使用的 HTTP 方法位於括弧內)：

  • 讀取 (GET)

裝置實體

代表目錄中註冊的裝置。 繼承自 DirectoryObject。

屬性

宣告屬性

Name 類型 支援 說明
accountEnabled Edm.Boolean POST (必要), GET ($filter), PATCH
alternativeSecurityIds Collection(AlternativeSecurityId) POST (必要), GET ($filter), PATCH 注意︰不可為 Null，多重值屬性的篩選條件運算式需要 any 運算子；如需詳細資訊，請參閱Supported Queries, Filters, and Paging Options。
approximateLastLogonTimeStamp Edm.DateTime POST, GET, PATCH
deletionTimestamp Edm.DateTime GET 此屬性對裝置而言無效，一律會傳回 null。 繼承自 DirectoryObject。

注意：需要 1.5 版或更新版本。
deviceId Edm.Guid POST (必要), GET ($filter), PATCH
deviceObjectVersion Edm.Int32 POST, GET, PATCH
deviceOSType Edm.String POST (必要), GET, PATCH 裝置上的作業系統類型。
deviceOSVersion Edm.String POST (必要), GET, PATCH 裝置上的作業系統版本
devicePhysicalIds Collection(Edm.String) POST, GET ($filter), PATCH 注意：不可為 Null
dirSyncEnabled Edm.Boolean GET ($filter) 若此物件從內部部署目錄同步處理，則為 true；若此物件原本從內部部署目錄同步處理但已不再同步處理，則為 false；如果此物件從未自內部部署目錄同步處理 (預設值)，則為 null。
displayName Edm.String POST (必要), GET ($filter), PATCH 裝置的顯示名稱。
isCompliant Edm.Boolean POST, GET, PATCH 若裝置符合行動裝置管理 (MDM) 原則，則為 true；否則為 false。
IsManaged Edm.Boolean POST, GET, PATCH 若裝置是由行動裝置管理 (MDM) 應用程式 (例如 Intune) 管理，則為 true；否則為 false。
lastDirSyncTime Edm.DateTime GET ($filter) 此物件上次與內部部署目錄進行同步處理的時間。
objectId Edm.String GET 裝置的唯一識別碼。 繼承自 DirectoryObject。

注意：索引鍵、不可變、不可為 Null、唯一
objectType Edm.String GET 識別此物件類型的字串。 對於裝置，這個值一律是 "Device"。 繼承自 DirectoryObject

導覽屬性

Name 收件者 多重性
(來源/目的地)		 說明
registeredOwners [使用者] */* 身為裝置之註冊擁有者的使用者。
registeredUsers [使用者] */* 身為裝置之註冊使用者的使用者。

注意︰不支援未列出的繼承導覽屬性。 傳送到不支援之導覽屬性的要求會傳回「400 不正確的要求」****。

支援的作業

下列為裝置支援的作業 (HTTP 方法位於括弧內)：

  • 建立 (CREATE)
  • 讀取 (READ)
  • 更新 (PATCH)
  • 刪除 (DELETE)

裝置導覽屬性支援下列作業。 並非每個導覽屬性都支援所有作業。

  • 讀取 (READ)
  • 更新 (PUT)
  • 刪除 (DELETE)

裝置不支援函數或動作。

DirectoryLinkChange 實體

在差異查詢的結果集中傳回 DirectoryLinkChange 物件，指出以連結表示的連絡人、使用者或群組的屬性在上次差異查詢後已變更。 DirectoryLinkChange 物件將代表使用者或連絡人 manager 屬性的變更，或群組 members 屬性的變更。 如需差異查詢的詳細資訊，請參閱Differential Query。 繼承自 DirectoryObject。

屬性

宣告屬性

Name 類型 支援 說明
associationType Edm.String GET 識別套用變更的關聯類型的字串。 值可以是 "Member" 或 "Manager"。
deletionTimestamp Edm.DateTime GET 此屬性對目錄連結變更物件而言無效，一律會傳回 null。 繼承自 DirectoryObject。

注意：需要 1.5 版或更新版本。
objectId Edm.String GET 目錄連結變更物件的唯一識別碼。 對於 DirectoryLinkChange 物件，這個值一律是 00000000-0000-0000-0000-000000000000。 繼承自 DirectoryObject。

注意：索引鍵、不可變、不可為 Null、唯一
objectType Edm.String GET 識別此物件類型的字串。 對於 DirectoryLinkChange 物件，這個值一律是 "DirectoryLinkChange"。 DirectoryObject
sourceObjectId Edm.String GET 來源物件的物件識別碼，例如 "7373b0af-d462-406e-ad26-f2bc96d823d8"。
sourceObjectType Edm.String GET 識別來源物件類型的字串；這可以是下列其中一項："Group"、"User" 或 "Contact"。
sourceObjectUri Edm.String GET 來源物件的 URI，例如 "https://graph.windows.net/contoso.com/groups/7373b0af-d462-406e-ad26-f2bc96d823d8"。
targetObjectId Edm.String GET 目標物件的物件識別碼，例如 "dca803ab-bf26-4753-bf20-e1c56a9c34e2"。
targetObjectType Edm.String GET 識別來源物件類型的字串；這可以是下列其中一項："Group"、"User" 或 "Contact"。
targetObjectUri Edm.String GET 目標物件的 URI，例如 "https://graph.windows.net/contoso.com/users/dca803ab-bf26-4753-bf20-e1c56a9c34e2"。

導覽屬性
無。

注意︰不支援未列出的繼承導覽屬性。 傳送到不支援之導覽屬性的要求會傳回「400 不正確的要求」****。

DirectoryObject 實體

代表 Azure Active Directory 物件。 DirectoryObject 類型是其他大多數目錄實體類型的基底類型。

屬性

宣告屬性

| Name | 類型 | 支援 | 說明 | |:----|:----|:----------|:----------| | deletionTimestamp | Edm.DateTime | GET | 刪除目錄物件的時間。 僅適用於可還原的目錄物件。 目前僅支援已刪除的 Application 物件，對於其他所有實體，此屬性會傳回 null。

注意：需要 1.5 版或更新版本。 | | objectId | Edm.String | GET | Guid 為物件的唯一識別碼，例如 12345678-9abc-def0-1234-56789abcde。

注意：索引鍵、不可變、不可為 Null、唯一。 | | objectType | Edm.String | GET | 識別此物件類型的字串。 例如，對於群組，這個值一律是 "Group"。 | 導覽屬性

Name 收件者 多重性
(來源/目的地)		 說明
createdObjects DirectoryObject */* 目前物件所建立的目錄物件。 唯讀。 需要 2013-11-08 版本或更新版本。
createdOnBehalfOf DirectoryObject */0..1 建立此物件所要代表的目錄物件。 唯讀。 需要 2013-11-08 版本或更新版本。
manager DirectoryObject */0..1 這個物件的管理員。 在使用者與連絡人中有效。 傳回使用者或連絡人。
directReports DirectoryObject */* 負責向此物件報告的使用者及連絡人。 在使用者與連絡人中有效。 傳回使用者和連絡人。 唯讀。
members DirectoryObject */* 這些物件為此物件的成員。 在群組和角色中有效。 在群組中，傳回連絡人、使用者及群組。 在角色中，傳回使用者和服務主體。
memberOf DirectoryObject */* 此物件為成員之一的眾多物件。 在連絡人、群組、服務主體和使用者中有效。 在連絡人中，傳回群組。 在群組中，傳回群組。 在使用者中，傳回群組及角色。 在服務主體中，傳回角色。 唯讀。

不轉移屬性。 例如，如果使用者 A 是群組 B 的成員，而群組 B 是群組 C 的成員，則使用者 A 中的 memberOf 屬性不會傳回群組 C。
ownedObjects DirectoryObject */* 目前物件所擁有的目錄物件。 唯讀。 需要 2013-11-08 版本或更新版本。
owners DirectoryObject */* 做為目前物件之擁有者的目錄物件。 擁有者是一組允許修改此物件的非系統管理員使用者。 需要 2013-11-08 版本或更新版本。

注意：在繼承自 DirectoryObject 的實體類型上，並非所有導覽屬性都一定有效。 如果傳送對特定實體無效之屬性的要求，會傳回「400 不正確的要求」****回應。 如需哪些導覽屬性在特定實體中有效的相關資訊，請參閱該實體類型的文件集。

支援的作業

目錄物件中支援的完整作業集如下 (各項作業所使用的 HTTP 方法位於括號內)：建立 (POST)、讀取 (GET)、更新 (PATCH) 和刪除 (DELETE)。 然而，並非每個實體類型都支援所有作業。 目錄物件的宣告屬性是唯讀的，不能在建立或更新作業中指定。

每個導覽屬性可能支援的一組作業如下：

  • createdObjects：讀取 (GET)。
  • createdOnBehalfOf：讀取 (GET)。
  • manager：讀取 (GET)、更新 (PUT) 和刪除 (DELETE)。
  • directReports：讀取 (GET)。
  • members：讀取 (GET)、更新 (POST) 和刪除 (DELETE)。
  • memberOf：讀取 (GET)。
  • ownedObjects：讀取 (GET)。
  • owners：讀取 (GET)、更新 (POST) 和刪除 (DELETE)。

並非每個實體類型都必定支援所有導覽屬性，每個實體類型也不一定都支援導覽屬性的潛在作業集。

特定目錄物件是否支援特定動作或函數，取決於目錄物件的類型 (objectType 屬性)。 如需哪些物件類型支援哪些函數或動作的相關資訊，請參閱特定物件 (例如使用者、群組等) 或特定函數的文件。

如需實體支援之作業的資訊，請參閱特定實體類型的文件。

DirectoryRole 實體

代表 Azure AD 目錄角色。 Azure AD 目錄角色也稱為「系統管理員角色」** (administrator role)。 如需目錄 (系統管理員) 角色的詳細資訊，請參閱在 Azure Active Directory (Azure AD) 中指派系統管理員角色。

Graph API 可讓您將使用者和服務主體指派給目錄角色，以授與目標角色的權限給他們。 您可以讀取目錄角色物件並更新目錄角色的 members 導覽屬性，但無法刪除目錄角色或更新其宣告的屬性。 繼承自 DirectoryObject。

若要讀取目錄角色或更新其成員，必須先在租用戶中啟用目錄角色。 在 1.5 之前的版本中，預設已啟用所有目錄角色。 自 1.5 版起，預設只會啟用公司系統管理員目錄角色。 若要啟用其他可用的目錄角色，您可以傳送 POST 要求，其中包含目錄角色所依據之 DirectoryRoleTemplate 的 objectId。 如需詳細資訊，請參閱支援的作業和備註。

重要：自 1.5 版起，Role 實體類型已重新命名為 DirectoryRole。

屬性

宣告屬性

Name 類型 支援 說明
deletionTimestamp Edm.DateTime GET 此屬性對目錄角色而言無效，一律會傳回 null。 繼承自 DirectoryObject。

注意：需要 1.5 版或更新版本。
描述 Edm.String GET 目錄角色的描述。
displayName Edm.String GET 目錄角色的顯示名稱。
isSystem Edm.Boolean GET 若角色為系統角色，則為 true；否則為 false。
objectId Edm.String GET 目錄角色的唯一識別碼。 繼承自 DirectoryObject。

注意：索引鍵、不可變、不可為 Null、唯一。
objectType Edm.String GET 識別此物件類型的字串。 對於目錄角色，這個值一律是 "DirectoryRole"。 繼承自 DirectoryObject。

注意：在 1.5 之前的版本中，此值會是 "Role"。
roleDisabled Edm.Boolean GET 若已停用目錄角色，則為 true；否則為 false。
roleTemplateId 字串 POST (必要), GET 此角色所根據之 DirectoryRoleTemplate 的 objectId。

注意︰在 1.5 版之前的版本中，此屬性是唯讀的。 在 1.5 版及更新版本中，此屬性必須在使用 POST 作業啟用租用戶中的目錄角色時指定。 啟用目錄角色之後，此屬性會變成唯讀。

導覽屬性

名稱 目標 多重性
(來源/目的地)		 描述
members DirectoryObject

(支援 User 和 ServicePrincipal。)		 / 屬於此目錄角色之成員的使用者及服務主體。 繼承自 DirectoryObject。

HTTP 方法：GET、POST、DELETE

注意︰不支援未列出的繼承導覽屬性。 傳送到不支援之導覽屬性的要求會傳回「400 不正確的要求」****。

支援的作業

下列為目錄角色支援的作業 (各項作業所使用的 HTTP 方法位於括弧內)：

  • 建立 (POST)：1.5 版及更新版本支援此做法。 使用要求中 roleTemplateId 屬性所指定的 DirectoryRoleTemplate，來啟用租用戶中的目錄角色。 啟用目錄角色之後，您可以對角色加入及刪除使用者和服務主體。
  • 讀取 (GET)

下列為目錄角色導覽屬性支援的作業：

  • 讀取 (GET)
  • 更新 (POST)
  • 刪除 (DELETE)

在目錄角色上無法呼叫任何函數或動作；不過，您可以在 User 或 ServicePrincipal 上呼叫 getMemberObjects 來判斷其目錄角色成員資格。 請注意，若是使用者，此函數也會傳回其直接和可轉移的群組成員資格。

備註

  • 在 1.5 版及更新版本中，預設只會啟用 (並顯示) 租用戶中的公司系統管理員角色。 使用建立 (POST) 作業可啟用其他目錄角色。 此作業指定要求中的 roleTemplateId 屬性。 此屬性包含 DirectoryRoleTemplate 執行個體的 objectId，該執行個體會對應至您要啟用的角色。 啟用目錄角色之後，您可以使用 Graph API 對其加入及刪除使用者和服務主體。 在 1.5 之前的版本中，預設會啟用所有目錄角色 (以 Role 實體表示)，且不支援建立 (POST) 作業。
  • 無法使用 Graph API 刪除目錄角色。 只有 members 導覽屬性上才支援更新。 此屬性上支援加入和移除。
  • 查詢篩選器運算式不支援目錄角色。

DirectoryRoleTemplate 實體

代表目錄角色範本。 目錄角色範本指定目錄角色 (DirectoryRole) 的屬性值。 每個可能在租用戶中啟用的目錄角色都有相關聯的目錄角色範本物件。 繼承自 DirectoryObject。

若要讀取目錄角色或更新其成員，必須先在租用戶中啟用目錄角色。 在 1.5 之前的版本中，預設已啟用所有目錄角色。 自 1.5 版起，預設只會啟用公司系統管理員目錄角色。 若要啟用其他可用的目錄角色，您可以將 POST 要求傳送到 /directoryRoles 端點，其中包含目錄角色所依據之目錄角色範本的 objectId (在要求的 roleTemplateId 參數中指定)。 如需詳細資訊，請參閱 DirectoryRole。

注意︰目錄角色範本會公開給 Users 目錄角色。 Users 目錄角色是隱含的，目錄用戶端看不到這個角色。 基礎結構會將租用戶中的每個 User 指派給此角色。 此角色已經啟用。 請勿使用此範本。

重要：在 1.5 版中引進。

屬性

宣告屬性

Name 類型 支援 說明
描述 Edm.String GET 為目錄角色設定的描述。
deletionTimestamp Edm.DateTime GET 此屬性對目錄角色範本而言無效，一律會傳回 null。 繼承自 DirectoryObject。

注意：需要 1.5 版或更新版本。
displayName Edm.String GET 為目錄角色設定的顯示名稱。
objectId Edm.String GET 範本的唯一識別碼。 繼承自 DirectoryObject。 在 1.5 版及更新版本中，您可以指定目錄角色範本的 objectId，讓 POST 要求中的 roleTemplateId 屬性啟用租用戶中的 DirectoryRole。

注意：索引鍵、不可變、不可為 Null、唯一。
objectType Edm.String GET 識別此物件類型的字串。 對於角色範本，這個值一律是 "RoleTemplate"。 繼承自 DirectoryObject。

導覽屬性
無。

注意︰不支援未列出的繼承導覽屬性。 傳送到不支援之導覽屬性的要求會傳回「400 不正確的要求」****。

支援的作業

下列為目錄角色範本支援的作業 (HTTP 方法位於括　內)：

  • 讀取 (GET)

Domain 實體 (預覽)

代表與租用戶相關聯的網域。

重要︰只在搶鮮版 (Beta) 中可用。

屬性

宣告屬性

Name 類型 支援 說明
authenticationType Edm.String GET 指出網域的驗證類型設定。 值可以是 "Managed" 或 "Federated"。
availabilityStatus Edm.String GET 除非使用 verify 動作，否則此屬性一律為 null。 使用 verify 動作時，會在回應中傳回 Domain 實體。 回應中 Domain 實體的 availabilityStatus 屬性是 "AvailableImmediately" 或 "EmailVerifiedDomainTakeoverScheduled"。
isAdminManaged Edm.Boolean GET 若網域的 DNS 記錄管理已委派給 Office 365，則為 false； 否則為 true。

注意：不可為 Null
isDefault Edm.Boolean GET, PATCH 指出這是否為建立使用者所使用的預設網域。 一家公司只有一個預設網域。

注意：不可為 Null
isInitial Edm.Boolean GET 指出這是否為 Microsoft Online Services 所建立的初始網域 (companyname.onmicrosoft.com)。 一家公司只有一個初始網域。

注意：不可為 Null
isRoot Edm.Boolean GET 對於子網域，這代表根網域。 只需要驗證根網域，而且會自動驗證所有子網域。

注意：不可為 Null
isVerified Edm.Boolean GET 指出這個網域是否已完成驗證網域擁有權。

注意：不可為 Null
名稱 Edm.String POST (必要), GET ($filter) 網域的完整名稱。

注意：索引鍵、不可變、不可為 Null、唯一
supportedServices Collection(Edm.String) GET, PATCH 指派給網域的功能。 可包含下列一或多個值，或不包含任何值：
  • "Email"
  • "Sharepoint"
  • "EmailInternalRelayOnly"
  • "OfficeCommunicationsOnline"
  • "SharePointDefaultDomain"
  • "FullRedelegation"
  • "SharePointPublic"
  • "OrgIdAuthentication"
  • "Yammer"
  • "Intune"


上述大部分的值都是唯讀的。 您可以使用 Graph API 加入/移除的值包括︰
  • "Email"
  • "OfficeCommunicationsOnline"
  • "Yammer"


注意：不可為 Null

導覽屬性

Name 收件者 多重性
(來源/目的地)		 說明
serviceConfigurationRecords DomainDnsRecord */* 客戶必須加入網域之 DNS 區域檔案中的 DNS 記錄，在這之後，才能讓 Microsoft Online Services 使用網域。
verificationDnsRecords DomainDnsRecord */* 客戶必須加入網域之 DNS 區域檔案中的 DNS 記錄，在這之後，客戶才能向 Azure AD 完成驗證網域擁有權。

 

DomainDnsRecord 實體 (預覽)

針對租用戶中的每個網域，您可能必須將 DNS 記錄加入網域的 DNS 區域檔案中，在這之後，才能讓 Microsoft Online Services 使用網域。 DomainDnsRecord 實體可用來呈現這類 DNS 記錄。 DomainDnsCnameRecord、DomainDnsMxRecord、DomainDnsSrvRecord 和 DomainDnsSrvRecord 實體的基底實體。

重要︰只在搶鮮版 (Beta) 中可用。

屬性

宣告屬性

Name 類型 支援 說明
dnsRecordId Edm.Guid GET 指派給此實體的唯一識別碼。

注意：不可為 Null
isOptional Edm.Boolean GET 指出是否必須由客戶在 DNS 主機上設定此記錄，Microsoft Online Services 才能正常使用網域。

注意：不可為 Null
label Edm.String GET 指出在 DNS 主機上設定 DNS 記錄的名稱時所要使用的值。
recordType Edm.String GET 指出此實體所代表的 DNS 記錄類型。 這個值可以是下列其中一個值：
  • "CName"
  • "Mx"
  • "Srv"
  • "Txt"


注意：索引鍵
supportedService Edm.String GET 指出哪些 Microsoft Online Services 或功能會相依於此 DNS 記錄。 可以是下列其中一個值：
  • null
  • "Email"
  • "Sharepoint"
  • "EmailInternalRelayOnly"
  • "OfficeCommunicationsOnline"
  • "SharePointDefaultDomain"
  • "FullRedelegation"
  • "SharePointPublic"
  • "OrgIdAuthentication"
  • "Yammer"
  • "Intune"
ttl Edm.Int32 GET 指出在 DNS 主機上設定 DNS 記錄的 Time-To-Live (ttl) 屬性時所要使用的值。

注意：不可為 Null

 

DomainDnsCnameRecord 實體 (預覽)

代表需要加入租用戶中特定網域之 DNS 區域檔案中的 CNAME 記錄。 繼承自 DomainDnsRecord 實體。

重要︰只在搶鮮版 (Beta) 中可用。

屬性

宣告屬性

Name 類型 支援 說明
canonicalName Edm.String GET 指出在 DNS 主機上設定 CNAME 記錄的正式名稱時所要使用的值。
dnsRecordId Edm.Guid GET 指派給此實體的唯一識別碼。

注意：不可為 Null
isOptional Edm.Boolean GET 指出是否必須由客戶在 DNS 主機上設定此 CNAME 記錄，Microsoft Online Services 才能正常使用網域。

注意：不可為 Null
label Edm.String GET 指出在 DNS 主機上設定 CNAME 記錄的名稱時所要使用的值。
recordType Edm.String GET 指出此實體所代表的 DNS 記錄類型。 這個值一律是 "CName"。

注意：索引鍵
supportedService Edm.String GET 指出哪些 Microsoft Online Services 或功能會相依於此 CNAME 記錄。 可以是下列其中一個值：
  • null
  • "Email"
  • "Sharepoint"
  • "EmailInternalRelayOnly"
  • "OfficeCommunicationsOnline"
  • "SharePointDefaultDomain"
  • "FullRedelegation"
  • "SharePointPublic"
  • "OrgIdAuthentication"
  • "Yammer"
  • "Intune"
ttl Edm.Int32 GET 指出在 DNS 主機上設定 CNAME 記錄的 Time-To-Live (ttl) 屬性時所要使用的值。

注意：不可為 Null

 

DomainDnsMxRecord 實體 (預覽)

代表需要加入租用戶中特定網域之 DNS 區域檔案中的 MX 記錄。 繼承自 DomainDnsRecord 實體。

重要︰只在搶鮮版 (Beta) 中可用。

屬性

宣告屬性

Name 類型 支援 說明
dnsRecordId Edm.Guid GET 指派給此實體的唯一識別碼。

注意：不可為 Null
isOptional Edm.Boolean GET 指出是否必須由客戶在 DNS 主機上設定此 MX 記錄，Microsoft Online Services 才能正常使用網域。

注意：不可為 Null
label Edm.String GET 在 DNS 主機上設定 MX 記錄的 Alias/Host/Name 屬性時所要使用的值。
mailExchange Edm.String GET 在 DNS 主機上設定 MX 記錄的 Answer/Destination/Value 時所要使用的值。
recordType Edm.String GET 指出此實體所代表的 DNS 記錄類型。 這個值一律是 "Mx"。

注意：索引鍵
preference Edm.Int32 GET 在 DNS 主機上設定 MX 記錄的 Preference/Priority 屬性時所要使用的值。
supportedService Edm.String GET 指出哪些 Microsoft Online Services 或功能會相依於此 CNAME 記錄。 可以是下列其中一個值：
  • null
  • "Email"
  • "Sharepoint"
  • "EmailInternalRelayOnly"
  • "OfficeCommunicationsOnline"
  • "SharePointDefaultDomain"
  • "FullRedelegation"
  • "SharePointPublic"
  • "OrgIdAuthentication"
  • "Yammer"
  • "Intune"
ttl Edm.Int32 GET 在 DNS 主機上設定 MX 記錄的 Time-To-Live (ttl) 屬性時所要使用的值。

注意：不可為 Null

 

DomainDnsSrvRecord Entity 實體 (預覽)

代表需要加入租用戶中特定網域之 DNS 區域檔案中的 SRV 記錄。 繼承自 DomainDnsRecord 實體。

重要︰只在搶鮮版 (Beta) 中可用。

屬性

宣告屬性

Name 類型 支援 說明
dnsRecordId Edm.Guid GET 指派給此實體的唯一識別碼。

注意：不可為 Null
isOptional Edm.Boolean GET 指出是否必須由客戶在 DNS 主機上設定此 SRV 記錄，Microsoft Online Services 才能正常使用網域。

注意：不可為 Null
label Edm.String GET 在 DNS 主機上設定 SRV 記錄的 Name 屬性時所要使用的值。
nameTarget Edm.String GET 在 DNS 主機上設定 SRV 記錄的 Target 屬性時所要使用的值。
port Edm.Int32 GET 在 DNS 主機上設定 SRV 記錄的 Port 屬性時所要使用的值。
優先順序 Edm.Int32 GET 在 DNS 主機上設定 SRV 記錄的 Priority 屬性時所要使用的值。
通訊協定 Edm.String GET 在 DNS 主機上設定 SRV 記錄的 Protocol 屬性時所要使用的值。
recordType Edm.String GET 指出此實體所代表的 DNS 記錄類型。 這個值一律是 "Srv"。

注意：索引鍵
Service Edm.String GET 在 DNS 主機上設定 SRV 記錄的 Service 屬性時所要使用的值。
supportedService Edm.String GET 指出哪些 Microsoft Online Services 或功能會相依於此 SRV 記錄。 可以是下列其中一個值：
  • null
  • "Email"
  • "Sharepoint"
  • "EmailInternalRelayOnly"
  • "OfficeCommunicationsOnline"
  • "SharePointDefaultDomain"
  • "FullRedelegation"
  • "SharePointPublic"
  • "OrgIdAuthentication"
  • "Yammer"
  • "Intune"
ttl Edm.Int32 GET 在 DNS 主機上設定 SRV 記錄的 Time-To-Live 屬性時所要使用的值。

注意：不可為 Null
weight Edm.Int32 GET 在 DNS 主機上設定 SRV 記錄的 Weight 屬性時所要使用的值。

 

DomainDnsTxtRecord Entity 實體 (預覽)

代表需要加入租用戶中特定網域之 DNS 區域檔案中的 TXT 記錄。 繼承自 DomainDnsRecord 實體。

重要︰只在搶鮮版 (Beta) 中可用。

屬性

宣告屬性

Name 類型 支援 說明
dnsRecordId Edm.Guid GET 指派給此實體的唯一識別碼。

注意：不可為 Null
isOptional Edm.Boolean GET 指出是否必須由客戶在 DNS 主機上設定此 MX 記錄，Microsoft Online Services 才能正常使用網域。

注意：不可為 Null
label Edm.String GET 在 DNS 主機上設定 MX 記錄的 Alias/Host/Name 屬性時所要使用的值。
recordType Edm.String GET 指出此實體所代表的 DNS 記錄類型。 這個值一律是 "Mx"。

注意：索引鍵
supportedService Edm.String GET 指出哪些 Microsoft Online Services 或功能會相依於此 CNAME 記錄。 可以是下列其中一個值：
  • null
  • "Email"
  • "Sharepoint"
  • "EmailInternalRelayOnly"
  • "OfficeCommunicationsOnline"
  • "SharePointDefaultDomain"
  • "FullRedelegation"
  • "SharePointPublic"
  • "OrgIdAuthentication"
  • "Yammer"
  • "Intune"
文字 Edm.String GET
ttl Edm.Int32 GET 在 DNS 主機上設定 TXT 記錄的 Time-To-Live 屬性時所要使用的值 (以秒為單位)。

注意：不可為 Null

 

DomainDnsUnavailableRecord 實體 (預覽)

繼承自 DomainDnsRecord 實體。 當您查詢 Domain 實體的導覽屬性 serviceConfigurationRecords 時，您可能會收到 DomainDnsCnameRecord、DomainDnsMxRecord、DomainDnsSrvRecord 及/或 DomainDnsTxtRecord 實體的其中一或多個。 這些實體指出您必須加入網域之區域檔案中的 DNS 記錄，在這之後，才能讓 Microsoft Online Services 使用網域。 無法產生這類實體時，會改為傳回 DomainDnsUnavailableRecord 實體。

重要︰只在搶鮮版 (Beta) 中可用。

屬性

宣告屬性

Name 類型 支援 說明
描述 Edm.String GET 提供傳回 DomainDnsUnavailableRecord 實體的原因。

ExtensionProperty 實體

可讓應用程式定義並使用一組額外的屬性，且這些屬性可加入至目錄物件 (使用者、群組、租用戶詳細資料、裝置、應用程式和服務主體)，應用程式並不需要外部資料存放區。 如需擴充功能屬性的詳細資訊，請參閱Directory Schema Extensions。 繼承自 DirectoryObject。

重要：ExtensionProperty 在 1.5 版中引進。

屬性

宣告屬性

Name 類型 支援 說明
appDisplayName Edm.String GET
dataType Edm.String POST, GET, PATCH 指定要加入的目錄延伸模組屬性型別。 支援的類型包括：Integer、LargeInteger、DateTime (必須以 ISO 8601 指定 - DateTime 以 UTC 儲存)、Binary、Boolean 和 String。
deletionTimestamp Edm.DateTime GET 此屬性對擴充功能屬性而言無效，一律會傳回 null。 繼承自 DirectoryObject。
objectId Edm.String GET 擴充功能屬性的唯一識別碼。 繼承自 DirectoryObject。

注意：索引鍵、不可變、不可為 Null、唯一。
objectType Edm.String GET 識別此物件類型的字串。 對於擴充功能屬性，這個值一律是 "ExtensionProperty"。 繼承自 DirectoryObject。
名稱 Edm.String POST, GET, PATCH 指定目錄延伸模組屬性的顯示名稱。

注意：不可為 Null。
isSyncedFromOnPremises Edm.Boolean GET 指出是否從內部部署目錄同步處理延伸模組屬性。

注意：不可為 Null。
targetObjects Collection(Edm.String) POST, GET, PATCH 要加入目錄延伸模組屬性的目錄物件。 可延伸的受支援目錄實體包括："User"、"Group"、"TenantDetail"、"Device"、"Application" 和 "ServicePrincipal"

注意：不可為 Null。

導覽屬性
無。

注意︰不支援未列出的繼承導覽屬性。 傳送到不支援之導覽屬性的要求會傳回「400 不正確的要求」****。

Group 實體

代表 Azure Active Directory 群組。 繼承自 DirectoryObject。

屬性

宣告屬性

Name 類型 支援 說明
deletionTimestamp Edm.DateTime GET 此屬性對群組而言無效，一律會傳回 null。 繼承自 DirectoryObject。

注意：需要 1.5 版或更新版本。
描述 Edm.String POST, GET, PATCH 群組的選擇性描述。
dirSyncEnabled Edm.Boolean GET ($filter) 若此物件從內部部署目錄同步處理，則為 true；若此物件原本從內部部署目錄同步處理但已不再同步處理，則為 false；如果此物件從未自內部部署目錄同步處理 (預設值)，則為 null。
displayName Edm.String POST (必要), GET ($filter), PATCH 群組的顯示名稱。 建立群組時需要此屬性，且在更新期間無法將其清除。
lastDirSyncTime Edm.DateTime GET ($filter) 指出此物件上次與內部部署目錄進行同步處理的時間。
mail Edm.String GET ($filter) 群組的 SMTP 位址，例如 "serviceadmins@contoso.onmicrosoft.com"。
mailEnabled Edm.Boolean POST (必要), GET, PATCH 指定群組是否擁有郵件功能。 如果 securityEnabled 屬性也為 true，該群組為擁有郵件功能的安全性群組；若否，則該群組為 Microsoft Exchange 通訊群組。 使用 Azure AD Graph 僅可建立 (單純的) 安全性群組。 因此，當建立群組且其不能使用 Azure AD Graph 更新時，必須將屬性設定為 false。
mailNickname Edm.String POST (必要), GET ($filter), PATCH 群組的郵件別名。 建立群組時必須指定此屬性。
objectId Edm.String GET 群組的唯一識別碼。 繼承自 DirectoryObject。

注意：索引鍵、不可變、不可為 Null、唯一。
objectType Edm.String GET 識別此物件類型的字串。 對於群組，這個值一律是 "Group"。 繼承自 DirectoryObject。
onPremisesSecurityIdentifier 字串 GET 包含已從內部部署同步至雲端之群組的內部部署安全性識別碼 (SID)。

注意：需要 1.5 版或更新版本。
provisioningErrors Collection(ProvisioningError) GET 導致無法成功佈建此群組之錯誤詳細資料的集合。

注意：不可為 Null。
proxyAddresses Collection(Edm.String) GET ($filter)

注意︰不可為 Null，多重值屬性的篩選條件運算式需要 any 運算子；如需詳細資訊，請參閱Supported Queries, Filters, and Paging Options。
securityEnabled Edm.Boolean POST (必要), GET ($filter), PATCH 指定群組是否為安全性群組。 如果 mailEnabled 屬性也為 true，該群組為擁有郵件功能的安全性群組，若否，則此為安全性群組。 使用 Azure AD Graph 僅可建立 (單純的) 安全性群組。 因此，在建立群組時必須將此屬性設定為 true。

導覽屬性

Name 收件者 目標多重性 說明
members DirectoryObject

(僅支援 Contact、Group、ServicePrincipal 和 User 物件)		 */* 屬於此群組之成員的使用者、連絡人、群組及服務主體。 繼承自 DirectoryObject。

HTTP 方法︰GET (支援所有群組)、POST (支援安全性群組和擁有郵件功能的安全性群組)、DELETE (僅支援安全性群組)
memberOf DirectoryObject

(僅支援 Group 物件)		 */* 此群組隸屬為其成員的群組。 繼承自 DirectoryObject。

HTTP 方法︰GET (支援所有群組)
owners DirectoryObject */* 群組的擁有者。 擁有者是一組允許修改此物件的非系統管理員使用者。 需要 2013-11-08 版本或更新版本。 繼承自 DirectoryObject。

HTTP 方法︰GET (支援所有群組)、POST (支援安全性群組和擁有郵件功能的安全性群組)、DELETE (僅支援安全性群組)
appRoleAssignments DirectoryObject */* 包含群組所指派到的應用程式集。

注意：需要 1.5 版或更新版本。
extensionProperties DirectoryObject */* 包含與應用程式相關聯的延伸模組屬性。

注意：需要 1.5 版或更新版本。

注意︰不支援未列出的繼承導覽屬性。 傳送到不支援之導覽屬性的要求會傳回「400 不正確的要求」****。

支援的作業

下列為使用者支援的作業 (各項作業所使用的 HTTP 方法位於括號內)：

  • 建立 (POST)︰僅支援安全性群組。
  • 讀取 (GET)：支援所有群組。
  • 更新 (PATCH)︰僅支援安全性群組和擁有郵件功能的安全性群組。 不是所有屬性皆可更新。
  • 刪除 (DELETE)：僅支援安全性群組。

下列為群組導覽屬性支援的作業：

  • 讀取 (GET)：支援所有群組。
  • 更新 (POST)：僅支援安全性群組和擁有郵件功能的安全性群組。 (僅限成員和擁有者。)
  • 刪除 (DELETE)：僅支援安全性群組。 (僅限成員和擁有者。)

在群組上可以呼叫下列動作和函數：

  • checkMemberGroups 可檢查群組在群組清單中的成員資格。 此檢查可移轉。
  • getAvailableExtensionProperties 可傳回群組已註冊的擴充功能屬性清單。 需要 1.5 版或更新版本。
  • getMemberGroups 可傳回群組隸屬的群組清單。 此檢查可移轉。
  • isMemberOf 可檢查群組是否為指定群組的成員。 此檢查可移轉。

備註

  • 共有三種群組：郵件通訊群組 (mailEnabled 屬性為 true 和 securityEnabled 屬性為 false)、擁有郵件功能的安全性群組 (mailEnabled 屬性為 true 和 securityEnabled 屬性為 true)，以及 (單純的) 安全性群組 (mailEnabled 屬性為 false 和 securityEnabled 屬性為 true)。
  • 您只能使用 Graph API 建立安全性群組 (無法建立擁有郵件功能的安全性群組或郵件通訊群組)。 因此，在建立群組時，mailEnabled 屬性必須設定為 false****securityEnabled 屬性必須設定為 true。
  • 當使用 Graph API 建立安全性群組時，必須指定所有標示為必要的屬性。 這些屬性如下：displayName、mailNickname、mailEnabled (false) 及 securityEnabled (true)。
  • 您無法使用 Graph API 將群組由安全性群組更新為擁有郵件功能的安全性群組或郵件通訊群組。

LicenseDetail 實體

包含指派給使用者的授權資訊。

User 實體的 licenseDetails 屬性屬於 LicenseDetail 類型。

重要：在 1.6 版中引進。

屬性

宣告屬性

屬性 類型 支援 說明
objectId Edm.String GET 授權詳細資料物件的唯一識別碼。

注意：索引鍵、不可為 Null。
servicePlans Collection(ServicePlanInfo) GET 指派授權之服務方案的相關資訊。

注意：不可為 Null。
skuId Edm.Guid GET 服務 SKU 的唯一識別碼 (GUID)。 等同於相關 SubscribedSku 物件的 skuId 屬性。
skuPartNumber Edm.String GET 唯一的 SKU 顯示名稱。 等同於相關 SubscribedSku 物件的 skuPartNumber，例如："AAD_Premium"。

導覽屬性
無。

注意︰不支援未列出的繼承導覽屬性。 傳送到不支援之導覽屬性的要求會傳回「400 不正確的要求」****。

支援的作業

下列為授權詳細資料支援的作業 (各項作業所使用的 HTTP 方法位於括弧內)：

  • 建立 (POST)
  • 讀取 (GET)
  • 更新 (PATCH)
  • 刪除 (DELETE)

在授權詳細資料上無法呼叫任何函數或動作。

OAuth2PermissionGrant 實體

代表已授予應用程式 (以服務主體表示) 的 OAuth 2.0 委派權限範圍，作為使用者或管理員同意程序一部分。

重要：自 1.5 版起，Permission 實體類型已重新命名為 OAuth2PermissionGrant。 在 1.5 之前的版本中，在同意過程中所建立的權限會加入使用者或服務主體的 permissions 屬性中。

屬性

宣告屬性

屬性 類型 支援 說明
clientId Edm.String POST、GET 指定服務主體的 objectId 同意在存取資源 (以 resourceId 表示) 時模擬使用者。
consentType Edm.String POST、GET 指定代表組織的系統管理員是否提供同意，或個人是否提供同意。 可能的值為 "AllPrincipals" 或 "Principal"。
expiryTime Edm.DateTime POST, GET, PATCH 已保留。 傳回 null。 請勿使用。
objectId Edm.String GET 權限範圍的唯一識別碼。

注意：索引鍵、不可為 Null。
principalId Edm.String POST、GET 如果 consentType 是 "AllPrincipals"，此值則為 Null，且會對組織中的所有使用者套用此同意。 如果 consentType 是 "Principal"，則此屬性會指定同意的使用者 objectId，並僅對該使用者套用。
resourceId Edm.String POST、GET 指定已授與存取權的資源服務主體 objectId。
範圍 Edm.String POST, GET, PATCH 指定資源應用程式預期會在 OAuth 2.0 存取權杖中看到的範圍宣告值。
startTime Edm.DateTime POST、GET 已保留。 傳回 null。 請勿使用。

導覽屬性
無。

注意︰不支援未列出的繼承導覽屬性。 傳送到不支援之導覽屬性的要求會傳回「400 不正確的要求」****。

支援的作業

下列是權限範圍所支援的作業 (各項作業所使用的 HTTP 方法會顯示在括號中)：

  • 建立 (POST)
  • 讀取 (GET)
  • 更新 (PATCH)：僅限 scope 屬性。
  • 刪除 (DELETE)

可能無法在權限範圍上呼叫任何函數或動作。

備註

  • 在 1.5 版及更新版本中，User 實體和 ServicePrincipal 實體的 oauth2PermissionGrants 導覽屬性會傳回與使用者或服務主體相關聯的 OAuth2PermissionGrant 物件。
  • 在 1.5 之前的版本中，User 實體和 ServicePrincipal 實體的 permissions 導覽屬性會傳回與使用者或服務主體相關聯的 Permission 物件。

ServiceEndpoint 實體

此服務端點實體包含服務探索資訊。 繼承自 DirectoryObject。

Application 和 ServicePrincipal 實體的 ServiceEndpoints 屬性屬於 ServiceEndpoint 類型。 其他服務可以使用儲存在 ServiceEndpoint 實體中的資訊，來尋找此服務及其可定址的端點。

重要：在 1.6 版中引進。

屬性

宣告屬性

屬性 類型 支援 說明
功能 Edm.String POST (必要), GET 服務功能的文字識別碼。 範例包括 "Documents" 和 "Mail"。
deletionTimestamp Edm.DateTime GET 此屬性對服務端點而言無效，一律會傳回 null。 繼承自 DirectoryObject。
objectId Edm.String GET 服務端點的唯一識別碼。 繼承自 DirectoryObject。

注意：索引鍵、不可變、不可為 Null、唯一。
objectType Edm.String GET 識別此物件類型的字串。 對於服務端點，這個值一律是 "ServiceEndpoint"。 繼承自 DirectoryObject。
serviceId Edm.String POST、GET 服務的識別碼
serviceName Edm.String POST、GET 服務的顯示名稱。
URI Edm.String POST (必要), GET 服務端點的 URI。
resourceId Edm.String POST、GET 服務內特定資源的識別碼。

導覽屬性
無。

注意︰不支援未列出的繼承導覽屬性。 傳送到不支援之導覽屬性的要求會傳回「400 不正確的要求」****。

支援的作業

無法對服務端點直接執行作業。 您只能透過 Application 或 ServicePrincipal 的 serviceEndpoints 屬性來對其定址。 下列為支援的作業 (各項作業所使用的 HTTP 方法位於括弧內)：

在服務端點上無法呼叫任何函數或動作。

備註

  • 當您將服務端點加入 Application 中時，需要 capability 和 uri 屬性。

ServicePrincipal 實體

代表目錄中的應用程式的執行個體。 繼承自 DirectoryObject。

屬性

宣告屬性

Name 類型 支援 說明
accountEnabled Edm.Boolean POST, GET ($filter), PATCH 若已啟用服務主體帳戶，則為 true；否則為 false。
addIns Collection(AddIn) GET 定義取用服務可用來在特定內容中呼叫應用程式的自訂行為。 例如，可以轉譯檔案資料流的應用程式可能會為其 "FileHandler" 功能設定 addIns 屬性。 這可讓如 Office 365 等服務在使用者目前正在處理的文件內容中呼叫應用程式。

注意：需要 1.6 版。
appDisplayName Edm.String GET 相關聯應用程式所公開的顯示名稱。
appId Edm.Guid POST (必要), GET ($filter), PATCH 相關聯應用程式的唯一識別碼 (其 appId 屬性)。
appOwnerTenantId Edm.Guid GET
appRoleAssignmentRequired Edm.Boolean POST, GET, PATCH 指定在 Azure AD 核發使用者或存取權杖給應用程式之前，是否需要使用者或群組的 AppRoleAssignment。

注意：需要 1.5 版或更新版本，不可為 Null。
appRoles Collection(AppRole) GET 相關聯應用程式所公開的應用程式角色。 如需詳細資訊，請參閱 Application 實體的 appRoles 屬性定義

注意：需要 1.5 版或更新版本，不可為 Null。
authenticationPolicy ServicePrincipalAuthenticationPolicy GET 保留僅供內部使用。 請勿使用。 1.5 版中移除。

注意：只在 2013-11-08 版中可用。
deletionTimestamp Edm.DateTime GET 此屬性對服務主體而言無效，一律會傳回 null。 繼承自 DirectoryObject。

注意：需要 1.5 版或更新版本。
displayName Edm.String POST, GET ($filter), PATCH 服務主體的顯示名稱。
errorUrl Edm.String POST, GET, PATCH
首頁 Edm.String POST, GET, PATCH 相關聯應用程式的首頁 URL。
keyCredentials Collection(KeyCredential) POST, GET, PATCH 與服務主體相關聯的金鑰認證集合。

注意：不可為 Null。
logoutUrl Edm.String POST, GET, PATCH
oauth2Permissions Collection(OAuth2Permission) GET 相關聯應用程式所公開的 OAuth 2.0 權限。 如需詳細資訊，請參閱 Application 實體的 oauth2Permissions 屬性定義。

注意：需要 1.5 版或更新版本，不可為 Null。
objectId Edm.String GET 服務主體的唯一識別碼。 繼承自 DirectoryObject。

注意：索引鍵、不可變、不可為 Null、唯一。
objectType Edm.String GET 識別此物件類型的字串。 對於服務主體，這個值一律是 "ServicePrincipal"。 繼承自 DirectoryObject。
passwordCredentials Collection(PasswordCredential) POST, GET, PATCH 與服務主體相關聯的密碼認證集合。

注意：不可為 Null。
preferredTokenSigningKeyThumbprint Edm.String GET 保留僅供內部使用。 請勿撰寫或依賴這個屬性。 可能會在未來版本中移除。

注意：需要 1.5 版或更新版本。
publisherName Edm.String POST, GET ($filter), PATCH 租用戶的顯示名稱，其中指定相關聯的應用程式。
replyUrls Collection(Edm.String) POST, GET, PATCH 為了供相關聯的應用程式登入而將使用者權杖傳送到的 URL，或為了存取相關聯的應用程式而將 OAuth 2.0 授權碼和存取權杖傳送到的重新導向 URL。

注意：不可為 Null。
samlMetadataUrl Edm.String POST, GET, PATCH
servicePrincipalNames Collection(Edm.String) POST, GET ($filter), PATCH 用來識別相關聯應用程式的 URI。 如需詳細資訊，請參閱應用程式物件和服務主體物件。

注意︰不可為 Null，多重值屬性的篩選條件運算式需要 any 運算子；如需詳細資訊，請參閱Supported Queries, Filters, and Paging Options。
標記 Collection(Edm.String) POST, GET ($filter), PATCH

注意：不可為 Null。

導覽屬性

Name 收件者 多重性
(來源/目的地)		 說明
appRoleAssignedTo AppRoleAssignment */* 指派給此服務主體的主體 (使用者、群組和服務主體)。 需要 1.5 版或更新版本。
appRoleAssignments AppRoleAssignment */* 服務主體指派到的應用程式。 需要 1.5 版或更新版本。
createdObjects DirectoryObject */* 此服務主體所建立的目錄物件。 繼承自 DirectoryObject。 需要 2013-11-08 版本或更新版本。
memberOf DirectoryObject

(僅支援 DirectoryRole 和 Group 物件)		 */* 此服務主體為其直屬成員的角色和群組。 繼承自 DirectoryObject。

HTTP 方法：GET
oauth2PermissionGrants OAuth2PermissionGrant */* 與此服務主體相關聯的使用者模擬授權。 需要 1.5 版或更新版本。
ownedObjects DirectoryObject */* 此服務主體所擁有的目錄物件。 繼承自 DirectoryObject。 需要 2013-11-08 版本或更新版本。
owners DirectoryObject */* 做為此服務主體之擁有者的目錄物件。 擁有者是一組允許修改此物件的非系統管理員使用者。 繼承自 DirectoryObject。 需要 2013-11-08 版本或更新版本。
權限 權限 */* 在 1.5 版及更新版本中，已重新命名為 oauth2PermissionGrants。 在舊版中，指向與服務主體相關聯的權限。 如需 Permission 實體類型的資訊，請參閱 OAuth2PermissionGrant。
serviceEndpoints serviceEndpoint 1/* 適用於探索的服務端點。 如需詳細資訊，請參閱 ServiceEndpoint 主題。 HTTP 方法：GET。 需要 1.6 版或更新版本。

注意︰不支援未列出的繼承導覽屬性。 傳送到不支援之導覽屬性的要求會傳回「400 不正確的要求」****。

支援的作業

下列為服務主體支援的作業 (各項作業所使用的 HTTP 方法位於括號內)：

  • 建立 (POST)
  • 讀取 (GET)
  • 更新 (PATCH)
  • 刪除 (DELETE)

下列為導覽屬性支援的作業：

  • 讀取 (GET)

在群組上可以呼叫下列動作和函數：

  • checkMemberGroups 可檢查服務主體在群組清單中的成員資格。 此檢查可移轉。
  • getMemberGroups 可傳回服務主體隸屬的群組清單。 此檢查可移轉。
  • getMemberObjects 可傳回服務主體隸屬的群組和目錄角色清單。 此檢查可移轉。

主體必須是「公司系統管理員」角色，才能在服務主體上執行作業。

備註

當您建立服務主體時，您必須將 appId 屬性設為目錄中的應用程式識別碼。

SubscribedSku 實體

包含公司訂閱之服務 SKU 的相關資訊。

已訂閱的 SKU 僅支援讀取操作，不支援建立、更新和刪除。 不支援查詢篩選條件運算式。

屬性

宣告屬性

屬性 類型 支援 描述
appliesTo Edm.String GET 例如，「使用者」或「公司」。

注意：需要 1.6 版。
capabilityStatus Edm.String GET 例如，「已啟用」。
consumedUnits Edm.Int32 GET 已指派的授權數目。
objectId Edm.String GET 已訂閱之 SKU 物件的唯一識別碼。

注意：索引鍵、不可為 Null。
prepaidUnits LicenseUnitsDetail GET 預付授權數目和狀態的相關資訊。
servicePlans Collection(ServicePlanInfo) GET SKU 可用之服務方案的相關資訊。

注意：不可為 Null。
skuId Edm.Guid GET 服務 SKU 的唯一識別碼 (GUID)。
skuPartNumber Edm.String GET SKU 組件編號，例如："AAD_PREMIUM" 或 "RMSBASIC"。

導覽屬性
無。

注意︰不支援未列出的繼承導覽屬性。 傳送到不支援之導覽屬性的要求會傳回「400 不正確的要求」****。

支援的作業

下列為已訂用的 SKU 支援的作業 (各項作業所使用的 HTTP 方法位於括號內)：

  • 讀取 (GET)

已訂閱的 SKU 不公開任何導覽屬性。

在已訂閱的 SKU 上無法呼叫任何函數或動作。

TenantDetail 實體

代表 Azure Active Directory 租用戶。 租用戶上僅支援讀取和更新作業，不支援建立和刪除。 繼承自 [DirectoryOjbect]。

屬性

宣告屬性

Name 類型 支援 說明
assignedPlans Collection(AssignedPlan) GET 與租用戶相關的服務方案集合。

注意：不可為 Null。
城市 Edm.String GET
companyLastDirSyncTime Edm.DateTime GET 租用戶最後一次與內部部署目錄進行同步處理的時間和日期。
國家/地區 Edm.String GET
countryLetterCode Edm.String GET
deletionTimestamp Edm.DateTime GET 此屬性對租用戶而言無效，一律會傳回 null。 繼承自 DirectoryObject。

注意：需要 1.5 版或更新版本。
dirSyncEnabled Edm.Boolean GET 若此物件從內部部署目錄同步處理，則為 true；若此物件原本從內部部署目錄同步處理但已不再同步處理，則為 false；如果此物件從未自內部部署目錄同步處理 (預設值)，則為 null。
displayName Edm.String GET 租用戶的顯示名稱。
marketingNotificationEmails Collection(Edm.String) GET, PATCH

注意：不可為 Null。
objectId Edm.String GET 租用戶的唯一識別碼。 繼承自 DirectoryObject。

注意：索引鍵、不可變、不可為 Null、唯一。
objectType Edm.String GET 識別此物件類型的字串。 對於租用戶，這個值一律是 "Company"。 繼承自 DirectoryObject。
postalCode Edm.String GET
preferredLanguage Edm.String GET
provisionedPlans Collection(ProvisionedPlan) GET

注意：不可為 Null。
provisioningErrors Collection(ProvisioningError) GET

注意：不可為 Null。
狀態 Edm.String GET
街道 Edm.String GET
technicalNotificationMails Collection(Edm.String) GET, PATCH

注意：不可為 Null。
telephoneNumber Edm.String GET
tenantType Edm.String GET

注意：1.5 版及更新版本中已移除。
verifiedDomains Collection(VerifiedDomain) GET 與此租用戶相關的定義域集合。

注意：不可為 Null。

導覽屬性

Name 收件者 目標多重性 說明
trustedCAsForPasswordlessAuth TrustedCAsForPasswordlessAuth 1/1 執行無密碼驗證時用來驗證信任鏈結的一組憑證授權單位。 如需詳細資訊，請參閱備註。

注意：需要 1.6 版或更新版本。

注意︰不支援未列出的繼承導覽屬性。 傳送到不支援之導覽屬性的要求會傳回「400 不正確的要求」****。

支援的作業

下列為租用戶支援的作業 (各項作業所使用的 HTTP 方法位於括號內)：

  • 讀取 (GET)
  • 更新 (PATCH)；使用 Graph API 只能更新 marketingNotificationMails 和 technicalNotificationMails 屬性。

下列為租用戶導覽屬性支援的作業：

  • 讀取 (GET)
  • 更新 (POST)
  • 刪除 (DELETE)

在租用戶上無法呼叫任何函數或動作。

備註

  • 您無法使用 Graph API 建立或刪除租用戶。
  • 使用 Graph API 只能更新 marketingNotificationMails 和 technicalNotificationMails 屬性。
  • 受信任的憑證授權單位可讓同盟租用戶中的使用者使用憑證式驗證進行登入。 為了實現此案例，請設定 trustedCAsForPasswordlessAuth 導覽屬性，將憑證授權單位的公開憑證設定為受信任可以進行登入。
  • 查詢篩選器運算式不支援租用戶。

TrustedCAsForPasswordlessAuth 實體

代表執行無密碼驗證時要驗證信任鏈結的一組憑證授權單位。

TenantDetail 實體的 TrustedCAsForPasswordlessAuth 導覽屬性是 trustedCAsForPasswordlessAuth 的集合。 用戶端可以使用此屬性，將授權單位的公開憑證設定為受信任可以進行登入，以便同盟租用戶中的使用者能夠使用憑證式驗證進行登入。

重要：在 1.6 版中引進。

屬性

宣告屬性

Name 類型 支援 說明
id Edm.String GET 唯一識別碼。

注意：索引鍵、不可為 Null。
certificateAuthorities Collection(CertificateAuthorityInformation) POST (必要), GET, PATCH 憑證授權單位資訊的集合。

導覽屬性
無。

支援的作業

下列為受信任的憑證授權單位支援的作業 (各項作業所使用的 HTTP 方法位於括弧內)：

  • 建立 (POST)；只能指定 certificateAuthorities 屬性。
  • 讀取 (GET)
  • 更新 (PATCH)；僅限 certificateAuthorities 屬性

受信任的憑證不公開任何導覽屬性。

在受信任的憑證授權單位上無法呼叫任何函數或動作。

User 實體

代表 Azure AD 使用者帳戶。 繼承自 DirectoryObject。

屬性

宣告屬性

Name 類型 支援 說明
accountEnabled Edm.Boolean POST (必要), GET ($filter), PATCH 若已啟用帳戶，則為 true；否則為 false。 建立使用者時需要此屬性。
assignedLicenses Collection(AssignedLicense) POST, GET, PATCH 指派給使用者的授權。

注意：不可為 Null。
assignedPlans Collection(AssignedPlan) GET 指派給使用者的方案。

注意：不可為 Null。
城市 Edm.String POST, GET ($filter), PATCH 使用者所在的縣市。
國家/地區 Edm.String POST, GET ($filter), PATCH 使用者所在的國家/地區，例如 "US" 或 "UK"。
creationType Edm.String POST (本機帳戶的必要項), GET ($filter) 指定使用者帳戶是否為 Azure Active Directory B2C 租用戶的本機帳戶。 可能的值為 "LocalAccount" 和 null。 建立本機帳戶時，需要此屬性，而且您必須將它設為 "LocalAccount"。 建立工作或學校帳戶時，請勿指定此屬性，或將它設為 null。 如需 Azure Active Directory B2C 的詳細資訊，請參閱 Azure Active Directory B2C 文件。

注意：需要 1.6 版或更新版本。 在搶鮮版 (Beta) 中，將值指定為 "NameCoexistence" 而非 "LocalAccount"。
deletionTimestamp Edm.DateTime GET 此屬性對使用者而言無效，一律會傳回 null。 繼承自 DirectoryObject。

注意：需要 1.5 版或更新版本。
department Edm.String POST, GET ($filter), PATCH 使用者工作的部門名稱。
dirSyncEnabled Edm.Boolean GET ($filter) 若此物件從內部部署目錄同步處理，則為 true；若此物件原本從內部部署目錄同步處理但已不再同步處理，則為 false；如果此物件從未自內部部署目錄同步處理 (預設值)，則為 null。
displayName Edm.String POST (必要), GET ($filter), PATCH (但無法清除) 使用者顯示於通訊錄中的名稱。 這通常是使用者的名字、中間名縮寫和姓氏的組合。 建立使用者時需要此屬性，且在更新期間無法將其清除。
facsimileTelephoneNumber Edm.String POST, GET, PATCH 使用者的商務傳真機電話號碼。
givenName Edm.String POST, GET ($filter), PATCH 使用者的名字。
immutableId Edm.String POST (使用 UPN 的同盟網域時為必要項), GET ($filter), PATCH 此屬性用來將內部部署 Active Directory 使用者帳戶與其 Azure AD 使用者物件產生關聯。 如果您使用使用者之 userPrincipalName (UPN) 屬性的同盟網域，在 Graph 中建立新使用者帳戶時，必須指定此屬性。

重要：指定此屬性時，無法使用 $ 和 _ 字元。

注意：需要 2013-11-08 版或更新版本。
jobTitle Edm.String POST, GET ($filter), PATCH 使用者的職稱。
lastDirSyncTime Edm.DateTime GET ($filter) 指出此物件上次與內部部署目錄進行同步處理的時間。例如："2013-02-16T03:04:54Z"
mail Edm.String POST, GET ($filter) 使用者的 SMTP 位址，例如 "jeff@contoso.onmicrosoft.com"。
mailNickname Edm.String POST (工作或學校帳戶的必要項), GET ($filter), PATCH 使用者的郵件別名。 當您建立工作或學校帳戶時，需要此屬性；對於本機帳戶而言則為選擇性。
行動 Edm.String POST, GET, PATCH 使用者的主要行動電話號碼。
objectId Edm.Guid GET 使用者的唯一識別碼。 繼承自 DirectoryObject。

注意：索引鍵、不可變、不可為 Null、唯一。
objectType Edm.String GET 識別此物件類型的字串。 對於使用者，這個值一律是 "User"。 繼承自 DirectoryObject。
onPremisesSecurityIdentifier Edm.String GET 包含已從內部部署同步至雲端之使用者的內部部署安全性識別碼 (SID)。

注意：需要 1.5 版或更新版本。
otherMails Collection(Edm.String) POST, GET ($filter), PATCH 使用者的其他電子郵件地址清單，例如：["bob@contoso.com", "Robert@fabrikam.com"]。

注意︰不可為 Null，多重值屬性的篩選條件運算式需要 any 運算子；如需詳細資訊，請參閱Supported Queries, Filters, and Paging Options。
passwordPolicies Edm.String POST, GET, PATCH 指定使用者的密碼原則。 這個值是一個列舉，具有可能值 "DisableStrongPassword" 允許指定比預設原則更弱的密碼。 也可以指定 "DisablePasswordExpiration"。 兩者可同時指定，例如："DisablePasswordExpiration, DisableStrongPassword"。
passwordProfile PasswordProfile POST (必要), GET, PATCH 指定使用者的密碼設定檔。 設定檔含有使用者的密碼。 建立使用者時需要此屬性。

設定檔內的密碼必須符合 passwordPolicies 屬性所指定的最低需求。 依預設需要增強式密碼。 如需強式密碼必須符合之各項限制的詳細資訊，請參閱 Microsoft Office 365 說明頁面中變更您的密碼底下的密碼原則。
physicalDeliveryOfficeName Edm.String POST, GET, PATCH 使用者工作地點的辦公室位置。
postalCode Edm.String POST, GET, PATCH 使用者郵寄地址的郵遞區號。 具體的郵遞區號依使用者的國家/地區而定。 在美國，此屬性包含了郵遞區號 (ZIP Code)。
preferredLanguage Edm.String POST, GET, PATCH 使用者慣用的語言。 應該符合 ISO 639-1 代碼，例如 "en-US"。
provisionedPlans Collection(ProvisionedPlan) GET 針對使用者佈建的方案。

注意：不可為 Null。
provisioningErrors Collection(ProvisioningError) GET 導致無法成功佈建這名使用者之錯誤詳細資料的集合。
proxyAddresses Collection(Edm.String) GET ($filter) Fpr 範例：["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"]

注意︰唯一、不可為 Null，多重值屬性的篩選條件運算式需要 any 運算子；如需詳細資訊，請參閱Supported Queries, Filters, and Paging Options。
signInNames Collection(SignInName) POST (本機帳戶的必要項), GET ($filter) 為 Azure Active Directory B2C 租用戶中的本機帳戶，指定登入名稱的集合。 每個登入名稱在公司/租用戶中必須是唯一的。 當您建立本機帳戶使用者時，必須指定此屬性；當您建立工作或學校帳戶時，則請勿指定。 如需 Azure Active Directory B2C 的詳細資訊，請參閱 Azure Active Directory B2C 文件。

注意：需要 1.6 版或更新版本。 已從搶鮮版 (Beta) 中的 alternativeSignInNameInfo 重新命名。
sipProxyAddress Edm.String GET 指定使用者的 voice over IP (VOIP) 工作階段初始通訊協定 (SIP) 位址。

注意：需要 1.5 版或更新版本。
狀態 Edm.String POST, GET ($filter), PATCH 使用者地址所屬的州/省。
streetAddress Edm.String POST, GET, PATCH 使用者工作地點的街道地址。
surname Edm.String POST, GET ($filter), PATCH 使用者的姓氏。

注意：可篩選。
telephoneNumber Edm.String POST, GET, PATCH 使用者工作地點的主要電話號碼。
thumbnailPhoto Edm.Stream POST, GET, PATCH 使用者的相片縮圖顯示。

注意：不可為 Null。
usageLocation Edm.String POST, GET ($filter), PATCH 雙字母的國碼 (ISO 標準 3166)。 基於法律要求而必須檢查服務在國家或地區中的可用性，將獲派授權的使用者需要此項目。 範例包括："US"、"JP" 和 "GB"

注意：不可為 Null。
userPrincipalName Edm.String POST (工作或學校帳戶的必要項), GET ($filter), PATCH 使用者的使用者主要名稱 (UPN)。 UPN 是使用者的網際網路型態登入名稱 (根據網際網路標準 RFC 822)。 依照慣例，這應該對應到使用者的電子郵件名稱。 一般格式為 "alias@domain"。 若是工作或學校帳戶，此網域必須在租用戶的已驗證網域集合中。 建立工作或學校帳戶時，需要此屬性；對於本機帳戶而言則為選擇性。

租用戶的已驗證網域可透過 TenantDetail 的 VerifiedDomains 屬性存取。

注意：索引鍵、唯一。
userType Edm.String POST, GET ($filter), PATCH 字串值可用來在您的目錄中分類使用者類型，例如 "Member" 和 "Guest"。

注意：需要 2013-11-08 版或更新版本。

導覽屬性

Name 收件者 多重性
(來源/目的地)		 說明
manager DirectoryObject

(僅支援 User 和 Contact 物件。)		 */0..1 擔任這名使用者之管理員的使用者或連絡人。 繼承自 DirectoryObject。

HTTP 方法：GET、PUT、DELETE
directReports DirectoryObject

(僅支援 User 和 Contact 物件。)		 */* 負責向這名使用者報告的使用者及連絡人。 (使用者及連絡人的 manager 屬性設定為這名使用者。)繼承自 DirectoryObject。

HTTP 方法：GET
licenseDetails LicenseDetail */*

注意：需要 1.6 版或更新版本。
memberOf DirectoryObject

(僅支援 Group 和 DirectoryRole 物件。)		 */* 使用者隸屬為其成員的群組及目錄角色。 繼承自 DirectoryObject。

HTTP 方法：GET
ownedDevices [裝置] */* 使用者所擁有的裝置。
權限 權限 */* 與使用者相關聯的權限。 在 1.5 版及更新版本中，此屬性已重新命名為 oauth2PermissionGrants而 Permission 實體已重新命名為 OAuth2PermissionGrant。 如需 Permission 實體類型的文件，請參閱 OAuth2PermssionGrant 的文件。
registeredDevices [裝置] */* 使用者已註冊的裝置。
createdObjects DirectoryObject */* 使用者建立的目錄物件。 需要 2013-11-08 版本或更新版本。
ownedObjects DirectoryObject */* 使用者所擁有的目錄物件。 需要 2013-11-08 版本或更新版本。
appRoleAssignments AppRoleAssignment */* 這個使用者指派到的應用程式集。 需要 1.5 版或更新版本。

HTTP 方法：GET、POST、DELETE
oauth2PermissionGrants OAuth2PermissionGrant */* 獲得同意模擬此使用者的應用程式集。 需要 1.5 版或更新版本。

HTTP 方法：GET、POST、DELETE

注意︰不支援未列出的繼承導覽屬性。 傳送到不支援之導覽屬性的要求會傳回「400 不正確的要求」****。

支援的作業

下列為使用者支援的作業 (各項作業所使用的 HTTP 方法位於括號內)：

  • 建立 (POST)
  • 讀取 (GET)
  • 更新 (PATCH)
  • 刪除 (DELETE)

使用者導覽屬性支援下列作業，並非每個導覽屬性都支援所有作業。

  • 讀取 (GET)
  • 更新 (PUT)
  • 刪除 (DELETE)

在使用者上可以呼叫下列動作和函數：

  • assignLicense 可指派及/或移除使用者的指定授權清單。 需要 2013-11-08 版本或更新版本。
  • checkMemberGroups 可檢查使用者在群組清單中的成員資格。 此檢查可移轉。
  • getAvailableExtensionProperties 可傳回使用者已註冊的擴充功能屬性清單。 需要 1.5 版或更新版本。
  • getMemberGroups 可傳回使用者隸屬的群組清單。 此檢查可移轉。
  • getMemberObjects 可傳回使用者隸屬的群組和目錄角色清單。 此檢查可移轉。
  • isMemberOf 可檢查使用者是否為指定群組的成員。 此檢查可移轉。

備註

  • 若要建立工作或學校帳戶，需要下列屬性︰accountEnabled、displayName、mailNickname、passwordProfile 和 userPrincipalName。 passwordProfile 屬性所指定的密碼必須符合租用戶的密碼複雜性需求。 如需詳細資訊，請參閱 passwordPolicies 屬性。
  • 若要建立本機帳戶，需要下列屬性︰accountEnabled、creationType (必須設為 “LocalAccount”)、displayName、passwordProfile 和 signInNames。 passwordProfile 屬性所指定的密碼必須符合租用戶的密碼複雜性需求。 如需詳細資訊，請參閱 passwordPolicies 屬性。
  • 在 2013-11-08 版及更新版本中，如果您使用使用者之 userPrincipalName (UPN) 屬性的同盟網域，在 Graph 中建立新使用者帳戶時，必須指定 immutableId 屬性。
  • displayName 屬性在更新時無法清除。
  • passwordProfile 屬性一律會傳回 null。 這是為了防止顯示使用者的密碼。 您可以藉由更新 passwordProfile 屬性重設使用者的密碼。
  • 除了適用於所有目錄實體的標準定址之外，還可以使用 userPrincipalName 屬性來定址使用者，例如 https://graph.windows.net/contoso.onmicrosoft.com/users/john@contoso.onmicrosoft.com?api-version=1.5。

複雜類型參考

AddIn 類型

定義取用服務可用來在特定內容中呼叫應用程式的自訂行為。 例如，可以轉譯檔案資料流的應用程式可能會為其 "FileHandler" 功能設定 addIns 屬性。 這可讓如 Office 365 等服務在使用者目前正在處理的文件內容中呼叫應用程式。 Application 和 ServicePrincipal 實體的 addins 屬性是 AddIn 的集合。

重要：在 1.6 版中引進。

屬性

Name 類型 讀取/寫入 說明
id Edm.Guid R 特定 Application 上之 addins 集合內的唯一識別碼。
型別 Edm.String RW 應用程式所公開之功能的唯一名稱。
內容 Collection(KeyValue) RW (寫入時為必要項) 索引鍵/值組的集合，定義取用服務可使用或呼叫的參數。 對 addIns 集合執行 POST 或 PATCH 作業時，您必須指定此屬性。

AlternativeSecurityId 類型

包含與裝置相關聯的替代安全性識別碼。 Device 實體的 alternativeSecurityIds 屬性是 AlternativeSecurityId 的集合。

屬性

Name 類型 讀取/寫入 說明
identityProvider Edm.String
key Edm.Binary
型別 Edm.Int32

AppRole 類型

代表應用程式角色，可能由呼叫另一個應用程式的用戶端應用程式要求，或用來將應用程式指派給指定應用程式角色中的使用者或群組。 ServicePrincipal 實體和 Application 實體的 appRoles 屬性是 AppRole 的集合。

重要：需要 1.5 版或更新版本。

屬性

Name 類型 讀取/寫入 說明
allowedMemberTypes Collection(Edm.String) RW 指定是否可以藉由設定為 "User" 而將此應用程式角色定義指派給使用者和群組，或藉由設定為 "Application" 而指派給其他應用程式 (在精靈服務案例中存取此應用程式)，或指派給使用者和群組以及其他應用程式。

注意：不可為 Null。
描述 Edm.String RW 出現在管理員應用程式指派和同意體驗中的權限說明文字。
displayName Edm.String RW 出現在管理員同意和應用程式指派體驗中的權限顯示名稱。
id Edm.Guid RW appRoles 集合內的唯一角色識別碼。
isEnabled Edm.Boolean RW 當建立或更新角色定義時，這必須設為 true (此為預設值)。 若要刪除角色，這必須先設為 false。 此時，在後續的呼叫中，可能會移除此角色。
值 Edm.String RW 指定應用程式預期驗證和存取權杖中應該有的角色宣告值。

AssignedLicense 類型

代表指派給使用者的授權。 User 實體的 assignedLicenses 屬性是 AssignedLicense 的集合。

屬性

Name 類型 讀取/寫入 說明
disabledPlans Collection(Edm.Guid) R 已停用之方案的唯一識別碼集合。

注意：不可為 Null。
skuId Edm.Guid R 服務 SKU 的唯一識別碼。 與相關 SubscribedSku 物件的 skuId 屬性值相同。

AssignedPlan 類型

User 實體和 TenantDetail 實體的 assignedPlans 屬性是 AssignedPlan 的集合。

屬性

Name 類型 讀取/寫入 說明
assignedTimestamp Edm.DateTime R 指派方案的日期和時間，例如：2013-01-02T19:32:30Z。
capabilityStatus Edm.String R 例如，「已啟用」。
服務 Edm.String R 名稱的服務，例如 "SharePoint"、"MicrosoftOffice" 或 "Exchange"。
servicePlanId Edm.Guid R 識別服務方案的 GUID。

CertificateAuthorityInformation 類型

代表執行無密碼驗證時用來驗證信任鏈結的憑證授權單位。 TrustedCAsForPasswordlessAuth 實體的 CertificateAuthorities 屬性是 CertificateAuthorityInformation 的集合。

重要：在 1.6 版中引進。

屬性

Name 類型 讀取/寫入 說明
authorityType Edm.String RW (POST 時為必要項) 必要。 必須設為兩個可能值的其中一個：“RootAuthority” 或 “IntermediateAuthority”。 可在驗證期間用來驗證憑證。
crlDistributionPoint Edm.String RW 憑證撤銷清單 (CRL) 發佈點會保留儲存已撤銷之所有憑證序號的檔案。 這通常是 URI。
deltaCrlDistributionPoint Edm.String RW 包含自上次建立完整 CRL 後所有已撤銷憑證之清單的 URI。
trustedCertificate Edm.Binary RW (POST 時為必要項) 必要。 使用二進位格式的公開憑證。
trustedIssuer Edm.String R 唯讀。 從 trustedCertificate 值計算而得。
trustedIssuerSki Edm.String R 唯讀。 主體金鑰識別碼是從 trustedCertificate 值計算而得。

KeyCredential 類型

包含與應用程式或服務主體相關聯的金鑰認證。 Application 和 ServicePrincipal 實體的 keyCredentials 屬性是 KeyCredential 的集合。

屬性

Name 類型 讀取/寫入 說明
customKeyIdentifier Edm.Binary
endDate Edm.DateTime 認證過期的日期和時間。
keyId Edm.Guid 金鑰的唯一識別碼 (GUID)。
startDate Edm.DateTime 認證生效的日期和時間。
型別 Edm.String 金鑰認證的類型，例如「對稱」。
使用方式 Edm.String 描述金鑰用途的字串，例如「驗證」。
值 Edm.String

KeyValue 類型

包含索引鍵/值組，定義取用服務可對 AddIn 中指定的應用程式使用或呼叫的參數。 AddIn 類型的 properties 屬性是 KeyValue 的集合。

重要：在 1.6 版中引進。

屬性

Name 類型 讀取/寫入 說明
key Edm.String RW 索引鍵/值組的索引鍵。
值 Edm.String RW 索引鍵/值組的值。

LicenseUnitsDetail 類型

包含公司訂閱的服務 SKU 之預付單位的相關資訊和狀態。

SubscribedSku 實體的 prepaidUnits 屬性屬於 LicenseUnitsDetail 類型。

屬性

Name 類型 讀取/寫入 說明
enabled Edm.Int32 R 啟用的單位數。
已暫止 Edm.Int32 R 暫止的單位數。
warning Edm.Int32 R 處於警告狀態的單位數。

OAuth2Permission 類型

代表 OAuth 2.0 委派權限範圍。 用戶端應用程式在呼叫資源應用程式時，可要求指定的 OAuth 2.0 委派權限範圍 (透過 Application 物件上的 requiredResourceAccess 集合)。 ServicePrincipal 實體和 Application 實體的 oauth2Permissions 屬性是 OAuth2Permission 的集合。

重要：需要 1.5 版或更新版本。

屬性

Name 類型 讀取/寫入 說明
adminConsentDescription Edm.String RW 出現在管理員同意和應用程式指派體驗中的權限說明文字。
adminConsentDisplayName Edm.String RW 出現在管理員同意和應用程式指派體驗中的權限顯示名稱。
id Edm. GUID RW Oauth2Permissions 集合內的唯一範圍權限識別碼。
isEnabled Edm.Boolean RW 當建立或更新權限時，此屬性必須設為 true (此為預設值)。 若要刪除權限，此屬性必須先設為 false。 此時，在後續的呼叫中，可能會移除權限。

注意：不可為 Null。
型別 Edm.String RW 指定此範圍權限是否可以由使用者同意，或它是否為必須由公司系統管理員同意的租用戶整體權限。 可能的值為 "User" 或 "Admin"。
userConsentDescription Edm.String RW 出現在使用者同意體驗中的權限說明文字。
userConsentDisplayName Edm.String RW 出現在使用者同意體驗中的權限顯示名稱。
值 Edm.String RW 資源應用程式預期 OAuth 2.0 存取權杖中應該有的範圍宣告值。

PasswordCredential 類型

包含與應用程式或服務主體相關聯的密碼認證。 ServicePrincipal 實體和 Application 實體的 passwordCredentials 屬性是 PasswordCredential 的集合。

屬性

Name 類型 讀取/寫入 說明
customKeyIdentifier Edm.Binary
endDate Edm.DateTime 密碼過期的日期和時間。
keyId Edm.Guid
startDate Edm.DateTime 密碼生效的日期和時間。
值 Edm.String

PasswordProfile 類型

包含與使用者相關聯的密碼設定檔。 User 實體的 passwordProfile 屬性是 PasswordProfile 物件。

屬性

Name 類型 附註 說明
密碼 Edm.String RW 使用者的密碼。 建立使用者時需要此屬性。 此屬性可加以更新，但使用者必須在下一次登入時變更密碼。

密碼必須符合使用者的 PasswordPolicies 屬性所指定的最低需求。 依預設需要增強式密碼。
forceChangePasswordNextLogin Edm.Boolean RW 若使用者必須在下一次登入時變更其密碼，則為 true；否則為 false。

ProvisionedPlan 類型

User 實體和 TenantDetail 實體的 provisionedPlans 屬性是 ProvisionedPlan 的集合。

屬性

Name 類型 讀取/寫入 說明
capabilityStatus Edm.String R 例如，「已啟用」或「已刪除」。
provisioningStatus Edm.String R 例如，「成功」。
服務 Edm.String R 名稱的服務，例如 "SharePoint"、"MicrosoftOffice" 或 "Exchange"。

ProvisioningError 類型

Contact、User 和 Group 實體的 provisioningErrors 屬性是 ProvisioningError 的集合。

屬性

Name 類型 讀取/寫入 說明
errorDetail Edm.String R 錯誤的描述。
已解決 Edm.Boolean R 若已解決錯誤，則為 true；否則為 false。
serviceInstance Edm.String R 發生錯誤的服務執行個體。
時間戳記 Edm.DateTime R 發生錯誤的日期和時間。

RequiredResourceAccess 類型

指定應用程式需要存取之指定資源下的 OAuth 2.0 權限範圍和應用程式角色集合。 用戶端應用程式在呼叫資源應用程式時，可要求指定的 OAuth 2.0 權限範圍 (透過 requiredResourceAccess 集合)。 Application 實體的 RequiredResourceAccess 屬性是 ReqiredResourceAccess 的集合。

重要：需要 1.5 版或更新版本。

屬性

Name 類型 讀取/寫入 說明
resourceAppId Edm.String RW 應用程式需要存取之資源的唯一識別碼。 這應該等同於目標資源應用程式上宣告的 appId。
resourceAccess Collection(ResourceAccess) RW 應用程式從指定的資源中需要的 OAuth2.0 權限範圍和應用程式角色清單。

注意：不可為 Null。

ResourceAccess 類型

指定應用程式需要的 OAuth 2.0 權限範圍或應用程式角色。 RequiredResourceAccess 類型的 resourceAccess 屬性是 ResourceAccess 的集合。

重要：需要 1.5 版或更新版本。

屬性

Name 類型 讀取/寫入 說明
id Edm.Guid RW 資源應用程式所公開之 OAuth2Permission 或 AppRole 執行個體的唯一識別碼。

注意：不可為 Null。
型別 Edm.String RW 指定 id 屬性參考 OAuth2Permission 或 AppRole。 可能的值為 "scope" 或 "role"。

ServicePlanInfo 類型

包含與訂閱的 SKU 相關聯之服務方案或指派給使用者之授權的相關資訊。 SubscribedSku 和 LicenseDetail 實體的 servicePlans 屬性是 ServicePlanInfo 的集合。

屬性

Name 類型 讀取/寫入 說明
appliesTo Edm.String R 例如，「使用者」或「公司」。

注意：需要 1.6 版。
provisioningStatus Edm.String R 例如，「成功」或「已停用」。

注意：需要 1.6 版。
servicePlanId Edm.Guid R 服務方案的唯一識別碼 (GUID)。
servicePlanName Edm.String R 服務方案的名稱。 例如，"MFA_PREMIUM"、"AAD_PREMIUM" 或 "RMS_S_BASIC"。

ServicePrincipalAuthenticationPolicy 類型

包含服務主體的驗證原則。

重要：只在 2013-11-08 中可用，但保留供內部使用，且已在 1.5 版及更新版本中移除。

屬性

Name 類型 讀取/寫入 說明
defaultPolicy Edm.String RW 保留僅供內部使用。 請勿使用。 1.5 版中移除。
allowedPolicies Collection(Edm.String) RW 保留僅供內部使用。 請勿使用。 1.5 版中移除。

注意：不可為 Null。

SignInName 類型

包含 Azure Active Directory B2C 租用戶中本機帳戶使用者之登入名稱的相關資訊。 User 實體的 signInNames 屬性是 SignInName 的集合。 如需 Azure Active Directory B2C 的詳細資訊，請參閱 Azure Active Directory B2C 文件。

重要：在 1.6 版中引進。 已從搶鮮版 (Beta) 中的 LogonIdentifier 重新命名。

屬性

Name 類型 讀取/寫入 說明
型別 Edm.String RW 字串值可用來在您的目錄中分類使用者登入類型，例如 "emailAddress" 或 "userName"。
值 Edm.String RW 本機帳戶使用的登入資訊。 在公司/租用戶中必須是唯一的。 例如，"johnc@example.com"。

VerifiedDomain 類型

指定租用戶的網域。 TenantDetail 實體的 verifiedDomains 屬性是 VerifiedDomain 的集合。

屬性

Name 類型 讀取/寫入 說明
capabilities Edm.String R 例如，"Email"、"OfficeCommunicationsOnline"。
預設 Edm.Boolean R 若這是與租用戶相關聯的預設網域，則為 true；否則為 false。
id Edm.String R 例如，"00057FFE80187238"。
初始 Edm.Boolean R
名稱 Edm.String R 網域名稱，例如 "contoso.onmicrosoft.com"
型別 Edm.String R 例如，"Managed"。

其他資源

  • 在 Graph API 概念中深入了解 Graph API 支援的功能、能力和預覽功能。