Panggil API GetFunction untuk menanyakan informasi fungsi - Function Compute

Mengambil informasi tentang suatu 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:GetFunction

get

*All Resource

*

None

Sintaks permintaan

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

Path Parameters

Parameter	Type	Required	Description	Example
serviceName	string	Yes	Nama layanan.	service_name
functionName	string	Yes	Nama fungsi.	function_name

Parameter permintaan

Parameter	Type	Required	Description	Example
qualifier	string	No	Versi atau alias layanan.	demoQualifier
X-Fc-Account-Id	string	No	ID Akun Alibaba Cloud Anda.	188077086902****
X-Fc-Date	string	No	Waktu pemanggilan fungsi. Format nilainya adalah: EEE,d MMM yyyy HH:mm:ss GMT.	Wed, 11 May 2022 09:00:00 GMT
X-Fc-Trace-Id	string	No	ID permintaan kustom.	asdf****

Elemen respons

Element	Type	Description	Example
	object	Definisi fungsi.
codeChecksum	string	Nilai CRC-64 dari paket kode fungsi.	2825179536350****
codeSize	integer	Ukuran paket kode fungsi. Satuan: byte.	421
createdTime	string	Waktu pembuatan fungsi.	2020-04-01T08:15:27Z
description	string	Deskripsi fungsi.	test_description
environmentVariables	object	Variabel lingkungan yang dikonfigurasi untuk fungsi. Anda dapat memperoleh nilai variabel lingkungan tersebut dari dalam fungsi. Untuk informasi selengkapnya, lihat Environment variables.
	string	Variabel lingkungan yang Anda konfigurasikan untuk fungsi.	{"key":"value"}
functionId	string	ID yang dihasilkan sistem untuk fungsi. Setiap ID fungsi bersifat unik dalam Function Compute.	aa715851-1c20-4b89-a8fb-***
functionName	string	Nama fungsi.	function_name
handler	string	Penanganan fungsi. Untuk informasi selengkapnya, lihat Function handler.	index.handler
lastModifiedTime	string	Waktu terakhir fungsi dimodifikasi.	2020-04-01T08:15:27Z
memorySize	integer	Ukuran memori untuk fungsi. Satuan: MB. Nilainya harus kelipatan 64. Ukuran memori bervariasi tergantung pada tipe instans fungsi. Untuk informasi selengkapnya, lihat Instance types.	256
runtime	string	Runtime fungsi. Nilai yang valid: nodejs20, nodejs18, nodejs16, nodejs14, nodejs12, nodejs10, nodejs8, nodejs6, nodejs4.4, python3.10, python3.9, python3, python2.7, java11, java8, go1, php7.2, dotnetcore2.1, custom.debian10, custom, dan custom-container.	python3
timeout	integer	Periode timeout untuk eksekusi fungsi. Satuan: detik. Nilai default: 60. Nilai yang valid: 1 hingga 600. Ketika periode ini berakhir, eksekusi fungsi akan dihentikan.	60
initializationTimeout	integer	Periode timeout untuk eksekusi panggilan balik Initializer. Satuan: detik. Nilai default: 3. Nilai yang valid: 1 hingga 300. Ketika periode ini berakhir, eksekusi panggilan balik Initializer akan dihentikan.	60
initializer	string	Penanganan panggilan balik Initializer. Format nilainya ditentukan oleh bahasa pemrograman yang Anda gunakan. Untuk informasi selengkapnya, lihat Initializer hook.	index.handler
caPort	integer	Port tempat server HTTP mendengarkan untuk runtime kustom atau runtime kontainer kustom.	9000
customContainerConfig	CustomContainerConfigInfo	Konfigurasi runtime Custom Container. Setelah Anda mengonfigurasi runtime Custom Container, Anda dapat menggunakan gambar kontainer kustom untuk mengeksekusi fungsi.
layers	array	Daftar layer (ARN V1). Catatan Jika terdapat beberapa layer, layer-layer tersebut digabung berdasarkan indeks array secara menurun. Konten layer dengan indeks lebih kecil akan menimpa konten layer dengan indeks lebih besar. Catatan Parameter ini akan ditinggalkan. Gunakan layersArnV2.
	string	Nama resource layer (versi ARN V1).	02f81d283888f5ec63442a88fe82b260#Layer-name#1
