Spinpanel （預覽版）

Spinpanel，允許您銷售、部署、管理和自動化 Microsoft 雲解決方案

此連接器適用於以下產品和區域：

服務	Class	Regions
副駕駛工作室	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
邏輯應用程式	標準	所有 Logic Apps 區域，但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部（DoD）
Power Apps	進階	除下列區域外的所有 Power Apps 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
Power Automate（自動化服務）	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）

連絡人
名稱	Spinpanel 支持
URL	https://help.spinpanel.com
Email	support@spinpanel.com

連接器中繼資料
Publisher	Spinpanel B.V.
網站	https://www.spinpanel.com
隱私策略	https://knowledge.spinpanel.com/en/privacy-policy
類別	企業管理;資訊科技營運

Spinpanel 使組織能夠銷售、部署、管理和自動化 Microsoft 365 和 Azure 解決方案。它提供了有關使用情況、發票數據的詳細見解，並提供直觀的自助服務選項。

先決條件

您將需要以下內容才能繼續：

Spinpanel Cloud Essentials、Cloud Business 或 Cloud Enterprise 訂閱。
在 Spinpanel 中針對您打算使用的特定操作配置的解決方案。
在 Spinpanel 中針對您打算使用的特定作業設定角色。

如何取得認證

您可以使用任何配置為訪問 Spinpanel 的帳戶登錄。針對自動化案例，建議您使用專用服務帳戶。

開始使用連接器

從 [取得組織] 開始，擷取您允許管理的組織清單（包括您自己的組織）。組織會根據 Spinpanel 入口網站中設定的角色範圍傳回。將 ID 用於連續通話。對於需要合作夥伴 ID 的作業，請使用您自己組織中的 ID。針對某些作業，您需要租用戶識別碼，而不是內部 Spinpanel 識別碼，或兩者兼而有之。

已知問題與限制

某些作業需要目標組織具有相符的 Microsoft 365 授權和/或作用中的 Azure 訂用帳戶。例如：設定條件式存取，需要 Microsoft Entra ID 進階版授權。

節流限制

名稱	呼叫	續約期間
每個連線的 API 呼叫	100	60 秒

動作

使用者變更密碼	更新使用者的密碼設定檔以重設其密碼。
列出組織網域	擷取網域物件清單。
刪除 Spinpanel 使用者群組	刪除使用者群組。
刪除使用者	刪除使用者。刪除時，使用者資源會移至暫存容器，並可在 30 天內還原。在此之後，它們將被永久刪除。
取得 Microsoft Entra ID 安全性群組	取得您有權檢視之所有組織的 Microsoft Entra ID 安全性群組清單。
取得 spinpanel 使用者群組	取得您有權檢視的所有組織的群組清單。
取得使用者授權詳細資料	擷取企業使用者的授權詳細資料物件清單。
取得使用者詳細資料	依 Microsoft 物件識別碼取得使用者。
取得地區設定	取得地區設定。
取得組織	取得您有權檢視的所有組織。
取得組織訂閱的 SKU	取得組織已取得的商業訂用帳戶清單。
取得訂閱	依合作夥伴客戶的 Microsoft Entra ID 租用戶識別碼擷取其所有訂用帳戶。
將成員新增至使用者群組	將成員新增至使用者群組，該成員應與群組屬於同一組織。
將成員新增至群組	透過成員導覽屬性，將成員新增至 Microsoft 365 群組或安全性群組。
將授權指派給使用者	新增或移除使用者的授權。您也可以啟用和停用與授權相關聯的特定方案。
建立 Microsoft Entra ID 群組	建立 Microsoft Entra ID 群組。
建立使用者	要求內文包含要建立的使用者。您至少必須為使用者指定必要的內容。您可以選擇性地指定任何其他可寫入的內容。
從使用者群組中移除成員	移除使用者群組的成員。
更新訂閱數量	更新訂閱的數量。
獲取 Spinpanel 用戶組成員列表	取得特定群組的使用者群組成員清單。
獲取用戶	擷取使用者物件清單。
移除成員	透過成員導覽屬性從群組中移除成員。

使用者變更密碼

作業識別碼：: PatchGraphUserPassword

更新使用者的密碼設定檔以重設其密碼。

