Teamsettings - Get

チームの設定を取得する

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

URI パラメーター

Name / 必須 型 説明
organization
path True

string

Azure DevOps 組織の名前。

project
path True

string

プロジェクト ID またはプロジェクト名

team
path

string

チーム ID またはチーム名

api-version
query True

string

使用する API のバージョン。 このバージョンの API を使用するには、これを '7.1' に設定する必要があります。

応答

Name 型 説明
200 OK

TeamSetting

成功した操作

セキュリティ

oauth2

型: oauth2
フロー: accessCode
Authorization URL (承認 URL): https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL (トークン 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

スコープ

Name 説明
vso.work 作業項目、クエリ、ボード、領域とイテレーションのパス、およびその他の作業項目追跡関連のメタデータを読み取る機能を付与します。 また、クエリを実行したり、作業項目を検索したり、サービス フックを介して作業項目イベントに関する通知を受信したりすることもできます。

例

Get team settings for a team

要求のサンプル

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

応答のサンプル

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

定義

Name 説明
BugsBehavior

バグの動作

DayOfWeek

チームが作業している日数

ReferenceLinks

REST 参照リンクのコレクションを表すクラス。

TeamIterationAttributes
TeamSetting

TeamSettings のデータ コントラクト

TeamSettingsIteration

1 回の反復の浅い参照を表します。

TimeFrame

イテレーションの期間 (過去、現在、将来など)。

BugsBehavior

バグの動作

値 説明
off
asRequirements
asTasks

DayOfWeek

チームが作業している日数

値 説明
sunday
monday
tuesday
wednesday
thursday
friday
saturday

REST 参照リンクのコレクションを表すクラス。

Name 型 説明
links

object

リンクの読み取りビュー。 参照リンクは読み取り専用であるため、読み取り専用として公開する必要があります。

TeamIterationAttributes

Name 型 説明
finishDate

string (date-time)

イテレーションの終了日。 日付のみ、UTC の午前 0 時に調整されていない修正。

startDate

string (date-time)

イテレーションの開始日。 日付のみ、UTC の午前 0 時に調整されていない修正。

timeFrame

TimeFrame

イテレーションの期間 (過去、現在、将来など)。

TeamSetting

TeamSettings のデータ コントラクト

Name 型 説明
_links

ReferenceLinks

リソースに関連するリンクのコレクション

backlogIteration

TeamSettingsIteration

バックログイテレーション

backlogVisibilities

object

バックログに表示されるカテゴリに関する情報。

bugsBehavior

BugsBehavior

BugsBehavior (Off、AsTasks、AsRequirements、...)

defaultIteration

TeamSettingsIteration

既定のイテレーション。クエリ ページで新しい作業項目を作成するときに使用されるイテレーション。

defaultIterationMacro

string

既定の反復マクロ (存在する場合)

url

string

リソースへの完全な http リンク

workingDays

DayOfWeek[]

チームが作業している日数

TeamSettingsIteration

1 回の反復の浅い参照を表します。

Name 型 説明
_links

ReferenceLinks

リソースに関連するリンクのコレクション

attributes

TeamIterationAttributes

開始日や終了日などのイテレーションの属性。

id

string (uuid)

イテレーションの ID。

name

string

イテレーションの名前。

path

string

イテレーションの相対パス。

url

string

リソースへの完全な http リンク

TimeFrame

イテレーションの期間 (過去、現在、将来など)。

値 説明
past
current
future