Feed Management - Get Feed

特定のフィードの設定を取得します。

フィードがプロジェクトで作成された場合は、プロジェクト パラメーターを指定する必要があります。 フィードがプロジェクトに関連付けられていない場合は、要求から project パラメーターを省略します。

GET https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feedId}?api-version=7.1-preview.1
GET https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feedId}?includeDeletedUpstreams={includeDeletedUpstreams}&api-version=7.1-preview.1

URI パラメーター

名前 / 必須 説明
feedId
path True

string

フィードの名前または ID。

organization
path True

string

Azure DevOps 組織の名前です。

project
path

string

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

api-version
query True

string

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

includeDeletedUpstreams
query

boolean

応答に削除されたアップストリームを含めます。

応答

名前 説明
200 OK

Feed

成功した操作

セキュリティ

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 フィードとパッケージを読み取る機能を付与します。 また、パッケージを検索する機能も付与されます。

定義

名前 説明
Feed

成果物のコンテナー。

FeedCapabilities

フィードのサポートされている機能。

FeedPermission

フィードのアクセス許可。

FeedRole

フィードでのこの ID のロール。

FeedView

フィードの上にあるビュー。

FeedViewType

ビューの種類。

FeedVisibility

ビューの表示状態。

IdentityDescriptor

ID 記述子は、ID の種類 (Windows SID、Passport) のラッパーであり、SID や PUID などの一意の識別子です。

ProjectReference
ReferenceLinks

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

UpstreamSource

アップストリーム ソース定義 (ID、パッケージの種類、およびその他の関連情報を含む)。

UpstreamSourceType

ソースの種類 (Public や Internal など)。

UpstreamStatus

アップストリームの状態を指定します。

UpstreamStatusDetail

Feed

成果物のコンテナー。

名前 説明
_links

ReferenceLinks

関連する REST リンク。

badgesEnabled

boolean

設定されている場合、このフィードではパッケージ バッジの生成がサポートされます。

capabilities

FeedCapabilities

フィードのサポートされている機能。

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 文字を超えてはなりません空白文字を含めてはいけません。アンダースコアまたはピリオドで終わってはいけません。ピリオドで終わる必要があります。無効な文字を含めてはいけません: 、|、/、\\、?、:、&、$、*、\"、#、[、]]]]>

permanentDeletedDate

string

このフィードが完全に削除された日付。

permissions

FeedPermission[]

フィードの明示的なアクセス許可。

project

ProjectReference

このフィードが関連付けられているプロジェクト。

scheduledPermanentDeleteDate

string

このフィードが完全に削除されるようにスケジュールされている日付。

upstreamEnabled

boolean

これは常に true である必要があります。 false に設定すると、UpstreamSources 内のすべてのソースがオーバーライドされます。

upstreamEnabledChangedDate

string

設定されている場合、UpstreamEnabled プロパティが変更された時刻。 フィードの作成後に UpstreamEnabled が変更されなかった場合は null になります。

upstreamSources

UpstreamSource[]

このフィードがパッケージをフェッチするソースの一覧。 空のリストは、このフィードがパッケージの追加のソースを検索しないことを示します。

url

string

GUID 形式のベース フィードの URL。

view

FeedView

ビューの定義。

viewId

string

ビュー ID。

viewName

string

ビューの名前。

FeedCapabilities

フィードのサポートされている機能。

名前 説明
defaultCapabilities

string

新しく作成されたフィードに与えられる機能

none

string

このフィードにフラグが存在しません

underMaintenance

string

このフィードは現在メンテナンス中であり、機能が低下している可能性があります

upstreamV2

string

このフィードは、アップストリーム ソースのパッケージを提供できます。アップストリーム パッケージは、手動でビューに昇格する必要があります

FeedPermission

フィードのアクセス許可。

名前 説明
displayName

string

ID の表示名。

identityDescriptor

IdentityDescriptor

このロールに関連付けられている ID。

identityId

string

