Feed Management - Create Feed
さまざまなパッケージの種類のコンテナーであるフィードを作成します。
プロジェクト パラメーターが要求 URL に含まれている場合は、プロジェクトにフィードを作成できます。 プロジェクト パラメーターを省略すると、フィードはプロジェクトに関連付けされず、organization レベルで作成されます。 プロジェクト スコープフィードの作成はプレリリース段階であり、organizationではまだ使用できない場合があります。
POST https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/feeds?api-version=5.1-preview.1
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
organization
|
path | True |
string |
Azure DevOps 組織の名前です。 |
project
|
path |
string |
プロジェクト ID またはプロジェクト名 |
|
api-version
|
query | True |
string |
使う API のバージョン。 このバージョンの API を使用するには、これを '5.1-preview.1' に設定する必要があります。 |
要求本文
名前 | 型 | 説明 |
---|---|---|
_links |
関連する REST リンク。 |
|
badgesEnabled |
boolean |
設定されている場合、このフィードではパッケージ バッジの生成がサポートされます。 |
capabilities |
フィードのサポートされている機能。 |
|
defaultViewId |
string |
フィード管理者が示したビューは、閲覧者の既定のエクスペリエンスです。 |
deletedDate |
string |
このフィードが削除された日付。 |
description |
string |
フィードの説明。 説明は 255 文字以内にする必要があります。 |
fullyQualifiedId |
string |
これはフィード GUID またはフィード GUID のいずれかであり、フィードへのアクセス方法に応じて GUID を表示します。 |
fullyQualifiedName |
string |
ビューの完全な名前 (feed@view形式)。 |
hideDeletedPackageVersions |
boolean |
設定すると、フィードはすべての削除済み/未発行バージョンを非表示にします |
id |
string |
このフィードを一意に識別する GUID。 |
isReadOnly |
boolean |
設定されている場合、フィード内のすべてのパッケージは変更できません。 フィード ビューは不変であることに注意することが重要です。したがって、このフラグは常にビューに設定されます。 |
name |
string |
フィードの名前。 フィード名は、次の規則に従う必要があります: 64 文字を超えてはなりません空白文字を含めてはいけません。アンダースコアまたはピリオドで終わってはいけません。ピリオドで終わる必要があります。無効な文字を含めてはいけません: 、|、/、\\、?、:、&、$、*、\"、#、[、]]]]> |
permissions |
フィードの明示的なアクセス許可。 |
|
project |
このフィードが関連付けられているプロジェクト。 |
|
upstreamEnabled |
boolean |
現在は使用されていません。これは常に true である必要があります。 false に設定すると、UpstreamSources 内のすべてのソースがオーバーライドされます。 |
upstreamEnabledChangedDate |
string |
設定されている場合、UpstreamEnabled プロパティが変更された時刻。 フィードの作成後に UpstreamEnabled が変更されなかった場合は null になります。 |
upstreamSources |
このフィードがパッケージをフェッチするソースの一覧。 空のリストは、このフィードがパッケージの追加のソースを検索しないことを示します。 |
|
url |
string |
GUID 形式のベース フィードの URL。 |
view |
ビューの定義。 |
|
viewId |
string |
ビュー ID。 |
viewName |
string |
ビューの名前。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
成功した操作 |
セキュリティ
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
名前 | 説明 |
---|---|
vso.packaging_write | フィードとパッケージを作成および読み取る機能を付与します。 |
定義
名前 | 説明 |
---|---|
Feed |
成果物のコンテナー。 |
Feed |
フィードのサポートされている機能。 |
Feed |
フィードのアクセス許可。 |
Feed |
フィードでのこの ID のロール。 |
Feed |
フィードの上のビュー。 |
Feed |
ビューの種類。 |
Feed |
ビューの表示状態。 |
Identity |
ID 記述子は、ID の種類 (Windows SID、Passport) のラッパーであり、SID や PUID などの一意の識別子です。 |
Project |
|
Reference |
REST 参照リンクのコレクションを表す クラス。 |
Upstream |
アップストリーム ソース定義 (ID、パッケージの種類、およびその他の関連情報を含む)。 |
Upstream |
ソースの種類 (Public や Internal など)。 |
Feed
成果物のコンテナー。
名前 | 型 | 説明 |
---|---|---|
_links |
関連する REST リンク。 |
|
badgesEnabled |
boolean |
設定されている場合、このフィードではパッケージ バッジの生成がサポートされます。 |
capabilities |
フィードのサポートされている機能。 |
|
defaultViewId |
string |
フィード管理者が示したビューは、閲覧者の既定のエクスペリエンスです。 |
deletedDate |
string |
このフィードが削除された日付。 |
description |
string |
フィードの説明。 説明は 255 文字以内にする必要があります。 |
fullyQualifiedId |
string |
これはフィード GUID またはフィード GUID のいずれかであり、フィードへのアクセス方法に応じて GUID を表示します。 |
fullyQualifiedName |
string |
ビューの完全な名前 (feed@view形式)。 |
hideDeletedPackageVersions |
boolean |
設定すると、フィードはすべての削除済み/未発行バージョンを非表示にします |
id |
string |
このフィードを一意に識別する GUID。 |
isReadOnly |
boolean |
設定されている場合、フィード内のすべてのパッケージは不変です。 フィード ビューは不変であることに注意することが重要です。したがって、このフラグは常にビューに対して設定されます。 |
name |
string |
フィードの名前。 フィード名は、次の規則に従う必要があります。64 文字を超えてはなりません空白文字を含めてはなりません。アンダースコアで始まる必要があります。ピリオドで終わる必要があります。ピリオドで終わる必要があります。次の無効な文字を含めてはいけません: 、|、/、\\、?、:、&、$、*、\"、#、[、]]]> |
permissions |
フィードの明示的なアクセス許可。 |
|
project |
このフィードが関連付けられているプロジェクト。 |
|
upstreamEnabled |
boolean |
廃止: これは常に true である必要があります。 を false に設定すると、UpstreamSources 内のすべてのソースがオーバーライドされます。 |
upstreamEnabledChangedDate |
string |
設定されている場合、UpstreamEnabled プロパティが変更された時刻。 フィードの作成後に UpstreamEnabled が変更されなかった場合は null になります。 |
upstreamSources |
このフィードがパッケージをフェッチするソースの一覧。 空のリストは、このフィードがパッケージの追加ソースを検索しないことを示します。 |
|
url |
string |
GUID 形式のベース フィードの URL。 |
view |
ビューの定義。 |
|
viewId |
string |
表示 ID。 |
viewName |
string |
ビューの名前。 |
FeedCapabilities
フィードのサポートされている機能。
名前 | 型 | 説明 |
---|---|---|
defaultCapabilities |
string |
新しく作成されたフィードに与えられる機能 |
none |
string |
このフィードにフラグが存在しません |
underMaintenance |
string |
このフィードは現在メンテナンス中であり、機能が低下している可能性があります |
upstreamV2 |
string |
このフィードは、アップストリーム ソースからのパッケージを提供できます。アップストリーム パッケージは、手動でビューに昇格する必要があります |
FeedPermission
フィードのアクセス許可。
名前 | 型 | 説明 |
---|---|---|
displayName |
string |
ID の表示名。 |
identityDescriptor |
このロールに関連付けられている ID。 |
|
identityId |
string |
このロールに関連付けられている ID の ID。 |
role |
フィードでのこの ID のロール。 |
FeedRole
フィードでのこの ID のロール。
名前 | 型 | 説明 |
---|---|---|
administrator |
string |
管理者はフィードを完全に制御できます。 |
collaborator |
string |
コラボレーターには閲覧者と同じアクセス許可がありますが、構成されたアップストリーム ソースからパッケージを取り込むこともできます。 |
contributor |
string |
共同作成者は、新しいパッケージの追加を含め、フィード内のパッケージに対して何かを行うことができますが、フィード設定を変更できない場合があります。 |
custom |
string |
サポートされていません。 |
none |
string |
サポートされていません。 |
reader |
string |
閲覧者はパッケージの読み取りと設定の表示のみを行うことができます。 |
FeedView
フィードの上のビュー。
名前 | 型 | 説明 |
---|---|---|
_links |
関連する REST リンク。 |
|
id |
string |
ビューの ID。 |
name |
string |
ビューの名前。 |
type |
ビューの種類。 |
|
url |
string |
ビューの URL。 |
visibility |
ビューの表示状態。 |
FeedViewType
ビューの種類。
名前 | 型 | 説明 |
---|---|---|
implicit |
string |
システムによって自動的に作成および管理される内部ビューの種類。 |
none |
string |
既定の未指定のビューの種類。 |
release |
string |
リリースされた成果物を分類するための昇格先として使用されるビュー。 |
FeedVisibility
ビューの表示状態。
名前 | 型 | 説明 |
---|---|---|
collection |
string |
フィードには、フィードが存在するorganizationに存在するすべての有効なユーザーがアクセスできます (たとえば、"dev.azure.com/myorg" の "myorg" organizationまたがっています) |
organization |
string |
フィードには、フィードが存在する企業内に存在するすべての有効なユーザーがアクセスできます。 従来の名前付けとバック 互換性により、この値の名前は新しい意味と同期されません。 |
private |
string |
フィード管理者によって明示的に設定されたアクセス許可によってのみアクセスできます。 |
IdentityDescriptor
ID 記述子は、ID の種類 (Windows SID、Passport) のラッパーであり、SID や PUID などの一意の識別子です。
名前 | 型 | 説明 |
---|---|---|
identifier |
string |
この ID の一意識別子 。256 文字を超えず、永続化されます。 |
identityType |
string |
記述子の種類 (Windows、Passport など)。 |
ProjectReference
名前 | 型 | 説明 |
---|---|---|
id |
string |
プロジェクトの ID を取得または設定します。 |
name |
string |
プロジェクトの名前を取得または設定します。 |
visibility |
string |
プロジェクトの可視性を取得または設定します。 |
ReferenceLinks
REST 参照リンクのコレクションを表す クラス。
名前 | 型 | 説明 |
---|---|---|
links |
object |
リンクの読み取り時ビュー。 参照リンクは読み取り専用であるため、参照リンクは読み取り専用として公開する必要があります。 |
UpstreamSource
アップストリーム ソース定義 (ID、パッケージの種類、およびその他の関連情報を含む)。
名前 | 型 | 説明 |
---|---|---|
deletedDate |
string |
このアップストリームが削除された UTC 日付。 |
displayLocation |
string |
アップストリーム ソースにユーザー フレンドリな形式で接続するためのロケーター。時間の経過と伴って変化する可能性があります |
id |
string |
アップストリーム ソースの ID。 |
internalUpstreamCollectionId |
string |
内部アップストリーム型の場合は、それを含む Azure DevOps organizationを追跡します。 |
internalUpstreamFeedId |
string |
内部アップストリーム型の場合は、参照されているフィード ID を追跡します。 |
internalUpstreamViewId |
string |
内部アップストリーム タイプの場合は、参照されているフィードのビューを追跡します。 |
location |
string |
アップストリーム ソースに接続するための一貫性のあるロケーター。 |
name |
string |
表示名。 |
protocol |
string |
アップストリーム ソースに関連付けられているパッケージの種類。 |
upstreamSourceType |
ソースの種類 (Public や Internal など)。 |
UpstreamSourceType
ソースの種類 (Public や Internal など)。
名前 | 型 | 説明 |
---|---|---|
internal |
string |
Azure DevOps アップストリーム ソース。 |
public |
string |
パブリックに利用可能なソース。 |