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 |