instanceConcurrency	integer	Jumlah permintaan yang dapat diproses secara konkuren oleh satu instans.	10
instanceSoftConcurrency	integer	Konkurensi lunak instans. Anda dapat menggunakan parameter ini untuk menerapkan skalabilitas vertikal instans yang halus. Jika jumlah permintaan konkuren pada suatu instans melebihi nilai konkurensi lunak, skalabilitas vertikal instans akan dipicu. Misalnya, jika instans Anda memerlukan waktu lama untuk memulai, Anda dapat menentukan konkurensi lunak yang sesuai agar instans dimulai lebih awal. Nilainya harus kurang dari atau sama dengan nilai parameter instanceConcurrency.	5
instanceType	string	Tipe instans fungsi. Nilai yang valid: e1: instans elastis c1: instans performa fc.gpu.tesla.1: instans yang dipercepat GPU dengan kartu seri Tesla fc.gpu.ampere.1: instans yang dipercepat GPU dengan kartu seri Ampere fc.gpu.ada.1: instans yang dipercepat GPU dengan kartu seri Ada g1: sama dengan fc.gpu.tesla.1	e1
instanceLifecycleConfig	InstanceLifecycleConfig	Konfigurasi siklus hidup instans.
customDNS	CustomDNS	Pengaturan Domain Name System (DNS) kustom fungsi.
customRuntimeConfig	CustomRuntimeConfig	Konfigurasi fungsi yang berjalan dalam runtime kustom.
customHealthCheckConfig	CustomHealthCheckConfig	Konfigurasi pemeriksaan kesehatan kustom fungsi. Parameter ini hanya berlaku untuk runtime kustom dan runtime Custom Container.
layersArnV2	array	Daftar layer (ARN V2). Catatan Jika terdapat beberapa layer, layer-layer tersebut digabung berdasarkan indeks array secara menurun. Konten layer dengan indeks lebih kecil akan menimpa konten layer dengan indeks lebih besar.
	string	Nama resource layer (versi ARN V2).	acs:fc:{region}:{accountID}:layers/{layerName}/versions/{layerVersion}
cpu	number	Jumlah vCPU fungsi. Nilainya harus kelipatan 0,05.	1.5
diskSize	integer	Ukuran disk fungsi. Satuan: MB. Nilai yang valid: 512 dan 10240.	512
gpuMemorySize	integer	Kapasitas memori GPU untuk fungsi. Satuan: MB. Nilainya merupakan kelipatan 1.024.	2048

Contoh

Respons sukses

JSONformat

{
  "codeChecksum": "2825179536350****",
  "codeSize": 421,
  "createdTime": "2020-04-01T08:15:27Z",
  "description": "test_description",
  "environmentVariables": {
    "key": "{\"key\":\"value\"}"
  },
  "functionId": "aa715851-1c20-4b89-a8fb-***",
  "functionName": "function_name",
  "handler": "index.handler",
  "lastModifiedTime": "2020-04-01T08:15:27Z",
  "memorySize": 256,
  "runtime": "python3",
  "timeout": 60,
  "initializationTimeout": 60,
  "initializer": "index.handler",
  "caPort": 9000,
  "customContainerConfig": {
    "args": "[\"-arg1\", \"value1\"]",
    "command": "[\"/code/myserver\"]",
    "image": "registry-vpc.cn-hangzhou.aliyuncs.com/fc-demo/helloworld:v1beta1",
    "accelerationType": "Default",
    "accelerationInfo": {
      "status": "Preparing"
    },
    "instanceID": "cri-xxxxxxxxxx",
    "webServerMode": true
  },
  "layers": [
    "02f81d283888f5ec63442a88fe82b260#Layer-name#1"
  ],
  "instanceConcurrency": 10,
  "instanceSoftConcurrency": 5,
  "instanceType": "e1",
  "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
  },
  "layersArnV2": [
    "acs:fc:{region}:{accountID}:layers/{layerName}/versions/{layerVersion}"
  ],
  "cpu": 1.5,
  "diskSize": 512,
  "gpuMemorySize": 2048
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.