Teamsettings - Update

Odwołanie

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

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.

Treść żądania

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

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_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

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

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

ReferenceLinks

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

TeamSettingsPatch

Objekt

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

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

TimeFrame

Wyliczanie

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

Wartość	Opis
current
future
past

Udostępnij przez

Teamsettings - Update

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Zabezpieczenia

oauth2

Zakresy

Przykłady

Update team settings. Example 1

Przykładowe żądanie

Przykładowa odpowiedź

Update team settings. Example 2

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

BugsBehavior

DayOfWeek

ReferenceLinks

TeamIterationAttributes

TeamSetting

TeamSettingsIteration

TeamSettingsPatch

TimeFrame