Todos los productos
Search
Centro de documentos

Simple Log Service:UpdateLogStore

Última actualización: Sep 01, 2026

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.

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ónRecurso
log:UpdateLogStoreacs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/{#LogstoreName}

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

  • Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.

  • API: La API que debe invocarse para llevar a cabo la acción.

  • Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.

  • Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.

    • En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.

    • Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.

  • Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.

  • Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

log:UpdateLogStore

update

*LogStore

acs:log:{#regionId}:{#accountId}:project/{#project}/logstore/{#logstore}

  • log:TLSVersion
  • log:Encrypted
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):

{
    "enable": true,
    "encrypt_conf": "default"
}

Ejemplo 2 (habilitar el cifrado BYOK):

{
    "enable": true,
    "encrypt_conf": "default",
    "user_cmk_info": {
        "cmk_key_id": "xxxxx",
        "arn": "acs:ram::112340000000:role/rolename",
        "region": "ap-southeast-1"
    }
}

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.

  • true: habilita WebTracking.

  • false: deshabilita WebTracking.

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.

  • true: habilita la función. Una vez habilitada esta función, Simple Log Service agrega automáticamente la dirección IP pública del dispositivo de origen del registro y la hora en que el registro llega al servidor al campo Tag del registro.

  • false: deshabilita la función.

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: datos de registro. Este es el valor predeterminado.

  • Metrics: datos de series temporales.

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:

  • Escenario 1 (solo nivel caliente, 30 días): {"ttl": 30} o {"ttl": 30, "hot_ttl": 30}

  • Escenario 2 (nivel caliente 7 días, nivel IA 23 días): {"ttl": 30, "hot_ttl": 7}

60

mode

string

No

Simple Log Service proporciona dos tipos de Logstores: Estándar y Consulta.

  • standard: admite las capacidades integrales de análisis de datos de Simple Log Service. Este tipo es adecuado para escenarios como monitoreo en tiempo real, análisis interactivo y construcción de sistemas completos de observabilidad.

  • query: admite consultas de alto rendimiento. La tarifa de tráfico de índice es aproximadamente la mitad que la del tipo Estándar. Sin embargo, no se admite el análisis SQL. Este tipo es adecuado para escenarios con grandes volúmenes de datos, períodos de almacenamiento prolongados (semanas o meses) y sin requisitos de análisis de registros.

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:

  • Escenario 1 (nivel caliente 7 días, nivel IA 23 días): {"ttl": 30, "hot_ttl": 7}

  • Escenario 2 (nivel caliente 7 días, nivel IA 30 días, nivel de archivo 60 días): {"ttl": 97, "hot_ttl": 7, "infrequentAccessTTL": 30}

  • Escenario 3 (nivel caliente 60 días, nivel IA 0 días, nivel de archivo 60 días): {"ttl": 120, "hot_ttl": 60, "infrequentAccessTTL": 0}

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.