Configurando as definições de conta

Você pode definir as configurações da conta IBM Cloud Logs Routing para definir onde e como os logs da plataforma são coletados, roteados e gerenciados na sua conta. Você pode fazer isso por meio da interface do usuário ou usando a CLI, a API REST V3 ou os scripts do Terraform.

Quando você configurar ou modificar as configurações da conta IBM Cloud Logs Routing, considere as seguintes informações:

Toda vez que você modifica as configurações da conta IBM Cloud Logs Routing, os dados que são passados na nova solicitação substituem todos os dados de configuração existentes. Deve-se garantir que quaisquer dados existentes não sejam excluídos ao executar uma atualização das configurações da conta, incluindo-a na nova solicitação.

Antes de desativar os terminais públicos, configurando --private-api-endpoint-only TRUE, certifique-se de que sua conta tenha acesso ao terminal privado. Você pode fazer isso executando o comando ibmcloud account show. Se VRF Enabled for true e Service Endpoint Enabled for true, você tem acesso ao terminal privado. Se você não tiver acesso ao terminal privado, poderá reativar o terminal público, uma vez que o acesso ao terminal privado é necessário para reativar o terminal público.

É possível usar terminais privados e públicos para gerenciar configurações. Para obter mais informações sobre a lista de ENDPOINTS disponíveis, consulte Terminais.

Por meio da rede privada, você deve usar um endpoint de API com o seguinte formato: https://api.private.<region>.logs-router.cloud.ibm.com
Por meio da rede pública, você deve usar um endpoint de API com o seguinte formato: https://api.<region>.logs-router.cloud.ibm.com

Quais dados você pode configurar por meio das configurações da conta IBM Cloud Logs Routing?

É possível definir qualquer uma das informações a seguir:

O local em sua conta IBM Cloud onde os metadados de configuração da conta IBM Cloud Logs Routing estão armazenados.

Por metadados, nos referimos aos dados de destino / rota / configurações que estão disponíveis em toda a conta em qualquer região.

Você pode escolher qualquer um dos locais suportados onde o IBM Cloud Logs Routing está disponível. Para obter mais informações, consulte Locais.

Você pode escolher um local onde os metadados são armazenados. Você também pode configurar um local de backup onde os metadados são armazenados para fins de recuperação.

Leve em consideração quaisquer requisitos corporativos ou de conformidade com o setor de mercado, como locais Serviços Financeiros Validados, ou regiões gerenciadas pela União Europeia.

Você deve configurar a região de metadados primária antes de criar destinos e rotas, garantindo que a configuração atenda às suas necessidades de conformidade.
O tipo de pontos de extremidade que têm permissão para gerenciar a configuração da conta IBM Cloud Logs Routing na conta.

Por padrão, os pontos de extremidade públicos e privados estão ativados.

Você pode configurar sua conta para restringir o gerenciamento somente por meio de endpoints privados.
Os locais em que um administrador de conta pode definir alvos para coletar logs.

Você pode escolher qualquer um dos locais suportados onde o IBM Cloud Logs Routing está disponível. Para obter mais informações, consulte Locais.

Leve em consideração quaisquer requisitos corporativos ou de conformidade com o setor de mercado, como locais Serviços Financeiros Validados, ou regiões gerenciadas pela União Europeia.
Locais de destino padrão, ou seja, 1 ou mais destinos na conta, que coletarão logs de locais suportados IBM Cloud Logs Routing onde você não configurou como deseja coletar logs.

Se você definir mais de um destino, todos os destinos padrão receberão uma cópia dos logs que não têm uma regra de roteamento para indicar onde entregá-los na conta. É possível definir até 2 destinos padrão por conta.
A versão da API que está habilitada na conta para IBM Cloud Logs Routing. Os valores válidos são: 1 ou 3.

Permissões do IAM

Verifique se você tem as permissões corretas do IAM para definir as configurações do IBM Cloud Logs Routing.

Gerenciamento de configurações usando a interface do usuário

Você pode gerenciar a definição de suas configurações usando a interface do usuário IBM Cloud Logs Routing. Para obter mais informações, consulte Definição das configurações da conta.

Comandos de CLI

A tabela a seguir lista as ações possíveis de executar para gerenciar configurações:

Ações de configuração usando a CLI do IBM Cloud Logs Routing
Ação	Comando
Obter informações de configurações	`ibmcloud logs-router setting get`
Atualizar configurações	`ibmcloud logs-router setting update`

Para obter mais informações, consulte CLI da IBM Cloud Logs Routing.

Métodos de API

A tabela a seguir lista as ações possíveis de executar para gerenciar configurações:

Ações de configuração usando a API REST do site IBM Cloud Logs Routing
Ação	Método de API de REST	API_URL
Obter informações de configurações	`GET`	`<ENDPOINT>/v3/settings`
Atualizar configurações	`PATCH`	`<ENDPOINT>/v3/settings`

É possível usar terminais privados e públicos para gerenciar destinos. Para obter mais informações sobre a lista de ENDPOINTS disponíveis, consulte Terminais.

É possível gerenciar destinos a partir da rede privada usando um terminal de API com o formato a seguir: https://api.private.REGION.logs-router.cloud.ibm.com
É possível gerenciar destinos a partir da rede pública usando um terminal de API com o formato a seguir: https://api.REGION.logs-router.cloud.ibm.com

Para obter mais informações sobre a API REST, consulte a API de configurações.

Códigos de resposta HTTP

Quando você usa a API de REST do IBM Cloud Logs Routing, pode obter códigos de resposta HTTP padrão para indicar se um método foi concluído com sucesso.

A resposta 200 sempre indica sucesso.
A resposta 4xx indica uma falha.
A resposta 5xx geralmente indica um erro no sistema interno.

Consulte a tabela a seguir para obter alguns códigos de resposta HTTP:

Lista de códigos de resposta do site HTTP
Código de status	Status	Descrição
`200`	OK	A solicitação foi bem-sucedida.
`201`	OK	A solicitação foi bem-sucedida. Um recurso é criado.
`400`	Solicitação inválida	A solicitação foi malsucedida. Um parâmetro que é necessário pode estar ausente.
`401`	Desautorizado	O token IAM que é usado na solicitação da API é inválido ou expirou.
`403`	Proibido	A operação é proibida devido a permissões insuficientes.
`404`	Não Encontrado	O recurso solicitado não existe ou já está foi excluído.
`409`	Conflito	Há um conflito entre os dados da solicitação e o estado dos recursos no sistema.
`429`	Muitas solicitações	Muitas solicitações atingiram a API muito rapidamente.
`500`	Erro interno do servidor	Ocorreu um problema. Não foi possível processar sua solicitação. Tente novamente mais tarde. Se o problema persistir, anote o ID da transação no cabeçalho da resposta e entre em contato com o suporte IBM Cloud.