Compartir a través de


Teamsettings - Get

Obtener la configuración de un equipo

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
organization
path True

string

El nombre de la organización de Azure DevOps.

project
path True

string

Id. de proyecto o nombre del proyecto

team
path

string

Id. de equipo o nombre del equipo

api-version
query True

string

Versión de la API que se va a usar. Debe establecerse en "7.1-preview.1" para usar esta versión de la API.

Respuestas

Nombre Tipo Description
200 OK

TeamSetting

operación correcta

Seguridad

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

Nombre Description
vso.work Concede la capacidad de leer elementos de trabajo, consultas, paneles, rutas de acceso de área e iteraciones y otros metadatos relacionados con el seguimiento de elementos de trabajo. También concede la capacidad de ejecutar consultas, buscar elementos de trabajo y recibir notificaciones sobre eventos de elementos de trabajo a través de enlaces de servicio.

Ejemplos

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

Definiciones

Nombre Description
BugsBehavior

Comportamiento de errores

DayOfWeek

Días en los que el equipo está trabajando

ReferenceLinks

Clase que representa una colección de vínculos de referencia de REST.

TeamIterationAttributes
TeamSetting

Contrato de datos para TeamSettings

TeamSettingsIteration

Representa una referencia superficial para una sola iteración.

TimeFrame

Período de tiempo de la iteración, como pasado, actual o futuro.

BugsBehavior

Comportamiento de errores

Nombre Tipo Description
asRequirements

string

asTasks

string

off

string

DayOfWeek

Días en los que el equipo está trabajando

Nombre Tipo Description
friday

string

monday

string

saturday

string

sunday

string

thursday

string

tuesday

string

wednesday

string

Clase que representa una colección de vínculos de referencia de REST.

Nombre Tipo Description
links

object

Vista de solo lectura de los vínculos. Dado que los vínculos de referencia son de solo lectura, solo queremos exponerlos como de solo lectura.

TeamIterationAttributes

Nombre Tipo Description
finishDate

string

Fecha de finalización de la iteración. Solo fecha, correcto sin ajustar a medianoche en UTC.

startDate

string

Fecha de inicio de la iteración. Solo fecha, correcto sin ajustar a medianoche en UTC.

timeFrame

TimeFrame

Período de tiempo de la iteración, como pasado, actual o futuro.

TeamSetting

Contrato de datos para TeamSettings

Nombre Tipo Description
_links

ReferenceLinks

Colección de vínculos relevantes para el recurso

backlogIteration

TeamSettingsIteration

Iteración de trabajo pendiente

backlogVisibilities

object

Información sobre las categorías que están visibles en el trabajo pendiente.

bugsBehavior

BugsBehavior

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

defaultIteration

TeamSettingsIteration

Iteración predeterminada, la iteración usada al crear un nuevo elemento de trabajo en la página de consultas.

defaultIterationMacro

string

Macro de iteración predeterminada (si existe)

url

string

Vínculo HTTP completo al recurso

workingDays

DayOfWeek[]

Días en los que el equipo está trabajando

TeamSettingsIteration

Representa una referencia superficial para una sola iteración.

Nombre Tipo Description
_links

ReferenceLinks

Colección de vínculos relevantes para el recurso

attributes

TeamIterationAttributes

Atributos de la iteración, como la fecha de inicio y finalización.

id

string

Identificador de la iteración.

name

string

Nombre de la iteración.

path

string

Ruta de acceso relativa de la iteración.

url

string

Vínculo HTTP completo al recurso

TimeFrame

Período de tiempo de la iteración, como pasado, actual o futuro.

Nombre Tipo Description
current

string

future

string

past

string