# Describe export job

Read the state of a snapshot export job.

SDK: `@zilliz/milvus2-sdk-node@3.0.10` · Tested with Milvus 3.0.6

Canonical documentation: https://milvus-io.github.io/milvus-sdk-node/rest-api/snapshot-jobs/export/describe/

## Section links

- [cURL command](https://milvus-io.github.io/milvus-sdk-node/rest-api/snapshot-jobs/export/describe/#curl-command)
- [Default request](https://milvus-io.github.io/milvus-sdk-node/rest-api/snapshot-jobs/export/describe/#default-request)
- [Sample response](https://milvus-io.github.io/milvus-sdk-node/rest-api/snapshot-jobs/export/describe/#sample-response)
- [Request fields](https://milvus-io.github.io/milvus-sdk-node/rest-api/snapshot-jobs/export/describe/#request-fields)

`POST /v2/vectordb/jobs/snapshot/export/describe`

Replace `https://your-cluster.example.com` with your Milvus endpoint. Set `MILVUS_TOKEN` for authentication or omit the Authorization header on an unauthenticated cluster.

## cURL command

```bash
curl --request POST --url 'https://your-cluster.example.com/v2/vectordb/jobs/snapshot/export/describe' \
  --header 'Content-Type: application/json' \
  --header "Authorization: Bearer ${MILVUS_TOKEN}" \
  --data-raw '{
  "jobId": "123456789"
}'
```

## Default request

```json
{
  "jobId": "123456789"
}
```

## Sample response

```json
{
  "code": 0,
  "data": {
    "jobId": 123456789,
    "snapshotName": "books_backup",
    "dbName": "default",
    "collectionName": "books",
    "progress": 100,
    "reason": "",
    "startTime": 1795099200000,
    "timeCost": 2000,
    "state": "ExportSnapshotCompleted",
    "totalFiles": 1,
    "copiedFiles": 1,
    "totalBytes": 4096,
    "snapshotMetadataURI": "s3://example-bucket/snapshots/books/manifest.json"
  }
}
```

## Request fields

- `jobId` string (required)
  Job ID returned when the job was submitted.

See [`HttpClient.getExportSnapshotState`](https://milvus-io.github.io/milvus-sdk-node/api-reference/http-client/#getexportsnapshotstate) for the Node.js SDK method.
