Udostępnij przez

Teamsettings - Get

  • Odwołanie
Usługa:
Work
Wersja interfejsu API:
7.1

Pobieranie ustawień zespołu

GET https://dev.azure.com/{organization}/{project}/{team}/_apis/work/teamsettings?api-version=7.1

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
organization
 path True

string

Nazwa organizacji usługi Azure DevOps.
project
 path True

string

Identyfikator projektu lub nazwa projektu
team
 path

string

Identyfikator zespołu lub nazwa zespołu
api-version
 query True

string

Wersja interfejsu API do użycia. Należy ustawić wartość "7.1", aby używać tej wersji interfejsu API.

Odpowiedzi

Nazwa Typ Opis
200 OK

TeamSetting

operacja zakończona powodzeniem

Zabezpieczenia

oauth2

Typ: oauth2
Flow: accessCode
Adres URL autoryzacji: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Adres URL tokenu: 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

Zakresy

Nazwa Opis
vso.work Umożliwia odczytywanie elementów roboczych, zapytań, tablic, ścieżek obszaru i iteracji oraz innych metadanych powiązanych ze śledzeniem elementów roboczych. Ponadto umożliwia wykonywanie zapytań, wyszukiwanie elementów roboczych i odbieranie powiadomień o zdarzeniach elementów roboczych za pośrednictwem punktów zaczepienia usługi.

Przykłady

Get team settings for a team

Przykładowe żądanie

GET https://dev.azure.com/fabrikam/fabrikam-fiber/_apis/work/teamsettings?api-version=7.1

Przykładowa odpowiedź

Kod stanu:
200 
{
  "backlogIteration": {
    "id": "323b04b6-2fb8-4093-94f4-fbe3bd36a19f",
    "name": "Iteration",
    "path": "",
    "url": "https://dev.azure.com/fabrikam/c1f04a4e-c4e5-4e0d-8096-e5f9fd214bfb/_apis/wit/classificationNodes/Iterations"
  },
  "bugsBehavior": "asRequirements",
  "workingDays": [
    "monday",
    "tuesday",
    "wednesday",
    "thursday",
    "friday"
  ],
  "backlogVisibilities": {
    "Microsoft.EpicCategory": false,
    "Microsoft.FeatureCategory": true,
    "Microsoft.RequirementCategory": true
  },
  "defaultIteration": {
    "id": "a912d62f-3eba-44b9-ab54-aa82af94b1d7",
    "name": "Iteration 1",
    "path": "\\Iteration 1",
    "url": "https://dev.azure.com/fabrikam/c1f04a4e-c4e5-4e0d-8096-e5f9fd214bfb/_apis/wit/classificationNodes/Iterations/Iteration%201"
  },
  "defaultIterationMacro": "@currentIteration",
  "url": "https://dev.azure.com/fabrikam/c1f04a4e-c4e5-4e0d-8096-e5f9fd214bfb/3e9700ae-46cb-4ee3-ad77-3a1b1ae99572/_apis/work/teamsettings",
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/c1f04a4e-c4e5-4e0d-8096-e5f9fd214bfb/3e9700ae-46cb-4ee3-ad77-3a1b1ae99572/_apis/work/teamsettings"
    },
    "project": {
      "href": "https://dev.azure.com/fabrikam/_apis/projects/c1f04a4e-c4e5-4e0d-8096-e5f9fd214bfb"
    },
    "team": {
      "href": "https://dev.azure.com/fabrikam/_apis/projects/c1f04a4e-c4e5-4e0d-8096-e5f9fd214bfb/teams/3e9700ae-46cb-4ee3-ad77-3a1b1ae99572"
    },
    "teamIterations": {
      "href": "https://dev.azure.com/fabrikam/c1f04a4e-c4e5-4e0d-8096-e5f9fd214bfb/3e9700ae-46cb-4ee3-ad77-3a1b1ae99572/_apis/work/teamsettings/iterations"
    },
    "teamFieldValues": {
      "href": "https://dev.azure.com/fabrikam/c1f04a4e-c4e5-4e0d-8096-e5f9fd214bfb/3e9700ae-46cb-4ee3-ad77-3a1b1ae99572/_apis/work/teamsettings/teamfieldvalues"
    },
    "classificationNode": [
      {
        "href": "https://dev.azure.com/fabrikam/c1f04a4e-c4e5-4e0d-8096-e5f9fd214bfb/_apis/wit/classificationNodes/Iterations"
      },
      {
        "href": "https://dev.azure.com/fabrikam/c1f04a4e-c4e5-4e0d-8096-e5f9fd214bfb/_apis/wit/classificationNodes/Iterations/Iteration%201"
      }
    ]
  }
}

Definicje

Nazwa Opis
BugsBehavior

Zachowanie błędów
DayOfWeek

Dni, w których pracuje zespół
ReferenceLinks

Klasa reprezentująca kolekcję linków referencyjnych REST.
TeamIterationAttributes
TeamSetting

Kontrakt danych dla usługi TeamSettings
TeamSettingsIteration

Reprezentuje płytki ref dla pojedynczej iteracji.
TimeFrame

Przedział czasu iteracji, na przykład przeszłości, bieżącej lub przyszłej.

BugsBehavior

Wyliczanie

Zachowanie błędów

Wartość Opis
asRequirements
asTasks
off

DayOfWeek

Wyliczanie

Dni, w których pracuje zespół

Wartość Opis
friday
monday
saturday
sunday
thursday
tuesday
wednesday
Objekt

Klasa reprezentująca kolekcję linków referencyjnych REST.

Nazwa Typ Opis
links

object

Czytelny widok linków. Ponieważ linki odwołania są tylko do odczytu, chcemy uwidocznić je tylko jako tylko do odczytu.

TeamIterationAttributes

Objekt
Nazwa Typ Opis
finishDate

string (date-time)

Data zakończenia iteracji. Tylko data, popraw nieprzystosowane o północy w formacie UTC.
startDate

string (date-time)

Data rozpoczęcia iteracji. Tylko data, popraw nieprzystosowane o północy w formacie UTC.
timeFrame

TimeFrame

Przedział czasu iteracji, na przykład przeszłości, bieżącej lub przyszłej.

TeamSetting

Objekt

Kontrakt danych dla usługi TeamSettings

Nazwa Typ Opis
_links

ReferenceLinks

Kolekcja łączy istotnych dla zasobu
backlogIteration

TeamSettingsIteration

Iteracja listy prac
backlogVisibilities

object

Informacje o kategoriach, które są widoczne na liście prac.
bugsBehavior

BugsBehavior

BugsBehavior (Wyłączone, AsTasks, AsRequirements, ...)
defaultIteration

TeamSettingsIteration

Domyślna iteracja, iteracja używana podczas tworzenia nowego elementu roboczego na stronie zapytań.
defaultIterationMacro

string

Domyślne makro iteracji (jeśli istnieje)
url

string

Pełny link http do zasobu
workingDays

DayOfWeek[]

Dni, w których pracuje zespół

TeamSettingsIteration

Objekt

Reprezentuje płytki ref dla pojedynczej iteracji.

Nazwa Typ Opis
_links

ReferenceLinks

Kolekcja łączy istotnych dla zasobu
attributes

TeamIterationAttributes

Atrybuty iteracji, takie jak data rozpoczęcia i zakończenia.
id

string (uuid)

Identyfikator iteracji.
name

string

Nazwa iteracji.
path

string

Ścieżka względna iteracji.
url

string

Pełny link http do zasobu

TimeFrame

Wyliczanie

Przedział czasu iteracji, na przykład przeszłości, bieżącej lub przyszłej.

Wartość Opis
current
future
past