Entra Id Assignments - Update

Service:

Communication

Version d'API:

2025-03-02-preview

Met à jour les attributions d’accès Entra en bloc.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
endpoint	path	True	string (url)	Ressource de communication, par exemple https://my-resource.communication.azure.com
api-version	query	True	string	Version de l’API à appeler.

Corps de la demande

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

Nom	Type	Description
	EntraAssignmentCreateOrUpdateRequest

Réponses

Nom	Type	Description
200 OK	EntraAssignmentsResponse	Succès
204 No Content		Aucun contenu
Other Status Codes	CommunicationErrorResponse	Erreur

Exemples

Update Assignments

Exemple de requête

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"
    ]
  }
}

Exemple de réponse

Code d’état:

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"
      ]
    }
  ]
}

Code d’état:

204

Définitions

Nom	Description
CommunicationError	Erreur Communication Services.
CommunicationErrorResponse	Erreur Communication Services.
EntraAssignment
EntraAssignmentCreateOrUpdateRequest
EntraAssignmentsResponse
EntraPrincipalType

CommunicationError

Object

Erreur Communication Services.

Nom	Type	Description
code	string	Code d’erreur.
details	CommunicationError[]	Plus d’informations sur les erreurs spécifiques qui ont conduit à cette erreur.
innererror	CommunicationError	Erreur interne le cas échéant.
message	string	Message d’erreur.
target	string	Cible d’erreur.

CommunicationErrorResponse

Object

Erreur Communication Services.

Nom	Type	Description
error	CommunicationError	Erreur Communication Services.

EntraAssignment

Object

Nom	Type	Description
clientIds	string[]
objectId	string
principalType	EntraPrincipalType
tenantId	string

EntraAssignmentCreateOrUpdateRequest

Object

Nom	Type	Description
clientIds	string[]
principalType	EntraPrincipalType
tenantId	string

EntraAssignmentsResponse

Object

Nom	Type	Description
nextLink	string
value	EntraAssignment[]

EntraPrincipalType

Énumération

Valeur	Description
user
group
tenant