UpdateFunction - : Central de Documentação do Alibaba Cloud

Atualiza as informações da função.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

fc:UpdateFunction

update

*Function.

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

Nenhuma

Sintaxe da solicitação

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

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
serviceName	string	Sim	O nome do serviço.	demoService
functionName	string	Sim	O nome da função.	demoFunction

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
If-Match	string	Não	Usado para garantir que o recurso sendo modificado corresponda ao recurso esperado. O valor é obtido das respostas de CreateFunction, GetFunction e UpdateFunction.	e19d5cd5af0378da05f63f891c7467af
functionUpdateFields	object	Não	A estrutura da solicitação para atualizar uma função.
code	Code	Não	Code oferece suporte a dois métodos para fornecer o pacote de código da função. Você deve usar um e apenas um método em uma única solicitação: Especifique ossBucketName e ossObjectName para referenciar o pacote de código armazenado no OSS. Especifique zipFile como o conteúdo codificado em Base64 do pacote ZIP.
customContainerConfig	CustomContainerConfig	Não	A configuração para o runtime de Custom Container. Após a configuração, a função pode usar uma imagem de contêiner personalizado para executar a função.
layers	array	Não	A lista de camadas. Nota Várias camadas são mescladas em ordem decrescente de índice de array. Os arquivos em uma camada com um índice menor substituem os arquivos com o mesmo nome em uma camada com um índice maior.
	string	Não	O nome do recurso da camada.	layername
description	string	Não	A descrição da função.	test desc
environmentVariables	object	Não	As variáveis de ambiente definidas para a função. Você pode recuperar os valores das variáveis de ambiente dentro da função. Para mais informações, consulte Variáveis de ambiente.
	string	Não	A configuração da variável de ambiente.	{"key":"value"}
handler	string	Não	O ponto de entrada para a execução da função. O formato específico depende da linguagem. Para mais informações, consulte Ponto de entrada da função.	index.handler
memorySize	integer	Não	A especificação de memória da função em MB. O valor deve ser um múltiplo de 64 MB. As especificações de memória variam conforme o tipo de instância da função. Para mais informações, consulte Especificações da instância.	512
runtime	string	Não	O ambiente de runtime de linguagem para a função. Valores válidos: 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 e custom-container. Para mais informações, consulte Ambientes de runtime de função suportados.	python3.9
timeout	integer	Não	O tempo limite para a execução da função em segundos. Valor mínimo: 1. Valor padrão: 3. A função é encerrada se exceder esse limite de tempo.	60
initializationTimeout	integer	Não	O tempo limite para a função inicializadora em segundos. Valor mínimo: 1. Valor padrão: 3. A função inicializadora é encerrada se exceder esse limite de tempo.	60
initializer	string	Não	O ponto de entrada para a execução da função inicializadora. O formato específico depende da linguagem. Para mais informações, consulte Ponto de entrada da função.	index.handler
caPort	integer	Não	A porta de escuta do servidor HTTP para runtimes custom e custom container.	9000
InstanceConcurrency	integer	Não	A concorrência máxima de uma instância.	10
instanceSoftConcurrency	integer	Não	A concorrência suave de uma instância, usada para escalonamento gradual. Quando a concorrência em uma instância excede a concorrência suave, o escalonamento da instância é acionado. Por exemplo, se sua instância iniciar lentamente, você pode definir uma concorrência suave apropriada para iniciar instâncias antecipadamente. O valor deve ser menor ou igual a instanceConcurrency.	5
instanceType	string	Não	O tipo de instância da função. Valores válidos: e1: instância elástica. c1: instância de desempenho. fc.gpu.tesla.1: tipo de instância da série GPU Tesla. fc.gpu.ampere.1: tipo de instância da série GPU Ampere. fc.gpu.ada.1: tipo de instância da série GPU Ada. g1: igual a fc.gpu.tesla.1.	e1
instanceLifecycleConfig	InstanceLifecycleConfig	Não	A configuração do ciclo de vida da instância.
customDNS	CustomDNS	Não	A configuração de DNS personalizado para a função.
customRuntimeConfig	CustomRuntimeConfig	Não	A configuração detalhada para funções de Custom Runtime.
customHealthCheckConfig	CustomHealthCheckConfig	Não	A configuração de verificação de integridade personalizada para a função, aplicável apenas a Custom Runtime e Custom Container.
cpu	number	Não	A especificação de CPU da função em vCPU. O valor deve ser um múltiplo de 0,05 vCPU.	1.5
diskSize	integer	Não	A especificação de disco da função em MB. Valores válidos: 512 MB ou 10240 MB.	512
gpuMemorySize	integer	Não	A especificação de memória GPU da função em MB. O valor deve ser um múltiplo de 1024 MB.	2048
X-Fc-Account-Id	string	Não	O ID da sua conta Alibaba Cloud.	188077086902****
X-Fc-Code-Checksum	string	Não	O valor CRC-64 do pacote de código da função.	1506052139770049xxxx
X-Fc-Date	string	Não	A data de início da invocação da função no formato EEE,d MMM yyyy HH:mm:ss GMT.	Wed, 11 May 2022 09:00:00 GMT
X-Fc-Trace-Id	string	Não	O ID de invocação da função, que corresponde ao requestId na resposta.	test-trace-id

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O valor de retorno da operação de atualização de função.
codeChecksum	string	O valor CRC64 do pacote de código da função.	5434025278388143772
codeSize	integer	O tamanho do pacote de código da função retornado pelo sistema, em bytes.	1024
createdTime	string	A hora em que a função foi criada.	2016-08-15T15:00:00.000+0000
customContainerConfig	CustomContainerConfig	A configuração do runtime de Custom Container. Após essa configuração, a função pode usar uma imagem de contêiner personalizado para executar a função.
layers	array	A lista de camadas. Nota Várias camadas são mescladas em ordem decrescente de índice de array. Os arquivos em uma camada com um índice menor substituem os arquivos com o mesmo nome em uma camada com um índice maior.
	string	O nome do recurso da camada.	md5#layername#version
