Udostępnij za pośrednictwem


Teamsettings - Get

Pobieranie ustawień zespołu

GET https://dev.azure.com/{organization}/{project}/{team}/_apis/work/teamsettings?api-version=7.1-preview.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. Ta wartość powinna być ustawiona na wartość "7.1-preview.1", aby używać tej wersji interfejsu API.

Odpowiedzi

Nazwa Typ Opis
200 OK

TeamSetting

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.work Umożliwia odczytywanie elementów roboczych, zapytań, tablic, ścieżek obszaru i iteracji oraz innych metadanych powiązanych ze śledzeniem elementów roboczych. Umożliwia również 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

Sample Request

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

Sample Response

{
  "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 pracy zespołu

ReferenceLinks

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

TeamIterationAttributes
TeamSetting

Kontrakt danych dla usługi TeamSettings

TeamSettingsIteration

Reprezentuje płytkie odwołanie dla pojedynczej iteracji.

TimeFrame

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

BugsBehavior

Zachowanie błędów

Nazwa Typ Opis
asRequirements

string

asTasks

string

off

string

DayOfWeek

Dni pracy zespołu

Nazwa Typ Opis
friday

string

monday

string

saturday

string

sunday

string

thursday

string

tuesday

string

wednesday

string

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

Nazwa Typ Opis
links

object

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

TeamIterationAttributes

Nazwa Typ Opis
finishDate

string

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

startDate

string

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

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 widocznych na liście prac.

bugsBehavior

BugsBehavior

BugsBehavior (Off, AsTasks, AsRequirements, ...)

defaultIteration

TeamSettingsIteration

Iteracja domyślna, 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 pracy zespołu

TeamSettingsIteration

Reprezentuje płytkie odwołanie 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

Identyfikator iteracji.

name

string

Nazwa iteracji.

path

string

Ścieżka względna iteracji.

url

string

Pełny link HTTP do zasobu

TimeFrame

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

Nazwa Typ Opis
current

string

future

string

past

string