Creates a function.
Operation description
When you create a function by using an Object Storage Service (OSS) code package, if the error "unable to access object xxx in bucket xxx" is returned, you must grant the current user access permissions on the OSS bucket. For example, you can attach the system access policy AliyunOSSReadOnlyAccess or a custom authorization with finer granularity such as oss:GetObject. For details about the policy content, see Grant a Resource Access Management (RAM) user the permissions to read all resources in a bucket.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
fc:CreateFunction |
create |
*All Resource
|
None | None |
Request syntax
POST /2023-03-30/functions HTTP/1.1Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| body | CreateFunctionInput |
Yes |
The function configuration information. |
Response elements
|
Element |
Type |
Description |
Example |
| Function |
The function configuration information. |
Examples
Success response
JSON format
{
"codeChecksum": "2825179536350****",
"codeSize": 412,
"cpu": 1,
"createdTime": "2023-04-01T08:15:27Z",
"customContainerConfig": {
"accelerationInfo": {
"status": "Ready"
},
"accelerationType": "Default",
"acrInstanceId": "cri-xxxxxxxxxx",
"command": [
"arg1"
],
"entrypoint": [
"/code/bootstrap"
],
"healthCheckConfig": {
"failureThreshold": 1,
"httpGetUrl": "/ready",
"initialDelaySeconds": 1,
"periodSeconds": 1,
"successThreshold": 2,
"timeoutSeconds": 2
},
"image": "registry-vpc.cn-hangzhou.aliyuncs.com/fc-demo/helloworld:v1beta1",
"port": 9000,
"registryConfig": {
"authConfig": {
"password": "abc***",
"userName": "admin"
},
"certConfig": {
"insecure": true,
"rootCaCertBase64": "cm9vdF9jYV9jZXJ0"
},
"networkConfig": {
"securityGroupId": "sg-xxxxxxxxxxxxxx",
"vSwitchId": "vsw-xxxxxxxxxxxxxx",
"vpcId": "vpc-xxxxxxxxxxxxxx"
}
},
"resolvedImageUri": "stand-sh-registry-vpc.cn-shanghai.cr.aliyuncs.com/fc-demo2/springboot-helloworld@sha256:68d1****0d64d6"
},
"customDNS": {
"dnsOptions": [
{
"name": "ndots",
"value": "2"
}
],
"nameServers": [
"8.8.x.x"
],
"searches": [
"ns1.svc.cluster-domain.example"
]
},
"customRuntimeConfig": {
"args": [
"arg1"
],
"command": [
"/code/bootstrap"
],
"healthCheckConfig": {
"failureThreshold": 1,
"httpGetUrl": "/ready",
"initialDelaySeconds": 1,
"periodSeconds": 1,
"successThreshold": 2,
"timeoutSeconds": 2
},
"port": 9000
},
"description": "my function",
"diskSize": 512,
"environmentVariables": {
"key": "value1"
},
"functionArn": "acs:fc:cn-shanghai:123:functions/functionName",
"functionId": "aa715851-1c20-4b89-a8fb-***",
"functionName": "my-function-1",
"gpuConfig": {
"gpuMemorySize": 2048,
"gpuType": "fc.gpu.tesla.1"
},
"handler": "index.handler",
"instanceConcurrency": 1,
"instanceLifecycleConfig": {
"initializer": {
"handler": "index.initializer",
"timeout": 10,
"command": [
"curl -X POST 'http://localhost:9000/preWarm"
]
},
"preStop": {
"handler": "index.initializer",
"timeout": 10,
"command": [
"curl -X POST 'http://localhost:9000/preWarm"
]
}
},
"internetAccess": true,
"lastModifiedTime": "2023-05-01T08:15:27Z",
"lastUpdateStatus": "InProgress",
"lastUpdateStatusReason": "The system is currently processing the acceleration optimization for the image.",
"lastUpdateStatusReasonCode": "ImageOptimizing",
"layers": [
{
"arn": "acs:fc:cn-beijing:186824xxxxxx:layers/fc_layer/versions/1",
"size": 421
}
],
"logConfig": {
"enableInstanceMetrics": true,
"enableRequestMetrics": true,
"logBeginRule": "DefaultRegex",
"logstore": "test-logstore",
"project": "test-project",
"enableLlmMetrics": true
},
"memorySize": 512,
"nasConfig": {
"groupId": 100,
"mountPoints": [
{
"enableTLS": true,
"mountDir": "/home/test",
"serverAddr": "***-uni85.cn-hangzhou.nas.com:/"
}
],
"userId": 100
},
"ossMountConfig": {
"mountPoints": [
{
"bucketName": "my-bucket",
"bucketPath": "/my-dir",
"endpoint": "http://oss-cn-shanghai.aliyuncs.com",
"mountDir": "/mnt/dir",
"readOnly": true
}
]
},
"role": "acs:ram::188077086902****:role/fc-test",
"runtime": "python3.10",
"state": "Pending",
"stateReason": "Function creating",
"stateReasonCode": "Creating",
"timeout": 60,
"tracingConfig": {
"params": {
"key": "http://tracing-analysis-dc-hz.aliyuncs.com/adapt_xxx/api/otlp/traces"
},
"type": "Jaeger"
},
"vpcConfig": {
"securityGroupId": "sg-bp18hj1wtxgy3b0***",
"vSwitchIds": [
"vsw-bp1ozpcrdc6r****"
],
"vpcId": "vpc-***",
"role": "acs:ram::188077086902****:role/fc-test"
},
"tags": [
{
"Key": "k1",
"Value": "v1"
}
],
"disableOndemand": true,
"invocationRestriction": {
"reason": "",
"lastModifiedTime": "",
"disable": true
},
"sessionAffinity": "MCP_SSE",
"enableLongLiving": true,
"resourceGroupId": "",
"instanceIsolationMode": "",
"sessionAffinityConfig": "{\\\"sseEndpointPath\\\":\\\"/sse\\\", \\\"sessionConcurrencyPerInstance\\\":20}",
"idleTimeout": 100,
"disableInjectCredentials": "Env",
"polarFsConfig": {
"groupId": 0,
"userId": 0,
"mountPoints": [
{
"extraOptions": "--skip-delete-rows-check=false --skip-dir-nlink=0 ",
"instanceId": "pfs-xxx",
"mountDir": "/mnt/polarfs",
"readOnly": false,
"remoteDir": "/share"
}
]
},
"lockInfo": {
"lockedBy": "AgentRun",
"lockedAt": "2025-04-05T10:00:00Z",
"lockedResources": [
""
]
},
"juiceFsConfig": {
"mountPoints": [
{
"volumeName": "",
"mountDir": "",
"remoteDir": "",
"token": "",
"args": [
""
]
}
],
"envs": {
"key": ""
}
},
"microSandboxConfig": {
"osType": "",
"startCommand": "",
"readyCommand": "",
"registryConfig": {
"authConfig": {
"password": "abc***",
"userName": "admin"
},
"certConfig": {
"insecure": true,
"rootCaCertBase64": "cm9vdF9jYV9jZXJ0"
},
"networkConfig": {
"securityGroupId": "sg-xxxxxxxxxxxxxx",
"vSwitchId": "vsw-xxxxxxxxxxxxxx",
"vpcId": "vpc-xxxxxxxxxxxxxx"
}
},
"image": "",
"acrInstanceId": ""
}
}Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.