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

Consulta informações de pontos de acesso.

Nota

Esta API foi descontinuada. Recomendamos migrar para NAS(2017-06-26) - ListAccessPoints para funcionalidade aprimorada e suporte contínuo. Embora a API descontinuada permaneça temporariamente acessível, nenhuma atualização ou correção de bugs será fornecida.

Descrição da operação

Apenas sistemas de arquivos NFS do NAS de uso geral 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:DescribeAccessPoints

list

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
FileSystemId	string	Não	O ID do sistema de arquivos.	174494****
AccessGroup	string	Não	O nome do grupo de permissões. Este parâmetro é obrigatório se o sistema de arquivos for um sistema de arquivos NAS de uso geral. Grupo de permissões padrão: DEFAULT_VPC_GROUP_NAME (o grupo de permissões padrão para VPCs).	DEFAULT_VPC_GROUP_NAME.
MaxResults	integer	Não	O número de resultados por consulta. Valores válidos: 10 a 100. Valor padrão: 10.	10
Tag	array<object>	Não	A lista de tags de ponto de acesso.
	object	Não	A lista de tags de ponto de acesso.
Key	string	Não	A chave da tag. Limites: Valores válidos de N: 1 a 20. A chave da tag pode ter até 128 caracteres de comprimento. A chave da tag não pode começar com aliyun ou acs:. A chave da tag não pode conter http:// ou https://.	TestKey.
Value	string	Não	O valor da tag. Limites: Valores válidos de N: 1 a 20. O valor da tag pode ter até 128 caracteres de comprimento. O valor da tag não pode começar com aliyun ou acs:. O valor da tag não pode conter http:// ou https://.	TestValue.
NextToken	string	Não	O token de consulta. Defina o valor como o valor NextToken retornado na chamada de API anterior.	MTY4NzcxOTcwMjAzMDk2Nzc0MyM4MDM4****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	6299428C-3861-435D-AE54-9B330A00****
AccessPoints	array<object>	As informações do ponto de acesso.
	array<object>
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-ie15y*****
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
PosixUser	object	O usuário POSIX.
PosixGroupId	integer	O ID do grupo POSIX.	12
PosixUserId	integer	O ID do usuário POSIX.	123
PosixSecondaryGroupIds	array	O ID do grupo secundário.
	integer	O ID do grupo secundário.	[123,123]
RootPath	string	O diretório raiz.	/
RootPathPermission	object	A permissão do diretório raiz.
OwnerGroupId	integer	O ID do grupo de arquivos do proprietário.	12
OwnerUserId	integer	O ID de usuário do proprietário.	1
Permission	string	A permissão POSIX.	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 o 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 de ponto de acesso.
	object	A lista de tags de ponto de acesso.
Key	string	A chave da tag.	TestKey
Value	string	O valor da tag.	TestValue
NextToken	string	O token de consulta. Defina o valor como o valor NextToken retornado na chamada de API anterior.	MTY4NzcxOTcwMjAzMDk2Nzc0MyM4MDM4****
TotalCount	integer	O número total de pontos de acesso.	20

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "6299428C-3861-435D-AE54-9B330A00****",
  "AccessPoints": [
    {
      "ARN": "acs:nas:cn-hangzhou:178321033379****:accesspoint/ap-ie15yd****",
      "AccessGroup": "test",
      "AccessPointId": "ap-ie15y*****\n",
      "AccessPointName": "test",
      "CreateTime": "1709619668276167",
      "DomainName": "ap-ie15ydanoz.001014****-w****.cn-hangzhou.nas.aliyuncs.com",
      "EnabledRam": false,
      "FileSystemId": "31a8e4****\n",
      "ModifyTime": "1709619668276167",
      "PosixUser": {
        "PosixGroupId": 12,
        "PosixUserId": 123,
        "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"
        }
      ]
    }
  ],
  "NextToken": "MTY4NzcxOTcwMjAzMDk2Nzc0MyM4MDM4****\n",
  "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.