Referensi fungsi intrinsik dan atribut DeletionPolicyUpdateReplacePolicy

Saat Anda menambahkan AWS::LanguageExtensions transformasi dalam AWS CloudFormation templat, Anda dapat menggunakan fungsi intrinsik untuk menentukan atribut DeletionPolicyatribut dan UpdateReplacePolicyatribut sumber daya.

catatan

Fungsi intrinsik harus diselesaikan menjadi valid Opsi DeletionPolicy atau. Opsi UpdateReplacePolicy

Pernyataan

JSON

{ "DeletionPolicy": IntrinsicFunction }

{ "UpdateReplacePolicy": IntrinsicFunction }

YAML

DeletionPolicy: IntrinsicFunction

UpdateReplacePolicy: IntrinsicFunction

Parameter

IntrinsicFunction

Fungsi intrinsik yang menyelesaikan ke valid atau opsi. DeletionPolicyatribut UpdateReplacePolicyatribut

Contoh

Mendefinisikan DeletionPolicy dan UpdateReplacePolicy menggunakan fungsi Fn:If intrinsik

Contoh berikut menetapkan UpdateReplacePolicyatribut atribut DeletionPolicyatribut dan berdasarkan kondisi yang didefinisikan dalam fungsi Fn::If intrinsik. Jika Stage parameternyaProd, UpdateReplacePolicy atribut DeletionPolicy and akan diatur keRetain.

JSON

{
    "AWSTemplateFormatVersion": "2010-09-09",
    "Transform": "AWS::LanguageExtensions",
    "Parameters": {
        "Stage": {
            "Type": "String",
            "AllowedValues": [
                "Prod",
                "Staging",
                "Dev"
            ]
        }
    },
    "Conditions": {
        "IsProd": {
            "Fn::Equals": [
                {
                    "Ref": "Stage"
                },
                "Prod"
            ]
        }
    },
    "Resources": {
        "Table": {
            "Type": "AWS::DynamoDB::Table",
            "Properties": {
                "KeySchema": [{
                    "AttributeName": "primaryKey",
                    "KeyType": "HASH"
                }],
                "AttributeDefinitions": [{
                        "AttributeName": "primaryKey",
                        "AttributeType": "S"
                }]
            },
            "DeletionPolicy": {
                "Fn::If": [
                    "IsProd",
                    "Retain",
                    "Delete"
                ]
            },
            "UpdateReplacePolicy": {
                "Fn::If": [
                    "IsProd",
                    "Retain",
                    "Delete"
                ]
            }
        }
    }
}

YAML

AWSTemplateFormatVersion: 2010-09-09
Transform: 'AWS::LanguageExtensions'
Parameters:
  Stage:
    Type: String
    AllowedValues:
      - Prod
      - Staging
      - Dev
Conditions:
  IsProd: !Equals 
    - !Ref Stage
    - Prod
Resources:
  Table:
    Type: 'AWS::DynamoDB::Table'
    Properties:
      KeySchema:
        - AttributeName: primaryKey
          KeyType: HASH
      AttributeDefinitions:
        - AttributeName: primaryKey
          AttributeType: S
    DeletionPolicy: !If 
      - IsProd
      - Retain
      - Delete
    UpdateReplacePolicy: !If 
      - IsProd
      - Retain
      - Delete

Tentukan DeletionPolicy dan UpdateReplacePolicy atribut menggunakan fungsi Ref intrinsik

Contoh berikut menetapkan UpdateReplacePolicyatribut atribut DeletionPolicyatribut dan berdasarkan nilai diselesaikan oleh fungsi Ref intrinsik. Jika UpdateReplacePolicyParam parameter DeletionPolicyParam dan keduanya disetel keRetain, UpdateReplacePolicy atribut DeletionPolicy dan juga diatur keRetain.

JSON

{
    "AWSTemplateFormatVersion": "2010-09-09",
    "Transform": "AWS::LanguageExtensions",
    "Parameters": {
        "DeletionPolicyParam": {
            "Type": "String",
            "AllowedValues": [
                "Delete",
                "Retain",
                "Snapshot"
            ],
            "Default": "Delete"
        },
        "UpdateReplacePolicyParam": {
            "Type": "String",
            "AllowedValues": [
                "Delete",
                "Retain",
                "Snapshot"
            ],
            "Default": "Delete"
        }
    },
    "Resources": {
        "Table": {
            "Type": "AWS::DynamoDB::Table",
            "Properties": {
                "KeySchema": [
                    {
                        "AttributeName": "primaryKey",
                        "KeyType": "HASH"
                }],
                "AttributeDefinitions": [{
                    "AttributeName": "primaryKey",
                    "AttributeType": "S"
                }]
            },
            "DeletionPolicy": {
                "Ref": "DeletionPolicyParam"
            },
            "UpdateReplacePolicy": {
                "Ref": "UpdateReplacePolicyParam"
            }
        }
    }
}

YAML

AWSTemplateFormatVersion: 2010-09-09
Transform: 'AWS::LanguageExtensions'
Parameters:
  DeletionPolicyParam:
    Type: String
    AllowedValues:
      - Delete
      - Retain
      - Snapshot
    Default: Delete
  UpdateReplacePolicyParam:
    Type: String
    AllowedValues:
      - Delete
      - Retain
      - Snapshot
    Default: Delete
Resources:
  Table:
    Type: 'AWS::DynamoDB::Table'
    Properties:
      KeySchema:
        - AttributeName: primaryKey
          KeyType: HASH
      AttributeDefinitions:
        - AttributeName: primaryKey
          AttributeType: S
    DeletionPolicy: !Ref DeletionPolicyParam
    UpdateReplacePolicy: !Ref UpdateReplacePolicyParam

Fungsi yang didukung

Di dalam DeletionPolicy atau UpdateReplacePolicy atribut, Anda dapat menggunakan fungsi-fungsi berikut:

• Fn::FindInMap

• Fn::If

• Ref

Anda juga dapat menggunakan parameter Pseudo berikut:

• AWS::AccountId

• AWS::Partition

• AWS::Region