Projects - Update
既存のプロジェクトの名前、省略形、説明を更新するか、プロジェクトを復元します。
PATCH https://dev.azure.com/{organization}/_apis/projects/{projectId}?api-version=7.1
URI パラメーター
| 名前 | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
organization
|
path | True |
string |
Azure DevOps 組織の名前。 |
|
project
|
path | True |
string (uuid) |
更新するプロジェクトのプロジェクト ID。 |
|
api-version
|
query | True |
string |
使用する API のバージョン。 このバージョンの API を使用するには、これを '7.1' に設定する必要があります。 |
要求本文
| 名前 | 型 | 説明 |
|---|---|---|
| _links |
このオブジェクトに関連する他のオブジェクトへのリンク。 |
|
| abbreviation |
string |
プロジェクトの省略形。 |
| capabilities |
object |
このプロジェクトが持つ一連の機能 (プロセス テンプレート & バージョン管理など)。 |
| defaultTeam |
既定のチームへの浅い参照。 |
|
| defaultTeamImageUrl |
string |
既定のチーム ID イメージの URL。 |
| description |
string |
プロジェクトの説明 (ある場合)。 |
| id |
string (uuid) |
プロジェクト識別子。 |
| lastUpdateTime |
string (date-time) |
プロジェクトの最終更新時刻。 |
| name |
string |
プロジェクト名。 |
| revision |
integer (int64) |
プロジェクトのリビジョン。 |
| state |
プロジェクトの状態。 |
|
| url |
string |
オブジェクトの完全なバージョンへの URL。 |
| visibility |
プロジェクトの可視性。 |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 200 OK |
成功した操作 |
セキュリティ
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.project_write | プロジェクトとチームの読み取りと更新を行う機能を付与します。 |
定義
| 名前 | 説明 |
|---|---|
|
Operation |
非同期操作のリファレンス。 |
|
Operation |
操作の現在の状態。 |
|
Project |
プロジェクトの現在の状態。 |
|
Project |
プロジェクトが表示されるユーザーを示します。 |
|
Reference |
REST 参照リンクのコレクションを表すクラス。 |
|
Team |
チーム プロジェクト オブジェクトを表します。 |
|
Web |
OperationReference
非同期操作のリファレンス。
| 名前 | 型 | 説明 |
|---|---|---|
| id |
string (uuid) |
操作の一意識別子。 |
| pluginId |
string (uuid) |
プラグインの一意識別子。 |
| status |
操作の現在の状態。 |
|
| url |
string |
完全な操作オブジェクトを取得する URL。 |
OperationStatus
操作の現在の状態。
| 値 | 説明 |
|---|---|
| cancelled |
操作はユーザーによって取り消されました。 |
| failed |
操作が失敗して完了しました。 |
| inProgress |
操作が進行中です。 |
| notSet |
操作に状態が設定されていません。 |
| queued |
操作はキューに登録されています。 |
| succeeded |
操作が正常に完了しました。 |
ProjectState
プロジェクトの現在の状態。
| 値 | 説明 |
|---|---|
| all |
[削除済み] を除く、状態に関係なく、すべてのプロジェクト。 |
| createPending |
プロジェクトは作成のためにキューに登録されていますが、プロセスはまだ開始されていません。 |
| deleted |
プロジェクトが削除されました。 |
| deleting |
プロジェクトは削除中です。 |
| new |
プロジェクトは作成中です。 |
| unchanged |
プロジェクトは変更されていません。 |
| wellFormed |
プロジェクトが完全に作成され、使用する準備が整いました。 |
ProjectVisibility
プロジェクトが表示されるユーザーを示します。
| 値 | 説明 |
|---|---|
| private |
プロジェクトは、明示的なアクセス権を持つユーザーにのみ表示されます。 |
| public |
プロジェクトはすべてのユーザーに表示されます。 |
ReferenceLinks
REST 参照リンクのコレクションを表すクラス。
| 名前 | 型 | 説明 |
|---|---|---|
| links |
object |
リンクの読み取りビュー。 参照リンクは読み取り専用であるため、読み取り専用として公開する必要があります。 |
TeamProject
チーム プロジェクト オブジェクトを表します。
| 名前 | 型 | 説明 |
|---|---|---|
| _links |
このオブジェクトに関連する他のオブジェクトへのリンク。 |
|
| abbreviation |
string |
プロジェクトの省略形。 |
| capabilities |
object |
このプロジェクトが持つ一連の機能 (プロセス テンプレート & バージョン管理など)。 |
| defaultTeam |
既定のチームへの浅い参照。 |
|
| defaultTeamImageUrl |
string |
既定のチーム ID イメージの URL。 |
| description |
string |
プロジェクトの説明 (ある場合)。 |
| id |
string (uuid) |
プロジェクト識別子。 |
| lastUpdateTime |
string (date-time) |
プロジェクトの最終更新時刻。 |
| name |
string |
プロジェクト名。 |
| revision |
integer (int64) |
プロジェクトのリビジョン。 |
| state |
プロジェクトの状態。 |
|
| url |
string |
オブジェクトの完全なバージョンへの URL。 |
| visibility |
プロジェクトの可視性。 |
WebApiTeamRef
| 名前 | 型 | 説明 |
|---|---|---|
| id |
string (uuid) |
チーム (ID) Guid。 Team Foundation ID。 |
| name |
string |
チーム名 |
| url |
string |
Team REST API Url |