Configurations - Update
İlke yapılandırmasını kimliğine göre güncelleştirin.
PUT https://dev.azure.com/{organization}/{project}/_apis/policy/configurations/{configurationId}?api-version=7.1-preview.1
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
configuration
|
path | True |
integer int32 |
Güncelleştirilecek mevcut ilke yapılandırmasının kimliği. |
organization
|
path | True |
string |
Azure DevOps kuruluşunun adı. |
project
|
path | True |
string |
Proje Kimliği veya proje adı |
api-version
|
query | True |
string |
Kullanılacak API sürümü. Api'nin bu sürümünü kullanmak için bu değer '7.1-preview.1' olarak ayarlanmalıdır. |
İstek Gövdesi
Name | Tür | Description |
---|---|---|
_links |
Bu nesneyle ilgili diğer nesnelerin bağlantıları. |
|
createdBy |
İlkeyi oluşturan kimliğe başvuru. |
|
createdDate |
string |
İlkenin oluşturulduğu tarih ve saat. |
id |
integer |
İlke yapılandırma kimliği. |
isBlocking |
boolean |
İlkenin engellenip engellenmediğini gösterir. |
isDeleted |
boolean |
İlkenin (geçici) silinip silinmediğini gösterir. |
isEnabled |
boolean |
İlkenin etkinleştirilip etkinleştirilmediğini gösterir. |
isEnterpriseManaged |
boolean |
Ayarlanırsa, bu ilke oluşturmak, düzenlemek veya silmek için "Kurumsal İlkeleri Yönetme" izni gerektirir. |
revision |
integer |
İlke yapılandırması düzeltme kimliği. |
settings |
İlke yapılandırma ayarları. |
|
type |
İlke yapılandırma türü. |
|
url |
string |
İlke yapılandırmasının alınabileceği URL. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
başarılı işlem |
Güvenlik
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
Name | Description |
---|---|
vso.code_write | Kaynak kodu okuma, güncelleştirme ve silme, işlemeler, değişiklik kümeleri, dallar ve diğer sürüm denetimi yapıtları hakkındaki meta verilere erişme olanağı verir. Ayrıca çekme istekleri ve kod incelemeleri oluşturup yönetme ve hizmet kancaları aracılığıyla sürüm denetimi olayları hakkında bildirim alma olanağı sağlar. |
Örnekler
Sample Request
PUT https://dev.azure.com/fabrikam/fabrikam-fiber-git/_apis/policy/configurations/17?api-version=7.1-preview.1
{
"isEnabled": true,
"isBlocking": true,
"type": {
"id": "fd2167ab-b0be-447a-8ec8-39368250530e"
},
"settings": {
"requiredReviewerIds": [
"1d1dad71-f27c-4370-810d-838ec41efd41",
"13272ea3-92ef-46d1-b77e-608ebbf3428b"
],
"filenamePatterns": [
"*/API*.cs",
"sql/tables/*"
],
"addedFilesOnly": false,
"scope": [
{
"repositoryId": null,
"refName": "refs/heads/master",
"matchKind": "exact"
},
{
"repositoryId": null,
"refName": "refs/heads/releases/",
"matchKind": "prefix"
},
{
"repositoryId": "49c1d4d0-be28-4f20-9e0a-4ecfafc39257",
"refName": "refs/heads/adventureworks",
"matchKind": "exact"
}
]
}
}
Sample Response
{
"createdBy": {
"id": "d6245f20-2af8-44f4-9451-8107cb2767db",
"displayName": "Normal Paulk",
"uniqueName": "fabrikamfiber16@hotmail.com",
"url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db",
"imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d6245f20-2af8-44f4-9451-8107cb2767db"
},
"createdDate": "2015-02-23T12:51:06.85754Z",
"isEnabled": true,
"isBlocking": true,
"isDeleted": false,
"settings": {
"requiredReviewerIds": [
"1d1dad71-f27c-4370-810d-838ec41efd41",
"13272ea3-92ef-46d1-b77e-608ebbf3428b"
],
"filenamePatterns": [
"*/API*.cs",
"sql/tables/*"
],
"addedFilesOnly": false,
"message": null,
"scope": [
{
"refName": "refs/heads/master",
"matchKind": "Exact",
"repositoryId": null
},
{
"refName": "refs/heads/releases/",
"matchKind": "Prefix",
"repositoryId": null
},
{
"refName": "refs/heads/adventureworks",
"matchKind": "Exact",
"repositoryId": "49c1d4d0-be28-4f20-9e0a-4ecfafc39257"
}
]
},
"_links": {
"self": {
"href": "https://dev.azure.com/fabrikam/_apis/policy/configurations/17"
},
"type": {
"href": "https://dev.azure.com/fabrikam/1be3fc5b-c58c-4173-8fd7-6647d11eccd1/_apis/policy/types/fd2167ab-b0be-447a-8ec8-39368250530e"
}
},
"revision": 2,
"id": 17,
"url": "https://dev.azure.com/fabrikam/_apis/policy/configurations/17",
"type": {
"id": "fd2167ab-b0be-447a-8ec8-39368250530e",
"url": "https://dev.azure.com/fabrikam/1be3fc5b-c58c-4173-8fd7-6647d11eccd1/_apis/policy/types/fd2167ab-b0be-447a-8ec8-39368250530e",
"displayName": "Required reviewers"
}
}
Tanımlar
Name | Description |
---|---|
Identity |
|
JObject |
JSON nesnesini temsil eder. |
Policy |
Ayarlarla tam ilke yapılandırması. |
Policy |
İlke türü başvurusu. |
Reference |
REST başvuru bağlantıları koleksiyonunu temsil eden sınıf. |
IdentityRef
Name | Tür | Description |
---|---|---|
_links |
Bu alan, grafik konusu hakkında sıfır veya daha fazla ilgi çekici bağlantı içerir. Bu bağlantılar, bu grafik konusu hakkında daha fazla ilişki veya daha ayrıntılı bilgi edinmek için çağrılabilir. |
|
descriptor |
string |
Tanımlayıcı, sistem çalışırken graf konusuna başvurmanın birincil yoludur. Bu alan, hem Hesaplar hem de Kuruluşlar genelinde aynı graf konusunu benzersiz olarak tanımlar. |
directoryAlias |
string |
Kullanım dışı - IdentityRef "_links" sözlüğündeki "self" girişinde başvuruda bulunılan Graph kullanıcısı sorgulanarak alınabilir |
displayName |
string |
Bu, grafik konusunun benzersiz olmayan görünen adıdır. Bu alanı değiştirmek için kaynak sağlayıcıdaki değerini değiştirmeniz gerekir. |
id |
string |
|
imageUrl |
string |
Kullanım dışı - IdentityRef "_links" sözlüğün "avatar" girişinde kullanılabilir |
inactive |
boolean |
Kullanım dışı - GraphUser "_links" sözlüğün "membershipState" girişinde başvurulan Graph üyelik durumu sorgulanarak alınabilir |
isAadIdentity |
boolean |
Kullanım dışı - Tanımlayıcının konu türünden çıkarılabilir (Descriptor.IsAadUserType/Descriptor.IsAadGroupType) |
isContainer |
boolean |
Kullanım dışı - Tanımlayıcının konu türünden çıkarılabilir (Descriptor.IsGroupType) |
isDeletedInOrigin |
boolean |
|
profileUrl |
string |
Kullanım dışı - ToIdentityRef'in önceden var olan uygulamalarının çoğunda kullanımda değil |
uniqueName |
string |
Kullanım dışı - bunun yerine Domain+PrincipalName kullanın |
url |
string |
Bu URL, bu grafik konusunun kaynak kaynağına giden tam yoldur. |
JObject
JSON nesnesini temsil eder.
Name | Tür | Description |
---|---|---|
item |
string |
|
type |
string |
Bu JToken için düğüm türünü alır. |
PolicyConfiguration
Ayarlarla tam ilke yapılandırması.
Name | Tür | Description |
---|---|---|
_links |
Bu nesneyle ilgili diğer nesnelerin bağlantıları. |
|
createdBy |
İlkeyi oluşturan kimliğe başvuru. |
|
createdDate |
string |
İlkenin oluşturulduğu tarih ve saat. |
id |
integer |
İlke yapılandırma kimliği. |
isBlocking |
boolean |
İlkenin engellenip engellenmediğini gösterir. |
isDeleted |
boolean |
İlkenin (geçici) silinip silinmediğini gösterir. |
isEnabled |
boolean |
İlkenin etkinleştirilip etkinleştirilmediğini gösterir. |
isEnterpriseManaged |
boolean |
Ayarlanırsa, bu ilke oluşturmak, düzenlemek veya silmek için "Kurumsal İlkeleri Yönetme" izni gerektirir. |
revision |
integer |
İlke yapılandırması düzeltme kimliği. |
settings |
İlke yapılandırma ayarları. |
|
type |
İlke yapılandırma türü. |
|
url |
string |
İlke yapılandırmasının alınabileceği URL. |
PolicyTypeRef
İlke türü başvurusu.
Name | Tür | Description |
---|---|---|
displayName |
string |
İlke türünün görünen adı. |
id |
string |
İlke türü kimliği. |
url |
string |
İlke türünün alınabileceği URL. |
ReferenceLinks
REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.
Name | Tür | Description |
---|---|---|
links |
object |
Bağlantıların salt okunur görünümü. Başvuru bağlantıları salt okunur olduğundan, bunları yalnızca salt okunur olarak göstermek istiyoruz. |
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin