Wikis - Get

Service:

Wiki

API Version:

7.1-preview.2

Pobiera witrynę typu wiki odpowiadającą podanemu identyfikatorowi wiki lub nazwie wiki.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
organization	path	True	string	Nazwa organizacji usługi Azure DevOps.
wikiIdentifier	path	True	string	Identyfikator witryny typu wiki lub nazwa witryny typu wiki.
project	path		string	Identyfikator projektu lub nazwa projektu
api-version	query	True	string	Wersja interfejsu API do użycia. Ta wartość powinna mieć wartość "7.1-preview.2", aby używać tej wersji interfejsu API.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	WikiV2	operacja zakończona powodzeniem

Zabezpieczenia

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

Nazwa	Opis
vso.wiki	Umożliwia odczytywanie stron typu wiki, stron typu wiki i załączników typu wiki. Umożliwia również wyszukiwanie stron typu wiki.

Przykłady

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": "/"
}

Definicje

Nazwa	Opis
GitVersionDescriptor
GitVersionOptions	Opcje wersji — określ dodatkowe modyfikatory do wersji (np. poprzedniej)
GitVersionType	Typ wersji (gałąź, tag lub zatwierdzenie). Określa, jak identyfikator jest interpretowany
WikiType	Typ strony typu wiki.
WikiV2	Definiuje zasób typu wiki.

GitVersionDescriptor

Nazwa	Typ	Opis
version	string	Identyfikator ciągu wersji (nazwa tagu/gałęzi, SHA1 zatwierdzenia)
versionOptions	GitVersionOptions	Opcje wersji — określ dodatkowe modyfikatory do wersji (np. poprzedniej)
versionType	GitVersionType	Typ wersji (gałąź, tag lub zatwierdzenie). Określa, jak identyfikator jest interpretowany

GitVersionOptions

Opcje wersji — określ dodatkowe modyfikatory do wersji (np. poprzedniej)

Nazwa	Typ	Opis
firstParent	string	Pierwszy element nadrzędny zatwierdzenia (HEAD^)
none	string	Nie określono
previousChange	string	Zatwierdzanie zmienionego elementu przed bieżącą wersją

GitVersionType

Typ wersji (gałąź, tag lub zatwierdzenie). Określa, jak identyfikator jest interpretowany

Nazwa	Typ	Opis
branch	string	Interpretowanie wersji jako nazwy gałęzi
commit	string	Interpretowanie wersji jako identyfikatora zatwierdzenia (SHA1)
tag	string	Interpretowanie wersji jako nazwy tagu

WikiType

Typ strony typu wiki.

Nazwa	Typ	Opis
codeWiki	string	Wskazuje, że witryna typu wiki została opublikowana z repozytorium git
projectWiki	string	Wskazuje, że witryna typu wiki jest aprowizowana dla projektu zespołowego

WikiV2

Definiuje zasób typu wiki.

Nazwa	Typ	Opis
id	string	Identyfikator strony typu wiki.
isDisabled	boolean	Czy repozytorium typu wiki jest wyłączone
mappedPath	string	Ścieżka folderu wewnątrz repozytorium, które jest wyświetlane jako wiki. Typ ProjectWiki nie jest wymagany.
name	string	Nazwa witryny typu wiki.
projectId	string	Identyfikator projektu, w którym ma zostać utworzona witryna typu wiki.
properties	object	Właściwości witryny typu wiki.
remoteUrl	string	Zdalny internetowy adres URL do witryny typu wiki.
repositoryId	string	Identyfikator repozytorium Git, które wykonuje kopię zapasową witryny typu wiki. Typ ProjectWiki nie jest wymagany.
type	WikiType	Typ strony typu wiki.
url	string	Adres URL REST dla tej witryny typu wiki.
versions	GitVersionDescriptor[]	Wersje witryny typu wiki.