Configuración de valores de cuenta

Puede configurar los ajustes de la cuenta IBM Cloud Logs Routing para definir dónde y cómo se recopilan, enrutan y gestionan los registros de la plataforma en su cuenta. Puede hacerlo a través de la interfaz de usuario, o utilizando la CLI, la API REST V3, o scripts Terraform.

Cuando configure o modifique los ajustes de la cuenta IBM Cloud Logs Routing, tenga en cuenta la siguiente información:

Cada vez que se modifica la configuración de la cuenta IBM Cloud Logs Routing, los datos que se pasan en la nueva solicitud sustituyen a cualquier dato de configuración existente. Debe asegurarse de que los datos existentes no se supriman cuando ejecute una actualización de los valores de la cuenta incluyéndolos en la nueva solicitud.

Antes de inhabilitar los puntos finales públicos estableciendo --private-api-endpoint-only TRUE, asegúrese de que la cuenta tenga acceso al punto final privado. Puede hacerlo ejecutando el mandato ibmcloud account show. Si VRF Enabled es true y Service Endpoint Enabled es true, tendrá acceso al punto final privado. Si no tiene acceso al punto final privado, no podrá volver a habilitar el punto final público ya que el acceso de punto final privado es necesario para volver a habilitar el punto final público.

Puede utilizar puntos finales privados y públicos para gestionar los valores. Para obtener más información sobre la lista de ENDPOINTS que están disponibles, consulte Puntos finales.

A través de la red privada, debe utilizar un punto final de API con el siguiente formato: https://api.private.<region>.logs-router.cloud.ibm.com
A través de la red pública, debe utilizar un punto final de API con el siguiente formato: https://api.<region>.logs-router.cloud.ibm.com

¿Qué datos puede configurar a través de los ajustes de la cuenta IBM Cloud Logs Routing?

Puede definir cualquiera de las siguientes informaciones:

La ubicación en su cuenta IBM Cloud donde se almacenan los metadatos de configuración de la cuenta IBM Cloud Logs Routing.

Por metadatos, nos referimos a los datos de destino/ruta/valores que están disponibles en la cuenta en cualquier región.

Puede elegir cualquiera de las ubicaciones admitidas en las que IBM Cloud Logs Routing está disponible. Para obtener más información, consulte Ubicaciones.

Puede elegir la ubicación en la que se almacenarán los metadatos. También puede configurar una ubicación de copia de seguridad donde se almacenen los metadatos con fines de recuperación.

Tenga en cuenta los requisitos de conformidad corporativos o de la industria como, por ejemplo, ubicaciones validadas para servicios financieros o regiones gestionadas por la UE.

Debe configurar la región de metadatos primaria antes de crear objetivos y rutas asegurándose de que la configuración satisface sus necesidades de cumplimiento.
El tipo de endpoints a los que se permite gestionar la configuración de la cuenta IBM Cloud Logs Routing en la cuenta.

Por defecto, los puntos finales públicos y privados están activados.

Puede configurar su cuenta para restringir la gestión únicamente a través de puntos finales privados.
Las ubicaciones en las que un administrador de cuentas puede definir objetivos para recopilar registros.

Puede elegir cualquiera de las ubicaciones admitidas en las que IBM Cloud Logs Routing está disponible. Para obtener más información, consulte Ubicaciones.

Tenga en cuenta los requisitos de conformidad corporativos o de la industria como, por ejemplo, ubicaciones validadas para servicios financieros o regiones gestionadas por la UE.
Ubicaciones de destino predeterminadas, es decir, 1 o más destinos en la cuenta, que recopilarán los registros de las ubicaciones compatibles de IBM Cloud Logs Routing en las que no haya configurado cómo desea recopilar los registros.

Si define más de 1 destino, todos los destinos predeterminados reciben una copia de los registros que no tienen una regla de enrutamiento que indique dónde entregarlos en la cuenta. Puede definir hasta 2 destinos predeterminados por cuenta.
La versión de la API que está habilitada en la cuenta para IBM Cloud Logs Routing. Los valores válidos son: 1 o 3.

Permisos de IAM

Asegúrese de que dispone de los permisos IAM correctos para configurar IBM Cloud Logs Routing settingss.

Gestión de la configuración mediante la interfaz de usuario

Puedes gestionar la definición de tus ajustes a través de la interfaz de usuario IBM Cloud Logs Routing. Para obtener más información, consulte Configuración de los ajustes de la cuenta.

mandatos de CLI

La tabla siguiente lista las acciones que puede ejecutar para gestionar los valores:

Acciones de configuración mediante la CLI IBM Cloud Logs Routing
Acción	Mandato
Obtener información de valores	`ibmcloud logs-router setting get`
Actualizar valores	`ibmcloud logs-router setting update`

Para obtener más información, consulte el tema sobre CLI de IBM Cloud Logs Routing.

Métodos de API

La tabla siguiente lista las acciones que puede ejecutar para gestionar los valores:

Acciones de configuración mediante la API REST de IBM Cloud Logs Routing
Acción	Método de API REST	API_URL
Obtener información de valores	`GET`	`<ENDPOINT>/v3/settings`
Actualizar valores	`PATCH`	`<ENDPOINT>/v3/settings`

Puede utilizar puntos finales públicos y privados para gestionar destinos. Para obtener más información sobre la lista de ENDPOINTS que están disponibles, consulte Puntos finales.

Puede gestionar destinos desde la red privada utilizando un punto final de API con el formato siguiente: https://api.private.REGION.logs-router.cloud.ibm.com
Puede gestionar destinos desde la red pública utilizando un punto final de API con el formato siguiente: https://api.REGION.logs-router.cloud.ibm.com

Para más información sobre la API REST, consulte la API de configuración.

Códigos de respuesta de HTTP

Cuando se utiliza la API REST de IBM Cloud Logs Routing, es posible obtener códigos de respuesta HTTP estándar para indicar si un método se ha completado satisfactoriamente.

Una respuesta de 200 siempre indica éxito.
Una respuesta 4xx indica una anomalía.
Una respuesta 5xx normalmente indica un error interno del sistema.

Consulte la tabla siguiente para ver algunos códigos de respuesta HTTP:

Lista de códigos de respuesta HTTP
Código de estado	Estado	Descripción
`200`	OK	La solicitud se ha realizado correctamente.
`201`	OK	La solicitud se ha realizado correctamente. Se crea un recurso.
`400`	Solicitud errónea	La solicitud no ha sido satisfactoria. Es posible que falte un parámetro que sea necesario.
`401`	No autorizado	La señal de IAM que se utiliza en la solicitud de API no es válida o ha caducado.
`403`	Prohibido	La operación está prohibida debido a permisos insuficientes.
`404`	No encontrado	El recurso solicitado no existe o ya se ha suprimido.
`409`	Conflict	Existe un conflicto con los datos de la solicitud y el estado de los recursos en el sistema.
`429`	Demasiadas solicitudes	Demasiadas solicitudes han llegado a la API demasiado rápido.
`500`	Error de servidor interno	Algo ha fallado. No se ha podido procesar su solicitud. Vuelva a intentarlo más tarde. Si el problema persiste, anote el transaction-id en la cabecera de respuesta y póngase en contacto con el servicio de asistencia IBM Cloud.