共用方式為


Organizations - Create

在應用程式中建立組織

PUT https://{subdomain}.{baseDomain}/api/organizations/{organizationId}?api-version=2022-07-31

URI 參數

名稱 位於 必要 類型 Description
baseDomain
path True

string

所有 Azure IoT Central 服務要求的基底網域。

organizationId
path True

string

組織的唯一標識碼。

Regex 模式: ^(?!-)[a-z0-9-]{1,48}[a-z0-9]$

subdomain
path True

string

應用程式子域。

api-version
query True

string

所呼叫 API 的版本。

要求本文

名稱 類型 Description
displayName

string

組織的顯示名稱。

parent

string

組織的父代標識碼。

回應

名稱 類型 Description
200 OK

Organization

Success

Other Status Codes

Error

從 IoT Central 服務收到的錯誤回應。

標題

x-ms-error-code: string

安全性

azure_auth

Azure Active Directory OAuth2 Flow

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱 Description
user_impersonation 模擬您的用戶帳戶

範例

Add or update organization

範例要求

PUT https://appsubdomain.azureiotcentral.com/api/organizations/seattle?api-version=2022-07-31

{
  "displayName": "Seattle",
  "parent": "washington"
}

範例回覆

{
  "id": "seattle",
  "displayName": "Seattle",
  "parent": "washington"
}

定義

名稱 Description
Error

回應錯誤定義。

ErrorDetails

錯誤的詳細資訊。

Organization

組織定義。

Error

回應錯誤定義。

名稱 類型 Description
error

ErrorDetails

目前要求的錯誤詳細數據。

ErrorDetails

錯誤的詳細資訊。

名稱 類型 Description
code

string

錯誤碼。

message

string

錯誤訊息詳細數據。

requestId

string

目前要求的相互關聯標識碼。

time

string

錯誤要求失敗的時間。

Organization

組織定義。

名稱 類型 Description
displayName

string

組織的顯示名稱。

id

string

組織的唯一標識碼。

parent

string

組織的父代標識碼。