Sdílet prostřednictvím


Teamsettings - Get

Získání nastavení týmu

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
organization
path True

string

Název organizace Azure DevOps.

project
path True

string

ID projektu nebo název projektu

team
path

string

ID týmu nebo název týmu

api-version
query True

string

Verze rozhraní API, která se má použít. Tato verze rozhraní API by měla být nastavená na 7.1-preview.1.

Odpovědi

Name Typ Description
200 OK

TeamSetting

úspěšná operace

Zabezpečení

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

Name Description
vso.work Umožňuje číst pracovní položky, dotazy, panely, cesty oblastí a iterací a další metadata související se sledováním pracovních položek. Poskytuje také možnost spouštět dotazy, vyhledávat pracovní položky a přijímat oznámení o událostech pracovních položek prostřednictvím volání služeb.

Příklady

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"
      }
    ]
  }
}

Definice

Name Description
BugsBehavior

Chování chyb

DayOfWeek

Dny, kdy tým pracuje

ReferenceLinks

Třída představující kolekci odkazů REST.

TeamIterationAttributes
TeamSetting

Kontrakt dat pro TeamSettings

TeamSettingsIteration

Představuje mělký odkaz pro jednu iteraci.

TimeFrame

Časový rámec iterace, například minulé, aktuální nebo budoucí.

BugsBehavior

Chování chyb

Name Typ Description
asRequirements

string

asTasks

string

off

string

DayOfWeek

Dny, kdy tým pracuje

Name Typ Description
friday

string

monday

string

saturday

string

sunday

string

thursday

string

tuesday

string

wednesday

string

Třída představující kolekci odkazů REST.

Name Typ Description
links

object

Zobrazení odkazů jen pro čtení. Vzhledem k tomu, že odkazy jsou jen pro čtení, chceme je zveřejnit jenom jako odkazy jen pro čtení.

TeamIterationAttributes

Name Typ Description
finishDate

string

Datum dokončení iterace. Pouze datum, správně nastaveno o půlnoci ve standardu UTC.

startDate

string

Počáteční datum iterace. Pouze datum, správně nastaveno o půlnoci ve standardu UTC.

timeFrame

TimeFrame

Časový rámec iterace, například minulé, aktuální nebo budoucí.

TeamSetting

Kontrakt dat pro TeamSettings

Name Typ Description
_links

ReferenceLinks

Kolekce odkazů relevantních pro prostředek

backlogIteration

TeamSettingsIteration

Iterace backlogu

backlogVisibilities

object

Informace o kategoriích, které jsou viditelné v backlogu.

bugsBehavior

BugsBehavior

BugsBehavior (Vypnuto, AsTasks, AsRequirements, ...)

defaultIteration

TeamSettingsIteration

Výchozí iterace, iterace použitá při vytváření nové pracovní položky na stránce dotazů.

defaultIterationMacro

string

Výchozí makro iterace (pokud existuje)

url

string

Úplný odkaz HTTP na prostředek

workingDays

DayOfWeek[]

Dny, kdy tým pracuje

TeamSettingsIteration

Představuje mělký odkaz pro jednu iteraci.

Name Typ Description
_links

ReferenceLinks

Kolekce odkazů relevantních pro prostředek

attributes

TeamIterationAttributes

Atributy iterace, jako je počáteční a koncové datum.

id

string

ID iterace.

name

string

Název iterace.

path

string

Relativní cesta iterace.

url

string

Úplný odkaz HTTP na prostředek

TimeFrame

Časový rámec iterace, například minulé, aktuální nebo budoucí.

Name Typ Description
current

string

future

string

past

string