Entra Id Assignments - Update

Serviço:

Communication

Versão da API:

2025-03-02-preview

Atualizações Entra atribuições de acesso em massa.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
endpoint	path	True	string (url)	O recurso de comunicação, por exemplo https://my-resource.communication.azure.com
api-version	query	True	string	Versão da API a invocar.

Corpo do Pedido

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

Name	Tipo	Description
	EntraAssignmentCreateOrUpdateRequest

Respostas

Name	Tipo	Description
200 OK	EntraAssignmentsResponse	Sucesso
204 No Content		Sem conteúdo
Other Status Codes	CommunicationErrorResponse	Erro

Exemplos

Update Assignments

Pedido de amostra

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

Resposta da amostra

Código de estado:

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

Código de estado:

204

Definições

Name	Description
CommunicationError	O erro dos Serviços de Comunicação.
CommunicationErrorResponse	O erro dos Serviços de Comunicação.
EntraAssignment
EntraAssignmentCreateOrUpdateRequest
EntraAssignmentsResponse
EntraPrincipalType

CommunicationError

Object

O erro dos Serviços de Comunicação.

Name	Tipo	Description
code	string	O código de erro.
details	CommunicationError[]	Mais detalhes sobre erros específicos que levaram a esse erro.
innererror	CommunicationError	O erro interno, se houver.
message	string	A mensagem de erro.
target	string	O destino do erro.

CommunicationErrorResponse

Object

O erro dos Serviços de Comunicação.

Name	Tipo	Description
error	CommunicationError	O erro dos Serviços de Comunicação.

EntraAssignment

Object

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

EntraAssignmentCreateOrUpdateRequest

Object

Name	Tipo	Description
clientIds	string[]
principalType	EntraPrincipalType
tenantId	string

EntraAssignmentsResponse

Object

Name	Tipo	Description
nextLink	string
value	EntraAssignment[]

EntraPrincipalType

Enumeração

Valor	Description
user
group
tenant