Attachments - Create
添付ファイルをアップロードします。
添付ファイルのアップロード制限 (>130 MB) が高いアカウントでは、チャンクアップロードを使用する必要があります。 複数のチャンクで添付ファイルをアップロードするには、最初に[チャンクされたアップロードを開始する]をしてから、「Upload Chunk」セクションの例に従う必要があります。
POST https://dev.azure.com/{organization}/{project}/_apis/wit/attachments?api-version=7.1
POST https://dev.azure.com/{organization}/{project}/_apis/wit/attachments?fileName={fileName}&uploadType={uploadType}&areaPath={areaPath}&api-version=7.1
URI パラメーター
| 名前 | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
organization
|
path | True |
string |
Azure DevOps 組織の名前。 |
|
project
|
path |
string |
プロジェクト ID またはプロジェクト名 |
|
|
api-version
|
query | True |
string |
使用する API のバージョン。 このバージョンの API を使用するには、これを '7.1' に設定する必要があります。 |
|
area
|
query |
string |
ターゲット プロジェクトの領域パス |
|
|
file
|
query |
string |
ファイルの名前 |
|
|
upload
|
query |
string |
添付ファイルのアップロードの種類: 単純またはチャンク |
要求本文
Media Types: "application/octet-stream"
| 名前 | 型 | 説明 |
|---|---|---|
| body |
string (Stream) |
アップロードするストリーム |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 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.work_write | 作業項目とクエリの読み取り、作成、更新、ボード メタデータの更新、領域の読み取り、反復パスに関連するメタデータの追跡、クエリの実行、サービス フックを介した作業項目イベントに関する通知の受信を行う機能を付与します。 |
例
| Start a Chunked Upload |
| Upload a binary file |
| Upload a text file |
Start a Chunked Upload
要求のサンプル
POST https://dev.azure.com/fabrikam/_apis/wit/attachments?fileName=largefile.zip&uploadType=chunked&api-version=7.1
応答のサンプル
{
"id": "de471719-27b2-40ab-ac40-4890f3eb1443",
"url": "https://dev.azure.com/fabrikam/_apis/wit/attachments/de471719-27b2-40ab-ac40-4890f3eb1443?fileName=test.txt"
}
Upload a binary file
要求のサンプル
POST https://dev.azure.com/fabrikam/_apis/wit/attachments?fileName=imageAsFileAttachment.png&api-version=7.1
"[BINARY FILE CONTENT]"
応答のサンプル
{
"id": "a5cedde4-2dd5-4fcf-befe-fd0977dd3433",
"url": "https://dev.azure.com/fabrikam/_apis/wit/attachments/a5cedde4-2dd5-4fcf-befe-fd0977dd3433?fileName=imageAsFileAttachment.png"
}
Upload a text file
要求のサンプル
POST https://dev.azure.com/fabrikam/_apis/wit/attachments?fileName=textAsFileAttachment.txt&api-version=7.1
"User text content to upload"
応答のサンプル
{
"id": "6b2266bf-a155-4582-a475-ca4da68193ef",
"url": "https://dev.azure.com/fabrikam/_apis/wit/attachments/6b2266bf-a155-4582-a475-ca4da68193ef?fileName=textAsFileAttachment.txt"
}
定義
AttachmentReference
| 名前 | 型 | 説明 |
|---|---|---|
| id |
string (uuid) |
|
| url |
string |