Feed Management - Create Feed

Service:

Artifacts

API Version:

5.1-preview.1

Crie um feed, um contêiner para vários tipos de pacote.

Os feeds poderão ser criados em um projeto se o parâmetro do projeto estiver incluído na URL de solicitação. Se o parâmetro do projeto for omitido, o feed não será associado a um projeto e será criado no nível da organização. A criação de feeds no escopo do projeto está em pré-lançamento e pode ainda não estar disponível em sua organização.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
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 '5.1-preview.1' para usar essa versão da api.

Corpo da solicitação

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: , |, /, \\, ?, :, &, $, *, \", #, [, ] ]]>
permissions	FeedPermission[]	Permissões explícitas para o feed.
project	ProjectReference	O projeto ao qual esse feed está associado.
upstreamEnabled	boolean	OBSOLETO: isso sempre deve ser verdadeiro. A configuração como false substituirá todas as fontes em UpstreamSources.
upstreamEnabledChangedDate	string	Se definido, a hora 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.

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_write	Concede a capacidade de criar e ler feeds e 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 sobre 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 sua Identidade, tipo de pacote e outras informações associadas.
UpstreamSourceType	Tipo de origem, como Público ou Interno.

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 ponto Não deve terminar com um ponto Não deve conter nenhum dos seguintes caracteres ilegais: , |, /, \\, ?, :, &, $, *, \", #, [, ] ]]>
permissions	FeedPermission[]	Permissões explícitas para o feed.
project	ProjectReference	O projeto ao qual este feed está associado.
upstreamEnabled	boolean	OBSOLETO: isso sempre deve ser verdadeiro. A configuração como false substituirá todas as fontes em UpstreamSources.
upstreamEnabledChangedDate	string	Se definido, a hora 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 para pacotes.
url	string	A URL do feed base no formulário GUID.
view	FeedView	Definição da 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 fornecer pacotes de upstream fontes os 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.
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 sobre 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
collection	string	O feed é acessível por todos os usuários válidos presentes na organização em que o feed reside (por exemplo, em toda a 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 de fundo 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 dessa 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 sua 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 mudar ao longo do tempo
id	string	Identidade da fonte de 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.
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 upstream.
name	string	Nome de exibição.
protocol	string	Tipo de pacote associado à origem 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	Azure DevOps upstream fonte.
public	string	Fonte disponível publicamente.