From fd2fa5dffae6166cc819536a8cc16e64724ecc88 Mon Sep 17 00:00:00 2001 From: Jack Kuo Date: Mon, 24 Feb 2020 15:14:06 +0800 Subject: [PATCH] Fix markdown syntax Add a space between period & sentence so that the markdown engine of GitHub can render it correctly. --- README/README-CN.md | 96 ++++++++++++++++++++++----------------------- README/README-JP.md | 96 ++++++++++++++++++++++----------------------- README/README-TW.md | 96 ++++++++++++++++++++++----------------------- 3 files changed, 144 insertions(+), 144 deletions(-) diff --git a/README/README-CN.md b/README/README-CN.md index 9fe7d26..c825fbd 100644 --- a/README/README-CN.md +++ b/README/README-CN.md @@ -14,15 +14,15 @@ #### 步骤 1：创建 CloudSearch 域 -1.使用 [AWS CLI](https://aws.amazon.com/cli/) 创建新 CloudSearch 域，自己选择一个域名。 +1. 使用 [AWS CLI](https://aws.amazon.com/cli/) 创建新 CloudSearch 域，自己选择一个域名。 ``` aws cloudsearch create-domain --domain-name [YOUR_DOMAIN_NAME] ``` -1.记下输出文档中新域的 ARN。启动 CloudFormation 堆栈时，您将使用此信息作为输入。 +1. 记下输出文档中新域的 ARN。启动 CloudFormation 堆栈时，您将使用此信息作为输入。 -1.定义 `headline` 和 `note_text` 字段的索引。 +1. 定义 `headline` 和 `note_text` 字段的索引。 ``` aws cloudsearch define-index-field --name headline --type text --domain-name [YOUR_DOMAIN_NAME] @@ -35,23 +35,23 @@ #### 步骤 2：创建 API Gateway REST API -1.使用 [AWS CLI](https://aws.amazon.com/cli/) 创建新 API，自己选择一个名称。 +1. 使用 [AWS CLI](https://aws.amazon.com/cli/) 创建新 API，自己选择一个名称。 ``` aws apigateway create-rest-api --name [YOUR_API_NAME] ``` -1.记下输出文档中提供的 `API ID`。启动 CloudFormation 堆栈时，您将使用此信息作为输入。 +1. 记下输出文档中提供的 `API ID`。启动 CloudFormation 堆栈时，您将使用此信息作为输入。 #### 步骤 3：创建 Amazon Cognito 身份池 -1.使用 [AWS CLI](https://aws.amazon.com/cli/) 创建新身份池，自己选择一个名称。 +1. 使用 [AWS CLI](https://aws.amazon.com/cli/) 创建新身份池，自己选择一个名称。 ``` aws cognito-identity create-identity-pool --allow-unauthenticated-identities --identity-pool-name [YOUR_POOL_NAME] ``` -1.记下输出文档中的 `IdentityPoolId`。启动 CloudFormation 堆栈时，您将使用此信息作为参数。 +1. 记下输出文档中的 `IdentityPoolId`。启动 CloudFormation 堆栈时，您将使用此信息作为参数。 #### 步骤 4：启动 CloudFormation 模板 @@ -69,38 +69,38 @@ 创建 CloudFormation 堆栈后，您需要更新先前创建的 API 以使用新创建的 `NotesApiFunction`。 -1.在 [Amazon API Gateway 控制台](https://console.aws.amazon.com/apigateway/home?region=us-east-1#/apis) 中选择您的 API。 -1.选择 **Create Resource** 以在 / 下面创建新的子资源。 -1.键入 `notes` 作为资源名称，并键入 `/notes` 作为资源路径。 -1.选择 **Create Resource**。 -1.选中 `/notes` 资源后，选择 **Create Method**。 -1.选择 `POST` 并选中复选框。 -1.选择 **Lambda Function** 作为集成类型，然后选择启动 CloudFormation 堆栈时所在的区域作为 Lambda 区域。 -1.在 **Lambda Function** 中，键入 **`NotesApiFunction`**，然后选择 CloudFormation 堆栈创建的函数。 -1.选择 **Save**，并授予 API Gateway 权限以执行 Lambda 函数。 -1.选择 **Method Request** 以编辑请求配置。 -1.对于 **Authorization type**，选择 `AWS_IAM`。 -1.对于 **API Key Required**，选择 `true`。 -1.选择 **Deploy API**。 -1.对于 **Deployment stage**，选择 `New Stage`，然后在 **Stage name** 中键入名称。 -1.记下新阶段的 **Invoke URL**。运行示例 iOS 应用程序时，您将使用此值。 +1. 在 [Amazon API Gateway 控制台](https://console.aws.amazon.com/apigateway/home?region=us-east-1#/apis) 中选择您的 API。 +1. 选择 **Create Resource** 以在 / 下面创建新的子资源。 +1. 键入 `notes` 作为资源名称，并键入 `/notes` 作为资源路径。 +1. 选择 **Create Resource**。 +1. 选中 `/notes` 资源后，选择 **Create Method**。 +1. 选择 `POST` 并选中复选框。 +1. 选择 **Lambda Function** 作为集成类型，然后选择启动 CloudFormation 堆栈时所在的区域作为 Lambda 区域。 +1. 在 **Lambda Function** 中，键入 **`NotesApiFunction`**，然后选择 CloudFormation 堆栈创建的函数。 +1. 选择 **Save**，并授予 API Gateway 权限以执行 Lambda 函数。 +1. 选择 **Method Request** 以编辑请求配置。 +1. 对于 **Authorization type**，选择 `AWS_IAM`。 +1. 对于 **API Key Required**，选择 `true`。 +1. 选择 **Deploy API**。 +1. 对于 **Deployment stage**，选择 `New Stage`，然后在 **Stage name** 中键入名称。 +1. 记下新阶段的 **Invoke URL**。运行示例 iOS 应用程序时，您将使用此值。 #### 步骤 6：创建 API 密钥 -1.在 [Amazon API Gateway 控制台](https://console.aws.amazon.com/apigateway/home?region=us-east-1#/apis) 中选择 **APIs**，然后选择 **API Keys**。 -1.选择 **Create API Key**。 -1.为密钥键入名称，然后选择 **Enabled**。 -1.选择 **Save** -1.在 **API Stage Association** 部分中，选择您的 API，然后选择您在上一步中创建的阶段。 -1.选择 **Add**。 -1.记下 **API key**。运行移动应用程序时，您将使用此信息。 +1. 在 [Amazon API Gateway 控制台](https://console.aws.amazon.com/apigateway/home?region=us-east-1#/apis) 中选择 **APIs**，然后选择 **API Keys**。 +1. 选择 **Create API Key**。 +1. 为密钥键入名称，然后选择 **Enabled**。 +1. 选择 **Save** +1. 在 **API Stage Association** 部分中，选择您的 API，然后选择您在上一步中创建的阶段。 +1. 选择 **Add**。 +1. 记下 **API key**。运行移动应用程序时，您将使用此信息。 #### 步骤 7：更新您的 Amazon Cognito 身份池 -1.在 [Amazon Cognito 控制台](https://console.aws.amazon.com/cognito/home?region=us-east-1) 中，选择您的身份池。 -1.选择 **Edit Identity Pool**。 -1.对于 **Unauthenticated role** 和 **Authenticated role**，选择 CloudFormation 堆栈创建的 **MobileClientRole**。堆栈输出中提供角色的完整 ARN。 -1.选择 **Save Changes**。 +1. 在 [Amazon Cognito 控制台](https://console.aws.amazon.com/cognito/home?region=us-east-1) 中，选择您的身份池。 +1. 选择 **Edit Identity Pool**。 +1. 对于 **Unauthenticated role** 和 **Authenticated role**，选择 CloudFormation 堆栈创建的 **MobileClientRole**。堆栈输出中提供角色的完整 ARN。 +1. 选择 **Save Changes**。 ### 运行示例 iOS 应用程序 @@ -111,21 +111,21 @@ #### 构建和运行应用程序 -1.签出或下载此存储库中的 **ios-sample** 源代码。 -1.使用后端部署的值更新 `MobileBackendIOS/Constants.swift`。在 CloudFormation 堆栈输出中可以找到大多数值。在 AWS 管理控制台中，可以在 API 详细信息中找到 API Gateway 密钥和终端节点 URL 值。 -1.从 `ios-sample` 根目录运行 Cocoa Pods。 +1. 签出或下载此存储库中的 **ios-sample** 源代码。 +1. 使用后端部署的值更新 `MobileBackendIOS/Constants.swift`。在 CloudFormation 堆栈输出中可以找到大多数值。在 AWS 管理控制台中，可以在 API 详细信息中找到 API Gateway 密钥和终端节点 URL 值。 +1. 从 `ios-sample` 根目录运行 Cocoa Pods。 ``` pod install ``` -1.在 Xcode 中打开生成的 `MobileBackendIOS.xcworkspace` 文件。 +1. 在 Xcode 中打开生成的 `MobileBackendIOS.xcworkspace` 文件。 ``` open -a Xcode MobileBackendIOS.xcworkspace ``` -1.通过单击窗口顶部的播放按钮，从 Xcode 构建并运行项目。 +1. 通过单击窗口顶部的播放按钮，从 Xcode 构建并运行项目。 ## 测试应用程序 @@ -133,9 +133,9 @@ ### 上传图像 -1.在应用程序中，选择 **Upload Image**。 -1.选择相机图标，从相册中选择图像，然后选择 **Choose**。 -1.选择 **Upload** 按钮。 +1. 在应用程序中，选择 **Upload Image**。 +1. 选择相机图标，从相册中选择图像，然后选择 **Choose**。 +1. 选择 **Upload** 按钮。 #### 验证是否已上传图像 @@ -145,9 +145,9 @@ ### 发布备注 -1.选择 **Post a Note**。 -1.在备注中键入标题和文本。 -1.选择 **Save Note**。 +1. 选择 **Post a Note**。 +1. 在备注中键入标题和文本。 +1. 选择 **Save Note**。 #### 验证是否已发布备注 @@ -164,10 +164,10 @@ 要删除此示例创建的所有资源，请执行以下操作： -1.删除 CloudFormation 堆栈创建的 S3 存储桶中的所有对象。 -1.删除 CloudFormation 堆栈。 -1.删除 Amazon Cognito 身份池、API Gateway 和 CloudSearch 域。 -1.删除与 CloudFormation 堆栈创建的每个 Lambda 函数关联的 CloudWatch 日志组。 +1. 删除 CloudFormation 堆栈创建的 S3 存储桶中的所有对象。 +1. 删除 CloudFormation 堆栈。 +1. 删除 Amazon Cognito 身份池、API Gateway 和 CloudSearch 域。 +1. 删除与 CloudFormation 堆栈创建的每个 Lambda 函数关联的 CloudWatch 日志组。 ## CloudFormation 模板资源 diff --git a/README/README-JP.md b/README/README-JP.md index 67b3b86..8174c95 100644 --- a/README/README-JP.md +++ b/README/README-JP.md @@ -14,15 +14,15 @@ #### ステップ 1: CloudSearch ドメインを作成する -1.[AWS CLI](https://aws.amazon.com/cli/) を使用して、任意のドメイン名を提供する新しい CloudSearch ドメインを作成します。 +1. [AWS CLI](https://aws.amazon.com/cli/) を使用して、任意のドメイン名を提供する新しい CloudSearch ドメインを作成します。 ``` aws cloudsearch create-domain --domain-name [ドメイン名] ``` -1.出力ドキュメントの新しいドメインの ARN をメモしておきます。CloudFormation スタックを起動するときに、これを入力として使用します。 +1. 出力ドキュメントの新しいドメインの ARN をメモしておきます。CloudFormation スタックを起動するときに、これを入力として使用します。 -1.`headline` および `note_text` フィールドのインデックスを定義します。 +1. `headline` および `note_text` フィールドのインデックスを定義します。 ``` aws cloudsearch define-index-field --name headline --type text --domain-name [ドメイン名] @@ -35,23 +35,23 @@ #### ステップ 2: API Gateway REST API を作成する -1.[AWS CLI](https://aws.amazon.com/cli/) を使用し、任意の名前を指定して新しい API を作成します。 +1. [AWS CLI](https://aws.amazon.com/cli/) を使用し、任意の名前を指定して新しい API を作成します。 ``` aws apigateway create-rest-api --name [API 名] ``` -1.出力ドキュメントの `API ID` をメモしておきます。CloudFormation スタックを起動するときに、これを入力として使用します。 +1. 出力ドキュメントの `API ID` をメモしておきます。CloudFormation スタックを起動するときに、これを入力として使用します。 #### ステップ 3: Amazon Cognito ID プールを作成する -1.[AWS CLI](https://aws.amazon.com/cli/) を使用し、任意の名前を指定して新しい ID プールを作成します。 +1. [AWS CLI](https://aws.amazon.com/cli/) を使用し、任意の名前を指定して新しい ID プールを作成します。 ``` aws cognito-identity create-identity-pool --allow-unauthenticated-identities --identity-pool-name [プール名] ``` -1.出力ドキュメントの `IdentityPoolId` をメモしておきます。CloudFormation スタックを起動するときに、これをパラメーターとして使用します。 +1. 出力ドキュメントの `IdentityPoolId` をメモしておきます。CloudFormation スタックを起動するときに、これをパラメーターとして使用します。 #### ステップ 4: CloudFormation テンプレートを起動する @@ -69,38 +69,38 @@ CloudFormation スタックを作成した後で、新しく作成された `NotesApiFunction` を使用するには、前に作成した API を更新する必要があります。 -1.[Amazon API Gateway Console](https://console.aws.amazon.com/apigateway/home?region=us-east-1#/apis) で、API を選択します。 -1.[**Create Resource**] を選択し、/ 以下に新しい子リソースを作成します。 -1.リソース名として「notes」、リソースパスとして「/notes」と入力します。 -1.[**Create Resource**] を選択します。 -1.新しい `/notes` リソースを選択して、[**Create Method**] を選択します。 -1.[`POST`] を選択し、チェックボックスをオンにします。 -1.統合タイプとして [**Lambda Function**] を選択し、Lambda リージョンとして CloudFormation スタックを起動したリージョンを選択します。 -1.[**Lambda Function**] に「**`NotesApiFunction`**」と入力し、CloudFormation スタックで作成した関数を選択します。 -1.[**Save**] を選択し、Lambda 関数を実行するための API Gateway アクセス権限を付与します。 -1.[**Method Request**] を選択してリクエスト設定を編集します。 -1.[**Authorization type**] で、[`AWS_IAM`] を選択します。 -1.[ **API Key Required**] で、[`true`] を選択します。 -1.[**Deploy API**] を選択します。 -1.[ **Deployment stage**] で、[`New Stage`] を選択し、[**Stage name**] に名前を入力します。 -1.新しいステージの [**Invoke URL**] をメモしておきます。iOS サンプルアプリを実行するときに、この値を使用します。 +1. [Amazon API Gateway Console](https://console.aws.amazon.com/apigateway/home?region=us-east-1#/apis) で、API を選択します。 +1. [**Create Resource**] を選択し、/ 以下に新しい子リソースを作成します。 +1. リソース名として「notes」、リソースパスとして「/notes」と入力します。 +1. [**Create Resource**] を選択します。 +1. 新しい `/notes` リソースを選択して、[**Create Method**] を選択します。 +1. [`POST`] を選択し、チェックボックスをオンにします。 +1. 統合タイプとして [**Lambda Function**] を選択し、Lambda リージョンとして CloudFormation スタックを起動したリージョンを選択します。 +1. [**Lambda Function**] に「**`NotesApiFunction`**」と入力し、CloudFormation スタックで作成した関数を選択します。 +1. [**Save**] を選択し、Lambda 関数を実行するための API Gateway アクセス権限を付与します。 +1. [**Method Request**] を選択してリクエスト設定を編集します。 +1. [**Authorization type**] で、[`AWS_IAM`] を選択します。 +1. [ **API Key Required**] で、[`true`] を選択します。 +1. [**Deploy API**] を選択します。 +1. [ **Deployment stage**] で、[`New Stage`] を選択し、[**Stage name**] に名前を入力します。 +1. 新しいステージの [**Invoke URL**] をメモしておきます。iOS サンプルアプリを実行するときに、この値を使用します。 #### ステップ 6: API キーを作成する -1.[Amazon API Gateway Console](https://console.aws.amazon.com/apigateway/home?region=us-east-1#/apis) で、[**APIs**] を選択し、[**API Keys**] を選択します。 -1.[**Create API Key**] を選択します。 -1.キーの名前を入力し、[**Enabled**] を選択します。 -1.[**Save**] を選択します。 -1.[**API Stage Association**] セクションで API を選択し、前のステップで作成したステージを選択します。 -1.[**Add**] を選択します。 -1.[**API key**] をメモしておきます。モバイルアプリケーションを実行するときに、これを使用します。 +1. [Amazon API Gateway Console](https://console.aws.amazon.com/apigateway/home?region=us-east-1#/apis) で、[**APIs**] を選択し、[**API Keys**] を選択します。 +1. [**Create API Key**] を選択します。 +1. キーの名前を入力し、[**Enabled**] を選択します。 +1. [**Save**] を選択します。 +1. [**API Stage Association**] セクションで API を選択し、前のステップで作成したステージを選択します。 +1. [**Add**] を選択します。 +1. [**API key**] をメモしておきます。モバイルアプリケーションを実行するときに、これを使用します。 #### ステップ 7: Amazon Cognito ID プールを更新する -1.[Amazon Cognito コンソール](https://console.aws.amazon.com/cognito/home?region=us-east-1) で、ID プールを選択します。 -1.[**Edit Identity Pool**] を選択します。 -1.[**Unauthenticated role**] および [**Authenticated role**] の両方について、CloudFormation スタックで作成された [**MobileClientRole**] を選択します。ロールの完全な ARN は、スタックの出力に含まれます。 -1.[**Save Changes**] を選択します。 +1. [Amazon Cognito コンソール](https://console.aws.amazon.com/cognito/home?region=us-east-1) で、ID プールを選択します。 +1. [**Edit Identity Pool**] を選択します。 +1. [**Unauthenticated role**] および [**Authenticated role**] の両方について、CloudFormation スタックで作成された [**MobileClientRole**] を選択します。ロールの完全な ARN は、スタックの出力に含まれます。 +1. [**Save Changes**] を選択します。 ### iOS サンプルアプリケーションの実行 @@ -111,21 +111,21 @@ CloudFormation スタックを作成した後で、新しく作成された `Not #### アプリケーションの構築と実行 -1.このレポジトリの **ios-sample** のソースコードをチェックアウトまたはダウンロードします。 -1.バックエンドデプロイの値で `MobileBackendIOS/Constants.swift` を更新します。ほとんどの値は、CloudFormation スタックの出力に含まれています。API Gateway キーおよびエンドポイント URL の値は、AWS マネジメントコンソールの API の詳細で確認できます。 -1.ルートの `ios-sample` ディレクトリから Cocoa Pods を実行します。 +1. このレポジトリの **ios-sample** のソースコードをチェックアウトまたはダウンロードします。 +1. バックエンドデプロイの値で `MobileBackendIOS/Constants.swift` を更新します。ほとんどの値は、CloudFormation スタックの出力に含まれています。API Gateway キーおよびエンドポイント URL の値は、AWS マネジメントコンソールの API の詳細で確認できます。 +1. ルートの `ios-sample` ディレクトリから Cocoa Pods を実行します。 ``` pod install ``` -1.Xcode で、生成された `MobileBackendIOS.xcworkspace` ファイルを開きます。 +1. Xcode で、生成された `MobileBackendIOS.xcworkspace` ファイルを開きます。 ``` Xcode MobileBackendIOS.xcworkspace を開きます。 ``` -1.ウィンドウの上部にある再生ボタンをクリックして、Xcode からプロジェクトを構築および実行します。 +1. ウィンドウの上部にある再生ボタンをクリックして、Xcode からプロジェクトを構築および実行します。 ## アプリケーションのテスト @@ -133,9 +133,9 @@ CloudFormation スタックを作成した後で、新しく作成された `Not ### 画像をアップロードするには -1.アプリケーションの [**Upload Image**] を選択します。 -1.カメラアイコンを選択し、カメラロールから画像を選択して、[**Choose**] を選択します。 -1.[**Upload**] ボタンを選択します。 +1. アプリケーションの [**Upload Image**] を選択します。 +1. カメラアイコンを選択し、カメラロールから画像を選択して、[**Choose**] を選択します。 +1. [**Upload**] ボタンを選択します。 #### 画像がアップロードされたことの確認 @@ -145,9 +145,9 @@ AWS マネジメントコンソールを使用して CloudFormation スタック ### メモを投稿するには -1.[**Post a Note**] を選択します。 -1.メモに見出しとテキストを入力します。 -1.[**Save Note**] を選択します。 +1. [**Post a Note**] を選択します。 +1. メモに見出しとテキストを入力します。 +1. [**Save Note**] を選択します。 #### メモが投稿されたことの確認 @@ -164,10 +164,10 @@ AWS マネジメントコンソールを使用して CloudFormation スタック この例で作成されたすべてのリソースを削除するには、次の操作を行います。 -1.CloudFormation スタックによって作成された S3 バケットからすべてのオブジェクトを削除します。 -1.CloudFormation スタックを削除します。 -1.Amazon Cognito ID プール、API Gateway、および CloudSearch ドメインを削除します。 -1.CloudFormation スタックによって作成された各 Lambda 関数と関連付けられた CloudWatch ロググループを削除します。 +1. CloudFormation スタックによって作成された S3 バケットからすべてのオブジェクトを削除します。 +1. CloudFormation スタックを削除します。 +1. Amazon Cognito ID プール、API Gateway、および CloudSearch ドメインを削除します。 +1. CloudFormation スタックによって作成された各 Lambda 関数と関連付けられた CloudWatch ロググループを削除します。 ## CloudFormation テンプレートのリソース diff --git a/README/README-TW.md b/README/README-TW.md index 4112699..3047ed4 100644 --- a/README/README-TW.md +++ b/README/README-TW.md @@ -14,15 +14,15 @@ #### 步驟 1：建立 CloudSearch 網域 -1.使用 [AWS CLI](https://aws.amazon.com/cli/) 建立新的 CloudSearch 網域並提供您選擇的網域名稱。 +1. 使用 [AWS CLI](https://aws.amazon.com/cli/) 建立新的 CloudSearch 網域並提供您選擇的網域名稱。 ``` aws cloudsearch create-domain --domain-name [YOUR_DOMAIN_NAME] ``` -1.請記下輸出文件中的新網域的 ARN，您將在啟動 CloudFormation 堆疊時使用它做為輸入。 +1. 請記下輸出文件中的新網域的 ARN，您將在啟動 CloudFormation 堆疊時使用它做為輸入。 -1.定義「headline」與「note_text」欄位的索引。 +1. 定義「headline」與「note_text」欄位的索引。 ``` aws cloudsearch define-index-field --name headline --type text --domain-name [YOUR_DOMAIN_NAME] @@ -35,23 +35,23 @@ #### 步驟 2：建立 API Gateway REST API -1.使用 [AWS CLI](https://aws.amazon.com/cli/) 建立新的 API 並提供您選擇的名稱。 +1. 使用 [AWS CLI](https://aws.amazon.com/cli/) 建立新的 API 並提供您選擇的名稱。 ``` aws apigateway create-rest-api --name [YOUR_API_NAME] ``` -1.請記下輸出文件中提供的「API ID」，您將在啟動 CloudFormation 堆疊時使用它做為輸入。 +1. 請記下輸出文件中提供的「API ID」，您將在啟動 CloudFormation 堆疊時使用它做為輸入。 #### 步驟 3：建立 Amazon Cognito Identity Pool -1.使用 [AWS CLI](https://aws.amazon.com/cli/) 建立新的 Identity Pool 並提供您選擇的名稱。 +1. 使用 [AWS CLI](https://aws.amazon.com/cli/) 建立新的 Identity Pool 並提供您選擇的名稱。 ``` aws cognito-identity create-identity-pool --allow-unauthenticated-identities --identity-pool-name [YOUR_POOL_NAME] ``` -1.請記下輸出文件中提供的「IdentityPoolId」，您將在啟動 CloudFormation 堆疊時使用它做為參數。 +1. 請記下輸出文件中提供的「IdentityPoolId」，您將在啟動 CloudFormation 堆疊時使用它做為參數。 #### 步驟 4：啟動 CloudFormation 範本 @@ -69,38 +69,38 @@ 在您建立 CloudFormation 堆疊之後，您必須更新先前建立的 API，才能使用新建立的「NotesApiFunction」。 -1.在 [Amazon API Gateway Console](https://console.aws.amazon.com/apigateway/home?region=us-east-1#/apis) 中選擇您的 API。 -1.選擇 **Create Resource** 在 / 之下建立新的子資源。 -1.輸入「notes」做為此資源的名稱，輸入「/notes」做為此資源的路徑。 -1.選擇 **Create Resource**。 -1.在已選取新的「/notes」資源的情況下，選擇 **建立方法**。 -1.選擇「POST」，然後選擇該核取方塊。 -1.選擇 **Lambda 功能** 做為整合類型，然後選擇您啟動 CloudFormation 堆疊的區域做為 Lambda 區域。 -1.在 **Lambda 功能** 中輸入 **`NotesApiFunction`**，然後選擇 CloudFormation 堆疊建立的功能。 -1.選擇 **儲存** 並授與 API Gateway 執行 Lambda 功能的許可。 -1.選擇 **方法請求** 以編輯請求組態。 -1.在 **授權類型** 項目中選擇「AWS_IAM」。 -1.在 **需要 API 金鑰** 項目中選擇「true」。 -1.選擇 **部署 API**。 -1.在 **部署階段** 項目中選擇「新階段」，然後在 **階段名稱** 中輸入一個名稱。 -1.請記下新階段的 **呼叫 URL**，您將在執行範例 iOS 應用程式時使用此數值。 +1. 在 [Amazon API Gateway Console](https://console.aws.amazon.com/apigateway/home?region=us-east-1#/apis) 中選擇您的 API。 +1. 選擇 **Create Resource** 在 / 之下建立新的子資源。 +1. 輸入「notes」做為此資源的名稱，輸入「/notes」做為此資源的路徑。 +1. 選擇 **Create Resource**。 +1. 在已選取新的「/notes」資源的情況下，選擇 **建立方法**。 +1. 選擇「POST」，然後選擇該核取方塊。 +1. 選擇 **Lambda 功能** 做為整合類型，然後選擇您啟動 CloudFormation 堆疊的區域做為 Lambda 區域。 +1. 在 **Lambda 功能** 中輸入 **`NotesApiFunction`**，然後選擇 CloudFormation 堆疊建立的功能。 +1. 選擇 **儲存** 並授與 API Gateway 執行 Lambda 功能的許可。 +1. 選擇 **方法請求** 以編輯請求組態。 +1. 在 **授權類型** 項目中選擇「AWS_IAM」。 +1. 在 **需要 API 金鑰** 項目中選擇「true」。 +1. 選擇 **部署 API**。 +1. 在 **部署階段** 項目中選擇「新階段」，然後在 **階段名稱** 中輸入一個名稱。 +1. 請記下新階段的 **呼叫 URL**，您將在執行範例 iOS 應用程式時使用此數值。 #### 步驟 6：建立 API 金鑰 -1.在 [Amazon API Gateway Console](https://console.aws.amazon.com/apigateway/home?region=us-east-1#/apis) 中選擇 **APIs**，然後選擇 **API 金鑰**。 -1.選擇 **建立 API 金鑰**。 -1.輸入金鑰的名稱，然後選擇 **已啟用**。 -1.選擇 **儲存** -1.在 **API 階段關聯** 區段中，選擇您的 API，然後選擇您在先前的步驟中建立的階段。 -1.選擇 **新增**。 -1.請記下 **API 金鑰**，您將在執行行動應用程式時使用它。 +1. 在 [Amazon API Gateway Console](https://console.aws.amazon.com/apigateway/home?region=us-east-1#/apis) 中選擇 **APIs**，然後選擇 **API 金鑰**。 +1. 選擇 **建立 API 金鑰**。 +1. 輸入金鑰的名稱，然後選擇 **已啟用**。 +1. 選擇 **儲存** +1. 在 **API 階段關聯** 區段中，選擇您的 API，然後選擇您在先前的步驟中建立的階段。 +1. 選擇 **新增**。 +1. 請記下 **API 金鑰**，您將在執行行動應用程式時使用它。 #### 步驟 7：更新您的 Amazon Cognito Identity Pool -1.在 [Amazon Cognito Console](https://console.aws.amazon.com/cognito/home?region=us-east-1) 中選擇您的 Identity Pool。 -1.選擇 **編輯 Identity Pool**。 -1.在 **未授權的角色** 與 **已授權的角色** 項目中選擇由 CloudFormation 堆疊建立的 **MobileClientRole**。堆疊的輸出中有提供該角色的完整 ARN。 -1.選擇 **儲存變更**。 +1. 在 [Amazon Cognito Console](https://console.aws.amazon.com/cognito/home?region=us-east-1) 中選擇您的 Identity Pool。 +1. 選擇 **編輯 Identity Pool**。 +1. 在 **未授權的角色** 與 **已授權的角色** 項目中選擇由 CloudFormation 堆疊建立的 **MobileClientRole**。堆疊的輸出中有提供該角色的完整 ARN。 +1. 選擇 **儲存變更**。 ### 執行範例 iOS 應用程式 @@ -111,21 +111,21 @@ #### 建立與執行應用程式 -1.查看或下載儲存庫中的 **ios-sample** 的原始碼。 -1.使用您的後端部署的數值更新「MobileBackendIOS/Constants.swift」。大多數的數值皆可在 CloudFormation 堆疊的輸出中找到。在 AWS 管理主控台中的您的 API 詳細資訊中，可找到 API Gateway 金鑰與終端節點 URL 數值。 -1.從「ios-sample」根目錄執行 Cocoa Pods。 +1. 查看或下載儲存庫中的 **ios-sample** 的原始碼。 +1. 使用您的後端部署的數值更新「MobileBackendIOS/Constants.swift」。大多數的數值皆可在 CloudFormation 堆疊的輸出中找到。在 AWS 管理主控台中的您的 API 詳細資訊中，可找到 API Gateway 金鑰與終端節點 URL 數值。 +1. 從「ios-sample」根目錄執行 Cocoa Pods。 ``` pod install ``` -1.在 Xcode 中開啟所產生的「MobileBackendIOS.xcworkspace」檔案。 +1. 在 Xcode 中開啟所產生的「MobileBackendIOS.xcworkspace」檔案。 ``` open -a Xcode MobileBackendIOS.xcworkspace ``` -1.按一下 Xcode 視窗最上方的播放按鈕以建立並執行專案。 +1. 按一下 Xcode 視窗最上方的播放按鈕以建立並執行專案。 ## 測試應用程式 @@ -133,9 +133,9 @@ ### 上傳圖片 -1.在應用程式中選擇 **上傳圖片**。 -1.選擇相機圖示，從相簿中選擇一張圖片後選擇 **選擇**。 -1.選擇 **上傳** 按鈕。 +1. 在應用程式中選擇 **上傳圖片**。 +1. 選擇相機圖示，從相簿中選擇一張圖片後選擇 **選擇**。 +1. 選擇 **上傳** 按鈕。 #### 驗證圖片是否已經上傳 @@ -145,9 +145,9 @@ ### 張貼筆記 -1.選擇 **張貼筆記**。 -1.在筆記中輸入標題與文字。 -1.選擇 **儲存筆記**。 +1. 選擇 **張貼筆記**。 +1. 在筆記中輸入標題與文字。 +1. 選擇 **儲存筆記**。 #### 驗證筆記是否已經張貼 @@ -164,10 +164,10 @@ 若要移除此範例建立的所有資源，請執行以下動作： -1.刪除 CloudFormation 堆疊建立的 S3 儲存貯體中的所有物件。 -1.刪除 CloudFormation 堆疊。 -1.刪除 Amazon Cognito Identity Pool、API Gateway 及 CloudSearch 網域。 -1.刪除與 CloudFormation 堆疊所建立的 Lambda 功能相關聯的 CloudWatch 記錄群組。 +1. 刪除 CloudFormation 堆疊建立的 S3 儲存貯體中的所有物件。 +1. 刪除 CloudFormation 堆疊。 +1. 刪除 Amazon Cognito Identity Pool、API Gateway 及 CloudSearch 網域。 +1. 刪除與 CloudFormation 堆疊所建立的 Lambda 功能相關聯的 CloudWatch 記錄群組。 ## CloudFormation 範本資源