Wikis - Get

Service:

Wiki

API Version:

7.1-preview.2

제공된 위키 ID 또는 위키 이름에 해당하는 위키를 가져옵니다.

GET https://dev.azure.com/{organization}/{project}/_apis/wiki/wikis/{wikiIdentifier}?api-version=7.1-preview.2

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
organization	path	True	string	Azure DevOps 조직의 이름입니다.
wikiIdentifier	path	True	string	Wiki ID 또는 wiki 이름입니다.
project	path		string	프로젝트 ID 또는 프로젝트 이름
api-version	query	True	string	사용할 API의 버전입니다. 이 버전의 api를 사용하려면 '7.1-preview.2'로 설정해야 합니다.

응답

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

보안

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.wiki	위키, 위키 페이지 및 위키 첨부 파일을 읽을 수 있는 기능을 부여합니다. 또한 위키 페이지를 검색할 수 있는 기능도 부여합니다.

예제

Query by Id

Query by name

Query by Id

Sample Request

HTTP

GET https://dev.azure.com/fabrikam/_apis/wiki/wikis/{wikiIdentifier}?api-version=7.1-preview.2

Sample Response

Status code:

200

{
  "id": "0ede3074-ce9f-4e0e-b9d6-20c23b774e05",
  "versions": [
    {
      "version": "wikiMaster"
    }
  ],
  "url": "https://dev.azure.com/fabrikam/15cbba90-8ac5-450e-934c-16f43021546b/_apis/wiki/wikis/0ede3074-ce9f-4e0e-b9d6-20c23b774e05",
  "remoteUrl": "https://dev.azure.com/fabrikam/15cbba90-8ac5-450e-934c-16f43021546b/_wiki/wikis/0ede3074-ce9f-4e0e-b9d6-20c23b774e05",
  "type": "projectWiki",
  "name": "sampleProjectWiki",
  "projectId": "15cbba90-8ac5-450e-934c-16f43021546b",
  "repositoryId": "0ede3074-ce9f-4e0e-b9d6-20c23b774e05",
  "mappedPath": "/"
}

Query by name

Sample Request

HTTP

GET https://dev.azure.com/fabrikam/_apis/wiki/wikis/{wikiIdentifier}?api-version=7.1-preview.2

Sample Response

Status code:

200

{
  "id": "0ede3074-ce9f-4e0e-b9d6-20c23b774e05",
  "versions": [
    {
      "version": "wikiMaster"
    }
  ],
  "url": "https://dev.azure.com/fabrikam/15cbba90-8ac5-450e-934c-16f43021546b/_apis/wiki/wikis/0ede3074-ce9f-4e0e-b9d6-20c23b774e05",
  "remoteUrl": "https://dev.azure.com/fabrikam/15cbba90-8ac5-450e-934c-16f43021546b/_wiki/wikis/0ede3074-ce9f-4e0e-b9d6-20c23b774e05",
  "type": "projectWiki",
  "name": "sampleProjectWiki",
  "projectId": "15cbba90-8ac5-450e-934c-16f43021546b",
  "repositoryId": "0ede3074-ce9f-4e0e-b9d6-20c23b774e05",
  "mappedPath": "/"
}

정의

Name	Description
GitVersionDescriptor
GitVersionOptions	버전 옵션 - 버전에 대한 추가 한정자 지정(예: 이전)
GitVersionType	버전 유형(분기, 태그 또는 커밋). ID가 해석되는 방법을 결정합니다.
WikiType	위키의 유형입니다.
WikiV2	위키 리소스를 정의합니다.

GitVersionDescriptor

Name	형식	Description
version	string	버전 문자열 식별자(태그/분기 이름, 커밋의 SHA1)
versionOptions	GitVersionOptions	버전 옵션 - 버전에 대한 추가 한정자 지정(예: 이전)
versionType	GitVersionType	버전 유형(분기, 태그 또는 커밋). ID가 해석되는 방법을 결정합니다.

GitVersionOptions

버전 옵션 - 버전에 대한 추가 한정자 지정(예: 이전)

Name	형식	Description
firstParent	string	커밋의 첫 번째 부모(HEAD^)
none	string	지정되지 않음
previousChange	string	현재 버전 이전에 변경된 항목을 커밋합니다.

GitVersionType

버전 유형(분기, 태그 또는 커밋). ID가 해석되는 방법을 결정합니다.

Name	형식	Description
branch	string	버전을 분기 이름으로 해석
commit	string	버전을 SHA1(커밋 ID)으로 해석
tag	string	버전을 태그 이름으로 해석

WikiType

위키의 유형입니다.

Name	형식	Description
codeWiki	string	wiki가 git 리포지토리에서 게시되었음을 나타냅니다.
projectWiki	string	Wiki가 팀 프로젝트에 대해 프로비전되었음을 나타냅니다.

WikiV2

위키 리소스를 정의합니다.

Name	형식	Description
id	string	wiki의 ID입니다.
isDisabled	boolean	Wiki 리포지토리를 사용할 수 없나요?
mappedPath	string	Wiki로 표시되는 리포지토리 내의 폴더 경로입니다. ProjectWiki 형식에는 필요하지 않습니다.
name	string	Wiki 이름입니다.
projectId	string	wiki를 만들 프로젝트의 ID입니다.
properties	object	Wiki의 속성입니다.
remoteUrl	string	Wiki에 대한 원격 웹 URL입니다.
repositoryId	string	wiki를 백업하는 git 리포지토리의 ID입니다. ProjectWiki 형식에는 필요하지 않습니다.
type	WikiType	위키의 유형입니다.
url	string	이 Wiki의 REST URL입니다.
versions	GitVersionDescriptor[]	Wiki의 버전입니다.