執行預存程序
在預存程式資源上執行 POST 來執行預存程式。 預存程序是一種以針對集合註冊並視為單一交易執行的 JavaScript 撰寫的應用程式邏輯。
要求
| 方法 | 要求 URI | Description |
|---|---|---|
| POST | https://{databaseaccount}.documents.azure.com/dbs/{db-id}/colls/{coll-id}/sprocs/{sproc-name} |
{databaseaccount} 是您訂用帳戶下建立的 Azure Cosmos DB 帳戶名稱。 {db-id} 值是使用者產生預存程式所在資料庫的名稱/識別碼，而不是系統產生的識別碼 (rid) 。 {coll-id} 值是預存程式所在的集合名稱。 {sproc-name} 值是要執行的預存程式名稱。 |
標題
如需所有 SQL API 要求所使用的標頭，請參閱 一般 REST 要求標頭 。
主體
| 屬性 | 必要 | 類型 | Description |
|---|---|---|---|
| < 參數> | 必要 | Array | 要傳遞至預存程式的參數陣列。 |
[“World”]
回應
標題
如需所有 Cosmos DB 回應所傳回的標頭，請參閱 常見的 Azure Cosmos DB REST 回應標頭 。
狀態碼
下表列出此作業所傳回的常見狀態碼。 如需狀態碼的完整清單，請參閱 HTTP 狀態碼。
| HTTP 狀態碼 | Description |
|---|---|
| 200 確定 | 作業成功。 |
主體
| 屬性 | Description |
|---|---|
| <回應> | 預存程式的回應。 |
"Hello, World"
範例
POST https://contosomarketing.documents.azure.com/dbs/volcanodb/colls/volcano1/sprocs/sproc_hello_world HTTP/1.1
x-ms-date: Wed, 09 Dec 2015 18:05:07 GMT
authorization: type%3dmaster%26ver%3d1.0%26sig%3dwG%2f1OgCtY8aoSRprHecXxL%2fewTrqEIPjfCLcHDlVZQA%3d
Cache-Control: no-cache
User-Agent: contoso/1.0
x-ms-version: 2015-08-06
Accept: application/json
Content-Type: application/json
Host: contosomarketing.documents.azure.com
Content-Length: 9
Expect: 100-continue
["World"]
HTTP/1.1 200 Ok
Cache-Control: no-store, no-cache
Pragma: no-cache
Content-Type: application/json
Server: Microsoft-HTTPAPI/2.0
Strict-Transport-Security: max-age=31536000
x-ms-last-state-change-utc: Sun, 29 Nov 2015 19:20:18.154 GMT
x-ms-schemaversion: 1.1
x-ms-alt-content-path: dbs/volcanodb/colls/volcano1/sprocs/sproc_hello_world
x-ms-content-path: Sl8fALN4sw4=
x-ms-quorum-acked-lsn: 37
x-ms-session-token: 37
x-ms-current-write-quorum: 3
x-ms-current-replica-set-size: 4
x-ms-request-charge: 7.3
x-ms-serviceversion: version=1.5.57.3
x-ms-activity-id: 92012d9b-7d0d-4d4e-acd7-3db487c267f9
Set-Cookie: x-ms-session-token=37; Domain=contosomarketing.documents.azure.com; Path=/dbs/volcanodb/colls/volcano1
x-ms-gatewayversion: version=1.5.57.3
Date: Wed, 09 Dec 2015 18:05:06 GMT
Content-Length: 14
"Hello, World"