Bir Function Compute işlevini eşzamanlı veya eşzamansız olarak çağırır. İstek gövdesinde bir olay yükü iletirsiniz; Function Compute bu yükü işlev işleyicisine yönlendirir ve sonucu veya bir çağırma kimliğini döndürür.
Bu işlemi etkileşimli olarak çağırmak ve SDK örnek kodu oluşturmak için OpenAPI Explorer kullanın.
İstek sözdizimi
POST /services/{serviceName.qualifier}/functions/{functionName} HTTP/1.1İstek üstbilgileri
Bu işlem, ortak istek üstbilgilerini ve aşağıdaki işleme özel üstbilgileri kullanır.
| Üstbilgi | Tür | Gerekli | Örnek | Açıklama |
|---|---|---|---|---|
| X-Fc-Invocation-Type | String | Hayır | Sync | Çağırma modu. Geçerli değerler: Sync (eşzamanlı çağırma) ve Async (eşzamansız çağırma). |
| X-Fc-Log-Type | String | Hayır | None | Günlüklerin döndürülüp döndürülmeyeceğini denetler. Geçerli değerler: Tail (istek için son 4 KB'lık günlükleri döndürür) ve None (hiçbir günlük döndürülmez). Varsayılan: None. |
| X-Fc-Stateful-Async-Invocation-Id | String | Hayır | g6u*iyvhd3jk8s6bhj0hh | Eşzamansız bir göreve atanacak kimlik. Eşzamansız görev özelliğinin önceden etkinleştirilmiş olması gerekir. Kimlik bir harf veya alt çizgi (_) ile başlamalıdır; harfler, rakamlar, alt çizgiler (_) ve kısa çizgiler (-) içerebilir. Maksimum uzunluk: 128 karakter. Belirtilmezse Function Compute otomatik olarak bir kimlik oluşturur. Görev durumunu kontrol etmeyi veya daha sonra görevi iptal etmeyi kolaylaştırmak için iş anlamı taşıyan bir kimlik belirtin (örneğin, video işleme işlevi için video dosya adı). |
İstek parametreleri
| Parametre | Tür | Konum | Gerekli | Örnek | Açıklama |
|---|---|---|---|---|---|
| serviceName | String | Path | Evet | service_name | Hizmetin adı. |
| qualifier | String | Path | Hayır | LATEST | Hizmetin sürümü veya diğer adı. |
| functionName | String | Path | Evet | function_name | İşlevin adı. |
| (body) | String | Body | Evet | {"key1": "value1"} | Olay yükü. Function Compute bu ikili diziyi işlemek üzere işlev işleyicisine iletir. |
Yanıt öğeleri
| Üstbilgi | Tür | Örnek | Açıklama |
|---|---|---|---|
| X-Fc-Error-Type | String | UnhandledInvocationError | Çağırma sonrasında döndürülen hata türü. Geçerli değerler: HandledInvocationError (Node.js geri araması tarafından döndürülen hatalar) ve UnhandledInvocationError (diğer tüm hatalar). Ayrıntılar için bkz. Hata işleme. |
| X-Fc-Log-Result | String | demo log result | X-Fc-Log-Type değeri Tail olarak ayarlandığında döndürülen çağırma günlük çıktısı. |
| X-Fc-Code-Checksum | String | 5697641582914695457 | İşlev kod paketinin CRC-64 sağlama toplamı. |
| X-Fc-Stateful-Async-Invocation-Id | String | g6u*iyvhd3jk8s6bhj0hh | Eşzamansız görevin kimliği. Maksimum uzunluk: 128 karakter. İstekte belirtilmemişse Function Compute bir kimlik oluşturur. |
| X-Fc-Instance-Id | String | 7c43576b-48b1-4c3a-86e5-dcb01872**** | Çağrıyı işleyen işlev örneğinin kimliği. |
| X-Fc-Request-Id | String | dab25e58-9356-4e3f-97d6-f044c4**** | Bu çağırma için istek kimliği. |
| X-Fc-Max-Memory-Usage | String | 9,2 | İşlev yürütme sırasında tüketilen en yüksek bellek miktarı (MB cinsinden). |
| X-Fc-Invocation-Duration | String | 10 | İşlev yürütme süresi (milisaniye cinsinden). |
| X-Fc-Invocation-Service-Version | String | LATEST | Çağrılan işlevin sürümü veya diğer adı. |
| (body) | String | hello world | İşlevden dönen değer. Döndürülecek sonucu belirtebilirsiniz. |
Örnekler
İstek
POST /services/{serviceName.qualifier}/functions/function_name HTTP/1.1
Host: fc-ram.aliyuncs.com
X-Fc-Invocation-Type: Sync
X-Fc-Log-Type: None
X-Fc-Stateful-Async-Invocation-Id: g6u*****iyvhd3jk8s6bhj0hh
Content-Type: application/json
{"key1": "value1"}Yanıt
HTTP/1.1 200 OK
Content-Type: application/json
{
"result": "hello world"
}Hata kodları
Hata kodlarının listesi için bkz. Hizmet hata kodları.