Feed Management - Get Feed

Service:

Artifacts

API Version:

7.1-preview.1

Obtenha as configurações de um feed específico.

O parâmetro do projeto deverá ser fornecido se o feed tiver sido criado em um projeto. Se o feed não estiver associado a nenhum projeto, omita o parâmetro de projeto da solicitação.

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

With optional parameters:

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
feedId	path	True	string	Nome ou ID do feed.
organization	path	True	string	O nome da organização do Azure DevOps.
project	path		string	ID do projeto ou nome do projeto
api-version	query	True	string	Versão da API a ser usada. Isso deve ser definido como '7.1-preview.1' para usar essa versão da api.
includeDeletedUpstreams	query		boolean	Inclua upstreams que foram excluídos na resposta.

Respostas

Nome	Tipo	Description
200 OK	Feed	operação bem-sucedida

Segurança

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

Nome	Description
vso.packaging	Concede a capacidade de ler feeds e pacotes. Também concede a capacidade de pesquisar pacotes.

Definições

Nome	Description
Feed	Um contêiner para artefatos.
FeedCapabilities	Recursos com suporte de um feed.
FeedPermission	Permissões para um feed.
FeedRole	A função para essa identidade em um feed.
FeedView	Uma exibição na parte superior de um feed.
FeedViewType	Tipo de exibição.
FeedVisibility	Visibilidade status da exibição.
IdentityDescriptor	Um descritor de identidade é um wrapper para o tipo de identidade (SID do Windows, Passport) juntamente com um identificador exclusivo, como o SID ou PUID.
ProjectReference
ReferenceLinks	A classe para representar uma coleção de links de referência REST.
UpstreamSource	Definição de origem upstream, incluindo identidade, tipo de pacote e outras informações associadas.
UpstreamSourceType	Tipo de origem, como Público ou Interno.
UpstreamStatus	Especifica o status do upstream.
UpstreamStatusDetail

Feed

Um contêiner para artefatos.

Nome	Tipo	Description
_links	ReferenceLinks	Links REST relacionados.
badgesEnabled	boolean	Se definido, esse feed dá suporte à geração de selos de pacote.
capabilities	FeedCapabilities	Recursos com suporte de um feed.
defaultViewId	string	A exibição que o administrador do feed indicou é a experiência padrão para leitores.
deletedDate	string	A data em que esse feed foi excluído.
description	string	Uma descrição para o feed. As descrições não devem exceder 255 caracteres.
fullyQualifiedId	string	Esse será o GUID do feed ou o GUID do feed e o GUID de exibição, dependendo de como o feed foi acessado.
fullyQualifiedName	string	Nome completo do modo de exibição, no formato feed@view.
hideDeletedPackageVersions	boolean	Se definido, o feed ocultará todas as versões excluídas/não publicadas
id	string	Um GUID que identifica exclusivamente esse feed.
isReadOnly	boolean	Se definido, todos os pacotes no feed serão imutáveis. É importante observar que as exibições de feed são imutáveis; portanto, esse sinalizador sempre será definido para exibições.
name	string	Um nome para o feed. Os nomes de feed devem seguir estas regras: não deve exceder 64 caracteres Não deve conter espaços em branco Não deve começar com um sublinhado ou um período Não deve terminar com um período Não deve conter nenhum dos seguintes caracteres ilegais: , |, /, \\, ?, :, &, $, *, \", #, [, ] ]]>
permanentDeletedDate	string	A data em que esse feed foi excluído permanentemente.
permissions	FeedPermission[]	Permissões explícitas para o feed.
project	ProjectReference	O projeto ao qual esse feed está associado.
scheduledPermanentDeleteDate	string	A data em que este feed está agendado para ser excluído permanentemente.
upstreamEnabled	boolean	Isso sempre deve ser verdade. A configuração como false substituirá todas as fontes em UpstreamSources.
upstreamEnabledChangedDate	string	Se definido, o tempo em que a propriedade UpstreamEnabled foi alterada. Será nulo se UpstreamEnabled nunca tiver sido alterado após a criação do Feed.
upstreamSources	UpstreamSource[]	Uma lista de fontes das quais esse feed buscará pacotes. Uma lista vazia indica que esse feed não pesquisará nenhuma fonte adicional em busca de pacotes.
url	string	A URL do feed base no formulário GUID.
view	FeedView	Definição do modo de exibição.
viewId	string	ID de exibição.
viewName	string	Nome da exibição.

FeedCapabilities

Recursos com suporte de um feed.

Nome	Tipo	Description
defaultCapabilities	string	As funcionalidades fornecidas a um feed recém-criado
none	string	Não existem sinalizadores para este feed
underMaintenance	string	Este feed está atualmente em manutenção e pode ter funcionalidade reduzida
upstreamV2	string	Esse feed pode atender pacotes de upstream fontes Pacotes upstream devem ser promovidos manualmente para exibições

FeedPermission

Permissões para um feed.

