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

Consulta os canais de armazenamento virtual associados a um sistema de arquivos.

Descrição da operação

Apenas o CPFS for Lingjun oferece suporte a este recurso. Para usar o CPFS for Lingjun, você deve primeiro enviar um ticket para solicitar a inclusão na lista de permissões do serviço e, em seguida, criar um sistema de arquivos no console do NAS.
A execução em lote é suportada. Na execução em lote, apenas um VscId pode ser associado a vários FileSystemIds. Isso significa que os valores de ResourceIds.VscId devem ser idênticos.
Para consultar os resultados da associação entre sistemas de arquivos e canais de armazenamento virtual, você deve primeiro chamar AttachVscToFilesystems para concluir a associação. Você pode chamar a operação ListVscs do Lingjun AI Computing Service eflo-controller/2022-12-15 para consultar o VscId. Se um VSC não for criado, você pode chamar CreateVsc para criar um.

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

list

*FileSystem.

acs:nas:{#regionId}:{#accountId}:filesystem/{#filesystemId}

*Vsc.

acs:eflo:{#regionId}:{#accountId}:vsc/{#VscId}

Nenhuma

Sintaxe da solicitação

POST  HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ResourceIds	array<object>	Sim	Os IDs dos sistemas de arquivos e dos canais de armazenamento virtual. Um máximo de 10 itens pode ser especificado em cada lote.
	object	Não	Os IDs dos sistemas de arquivos e dos canais de armazenamento virtual. Um máximo de 10 itens pode ser especificado em cada lote.
FileSystemId	string	Não	O ID do sistema de arquivos. Este parâmetro é obrigatório em cada entrada de ResourceIds e deve ser fornecido junto com VscId.	bmcpfs-290t15yn4uo8lid****
VscId	string	Não	O ID do canal de armazenamento virtual. Este parâmetro é obrigatório em cada entrada de ResourceIds e deve ser fornecido junto com FileSystemId. O ID começa com vsc-. Você pode chamar a operação ListVscs do Lingjun AI Computing Service eflo-controller/2022-12-15 para consultar o ID. Se um VSC não for criado, você pode chamar CreateVsc para criar um.	vsc-8vb864o3ppwfvh****
NextToken	string	Não	O token de consulta. O valor é o valor de NextToken retornado pela chamada de API anterior.	TGlzdFJlc291cmNlU****mVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0=
MaxResults	integer	Não	O número de entradas a serem retornadas por página. Valores válidos: 10 a 100. Valor padrão: 10.	10
RoleChain	array<object>	Não	A cadeia de funções. Nota Este parâmetro é obrigatório apenas em cenários de contas cruzadas.
	object	Não
RoleType	string	Não	O tipo de função. Valores válidos: service e user.	service
RoleArn	string	Não	O descritor de recurso da função especificada. Formato: acs:ram::$accountID:role/$roleName.	acs:ram::123472233814**:role/aliyunnasclientvsc**
AssumeRoleFor	string	Não	O UID da conta Alibaba Cloud, que especifica a conta Alibaba Cloud para a qual o serviço assume a função.	101522855006****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	BC7C825C-5F65-4B56-BEF6-98C56C7C****
NextToken	string	O token de consulta. O valor é o valor de NextToken retornado pela chamada de API anterior.	TGlzdFJlc291cmNlU****mVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0=
TotalCount	integer	O número total de registros de associação.	1
MaxResults	integer	O número de entradas retornadas por página. Valores válidos: 10 a 1000. Valor padrão: 10.	10
VscAttachInfo	object
VscAttachInfo	array<object>	A coleção de dados usada para associar sistemas de arquivos e canais de armazenamento virtual.
	object
FileSystemId	string	O ID do sistema de arquivos.	bmcpfs-290t15yn4uo8lid****
VscId	string	O ID do canal de armazenamento virtual.	vsc-8vb864o3ppwfvh****
Status	string	O status da associação do sistema de arquivos ao canal de armazenamento virtual. Valores válidos: Attaching: A operação de associação está em andamento. Attached: A operação de associação foi concluída. Detaching: A operação de desassociação está em andamento. Detached: A operação de desassociação foi concluída. Failed: A operação de associação falhou.	Attached

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "BC7C825C-5F65-4B56-BEF6-98C56C7C****",
  "NextToken": "TGlzdFJlc291cmNlU****mVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0=",
  "TotalCount": 1,
  "MaxResults": 10,
  "VscAttachInfo": {
    "VscAttachInfo": [
      {
        "FileSystemId": "bmcpfs-290t15yn4uo8lid****\n",
        "VscId": "vsc-8vb864o3ppwfvh****\n",
        "Status": "Attached"
      }
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParameter	The parameter is invalid.	O parâmetro especificado é inválido.
400	InvalidParameter.ResourceIds	Invalid ResourceIds, can not be empty or batch size large than 10.	O parâmetro ResourceIds é inválido. Ele não pode estar vazio e o tamanho do lote não pode exceder 10.
400	InvalidParameter.FileSystem	Invalid FileSystem in ResourceIds.	O sistema de arquivos especificado em ResourceIds é inválido.
400	InvalidFilesystemType.NotSupport	This Api does not support this fileSystem type.	A operação de API atual não oferece suporte a este tipo de sistema de arquivos.
400	InvalidParameter.VscId	Invalid VscId in ResourceIds.	O VscId em ResourceIds é inválido.
400	InvalidParameter.VscIds	Invalid VscId in ResourceIds.VscIds must be the same.	O VscId em ResourceIds é inválido. Os VscIds devem ser idênticos.
400	Ram.AddRamParamFailed	Ram check has failed due to param invalid, please check param.	A verificação do RAM falhou devido a parâmetros inválidos. Verifique os parâmetros.
400	FeatureOrAPI.NotSupported	The Feature/API is not supported in this region now.	A funcionalidade ou API não é suportada nesta região.
403	Forbbiden.Ram	User not authorized to operate on the specified resource, or this API doesn't support RAM.	A verificação de permissão do RAM para a sua conta falhou. Acesse o console do RAM para garantir que as permissões relacionadas ao NAS sejam concedidas.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.