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

Consulta os detalhes de um ponto de acesso.

Descrição da operação

Apenas sistemas de arquivos NAS de uso geral que utilizam o protocolo NFS suportam este recurso.

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

get

*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.	31a8e4****
AccessPointId	string	Sim	O ID do ponto de acesso.	ap-ie15yd****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
AccessPoint	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.	test.
AccessPointId	string	O ID do ponto de acesso.	ap-ie15yd****
AccessPointName	string	O nome do ponto de acesso.	test.
CreateTime	string	A hora em que o ponto de acesso foi criado. Formato: timestamp Unix/POSIX.	1709619668276167
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.	31a8e4****
ModifyTime	string	A hora em que o ponto de acesso foi modificado pela última vez. Formato: timestamp Unix/POSIX.	1709619668276167
RootPathPermission	object	As permissões de criação do diretório raiz.
OwnerGroupId	integer	O ID do grupo de arquivos.	123
OwnerUserId	integer	O ID do proprietário do arquivo.	1
Permission	string	As permissões POSIX.	0755
PosixUser	object	O usuário POSIX.
PosixGroupId	integer	O ID do grupo de usuários POSIX.	12
PosixUserId	integer	O ID do usuário POSIX.	123
PosixSecondaryGroupIds	array	O ID do grupo de usuários secundário.
	integer	O ID do grupo de usuários secundário.	[123,123]
RootPath	string	O diretório raiz.	/
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.	Active.
VSwitchId	string	O ID do vSwitch.	vsw-2zevmwkwyztjuoffg****
VpcId	string	O ID da VPC. A VPC deve ser a mesma VPC do servidor Elastic Computing Service (ECS) a ser montado.	vpc-2zesj9afh3y518k9o****
Tags	array<object>	A lista de tags do ponto de acesso.
	object	A lista de tags do ponto de acesso.
Key	string	A chave da tag.	TestKey
Value	string	O valor da tag.	TestValue
RegionId	string	O ID da região.	cn-hangzhou.
AgenticSpaceId	string	O ID do AgenticSpace.	agentic-229oypxjgpau2****
CreateTimeUtc	string	A hora em que o ponto de acesso foi criado. A hora segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ.	2026-06-10T10:08:08Z
ModifyTimeUtc	string	A hora em que o ponto de acesso foi modificado pela última vez. A hora segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ.	2026-06-10T10:08:08Z

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "AccessPoint": {
    "ARN": "acs:nas:cn-hangzhou:178321033379****:accesspoint/ap-ie15yd****",
    "AccessGroup": "test\n",
    "AccessPointId": "ap-ie15yd****\n",
    "AccessPointName": "test",
    "CreateTime": "1709619668276167",
    "DomainName": "ap-ie15ydanoz.001014****-w****.cn-hangzhou.nas.aliyuncs.com",
    "EnabledRam": false,
    "FileSystemId": "31a8e4****",
    "ModifyTime": "1709619668276167",
    "RootPathPermission": {
      "OwnerGroupId": 123,
      "OwnerUserId": 1,
      "Permission": "0755"
    },
    "PosixUser": {
      "PosixGroupId": 12,
      "PosixUserId": 123,
      "PosixSecondaryGroupIds": [
        0
      ]
    },
    "RootPath": "/",
    "RootPathStatus": "2",
    "Status": "Active",
    "VSwitchId": "vsw-2zevmwkwyztjuoffg****",
    "VpcId": "vpc-2zesj9afh3y518k9o****",
    "Tags": [
      {
        "Key": "TestKey",
        "Value": "TestValue"
      }
    ],
    "RegionId": "cn-hangzhou",
    "AgenticSpaceId": "agentic-229oypxjgpau2****",
    "CreateTimeUtc": "2026-06-10T10:08:08Z",
    "ModifyTimeUtc": "2026-06-10T10:08:08Z"
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
404	InvalidAccessPointId.NotFound	The access point id does not exist.	O APid especificado não existe.
404	InvalidFileSystem.NotFound	The specified file system does not exist.	O sistema de arquivos especificado não existe.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.