ListAccessPoints - File Storage NAS: Central de Documentação do Alibaba Cloud

Consulta informações de pontos de acesso.

Descrição da operação

Apenas sistemas de arquivos NFS do NAS de uso geral são suportados.

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

nas:ListAccessPoints

list

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
FileSystemId	string	Sim	O ID do sistema de arquivos.	0913nx15amuix9a****
Filters	array<object>	Não	As informações de filtro.
	object	Não	As informações de filtro.
Name	string	Não	O nome da chave de filtro. Valores válidos: AccessGroup (não suportado para agentic) AccessPointId AgenticSpaceId Valores válidos: AccessGroup : Nome do grupo de permissões. AccessPointId : ID do ponto de acesso. AgenticSpaceId : ID do espaço agentic.	AccessPointId
Value	string	Não	O valor da chave de filtro.	TestValue
NextToken	string	Não	O token de consulta. Defina este parâmetro com o valor de NextToken retornado na chamada de API anterior.	MTY4NzcxOTcwMjAzMDk2Nzc0MyM4MDM4****
MaxResults	integer	Não	O número máximo de resultados a serem retornados por consulta. Valor máximo: 100. Valor mínimo: 10. Valor padrão: 20.	10

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	98696EF0-1607-4E9D-B01D-F20930B6****
AccessPoints	array<object>	As informações do ponto de acesso.
	array<object>	As informações do ponto de acesso.
ARN	string	O ARN do ponto de acesso.	acs:nas:cn-hangzhou:178321033379**:accesspoint/ap-ie15yd**
AccessGroup	string	O nome do grupo de permissões.	DEFAULT_VPC_GROUP_NAME
AccessPointId	string	O ID do ponto de acesso.	ap-ie15y*****
AccessPointName	string	O nome do ponto de acesso.	test
CreateTime	string	A hora em que o ponto de acesso foi criado. A hora segue o padrão ISO 8601 em UTC. Formato: yyyy-MM-ddTHH:mm:ssZ.	2026-03-28T06:32:14Z
DomainName	string	O nome de domínio do ponto de acesso.	ap-ie15ydanoz.001014**-w**.cn-hangzhou.nas.aliyuncs.com
EnabledRam	boolean	Indica se a política RAM está ativada.	false
FileSystemId	string	O ID do sistema de arquivos.	091yj49baxscll2****
ModifyTime	string	A hora em que o ponto de acesso foi modificado pela última vez. A hora segue o padrão ISO 8601 em UTC. Formato: yyyy-MM-ddTHH:mm:ssZ.	2026-06-24T02:10:23Z
PosixUser	object	O usuário POSIX.
PosixGroupId	integer		10
PosixUserId	integer		156
PosixSecondaryGroupIds	array
	integer		[100,123]
RootPath	string	O diretório raiz.	/
RootPathPermission	object	A permissão do diretório raiz.
OwnerGroupId	integer		12
OwnerUserId	integer		1
Permission	string		0755
RootPathStatus	string	O status atual do diretório raiz. Valores válidos: 0: O status do caminho raiz é desconhecido. 1: O caminho raiz não existe. Ele pode ter sido excluído pelo usuário. 2: O status do caminho raiz é normal.	2
Status	string	O status atual do ponto de acesso. Valores válidos: Active: Disponível. Inactive: Indisponível. Pending: Sendo criado. Deleting: Sendo excluído. Nota Você só pode montar um sistema de arquivos quando o status for Active.	Active
VSwitchId	string	O ID do vSwitch.	vsw-2zevmwkwyztjuoffg****
VpcId	string	O ID da VPC.	vpc-2zesj9afh3y518k9o****
Tags	array<object>	A lista de tags do ponto de acesso.
	object	A lista de tags do ponto de acesso.
Key	string		TestKey
Value	string		TestValue
AgenticSpaceId	string	O ID do AgenticSpace.	agentic-229oypxjgpau2****
CreateTimeUtc	string	A hora em que o espaço agentic foi criado. A hora segue o padrão ISO 8601. Formato: yyyy-MM-ddTHH:mm:ssZ.	2026-06-10T10:08:08Z
ModifyTimeUtc	string	A hora em que o espaço agentic foi modificado pela última vez. A hora segue o padrão ISO 8601. Formato: yyyy-MM-ddTHH:mm:ssZ.	2026-06-10T10:08:08Z
NextToken	string	O token de consulta. Defina este parâmetro com o valor de NextToken retornado na chamada de API anterior.	52frCAAAAABoZS90cm****==
TotalCount	integer	O número total de pontos de acesso.	20

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****",
  "AccessPoints": [
    {
      "ARN": "acs:nas:cn-hangzhou:178321033379****:accesspoint/ap-ie15yd****",
      "AccessGroup": "DEFAULT_VPC_GROUP_NAME",
      "AccessPointId": "ap-ie15y*****\n",
      "AccessPointName": "test",
      "CreateTime": "2026-03-28T06:32:14Z",
      "DomainName": "ap-ie15ydanoz.001014****-w****.cn-hangzhou.nas.aliyuncs.com",
      "EnabledRam": false,
      "FileSystemId": "091yj49baxscll2****",
      "ModifyTime": "2026-06-24T02:10:23Z",
      "PosixUser": {
        "PosixGroupId": 10,
        "PosixUserId": 156,
        "PosixSecondaryGroupIds": [
          0
        ]
      },
      "RootPath": "/",
      "RootPathPermission": {
        "OwnerGroupId": 12,
        "OwnerUserId": 1,
        "Permission": "0755"
      },
      "RootPathStatus": "2",
      "Status": "Active",
      "VSwitchId": "vsw-2zevmwkwyztjuoffg****\n",
      "VpcId": "vpc-2zesj9afh3y518k9o****\n",
      "Tags": [
        {
          "Key": "TestKey",
          "Value": "TestValue"
        }
      ],
      "AgenticSpaceId": "agentic-229oypxjgpau2****",
      "CreateTimeUtc": "2026-06-10T10:08:08Z",
      "ModifyTimeUtc": "2026-06-10T10:08:08Z"
    }
  ],
  "NextToken": "52frCAAAAABoZS90cm****==",
  "TotalCount": 20
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidFilesystemType.NotSupport	The API operation does not support the file system type.	A operação atual não suporta este tipo de sistema de arquivos.
403	InvalidProtocolType.NotSupported	The specified protocol type does not supported.	O tipo de protocolo especificado não é suportado.
404	InvalidFileSystem.NotFound	The specified file system does not exist.	O sistema de arquivos especificado não existe.
404	InvalidAccessGroup.NotFound	The specified AccessGroup does not exist.	O grupo de permissões especificado não existe ou foi excluído.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.