すべてのプロダクト
Search
ドキュメントセンター

File Storage NAS:CreateAccessPoint

最終更新日:Oct 16, 2026

アクセスポイントを作成します。

操作説明

  • CreateAccessPoint 操作を呼び出してアクセスポイントを作成すると、一部のリソースが非同期で生成されます。したがって、CreateAccessPoint 操作の呼び出しが成功したら、 DescribeAccessPoints または DescribeAccessPoint 操作を呼び出してアクセスポイントのステータスをクエリしてください。ファイルシステムをマウントする前に、アクセスポイントが Active 状態になるまで待機してください。そうしないと、マウント操作が失敗する可能性があります。

  • この特徴は、汎用 NAS NFS ファイルシステムでのみサポートされています。

  • RAM ポリシー (EnabledRam) を有効にする場合は、対応する RAM 権限を設定する必要があります。詳細については、「アクセスポイントの管理」を参照してください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

nas:CreateAccessPoint

create

*すべてのリソース。

*

なし なし

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

FileSystemId

string

必須

ファイルシステムの ID。

31a8e4****

AgenticSpaceId

string

任意

AgenticSpace の ID。

説明

このパラメーターは、Agentic ファイルシステムでは必須です。

agentic-229oypxjgpau2****

AccessGroup

string

任意

権限グループ名。

このパラメーターは、ターゲットファイルシステムが汎用 NAS ファイルシステムである場合に必須です。

デフォルトの権限グループ: DEFAULT_VPC_GROUP_NAME (VPC のデフォルトの権限グループ)。

説明

このパラメーターは、Agentic ファイルシステムではサポートされていません。

DEFAULT_VPC_GROUP_NAME

VswId

string

必須

vSwitch の ID。

vsw-2zevmwkwyztjuoffg****

VpcId

string

必須

VPC の ID。

vpc-2zesj9afh3y518k9o****

AccessPointName

string

任意

アクセスポイント名。

test

RootDirectory

string

任意

アクセスポイントのルートディレクトリ。 デフォルト値: /。アクセスポイントディレクトリが存在しない場合は、OwnerUserId パラメーターと OwnerGroupId パラメーターも指定する必要があります。

説明

このパラメーターは、Agentic ファイルシステムではサポートされていません。

/

EnabledRam

boolean

任意

RAM ポリシーを有効にするかどうかを指定します。 有効な値:

  • true: 有効。

  • false: 無効。 デフォルト値: false。

説明

アクセスポイントの RAM ポリシーを有効にすると、デフォルトではすべての Resource Access Management (RAM) ユーザーがアクセスポイントを使用したデータのマウントおよびアクセスを拒否されます。アカウントに対応するアクセス権限を付与して、アクセスポイント経由でデータをマウントおよびアクセスできるようにする必要があります。この特徴が無効になっている場合、アクセスポイントは匿名マウントを許可します。アクセスポイント権限の設定方法の詳細については、「アクセスポイントポリシーの設定」を参照してください。

説明

Agentic ファイルシステムの場合、このパラメーターは true に設定する必要があります。

false

OwnerUserId

integer

任意

オーナーユーザーの ID。

このパラメーターは、RootDirectory ディレクトリが存在しない場合に必須です。

説明

このパラメーターは、Agentic ファイルシステムではサポートされていません。

1

OwnerGroupId

integer

任意

オーナーユーザーグループの ID。

このパラメーターは、RootDirectory ディレクトリが存在しない場合に必須です。

説明

このパラメーターは、Agentic ファイルシステムではサポートされていません。

1

Permission

string

任意

POSIX 権限。デフォルト値: 0755。制限: 値は 0 で始まる 4 桁の 8 進法システムである必要があります。

このパラメーターは、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

応答のスキーマ。

AccessPoint

object

アクセスポイント。

AccessPointDomain

string

アクセスポイントのドメイン名。

ap-ie15ydanoz.001014****-w****.cn-hangzhou.nas.aliyuncs.com

AccessPointId

string

アクセスポイントの ID。

ap-ie15yd****

RequestId

string

リクエストの ID。

98696EF0-1607-4E9D-B01D-F20930B6****

例

成功レスポンス

JSONJSON

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

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

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. 指定された RAM ロールが存在しません。
403 InvalidRamRole.NoPermission The specified RAM role does not have sufficient permission. 指定された RAM ロールに十分な権限がありません。
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. 指定された VPC が存在しません。先に VPC を作成してください。
404 InvalidVswitch.NotFound The specified VSwitch does not exist.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。