If an error occurs when you call an Apsara File Storage NAS API operation, an error code is returned.

Components of an error code

The following table describes the components of an error code.

ComponentDescription
HttpCodeThe HTTP status code that complies with the HTTP syntax.
CodeThe error ID.
MessageThe error message.
AdviceThe recommended solution.

Error codes

HttpCodeCodeMessageAdvice
500InternalErrorThe request processing has failed due to some unknown error.Try again later. If the issue persists after you try again, contact NAS technical support.
503ServiceUnavailableThe request has failed due to a temporary failure of the server.The request failed due to an unexpected error. Try again later.
504ServiceTimeoutThe request processing has failed due to timeout.Try again later.
503SecurityToken.CheckFailedThe security token check has failed due to some internal error.The system failed to authenticate the Security Token Service (STS) token due to the failure of an internal call. Try again later.
503SecurityToken.DecodeFailedThe security token decode has failed due to some internal error.The system failed to decode the STS token due to the failure of an internal call. Try again later.
503SubRam.CheckFailedThe sub user ram check has failed due to some internal error.The system failed to authenticate the Alibaba Cloud account or the RAM user due to the failure of an internal call. Try again later.
503VpcRam.CheckFailedThe Vpc ram check has failed due to some internal error.The system failed to authenticate the client that attempts to access the file system over the virtual private cloud (VPC) due to the failure of an internal call. Try again later.
503VpcSubRam.CheckFailedThe Vpc sub user ram check has failed due to some internal error.The system failed to authenticate the Alibaba Cloud account and the RAM user due to the failure of an internal call. Try again later.
400MissingParameter.callerUidParameter `callerUid` is mandatory for this action.Specify a valid value for the callerUid parameter.
400MissingParameter.RegionIdParameter `RegionId` in endpoint is mandatory for this action.Specify a valid endpoint for the RegionId parameter.
400MissingParameter.VSwitchIdParameter `VSwitchId` is mandatory for this action.Specify a valid value for the VSwitchId parameter.
400MissingParameter.VpcIdParameter `VpcId` is mandatory for this action.Specify a valid value for the VpcId parameter.
400InvalidParameter.StorageTypeParameter `StorageType` is mandatory for this action.The valid values of the StorageType parameter are Performance and Capacity.
400InvalidParameter.ProtocalTypeParameter ProtocalType is mandatory for this action.The valid values of the ProtocalType parameter are NFS and SMB.
400InvalidParameter.DescriptionParameter Description is mandatory for this action.The value of the Description parameter can contain letters and the following special characters: at signs (@), number signs (#), dollar signs ($), underscores (_), plus signs (+), and hyphens (-).
404InvalidFileSystem.NotFoundThe specified FileSystem does not exist.The specified file system does not exist or is deleted.
403InvalidFileSystem.AlreadyExistedThe specified FileSystem has been already existed.The specified file system already exists. You can call the DescribeFileSystems operation to query the information about the file system.
404InvalidMountTarget.NotFoundThe specified MountTarget does not exist.The specified mount target does not exist or is deleted.
404InvalidAccessGroup.NotFoundThe specified AccessGroup does not exist.The specified permission group does not exist or is deleted.
403InvalidAccessGroup.AlreadyExistedThe specified AccessGroup has been already existed.The specified permission group already exists. You can call the DescribeMountTargets operation to query the information about the permission group.
403InvalidAccessGroup.AlreadyAttachedThe specified AccessGroup is still attached by some MountTarget(s).One or more mount targets are attached to the specified permission group. Before you delete the permission group, you must detach the mount targets.
404InvalidAccessRule.NotFoundThe specified AccessRule does not exist.The specified rule does not exist or is deleted.
404InvalidLocatin.NotFoundThe specified Location is not found or is not supported.The specified location does not exist or is unavailable.
404InvalidRegionId.NotFoundThe specified Region is not found.The specified region does not exist or is unavailable.
404InvalidAZone.NotFoundThe specified AZone is not found.The specified zone does not exist or is unavailable.
404InvalidVpc.NotFoundThe specified Vpc is not found.The specified VPC does not exist. Create a VPC.
404InvalidVip.NotFoundThe specified Vip is not found.The specified VPC cannot be found. Check whether the information about the VPC is valid.
404InvalidLBid.NotFoundThe specified LBid is not found.The system failed to create the LBid. Try again later.
404InvalidVpcTunnelId.NotFoundThe specified vpc tunnelId is not found.The tunnel ID of the specified VPC does not exist. Check whether the information about the VPC is valid.
404InvalidVpc.CreationFailedThe specified vpc instance creation failed.The system failed to create the specified VPC. Check whether the information about the VPC is valid and whether available IP addresses exist. Try again later.
403OperationDenied.DefaultAccessGroupCannotDeleteThe default AccessGroup can not be deleted.You can modify a custom permission group.
403OperationDenied.DefaultAccessGroupCannotModifyThe default AccessGroup can not be modified.You can modify a custom permission group.
403OperationDenied.NetworkTypeNotMatchedThe NetworkType of MountTarget is not matched with AccessGroup.Make sure that the value of the NetworkType parameter for the mount target is the same as the value of the AccessGroupType parameter for the permission group.
403OperationDenied.MountTargetNotEmptyThere are still MountTarget(s) on the specified FileSystem.One or more mount targets are created for the specified file system. Before you delete the file system, you must delete the mount targets.
403OperationDenied.FileSystemCountsExceededThe amount of FileSystem has reached its limits(maximum 10).

To increase the upper limit, contact NAS technical support.

403OperationDenied.MountTargetCountsExceededThe amount of MountTarget has reached its limits(maximum 2 per FileSystem).To increase the upper limit, contact NAS technical support.
403OperationDenied.AccessGroupCountsExceededThe amount of AccessGroup has reached its limits.To increase the upper limit, contact NAS technical support.
403OperationDenied.AccessRuleCountsExceededThe amount of AccessRule has reached its limits.To increase the upper limit, contact NAS technical support.
403User.DisabledYour account does not open Nas Service yet or balance is insufficient.

If NAS is not activated, activate NAS.

403Forbidden.InvalidUserTypeThe operation is not permitted due to type of account.The NAS API operation does not support your account type.
403Forbidden.RamUser not authorized to operate on the specified resource, or this API doesn't support RAM.The system failed to authenticate the RAM user. Go to the Resource Access Management (RAM) console and grant the RAM user the permissions to access NAS resources.
403Forbidden.EcsTokenNotAuthorizedUser not authorized to check ecs on creating MountTarget of classic network type.Go to the RAM console and grant NAS the permissions to call the verification API operations of Elastic Compute Service (ECS).
403NotQualifiedUser has not been approved for the trail application.

We recommend that you apply for a free trial of the new features. If your application is pending approval for a long period of time, contact NAS technical support.

Sample responses

  • XML format

    <?xml version="1.0" encoding="UTF-8"?>
    <Error>
      <RequestId>B71B4C68-6C6B-4D4B-AD70-8951BD7D188E</RequestId>
      <HostId>nas.cn-hangzhou.aliyuncs.com</HostId>
      <Code>InvalidFileSystem.NotFound</Code>
      <Message>The specified file system does not exist.</Message>
    </Error>
    
                        
  • JSON format

    {
      "RequestId": "B71B4C68-6C6B-4D4B-AD70-8951BD7D188E",
      "HostId": " nas.cn-hangzhou.aliyuncs.com ",
      "Code": "InvalidFileSystem.NotFound",
      "Message": "The specified file system does not exist."
    }