AWS::CloudFormation::Interface - AWS CloudFormation
SintaksPropertiContoh

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

AWS::CloudFormation::Interface

AWS::CloudFormation::Interfaceadalah kunci metadata yang mendefinisikan bagaimana parameter dikelompokkan dan diurutkan di konsol. AWS CloudFormation Secara default, konsol mencantumkan parameter input dalam urutan abjad menurut logisnya IDs saat Anda membuat atau memperbarui tumpukan di konsol. Dengan menggunakan kunci ini, Anda dapat menentukan pengelompokan parameter dan pengurutan Anda sendiri agar pengguna dapat secara efisien menentukan nilai parameter. Misalnya, Anda dapat mengelompokkan semua parameter EC2 terkait dalam satu grup dan semua parameter VPC terkait di grup lain.

Pada kunci metadata, Anda dapat menentukan grup yang akan dibuat, parameter yang akan disertakan di setiap grup, dan urutan saat konsol menampilkan setiap parameter dalam kelompoknya.

Anda juga dapat menentukan label untuk parameter. Label adalah nama atau deskripsi yang mudah dimengerti yang ditampilkan oleh konsol sebagai pengganti ID logis parameter. Label berguna untuk membantu pengguna memahami nilai yang ditentukan untuk setiap parameter. Misalnya, Anda dapat melabeli parameter KeyPair Select an EC2 key pair.

Semua parameter yang Anda referensikan dalam kunci metadata harus dinyatakan dalam Parameters bagian dari template.

catatan

Hanya CloudFormation konsol yang menggunakan kunci AWS::CloudFormation::Interface metadata. AWS CLI dan API panggilan tidak menggunakan kunci ini.

Sintaks

Untuk mendeklarasikan entitas ini di CloudFormation template Anda, gunakan sintaks berikut:

JSON

"Metadata" : {
  "AWS::CloudFormation::Interface" : {
    "ParameterGroups" : [ ParameterGroup, ... ],
    "ParameterLabels" : ParameterLabel
  }
}

YAML

Metadata:
  AWS::CloudFormation::Interface:
    ParameterGroups:
      - ParameterGroup
    ParameterLabels:
      ParameterLabel

Properti

ParameterGroups

Daftar jenis grup parameter, di mana Anda menentukan nama grup, parameter di setiap grup, dan urutan parameter yang ditampilkan.

Wajib: Tidak

Jenis: AWS::CloudFormation::Interface ParameterGroup

Pembaruan membutuhkan: Tidak ada gangguan

ParameterLabels

Pemetaan parameter dan nama ramahnya yang ditampilkan CloudFormation konsol saat tumpukan dibuat atau diperbarui.

Wajib: Tidak

Jenis: AWS::CloudFormation::Interface ParameterLabel

Pembaruan membutuhkan: Tidak ada gangguan

Contoh

Contoh berikut menentukan dua grup parameter: Network Configuration dan Amazon EC2 Configuration. Grup Network Configuration mencakup parameter VPCID, SubnetId, dan SecurityGroupID, yang ditentukan di bagian Parameters dari templat (tidak ditampilkan). Urutan di mana konsol menunjukkan parameter ini ditentukan berdasarkan urutan parameter yang tercantum, yang dimulai dengan parameter VPCID. Contoh secara identik mengelompokkan dan mengurutkan parameter Amazon EC2 Configuration.

Contoh ini juga menentukan label untuk parameter VPCID. Konsol akan ditampilkan Ke mana ini VPC harus digunakan? bukan ID logis parameter (VPCID).

JSON

"Metadata" : {
  "AWS::CloudFormation::Interface" : {
    "ParameterGroups" : [
      {
        "Label" : { "default" : "Network Configuration" },
        "Parameters" : [ "VPCID", "SubnetId", "SecurityGroupID" ]
      },
      {
        "Label" : { "default":"Amazon EC2 Configuration" },
        "Parameters" : [ "InstanceType", "KeyName" ]
      }
    ],
    "ParameterLabels" : {
      "VPCID" : { "default" : "Which VPC should this be deployed to?" }
    }
  }
}

YAML

Metadata: 
  AWS::CloudFormation::Interface: 
    ParameterGroups: 
      - 
        Label: 
          default: "Network Configuration"
        Parameters: 
          - VPCID
          - SubnetId
          - SecurityGroupID
      - 
        Label: 
          default: "Amazon EC2 Configuration"
        Parameters: 
          - InstanceType
          - KeyName
    ParameterLabels: 
      VPCID: 
        default: "Which VPC should this be deployed to?"

Grup parameter di konsol

Penggunaan kunci metadata dari contoh ini, gambar berikut menunjukkan cara konsol menampilkan grup parameter saat tumpukan dibuat atau diperbarui: Grup parameter di konsol

Konsol menunjukkan grup parameter untuk contoh ini.