[comment]: # ({5c2c8c32-2a00571f})
# connector.create

[comment]: # ({/5c2c8c32-2a00571f})

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

`object connector.create(object/array connectors)`

Este método permite criar novos objetos de conector.

::: noteclassic
Este método está disponível apenas para o tipo de usuário *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]: # ({/abae348f-bad67477})

[comment]: # ({e144b89b-98722c06})
### Parâmetros

`(object/array)` Objetos de conector a serem criados.

Além das [propriedades padrão do conector](object#connector), o método aceita os seguintes parâmetros.

|Parâmetro|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|tags|array|[Filtro de tag](/manual/api/reference/connector/object#tag-filter) do conector.|

[comment]: # ({/e144b89b-98722c06})

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

`(object)` Retorna um objeto contendo os IDs dos conectores criados na propriedade `connectorids`.
A ordem dos IDs retornados corresponde à ordem dos conectores passados.

[comment]: # ({/d4487654-a513e07e})

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

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

[comment]: # ({88c51e60-5936d90d})
#### Criando um conector

Crie um conector para exportar eventos de trigger com um filtro de tag. A autenticação HTTP será realizada usando o token Bearer.

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

```json
{
    "jsonrpc": "2.0",
    "method": "connector.create",
    "params": [
        {
            "name": "Export of events",
            "data_type": 1,
            "url": "{$DATA_EXPORT_URL}",
            "authtype": 5,
            "token": "{$DATA_EXPORT_BEARER_TOKEN}",
            "tags": [
                {
                    "tag": "service",
                    "operator": 0,
                    "value": "mysqld"
                }
            ]
        }
    ],
    "id": 1
}
```

Resposta:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "connectorid": [
            "3"
        ]
    },
    "id": 1
}
```

[comment]: # ({/88c51e60-5936d90d})

[comment]: # ({af9876f9-6550862d})
### Fonte

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

[comment]: # ({/af9876f9-6550862d})