Questo articolo descrive l'estendibilità dell'API REST per Teams Phone.
Importante
Questa funzionalità di Servizi di comunicazione di Azure è attualmente in anteprima. Le funzionalità in anteprima sono disponibili pubblicamente e possono essere usate da tutti i clienti Microsoft nuovi ed esistenti.
Questa versione di anteprima viene fornita senza contratto di servizio, pertanto se ne sconsiglia l’uso per i carichi di lavoro in ambienti di produzione. Alcune funzionalità potrebbero non essere supportate o potrebbero essere vincolate.
Per altre informazioni, vedere le Condizioni supplementari per l'uso delle anteprime di Microsoft Azure.
Creare un'assegnazione
Creare un'assegnazione per concedere a un utente di Teams o a un account risorsa di Teams l'accesso alla risorsa di Servizi di comunicazione.
PUT {endpoint}/access/teamsExtension/tenants/{tenantId}/assignments/{objectId}?api-version=2025-03-02-preview
Parametri URI
| Nome |
In |
Obbligatorio |
TIPO |
Descrizione |
objectId |
sentiero |
vero |
corda |
ID oggetto del principale, ovvero l'ID utente o l'ID dell'account di risorsa. |
tenantId |
sentiero |
vero |
corda |
ID tenant del tenant a cui appartiene l'entità. |
api-version |
quesito |
vero |
corda |
Versione dell'API da richiamare. |
Testo della richiesta
Risposte
Ottenere l'assegnazione
Ottenere l'assegnazione per l'accesso a una risorsa da un utente di Teams o da un account di risorse di Teams.
GET {endpoint}/access/teamsExtension/assignments/{objectId}?api-version=2025-03-02-preview
Parametri URI
| Nome |
In |
Obbligatorio |
TIPO |
Descrizione |
objectId |
sentiero |
vero |
corda |
ID oggetto del principale, ovvero l'ID utente o l'ID dell'account di risorsa. |
Risposte
Elimina assegnazione
Eliminare l'assegnazione per rimuovere l'accesso alle risorse da un utente di Teams o da un account risorsa di Teams.
DELETE {endpoint}/access/teamsExtension/assignments/{objectId}?api-version=2025-03-02-preview
Parametri URI
| Nome |
In |
Obbligatorio |
TIPO |
Descrizione |
objectId |
sentiero |
vero |
corda |
ID oggetto del principale, ovvero l'ID utente o l'ID dell'account di risorsa. |
Risposte
| Nome |
TIPO |
Descrizione |
| 204 NoContent (Nessun contenuto) |
Vuoto |
Codice di stato riuscito. |
| Altri codici di stato |
CommunicationErrorResponse |
Errore. |
Definizioni
ErroreDiComunicazione
| Nome |
TIPO |
Descrizione |
code |
corda |
Codice di errore. |
details |
CommunicationError[] |
Altri dettagli sugli errori specifici che hanno causato questo errore. |
innererror |
CommunicationError |
Errore interno, se presente. |
message |
corda |
Messaggio di errore. |
target |
corda |
Destinazione dell'errore. |
CommunicationErrorResponse
RichiestaDiCreazioneOAggiornamentoTeamsExtensionAssignment
| Nome |
TIPO |
Descrizione |
principalType |
corda |
Tipo dell'entità che accede alla risorsa, "user" o "teamsResourceAccount". |
clientIds |
string[] |
Elenco di ID per le applicazioni tramite cui un'entità "user" può accedere alla risorsa. |
TeamsExtensionAssignmentResponse
| Nome |
TIPO |
Descrizione |
objectId |
corda |
ID oggetto dell'entità dell'assegnazione. |
tenantId |
corda |
ID tenant. |
principalType |
corda |
Tipo dell'entità che accede alla risorsa, "user" o "teamsResourceAccount". |
clientIds |
string[] |
Elenco di ID per le applicazioni tramite cui un'entità "user" può accedere alla risorsa. |
Articoli correlati