Entra Id Assignments - Update

Usługa:

Communication

Wersja interfejsu API:

2025-03-02-preview

Zbiorczo aktualizuje przypisania dostępu Entra.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
endpoint	path	True	string (url)	Zasób komunikacji, na przykład https://my-resource.communication.azure.com
api-version	query	True	string	Wersja interfejsu API do wywołania.

Treść żądania

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

Nazwa	Typ	Opis
	EntraAssignmentCreateOrUpdateRequest

Odpowiedzi

Nazwa	Typ	Opis
200 OK	EntraAssignmentsResponse	Powodzenie
204 No Content		Brak zawartości
Other Status Codes	CommunicationErrorResponse	Błąd

Przykłady

Update Assignments

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:

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

Kod stanu:

204

Definicje

Nazwa	Opis
CommunicationError	Błąd usług komunikacyjnych.
CommunicationErrorResponse	Błąd usług komunikacyjnych.
EntraAssignment
EntraAssignmentCreateOrUpdateRequest
EntraAssignmentsResponse
EntraPrincipalType

CommunicationError

Objekt

Błąd usług komunikacyjnych.

Nazwa	Typ	Opis
code	string	Kod błędu.
details	CommunicationError[]	Dalsze szczegółowe informacje o konkretnych błędach, które doprowadziły do tego błędu.
innererror	CommunicationError	Wewnętrzny błąd, jeśli istnieje.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

CommunicationErrorResponse

Objekt

Błąd usług komunikacyjnych.

Nazwa	Typ	Opis
error	CommunicationError	Błąd usług komunikacyjnych.

EntraAssignment

Objekt

Nazwa	Typ	Opis
clientIds	string[]
objectId	string
principalType	EntraPrincipalType
tenantId	string

EntraAssignmentCreateOrUpdateRequest

Objekt

Nazwa	Typ	Opis
clientIds	string[]
principalType	EntraPrincipalType
tenantId	string

EntraAssignmentsResponse

Objekt

Nazwa	Typ	Opis
nextLink	string
value	EntraAssignment[]

EntraPrincipalType

Wyliczanie

Wartość	Opis
user
group
tenant