參數

名稱	機碼	必要	類型	Description
Spinpanel 組織 ID。	organizationId	True	string	Spinpanel 組織識別碼。
使用者的 Microsoft 物件識別碼。	microsoftObjectId	True	string	使用者的 Microsoft 物件識別碼。
在登入時強制變更密碼	forceChangePasswordNextSignIn		boolean	強制使用者在下次登入時變更密碼。
密碼	password		string	要設定的新密碼。

列出組織網域

作業識別碼：: GetGraphDomains

擷取網域物件清單。

參數

名稱	機碼	必要	類型	Description
Spinpanel 組織 ID。	organizationId	True	string	Spinpanel 組織識別碼。

傳回

名稱	路徑	類型	Description
value	value	array of object	價。
驗證類型	value.authenticationType	string	網域的驗證類型。
可用性狀態	value.availabilityStatus	string	網域的可用性狀態。
Id	value.id	string	網域的識別碼。
管理員管理	value.isAdminManaged	boolean	指出網域是否由管理員管理。
預設	value.isDefault	boolean	指出這是否是預設網域。
初	value.isInitial	boolean	指出這是否是初始網域。
根	value.isRoot	boolean	指出這是否為根網域。
已驗證	value.isVerified	boolean	指出網域是否已驗證。
支援服務	value.supportedServices	array of string	支援的服務。
密碼有效性	value.passwordValidityPeriodInDays	integer	指出密碼有效期（以天為單位）。
密碼通知視窗	value.passwordNotificationWindowInDays	integer	指出密碼通知時段（以天為單位）。
State	value.state	string	網域狀態。

刪除 Spinpanel 使用者群組

作業識別碼：: DeleteUserGroup

刪除使用者群組。

參數

名稱	機碼	必要	類型	Description
Spinpanel 組織 ID。	organizationId	True	string	Spinpanel 組織識別碼。
使用者群組的 Spinpanel 識別碼。	userGroupId	True	string	使用者群組的 Spinpanel 識別碼。

刪除使用者

作業識別碼：: DeleteGraphUser

刪除使用者。刪除時，使用者資源會移至暫存容器，並可在 30 天內還原。在此之後，它們將被永久刪除。

參數

名稱	機碼	必要	類型	Description
Spinpanel 組織 ID。	organizationId	True	string	Spinpanel 組織識別碼。
使用者的 Microsoft 物件識別碼。	microsoftObjectId	True	string	使用者的 Microsoft 物件識別碼。

取得 Microsoft Entra ID 安全性群組

作業識別碼：: GetADSecurityGroups

取得您有權檢視之所有組織的 Microsoft Entra ID 安全性群組清單。

參數

名稱	機碼	必要	類型	Description
Spinpanel 組織 ID。	organizationId	True	string	Spinpanel 組織識別碼。

傳回

名稱	路徑	類型	Description
value	value	array of object	價。
建立時間	value.createdDateTime	string	創建於。
顯示名稱	value.displayName	string	顯示名稱。
群組類型	value.groupTypes	array of string	群組類型。
Id	value.id	string	群組的 Microsoft 物件識別碼。
已啟用安全性	value.securityEnabled	boolean	指出群組是否已啟用安全性。
郵件	value.mail	string	群組的電子郵件地址。

取得 spinpanel 使用者群組

作業識別碼：: GetGroups

取得您有權檢視的所有組織的群組清單。

傳回

名稱	路徑	類型	Description
Count	@odata.count	integer	OData 計數。
value	value	array of object	價。
組織識別碼	value.organizationId	string	Spinpanel 組織識別碼。
名稱	value.name	string	群組的名稱。
Description	value.description	string	群組的描述。
Id	value.id	string	群組的識別碼。
建立時間	value.createdOn	string	創建於。
修改時間	value.modifiedOn	string	修改於。

取得使用者授權詳細資料

作業識別碼：: GetUserLicenseDetails

擷取企業使用者的授權詳細資料物件清單。

參數

名稱	機碼	必要	類型	Description
Spinpanel 組織 ID。	organizationId	True	string	Spinpanel 組織識別碼。
使用者的 Microsoft 物件識別碼。	microsoftObjectId	True	string	使用者的 Microsoft 物件識別碼。

