Entra Id Assignments - Update

Servicio:

Communication

Versión de la API:

2025-03-02-preview

Actualiza las asignaciones de acceso de Entra de forma masiva.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
endpoint	path	True	string (url)	Recurso de comunicación, por ejemplo, https://my-resource.communication.azure.com
api-version	query	True	string	Versión de la API que se va a invocar.

Cuerpo de la solicitud

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

Nombre	Tipo	Description
	EntraAssignmentCreateOrUpdateRequest

Respuestas

Nombre	Tipo	Description
200 OK	EntraAssignmentsResponse	Éxito
204 No Content		Sin contenido
Other Status Codes	CommunicationErrorResponse	Error

Ejemplos

Update Assignments

Solicitud de ejemplo

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

Respuesta de muestra

status code:

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

status code:

204

Definiciones

Nombre	Description
CommunicationError	Error de Communication Services.
CommunicationErrorResponse	Error de Communication Services.
EntraAssignment
EntraAssignmentCreateOrUpdateRequest
EntraAssignmentsResponse
EntraPrincipalType

CommunicationError

Object

Error de Communication Services.

Nombre	Tipo	Description
code	string	Código de error.
details	CommunicationError[]	Más detalles sobre los errores específicos que llevaron a este error.
innererror	CommunicationError	Error interno si existe.
message	string	El mensaje de error.
target	string	Destino del error.

CommunicationErrorResponse

Object

Error de Communication Services.

Nombre	Tipo	Description
error	CommunicationError	Error de Communication Services.

EntraAssignment

Object

Nombre	Tipo	Description
clientIds	string[]
objectId	string
principalType	EntraPrincipalType
tenantId	string

EntraAssignmentCreateOrUpdateRequest

Object

Nombre	Tipo	Description
clientIds	string[]
principalType	EntraPrincipalType
tenantId	string

EntraAssignmentsResponse

Object

Nombre	Tipo	Description
nextLink	string
value	EntraAssignment[]

EntraPrincipalType

Enumeración

Valor	Description
user
group
tenant