Teamsettings - Get

リファレンス

サービス:: Work

API バージョン:: 7.1

チームの設定を取得する

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

URI パラメーター

名前	/	必須	型	説明
organization	path	True	string	Azure DevOps 組織の名前。
project	path	True	string	プロジェクト ID またはプロジェクト名
team	path		string	チーム ID またはチーム名
api-version	query	True	string	使用する API のバージョン。このバージョンの API を使用するには、これを '7.1' に設定する必要があります。

応答

名前	型	説明
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

スコープ

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

例

Get team settings for a team

要求のサンプル

HTTP

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

応答のサンプル

状態コード:: 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"
      }
    ]
  }
}

定義

名前	説明
BugsBehavior	バグの動作
DayOfWeek	チームが作業している日数
ReferenceLinks	REST 参照リンクのコレクションを表すクラス。
TeamIterationAttributes
TeamSetting	TeamSettings のデータコントラクト
TeamSettingsIteration	1 回の反復の浅い参照を表します。
TimeFrame	イテレーションの期間 (過去、現在、将来など)。

BugsBehavior

列挙

バグの動作

値	説明
asRequirements
asTasks
off

DayOfWeek

列挙

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

値	説明
friday
monday
saturday
sunday
thursday
tuesday
wednesday

ReferenceLinks

Object

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

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

TeamIterationAttributes

Object

名前	型	説明
finishDate	string (date-time)	イテレーションの終了日。日付のみ、UTC の午前 0 時に調整されていない修正。
startDate	string (date-time)	イテレーションの開始日。日付のみ、UTC の午前 0 時に調整されていない修正。
timeFrame	TimeFrame	イテレーションの期間 (過去、現在、将来など)。

TeamSetting

Object

TeamSettings のデータコントラクト

名前	型	説明
_links	ReferenceLinks	リソースに関連するリンクのコレクション
backlogIteration	TeamSettingsIteration	バックログイテレーション
backlogVisibilities	object	バックログに表示されるカテゴリに関する情報。
bugsBehavior	BugsBehavior	BugsBehavior (Off、AsTasks、AsRequirements、...)
defaultIteration	TeamSettingsIteration	既定のイテレーション。クエリページで新しい作業項目を作成するときに使用されるイテレーション。
defaultIterationMacro	string	既定の反復マクロ (存在する場合)
url	string	リソースへの完全な http リンク
workingDays	DayOfWeek[]	チームが作業している日数

TeamSettingsIteration

Object

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

名前	型	説明
_links	ReferenceLinks	リソースに関連するリンクのコレクション
attributes	TeamIterationAttributes	開始日や終了日などのイテレーションの属性。
id	string (uuid)	イテレーションの ID。
name	string	イテレーションの名前。
path	string	イテレーションの相対パス。
url	string	リソースへの完全な http リンク

TimeFrame

列挙

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

値	説明
current
future
past

次の方法で共有

Teamsettings - Get

URI パラメーター

応答

セキュリティ

oauth2

スコープ

例

Get team settings for a team

要求のサンプル

応答のサンプル

定義

BugsBehavior

DayOfWeek

ReferenceLinks

TeamIterationAttributes

TeamSetting

TeamSettingsIteration

TimeFrame