CreateSession - Function Compute: Central de Documentação do Alibaba Cloud

Cria um recurso de sessão explícito. O sistema gera automaticamente um ID de sessão exclusivo, pré-aloca uma instância de função e vincula a instância à sessão. Você pode especificar o TTL e o tempo limite de ociosidade. Esta operação se aplica aos tipos de afinidade HEADER_FIELD ou GENERATED_COOKIE para implementar o warm-up de sessão e a inicialização de configuração. Após a criação da sessão, você pode incluir o ID da sessão nas solicitações InvokeFunction para rotear as solicitações.

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:CreateSession

create

*Todos os recursos.

*

Nenhuma

Sintaxe da solicitação

POST /2023-03-30/functions/{functionName}/sessions HTTP/1.1

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
functionName	string	Não	O nome da função para a qual criar uma sessão.	my-func

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
qualifier	string	Não	A versão ou o alias da função.	aliasName1
body	CreateSessionInput	Não	A configuração para a criação de uma sessão.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	Session	As informações do recurso de sessão.

Exemplos

Resposta de sucesso

JSON formato

{
  "allowInternetAccess": false,
  "autoPauseFileSystemOnly": false,
  "containerId": "c-68999e02-16a1955c-d2a03d1ccs",
  "createdTime": "2025-04-01T08:15:27Z",
  "disableSessionIdReuse": false,
  "enableAutoPause": false,
  "enableAutoResume": false,
  "functionName": "functionName1",
  "juiceFsConfig": {
    "envs": {
      "key": ""
    },
    "mountPoints": [
      {
        "args": [
          ""
        ],
        "mountDir": "",
        "remoteDir": "",
        "token": "",
        "volumeName": ""
      }
    ]
  },
  "lastModifiedTime": "2025-04-01T18:15:27Z",
  "nasConfig": {
    "groupId": 100,
    "mountPoints": [
      {
        "enableTLS": true,
        "mountDir": "/home/test",
        "serverAddr": "***-uni85.cn-hangzhou.nas.com:/"
      }
    ],
    "userId": 100
  },
  "network": {
    "allowOut": [
      ""
    ],
    "allowPublicTraffic": false,
    "denyOut": [
      ""
    ],
    "maskRequestHost": "",
    "rules": {
      "key": [
        {
          "transform": {
            "headerValueReplacements": [
              {
                "placeholder": "sbx-notion-key-0001",
                "value": "ntn_real_secret_xxx"
              }
            ],
            "headers": {
              "key": ""
            }
          }
        }
      ]
    }
  },
  "ossMountConfig": {
    "mountPoints": [
      {
        "bucketName": "my-bucket",
        "bucketPath": "/my-dir",
        "endpoint": "http://oss-cn-shanghai.aliyuncs.com",
        "mountDir": "/mnt/dir",
        "readOnly": true
      }
    ]
  },
  "polarFsConfig": {
    "groupId": 0,
    "mountPoints": [
      {
        "extraOptions": "--skip-delete-rows-check=false  --skip-dir-nlink=0 ",
        "instanceId": "pfs-xxx",
        "mountDir": "/mnt/polarfs",
        "readOnly": false,
        "remoteDir": "/share"
      }
    ],
    "userId": 0
  },
  "qualifier": "AliasName1",
  "sessionAffinityType": "HEADER_FIELD",
  "sessionId": "81f70ae156904eb9b7d43e12f511fe58",
  "sessionIdleTimeoutInSeconds": 1800,
  "sessionStatus": "Active",
  "sessionTTLInSeconds": 21600,
  "trafficAccessToken": ""
}

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.