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

# 使用 Neptune-Export API 執行 Neptune-Export 工作
<a name="export-service-run-export"></a>

 CloudFormation 堆疊的**輸出**索引標籤也包含 `NeptuneExportApiUri`。每當您將請求傳送到 Neptune-Export 端點時，請使用此 URI。

**執行匯出工作**
+ 請確定匯出執行所在的使用者或角色已獲授與 `execute-api:Invoke` 許可。
+ 如果在安裝 Neptune-Export 時，於 CloudFormation 堆疊中將 `EnableIAM` 參數設為 `true`，則您需要以 `Sigv4` 簽署對 Neptune-Export API 的所有請求。我們建議您使用 [awscurl](https://github.com/okigan/awscurl) 向 API 提出請求。這裡的所有範例都假設 IAM 身分驗證已啟用。
+ 如果在安裝 Neptune-Export 時，於 CloudFormation 堆疊中將 `VPCOnly` 參數設為 `true`，則必須從 VPC 內呼叫 Neptune-Export API，通常從位於 VPC 的 Amazon EC2 執行個體進行此呼叫。

若要開始匯出資料，請使用 `command` 和 `outputS3Path` 請求參數以及 `endpoint` 匯出參數，將請求傳送至 `NeptuneExportApiUri` 端點。

以下是請求範例，其會從 Neptune 匯出屬性圖資料，並將其發佈至 Amazon S3：

```
curl \
  {{(your NeptuneExportApiUri)}} \
  -X POST \
  -H 'Content-Type: application/json' \
  -d '{
        "command": "export-pg",
        "outputS3Path": "s3://{{(your Amazon S3 bucket)}}/neptune-export",
        "params": { "endpoint": "{{(your Neptune endpoint DNS name)}}" }
      }'
```

同樣地，以下是將 RDF 資料從 Neptune 匯出至 Amazon S3 的請求範例：

```
curl \
  {{(your NeptuneExportApiUri)}} \
  -X POST \
  -H 'Content-Type: application/json' \
  -d '{
        "command": "export-rdf",
        "outputS3Path": "s3://{{(your Amazon S3 bucket)}}/neptune-export",
        "params": { "endpoint": "{{(your Neptune endpoint DNS name)}}" }
      }'
```

如果您省略了 `command` 請求參數，根據預設，Neptune-Export 會嘗試從 Neptune 匯出屬性圖資料。

如果上一個命令執行成功，輸出將如下所示：

```
{
  "jobName": "neptune-export-abc12345-1589808577790",
  "jobId": "c86258f7-a9c9-4f8c-8f4c-bbfe76d51c8f"
}
```

## 監控您剛開始的匯出工作
<a name="export-service-monitor"></a>

若要監控執行中工作，請將其 jobID 附加到您的 `NeptuneExportApiUri`，如下所示：

```
curl \
  {{(your NeptuneExportApiUri)}}/{{(the job ID)}}
```

如果服務尚未啟動匯出工作，回應將如下所示：

```
{
  "jobId": "c86258f7-a9c9-4f8c-8f4c-bbfe76d51c8f",
  "status": "pending"
}
```

當您在匯出工作開始之後重複此命令時，回應會如下所示：

```
{
  "jobId": "c86258f7-a9c9-4f8c-8f4c-bbfe76d51c8f",
  "status": "running",
  "logs": "https://us-east-1.console.aws.amazon.com/cloudwatch/home?..."
}
```

如果您使用狀態呼叫所提供的 URI 開啟 CloudWatch Logs 中的日誌，則接著可以詳細監控匯出的進度：

![CloudWatch Logs 顯示畫面的螢幕擷取畫面。](http://docs.aws.amazon.com/zh_tw/neptune/latest/userguide/images/export-job-monitor.png)


## 取消執行中的匯出工作
<a name="export-service-cancel-job"></a>

**使用 取消執行中的匯出任務 AWS 管理主控台**

1. 在 https：//[https://console.aws.amazon.com/batch/](https://console.aws.amazon.com/batch/) 開啟 AWS Batch 主控台。

1. 選擇 **Jobs (任務)**。

1. 根據 `jobID` 找出您要取消的執行中工作。

1. 選取**取消工作**。

**若要使用 Neptune 匯出 API 取消執行中的匯出工作**：

將 `HTTP DELETE` 請求傳送到附加 `jobID` 的 `NeptuneExportApiUri`，如下所示：

```
curl -X DELETE \
  {{(your NeptuneExportApiUri)}}/{{(the job ID)}}
```