[comment]: # ({c289fd9d-c289fd9d})
# httptest.update

[comment]: # ({/c289fd9d-c289fd9d})

[comment]: # ({d8b8edbd-b09ad465})
### Descrição

`object httptest.update(object/array webScenarios)`

Este método permite atualizar cenários web existentes.

::: noteclassic
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 de usuário](/manual/web_interface/frontend_sections/users/user_roles) para mais informações.
:::

[comment]: # ({/d8b8edbd-b09ad465})

[comment]: # ({e02b96f6-83b60d28})
### Parâmetros

`(object/array)` Propriedades do cenário web a serem atualizadas.

A propriedade `httptestid` deve ser definida para cada cenário web, todas as outras propriedades são opcionais. Somente as propriedades passadas serão atualizadas, todas as outras permanecerão inalteradas.

Além das [propriedades padrão do cenário web](object#web-scenario), o método aceita os seguintes parâmetros.

|Parâmetro|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|steps|array|[Etapas do cenário](/manual/api/reference/httptest/object#scenario-step) para substituir as etapas existentes.|
|tags|array|[Tags do cenário web](/manual/api/reference/httptest/object#web-scenario-tag).|

[comment]: # ({/e02b96f6-83b60d28})

[comment]: # ({02282fdb-02282fdb})
### Valores de retorno

`(object)` Retorna um objeto contendo os IDs dos cenários web atualizados na propriedade `httptestid`.

[comment]: # ({/02282fdb-02282fdb})

[comment]: # ({b41637d2-b41637d2})
### Exemplos

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({6fefc423-4c3bf00e})
#### Habilitando um cenário web

Habilite um cenário web, ou seja, defina seu status como "0".

[Requisição](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "httptest.update",
    "params": {
        "httptestid": "5",
        "status": 0
    },
    "id": 1
}
```

Resposta:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "httptestids": [
            "5"
        ]
    },
    "id": 1
}
```

[comment]: # ({/6fefc423-4c3bf00e})

[comment]: # ({a776cebb-e8ca015f})
### Veja também

-   [Etapa do cenário](object#scenario-step)

[comment]: # ({/a776cebb-e8ca015f})

[comment]: # ({628fc1ff-628fc1ff})
### Origem

CHttpTest::update() em *ui/include/classes/api/services/CHttpTest.php*.

[comment]: # ({/628fc1ff-628fc1ff})