Nome	Tipo	Description
displayName	string	Nome de exibição para a identidade.
identityDescriptor	IdentityDescriptor	Identidade associada a essa função.
identityId	string	Id da identidade associada a essa função.
isInheritedRole	boolean	Booliano que indica se a função é herdada ou definida diretamente.
role	FeedRole	A função para essa identidade em um feed.

FeedRole

A função para essa identidade em um feed.

Nome	Tipo	Description
administrator	string	Os administradores têm controle total sobre o feed.
collaborator	string	Os colaboradores têm as mesmas permissões que os leitores, mas também podem ingerir pacotes de fontes de upstream configuradas.
contributor	string	Os colaboradores podem fazer qualquer coisa com pacotes no feed, incluindo a adição de novos pacotes, mas podem não modificar as configurações do feed.
custom	string	Sem suporte:
none	string	Sem suporte:
reader	string	Os leitores só podem ler pacotes e exibir configurações.

FeedView

Uma exibição na parte superior de um feed.

Nome	Tipo	Description
_links	ReferenceLinks	Links REST relacionados.
id	string	Id da exibição.
name	string	Nome da exibição.
type	FeedViewType	Tipo de exibição.
url	string	URL da exibição.
visibility	FeedVisibility	Visibilidade status da exibição.

FeedViewType

Tipo de exibição.

Nome	Tipo	Description
implicit	string	Tipo de exibição interno que é criado e gerenciado automaticamente pelo sistema.
none	string	Tipo de exibição padrão não especificado.
release	string	Exibição usada como um destino de promoção para classificar artefatos lançados.

FeedVisibility

Visibilidade status da exibição.

Nome	Tipo	Description
aadTenant	string	O feed é acessível por todos os usuários válidos presentes no locatário do Azure Active Directory.
collection	string	O feed é acessível por todos os usuários válidos presentes na organização em que o feed reside (por exemplo, na organização 'myorg' em 'dev.azure.com/myorg')
organization	string	O feed é acessível por todos os usuários válidos presentes na empresa em que o feed reside. Observe que a nomenclatura herdada e a compatibilidade traseira deixam o nome desse valor fora de sincronia com seu novo significado.
private	string	Acessível somente pelas permissões definidas explicitamente pelo administrador do feed.

IdentityDescriptor

Um descritor de identidade é um wrapper para o tipo de identidade (SID do Windows, Passport) juntamente com um identificador exclusivo, como o SID ou PUID.

Nome	Tipo	Description
identifier	string	O identificador exclusivo para essa identidade, não excedendo 256 caracteres, que serão persistidos.
identityType	string	Tipo de descritor (por exemplo, Windows, Passport etc.).

ProjectReference

Nome	Tipo	Description
id	string	Obtém ou define a ID do projeto.
name	string	Obtém ou define o nome do projeto.
visibility	string	Obtém ou define a visibilidade do projeto.

ReferenceLinks

A classe para representar uma coleção de links de referência REST.

Nome	Tipo	Description
links	object	A exibição somente leitura dos links. Como os links de referência são somente leitura, só queremos expô-los como somente leitura.

UpstreamSource

Definição de origem upstream, incluindo identidade, tipo de pacote e outras informações associadas.

Nome	Tipo	Description
deletedDate	string	Data UTC em que esse upstream foi excluído.
displayLocation	string	Localizador para se conectar à origem do upstream em um formato amigável, que pode potencialmente mudar ao longo do tempo
id	string	Identidade da origem do upstream.
internalUpstreamCollectionId	string	Para um tipo de upstream interno, acompanhe a organização do Azure DevOps que o contém.
internalUpstreamFeedId	string	Para um tipo de upstream interno, acompanhe a ID do feed que está sendo referenciada.
internalUpstreamProjectId	string	Para um tipo de upstream interno, acompanhe o projeto do feed que está sendo referenciado.
internalUpstreamViewId	string	Para um tipo de upstream interno, acompanhe a exibição do feed que está sendo referenciado.
location	string	Localizador consistente para se conectar à origem do upstream.
name	string	Nome de exibição.
protocol	string	Tipo de pacote associado à origem do upstream.
serviceEndpointId	string	A identidade do ponto de extremidade de serviço que contém credenciais a serem usadas ao acessar o upstream.
serviceEndpointProjectId	string	Especifica a projectId do ponto de extremidade de serviço.
status	UpstreamStatus	Especifica o status do upstream.
statusDetails	UpstreamStatusDetail[]	Fornece um motivo legível para a status do upstream.
upstreamSourceType	UpstreamSourceType	Tipo de origem, como Público ou Interno.

UpstreamSourceType

Tipo de origem, como Público ou Interno.

Nome	Tipo	Description
internal	string	Origem upstream do Azure DevOps.
public	string	Origem disponível publicamente.

UpstreamStatus

Especifica o status do upstream.

Nome	Tipo	Description
disabled	string	A origem upstream está desabilitada.
ok	string	A origem upstream está ok.

UpstreamStatusDetail

Nome	Tipo	Description
reason	string	Fornece um motivo legível para a status do upstream.