Configurations - Update

참조

Service:: Policy

API Version:: 7.1-preview.1

ID로 정책 구성을 업데이트합니다.

PUT https://dev.azure.com/{organization}/{project}/_apis/policy/configurations/{configurationId}?api-version=7.1-preview.1

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
configurationId	path	True	integer int32	업데이트할 기존 정책 구성의 ID입니다.
organization	path	True	string	Azure DevOps 조직의 이름입니다.
project	path	True	string	프로젝트 ID 또는 프로젝트 이름
api-version	query	True	string	사용할 API의 버전입니다. 이 버전의 api를 사용하려면 '7.1-preview.1'로 설정해야 합니다.

요청 본문

Name	형식	Description
_links	ReferenceLinks	이 개체와 관련된 다른 개체에 대한 링크입니다.
createdBy	IdentityRef	정책을 만든 ID에 대한 참조입니다.
createdDate	string	정책을 만든 날짜 및 시간입니다.
id	integer	정책 구성 ID입니다.
isBlocking	boolean	정책이 차단되고 있는지 여부를 나타냅니다.
isDeleted	boolean	정책이 (소프트) 삭제되었는지 여부를 나타냅니다.
isEnabled	boolean	정책이 사용하도록 설정되어 있는지 여부를 나타냅니다.
isEnterpriseManaged	boolean	설정된 경우 이 정책을 만들거나 편집하거나 삭제하려면 "엔터프라이즈 정책 관리" 권한이 필요합니다.
revision	integer	정책 구성 수정 ID입니다.
settings	JObject	정책 구성 설정입니다.
type	PolicyTypeRef	정책 구성 유형입니다.
url	string	정책 구성을 검색할 수 있는 URL입니다.

응답

Name	형식	Description
200 OK	PolicyConfiguration	성공한 작업

보안

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	소스 코드를 읽고, 업데이트하고, 삭제하고, 커밋, 변경 집합, 분기 및 기타 버전 제어 아티팩트에 대한 메타데이터에 액세스하는 기능을 부여합니다. 또한 끌어오기 요청 및 코드 검토를 만들고 관리하고 서비스 후크를 통해 버전 제어 이벤트에 대한 알림을 받을 수 있는 기능도 부여합니다.

예제

Sample Request

HTTP

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

Status code:: 200

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

정의

Name	Description
IdentityRef
JObject	JSON 개체를 나타냅니다.
PolicyConfiguration	설정이 있는 전체 정책 구성입니다.
PolicyTypeRef	정책 유형 참조입니다.
ReferenceLinks	REST 참조 링크의 컬렉션을 나타내는 클래스입니다.

IdentityRef

Name	형식	Description
_links	ReferenceLinks	이 필드에는 그래프 제목에 대한 0개 이상의 흥미로운 링크가 포함되어 있습니다. 이러한 링크를 호출하여 이 그래프 제목에 대한 추가 관계 또는 자세한 정보를 얻을 수 있습니다.
descriptor	string	설명자는 시스템이 실행되는 동안 그래프 제목을 참조하는 기본 방법입니다. 이 필드는 계정과 조직 모두에서 동일한 그래프 제목을 고유하게 식별합니다.
directoryAlias	string	사용되지 않음 - IdentityRef "_links" 사전의 "자체" 항목에서 참조된 Graph 사용자를 쿼리하여 검색할 수 있습니다.
displayName	string	그래프 주체의 고유하지 않은 표시 이름입니다. 이 필드를 변경하려면 원본 공급자에서 해당 값을 변경해야 합니다.
id	string
imageUrl	string	사용되지 않음 - IdentityRef "_links" 사전의 "아바타" 항목에서 사용할 수 있습니다.
inactive	boolean	사용되지 않음 - GraphUser "_links" 사전의 "membershipState" 항목에서 참조되는 Graph 멤버 자격 상태를 쿼리하여 검색할 수 있습니다.
isAadIdentity	boolean	사용되지 않음 - 설명자의 주체 형식(Descriptor.IsAadUserType/Descriptor.IsAadGroupType)에서 유추할 수 있습니다.
isContainer	boolean	사용되지 않음 - 설명자의 주체 형식에서 유추할 수 있음(Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	사용되지 않음 - ToIdentityRef의 대부분의 기존 구현에서 사용되지 않음
uniqueName	string	사용되지 않음 - 대신 Domain+PrincipalName 사용
url	string	이 URL은 이 그래프 주체의 원본 리소스에 대한 전체 경로입니다.

JObject

JSON 개체를 나타냅니다.

Name	형식	Description
item	string
type	string	이 JToken의 노드 형식을 가져옵니다.

PolicyConfiguration

설정이 있는 전체 정책 구성입니다.

Name	형식	Description
_links	ReferenceLinks	이 개체와 관련된 다른 개체에 대한 링크입니다.
createdBy	IdentityRef	정책을 만든 ID에 대한 참조입니다.
createdDate	string	정책을 만든 날짜 및 시간입니다.
id	integer	정책 구성 ID입니다.
isBlocking	boolean	정책이 차단되고 있는지 여부를 나타냅니다.
isDeleted	boolean	정책이 (소프트) 삭제되었는지 여부를 나타냅니다.
isEnabled	boolean	정책이 사용하도록 설정되어 있는지 여부를 나타냅니다.
isEnterpriseManaged	boolean	설정된 경우 이 정책을 만들거나 편집하거나 삭제하려면 "엔터프라이즈 정책 관리" 권한이 필요합니다.
revision	integer	정책 구성 수정 ID입니다.
settings	JObject	정책 구성 설정입니다.
type	PolicyTypeRef	정책 구성 유형입니다.
url	string	정책 구성을 검색할 수 있는 URL입니다.

PolicyTypeRef

정책 유형 참조입니다.

Name	형식	Description
displayName	string	정책 유형의 표시 이름입니다.
id	string	정책 유형 ID입니다.
url	string	정책 유형을 검색할 수 있는 URL입니다.

ReferenceLinks

REST 참조 링크의 컬렉션을 나타내는 클래스입니다.

Name	형식	Description
links	object	링크의 읽기 전용 보기입니다. 참조 링크는 읽기 전용이므로 읽기 전용으로만 노출하려고 합니다.

다음을 통해 공유