傳回

名稱	路徑	類型	Description
value	value	array of object	價。
Id	value.id	string	使用者授權的識別碼。
存貨單位 ID	value.skuId	string	Microsoft 授權的 SKU 識別碼。
SKU 零件編號	value.skuPartNumber	string	Microsoft授權的 SKU 零件編號。
服務計劃	value.servicePlans	array of object	服務計劃。
servicePlanId	value.servicePlans.servicePlanId	string	Serviceplan 識別碼。
servicePlanName	value.servicePlans.servicePlanName	string	服務計劃名稱。
provisioning狀態	value.servicePlans.provisioningStatus	string	佈建狀態。
應用到	value.servicePlans.appliesTo	string	適用於。

取得使用者詳細資料

作業識別碼：: GetGraphUser

依 Microsoft 物件識別碼取得使用者。

參數

名稱	機碼	必要	類型	Description
Spinpanel 組織 ID。	organizationId	True	string	Spinpanel 組織識別碼。
使用者的 Microsoft 物件識別碼。	microsoftObjectId	True	string	使用者的 Microsoft 物件識別碼。

傳回

名稱	路徑	類型	Description
帳戶已啟用	accountEnabled	boolean	已啟用帳戶 true 或 false。
員工編號	employeeId	string	使用者的員工識別碼。
顯示名稱	displayName	string	使用者的顯示名稱。
名字	givenName	string	使用者的名稱。
Surname	surname	string	使用者的姓氏。
使用者主體名稱	userPrincipalName	string	使用者的使用者主體名稱。
職稱	jobTitle	string	使用者的職稱。
部門	department	string	用戶部門。
公司名稱	companyName	string	使用者的公司名稱。
使用地點	usageLocation	string	使用者的使用位置。
街道地址	streetAddress	string	使用者的街道地址。
城市	city	string	使用者的城市。
State	state	string	使用者的狀態。
郵遞區號	postalCode	string	用戶的郵遞區號。
國家	country	string	用戶的國家/地區。

取得地區設定

作業識別碼：: GetLocales

取得地區設定。

傳回

名稱	路徑	類型	Description
OData 內容	@odata.context	string	OData 內容。
Count	@odata.count	integer	OData 計數。
OData next連結	@odata.nextLink	string	OData nextlink 的連結。
value	value	array of object	價。
Id	value.id	string	地區設定識別碼。
地區設定代碼	value.localeCode	string	ISO-639 語言代碼。
國家代碼	value.countryCode	string	ISO-3166 國家代碼。
國家/地區名稱	value.countryName	string	國家/地區名稱。

取得組織

作業識別碼：: GetOrganizations

取得您有權檢視的所有組織。

傳回

名稱	路徑	類型	Description
OData 計數	@odata.count	integer	OData 計數。
value	value	array of object	價。
名稱	value.name	string	Microsoft Entra ID 組織的名稱。
Microsoft 租戶識別碼	value.microsoftTenantId	string	組織的 Microsoft 租用戶識別碼。
建立時間	value.createdOn	string	創建於。
修改時間	value.modifiedOn	string	修改於。
Id	value.id	string	Spinpanel 識別碼。

取得組織訂閱的 SKU

作業識別碼：: GetsubscribedSkus

取得組織已取得的商業訂用帳戶清單。

參數

名稱	機碼	必要	類型	Description
Spinpanel 組織 ID。	organizationId	True	string	Spinpanel 組織識別碼。

傳回

名稱	路徑	類型	Description
value	value	array of object	價。
功能狀態	value.capabilityStatus	string	Microsoft SKU 的功能狀態。
消耗的單位	value.consumedUnits	integer	此 SKU 的消耗單位。
Id	value.id	string	訂閱 sku 物件的識別碼。
存貨單位 ID	value.skuId	string	Microsoft 授權的 SKU 識別碼。
SKU 零件編號	value.skuPartNumber	string	Microsoft授權的 SKU 零件編號。
適用對象	value.appliesTo	string	適用於使用者或組織。
已啟用	value.prepaidUnits.enabled	integer	已啟用已訂閱的 SKU。
暫止	value.prepaidUnits.suspended	integer	已暫停訂閱的 SKU。
警告	value.prepaidUnits.warning	integer	訂閱了帶有警告的 SKU。
服務計劃	value.servicePlans	array of object	服務計劃。
servicePlanId	value.servicePlans.servicePlanId	string	Serviceplan 識別碼。
servicePlanName	value.servicePlans.servicePlanName	string	服務計劃名稱。
provisioning狀態	value.servicePlans.provisioningStatus	string	佈建狀態。
應用到	value.servicePlans.appliesTo	string	適用於。

取得訂閱

作業識別碼：: GetSubscriptions

依合作夥伴客戶的 Microsoft Entra ID 租用戶識別碼擷取其所有訂用帳戶。

參數

名稱	機碼	必要	類型	Description
Spinpanel 合作夥伴識別碼。	partnerId	True	string	Spinpanel 合作夥伴識別碼。
Spinpanel 客戶識別碼。	customerId	True	string	Spinpanel 客戶識別碼。
客戶的 Microsoft 租用戶識別碼。	tenantId	True	string	客戶的 Microsoft 租用戶識別碼。

傳回

名稱	路徑	類型	Description
總計數	totalCount	integer	訂閱物件的總計數。
items	items	array of object	項目。
Id	items.id	string	訂用帳戶的識別碼。
權利識別碼	items.entitlementId	string	訂閱的權利識別碼。
友善名稱	items.friendlyName	string	訂用帳戶的易記名稱。
數量	items.quantity	integer	訂閱數量。
單位類型	items.unitType	string	訂閱的單位類型。
建立時間	items.creationDate	string	在訂閱日期建立。
有效開始日期	items.effectiveStartDate	string	訂用帳戶的生效開始日期。
承諾結束日期	items.commitmentEndDate	string	訂閱的承諾結束日期。
地位	items.status	string	訂用帳戶的狀態。
自動更新	items.autoRenewEnabled	boolean	指出是否已為訂閱啟用自動續約。
帳單類型	items.billingType	string	訂用帳戶的計費類型。
合約類型	items.contractType	string	訂用帳戶的合約類型。
Uri	items.links.offer.uri	string	訂用帳戶的 URI。
方法	items.links.offer.method	string	訂閱方法。
headers	items.links.offer.headers	array of	標頭。
Uri	items.links.self.uri	string	訂用帳戶的 URI。
方法	items.links.self.method	string	訂閱方法。
headers	items.links.self.headers	array of	標頭。
訂單編號	items.orderId	string	訂用帳戶的訂單識別碼。
電子標籤	items.attributes.etag	string	訂閱的 etag。
物件類型	items.attributes.objectType	string	訂閱的物件類型。
物件類型	attributes.objectType	string	訂閱的物件類型。

將成員新增至使用者群組

作業識別碼：: PostUserGroupMember

將成員新增至使用者群組，該成員應與群組屬於同一組織。

參數

名稱	機碼	必要	類型	Description
Spinpanel 組織 ID。	organizationId	True	string	Spinpanel 組織識別碼。
Spinpanel 使用者群組 ID。	userGroupId	True	string	Spinpanel 使用者群組識別碼。
Spinpanel 使用者 ID。	userId	True	string	Spinpanel 使用者識別碼。

將成員新增至群組

作業識別碼：: AddGraphGroupMember

透過成員導覽屬性，將成員新增至 Microsoft 365 群組或安全性群組。

參數

名稱	機碼	必要	類型	Description
Spinpanel 組織 ID。	organizationId	True	string	Spinpanel 組織識別碼。
群組的 Microsoft 物件識別碼。	microsoftObjectId	True	string	群組的 Microsoft 物件識別碼。
會員	@odata.id	True	string	要新增的目錄、使用者、群組或組織連絡人物件的 URI。

將授權指派給使用者

作業識別碼：: PostUserLicense

新增或移除使用者的授權。您也可以啟用和停用與授權相關聯的特定方案。

參數

名稱	機碼	必要	類型	Description
Spinpanel 組織 ID。	organizationId	True	string	Spinpanel 組織識別碼。
使用者的 Microsoft 物件識別碼。	microsoftObjectId	True	string	使用者的 Microsoft 物件識別碼。
disabledPlans	disabledPlans		array of	殘疾人計劃。
存貨單位 ID	skuId		string	Microsoft 授權的 SKU 識別碼。
移除授權	removeLicenses		array of	識別要移除的授權的 GUID 集合。

傳回

名稱	路徑	類型	Description
value	value	array of object	價。
Id	value.id	string	授權物件的識別碼。
存貨單位 ID	value.skuId	string	Microsoft SKU 識別碼。
SKU 零件編號	value.skuPartNumber	string	Microsoft Sku 零件編號。
服務計劃	value.servicePlans	array of object	服務計劃。
servicePlanId	value.servicePlans.servicePlanId	string	Serviceplan 識別碼。
servicePlanName	value.servicePlans.servicePlanName	string	服務計劃名稱。
provisioning狀態	value.servicePlans.provisioningStatus	string	佈建狀態。
應用到	value.servicePlans.appliesTo	string	適用於。

建立 Microsoft Entra ID 群組

作業識別碼：: PostGraphGroup

建立 Microsoft Entra ID 群組。

參數

名稱	機碼	必要	類型	Description
Spinpanel 組織 ID。	organizationId	True	string	Spinpanel 組織識別碼。
Description	description		string	群組描述。
顯示名稱	displayName		string	群組的顯示名稱。
群組類型	groupTypes		array of string	群組類型。
已啟用郵件	mailEnabled		boolean	指出群組是否已啟用郵件。
郵件暱稱	mailNickname		string	群組的郵件暱稱。
已啟用安全性	securityEnabled		boolean	指出群組是否已啟用安全性。

傳回

名稱	路徑	類型	Description
Id	id	string	群組的識別碼。
刪除於	deletedDateTime	string	刪除於。
Classification	classification	string	組的分類。
建立時間	createdDateTime	string	創建於。
創建選項	creationOptions	array of string	建立選項。
Description	description	string	Description.
顯示名稱	displayName	string	顯示名稱。
群組類型	groupTypes	array of string	群組類型
郵件	mail	string	群組的電子郵件地址。
已啟用郵件	mailEnabled	boolean	表示群組已啟用郵件。
郵件暱稱	mailNickname	string	群組的郵件暱稱。
內部部署上次同步處理	onPremisesLastSyncDateTime	string	指出群組同步至內部部署的時間。
內部部署安全識別碼	onPremisesSecurityIdentifier	string	群組的內部部署安全性識別碼。
已啟用內部部署同步	onPremisesSyncEnabled	string	指出是否已啟用內部部署同步。
偏好的資料位置	preferredDataLocation	string	群組的偏好資料位置。
代理地址	proxyAddresses	array of string	代理位址。
更新	renewedDateTime	string	群組的更新日期時間。
resourceBehaviorOptions	resourceBehaviorOptions	array of string	資源行為選項。
resourceProvisioning選項	resourceProvisioningOptions	array of string	資源提供選項。
已啟用安全性	securityEnabled	boolean	指出群組是否已啟用安全性。
可見度	visibility	string	群組的可見性。
onPremisesProvisioningErrors	onPremisesProvisioningErrors	array of string	內部部署佈建錯誤。

建立使用者

作業識別碼：: PostGraphUser

要求內文包含要建立的使用者。您至少必須為使用者指定必要的內容。您可以選擇性地指定任何其他可寫入的內容。

參數

名稱	機碼	必要	類型	Description
Spinpanel 組織 ID。	organizationId	True	string	Spinpanel 組織識別碼。
帳戶已啟用	accountEnabled		boolean	已啟用帳戶 true 或 false。
顯示名稱	displayName		string	使用者的顯示名稱。
郵件暱稱	mailNickname		string	使用者的郵件暱稱。
使用者主體名稱	userPrincipalName		string	使用者的使用者主體名稱。
下次登入強制變更密碼	forceChangePasswordNextSignIn		boolean	強制使用者在下次登入時變更密碼。
密碼	password		string	使用者的新密碼。

傳回

