Configuración de valores de cuenta

Puede configurar los ajustes de su cuenta para IBM Cloud® Metrics Routing mediante la IBM Cloud Metrics Routing UI, la IBM Cloud Metrics Routing CLI, la IBM Cloud Metrics Routing REST API y los scripts de Terraform. Configure estos ajustes para definir dónde y cómo se recopilan, enrutan y gestionan las métricas en su cuenta.

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

Cada vez que se modifica la configuración de la cuenta IBM Cloud Metrics 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 formato siguiente: https://private.<region>.metrics_router.cloud.ibm.com

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

¿Qué datos puede configurar a través de los ajustes de la cuenta IBM Cloud® Metrics 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 Metrics 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 Metrics Routing está disponible. Para obtener más información, consulte Ubicaciones.

Puede elegir una ubicación donde se almacenen los datos. También puede configurar una ubicación de copia de seguridad donde se almacenan los metadatos para 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 Metrics 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 sólo a través de puntos finales privados.
Las ubicaciones en las que un administrador de cuenta puede definir objetivos para recopilar métricas.

Puede elegir cualquiera de las ubicaciones admitidas en las que IBM Cloud Metrics 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 métricas de las ubicaciones soportadas de IBM Cloud Metrics Routing donde no ha configurado cómo desea recopilar métricas.

Si define más de 1 objetivo, todos los objetivos predeterminados obtienen una copia de las métricas que no tienen una regla de enrutamiento que indique dónde recogerlas en la cuenta. Puede definir hasta 2 destinos predeterminados por cuenta.

Permisos de IAM

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

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

Puede gestionar la definición de la configuración mediante la IU IBM Cloud Metrics 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 el IBM Cloud Metrics Routing CLI
Acción	Mandato
Obtener información de valores	`ibmcloud metrics-router setting get`
Actualizar valores	`ibmcloud metrics-router setting update`

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

Métodos de API

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

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

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

Códigos de respuesta de HTTP

Cuando se utiliza la API REST de IBM Cloud Metrics 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.
`429`	Demasiadas solicitudes	Demasiadas solicitudes han llegado a la API demasiado rápido.
`500`	Error de servidor interno	Algo ha fallado en el proceso de IBM Cloud Metrics Routing.