Todos os produtos
Search
Central de documentação

Resource Orchestration Service:Fn::Length

Última atualização: Jun 27, 2026

A função Fn::Length retorna o comprimento de um objeto, como o número de caracteres em uma string, elementos em uma lista ou pares chave-valor em um dicionário.

Declaração

  • JSON

    {
     "Fn::Length": Object
    }
  • YAML

    • Sintaxe do nome completo da função:

      Fn::Length : Object
    • Sintaxe da forma abreviada:

      !Length Object

Parâmetros

Object: o objeto cujo comprimento se deseja obter. Tipos válidos: String, List e Dictionary.

Valor de retorno

Comprimento do objeto. O valor retornado é um número inteiro.

Exemplos

Calcular o número de pares chave-valor em um dicionário

!Length
  key1: v1
  key2: v2
{
  "Fn:Length": {
    "key1": "v1",
    "key2": "v2"
  }
}

O valor retornado é 2.

Calcular o número de elementos em uma lista

!Length
 - 1
 - 2
 - 3
{
  "Fn:Length": [1,2,3]
}

O valor retornado é 3.

Calcular o número de caracteres em uma string

!Length aaaaaa
{
  "Fn::Length": "aaaaaa"
}

O valor retornado é 6.