名稱	路徑	類型	Description
OData 內容	@odata.context	string	OData 內容。
Id	id	string	Spinpanel 識別碼。
商務電話	businessPhones	array of string	用戶的商務電話。
顯示名稱	displayName	string	使用者的顯示名稱。
名字	givenName	string	名。
職稱	jobTitle	string	使用者的職稱。
郵件	mail	string	使用者的電子郵件地址。
行動電話	mobilePhone	string	用戶的手機號碼。
辦公地點	officeLocation	string	使用者的辦公室位置。
首選語言	preferredLanguage	string	Microsoft Entra ID 中設定的慣用語言。
Surname	surname	string	使用者的姓氏。
使用者主體名稱	userPrincipalName	string	使用者的使用者主體名稱。

從使用者群組中移除成員

作業識別碼：: DeleteUserGroupMember

移除使用者群組的成員。

參數

名稱	機碼	必要	類型	Description
Spinpanel 組織 ID。	organizationId	True	string	Spinpanel 組織識別碼。
Spinpanel 使用者群組 ID。	userGroupId	True	string	Spinpanel 使用者群組識別碼。
Spinpanel 使用者 ID。	userId	True	string	Spinpanel 使用者識別碼。

更新訂閱數量

作業識別碼：: PatchSubscriptionQuantity

更新訂閱的數量。

參數

名稱	機碼	必要	類型	Description
Spinpanel 合作夥伴識別碼。	partnerId	True	string	Spinpanel 合作夥伴識別碼。
Spinpanel 客戶 ID。	customerId	True	string	Spinpanel 客戶識別碼。
客戶的 Microsoft 租用戶識別碼。	tenantId	True	string	客戶的 Microsoft 租用戶識別碼。
訂閱 ID。	subscriptionId	True	string	客戶的訂閱識別碼。
數量	quantity		integer	訂閱數量。

獲取 Spinpanel 用戶組成員列表

作業識別碼：: UserGroupMembers

取得特定群組的使用者群組成員清單。

參數

名稱	機碼	必要	類型	Description
Spinpanel 組織 ID。	organizationId	True	string	Spinpanel 組織識別碼。
群組的 Spinpanel 識別碼。	userGroupId	True	string	群組的 Spinpanel 識別碼。

傳回

名稱	路徑	類型	Description
Count	@odata.count	integer	OData 計數。
value	value	array of object	價。
名稱	value.name	string	名稱.
使用者主體名稱	value.upn	string	群組的使用者主體名稱。
Id	value.id	string	群組成員物件的識別碼。
群組識別碼	value.groupId	string	群組的 Spinpanel 識別碼。
建立時間	value.createdOn	string	創建於。
修改時間	value.modifiedOn	string	修改於。

獲取用戶

作業識別碼：: GetUsers

擷取使用者物件清單。

參數

名稱	機碼	必要	類型	Description
篩選使用者。	$filter	True	string	篩選組織中的使用者。使用：organizationId in （'{organizationId}'）。

傳回

名稱	路徑	類型	Description
OData 計數	@odata.count	integer	OData 計數。
value	value	array of object	價。
組織標識碼	value.organizationId	string	Spinpanel 組織識別碼。
Microsoft 物件識別碼	value.microsoftObjectIdentifier	string	使用者的 Microsoft 物件識別碼。
使用者主體名稱	value.upn	string	使用者的使用者主體名稱。
名字	value.firstName	string	使用者的名字。
姓氏	value.lastName	string	使用者的姓氏。
顯示名稱	value.displayName	string	使用者的顯示名稱。
語言	value.language	string	使用者的語言。
使用位置	value.usageLocation	string	使用者的使用位置。
Id	value.id	string	使用者的 Spinpanel 識別碼。
創建日期	value.createdOn	string	建立日期。
修改時間	value.modifiedOn	string	修改於。

移除成員

作業識別碼：: RemoveGraphGroupMember

透過成員導覽屬性從群組中移除成員。

參數

名稱	機碼	必要	類型	Description
Spinpanel 組織 ID。	organizationId	True	string	Spinpanel 組織識別碼。
群組的 Microsoft 物件識別碼。	groupMicrosoftObjectId	True	string	群組的 Microsoft 物件識別碼。
使用者的 Microsoft 物件識別碼。	userMicrosoftObjectId	True	string	使用者的 Microsoft 物件識別碼。

共用方式為