Condividi tramite

Teamsettings - Get

  • Riferimento
Servizio:
Work
Versione API:
7.1

Ottenere le impostazioni di un team

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
organization
 path True

string

Nome dell'organizzazione di Azure DevOps.
project
 path True

string

ID progetto o nome progetto
team
 path

string

ID team o nome team
api-version
 query True

string

Versione dell'API da usare. Deve essere impostato su '7.1' per usare questa versione dell'API.

Risposte

Nome Tipo Descrizione
200 OK

TeamSetting

operazione riuscita

Sicurezza

oauth2

Tipo: oauth2
Flow: accessCode
URL di autorizzazione: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL token: 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

Ambiti

Nome Descrizione
vso.work Concede la possibilità di leggere elementi di lavoro, query, lavagne, percorsi di aree e iterazioni e altri metadati correlati al rilevamento degli elementi di lavoro. Concede inoltre la possibilità di eseguire query, cercare elementi di lavoro e ricevere notifiche sugli eventi degli elementi di lavoro tramite hook del servizio.

Esempio

Get team settings for a team

Esempio di richiesta

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

Risposta di esempio

Codice di stato:
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"
      }
    ]
  }
}

Definizioni

Nome Descrizione
BugsBehavior

Comportamento dei bug
DayOfWeek

Giorni di lavoro del team
ReferenceLinks

Classe per rappresentare una raccolta di collegamenti di riferimento REST.
TeamIterationAttributes
TeamSetting

Contratto dati per TeamSettings
TeamSettingsIteration

Rappresenta un riferimento superficiale per una singola iterazione.
TimeFrame

Intervallo di tempo dell'iterazione, ad esempio passato, corrente o futuro.

BugsBehavior

Enumerazione

Comportamento dei bug

Valore Descrizione
asRequirements
asTasks
off

DayOfWeek

Enumerazione

Giorni di lavoro del team

Valore Descrizione
friday
monday
saturday
sunday
thursday
tuesday
wednesday
Object

Classe per rappresentare una raccolta di collegamenti di riferimento REST.

Nome Tipo Descrizione
links

object

Visualizzazione di sola lettura dei collegamenti. Poiché i collegamenti di riferimento sono di sola lettura, è consigliabile esporli solo come di sola lettura.

TeamIterationAttributes

Object
Nome Tipo Descrizione
finishDate

string (date-time)

Data di fine dell'iterazione. Solo data, corretta annullata a mezzanotte in formato UTC.
startDate

string (date-time)

Data di inizio dell'iterazione. Solo data, corretta annullata a mezzanotte in formato UTC.
timeFrame

TimeFrame

Intervallo di tempo dell'iterazione, ad esempio passato, corrente o futuro.

TeamSetting

Object

Contratto dati per TeamSettings

Nome Tipo Descrizione
_links

ReferenceLinks

Raccolta di collegamenti rilevanti per la risorsa
backlogIteration

TeamSettingsIteration

Iterazione backlog
backlogVisibilities

object

Informazioni sulle categorie visibili nel backlog.
bugsBehavior

BugsBehavior

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

TeamSettingsIteration

Iterazione predefinita, iterazione usata durante la creazione di un nuovo elemento di lavoro nella pagina query.
defaultIterationMacro

string

Macro di iterazione predefinita (se disponibile)
url

string

Collegamento HTTP completo alla risorsa
workingDays

DayOfWeek[]

Giorni di lavoro del team

TeamSettingsIteration

Object

Rappresenta un riferimento superficiale per una singola iterazione.

Nome Tipo Descrizione
_links

ReferenceLinks

Raccolta di collegamenti rilevanti per la risorsa
attributes

TeamIterationAttributes

Attributi dell'iterazione, ad esempio data di inizio e fine.
id

string (uuid)

ID dell'iterazione.
name

string

Nome dell'iterazione.
path

string

Percorso relativo dell'iterazione.
url

string

Collegamento HTTP completo alla risorsa

TimeFrame

Enumerazione

Intervallo di tempo dell'iterazione, ad esempio passato, corrente o futuro.

Valore Descrizione
current
future
past