SAMテンプレート（Cloud Formation） Fn::Subの使い方（リソースパラメータの参照）

Question

実現したいこと

aws samでAPIGW用テンプレートを作成しています。
デプロイ前にsam validate --lintでチェックしたのですが、Fn::Subの部分でエラーが出てしまいました。
エラー２件出ています。
①${ServerlessRestApi}
②${RestApi.Properties.StageName}

①については別件として投稿しておりますので
②の部分についてどう修正すれば良いのかご教示ください。

前提

省略

発生している問題・エラーメッセージ

PS C:\Users\luna\devRoot\mybank-sample> sam validate --lint
E6001 Output ApigwInfo is not an object
C:\Users\luna\devRoot\mybank-sample\template.yaml:54:3

E6001 Output Description has invalid property Fn::Sub
C:\Users\luna\devRoot\mybank-sample\template.yaml:56:5

E1019 Parameter ServerlessRestApi for Fn::Sub not found at Outputs/Description/Value/Fn::Sub
C:\Users\luna\devRoot\mybank-sample\template.yaml:58:5

★↓該当エラー箇所★
E1019 ★Parameter RestApi.Properties.StageName for Fn::Sub not found★ at Outputs/Description/Value/Fn::Sub
C:\Users\luna\devRoot\mybank-sample\template.yaml:58:5

Error: Linting failed. At least one linting rule was matched to the provided template.

該当のソースコード

AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
Description: "Sample SAM Template for local-deploy-sample1"

Resources:
  RestApi:
    Type: AWS::Serverless::Api
    Properties:
      Name: my-bank-api-name
      Description: RestApi-no-Properties-no-Description
      EndpointConfiguration: REGIONAL
      StageName: mybank-stage        #base-path to awaseru
      OpenApiVersion: 3.0.2
      DefinitionUri: ./openapi.yaml
・・・省略・・・
Outputs:
  ApigwInfo:
    Description:
    Fn::Sub: ${RestApi} 
    Value: !Sub "https://${ServerlessRestApi}.execute-api.${AWS::Region}.amazonaws.com/${RestApi.Properties.StageName}/"

試したこと

awsリファレンス Fn::Subは確認しました。

If you specify resource attributes, such as ${MyInstance.PublicIp}, CloudFormation returns the same values as if you used the Fn::GetAtt intrinsic function.
と記載があるので、${RestApi.Properties.StageName}もOKかと思った次第です。

補足情報（FW/ツールのバージョンなど）

省略

Comments

[dbfreak]

===============
①については別件として投稿しておりますので
②の部分についてどう修正すれば良いのかご教示ください。
===============
本文に記載のとおり、未投稿の②に対するQAとなりますのでご指摘には当たらないと思います。

Answer 1

AWSのCloudFormationテンプレートまたはSAMテンプレートに使用するSubやRef、GetAtt関数が返すものはリソースごとに違うというのを意識するといいかと思います。
今回の場合は"AWS::Serverless::Api"というリソースなので、ドキュメントを見に行くと、戻り値というセクションがあるので参考にしてください。
https://docs.aws.amazon.com/ja_jp/serverless-application-model/latest/developerguide/sam-resource-api.html#sam-resource-api-return-values

上記のドキュメントに従うと、
RestAPIのIDとRootパスのリソースIDしか取得できません。（原因②）
!Subは!Refと同じ値を使用します
そのため下記のような記載要領になるかと思います

Outputs:
  ApigwInfo:
    Description: !Sub "${RestApi}"
    Value: !Sub "https://${RestApi}.execute-api.${AWS::Region}.amazonaws.com/mybank-stage/"

なおご記載の${ServerlessRestApi}についてはリソース上存在しないので、エラーになると思います（原因①）

補足ですがいわゆるテンプレートの${RestApi}というのは論理IDというのですが、プログラミング言語でいうと変数にあたります。
他にもテンプレートの引数のようなParametersセクションやFn::ImportValueといった別のテンプレートでOutputsで定義したものを引き込む便利なものもあります。

AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31

Parameters:
  パラメータ１:
    Type: String
    Default: 許可された値１
    AllowedValues:
      - 許可された値１
      - 許可された値２
      - 許可された値３
    Description: パラメータ1という引数に許可された値１～３という値のみ入れることができます
  ApiStage:
    Type: String
    Description: APIのステージ

Resources:
  リソースの論理ID１:
    Type: AWS::Serverless::Api
    Properties:
      Name: !Sub "${パラメータ1}-api"
      Description:
        Fn::ImportValue: "アウトプット１"
      StageName: !Ref ApiStage
・・・
Outputs:
  アウトプット２:
    Description: "CloudFormationのアウトプット"
    Value: !Sub "https://${リソースの論理ID１}.execute-api.${AWS::Region}.amazonaws.com/${ApiStage}/"