Configurando as definições de conta

Você pode definir as configurações da sua conta para IBM Cloud® Metrics Routing usando a interface do usuário IBM Cloud Metrics Routing, a interface do usuário IBM Cloud Metrics Routing CLI, a IBM Cloud Metrics Routing API REST e os scripts do Terraform. Defina essas configurações para definir onde e como as métricas são coletadas, roteadas e gerenciadas em sua conta.

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

Toda vez que você modifica as configurações da conta IBM Cloud Metrics 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, deve-se usar um terminal de API com o seguinte formato: https://private.<region>.metrics_router.cloud.ibm.com

Por meio da rede pública, deve-se usar um terminal de API com o formato a seguir: https://<region>.metrics_router.cloud.ibm.com

Quais dados você pode configurar nas configurações da conta IBM Cloud® Metrics 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 Metrics 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 Metrics Routing está disponível. Para obter mais informações, consulte Locais.

É possível escolher um local no qual os dados são armazenados Também é possível configurar um local de backup no qual os metadados são armazenados para propósitos 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 Metrics Routing na conta.

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

É possível configurar sua conta para restringir o gerenciamento somente por meio de terminais privados
Os locais onde um administrador de conta pode definir metas para coletar métricas.

Você pode escolher qualquer um dos locais suportados onde o IBM Cloud Metrics 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 métricas dos locais do IBM Cloud Metrics Routing suportados nos quais você não configurou como deseja coletar métricas....

Se você definir mais de um destino, todos os destinos padrão receberão uma cópia das métricas que não têm uma regra de roteamento para indicar onde coletá-las na conta. É possível definir até 2 destinos padrão por conta.

Permissões do IAM

Assegure-se de que você tenha as permissões corretas do IAM para configurar IBM Cloud Metrics Routing settingss.

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

Você pode gerenciar sua definição de configurações usando a interface do usuário IBM Cloud Metrics Routing. Para obter mais informações, consulte Configuração das definições de 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 IBM Cloud Metrics Routing CLI
Ação	Comando
Obter informações de configurações	`ibmcloud metrics-router setting get`
Atualizar configurações	`ibmcloud metrics-router setting update`

Para obter mais informações, consulte CLI da IBM Cloud Metrics 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 IBM Cloud Metrics Routing API REST
Ação	Método de API de REST	API_URL
Obter informações de configurações	`GET`	`<ENDPOINT>/api/v3/settings`
Atualizar configurações	`PATCH`	`<ENDPOINT>/api/v3/settings`

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 Metrics 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.
`429`	Muitas solicitações	Muitas solicitações atingiram a API muito rapidamente.
`500`	Erro interno do servidor	Algo deu errado no processamento do IBM Cloud Metrics Routing.