Consulta de parâmetros de configuração da instância DCS
Função
Essa API é usada para consultar os parâmetros de configuração de uma instância de DCS.
Solicitação
Parâmetros de solicitação
Nenhum.
Exemplo de solicitações
GET https://{dcs_endpoint}/v1.0/{project_id}/instances/{instance_id}/configs Resposta
Parâmetros de resposta
| Parâmetro | Tipo | Descrição |
|---|---|---|
| status | String | Status atual de uma instância de DCS. |
| instance_id | String | ID da instância do DCS. |
| redis_config | Array | Matriz de itens de configuração da instância do DCS. Para mais detalhes, consulte Tabela 3. |
| config_status | String | Status da instância de DCS que está sendo modificada ou foi modificada. Opções:
|
| config_time | String | Hora em que a instância do DCS é operada. Por exemplo, 2017-03-31T12:24:46.297Z. |
| Parâmetro | Tipo | Descrição |
|---|---|---|
| description | String | Descrição do item de configuração. |
| param_id | Integer | ID do parâmetro de configuração. Para obter os valores possíveis, consulte a coluna Parameter ID em Tabela 4. |
| param_name | String | Nome do parâmetro de configuração. Para obter os valores possíveis, consulte a coluna Parameter Name em Tabela 4. |
| param_value | String | Valor do parâmetro de configuração. |
| default_value | String | Valor padrão do parâmetro de configuração. Para obter os valores possíveis, consulte a coluna Default Value em Tabela 4. |
| value_type | String | Tipo do valor do parâmetro de configuração. Para obter os valores possíveis, consulte a coluna Value Type em Tabela 4. |
| value_range | String | Intervalo do valor do parâmetro de configuração. Para obter os valores possíveis, consulte a coluna Value Range em Tabela 4. |
Tabela 4 descreve os parâmetros de configuração de uma instância de DCS.
| ID do parâmetro | Nome do Parâmetro | Motor aplicável | Tipo do valor | Descrição | Intervalo de valores | Valor padrão |
|---|---|---|---|---|---|---|
| 1 | timeout | Redis e Memcached | Interger | A conexão entre o cliente e o servidor (instância DCS) será fechada se o cliente estiver ocioso durante o período de tempo limite (medido em segundos). Um período de tempo limite de 0 segundos indica que a função de tempo limite está desativada. | 0 a 7200. Unidade: segundo. | 0 |
| 2 | maxmemory-policy | Redis e Memcached | Enum | Como o Redis selecionará o que remover quando a memória máxima for alcançada. Para obter mais informações sobre esse parâmetro, consulte https://redis.io/topics/lru-cache. | volatile-lru allkeys-lru volatile-random allkeys-random volatile-ttl noeviction | noeviction |
| 3 | hash-max-ziplist-entries | Redis | Interger | Quando o número de entradas em hashes é menor que o valor deste parâmetro, os hashes são codificados usando ziplist para economizar memória. | 1–10.000 | 512 |
| 4 | hash-max-ziplist-value | Redis | Interger | Quando a maior entrada em hashes não excede o limite de comprimento indicado por este parâmetro, os hashes são codificados usando ziplist para economizar memória. | 1–10.000 | 64 |
| 5 | list-max-ziplist-entries | Redis | Interger | Quando o número de entradas nas listas é menor que o valor deste parâmetro, as listas são codificadas usando ziplist para economizar memória. | 1–10.000 | 512 |
| 6 | list-max-ziplist-value | Redis | Interger | Quando a maior entrada em listas não exceder o limite de comprimento indicado por este parâmetro, as listas são codificadas usando ziplist para economizar memória. | 1–10.000 | 64 |
| 7 | set-max-intset-entries | Redis | Interger | Quando um conjunto é composto inteiramente de strings e o número de inteiros não excede o limite de comprimento indicado por este parâmetro, o conjunto é codificado usando intset para economizar memória. | 1–10.000 | 512 |
| 8 | zset-max-ziplist-entries | Redis | Interger | Quando o número de entradas em conjuntos ordenados é menor que o valor deste parâmetro, os conjuntos ordenados são codificados usando um ziplist para economizar memória. | 1–10.000 | 128 |
| 9 | zset-max-ziplist-value | Redis | Interger | Quando a maior entrada em conjuntos ordenados não exceder o limite de comprimento indicado por este parâmetro, os conjuntos ordenados são codificados usando ziplist para economizar memória. | 1–10.000 | 64 |
| 10 | latency-monitor-threshold | Redis | Interger | A quantidade mínima de latência que será registrada como picos de latência Se esse parâmetro for definido como 0, o monitoramento de latência será desativado. Se esse parâmetro for definido como um valor maior que 0, todos os eventos que bloqueiam o servidor por um tempo maior que o valor configurado serão registrados. Ao executar o comando LATENCY, você pode executar operações relacionadas ao monitoramento de latência, como obter dados estatísticos e configurar e ativar o monitoramento de latência. Para obter mais informações sobre o latency-monitor-threshold, visite https://redis.io/docs/reference/optimization/latency-monitor/. | 0–86.400.000 ms | 0 |
| 12 | reserved-memory | Redis | Interger | Memória reservada, que está disponível apenas para instâncias de nó único e principal/em espera. Este parâmetro indica o número de megabytes reservados para que o back-end execute o processamento interno, como persistência e replicação principal/em espera. O tamanho da memória reservada pode ser ajustado, mas deve estar no intervalo de valores descrito na próxima coluna. Nota: Para obter mais informações sobre o máximo de memória disponível para cada tipo de instância, consulte Visão geral de serviço de DCS. | 0% a 80% do espaço máximo de memória disponível inicialmente para a instância e abaixo do espaço de memória livre atual. Unidade: MB. | 0 |
| 13 | notify-keyspace-events | Redis | String | Notificação de eventos do espaço de chave. Se esse parâmetro estiver configurado, o recurso Redis Sub/Pub permitirá que os clientes recebam um evento quando um conjunto de dados do Redis for modificado. | Se o valor do parâmetro for uma cadeia de caracteres vazia ou null, o valor padrão Ex será usado. Se o valor do parâmetro contiver vários caracteres, a notificação de eventos de keyspace será ativada e cada caractere identificará uma classe de eventos de keyspace para os quais o Redis enviará notificações. K: Eventos de espaço de chave, publicados com o __keyspace@__ prefix E: Eventos keyevent, publicados com o __keyevent@__ prefix g: Comandos genéricos (não específicos do tipo), como DEL, EXPIRE e RENAME $: Comandos de string l: Comandos de lista s: Definir comandos h: Comandos hash z: Comandos do conjunto classificado x: Eventos expirados (eventos gerados toda vez que uma chave expira) e: Eventos despejados (eventos gerados quando uma chave é despejada por maxmemory) Para obter mais informações, consulte a seguinte nota. | Ex |
Mais informações sobre o parâmetro notify-keyspace-events:
- Caracteres permitidos são K, E, KE, A, g, l, s, h, z, x, e, e $. O valor do parâmetro deve conter K ou E.
- A é um alias para g$lshzxe e não pode ser usado junto com nenhum dos caracteres em g$lshzxe.
- Por exemplo, o valor Kl significa que o Redis pode notificar clientes Pub/Sub sobre eventos de espaço de chaves e comandos de lista. O valor AKE significa que o Redis notificará os clientes do Pub/Sub sobre todos os eventos.
{
"status": "RUNNING",
"instance_id": "c08fdc6e-5c25-4185-ab57-c0a5529b727f",
"redis_config": [
{
"description": "How Redis will select what to remove when maxmemory is reached, You can select among five behaviors: volatile-lru : remove the key with an expire set using an LRU algorithm allkeys-lru : remove any key according to the LRU algorithm volatile-random: remove a random key with an expire set allkeys-random: remove a random key, any key volatile-ttl : remove the key with the nearest expire time (minor TTL) noeviction : don't expire at all, just return an error on write operations",
"param_id": 2,
"param_name": "maxmemory-policy",
"param_value": "noeviction",
"default_value": "noeviction",
"value_type": "Enum",
"value_range": "volatile-lru,allkeys-lru,volatile-random,allkeys-random,volatile-ttl,noeviction"
},
{
"description": "Hashes are encoded using a memory efficient data structure when they have a small number of entries",
"param_id": 3,
"param_name": "hash-max-ziplist-entries",
"param_value": "512",
"default_value": "512",
"value_type": "Interger",
"value_range": "1-10000"
},
{
"description": "Hashes are encoded using a memory efficient data structure when the biggest entry does not exceed a given threshold",
"param_id": 4,
"param_name": "hash-max-ziplist-value",
"param_value": "64",
"default_value": "64",
"value_type": "Interger",
"value_range": "1-10000"
},
{
"description": "Lists are encoded using a memory efficient data structure when they have a small number of entries",
"param_id": 5,
"param_name": "list-max-ziplist-entries",
"param_value": "512",
"default_value": "512",
"value_type": "Interger",
"value_range": "1-10000"
},
{
"description": "Lists are encoded using a memory efficient data structure when the biggest entry does not exceed a given threshold",
"param_id": 6,
"param_name": "list-max-ziplist-value",
"param_value": "64",
"default_value": "64",
"value_type": "Interger",
"value_range": "1-10000"
},
{
"description": "When a set is composed of just strings that happen to be integers in radix 10 in the range of 64 bit signed integers.",
"param_id": 7,
"param_name": "set-max-intset-entries",
"param_value": "512",
"default_value": "512",
"value_type": "Interger",
"value_range": "1-10000"
},
{
"description": "Sorted sets are encoded using a memory efficient data structure when they have a small number of entries",
"param_id": 8,
"param_name": "zset-max-ziplist-entries",
"param_value": "128",
"default_value": "128",
"value_type": "Interger",
"value_range": "1-10000"
},
{
"description": "Sorted sets are encoded using a memory efficient data structure when the biggest entry does not exceed a given threshold",
"param_id": 9,
"param_name": "zset-max-ziplist-value",
"param_value": "64",
"default_value": "64",
"value_type": "Interger",
"value_range": "1-10000"
},
{
"description": "Close the connection after a client is idle for N seconds (0 to disable)",
"param_id": 1,
"param_name": "timeout",
"param_value": "0",
"default_value": "0",
"value_type": "Interger",
"value_range": "0-7200"
},
{
"description": "Only events that run in more time than the configured latency-monitor-threshold will be logged as latency spikes. If latency-monitor-threshold is set to 0, latency monitoring is disabled. If latency-monitor-threshold is set to a value greater than 0, all events blocking the server for a time equal to or greater than the configured latency-monitor-threshold will be logged.",
"param_id": 10,
"param_name": "latency-monitor-threshold",
"param_value": "0",
"default_value": "0",
"value_type": "Interger",
"value_range": "0-86400000"
},
{
"description": "The total memory, in bytes, reserved for non-data usage.",
"param_id": 12,
"param_name": "reserved-memory",
"param_value": "0",
"default_value": "0",
"value_type": "Interger",
"value_range": "0-6553"
},
{
"description": "Redis can notify Pub or Sub clients about events happening in the key space",
"param_id": 13,
"param_name": "notify-keyspace-events",
"param_value": null,
"default_value": null,
"value_type": "regular",
"value_range": "([KE]+([A]|[g$lshzxe]+)){0,11}"
}
],
"config_status": "SUCCESS",
"config_time": ""
} 
