Obtener detalles de la configuración de la cuenta mediante la interfaz de usuario

Complete los siguientes pasos para ver la configuración de la cuenta de IBM Cloud Logs Routing mediante la interfaz de usuario:

1. Conéctese a su cuenta IBM Cloud.

2. Pulse el icono Menú > Observabilidad.

3. Haga clic en Registro > Enrutamiento.

4. Pulse el separador Valores.

En esta página puede ver los siguientes ajustes:

• Ubicación de metadatos: Muestra la región de metadatos primaria y la región de metadatos de copia de seguridad.

• Regiones objetivo permitidas. Muestra las regiones de destino a las que se pueden enviar los registros de la plataforma.

• Objetivos por defecto: Muestra los objetivos por defecto configurados.

• Puntos finales públicos: Muestra si los puntos finales públicos están habilitados. Cuando está desactivada, no se puede acceder a la interfaz de usuario IBM Cloud Logs Routing.

• Informes: Muestra las configuraciones en formato JSON.

Actualizar la configuración de la cuenta mediante la interfaz de usuario

1. Conéctese a su cuenta IBM Cloud.

2. Pulse el icono Menú > Observabilidad.

3. Haga clic en Registro >Ruta.

4. Pulse el separador Valores.

5. Haga clic en Editar junto al ajuste que desee modificar. Puede modificar los siguientes ajustes:

• Ubicación de los metadatos: Seleccione la región de metadatos primaria y la región de metadatos de copia de seguridad que desee.

• Regiones de destino permitidas: Seleccione la región en la que se pueden crear objetivos. Si no se selecciona ninguna región, todas las regiones pueden recibir los registros de la plataforma.

• Destinos por defecto: Seleccione el destino que se utilizará por defecto cuando las reglas de enrutamiento no existan o no coincidan.

Requisitos previos de la CLI

Antes de utilizar la CLI para gestionar la configuración de cuentas de IBM Cloud Logs Routing, instale la CLI de IBM Cloud Logs Routing.

Compruebe que dispone de permisos IAM para leer, actualizar, o ambos, los ajustes de la cuenta IBM Cloud Logs Routing.

Obtención de detalles de la configuración de la cuenta mediante la CLI

Utilice este comando para obtener los ajustes de configuración de la cuenta IBM Cloud Logs Routing.

ibmcloud logs-router setting get [--output FORMAT]

Default Targets             -
Permitted Target Regions    -
Primary Metadata Region
Backup Metadata Region
Private Api Endpoint Only   false
Api Version                 1

Actualización de la configuración de la cuenta mediante la CLI

Utilice este mandato para modificar los valores de cuenta actuales, como los destinos predeterminados, las regiones de destino permitidas y la región de metadatos primaria.

ibmcloud logs-router setting update [--default-targets DEFAULT-TARGETS | @DEFAULT-TARGETS-FILE] [--permitted-target-regions PERMITTED-TARGET-REGIONS] [--primary-metadata-region PRIMARY-METADATA-REGION] [--backup-metadata-region BACKUP-METADATA-REGION] [--private-api-endpoint-only=PRIVATE-API-ENDPOINT-ONLY] [--output FORMAT] [--force]

Requisitos previos de la API

Para realizar llamadas de API para gestionar valores, realice los pasos siguientes:

1. Obtenga una señal de acceso IAM. Para obtener más información, consulte Recuperación de señales de acceso de IAM.
2. Identifique el punto final de API en la región en la que piensa configurar o gestionar valores. Para obtener más información, consulte Puntos finales.

Obtener detalles de la configuración de la cuenta mediante la API

Puede utilizar el siguiente mandato cURL para obtener información de valores existentes:

curl -X GET  ENDPOINT/api/v3/settings   -H "Authorization:  $ACCESS_TOKEN"

Donde:

ENDPOINT

Es el punto final de la API en la región donde tiene previsto configurar o gestionar un destino. Para obtener más información, consulte Puntos finales.

Por ejemplo, puede utilizar la siguiente solicitud cURL para obtener la información de configuración de la cuenta:

curl -X GET   https://api.<region>.logs-router.cloud.ibm.com/v3/settings   -H "Authorization:  $ACCESS_TOKEN"

Se devuelve una respuesta similar a la siguiente:

{
  "default_targets":[],
  "permitted_target_regions":[],
  "primary_metadata_region":"",
  "backup_metadata_region":"",
  "private_api_endpoint_only":false,
  "api_version":1
}

Donde:

default_targets

Es una lista de ID de destino. Si ninguna regla de enrutamiento hace que los registros de la plataforma se envíen a otros destinos, estos destinos recibirán los registros de la plataforma.

permitted_target_regions

Es la lista de regiones que se pueden utilizar para definir un destino. Se permite un máximo de dos regiones de destino.

primary_metadata_region

Es la región donde se almacenan los metadatos asociados a las definiciones de ruta y destino.

backup_metadata_region

Es la región donde se almacenan como copia de seguridad los metadatos asociados a las definiciones de ruta y destino.

private_api_endpoint_only

Especifica si se puede utilizar un punto final privado. Si true sólo se puede utilizar un punto final privado.

api_version

Es la versión de la API configurada para esta cuenta.

Actualización de la configuración de la cuenta mediante la API

Cuando actualices la configuración, ten en cuenta la siguiente información:

• Debe incluir la información de configuración en la sección de datos de la solicitud.

• Debe pasar los datos configurados para cada ajuste.

  Los datos configurados y no incluidos en una solicitud de actualización se eliminan.

• Actualice los datos de los campos que deban modificarse.

• El cambio de versión de la API sólo está permitido como parte del proceso de migración de V1 a V3. Véase Transición de v1 a v3.

Puede utilizar el siguiente mandato cURL para actualizar los valores:

curl -X PATCH   https://api.<region>.logs-router.cloud.ibm.com/v3/settings
-H "Authorization: Bearer <IAM_TOKEN>"
-H 'accept: application/json'
-d '{
    "default_targets": [
      {
        "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
      }
    ],
    "permitted_target_regions": ["us-south", "us-east"],
    "primary_metadata_region": "us-south",
    "backup_metadata_region": "us-east",
    "private_api_endpoint_only": false
  }'

Donde:

ENDPOINT

Es el punto final de la API en la región donde tiene previsto configurar o gestionar un destino. Para obtener más información, consulte Puntos finales.

default_targets

Es una lista de ID de destino. Si ninguna regla de enrutamiento hace que los registros de la plataforma se envíen a otros destinos, estos destinos recibirán los registros de la plataforma.

permitted_target_regions

Es la lista de regiones que se pueden utilizar para definir un destino. Se puede especificar un máximo de dos regiones de destino permitidas.

primary_metadata_region

Es la región donde se almacenan los metadatos asociados a las definiciones de ruta y destino.

backup_metadata_region

Es la región donde se almacenan los metadatos asociados a las definiciones de ruta y destino con fines de copia de seguridad.

private_api_endpoint_only

Especifica si se puede utilizar o no un punto final privado. Si true sólo se puede utilizar un punto final privado.