AWS APIの1つの値しか許可されない配列

AWS APIの1つの値しか許可されない配列:

はじめに

CloudFormationでALBを作成していたら、テンプレートの構文で気になるところがあった。

ListenerRuleのConditonsのValues

AWS::ElasticLoadBalancingV2::ListenerRuleのPropertyのConditionsのValuesが、配列になってるんですよね。
公式ドキュメントを見ても、ValuesはしっかりType: List of String valuesって書いてます。

Type: AWS::ElasticLoadBalancingV2::ListenerRule 
Properties: 
  Actions: 
    - Actions 
  Conditions: 
    - Field: String 
      Values: 
        - String # 配列になっている 
  ListenerArn: String 
  Priority: Integer 

通常は下記のように1つの値を入れるのだけど(実際いままではそうやってしか使っていなかった)、

配列になってるから2つ以上の値もいけるのか？と思って試してみた。

listenerRule: 
    Type: AWS::ElasticLoadBalancingV2::ListenerRule 
    Properties: 
      Actions: 
        - TargetGroupArn: 
            Ref: targetGroup 
          Type: forward 
      Conditions: 
        - Field: path-pattern 
          Values: 
            - hogehuga # パスパターンを記述 
      ListenerArn: 
        Ref: listener 
      Priority: 1 

パスパターンを2つ記述したテンプレート

listenerRule: 
    Type: AWS::ElasticLoadBalancingV2::ListenerRule 
    Properties: 
      Actions: 
        - TargetGroupArn: 
            Ref: targetGroup 
          Type: forward 
      Conditions: 
        - Field: path-pattern 
          Values: 
            - hogehuga 
            - foobaa # 配列なのでパスパターンを追加してみる 
      ListenerArn: 
        Ref: listener 
      Priority: 1 

が、ダメ・・・！

A condition can only have '1' values (Service: AmazonElasticLoadBalancingV2; Status Code: 400; Error Code: ValidationError; Request ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)

Fieldがホストヘッダの場合でもやってみたが、結果は同じ。

listenerRule: 
    Type: AWS::ElasticLoadBalancingV2::ListenerRule 
    Properties: 
      Actions: 
        - TargetGroupArn: 
            Ref: targetGroup 
          Type: forward 
      Conditions: 
        - Field: host-header 
          Values: 
            - hoge.example.com # ホストヘッダの場合でもやってみた 
            - huga.example.com 
      ListenerArn: 
        Ref: listener 
      Priority: 1 

公式ドキュメントに"you can specify a single host name", "you can specify a single path pattern"と書いてあるのでダメなんだろうなとは思ってた。

APIのドキュメントのほうも、文字列の配列になっている。

Values.member.N 
The condition value. 
 
~略~ 
 
Type: Array of strings 
 
Required: No 

AWSサポートに問い合わせてみた

なんで配列なのかなと思って、AWSサポートに問い合わせてみた。

以下回答の抜粋

> 私が理解できていないだけで、2つ以上の値を設定する場面があったり、その方法があったりするのでしょうか？ 
 
現時点では 2 つ以上の値を設定する場面はございません。 
 
配列となっている理由といたしましては、将来的に API の拡張が行われた際に、2 つ以上の値を指定できるように変更される可能性などが考えられます。 

なるほどなぁと思った(こなみ)