CreateMountTarget - : Central de Documentação do Alibaba Cloud

Descrição

A criação do ponto de montagem não ocorre imediatamente após a chamada à operação CreateMountTarget. Por isso, recomendamos chamar a operação DescribeMountTargets para consultar o status do ponto de montagem. Monte o sistema de arquivos somente quando o ponto de montagem estiver no estado Active. Caso contrário, a montagem poderá falhar.
Ao executar esta operação, o sistema cria automaticamente uma função vinculada ao serviço do NAS. Para mais informações, consulte Gerenciar as funções vinculadas ao serviço do NAS.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos executar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	CreateMountTarget	Operação a ser executada. Defina o valor como CreateMountTarget.
FileSystemId	String	Sim	174494****	ID do sistema de arquivos. Exemplo de ID de sistema de arquivos NAS de uso geral: 31a8e4**. IDs de sistemas de arquivos NAS Extreme devem começar com `extreme-`. Exemplo: extreme-0015. IDs de sistemas de arquivos Cloud Parallel File Storage (CPFS) devem começar com `cpfs-`. Exemplo: cpfs-125487. Nota** Sistemas de arquivos CPFS estão disponíveis apenas no site da China (aliyun.com).
AccessGroupName	String	Não	classic-test	Nome do grupo de permissões. Parâmetro obrigatório para criar um ponto de montagem em sistemas de arquivos NAS de uso geral ou NAS Extreme. Grupos de permissões padrão: DEFAULT_VPC_GROUP_NAME (grupo de permissões padrão para VPCs) e DEFAULT_CLASSIC_GROUP_NAME (grupo de permissões padrão para a rede clássica).
NetworkType	String	Sim	Vpc	Tipo de rede do ponto de montagem. Valores válidos: Vpc: nuvem privada virtual (VPC) Classic: rede clássica
VpcId	String	Não	vpc-2zesj9afh3y518k9o****	ID da VPC. Parâmetro válido e obrigatório se o ponto de montagem residir em uma VPC. Exemplo: Se definir o parâmetro NetworkType como VPC, especifique o parâmetro VpcId.
VSwitchId	String	Não	vsw-2zevmwkwyztjuoffg****	ID do vSwitch. Parâmetro válido e obrigatório se o ponto de montagem residir em uma VPC. Exemplo: Se definir o parâmetro NetworkType como VPC, especifique o parâmetro VSwitchId.
SecurityGroupId	String	Não	sg-bp1fg655nh68xyz9****	ID do grupo de segurança.
EnableIpv6	Boolean	Não	true	Indica se deve criar um nome de domínio IPv6 para o ponto de montagem. Valores válidos: true: cria um nome de domínio IPv6 para o ponto de montagem. false (valor padrão): não cria nome de domínio IPv6 para o ponto de montagem. Nota Apenas sistemas de arquivos NAS Extreme localizados na China continental suportam IPv6. Para criar um nome de domínio IPv6 para o ponto de montagem, ative o IPv6 no sistema de arquivos.
DryRun	Boolean	Não	false	Indica se deve verificar a existência de pontos de montagem. Este parâmetro é válido apenas para sistemas de arquivos CPFS. Se definido como true, o sistema verifica a validade dos parâmetros da solicitação e a disponibilidade dos recursos solicitados. Nesse caso, o sistema não cria o ponto de montagem nem gera cobranças. true: executa uma pré-verificação sem criar o ponto de montagem. O sistema valida o formato da solicitação, os limites do serviço, a disponibilidade de recursos CPFS e a especificação dos parâmetros obrigatórios. Se a solicitação falhar na pré-verificação, o sistema retorna uma mensagem de erro. Se passar, retorna o código de status HTTP `200`, sem valor para o parâmetro `MountTargetDomain`. false (valor padrão): envia a solicitação. Se a solicitação passar na pré-verificação, o sistema cria o ponto de montagem.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	70EACC9C-D07A-4A34-ADA4-77506C42****	ID da solicitação.
MountTargetDomain	String	174494b666-x****.cn-hangzhou.nas.aliyuncs.com	Nome de domínio IPv4 do ponto de montagem.
MountTargetExtra	Object		Lista de pontos de montagem.
DualStackMountTargetDomain	String	174494b666-x****.dualstack.cn-hangzhou.nas.aliyuncs.com	Nome de domínio de pilha dupla (IPv4 e IPv6) do ponto de montagem.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=CreateMountTarget
&FileSystemId=174494****
&AccessGroupName=classic-test
&NetworkType=Vpc
&VpcId=vpc-2zesj9afh3y518k9o****
&VSwitchId=vsw-2zevmwkwyztjuoffg****
&SecurityGroupId=sg-bp1fg655nh68xyz9****
&EnableIpv6=true
&DryRun=false
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateMountTargetResponse>
    <RequestId>70EACC9C-D07A-4A34-ADA4-77506C42****</RequestId>
    <MountTargetDomain>174494b666-x****.cn-hangzhou.nas.aliyuncs.com</MountTargetDomain>
    <MountTargetExtra>
        <DualStackMountTargetDomain>174494b666-x****.dualstack.cn-hangzhou.nas.aliyuncs.com</DualStackMountTargetDomain>
    </MountTargetExtra>
</CreateMountTargetResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "70EACC9C-D07A-4A34-ADA4-77506C42****",
  "MountTargetDomain" : "174494b666-x****.cn-hangzhou.nas.aliyuncs.com",
  "MountTargetExtra" : {
    "DualStackMountTargetDomain" : "174494b666-x****.dualstack.cn-hangzhou.nas.aliyuncs.com"
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
202	RequestAccepted	The request has been accepted by the server.	Mensagem retornada porque o backend aceitou a solicitação.
400	InvalidFileSystem.NotsupportedIPv6	The file system does not support IPv6.	Mensagem de erro retornada porque o sistema de arquivos não suporta IPv6.
400	InvalidVSwitch.Ipv6NotTurnOn	The VSwitch you are currently using has not enabled the IPv6 function. Please enable this function first and try again.	Mensagem de erro retornada porque o vSwitch não suporta IPv6. Ative o IPv6 e tente novamente.
400	IdempotentParameterMismatch	The same client token was passed in to different parameters.	Mensagem de erro retornada porque o mesmo token de cliente foi especificado em solicitações diferentes.
400	MissingParameter.AccessGroupName	You must specify AccessGroupName when you create a standard or extreme file system mount target.	Mensagem de erro retornada devido à falta do parâmetro AccessGroupName. Este parâmetro é obrigatório para criar um ponto de montagem em sistemas de arquivos NAS de uso geral ou NAS Extreme.
400	InvalidVSwitchId.IpNotEnough	The number of the specified VSwitch IP address is insufficient.	Mensagem de erro retornada porque os endereços IP disponíveis no bloco CIDR do vSwitch especificado são insuficientes.
400	InvalidParameter.ConflictVpcCidr	The specified VPC CIDR conflicts with the server.	Mensagem de erro retornada porque o bloco CIDR da VPC especificada entra em conflito com o servidor.
400	DryRunOperation	The request is validated with DryRun flag set.	Mensagem retornada porque a solicitação foi validada.
400	SubAccount.NoStandardSLRPermission	The RAM user does not have the permission to create service linked role AliyunServiceRoleForNasStandard. Please authorize the RAM user the permission ram:CreateServiceLinkedRole.	Mensagem de erro retornada porque o usuário RAM atual não tem autorização para criar a função vinculada ao serviço AliyunServiceRoleForNasStandard. Conceda a permissão ram:CreateServiceLinkedRole ao usuário RAM.
403	OperationDenied.InvalidState	The operation is not permitted when the status is processing.	Mensagem de erro retornada porque o sistema de arquivos está em um estado inválido.
403	InvalidRamRole.NotExist	The specified RAM role does not exist.	Mensagem de erro retornada porque a função RAM especificada não existe.
403	InvalidRamRole.NoPermission	The specified RAM role does not have sufficient permission.	Mensagem de erro retornada porque a função RAM especificada não possui as permissões necessárias para criar um ponto de montagem.
403	InvalidMountTarget.AlreadyExisted	The specified mount target already exists.	Mensagem de erro retornada porque o ponto de montagem especificado já existe.
403	Resource.OutOfStock	The inventory of the specified zone is insufficient.	Mensagem de erro retornada porque os recursos disponíveis na zona especificada são insuficientes.
403	OperationDenied.MountTargetExceedLimit	The maximum number of mount target in the specified file system is exceeded.	Mensagem de erro retornada porque o número máximo de pontos de montagem foi atingido.
404	InvalidParameter.VswNotFound	The specified VSwitch does not exist.	Mensagem de erro retornada porque o vSwitch especificado não existe.
404	InvalidParameter.VpcNotFound	The specified VPC does not exist.	Mensagem de erro retornada porque a VPC especificada não existe.
404	InvalidFileSystem.NotFound	The specified file system does not exist.	Mensagem de erro retornada porque o sistema de arquivos especificado não existe.

Para obter uma lista de códigos de erro, visite o API Error Center.