Publicação de várias APIs ou colocação de várias APIs off-line
Função
Esta API é usada para publicar várias APIs em um ambiente ou para remover várias APIs do ambiente em que foram publicadas.
URI
A tabela a seguir lista o método de solicitação HTTP/HTTPS e o URI da API.
Método de solicitação |
URI |
---|---|
POST |
/v1.0/apigw/apis/publish[?action] |
A tabela a seguir lista o parâmetro no URI.
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
action |
Não |
String |
online: publicar offline: ficar off-line |
Solicitação
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
apis |
Sim |
String Array |
IDs das APIs a serem publicadas ou colocadas off-line |
env_id |
Sim |
String |
ID do ambiente |
remark |
Não |
String |
Descrição da publicação A descrição não pode exceder 255 caracteres. |
Exemplo de solicitação:
{ "apis": ["81efcfd94b8747a0b21e8c04144a4e8c","7addcd00cfab433984b1d8bf2fe08aaa"], "env_id": "DEFAULT_ENVIRONMENT_RELEASE_ID", "remark": "Published in the production environment" }
Resposta
Parâmetro |
Tipo |
Descrição |
---|---|---|
success |
Array |
Mensagem para publicação bem-sucedida da API ou colocação off-line |
failure |
Array |
Mensagem de erro e APIs que não conseguem ser publicadas ou colocadas offline |
Parâmetro |
Tipo |
Descrição |
---|---|---|
publish_id |
String |
ID do registro da publicação |
api_id |
String |
ID de uma API publicada com sucesso |
api_name |
String |
Nome da API |
env_id |
String |
ID do ambiente no qual a API foi publicada |
remark |
String |
Descrição da publicação |
publish_time |
Timestamp |
Hora em que a API é publicada |
version_id |
String |
Versão da API |
Parâmetro |
Tipo |
Descrição |
---|---|---|
api_id |
String |
ID de uma API que é colocada off-line com sucesso |
api_name |
String |
Nome da API |
Parâmetro |
Tipo |
Descrição |
---|---|---|
api_id |
String |
ID de uma API que não consegue ser publicada ou colocada off-line |
api_name |
String |
Nome da API |
error_code |
String |
Código de erro |
error_msg |
String |
Mensagem de erro |
Exemplo de resposta:
{ "success": [{ "publish_id": "5b729aa252764739be2c37ef0d66dc63", "api_id": "7addcd00cfab433984b1d8bf2fe08aaa", "api_name": "testApi", "env_id": "DEFAULT_ENVIRONMENT_RELEASE_ID", "version_id": "3d9dcb733ba34352b0d02f85fd16b026", "remark": "string", "publish_time": "2018-07-26T13:18:04.1079916Z" }], "failure": [{ "api_id": "81efcfd94b8747a0b21e8c04144a4e8c", "error_code": "APIG.3002", "error_msg": "api with id 81efcfd94b8747a0b21e8c04144a4e8c not found" }] }
Códigos de status
Código de status |
Descrição |
---|---|
200 |
OK |
400 |
Solicitação inválida |
401 |
Não autorizado |
403 |
Proibido |
404 |
Não encontrado |
500 |
Erro do servidor interno |