Freigeben über


Organizations - Create

Erstellen einer organization in der Anwendung

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
baseDomain
path True

string

Die Basisdomäne für alle Azure IoT Central-Dienstanforderungen.

organizationId
path True

string

Eindeutige ID für die organization.

RegEx-Muster: ^(?!-)[a-z0-9-]{1,48}[a-z0-9]$

subdomain
path True

string

Die Unterdomäne der Anwendung.

api-version
query True

string

Die Version der aufgerufenen API.

Anforderungstext

Name Typ Beschreibung
displayName

string

Anzeigename des organization.

parent

string

ID des übergeordneten organization.

Antworten

Name Typ Beschreibung
200 OK

Organization

Erfolg

Other Status Codes

Error

Eine vom IoT Central-Dienst empfangene Fehlerantwort.

Header

x-ms-error-code: string

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

Add or update organization

Beispielanforderung

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

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

Beispiel für eine Antwort

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

Definitionen

Name Beschreibung
Error

Die Antwortfehlerdefinition.

ErrorDetails

Die Detailinformationen des Fehlers.

Organization

Die organization Definition.

Error

Die Antwortfehlerdefinition.

Name Typ Beschreibung
error

ErrorDetails

Fehlerdetails für die aktuelle Anforderung.

ErrorDetails

Die Detailinformationen des Fehlers.

Name Typ Beschreibung
code

string

Fehlercode

message

string

Fehlermeldungsdetails.

requestId

string

Korrelations-ID für die aktuelle Anforderung.

time

string

Der Zeitpunkt, zu dem bei der Fehleranforderung ein Fehler aufgetreten ist.

Organization

Die organization Definition.

Name Typ Beschreibung
displayName

string

Anzeigename des organization.

id

string

Eindeutige ID des organization.

parent

string

ID des übergeordneten organization.