Controle de versão da API de gerenciamento de grade
A API de gerenciamento de grade usa controle de versão para oferecer suporte a atualizações sem interrupções.
Por exemplo, esta URL de solicitação especifica a versão 4 da API.
https://hostname_or_ip_address/api/v4/authorize
A versão principal da API é alterada quando são feitas alterações que não são compatíveis com versões mais antigas. A versão secundária da API é alterada quando são feitas alterações que são compatíveis com versões mais antigas. Alterações compatíveis incluem a adição de novos pontos de extremidade ou novas propriedades.
O exemplo a seguir ilustra como a versão da API é alterada com base no tipo de alterações feitas.
Tipo de alteração na API | Versão antiga | Nova versão |
---|---|---|
Compatível com versões mais antigas |
2,1 |
2,2 |
Não compatível com versões mais antigas |
2,1 |
3,0 |
Quando você instala o software StorageGRID pela primeira vez, somente a versão mais recente da API é habilitada. No entanto, ao atualizar para uma nova versão de recurso do StorageGRID, você continua tendo acesso à versão mais antiga da API para pelo menos uma versão de recurso do StorageGRID .
|
Você pode configurar as versões suportadas. Veja a seção config da documentação da API do Swagger para"API de gerenciamento de grade" para mais informações. Você deve desativar o suporte para a versão mais antiga após atualizar todos os clientes da API para usar a versão mais recente. |
Solicitações desatualizadas são marcadas como obsoletas das seguintes maneiras:
-
O cabeçalho de resposta é "Obsoleto: verdadeiro"
-
O corpo da resposta JSON inclui "deprecated": true
-
Um aviso obsoleto foi adicionado ao nms.log. Por exemplo:
Received call to deprecated v2 API at POST "/api/v2/authorize"
Determinar quais versões de API são suportadas na versão atual
Use o GET /versions
Solicitação de API para retornar uma lista das principais versões de API suportadas. Esta solicitação está localizada na seção config da documentação da API do Swagger.
GET https://{{IP-Address}}/api/versions { "responseTime": "2023-06-27T22:13:50.750Z", "status": "success", "apiVersion": "4.0", "data": [ 2, 3, 4 ] }
Especifique uma versão de API para uma solicitação
Você pode especificar a versão da API usando um parâmetro de caminho(/api/v4
) ou um cabeçalho(Api-Version: 4
). Se você fornecer ambos os valores, o valor do cabeçalho substituirá o valor do caminho.
curl https://[IP-Address]/api/v4/grid/accounts curl -H "Api-Version: 4" https://[IP-Address]/api/grid/accounts