Fn::Length - AWS CloudFormation
DeclaraçãoParâmetrosValor de retornoExemplosFunções compatíveis

Este é o novo Guia de referência de modelos do CloudFormation. Atualize seus favoritos e links. Para obter ajuda para começar a usar o CloudFormation, consulte o Guia do usuário do AWS CloudFormation.

Fn::Length

A função intrínseca Fn::Length retorna o número de elementos em uma matriz ou uma função intrínseca que retorna um matriz.

Importante

Você deve usar o Transformação AWS::LanguageExtensions para usar a função intrínseca Fn::Length.

Declaração

JSON

{ "Fn::Length" : IntrinsicFunction }
{ "Fn::Length" : Array }

YAML

Fn::Length : IntrinsicFunction
Fn::Length : Array

Parâmetros

IntrinsicFunction

A função intrínseca que retorna uma matriz da qual você deseja retornar vários elementos.

Array

A matriz da qual você deseja retornar o número de elementos.

Valor de retorno

O número de elementos na função intrínseca que retorna uma matriz ou na matriz passada para a função intrínseca.

Exemplos

Retorna o número de elementos em uma função intrínseca que retorna uma matriz

Esse exemplo de trecho retorna o número de elementos em uma função intrínseca que retorna uma matriz. A função retorna 3.

JSON

{
//...
    "Transform": "AWS::LanguageExtensions"
    //...
        "Fn::Length" : {
            "Fn::Split": ["|", "a|b|c"]
        }
//...
}

YAML

Transform: 'AWS::LanguageExtensions'
#...
  Fn::Length: 
    !Split ["|", "a|b|c"]
#...

Retorna o número de elementos em uma função intrínseca Ref que referencia um tipo de parâmetro de lista

Esse exemplo de trecho retorna o número de elementos em uma função intrínseca Ref que referencia um tipo de parâmetro de lista. Se o parâmetro com o nome ListParameter for uma lista com 3 elementos, a função retornará 3.

JSON

{
//...
    "Transform": "AWS::LanguageExtensions"
    //...
        "Fn::Length": {
            "Ref": "ListParameter"
        }
//...
}

YAML

Transform: 'AWS::LanguageExtensions'
#...
  Fn::Length: 
    !Ref ListParameter
#...

Retornar o número de elementos em uma matriz

Esse exemplo de trecho retorna o número de elementos na matriz passada para a uma função intrínseca. A função retorna 3.

JSON

{
//...
    "Transform": "AWS::LanguageExtensions"
    //...
        "Fn::Length": [
            1,
            {"Ref": "ParameterName"}, 
            3
        ]
//...
}

YAML

Transform: 'AWS::LanguageExtensions'
#...
  Fn::Length: 
    - 1
    - !Ref ParameterName
    - 3
#...

Funções compatíveis

Você pode usar as funções a seguir na função intrínseca Fn::Length ou na matriz:

  • Condition Functions

  • Fn::Base64

  • Fn::FindInMap

  • Fn::Join

  • Fn::Length

  • Fn::Select

  • Fn::Split

  • Fn::Sub

  • Fn::ToJsonString

  • Ref