Artifact Details - Get Packages
피드의 모든 패키지에 대한 세부 정보를 가져옵니다. 다양한 필터를 사용하여 결과 집합에서 정보를 포함하거나 제외합니다.
프로젝트에서 피드를 만든 경우 프로젝트 매개 변수를 제공해야 합니다. 피드가 프로젝트와 연결되지 않은 경우 요청에서 프로젝트 매개 변수를 생략합니다.
GET https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/Feeds/{feedId}/packages?api-version=7.1
GET https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/Feeds/{feedId}/packages?protocolType={protocolType}&packageNameQuery={packageNameQuery}&normalizedPackageName={normalizedPackageName}&includeUrls={includeUrls}&includeAllVersions={includeAllVersions}&isListed={isListed}&getTopPackageVersions={getTopPackageVersions}&isRelease={isRelease}&includeDescription={includeDescription}&$top={$top}&$skip={$skip}&includeDeleted={includeDeleted}&isCached={isCached}&directUpstreamId={directUpstreamId}&api-version=7.1
URI 매개 변수
| Name | In(다음 안에) | 필수 | 형식 | Description |
|---|---|---|---|---|
|
feed
|
path | True |
string |
피드의 이름 또는 ID입니다. |
|
organization
|
path | True |
string |
Azure DevOps 조직의 이름입니다. |
|
project
|
path |
string |
프로젝트 ID 또는 프로젝트 이름 |
|
|
api-version
|
query | True |
string |
사용할 API의 버전입니다. 이 버전의 API를 사용하려면 '7.1'로 설정해야 합니다. |
|
$skip
|
query |
integer (int32) |
첫 번째 N 패키지(또는 getTopPackageVersions=true인 패키지 버전)를 건너뜁니다. |
|
|
$top
|
query |
integer (int32) |
상위 N 패키지(또는 getTopPackageVersions=true인 패키지 버전) 가져오기 |
|
|
direct
|
query |
string (uuid) |
결과를 필터링하여 특정 업스트림에서 패키지를 반환합니다. |
|
|
get
|
query |
boolean |
각 패키지의 모든 버전을 $top 반환하도록 $top 및 $skip 동작을 변경합니다. includeAllVersions=true와 함께 사용해야 합니다. |
|
|
include
|
query |
boolean |
응답에서 패키지의 모든 버전을 반환하려면 True입니다. 기본값은 false입니다(최신 버전에만 해당). |
|
|
include
|
query |
boolean |
응답에서 삭제되거나 게시되지 않은 패키지 버전을 반환합니다. 기본값은 False입니다. |
|
|
include
|
query |
boolean |
응답에서 각 패키지의 모든 버전에 대한 설명을 반환합니다. 기본값은 False입니다. |
|
|
include
|
query |
boolean |
응답과 함께 REST URL을 반환하려면 True입니다. 기본값은 True입니다. |
|
|
is
|
query |
boolean |
[사용되지 않음] 레거시 시나리오에 사용되며 이후 버전에서 제거될 수 있습니다. |
|
|
is
|
query |
boolean |
NuGet 패키지에만 적용되며 다른 패키지 유형에 대해 설정하면 404가 발생합니다. false이면 나열되지 않은 패키지 버전이 반환됩니다. includeAllVersions가 true로 설정된 경우 이 값을 사용하여 응답을 필터링합니다. 기본값은 설정되지 않습니다(목록에 없는 패키지는 반환하지 않음). |
|
|
is
|
query |
boolean |
Nuget 패키지에만 적용됩니다. includeAllVersions가 true로 설정된 경우 이 값을 사용하여 응답을 필터링합니다. 기본값은 True입니다(시험판 버전 관리가 없는 패키지만 반환). |
|
|
normalized
|
query |
string |
[사용되지 않음] 레거시 시나리오에 사용되며 이후 버전에서 제거될 수 있습니다. |
|
|
package
|
query |
string |
제공된 문자열을 포함하는 패키지로 필터링합니다. 문자열의 문자는 패키지 이름 제약 조건을 준수해야 합니다. |
|
|
protocol
|
query |
string |
지원되는 아티팩트 패키지 유형 중 하나입니다. |
응답
| Name | 형식 | Description |
|---|---|---|
| 200 OK |
Package[] |
성공한 작업 |
보안
oauth2
형식:
oauth2
Flow:
accessCode
권한 부여 URL:
https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
토큰 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
범위
| Name | Description |
|---|---|
| vso.packaging | 피드 및 패키지를 읽을 수 있는 기능을 부여합니다. 패키지를 검색하는 기능도 부여합니다. |
정의
| Name | Description |
|---|---|
|
Feed |
피드 맨 위에 있는 보기입니다. |
|
Feed |
보기 유형입니다. |
|
Feed |
보기의 표시 유형 상태입니다. |
|
Minimal |
ID 및 버전 정보 및 기본 상태를 포함하여 모든 패키지에 대한 핵심 데이터입니다. |
| Package |
하나 이상의 패키지 버전에 대한 컨테이너인 패키지입니다. |
|
Reference |
REST 참조 링크의 컬렉션을 나타내는 클래스입니다. |
FeedView
피드 맨 위에 있는 보기입니다.
| Name | 형식 | Description |
|---|---|---|
| _links |
관련 REST 링크입니다. |
|
| id |
string (uuid) |
보기의 ID입니다. |
| name |
string |
보기의 이름입니다. |
| type |
보기 유형입니다. |
|
| url |
string |
보기의 URL입니다. |
| visibility |
보기의 표시 유형 상태입니다. |
FeedViewType
보기 유형입니다.
| 값 | Description |
|---|---|
| none |
기본, 지정되지 않은 뷰 형식입니다. |
| release |
릴리스된 아티팩트를 분류하기 위해 승격 대상으로 사용되는 보기입니다. |
| implicit |
시스템에서 자동으로 만들어지고 관리되는 내부 뷰 형식입니다. |
FeedVisibility
보기의 표시 유형 상태입니다.
| 값 | Description |
|---|---|
| private |
피드 관리자가 명시적으로 설정한 권한에서만 액세스할 수 있습니다. |
| collection |
피드가 있는 조직에 있는 모든 유효한 사용자가 피드에 액세스할 수 있습니다(예: 'dev.azure.com/myorg'의 조직 'myorg'). |
| organization |
피드는 피드가 있는 엔터프라이즈에 있는 모든 유효한 사용자가 액세스할 수 있습니다. 레거시 명명 및 백 호환성은 이 값의 이름이 새로운 의미와 동기화되지 않습니다. |
| aadTenant |
피드는 Azure Active Directory 테넌트에 있는 모든 유효한 사용자가 액세스할 수 있습니다. |
MinimalPackageVersion
ID 및 버전 정보 및 기본 상태를 포함하여 모든 패키지에 대한 핵심 데이터입니다.
| Name | 형식 | Description |
|---|---|---|
| directUpstreamSourceId |
string (uuid) |
이 패키지가 수집된 업스트림 원본입니다. |
| id |
string (uuid) |
패키지의 ID입니다. |
| isCachedVersion |
boolean |
[사용되지 않음] 레거시 시나리오에 사용되며 이후 버전에서 제거될 수 있습니다. |
| isDeleted |
boolean |
이 패키지가 삭제된 경우 True입니다. |
| isLatest |
boolean |
True이면 패키지 유형 정렬 순서에 따라 패키지의 최신 버전입니다. |
| isListed |
boolean |
(NuGet 및 Cargo만 해당) 이 패키지가 나열되면 True입니다. |
| normalizedVersion |
string |
패키지 유형과 관련된 정규화 규칙을 사용하여 정규화된 버전입니다. |
| packageDescription |
string |
패키지 설명입니다. |
| publishDate |
string (date-time) |
패키지가 서비스에 게시된 UTC 날짜입니다. |
| storageId |
string |
내부 스토리지 ID입니다. |
| version |
string |
표시 버전입니다. |
| views |
Feed |
이 패키지 버전을 포함하는 뷰 목록입니다. |
Package
하나 이상의 패키지 버전에 대한 컨테이너인 패키지입니다.
| Name | 형식 | Description |
|---|---|---|
| _links |
관련 REST 링크입니다. |
|
| id |
string (uuid) |
패키지의 ID입니다. |
| isCached |
boolean |
레거시 시나리오에 사용되며 이후 버전에서 제거될 수 있습니다. |
| name |
string |
패키지의 표시 이름입니다. |
| normalizedName |
string |
패키지 형식 내에서 이 패키지의 ID를 나타내는 정규화된 이름입니다. |
| protocolType |
string |
패키지의 형식입니다. |
| starCount |
integer (int32) |
[사용되지 않음] - 이 필드는 사용되지 않으며 향후 릴리스에서 제거될 예정입니다. |
| url |
string |
이 패키지의 URL입니다. |
| versions |
피드 내의 이 패키지에 대한 모든 버전입니다. |
ReferenceLinks
REST 참조 링크의 컬렉션을 나타내는 클래스입니다.
| Name | 형식 | Description |
|---|---|---|
| links |
object |
링크의 읽기 전용 보기입니다. 참조 링크는 읽기 전용이므로 읽기 전용으로만 노출하려고 합니다. |