Entra Id Assignments - Update

Servizio:

Communication

Versione API:

2025-03-02-preview

Aggiorna le assegnazioni di accesso Entra in blocco.

PATCH {endpoint}/access/entra/assignments?api-version=2025-03-02-preview

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
endpoint	path	True	string (url)	Risorsa di comunicazione, ad esempio https://my-resource.communication.azure.com
api-version	query	True	string	Versione dell'API da richiamare.

Corpo della richiesta

Media Types: "application/merge-patch+json"

Nome	Tipo	Descrizione
	EntraAssignmentCreateOrUpdateRequest

Risposte

Nome	Tipo	Descrizione
200 OK	EntraAssignmentsResponse	Successo
204 No Content		Nessun contenuto
Other Status Codes	CommunicationErrorResponse	Errore

Esempio

Update Assignments

Esempio di richiesta

HTTP

PATCH https://my-resource.communication.azure.com/access/entra/assignments?api-version=2025-03-02-preview

{
  "b27b64b9-39d2-44a3-869d-67700b74e805": {
    "tenantId": "c70d068c-2f32-484d-9455-73070cd5aadd",
    "principalType": "user",
    "clientIds": [
      "617d08b5-f35b-4270-87d6-56833d2dee1b"
    ]
  },
  "eaf4bdca-9343-492B-a5e2-9310fbe393b8": null,
  "fd63f3cb-3731-4d15-8e47-9d062aba58c5": {
    "tenantId": "c70d068c-2f32-484d-9455-73070cd5aadd",
    "principalType": "user",
    "clientIds": [
      "617d08b5-f35b-4270-87d6-56833d2dee1b"
    ]
  }
}

Risposta di esempio

Codice di stato:

200

{
  "value": [
    {
      "objectId": "b27b64b9-39d2-44a3-869d-67700b74e805",
      "tenantId": "c70d068c-2f32-484d-9455-73070cd5aadd",
      "principalType": "user",
      "clientIds": [
        "617d08b5-f35b-4270-87d6-56833d2dee1b"
      ]
    },
    {
      "objectId": "fd63f3cb-3731-4d15-8e47-9d062aba58c5",
      "tenantId": "c70d068c-2f32-484d-9455-73070cd5aadd",
      "principalType": "user",
      "clientIds": [
        "617d08b5-f35b-4270-87d6-56833d2dee1b"
      ]
    }
  ]
}

Codice di stato:

204

Definizioni

Nome	Descrizione
CommunicationError	Errore di Servizi di comunicazione.
CommunicationErrorResponse	Errore di Servizi di comunicazione.
EntraAssignment
EntraAssignmentCreateOrUpdateRequest
EntraAssignmentsResponse
EntraPrincipalType

CommunicationError

Object

Errore di Servizi di comunicazione.

Nome	Tipo	Descrizione
code	string	Codice di errore.
details	CommunicationError[]	Altri dettagli sugli errori specifici che hanno causato questo errore.
innererror	CommunicationError	Errore interno, se presente.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

CommunicationErrorResponse

Object

Errore di Servizi di comunicazione.

Nome	Tipo	Descrizione
error	CommunicationError	Errore di Servizi di comunicazione.

EntraAssignment

Object

Nome	Tipo	Descrizione
clientIds	string[]
objectId	string
principalType	EntraPrincipalType
tenantId	string

EntraAssignmentCreateOrUpdateRequest

Object

Nome	Tipo	Descrizione
clientIds	string[]
principalType	EntraPrincipalType
tenantId	string

EntraAssignmentsResponse

Object

Nome	Tipo	Descrizione
nextLink	string
value	EntraAssignment[]

EntraPrincipalType

Enumerazione

Valore	Descrizione
user
group
tenant