Service Principal Entitlements - Update Service Principal Entitlements
Edit hak (Lisensi, Ekstensi, Proyek, Teams, dll) untuk satu atau beberapa perwakilan layanan.
PATCH https://vsaex.dev.azure.com/{organization}/_apis/serviceprincipalentitlements?api-version=7.1-preview.1
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
organization
|
path | True |
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
Media Types: "application/json-patch+json"
Nama | Jenis | Deskripsi |
---|---|---|
from |
string |
Jalur untuk menyalin dari untuk operasi Pindahkan/Salin. |
op |
Operasi patch |
|
path |
string |
Jalur untuk operasi. Dalam kasus array, indeks berbasis nol dapat digunakan untuk menentukan posisi dalam array (misalnya /biskuit/0/name). Karakter "-" dapat digunakan alih-alih indeks untuk disisipkan di akhir array (misalnya /biskuit/-). |
value |
object |
Nilai untuk operasi. Ini adalah primitif atau JToken. |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
200 OK |
operasi berhasil |
Keamanan
oauth2
Type:
oauth2
Flow:
accessCode
Authorization URL:
https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL:
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
Scopes
Nama | Deskripsi |
---|---|
vso.memberentitlementmanagement_write | Memberikan kemampuan untuk mengelola pengguna, lisensi mereka serta proyek dan ekstensi yang dapat mereka akses |
Contoh
Sample Request
PATCH https://vsaex.dev.azure.com/{organization}/_apis/serviceprincipalentitlements?api-version=7.1-preview.1
[
{
"from": "",
"op": "replace",
"path": "/ed82811a-0890-6f7f-813e-69dd9ebd5ba3/accessLevel",
"value": {
"accountLicenseType": "express",
"licensingSource": "account"
}
},
{
"from": "",
"op": "remove",
"path": "/ed82811a-0890-6f7f-813e-69dd9ebd5ba3/projectEntitlements/fca61097-56a1-464f-85ba-1b126cf02cd1",
"value": ""
},
{
"from": "",
"op": "add",
"path": "/ed82811a-0890-6f7f-813e-69dd9ebd5ba3/projectEntitlements/6fa35aad-6755-4dd7-8c69-e13f702af0f9",
"value": {
"group": {
"groupType": "projectAdministrator"
},
"projectRef": {
"id": "6fa35aad-6755-4dd7-8c69-e13f702af0f9"
}
}
},
{
"from": "",
"op": "add",
"path": "",
"value": {
"accessLevel": {
"accountLicenseType": "stakeholder"
},
"projectEntitlements": [
{
"group": {
"groupType": "projectAdministrator"
},
"projectRef": {
"id": "fca61097-56a1-464f-85ba-1b126cf02cd1"
}
}
],
"servicePrincipal": {
"origin": "aad",
"originId": "00ed1ce5-4257-4bbd-946e-1b57718e203e",
"subjectKind": "servicePrincipal"
}
}
}
]
Sample Response
{
"id": "cba1141f-6471-437e-8c6c-79a08813f247",
"status": "succeeded",
"haveResultsSucceeded": true,
"completed": true,
"results": [
{
"servicePrincipalId": "ed82811a-0890-6f7f-813e-69dd9ebd5ba3",
"isSuccess": true,
"errors": [],
"result": {
"servicePrincipal": {
"subjectKind": "servicePrincipal",
"applicationId": "d1a24244-f6cc-488b-bca7-42eb10f13c5b",
"metaType": "application",
"directoryAlias": "00ed1ce5-4257-4bbd-946e-1b57718e203e",
"domain": "faab4a73-0db3-4a5e-8e8a-02188f1d3f4b",
"principalName": "00ed1ce5-4257-4bbd-946e-1b57718e203e",
"mailAddress": null,
"origin": "aad",
"originId": "00ed1ce5-4257-4bbd-946e-1b57718e203e",
"displayName": "Service principal",
"_links": {
"self": {
"href": "https://vssps.dev.azure.com/fabrikam/_apis/Graph/ServicePrincipals/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
},
"memberships": {
"href": "https://vssps.dev.azure.com/fabrikam/_apis/Graph/Memberships/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
},
"membershipState": {
"href": "https://vssps.dev.azure.com/fabrikam/_apis/Graph/MembershipStates/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
},
"storageKey": {
"href": "https://vssps.dev.azure.com/fabrikam/_apis/Graph/StorageKeys/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
},
"avatar": {
"href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
}
},
"url": "https://vssps.dev.azure.com/fabrikam/_apis/Graph/ServicePrincipals/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz",
"descriptor": "aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
},
"id": "ed82811a-0890-6f7f-813e-69dd9ebd5ba3",
"accessLevel": {
"licensingSource": "account",
"accountLicenseType": "earlyAdopter",
"msdnLicenseType": "none",
"licenseDisplayName": "Early Adopter",
"status": "pending",
"statusMessage": "",
"assignmentSource": "unknown"
},
"lastAccessedDate": "0001-01-01T00:00:00",
"dateCreated": "0001-01-01T00:00:00",
"projectEntitlements": null,
"groupAssignments": null
}
},
{
"servicePrincipalId": "ed82811a-0890-6f7f-813e-69dd9ebd5ba3",
"isSuccess": true,
"errors": [],
"result": null
},
{
"servicePrincipalId": "ed82811a-0890-6f7f-813e-69dd9ebd5ba3",
"isSuccess": true,
"errors": [],
"result": null
},
{
"servicePrincipalId": "ed82811a-0890-6f7f-813e-69dd9ebd5ba3",
"isSuccess": true,
"errors": [],
"result": {
"servicePrincipal": {
"subjectKind": "servicePrincipal",
"applicationId": "d1a24244-f6cc-488b-bca7-42eb10f13c5b",
"metaType": "application",
"directoryAlias": "00ed1ce5-4257-4bbd-946e-1b57718e203e",
"domain": "faab4a73-0db3-4a5e-8e8a-02188f1d3f4b",
"principalName": "d1a24244-f6cc-488b-bca7-42eb10f13c5b",
"mailAddress": null,
"origin": "aad",
"originId": "00ed1ce5-4257-4bbd-946e-1b57718e203e",
"displayName": "Service principal",
"_links": {
"self": {
"href": "https://vssps.dev.azure.com/fabrikam/_apis/Graph/ServicePrincipals/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
},
"memberships": {
"href": "https://vssps.dev.azure.com/fabrikam/_apis/Graph/Memberships/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
},
"membershipState": {
"href": "https://vssps.dev.azure.com/fabrikam/_apis/Graph/MembershipStates/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
},
"storageKey": {
"href": "https://vssps.dev.azure.com/fabrikam/_apis/Graph/StorageKeys/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
},
"avatar": {
"href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
}
},
"url": "https://vssps.dev.azure.com/fabrikam/_apis/Graph/ServicePrincipals/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz",
"descriptor": "aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
},
"id": "ed82811a-0890-6f7f-813e-69dd9ebd5ba3",
"accessLevel": {
"licensingSource": "account",
"accountLicenseType": "earlyAdopter",
"msdnLicenseType": "none",
"licenseDisplayName": "Early Adopter",
"status": "pending",
"statusMessage": "",
"assignmentSource": "unknown"
},
"lastAccessedDate": "0001-01-01T00:00:00Z",
"dateCreated": "2023-02-08T12:30:21.5692042Z",
"projectEntitlements": [],
"groupAssignments": []
}
}
]
}
Definisi
Nama | Deskripsi |
---|---|
Json |
Model JSON untuk Operasi Patch JSON |
Operation |
Operasi patch |
Operation |
Status operasi saat ini. |
Service |
|
Service |
JsonPatchDocument
Model JSON untuk Operasi Patch JSON
Nama | Jenis | Deskripsi |
---|---|---|
from |
string |
Jalur untuk menyalin dari untuk operasi Pindahkan/Salin. |
op |
Operasi patch |
|
path |
string |
Jalur untuk operasi. Dalam kasus array, indeks berbasis nol dapat digunakan untuk menentukan posisi dalam array (misalnya /biskuit/0/name). Karakter "-" dapat digunakan alih-alih indeks untuk disisipkan di akhir array (misalnya /biskuit/-). |
value |
object |
Nilai untuk operasi. Ini adalah primitif atau JToken. |
Operation
Operasi patch
Nama | Jenis | Deskripsi |
---|---|---|
add |
string |
|
copy |
string |
|
move |
string |
|
remove |
string |
|
replace |
string |
|
test |
string |
OperationStatus
Status operasi saat ini.
Nama | Jenis | Deskripsi |
---|---|---|
cancelled |
string |
Operasi dibatalkan oleh pengguna. |
failed |
string |
Operasi selesai dengan kegagalan. |
inProgress |
string |
Operasi sedang berlangsung. |
notSet |
string |
Operasi tidak memiliki set status. |
queued |
string |
Operasi telah diantrekan. |
succeeded |
string |
Operasi berhasil diselesaikan. |
ServicePrincipalEntitlementOperationReference
Nama | Jenis | Deskripsi |
---|---|---|
completed |
boolean |
Operasi selesai dengan keberhasilan atau kegagalan. |
haveResultsSucceeded |
boolean |
True jika semua operasi berhasil. |
id |
string |
Pengidentifikasi unik untuk operasi. |
pluginId |
string |
Pengidentifikasi unik untuk plugin. |
results |
Daftar hasil untuk setiap operasi. |
|
status |
Status operasi saat ini. |
|
url |
string |
URL untuk mendapatkan objek operasi penuh. |
ServicePrincipalEntitlementOperationResult
Nama | Jenis | Deskripsi |
---|---|---|
errors |
object[] |
Daftar kode kesalahan yang dipasangkan dengan pesan kesalahan yang sesuai. |
isSuccess |
boolean |
Status keberhasilan operasi. |
result |
string |
Menghasilkan properti pemberian izin. Untuk implementasi tertentu, lihat juga: |
servicePrincipalId |
string |
Pengidentifikasi ServicePrincipal yang ditindaklanjuti. |
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk