Gerenciar revisões

Esta página se aplica à Apigee e à Apigee híbrida.

Visualização — Apigee API hub

Esse recurso está sujeito aos "Termos de ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos de serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Cada API no hub de APIs pode ter várias versões, e cada versão pode ter uma especificação que pode ter várias revisões. A guia Histórico na página "APIs" lista cada revisão de especificação em todas as versões da API.

Ver esquema do Registro da API

Veja a seguir a relação entre as APIs do hub da API, as versões, as implantações e as especificações.

Referência	Item	Descrição
	Registro	O registro é um conjunto de APIs que serve como um catálogo de APIs.
	Versão	Uma API pode ter várias versões. A versão precisa corresponder a uma interface estável que os clientes podem usar para chamar uma API. Uma dessas versões pode ser designada como a recomendada. Na terminologia semver, é uma prática recomendada que as versões sejam versões principais.
	Deployment	Uma API pode ter várias implantações, por exemplo, diferentes ambientes ou regiões de preparo. Uma implantação é um local (um endereço) em que os usuários podem acessar uma API. Uma dessas implantações pode ser a recomendada.
	Especificação	Recomendamos, mas não é obrigatório, que uma versão da API seja descrita por especificações formais, geralmente usando diferentes formatos de especificação de API. Um desses formatos de especificação pode ser principal, o que indica que outras especificações dessa versão são derivadas dela.
	Revisões	As implantações têm um histórico de revisões. As revisões de implantação representam instâncias específicas de uma implantação a tempo e podem se referir a uma ou mais revisões de especificações, se a implementação da API exibida pela implantação for alterada. As especificações têm um histórico de revisões. As revisões de especificação representam instâncias subsequentes de uma especificação e normalmente representam alterações não interruptivas no conteúdo das especificações. Na terminologia semver, as revisões podem corresponder a versões secundárias ou pontuais.

Classificar tabela de revisão

Clique no cabeçalho da coluna Atualizado para classificar a tabela.

Adicionar revisão

Para adicionar uma revisão:

1. No console do Google Cloud, acesse a página Hub de APIs.

   Acesse o hub de API

   A página da lista APIs é exibida por padrão.

2. Na lista APIs, clique em uma linha da API. A guia Visão geral é exibida por padrão.
3. Selecione a guia Histórico.
4. Clique em Adicionar revisão.
5. Clique em Navegar e selecione um documento de descrição ou um arquivo ZIP.
6. Clique em Abrir.
7. Especifique Detalhes:
   • Selecione uma versão de API.
   • Selecione um tipo MIME Se você selecionar Outro, um campo de texto será exibido e será possível especificar manualmente o tipo MIME.
   • Digite uma mensagem de confirmação (opcional).
   • Digite um hash de confirmação (opcional).
8. Clique em Salvar (ou Cancelar).

Observação: O Documento de identificação na colunaHistórico da tabela é o ID da revisão conforme aparece na API Registry.

Ver revisão

Consulte Visualizar ou fazer o download de uma especificação

Excluir revisão

Para excluir uma revisão:

1. No console do Cloud, acesse a página Hub de APIs.

   Acesse o hub de API

   A página da lista APIs é exibida por padrão.

2. Na lista APIs, clique em uma linha da API. A guia Visão geral é exibida por padrão.
3. Selecione a guia Histórico.
4. Clique em Excluir ao lado da revisão desejada.
5. Clique em Excluir (ou Cancelar) no prompt.