GetFunction - - Alibaba Cloud Dokümantasyon Merkezi

Bir fonksiyon hakkındaki bilgileri sorgular.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

fc:GetFunction

get

*All Resource

*

None

Request syntax

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

Path Parameters

Parameter	Type	Required	Description	Example
serviceName	string	Yes	Hizmetin adı.	service_name
functionName	string	Yes	Fonksiyonun adı.	function_name

Request parameters

Parameter	Type	Required	Description	Example
qualifier	string	No	Hizmetin sürümü veya diğer adı.	demoQualifier
X-Fc-Account-Id	string	No	Alibaba Cloud hesabınızın kimliği.	188077086902****
X-Fc-Date	string	No	Fonksiyonun çağrıldığı zaman. Değerin biçimi: EEE,d MMM yyyy HH:mm:ss GMT.	Wed, 11 May 2022 09:00:00 GMT
X-Fc-Trace-Id	string	No	Özel istek kimliği.	asdf****

Response elements

Element	Type	Description	Example
	object	Fonksiyonun tanımı.
codeChecksum	string	Fonksiyon kod paketinin CRC-64 değeri.	2825179536350****
codeSize	integer	Fonksiyon kod paketinin boyutu. Birim: bayt.	421
createdTime	string	Fonksiyonun oluşturulduğu zaman.	2020-04-01T08:15:27Z
description	string	Fonksiyonun açıklaması.	test_description
environmentVariables	object	Fonksiyon için yapılandırılan ortam değişkenleri. Ortam değişkenlerinin değerlerini fonksiyondan alabilirsiniz. Daha fazla bilgi için bkz. Ortam değişkenleri.
	string	Fonksiyon için yapılandırdığınız ortam değişkenleri.	{"key":"value"}
functionId	string	Fonksiyon için sistem tarafından oluşturulan kimlik. Her fonksiyon kimliği Function Compute'ta benzersizdir.	aa715851-1c20-4b89-a8fb-***
functionName	string	Fonksiyonun adı.	function_name
handler	string	Fonksiyonun işleyicisi. Daha fazla bilgi için bkz. Fonksiyon işleyicisi.	index.handler
lastModifiedTime	string	Fonksiyonun en son değiştirildiği zaman.	2020-04-01T08:15:27Z
memorySize	integer	Fonksiyon için bellek boyutu. Birim: MB. Değer 64'ün katı olmalıdır. Bellek boyutu fonksiyon örnek türüne göre değişir. Daha fazla bilgi için bkz. Örnek türleri.	256
runtime	string	Fonksiyonun çalışma zamanı. Geçerli değerler: 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 ve custom-container.	python3
timeout	integer	Fonksiyonun yürütülmesi için zaman aşımı süresi. Birim: saniye. Varsayılan değer: 60. Geçerli değerler: 1 ile 600 arası. Bu süre dolduğunda fonksiyonun yürütülmesi sonlandırılır.	60
initializationTimeout	integer	Initializer kancasının yürütülmesi için zaman aşımı süresi. Birim: saniye. Varsayılan değer: 3. Geçerli değerler: 1 ile 300 arası. Bu süre sona erdiğinde Initializer kancasının yürütülmesi sonlandırılır.	60
initializer	string	Initializer kancasının işleyicisi. Değerin biçimi kullandığınız programlama diline göre belirlenir. Daha fazla bilgi için bkz. Initializer kancası.	index.handler
caPort	integer	Özel çalışma zamanı veya özel konteyner çalışma zamanı için HTTP sunucusunun dinlediği bağlantı noktası.	9000
customContainerConfig	CustomContainerConfigInfo	Custom Container çalışma zamanı yapılandırmaları. Custom Container çalışma zamanını yapılandırdıktan sonra fonksiyonları yürütmek için özel bir konteyner görüntüsü kullanabilirsiniz.
layers	array	Katmanların listesi (ARN V1). Not Birden fazla katman varsa, katmanlar dizi indislerine göre azalan sırada birleştirilir. Daha küçük indise sahip bir katmanın içeriği, daha büyük indise sahip olanın üzerine yazar. Not Bu parametre kullanımdan kaldırılacaktır. layersArnV2 kullanın.
	string	Katman kaynağının adı (ARN V1 sürümü).	02f81d283888f5ec63442a88fe82b260#Layer-name#1
instanceConcurrency	integer	Tek bir örnek tarafından eşzamanlı olarak işlenebilen istek sayısı.	10
instanceSoftConcurrency	integer	Örneğin yumuşak eşzamanlılığı. Bu parametreyi kullanarak örneklerin sorunsuz bir şekilde ölçeklenmesini sağlayabilirsiniz. Bir örnekteki eşzamanlı istek sayısı yumuşak eşzamanlılık değerinden büyükse örnek ölçeklendirmesi tetiklenir. Örneğin, örneğinizin başlaması uzun zaman alıyorsa, örneği önceden başlatmak için uygun bir yumuşak eşzamanlılık belirtebilirsiniz. Değer, instanceConcurrency parametresinin değerinden küçük veya ona eşit olmalıdır.	5
instanceType	string	Fonksiyonun örnek türü. Geçerli değerler: e1: esnek örnekler c1: performans örnekleri fc.gpu.tesla.1: Tesla serisi kartlara sahip GPU hızlandırmalı örnekler fc.gpu.ampere.1: Ampere serisi kartlara sahip GPU hızlandırmalı örnekler fc.gpu.ada.1: Ada serisi kartlara sahip GPU hızlandırmalı örnekler g1: fc.gpu.tesla.1 ile aynı	e1
instanceLifecycleConfig	InstanceLifecycleConfig	Örneklerin yaşam döngüsü yapılandırmaları.
customDNS	CustomDNS	Fonksiyonun özel Etki Alanı Adı Sistemi (DNS) ayarları.
customRuntimeConfig	CustomRuntimeConfig	Özel çalışma zamanında çalışan fonksiyonun yapılandırmaları.
customHealthCheckConfig	CustomHealthCheckConfig	Fonksiyonun özel sağlık denetimi yapılandırmaları. Bu parametre yalnızca özel çalışma zamanları ve Custom Container çalışma zamanları için geçerlidir.
layersArnV2	array	Katmanların listesi (ARN V2). Not Birden fazla katman varsa, katmanlar dizi indislerine göre azalan sırada birleştirilir. Daha küçük indise sahip bir katmanın içeriği, daha büyük indise sahip olanın üzerine yazar.
	string	Katman kaynağının adı (ARN V2 sürümü).	acs:fc:{region}:{accountID}:layers/{layerName}/versions/{layerVersion}
cpu	number	Fonksiyonun vCPU sayısı. Değer 0,05'in katı olmalıdır.	1.5
diskSize	integer	Fonksiyonun disk boyutu. Birim: MB. Geçerli değerler: 512 ve 10240.	512
gpuMemorySize	integer	Fonksiyon için GPU bellek kapasitesi. Birim: MB. Değer 1.024'ün katıdır.	2048

Examples

Success response

JSON format

{
  "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
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.