這是新的 *CloudFormation 範本參考指南*。請更新您的書籤和連結。如需 CloudFormation 入門的說明，請參閱 [AWS CloudFormation 使用者指南](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` 函數內使用任何會傳回字串的函數。