Todos os produtos
Search
Central de documentação

Resource Orchestration Service:Fn::Index

Última atualização: Jun 27, 2026

Consulta o índice de um elemento especificado em uma lista.

Declaração

  • JSON

    {
      "Fn::Index": [
        "item_to_find_index",
        [
        	"item1",
          "item2",
          ...
     		]
      ]
    }
  • YAML

    • Sintaxe do nome completo da função:

      Fn::Index:
       - item_to_find_index
       - - item1
         - item2
         - ...
    • Sintaxe da forma abreviada:

      !Index [item_to_find_index, [item1, item2, ...]]

Parâmetros

  • item_to_find_index: elemento cujo índice se deseja consultar. Se o elemento não existir na lista, a função retornará uma string vazia.

  • item: elemento da lista.

Valor retornado

Índice do elemento na lista. Se o elemento não existir, a função retornará uma string vazia.

Exemplos

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  ZoneIds:
    Type: Json
    Default:
      - cn-beijing-a
      - cn-beijing-b
      - cn-beijing-f
  ZoneId:
    Type: String
    Default: cn-beijing-b
Outputs:
  Index:
    Value: !Index [!Ref ZoneId, !Ref ZoneIds]
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "ZoneIds": {
      "Type": "Json",
      "Default": [
        "cn-beijing-a",
        "cn-beijing-b",
        "cn-beijing-f"
      ]
    },
    "ZoneId": {
      "Type": "String",
      "Default": "cn-beijing-b"
    }
  },
  "Outputs": {
    "Index": {
      "Value": {
        "Fn::Index": [
          {
            "Ref": "ZoneId"
          },
          {
            "Ref": "ZoneIds"
          }
        ]
      }
    }
  }
}

Funções compatíveis

O parâmetro item_to_find_index aceita a função Ref.

O parâmetro de lista aceita as seguintes funções: