本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
AW-每個人的-數據
所有類都在積極開發中,並且在任何未來版本中都會受到非向後兼容的更改或刪除。這些不受語義版本
請注意: 為了確保功能正確,專案中的 AWS 解決方案建構套件和 AWS CDK 套件必須是相同的版本。
| 語言 | 套件 |
|---|---|
|
aws_solutions_constructs.aws_apigateway_sqs
|
|
@aws-solutions-constructs/aws-apigateway-sqs
|
|
software.amazon.awsconstructs.services.apigatewaysqs
|
Overview
此 AWS 解決方案建構實作連接到 Amazon SQS 佇列的 Amazon API 閘道 REST API。
下面是 TypeScript 中的最小可部署模式定義:
import { ApiGatewayToSqs, ApiGatewayToSqsProps } from "@aws-solutions-constructs/aws-apigateway-sqs"; new ApiGatewayToSqs(this, 'ApiGatewayToSqsPattern', {});
Initializer
new ApiGatewayToSqs(scope: Construct, id: string, props: ApiGatewayToSqsProps);
參數
-
scope
Construct -
id
string
模式建立道具
| 名稱 | 類型 | 描述 |
|---|---|---|
| 阿比格特威道具? |
api.RestApiProps
|
可選的使用者提供的道具來覆寫 API Gateway 的預設道具。 |
| 佇列道具? |
sqs.QueueProps
|
可選的使用者提供的道具來覆寫佇列的預設道具。 |
| 部署死亡佇列? |
boolean
|
是否部署輔助佇列做為無效字母佇列。預設為 true。 |
| maxReceiveCount |
number
|
訊息移到無效字母佇列之前,需交付到無效字母佇列的次數。 |
| 是否允許作業? |
boolean
|
是否部署在隊列上創建操作的 API Gateway 方法(即 SQL:發送消息)。 |
| 建立請求範本? |
string
|
覆寫建立方法的預設 API Gateway 要求範本,如果allowCreateOperation已設定為true。 |
| 允許操作? |
boolean
|
是否部署在隊列上讀取操作的 API Gateway 方法(即 SQL:接收消息)。 |
| 讀取要求樣板? |
string
|
覆寫讀取方法的預設 API Gateway 要求範本,如果allowReadOperation已設定為true。 |
| 是否允許刪除作業? |
boolean
|
是否部署在隊列上刪除操作的 API Gateway 方法(即 SQL:刪除)。 |
| 刪除請求範本? |
string
|
覆寫刪除方法的預設 API Gateway 要求範本,如果allowDeleteOperation已設定為true。 |
| 記錄群組道具? |
logs.LogGroupProps
|
可選的使用者提供的道具,用於覆寫 CloudWatch Logs 日誌群組的預設道具。 |
模式性質
| 名稱 | 類型 | 描述 |
|---|---|---|
| AigGateway |
api.RestApi
|
返回由模式創建的 API Gateway REST API 的實例。 |
| 雲端觀察角色 |
iam.Role
|
傳回模式所建立的 IAM 角色執行個體,該模式可啟用從 API Gateway REST API 存取記錄至 CloudWatch。 |
| 應用路徑記錄群組 |
logs.LogGroup
|
傳回傳送 API Gateway REST API 存取記錄檔的模式所建立之記錄群組的執行個體。 |
| 應用方式角色 |
iam.Role
|
傳回由 API Gateway REST API 模式所建立的 IAM 角色執行個體。 |
| 死機隊列? |
sqs.Queue
|
返回由模式創建的死信隊列的實例,如果一個被部署。 |
| 平方 |
sqs.Queue
|
返回由模式創建的 SQS 隊列的實例。 |
範例 API 使用
| 方法 | 請求路徑。 | 請求內文 | 佇列動作 | 描述 |
|---|---|---|---|---|
| GET |
/
|
sqs::ReceiveMessage
|
從佇列擷取訊息。 | |
| POST |
/
|
{ "data": "Hello World!" }
|
sqs::SendMessage
|
將訊息傳遞到佇列。 |
| DELETE |
/message?receiptHandle=[value]
|
sqs::DeleteMessage
|
從佇列刪除指定的訊息 |
預設設定
此模式的開箱即用實現沒有任何覆蓋將設置以下默認值:
Amazon API Gateway
-
部署邊緣最佳化的 API 端點
-
為 API Gateway 啟用 CloudWatch 日誌
-
設定 API Gateway 的最低權限存取 IAM 角色
-
將所有 API 方法的預設授權類型設定為 IAM
-
啟用 X-Ray 追蹤
Amazon SQS 佇列
-
為來源 SQS 佇列建立 SQS 無效字母佇列
-
使用 AWS 受管 KMS Key 為來源 SQS 佇列啟用伺服器端加密
-
強制加密傳輸中的資料
Architecture
GitHub
| 要查看此模式的代碼,創建/查看問題和提取請求,以及更多: | |
|---|---|
|
@aws-解決方案-構造/操作-應用程序 |