Partager via


Organizations - Create

Créer un organization dans l’application

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

Paramètres URI

Nom Dans Obligatoire Type Description
baseDomain
path True

string

Domaine de base pour toutes les demandes de service Azure IoT Central.

organizationId
path True

string

ID unique pour le organization.

Modèle d’expression régulière: ^(?!-)[a-z0-9-]{1,48}[a-z0-9]$

subdomain
path True

string

Sous-domaine d’application.

api-version
query True

string

Version de l’API appelée.

Corps de la demande

Nom Type Description
displayName

string

Nom d’affichage du organization.

parent

string

ID du parent du organization.

Réponses

Nom Type Description
200 OK

Organization

Succès

Other Status Codes

Error

Réponse d’erreur reçue du service IoT Central.

En-têtes

x-ms-error-code: string

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation Emprunter l’identité de votre compte d’utilisateur

Exemples

Add or update organization

Exemple de requête

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

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

Exemple de réponse

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

Définitions

Nom Description
Error

Définition de l’erreur de réponse.

ErrorDetails

Informations détaillées de l’erreur.

Organization

Définition organization.

Error

Définition de l’erreur de réponse.

Nom Type Description
error

ErrorDetails

Détails de l’erreur pour la demande actuelle.

ErrorDetails

Informations détaillées de l’erreur.

Nom Type Description
code

string

Code d’erreur.

message

string

Détails du message d’erreur.

requestId

string

ID de corrélation pour la requête actuelle.

time

string

Heure à laquelle la demande d’erreur a échoué.

Organization

Définition organization.

Nom Type Description
displayName

string

Nom d’affichage du organization.

id

string

ID unique du organization.

parent

string

ID du parent du organization.