description	string	A descrição da função.	Esta é uma função de demonstração hello world
environmentVariables	object	As variáveis de ambiente definidas para a função. Você pode recuperar os valores das variáveis de ambiente dentro da função. Para mais informações, consulte Variáveis de ambiente.
	string	A configuração da variável de ambiente.	{"key":"value"}
functionId	string	O ID exclusivo gerado pelo sistema para cada função.	2d28e0e9-9ba5-4eed-8b1a-d3d9cd24****
functionName	string	O nome da função.	demo-function
handler	string	O ponto de entrada de execução da função.	index.handler
lastModifiedTime	string	A hora em que a função foi modificada pela última vez.	2016-08-15T17:00:00.000+0000
memorySize	integer	O tamanho de memória configurado para a função, em MB.	512
runtime	string	O ambiente de runtime de linguagem para a função. Valores válidos: 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 e custom-container. Para mais informações, consulte Ambientes de runtime de função suportados.	python3.9
timeout	integer	O período de tempo limite de execução, em segundos.	10
initializationTimeout	integer	O tempo limite para a função inicializadora em segundos. Valor mínimo: 1. Valor padrão: 3. A função inicializadora é encerrada se exceder esse limite de tempo.	60
initializer	string	O ponto de entrada para a execução da função inicializadora. O formato específico depende da linguagem.	index.handler
caPort	integer	A porta de escuta do servidor HTTP para o runtime Custom Runtime ou Custom Container.	9000
instanceType	string	O tipo de instância da função. Valores válidos: e1: instância elástica. c1: instância de desempenho. fc.gpu.tesla.1: tipo de instância da série GPU Tesla. fc.gpu.ampere.1: tipo de instância da série GPU Ampere. fc.gpu.ada.1: tipo de instância da série GPU Ada. g1: igual a fc.gpu.tesla.1.	e1
instanceSoftConcurrency	integer	A concorrência suave de uma instância, usada para escalonamento gradual. Quando a concorrência em uma instância excede a concorrência suave, o escalonamento da instância é acionado. Por exemplo, se sua instância iniciar lentamente, você pode definir uma concorrência suave apropriada para iniciar instâncias antecipadamente. O valor deve ser menor ou igual a instanceConcurrency.	5
instanceLifecycleConfig	InstanceLifecycleConfig	A configuração do ciclo de vida da instância.
customDNS	CustomDNS	A configuração de DNS personalizado para a função.
customRuntimeConfig	CustomRuntimeConfig	A configuração detalhada para funções de Custom Runtime.
customHealthCheckConfig	CustomHealthCheckConfig	A configuração de verificação de integridade personalizada para a função, aplicável apenas a Custom Runtime e Custom Container.
cpu	number	A especificação de CPU da função em vCPU. O valor deve ser um múltiplo de 0,05 vCPU.	1.5
diskSize	integer	A especificação de disco da função em MB. Valores válidos: 512 MB ou 10240 MB.	512
instanceConcurrency	integer	A concorrência de uma única instância.	10
gpuMemorySize	integer	A especificação de memória GPU da função em MB. O valor deve ser um múltiplo de 1024 MB.	2048
layersArnV2	array	A lista de ARNs de camadas.
	string	O localizador de recursos da camada.	acs:fc:cn-hangzhou:official:layers/Python310/versions/2

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.