Condividi tramite


Organizations - Create

Creare un'organizzazione nell'applicazione

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
baseDomain
path True

string

Dominio di base per tutte le richieste di servizio Azure IoT Central.

organizationId
path True

string

ID univoco per l'organizzazione.

Criterio di espressione regolare: ^(?!-)[a-z0-9-]{1,48}[a-z0-9]$

subdomain
path True

string

Sottodominio dell'applicazione.

api-version
query True

string

Versione dell'API chiamata.

Corpo della richiesta

Nome Tipo Descrizione
displayName

string

Nome visualizzato dell'organizzazione.

parent

string

ID dell'elemento padre dell'organizzazione.

Risposte

Nome Tipo Descrizione
200 OK

Organization

Operazione riuscita

Other Status Codes

Error

Risposta di errore ricevuta dal servizio IoT Central.

Intestazioni

x-ms-error-code: string

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

Add or update organization

Esempio di richiesta

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

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

Risposta di esempio

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

Definizioni

Nome Descrizione
Error

Definizione dell'errore di risposta.

ErrorDetails

Informazioni dettagliate sull'errore.

Organization

Definizione dell'organizzazione.

Error

Definizione dell'errore di risposta.

Nome Tipo Descrizione
error

ErrorDetails

Dettagli degli errori per la richiesta corrente.

ErrorDetails

Informazioni dettagliate sull'errore.

Nome Tipo Descrizione
code

string

Codice di errore.

message

string

Dettagli del messaggio di errore.

requestId

string

ID di correlazione per la richiesta corrente.

time

string

Ora in cui la richiesta di errore non è riuscita.

Organization

Definizione dell'organizzazione.

Nome Tipo Descrizione
displayName

string

Nome visualizzato dell'organizzazione.

id

string

ID univoco dell'organizzazione.

parent

string

ID dell'elemento padre dell'organizzazione.