Teamsettings - Update

Usługa:: Work

Wersja interfejsu API:: 7.1

Aktualizowanie ustawień zespołu

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

Parametry identyfikatora URI

Nazwisko	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.

Treść żądania

Nazwisko	Typ	Opis
backlogIteration	string (uuid)
backlogVisibilities	object
bugsBehavior	BugsBehavior
defaultIteration	string (uuid)
defaultIterationMacro	string
workingDays	DayOfWeek[]

Odpowiedzi

Nazwisko	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

Nazwisko	Opis
vso.work_write	Umożliwia odczytywanie, tworzenie i aktualizowanie elementów roboczych i zapytań, metadanych tablicy aktualizacji, ścieżek obszaru odczytu i iteracji innych metadanych powiązanych elementów roboczych, wykonywania zapytań i odbierania powiadomień o zdarzeniach elementów roboczych za pośrednictwem punktów zaczepienia usługi.

Przykłady

Update team settings. Example 1

Update team settings. Example 2

Update team settings. Example 1

Przykładowe żądanie

HTTP

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

{
  "bugsBehavior": "AsTasks",
  "workingDays": [
    "monday",
    "tuesday",
    "wednesday",
    "thursday"
  ],
  "defaultIteration": "8C2457E8-8936-4CDC-B3AA-17B20F56C76C"
}

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": "asTasks",
  "workingDays": [
    "monday",
    "tuesday",
    "wednesday",
    "thursday"
  ],
  "backlogVisibilities": {
    "Microsoft.EpicCategory": false,
    "Microsoft.FeatureCategory": true,
    "Microsoft.RequirementCategory": true
  },
  "defaultIteration": {
    "id": "8c2457e8-8936-4cdc-b3aa-17b20f56c76c",
    "name": "Iteration 3",
    "path": "\\Iteration 3",
    "url": "https://dev.azure.com/fabrikam/c1f04a4e-c4e5-4e0d-8096-e5f9fd214bfb/_apis/wit/classificationNodes/Iterations/Iteration%203"
  },
  "defaultIterationMacro": null,
  "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%203"
      }
    ]
  }
}

Update team settings. Example 2

Przykładowe żądanie

HTTP

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

{
  "bugsBehavior": "AsRequirements",
  "workingDays": [
    "monday",
    "tuesday",
    "wednesday",
    "thursday",
    "friday"
  ],
  "defaultIterationMacro": "@CurrentIteration"
}

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

Nazwisko	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.
TeamSettingsPatch	Kontrakt danych dotyczący tego, czego oczekujemy, gdy patch
TimeFrame	Przedział czasu iteracji, na przykład przeszłości, bieżącej lub przyszłej.

BugsBehavior

Wyliczenie

Zachowanie błędów

Wartość	Opis
off
asRequirements
asTasks

DayOfWeek

Wyliczenie

Dni, w których pracuje zespół

Wartość	Opis
sunday
monday
tuesday
wednesday
thursday
friday
saturday

ReferenceLinks

Objekt

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

Nazwisko	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

Nazwisko	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

Nazwisko	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.

Nazwisko	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

TeamSettingsPatch

Objekt

Kontrakt danych dotyczący tego, czego oczekujemy, gdy patch

Nazwisko	Typ	Opis
backlogIteration	string (uuid)
backlogVisibilities	object
bugsBehavior	BugsBehavior
defaultIteration	string (uuid)
defaultIterationMacro	string
workingDays	DayOfWeek[]

TimeFrame

Wyliczenie

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

Wartość	Opis
past
current
future

Opinia

Czy ta strona była pomocna?