这是新的《CloudFormation 模板参考指南》**。请更新您的书签和链接。有关开始使用 CloudFormation 的帮助，请参阅《AWS CloudFormation 用户指南》[https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)。

# `Fn::Base64`
<a name="intrinsic-function-reference-base64"></a>

内部函数`Fn::Base64`返回输入字符串的 Base64 表示方法。该函数通常用于通过 `UserData` 属性将编码的数据传递给 Amazon EC2 实例。

## 声明
<a name="w2aac24c12b5"></a>

### JSON
<a name="intrinsic-function-reference-base64-syntax.json"></a>

```
{ "Fn::Base64" : valueToEncode }
```

### YAML
<a name="intrinsic-function-reference-base64-syntax.yaml"></a>

完整函数名称的语法：

```
Fn::Base64: valueToEncode
```

短格式的语法：

```
!Base64 valueToEncode
```

**注意**  
如果您使用简短格式并直接在 `valueToEncode` 参数中包含另一个函数，请在至少一个函数中使用完整函数名称。例如，以下语法是无效的：  

```
!Base64 !Sub string
!Base64 !Ref logical_ID
```
应该改为对至少一个函数使用完整函数名，如以下示例所示：  

```
!Base64
  "Fn::Sub": string

Fn::Base64:
  !Sub string
```

## Parameters
<a name="w2aac24c12b7"></a>

valueToEncode  
您想转换成 Base64 的字符串值。

## 返回值：
<a name="w2aac24c12b9"></a>

用 Base64 表示方法的原始字符串。

## 示例
<a name="w2aac24c12c11"></a>

### JSON
<a name="intrinsic-function-reference-base64-example.json"></a>

```
{ "Fn::Base64" : "AWS CloudFormation" }
```

### YAML
<a name="intrinsic-function-reference-base64-example.yaml"></a>

```
Fn::Base64: AWS CloudFormation
```

## 支持的函数
<a name="w2aac24c12c13"></a>

您可以在 `Fn::Base64` 函数内部使用返回字符串的任意函数。