アクセスポイントを作成します。
操作説明
CreateAccessPoint 操作を呼び出してアクセスポイントを作成すると、一部のリソースが非同期で生成されます。したがって、CreateAccessPoint 操作の呼び出しが成功したら、 DescribeAccessPoints または DescribeAccessPoint 操作を呼び出してアクセスポイントのステータスをクエリしてください。ファイルシステムをマウントする前に、アクセスポイントが Active 状態になるまで待機してください。そうしないと、マウント操作が失敗する可能性があります。
この特徴は、汎用 NAS NFS ファイルシステムでのみサポートされています。
RAM ポリシー (EnabledRam) を有効にする場合は、対応する 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 ポリシーを有効にするかどうかを指定します。 有効な値:
説明
アクセスポイントの 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 |
任意 |
タグキー。 使用制限:
|
TestKey |
| Value |
string |
任意 |
タグ値。 使用制限:
|
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. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。