Actualiza los atributos de un Logstore.
Descripción de la operación
Descripción de la operación
Antes de actualizar un Logstore, llame a la operación GetLogStore para obtener la configuración actual del Logstore. Modifique la configuración según sea necesario y pásela como parámetros a la operación UpdateLogStore.
El Host en la sintaxis de la solicitud consta del nombre del proyecto y el endpoint de Simple Log Service. Especifique el proyecto en el Host.
Se ha creado y obtenido un par de AccessKey. Para más información, consulte Par de AccessKey.
Un par de AccessKey de una cuenta de Alibaba Cloud tiene permisos de acceso a todas las operaciones de la API. Esto representa un alto riesgo de seguridad. Le recomendamos que cree y utilice un usuario de Resource Access Management (RAM) para llamar a las operaciones de la API o realizar tareas rutinarias de operación y mantenimiento. El usuario de RAM debe tener los permisos necesarios sobre los recursos EPS de Simple Log Service. Para más información, consulte Crear un usuario de RAM y otorgar autorización.
Ha determinado el nombre del proyecto, la región y el nombre del Logstore para los registros que desea consultar. Para más información, consulte Gestionar un proyecto y Gestionar un Logstore.
Se generan registros de operación cuando llama a esta operación.
Recursos de autenticación
La siguiente tabla enumera la información de autorización para esta operación de la API. Puede agregar la información al elemento Action en una declaración de política de acceso de RAM para otorgar a un usuario de RAM o a un rol de RAM los permisos necesarios para invocar esta operación de la API.
| Acción | Recurso |
log:UpdateLogStore | acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/{#LogstoreName} |
Pruébelo ahora
Test
Autorización de RAM
|
Action |
Nivel de acceso |
Tipo de recurso |
Clave de condición |
Acción dependiente |
|
log:UpdateLogStore |
update |
*LogStore
|
|
Ninguna |
Sintaxis de la solicitud
PUT /logstores/{logstore} HTTP/1.1
Parámetros de ruta
|
Parámetro |
Tipo |
Obligatorio |
Descripción |
Ejemplo |
| logstore |
string |
Sí |
El nombre del Logstore. |
test-logstore |
Parámetros de la solicitud
|
Parámetro |
Tipo |
Obligatorio |
Descripción |
Ejemplo |
| project |
string |
Sí |
El nombre del proyecto. |
ali-test-project |
| body |
object |
Sí |
Los parámetros del cuerpo de la solicitud. |
|
| logstoreName |
string |
Sí |
El nombre del Logstore. |
test-logstore |
shardCount
deprecated
|
integer |
No |
El número de shards. Nota
Esta operación no admite la actualización del número de shards. Solo puede modificar el número de shards llamando a la operación SplitShard o MergeShards. |
2 |
| ttl |
integer |
Sí |
El período de retención de datos. Unidad: días. Valores válidos: de 1 a 3650. Un valor de 3650 indica retención permanente. |
30 |
| encrypt_conf | EncryptConf |
No |
La configuración de cifrado. El cifrado está deshabilitado de forma predeterminada. Ejemplo 1 (habilitar el cifrado predeterminado):
Ejemplo 2 (habilitar el cifrado BYOK): |
|
| autoSplit |
boolean |
No |
Especifica si se debe habilitar la fragmentación automática. Una vez habilitada esta función, un shard se divide automáticamente cuando el tráfico de escritura supera continuamente el límite, lo que mejora la capacidad de escritura. Debe establecer maxSplitShard (el número máximo de shards después de la división) cuando habilite la fragmentación automática. |
true |
| enable_tracking |
boolean |
No |
Especifica si se debe habilitar la función WebTracking. Valor predeterminado: false. Puede utilizar la función WebTracking para recopilar y analizar datos de comportamiento del usuario en navegadores o mini programas, como vistas de página, registros de compras y tiempo de permanencia en el sitio.
|
false |
| appendMeta |
boolean |
No |
Especifica si se debe registrar la dirección IP pública y la hora de llegada del registro. Valor predeterminado: false.
|
false |
| maxSplitShard |
integer |
No |
El número máximo de shards para la fragmentación automática. Valor mínimo: 1. Valor máximo: 256. Nota
Este parámetro es obligatorio cuando autoSplit se establece en true. |
64 |
telemetryType
deprecated
|
string |
No |
El tipo de datos observables. El valor predeterminado son los datos de registro. Valores válidos:
|
None |
| hot_ttl |
integer |
No |
El período de retención de datos en el nivel caliente del Logstore. Unidad: días. Valor mínimo: 7. El valor no puede exceder el valor de ttl. De forma predeterminada, todos los datos dentro del período de retención se almacenan en el nivel caliente. Después de que el tiempo de almacenamiento de los datos supere el período de retención de datos calientes configurado, los datos se mueven al nivel de acceso poco frecuente (IA). Cuando habilita el nivel IA, el período de retención de datos calientes debe ser de al menos 7 días. Para más información, consulte Niveles inteligentes. Ejemplos:
|
60 |
| mode |
string |
No |
Simple Log Service proporciona dos tipos de Logstores: Estándar y Consulta.
|
standard |
| infrequentAccessTTL |
integer |
No |
Nivel de acceso poco frecuente (IA). No se requiere un tiempo mínimo de almacenamiento. Los datos deben almacenarse durante al menos 30 días antes de moverse al nivel de archivo. Cuando el período de retención de registros supera la suma del período de retención del nivel caliente y el período de retención del nivel IA, el tiempo de almacenamiento restante se convierte en almacenamiento de nivel de archivo. Ejemplos:
|
30 |
| shardingPolicy | ShardingPolicy |
No |
La configuración de escritura basada en hash. Cuando se escriben datos, los registros se enrutan a los shards según la política de hash configurada. Antes de configurar este parámetro, asegúrese de que los rangos de hash de los shards estén distribuidos uniformemente. Esta configuración puede afectar la capacidad de escritura. Proceda con precaución. |
Elementos de la respuesta
|
Elemento |
Tipo |
Descripción |
Ejemplo |
Ejemplos
Respuesta exitosa
JSON Formato
{}
Códigos de error
Consulte Códigos de error para ver la lista completa.
Notas de la versión
Consulte Notas de la versión para ver la lista completa.