CreateAccessPoint - File Storage NAS

建立接入點。

介面說明

在使用 CreateAccessPoint 介面建立接入點時部分資源的生成是異步完成的。因此在執行 CreateAccessPoint 介面成功後，請先呼叫 DescribeAccessPoints 或者 DescribeAccessPoint 介面查詢接入點狀態，當接入點狀態為 Active 後再執行掛載檔案系統操作，否則可能會掛載失敗。
僅通用型 NAS NFS 協議檔案系統支援該功能。
如果開啟 RAM 策略（EnabledRam），需要配置對應的 RAM 權限，具體請參考管理接入點。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

nas:CreateAccessPoint

create

*All Resource

*

無

請求參數

名稱	類型	必填	描述	樣本值
FileSystemId	string	是	檔案系統 ID。	31a8e4****
AgenticSpaceId	string	否	AgenticSpace Id。說明 Agentic 檔案系統必傳。	agentic-229oypxjgpau2****
AccessGroup	string	否	權限組名稱。當目標檔案系統為通用型 NAS，此參數必填。預設權限組：DEFAULT_VPC_GROUP_NAME（專有網路預設權限組）。說明 Agentic 檔案系統不支援。	DEFAULT_VPC_GROUP_NAME
VswId	string	是	交換機 ID。	vsw-2zevmwkwyztjuoffg****
VpcId	string	是	專有網路 ID。	vpc-2zesj9afh3y518k9o****
AccessPointName	string	否	接入點名稱。	test
RootDirectory	string	否	接入點根目錄。預設值為"/"，如果接入點目錄不存在，則還需要填寫 OwnerUserId 和 OwnerGroupId 參數。說明僅 Agentic 檔案系統支援。	/
EnabledRam	boolean	否	是否啟用 RAM 策略。取值： true：開啟 false（預設值）：不開啟說明啟用接入點 RAM 策略以後，預設禁止所有 RAM 帳號使用接入點掛載和存取資料，您需要為帳號進行授權開放對應存取權限，並透過接入點進行掛載存取。停用後，接入點允許匿名掛載。關於如何配置接入點權限，關於如何配置接入點權限，請參見配置接入點策略。說明 Agentic 檔案系統時，取值必須為 true。	false
OwnerUserId	integer	否	屬主使用者 ID。當 RootDirectory 目錄不存在時，該參數必填。說明 Agentic 檔案系統不支援。	1
OwnerGroupId	integer	否	屬主使用者群組 ID。當 RootDirectory 目錄不存在時，該參數必填。說明 Agentic 檔案系統不支援。	1
Permission	string	否	POSIX 權限。預設值為"0755"。限制：必須以 0 開頭的四位八進位數字。當填寫 OwnerUserId 和 OwnerGroupId 參數後，此欄位生效。說明 Agentic 檔案系統不支援。	0755
PosixUserId	integer	否	Posix 使用者 ID。說明 Agentic 檔案系統不支援。	123
PosixGroupId	integer	否	Posix 使用者群組 ID。說明 Agentic 檔案系統不支援。	123
PosixSecondaryGroupIds	string	否	第二使用者群組。多個使用者群組 ID 時，使用半形逗號（,）分隔。說明 Agentic 檔案系統不支援。	123,345
Tag	array<object>	否	接入點標籤列表。
	object	否	接入點標籤列表。
Key	string	否	標籤鍵。限制：不允許為空和空字串。最多支援 128 個字元。不能以 aliyun 或 acs:開頭。不能包含 http://和 https://。	TestKey
Value	string	否	標籤值。限制：不允許為空和空字串。最多支援 128 個字元。不能包含 http://和 https://。	TestValue

返回參數

名稱	類型	描述	樣本值
	object	Schema of Response
RequestId	string	請求 ID。	98696EF0-1607-4E9D-B01D-F20930B6****
AccessPoint	object	接入點。
AccessPointDomain	string	接入點網域名稱。	ap-ie15ydanoz.001014**-w**.cn-hangzhou.nas.aliyuncs.com
AccessPointId	string	接入點 ID。	ap-ie15yd****

樣本

正常返回樣本

JSON格式

{
  "RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****\n",
  "AccessPoint": {
    "AccessPointDomain": "ap-ie15ydanoz.001014****-w****.cn-hangzhou.nas.aliyuncs.com",
    "AccessPointId": "ap-ie15yd****"
  }
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊
400	InvalidRequest	The request is invalid.
403	InvalidProtocolType.NotSupported	The specified protocol type does not supported.
403	InvalidRamRole.NotExist	The specified RAM role does not exist.
403	InvalidRamRole.NoPermission	The specified RAM role does not have sufficient permission.
403	OperationDenied.AccessPointCountsExceeded	The maxium number of access point has reached its limits.
404	InvalidAccessGroup.NotFound	The specified AccessGroup does not exist.
404	InvalidFileSystem.NotFound	The specified file system does not exist.
404	InvalidVpc.NotFound	The specified Vpc is not found.
404	InvalidVswitch.NotFound	The specified VSwitch does not exist.

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。