update_custom_property
Para crear una propiedad personalizada para un objeto o para modificar una existente, utilice el método item/update_custom_property. Para enviar la solicitud, debe tener el derecho de acceso Modificar propiedades no mencionadas al objeto.
Puede utilizar este método para gestionar los ajustes de la integración con flespi (el token de flespi, la región del centro de datos y la configuración de la región), que se almacenan como propiedades personalizadas en el objeto del usuario de la cuenta de nivel superior. Para obtener instrucciones detalladas, consulte Configuración del token y la región de flespi mediante la API.
Endpoint
svc=item/update_custom_property¶ms={
"itemId":<long>,
"name":"<text>",
"value":"<text>"
}
Parámetros
La solicitud debe contener los siguientes parámetros:
| Nombre | Descripción |
|---|---|
| itemId | ID del objeto. |
| name | Nombre de la propiedad personalizada. |
| value | Valor de la propiedad personalizada. Para eliminar la propiedad personalizada, indique una cadena vacía (""). |
Resultado devuelto
Si la solicitud se completa correctamente, se devuelve una respuesta con el siguiente formato:
{
"n":"<text>", /* nombre de propiedad personalizada */
"v":"<text>" /* valor de propiedad personalizada */
}
De lo contrario, se devuelve un código de error.
Códigos de error
| Código de error | Descripción |
|---|---|
| 4 | Parámetros de entrada incorrectos. |
| 6 | Error no definido. |
| 7 | Error al obtener el objeto. Es posible que el usuario no tenga el derecho de acceso Modificar propiedades no mencionadas al objeto. El mismo error se devuelve mientras la cuenta del usuario se traslada a otro centro de datos. |