文件 AWS 開發套件範例 GitHub 儲存庫中有更多可用的 [AWS SDK 範例](https://github.com/awsdocs/aws-doc-sdk-examples)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 AWS SDKs API Gateway Management API 程式碼範例
<a name="apigatewaymanagementapi_code_examples"></a>

下列程式碼範例示範如何使用 Amazon API Gateway Management API 搭配 AWS 軟體開發套件 (SDK)。

*Actions* 是大型程式的程式碼摘錄，必須在內容中執行。雖然動作會告訴您如何呼叫個別服務函數，但您可以在其相關情境中查看內容中的動作。

**其他資源**
+  **[ API Gateway Management API 開發人員指南](https://docs.aws.amazon.com/apigateway/latest/developerguide/welcome.html)** – API Gateway Management API 的相關詳細資訊。
+ **[API Gateway Management API 參考](https://docs.aws.amazon.com/apigateway/latest/api/API_Operations.html)** – 所有可用 API Gateway Management API 動作的詳細資訊。
+ **[AWS 開發人員中心](https://aws.amazon.com/developer/code-examples/?awsf.sdk-code-examples-product=product%23api-gateway)** – 您可以依類別或全文搜尋篩選的程式碼範例。
+ **[AWS SDK 範例](https://github.com/awsdocs/aws-doc-sdk-examples)** – GitHub 儲存庫使用慣用語言的完整程式碼。包含設定和執行程式碼的指示。

**Contents**
+ [基本概念](apigatewaymanagementapi_code_examples_basics.md)
  + [動作](apigatewaymanagementapi_code_examples_actions.md)
    + [`PostToConnection`](apigatewaymanagementapi_example_apigatewaymanagementapi_PostToConnection_section.md)

# API Gateway Management API AWS SDKs的基本範例
<a name="apigatewaymanagementapi_code_examples_basics"></a>

下列程式碼範例示範如何搭配使用 Amazon API Gateway Management API 的基本功能與 AWS SDK。

**Contents**
+ [動作](apigatewaymanagementapi_code_examples_actions.md)
  + [`PostToConnection`](apigatewaymanagementapi_example_apigatewaymanagementapi_PostToConnection_section.md)

# 使用 AWS SDKs的 API Gateway Management API 動作
<a name="apigatewaymanagementapi_code_examples_actions"></a>

下列程式碼範例示範如何使用 AWS SDKs 執行個別 API Gateway Management API 動作。每個範例均包含 GitHub 的連結，您可以在連結中找到設定和執行程式碼的相關說明。

 下列範例僅包含最常使用的動作。如需完整清單，請參閱 [Amazon API Gateway Management API API 參考](https://docs.aws.amazon.com/apigateway/latest/api/API_Operations.html)。

**Topics**
+ [`PostToConnection`](apigatewaymanagementapi_example_apigatewaymanagementapi_PostToConnection_section.md)

# `PostToConnection` 搭配 AWS SDK 或 CLI 使用
<a name="apigatewaymanagementapi_example_apigatewaymanagementapi_PostToConnection_section"></a>

下列程式碼範例示範如何使用 `PostToConnection`。

------
#### [ CLI ]

**AWS CLI**  
**將資料傳送至 WebSocket 連線**  
下列 `post-to-connection` 範例會將訊息傳送至與指定 WebSocket API 連線的用戶端。  

```
aws apigatewaymanagementapi post-to-connection \
    --connection-id L0SM9cOFvHcCIhw= \
    --data "Hello from API Gateway!" \
    --endpoint-url https://aabbccddee.execute-api.us-west-2.amazonaws.com/prod
```
此命令不會產生輸出。  
如需詳細資訊，請參閱《*Amazon API Gateway 開發人員指南*》中的[在後端服務中使用 @connections 命令](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-how-to-call-websocket-api-connections.html)。  
+  如需 API 詳細資訊，請參閱《*AWS CLI 命令參考*》中的 [PostToConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewaymanagementapi/post-to-connection.html)。

------
#### [ Rust ]

**適用於 Rust 的 SDK**  
 GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/rustv1/examples/apigatewaymanagement#code-examples)中設定和執行。

```
async fn send_data(
    client: &aws_sdk_apigatewaymanagement::Client,
    con_id: &str,
    data: &str,
) -> Result<(), aws_sdk_apigatewaymanagement::Error> {
    client
        .post_to_connection()
        .connection_id(con_id)
        .data(Blob::new(data))
        .send()
        .await?;

    Ok(())
}

    let endpoint_url = format!(
        "https://{api_id}.execute-api.{region}.amazonaws.com/{stage}",
        api_id = api_id,
        region = region,
        stage = stage
    );

    let shared_config = aws_config::from_env().region(region_provider).load().await;
    let api_management_config = config::Builder::from(&shared_config)
        .endpoint_url(endpoint_url)
        .build();
    let client = Client::from_conf(api_management_config);
```
+  如需 API 詳細資訊，請參閱《AWS  SDK for Rust API 參考》**中的 [PostToConnection](https://docs.rs/aws-sdk-apigatewaymanagementapi/latest/aws_sdk_apigatewaymanagementapi/client/struct.Client.html#method.post_to_connection)。

------