sla.update

Descrição

object sla.update(object/array slaids)

Este método permite atualizar as entradas de SLA existentes.

Este método está disponível apenas para os tipos de usuário Admin e Super admin. As permissões para chamar o método podem ser revogadas nas configurações de função do usuário. Consulte Funções do usuário para obter mais informações.

Parâmetros

(object/array) Propriedades de SLA a serem atualizadas.

A propriedade slaid deve ser definida para cada SLA, todas as outras propriedades são opcionais. Apenas as propriedades passadas serão atualizadas, todas as outras permanecerão inalteradas.

Além das propriedades de SLA padrão, o método aceita os seguintes parâmetros.

Parâmetro Tipo Descrição
service_tags array SLA service_tags para substituir as atuais etiquetas de serviço SLA.

Pelo menos uma etiqueta de serviço deve ser especificada.
schedule array SLA schedule para substituir o atual.

Especificar o parâmetro como vazio será interpretado como uma programação 24x7.
excluded_downtimes array SLA excluded_downtimes para substituir os atuais.

Valores de retorno

(object) Retorna um objeto contendo os IDs dos SLAs atualizados na propriedade slaids.

Exemplos

Atualizando etiquetas de serviço

Fazer SLA com ID "5" a ser calculado em intervalos mensais para serviços relacionados ao NoSQL, sem alterar sua programação ou excluir downtimes; defina SLO para 95%.

Request:

{
           "jsonrpc": "2.0",
           "method": "sla.update",
           "params": [
               {
                   "slaid": "5",
                   "name": "NoSQL Database engines",
                   "slo": "95",
                   "period": 2,
                   "service_tags": [
                       {
                           "tag": "Database",
                           "operator": "0",
                           "value": "Redis"
                       },
                       {
                           "tag": "Database",
                           "operator": "0",
                           "value": "MongoDB"
                       }
                   ]
               }
           ],
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Response:

{
           "jsonrpc": "2.0",
           "result": {
               "slaids": [
                   "5"
               ]
           },
           "id": 1
       }

Alterando a programação de um SLA

Alterne o SLA com ID "5" para uma programação 24 horas por dia, 7 dias por semana.

Request:

{
           "jsonrpc": "2.0",
           "method": "service.update",
           "params": {
               "slaid": "5",
               "schedule": []
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Response:

{
           "jsonrpc": "2.0",
           "result": {
               "slaids": [
                   "5"
               ]
           },
           "id": 1
       }

Alterando os tempos de inatividade excluídos para um SLA

Adicione um tempo de inatividade planejado de atualização de RAM de 4 horas em 6 de abril de 2022, mantendo (precisa ser definido novamente) uma atualização de software existente planejada em 4 de julho para o SLA com ID "5".

Request:

{
           "jsonrpc": "2.0",
           "method": "service.update",
           "params": {
               "slaid": "5",
               "excluded_downtimes": [
                   {
                       "name": "Software version upgrade rollout",
                       "period_from": "1648760400",
                       "period_to": "1648764900"
                   },
                   {
                       "name": "RAM upgrade",
                       "period_from": "1649192400",
                       "period_to": "1649206800"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Response:

{
           "jsonrpc": "2.0",
           "result": {
               "slaids": [
                   "5"
               ]
           },
           "id": 1
       }

Fonte

CSla::update() in ui/include/classes/api/services/CSla.php.