Roleassignments - Set Role Assignment

Layanan:

Security Roles

Versi API:

7.1-preview.1

Mengatur penetapan peran pada sumber daya

PUT https://dev.azure.com/{organization}/_apis/securityroles/scopes/{scopeId}/roleassignments/resources/{resourceId}/{identityId}?api-version=7.1-preview.1

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
identityId	path	True	string uuid
resourceId	path	True	string	Id sumber daya tempat peran akan ditetapkan
scopeId	path	True	string	Id cakupan yang ditetapkan
organization	path		string	Nama organisasi Azure DevOps.
api-version	query	True	string	Versi API yang akan digunakan. Ini harus diatur ke '7.1-preview.1' untuk menggunakan versi api ini.

Isi Permintaan

Nama	Jenis	Deskripsi
roleName	string	Nama peran yang ditetapkan.
uniqueName	string	Pengidentifikasi pengguna yang diberi penetapan peran.
userId	string	Id unik pengguna yang diberi penetapan peran.

Respons

Nama	Jenis	Deskripsi
200 OK	RoleAssignment	operasi berhasil

Keamanan

oauth2

Jenis: oauth2
Alur: accessCode
URL Otorisasi: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL token: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Cakupan

Nama	Deskripsi
vso.security_manage	Memberikan kemampuan untuk membaca, menulis, dan mengelola izin keamanan.

Definisi

Nama	Deskripsi
IdentityRef
ReferenceLinks	Kelas untuk mewakili kumpulan tautan referensi REST.
RoleAccess	Menunjuk peran sebagai yang ditetapkan atau diwariskan secara eksplisit.
RoleAssignment
SecurityRole
UserRoleAssignmentRef

IdentityRef

Objek

Nama	Jenis	Deskripsi
_links	ReferenceLinks	Bidang ini berisi nol atau lebih tautan menarik tentang subjek grafik. Tautan ini dapat dipanggil untuk mendapatkan hubungan tambahan atau informasi lebih rinci tentang subjek grafik ini.
descriptor	string	Deskriptor adalah cara utama untuk mereferensikan subjek grafik saat sistem berjalan. Bidang ini akan secara unik mengidentifikasi subjek grafik yang sama di seluruh Akun dan Organisasi.
directoryAlias	string	Tidak digunakan lagi - Dapat diambil dengan mengkueri pengguna Graph yang direferensikan dalam entri "mandiri" kamus IdentityRef "_links"
displayName	string	Ini adalah nama tampilan subjek grafik yang tidak unik. Untuk mengubah bidang ini, Anda harus mengubah nilainya di penyedia sumber.
id	string
imageUrl	string	Tidak digunakan lagi - Tersedia dalam entri "avatar" kamus IdentityRef "_links"
inactive	boolean	Tidak digunakan lagi - Dapat diambil dengan mengkueri status keanggotaan Graph yang direferensikan dalam entri "membershipState" dari kamus "_links" GraphUser
isAadIdentity	boolean	Tidak digunakan lagi - Dapat disimpulkan dari jenis subjek deskriptor (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Tidak digunakan lagi - Dapat disimpulkan dari jenis subjek deskriptor (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	Tidak digunakan lagi - tidak digunakan dalam sebagian besar implementasi ToIdentityRef yang sudah ada sebelumnya
uniqueName	string	Tidak digunakan lagi - gunakan Domain+PrincipalName sebagai gantinya
url	string	Url ini adalah rute lengkap ke sumber daya sumber subjek grafik ini.

ReferenceLinks

Objek

Kelas untuk mewakili kumpulan tautan referensi REST.

Nama	Jenis	Deskripsi
links	object	Tampilan baca-saja dari tautan. Karena tautan Referensi bersifat baca-saja, kami hanya ingin mengeksposnya sebagai baca saja.

RoleAccess

Enumeration

Menunjuk peran sebagai yang ditetapkan atau diwariskan secara eksplisit.

Nilai	Deskripsi
assigned	Akses telah diatur secara eksplisit.
inherited	Akses telah diwarisi dari cakupan yang lebih tinggi.

RoleAssignment

Objek

Nama	Jenis	Deskripsi
access	RoleAccess	Menunjuk peran sebagai yang ditetapkan atau diwariskan secara eksplisit.
accessDisplayName	string	Deskripsi penugasan akses yang mudah digunakan.
identity	IdentityRef	Pengguna yang perannya ditetapkan.
role	SecurityRole	Peran yang ditetapkan untuk pengguna.

SecurityRole

Objek

Nama	Jenis	Deskripsi
allowPermissions	integer	Izin peran diizinkan.
denyPermissions	integer	Izin peran ditolak.
description	string	Deskripsi akses pengguna yang ditentukan oleh peran
displayName	string	Nama peran yang ramah pengguna.
identifier	string	Pengidentifikasi unik global untuk peran tersebut.
name	string	Nama unik peran dalam cakupan.
scope	string	Mengembalikan id Dari ParentScope.

UserRoleAssignmentRef

Objek

Nama	Jenis	Deskripsi
roleName	string	Nama peran yang ditetapkan.
uniqueName	string	Pengidentifikasi pengguna yang diberi penetapan peran.
userId	string	Id unik pengguna yang diberi penetapan peran.