All Products
Search

This Product

    :UpdateFunction

    Document Center

    :UpdateFunction

    Last Updated:Aug 28, 2026

    Memperbarui informasi fungsi.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    fc:UpdateFunction

    update

    *Function.

    acs:fc:{#regionId}:{#accountId}:services/{#ServiceName}/functions/{#FunctionName}

    		 None None

    Sintaks permintaan

    PUT /2021-04-06/services/{serviceName}/functions/{functionName} HTTP/1.1

    Path Parameters

    Parameter

    Type

    Required

    Description

    Example
    serviceName

    string

    Yes

    Nama layanan.

    demoService
    functionName

    string

    Yes

    Nama fungsi.

    demoFunction

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    If-Match

    string

    No

    Digunakan untuk memastikan bahwa resource yang dimodifikasi sesuai dengan resource yang diharapkan. Nilai diperoleh dari tanggapan CreateFunction, GetFunction, dan UpdateFunction.

    e19d5cd5af0378da05f63f891c7467af
    functionUpdateFields

    object

    No

    Struktur permintaan untuk memperbarui fungsi.

    code Code

    No

    Code mendukung dua metode untuk menyediakan paket kode fungsi. Anda harus menggunakan satu dan hanya satu metode dalam satu permintaan:

    • Tentukan ossBucketName dan ossObjectName untuk mereferensikan paket kode yang disimpan di OSS.

    • Tentukan zipFile sebagai konten terenkripsi Base64 dari paket ZIP.

    customContainerConfig CustomContainerConfig

    No

    Konfigurasi untuk runtime Custom Container. Setelah dikonfigurasi, fungsi dapat menggunakan gambar kontainer kustom untuk menjalankan fungsi.

    layers

    array

    No

    Daftar layer.

    Catatan

    Beberapa layer digabungkan berdasarkan urutan indeks array menurun. File dalam layer dengan indeks lebih kecil akan menimpa file dengan nama yang sama di layer dengan indeks lebih besar.

    string

    No

    Nama resource layer.

    layername
    description

    string

    No

    Deskripsi fungsi.

    test desc
    environmentVariables

    object

    No

    Variabel lingkungan yang diatur untuk fungsi. Anda dapat mengambil nilai variabel lingkungan di dalam fungsi. Untuk informasi lebih lanjut, lihat Variabel lingkungan.

    string

    No

    Konfigurasi variabel lingkungan.

    {"key":"value"}
    handler

    string

    No

    Titik masuk untuk eksekusi fungsi. Format spesifik bergantung pada bahasa. Untuk informasi lebih lanjut, lihat Titik masuk fungsi.

    index.handler
    memorySize

    integer

    No

    Spesifikasi memori fungsi dalam MB. Nilai harus merupakan kelipatan 64 MB. Spesifikasi memori bervariasi berdasarkan tipe instans fungsi. Untuk informasi lebih lanjut, lihat Spesifikasi instans.

    512
    runtime

    string

    No

    Lingkungan runtime bahasa untuk fungsi. Nilai valid: nodejs20, nodejs18, nodejs16, nodejs14, nodejs12, nodejs10, nodejs8, nodejs6, nodejs4.4, python3.10, python3.9, python3, python2.7, java11, java8, go1, php7.2, dotnetcore3.1, dotnetcore2.1, custom.debian10, custom, dan custom-container. Untuk informasi lebih lanjut, lihat Lingkungan runtime fungsi yang didukung.

    python3.9
    timeout

    integer

    No

    Waktu tunggu untuk eksekusi fungsi dalam detik. Nilai minimum: 1. Nilai default: 3. Fungsi dihentikan jika melebihi batas waktu ini.

    60
    initializationTimeout

    integer

    No

    Waktu tunggu untuk fungsi inisialisasi dalam detik. Nilai minimum: 1. Nilai default: 3. Fungsi inisialisasi dihentikan jika melebihi batas waktu ini.

    60
    initializer

    string

    No

    Titik masuk untuk eksekusi fungsi inisialisasi. Format spesifik bergantung pada bahasa. Untuk informasi lebih lanjut, lihat Titik masuk fungsi.

    index.handler
    caPort

    integer

    No

    Port listening dari Server HTTP untuk runtime custom dan runtime kontainer kustom.

    9000
    InstanceConcurrency

    integer

    No

    Konkurensi maksimum sebuah instans.

    10
    instanceSoftConcurrency

    integer

    No

    Konkurensi lunak sebuah instans, digunakan untuk penskalaan yang halus. Ketika konkurensi pada sebuah instans melebihi konkurensi lunak, penskalaan instans akan dipicu. Misalnya, jika instans Anda mulai berjalan dengan lambat, Anda dapat mengatur konkurensi lunak yang sesuai untuk memulai instans terlebih dahulu.

    Nilai harus kurang dari atau sama dengan instanceConcurrency.

    5
    instanceType

    string

    No

    Tipe instans fungsi. Nilai valid:

    • e1: Instans elastis.

    • c1: Instans performa.

    • fc.gpu.tesla.1: Tipe instans seri GPU Tesla.

    • fc.gpu.ampere.1: Tipe instans seri GPU Ampere.

    • fc.gpu.ada.1: Tipe instans seri GPU Ada.

    • g1: Sama dengan fc.gpu.tesla.1.

    e1
    instanceLifecycleConfig InstanceLifecycleConfig

    No

    Konfigurasi siklus hidup instans.

    customDNS CustomDNS

    No

    Konfigurasi DNS kustom untuk fungsi.

    customRuntimeConfig CustomRuntimeConfig

    No

    Konfigurasi terperinci untuk fungsi Custom Runtime.

    customHealthCheckConfig CustomHealthCheckConfig

    No

    Konfigurasi pemeriksaan kesehatan kustom untuk fungsi, hanya berlaku untuk Custom Runtime dan Custom Container.

    cpu

    number

    No

    Spesifikasi CPU fungsi dalam vCPU. Nilai harus merupakan kelipatan 0,05 vCPU.

    1.5
    diskSize

    integer

    No

    Spesifikasi disk fungsi dalam MB. Nilai valid: 512 MB atau 10240 MB.

    512
    gpuMemorySize

    integer

    No

    Spesifikasi memori GPU fungsi dalam MB. Nilai harus merupakan kelipatan 1024 MB.

    2048
    X-Fc-Account-Id

    string

    No

    ID akun Alibaba Cloud Anda.

    188077086902****
    X-Fc-Code-Checksum

    string

    No

    Nilai CRC-64 dari paket kode fungsi.

    1506052139770049xxxx
    X-Fc-Date

    string

    No

    Tanggal mulai pemanggilan fungsi dalam format EEE,d MMM yyyy HH:mm:ss GMT.

    Wed, 11 May 2022 09:00:00 GMT
    X-Fc-Trace-Id

    string

    No

    ID pemanggilan fungsi, yang sesuai dengan requestId dalam tanggapan.

    test-trace-id

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Nilai kembali dari operasi pembaruan fungsi.

    codeChecksum

    string

    Nilai CRC64 paket kode fungsi.

    5434025278388143772
    codeSize

    integer

    Ukuran paket kode fungsi yang dikembalikan oleh sistem, dalam byte.

    1024
    createdTime

    string

    Waktu saat fungsi dibuat.

    2016-08-15T15:00:00.000+0000
    customContainerConfig CustomContainerConfig

    Konfigurasi runtime Custom Container. Setelah dikonfigurasi, fungsi dapat menggunakan gambar kontainer kustom untuk menjalankan fungsi.

    layers

    array

    Daftar layer.

    Catatan

    Beberapa layer digabungkan berdasarkan urutan menurun indeks array. File dalam layer dengan indeks lebih kecil menimpa file dengan nama yang sama di layer dengan indeks lebih besar.

    string

    Nama resource layer.

    md5#layername#version
    description

    string

    Deskripsi fungsi.

    This is a demo hello world function
    environmentVariables

    object

    Variabel lingkungan yang diatur untuk fungsi. Anda dapat mengambil nilai variabel lingkungan di dalam fungsi. Untuk informasi selengkapnya, lihat Variabel lingkungan.

    string

    Konfigurasi variabel lingkungan.

    {"key":"value"}
    functionId

    string

    ID unik yang dihasilkan oleh sistem untuk setiap fungsi.

    2d28e0e9-9ba5-4eed-8b1a-d3d9cd24****
    functionName

    string

    Nama fungsi.

    demo-function
    handler

    string

    Titik masuk eksekusi fungsi.

    index.handler
    lastModifiedTime

    string

    Waktu saat fungsi terakhir dimodifikasi.

    2016-08-15T17:00:00.000+0000
    memorySize

    integer

    Ukuran memori yang dikonfigurasi untuk fungsi, dalam MB.

    512
    runtime

    string

    Lingkungan waktu proses bahasa untuk fungsi. Nilai valid: nodejs20, nodejs18, nodejs16, nodejs14, nodejs12, nodejs10, nodejs8, nodejs6, nodejs4.4, python3.10, python3.9, python3, python2.7, java11, java8, go1, php7.2, dotnetcore3.1, dotnetcore2.1, custom.debian10, custom, dan custom-container. Untuk informasi selengkapnya, lihat Lingkungan runtime fungsi yang didukung.

    python3.9
    timeout

    integer

    Periode waktu tunggu eksekusi, dalam detik.

    10
    initializationTimeout

    integer

    Waktu tunggu untuk fungsi inisialisasi dalam detik. Nilai minimum: 1. Nilai default: 3. Fungsi inisialisasi dihentikan jika melebihi batas waktu ini.

    60
    initializer

    string

    Titik masuk untuk eksekusi fungsi inisialisasi. Format spesifik bergantung pada bahasa.

    index.handler
    caPort

    integer

    Port listening Server HTTP untuk Custom Runtime atau runtime Custom Container.

    9000
    instanceType

    string

    Tipe instans fungsi. Nilai valid:

    • e1: Instans elastis.

    • c1: Instans performa.

    • fc.gpu.tesla.1: Tipe instans seri GPU Tesla.

    • fc.gpu.ampere.1: Tipe instans seri GPU Ampere.

    • fc.gpu.ada.1: Tipe instans seri GPU Ada.

    • g1: Sama dengan fc.gpu.tesla.1.

    e1
    instanceSoftConcurrency

    integer

    Konkurensi lunak sebuah instans, digunakan untuk penskalaan yang halus. Ketika konkurensi pada sebuah instans melebihi konkurensi lunak, penskalaan instans akan dipicu. Misalnya, jika instans Anda mulai berjalan dengan lambat, Anda dapat mengatur konkurensi lunak yang sesuai untuk memulai instans terlebih dahulu.

    Nilai harus kurang dari atau sama dengan instanceConcurrency.

    5
    instanceLifecycleConfig InstanceLifecycleConfig

    Konfigurasi siklus hidup instans.

    customDNS CustomDNS

    Konfigurasi DNS kustom untuk fungsi.

    customRuntimeConfig CustomRuntimeConfig

    Konfigurasi detail untuk fungsi Custom Runtime.

    customHealthCheckConfig CustomHealthCheckConfig

    Konfigurasi pemeriksaan kesehatan kustom untuk fungsi, hanya berlaku untuk Custom Runtime dan Custom Container.

    cpu

    number

    Spesifikasi CPU fungsi dalam vCPU. Nilai harus merupakan kelipatan 0,05 vCPU.

    1.5
    diskSize

    integer

    Spesifikasi disk fungsi dalam MB. Nilai valid: 512 MB atau 10240 MB.

    512
    instanceConcurrency

    integer

    Konkurensi satu instans.

    10
    gpuMemorySize

    integer

    Spesifikasi memori GPU fungsi dalam MB. Nilai harus merupakan kelipatan 1024 MB.

    2048
    layersArnV2

    array

    Daftar ARN layer.

    string

    Locator resource layer.

    acs:fc:cn-hangzhou:official:layers/Python310/versions/2

    Contoh

    Respons sukses

    JSONformat

    {
  "codeChecksum": "5434025278388143772",
  "codeSize": 1024,
  "createdTime": "2016-08-15T15:00:00.000+0000",
  "customContainerConfig": {
    "args": "[\"-arg1\", \"value1\"]",
    "command": "[\"/code/myserver\"]",
    "image": "registry-vpc.cn-hangzhou.aliyuncs.com/fc-demo/helloworld:v1beta1",
    "accelerationType": "Default",
    "instanceID": "cri-xxxxxxxxxx",
    "webServerMode": true
  },
  "layers": [
    "md5#layername#version"
  ],
  "description": "This is a demo hello world function",
  "environmentVariables": {
    "key": "{\"key\":\"value\"}"
  },
  "functionId": "2d28e0e9-9ba5-4eed-8b1a-d3d9cd24****",
  "functionName": "demo-function",
  "handler": "index.handler",
  "lastModifiedTime": "2016-08-15T17:00:00.000+0000",
  "memorySize": 512,
  "runtime": "python3.9",
  "timeout": 10,
  "initializationTimeout": 60,
  "initializer": "index.handler",
  "caPort": 9000,
  "instanceType": "e1",
  "instanceSoftConcurrency": 5,
  "instanceLifecycleConfig": {
    "preFreeze": {
      "handler": "index.preStop",
      "timeout": 10
    },
    "preStop": {
      "handler": "index.preStop",
      "timeout": 10
    }
  },
  "customDNS": {
    "nameServers": [
      "8.8.x.x"
    ],
    "searches": [
      "ns1.svc.cluster-domain.example"
    ],
    "dnsOptions": [
      {
        "name": "ndots",
        "value": "2"
      }
    ]
  },
  "customRuntimeConfig": {
    "command": [
      "/code/myBootstrap"
    ],
    "args": [
      "args1"
    ]
  },
  "customHealthCheckConfig": {
    "httpGetUrl": "/ready",
    "initialDelaySeconds": 1,
    "periodSeconds": 1,
    "timeoutSeconds": 2,
    "failureThreshold": 1,
    "successThreshold": 2
  },
  "cpu": 1.5,
  "diskSize": 512,
  "instanceConcurrency": 10,
  "gpuMemorySize": 2048,
  "layersArnV2": [
    "acs:fc:cn-hangzhou:official:layers/Python310/versions/2"
  ]
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.