このロールに関連付けられている ID の ID。

isInheritedRole

boolean

ロールが継承されるか、直接設定されるかを示すブール値。

role

FeedRole

フィードでのこの ID のロール。

FeedRole

フィードでのこの ID のロール。

名前 説明
administrator

string

管理者はフィードを完全に制御できます。

collaborator

string

コラボレーターには閲覧者と同じアクセス許可がありますが、構成されたアップストリーム ソースからパッケージを取り込むこともできます。

contributor

string

共同作成者は、新しいパッケージの追加を含め、フィード内のパッケージに対して何かを行うことができますが、フィード設定を変更できない場合があります。

custom

string

サポートされていません。

none

string

サポートされていません。

reader

string

閲覧者はパッケージを読み取り、設定を表示することしかできません。

FeedView

フィードの上にあるビュー。

名前 説明
_links

ReferenceLinks

関連する REST リンク。

id

string

ビューの ID。

name

string

ビューの名前。

type

FeedViewType

ビューの種類。

url

string

ビューの URL。

visibility

FeedVisibility

ビューの表示状態。

FeedViewType

ビューの種類。

名前 説明
implicit

string

システムによって自動的に作成および管理される内部ビューの種類。

none

string

既定の未指定のビューの種類。

release

string

リリースされた成果物を分類するための昇格先として使用されるビュー。

FeedVisibility

ビューの表示状態。

名前 説明
aadTenant

string

フィードには、Azure Active Directory テナントに存在するすべての有効なユーザーがアクセスできます。

collection

string

フィードには、フィードが存在するorganizationに存在するすべての有効なユーザーがアクセスできます (たとえば、'dev.azure.com/myorg' organization 'myorg' 全体)

organization

string

フィードには、フィードが存在する企業に存在するすべての有効なユーザーがアクセスできます。 従来の名前付けと back compat では、この値の名前は新しい意味と同期していません。

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

プロジェクトの可視性を取得または設定します。

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

名前 説明
links

object

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

UpstreamSource

アップストリーム ソース定義 (ID、パッケージの種類、およびその他の関連情報を含む)。

名前 説明
deletedDate

string

このアップストリームが削除された UTC 日付。

displayLocation

string

アップストリーム ソースにユーザー フレンドリな形式で接続するためのロケーター。時間の経過と同時に変更される可能性があります

id

string

アップストリーム ソースの ID。

internalUpstreamCollectionId

string

内部アップストリーム型の場合は、それを含む Azure DevOps organizationを追跡します。

internalUpstreamFeedId

string

内部アップストリーム型の場合は、参照されているフィード ID を追跡します。

internalUpstreamProjectId

string

内部上流タイプの場合は、参照されるフィードのプロジェクトを追跡します。

internalUpstreamViewId

string

内部アップストリーム タイプの場合は、参照されているフィードのビューを追跡します。

location

string

アップストリーム ソースに接続するための一貫したロケーター。

name

string

表示名。

protocol

string

アップストリーム ソースに関連付けられているパッケージの種類。

serviceEndpointId

string

アップストリームにアクセスするときに使用する資格情報を保持するサービス エンドポイントの ID。

serviceEndpointProjectId

string

サービス エンドポイントの projectId を指定します。

status

UpstreamStatus

アップストリームの状態を指定します。

statusDetails

UpstreamStatusDetail[]

アップストリームの状態を人間が判読できる理由を提供します。

upstreamSourceType

UpstreamSourceType

ソースの種類 (Public や Internal など)。

UpstreamSourceType

ソースの種類 (Public や Internal など)。

名前 説明
internal

string

Azure DevOps アップストリーム ソース。

public

string

一般公開されているソース。

UpstreamStatus

アップストリームの状態を指定します。

名前 説明
disabled

string

アップストリーム ソースが無効になっています。

ok

string

アップストリーム ソースは問題ありません。

UpstreamStatusDetail

名前 説明
reason

string

アップストリームの状態を人間が判読できる理由を提供します。