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

Obtém os detalhes de uma sessão especificada, incluindo o ID da sessão, a função associada, o tipo de afinidade, a configuração de ciclo de vida, o status e as informações da instância. Esta operação consulta os metadados atuais de uma única sessão e suporta filtragem precisa pelos parâmetros functionName e qualifier para facilitar o monitoramento e a depuração por sistemas externos. Apenas sessões no estado Active podem ser consultadas.

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

get

*Todos os recursos.

*

Nenhuma

Sintaxe da solicitação

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

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
functionName	string	Não	O nome da função à qual a sessão pertence.	myFunction
sessionId	string	Não	O ID da sessão a ser consultada.	test-sessionid-index1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
qualifier	string	Não	O alias ou a versão da função associada ao ID da sessão a ser consultada.	aliasName1

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	Session	As informações da sessão da funçã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.