Entra Id Assignments - Update

Служба:

Communication

Версия API:

2025-03-02-preview

Массовое обновление назначений доступа к Entra.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
endpoint	path	True	string (url)	Ресурс связи, например https://my-resource.communication.azure.com
api-version	query	True	string	Версия API для вызова.

Текст запроса

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

Имя	Тип	Описание
	EntraAssignmentCreateOrUpdateRequest

Ответы

Имя	Тип	Описание
200 OK	EntraAssignmentsResponse	Успех
204 No Content		Нет содержимого
Other Status Codes	CommunicationErrorResponse	Ошибка

Примеры

Update Assignments

Образец запроса

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

Пример ответа

Код состояния:

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

Код состояния:

204

Определения

Имя	Описание
CommunicationError	Ошибка служб коммуникации.
CommunicationErrorResponse	Ошибка служб коммуникации.
EntraAssignment
EntraAssignmentCreateOrUpdateRequest
EntraAssignmentsResponse
EntraPrincipalType

CommunicationError

Object

Ошибка служб коммуникации.

Имя	Тип	Описание
code	string	Код ошибки.
details	CommunicationError[]	Дополнительные сведения об определенных ошибках, которые привели к этой ошибке.
innererror	CommunicationError	Внутренняя ошибка, если она есть.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

CommunicationErrorResponse

Object

Ошибка служб коммуникации.

Имя	Тип	Описание
error	CommunicationError	Ошибка служб коммуникации.

EntraAssignment

Object

Имя	Тип	Описание
clientIds	string[]
objectId	string
principalType	EntraPrincipalType
tenantId	string

EntraAssignmentCreateOrUpdateRequest

Object

Имя	Тип	Описание
clientIds	string[]
principalType	EntraPrincipalType
tenantId	string

EntraAssignmentsResponse

Object

Имя	Тип	Описание
nextLink	string
value	EntraAssignment[]

EntraPrincipalType

Перечисление

Значение	Описание
user
group
tenant