Todos os produtos
Search
Central de documentação

Resource Orchestration Service:ALIYUN::SLS::Logstore

Última atualização: Jun 27, 2026

O recurso ALIYUN::SLS::Logstore cria um Logstore em um projeto do Simple Log Service (SLS).

Sintaxe

{
  "Type": "ALIYUN::SLS::Logstore",
  "Properties": {
    "ProjectName": String,
    "ShardCount": Integer,
    "AutoSplit": Boolean,
    "MaxSplitShard": Integer,
    "LogstoreName": String,
    "AppendMeta": Boolean,
    "TTL": Integer,
    "EnableTracking": Boolean,
    "PreserveStorage": Boolean,
    "EncryptConf": Map,
    "Mode": String
  }
}

Propriedades

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

ProjectName

String

Sim

Não

Projeto SLS onde crie o Logstore.

De 3 a 63 caracteres.

Pode conter letras minúsculas, dígitos, hifens (-) e sublinhados (_). Deve começar e terminar com uma letra minúscula ou dígito.

ShardCount

Integer

Não

Sim

Número de shards.

Valores válidos: 1 a 100.

Valor padrão: 2.

MaxSplitShard

Integer

Não

Sim

Número máximo de shards para divisão automática.

Valores válidos: 1 a 64.

Obrigatório quando AutoSplit é definido como true.

LogstoreName

String

Sim

Não

Nome do Logstore.

Deve ser único no projeto SLS.

  • De 3 a 36 caracteres.

  • Aceita letras minúsculas, dígitos, hifens (-) e sublinhados (_).

  • Deve começar e terminar com letra minúscula ou dígito.

AutoSplit

Boolean

Não

Sim

Indica se os shards serão divididos automaticamente.

Valores válidos:

  • true

  • false (padrão)

TTL

Integer

Não

Sim

Período de retenção de dados.

Valores válidos: 1 a 3600.

Valor padrão: 30.

Unidade: dia.

EnableTracking

Boolean

Não

Sim

Indica se o rastreamento web está ativado.

O rastreamento web coleta dados de navegadores e aplicativos iOS e Android.

Valores válidos:

  • true

  • false (padrão)

PreserveStorage

Boolean

Não

Sim

Indica se os logs são retidos permanentemente.

Valores válidos:

  • true: retém os logs permanentemente. O TTL não tem efeito quando PreserveStorage é definido como true.

  • false (padrão): não retém os logs permanentemente.

Mode

String

Não

Sim

Tipo do Logstore.

Valores válidos:

  • standard: Logstore Padrão. Oferece suporte à análise de logs e é ideal para monitoramento em tempo real e análises interativas. Use este tipo para construir um sistema abrangente de observabilidade.

  • query: Logstore de Consulta. Permite consultas de alto desempenho com custo de tráfego de índice equivalente a aproximadamente metade do Logstore Padrão. Não oferece suporte à análise SQL. Recomendado para grandes volumes de dados, longos períodos de retenção ou cenários sem necessidade de análise de logs. Longo período de retenção refere-se a logs armazenados por semanas ou meses.

AppendMeta

Boolean

Não

Sim

Indica se o endereço IP público do cliente e o horário de recebimento são anexados ao log.

Valores válidos:

  • true

  • false (padrão)

EncryptConf

Map

Não

Não

Configuração de criptografia de dados.

Consulte a Sintaxe de EncryptConf e as Propriedades de EncryptConf.

Sintaxe de EncryptConf

"EncryptConf": {
    "Enable": Boolean,
    "EncryptType": String,
    "UserCmkInfo": Map
}

Propriedades de EncryptConf

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

Enable

Boolean

Sim

Não

Indica se a criptografia de dados está ativada.

Valores válidos:

  • true

  • false (padrão)

EncryptType

String

Sim

Não

Algoritmo de criptografia.

Valores válidos:

  • default: algoritmo Advanced Encryption Standard (AES)

  • m4: algoritmo criptográfico chinês

Nota

Consulte Criptografia de dados.

UserCmkInfo

Map

Não

Não

Método BYOK para criptografia e descriptografia de dados. Se estiver vazio, o sistema usa a chave de serviço SLS.

Consulte a Sintaxe de UserCmkInfo e as Propriedades de UserCmkInfo.

Sintaxe de UserCmkInfo

"UserCmkInfo": {
    "CmkKeyId": String,
    "Arn": String,
    "RegionId": String
  }

Propriedades de UserCmkInfo

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

CmkKeyId

String

Sim

Não

ID da chave mestra do cliente (CMK) para criptografia BYOK.

Nenhuma.

RegionId

String

Sim

Não

ID da região da CMK.

Nenhuma.

Arn

String

Sim

Não

Alibaba Cloud Resource Name (ARN) da função RAM.

Para consultar o ARN de uma função RAM, consulte Enviar dados de log do Simple Log Service para o OSS.

Valores de retorno

Fn::GetAtt

  • LogstoreName: nome do Logstore.

  • ProjectName: nome do projeto SLS.

Exemplos

Formato YAML

ROSTemplateFormatVersion: '2015-09-01'
Description: Test SLS Logstore
Parameters: {}
Resources:
  SlsLogStore:
    Type: ALIYUN::SLS::Logstore
    Properties:
      LogstoreName: mytest
      PreserveStorage: true
      ProjectName: TestProject
      AppendMeta: true
      MaxSplitShard: 64
      AutoSplit: true
      EnableTracking: false
      ShardCount: 2
Outputs: {}

Formato JSON

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Description": "Test SLS Logstore",
  "Parameters": {
  },
  "Resources": {
    "SlsLogStore": {
      "Type": "ALIYUN::SLS::Logstore",
      "Properties": {
        "LogstoreName": "mytest",
        "PreserveStorage": true,
        "ProjectName": "TestProject",
        "AppendMeta": true,
        "MaxSplitShard": 64,
        "AutoSplit": true,
        "EnableTracking": false,
        "ShardCount": 2
      }
    }
  },
  "Outputs": {
  }
}

Para mais exemplos, visite sls.yml. Este exemplo utiliza os seguintes tipos de recursos: ALIYUN::SLS::Project, ALIYUN::SLS::Logstore, ALIYUN::SLS::Index, ALIYUN::SLS::LogtailConfig, ALIYUN::SLS::MachineGroup, ALIYUN::SLS::ApplyConfigToMachineGroup, ALIYUN::ApiGateway::LogConfig, ALIYUN::SLS::Savedsearch e ALIYUN::SLS::Alert.