本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

AWS::ServiceCatalog 轉換程序

AWS::ServiceCatalog轉換可讓 Service Catalog 使用者參考其 CloudFormation 範本中現有 Service Catalog 佈建產品的輸出。

若要參考現有佈建產品的輸出，您必須在範本的頂端包含 AWS::ServiceCatalog 轉換。如果需要輸出值，請提供已佈建產品的名稱和輸出索引鍵名稱。

您可以在範本中參考多個佈建的產品和索引鍵名稱，每個範本最多可參考 20 個。在佈建期間，轉換會從每個參照的已佈建產品和金鑰擷取值，並取代 CloudFormation範本中的輸出值。

用量

在範本的最上層使用 AWS::ServiceCatalog 轉換。您無法將 AWS::ServiceCatalog 作為內嵌於任何其他範本區段的轉換使用。

轉換宣告的值必須是常值字串。您不能使用參數或函數來指定轉換值。

範本最上層的語法

若要在範本的最上層包含 AWS::ServiceCatalog，請在 [轉換] 區段中使用下列語法。

JSON

{
"Transform": "AWS::ServiceCatalog",
. . .
}

YAML

Transform: AWS::ServiceCatalog

參數

AWS::ServiceCatalog 轉換不接受任何參數。

範例

下面的 JSON 和 YAML 範例顯示使用者如何參考範 CloudFormation 本中現有 Service Catalog 佈建產品的輸出。

在這些範例中，SampleProvisionedProduct 是先前建立的佈建產品。SampleOutputKey是此佈建產品的輸出索引鍵。

JSON

此範例是工作版本。

未將該值包裝為字串文字的範例版本將會失敗。

    {
        "AWSTemplateFormatVersion": "2010-09-09",
        "Transform": "AWS::ServiceCatalog",
        "Resources": {
            "ExampleParameter": {
                "Type": "AWS::SSM::Parameter",
                "Properties": {
                    "Type": "String",
                    "Value": "[[servicecatalog:provisionedproduct:SampleProvisionedProduct:SampleOutputKey]]"
                }
            }
        }
    }    

YAML

範例 1–4 是有效的範本。在範例 1 和 2 中，轉換和值是字串文字。

範例 5 不是有效的範本。值必須包裝在字串 ' 或 " 或 >- 內。如果沒有，使用者將會收到錯誤。

     // Example 1 
    AWSTemplateFormatVersion: 2010-09-09
    Transform: 'AWS::ServiceCatalog'
    Resources:
      ExampleParameter:
        Type: 'AWS::SSM::Parameter'
        Properties:
          Type: String
          Value: '[[servicecatalog:provisionedproduct:SampleProvisionedProduct:SampleOutputKey]]'
     
    // Example 2 
    AWSTemplateFormatVersion: 2010-09-09
    Transform: 'AWS::ServiceCatalog'
    Resources:
      ExampleParameter:
        Type: 'AWS::SSM::Parameter'
        Properties:
          Type: String
          Value: '[[servicecatalog:provisionedproduct:SampleProvisionedProduct:SampleOutputKey]]'
     
     
    // Example 3 
    AWSTemplateFormatVersion: 2010-09-09
    Transform: AWS::ServiceCatalog
    Resources:
      ExampleParameter:
        Type: 'AWS::SSM::Parameter'
        Properties:
          Type: String
          Value: "[[servicecatalog:provisionedproduct:SampleProvisionedProduct:SampleOutputKey]]"
     
     
    // Example 4 
     
    AWSTemplateFormatVersion: 2010-09-09
    Transform: AWS::ServiceCatalog
    Resources:
      ExampleParameter:
        Type: 'AWS::SSM::Parameter'
        Properties:
          Type: String
          Value: >-
            [[servicecatalog:provisionedproduct:SampleProvisionedProduct:SampleOutputKey]]
     
     
    // Example 5 
    AWSTemplateFormatVersion: 2010-09-09
    Transform: AWS::ServiceCatalog
    Resources:
      ExampleParameter2:
        Type: 'AWS::SSM::Parameter'
        Properties:
          Type: String
          Value: [[servicecatalog:provisionedproduct:SSMProductProvisionedProduct:SampleOutputKey]]