[comment]: # translation:outdated

[comment]: # ({000fdd04-000fdd04})
## graph.create

[comment]: # ({/000fdd04-000fdd04})

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

`object graph.create(object/array graphs)`

Este método permite criar novos gráficos.

::: noteclassic
Este método está disponível apenas para *Admin* e *Superadministrador*
tipos de usuário. As permissões para chamar o método podem ser revogadas na função de usuário
definições. Veja [Usuário
funções](/manual/web_interface/frontend_sections/administration/user_roles)
Para maiores informações.
:::

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

[comment]: # ({fc8b02f4-fc8b02f4})
### Parâmetros

`(object/array)` Gráficos para criar.

Além das [propriedades de gráfico padrão](object#graph), o
O método aceita os seguintes parâmetros.

|Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição|
|---------|----------------------------------- ------------|-----------|
|**gitems**<br>(obrigatório)|array|Gráfico [itens](/manual/api/reference/graphitem/object) a ser criado para o gráfico.|

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

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

`(object)` Retorna um objeto contendo os IDs dos gráficos criados
sob a propriedade `graphids`. A ordem dos IDs retornados corresponde à
ordem dos gráficos passados.

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

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

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

[comment]: # ({cd12048c-cd12048c})
#### Criando um gráfico

Crie um gráfico com dois itens.

Solicitação:

``` {.java}
{
    "jsonrpc": "2.0",
    "método": "graf.criar",
    "parâmetros": {
        "name": "Largura de banda MySQL",
        "largura": 900,
        "altura": 200,
        "gitens": [
            {
                "itemid": "22828",
                "cor": "00AA00"
            },
            {
                "itemid": "22829",
                "cor": "3333FF"
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Resposta:

``` {.java}
{
    "jsonrpc": "2.0",
    "resultado": {
        "grafos": [
            "652"
        ]
    },
    "id": 1
}
```

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

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

- [Item de gráfico](/manual/api/reference/graphitem/object#graph_item)

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

[comment]: # ({4e535c8e-4e535c8e})
### Fonte

CGraph::create() em *ui/include/classes/api/services/CGraph.php*.

[comment]: # ({/4e535c8e-4e535c8e})