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

# RemoteWrite
<a name="AMP-APIReference-RemoteWrite"></a>

`RemoteWrite` 作業會使用標準化格式將指標自 Prometheus 伺服器寫入遠端 URL。通常，您將使用現有的用戶端 (例如 Prometheus 伺服器) 來呼叫此作業。

有效的 HTTP 動詞：  
`POST`

有效 URI：  
`/workspaces/workspaceId/api/v1/remote_write`

URL 查詢參數：  
無

`RemoteWrite` 擷取速率為每秒 70,000 個樣本，擷取突發大小為 1,000,000 個樣本。

**請求範例**

```
POST /workspaces/ws-b226cc2a-a446-46a9-933a-ac50479a5568/api/v1/remote_write --data-binary "@real-dataset.sz" HTTP/1.1
Authorization: AUTHPARAMS
X-Amz-Date: 20201201T193725Z
User-Agent: Prometheus/2.20.1
Content-Type: application/x-protobuf
Content-Encoding: snappy
X-Prometheus-Remote-Write-Version: 0.1.0

body
```

**注意**  
有關請求主體語法，請參閱 [https://github.com/prometheus/prometheus/blob/1c624c58ca934f618be737b4995e22051f5724c1/prompb/remote.pb.go\$1L64](https://github.com/prometheus/prometheus/blob/1c624c58ca934f618be737b4995e22051f5724c1/prompb/remote.pb.go#L64) 的協議緩衝區定義。

**回應範例**

```
HTTP/1.1 200 OK
x-amzn-RequestId: 12345678-abcd-4442-b8c5-262b45e9b535
Content-Length:0
Connection: keep-alive
Date: Tue, 01 Dec 2020 19:37:25 GMT
Content-Type: application/json
Server: amazon
vary: Origin
```