アクセスポイント情報を照会します。
操作説明
汎用 NAS NFS ファイルシステムのみがサポートされています。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
nas:ListAccessPoints |
list |
*All Resource
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| FileSystemId |
string |
必須 |
ファイルシステムの ID。 |
0913nx15amuix9a**** |
| Filters |
array<object> |
任意 |
フィルター情報。 |
|
|
object |
任意 |
フィルター情報。 |
||
| Name |
string |
任意 |
フィルターキーの名前。有効な値:
列挙値:
|
AccessPointId |
| Value |
string |
任意 |
フィルターキーの値。 |
TestValue |
| NextToken |
string |
任意 |
クエリトークン。このパラメーターには、前の API 呼び出しで返された NextToken の値を設定します。 |
MTY4NzcxOTcwMjAzMDk2Nzc0MyM4MDM4**** |
| MaxResults |
integer |
任意 |
クエリごとに返す結果の最大数。
|
10 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| RequestId |
string |
リクエストの ID。 |
98696EF0-1607-4E9D-B01D-F20930B6**** |
| AccessPoints |
array<object> |
アクセスポイント情報。 |
|
|
array<object> |
アクセスポイント情報。 |
||
| ARN |
string |
アクセスポイントの Amazon リソースネーム (ARN)。 |
acs:nas:cn-hangzhou:178321033379****:accesspoint/ap-ie15yd**** |
| AccessGroup |
string |
権限グループ名。 |
DEFAULT_VPC_GROUP_NAME |
| AccessPointId |
string |
アクセスポイントの ID。 |
ap-ie15y***** |
| AccessPointName |
string |
アクセスポイント名。 |
test |
| CreateTime |
string |
アクセスポイントが作成された時間。時間は ISO 8601 標準に従い、協定世界時 (UTC) で表されます。フォーマット: yyyy-MM-ddTHH:mm:ssZ。 |
2026-03-28T06:32:14Z |
| DomainName |
string |
アクセスポイントのドメイン名。 |
ap-ie15ydanoz.001014****-w****.cn-hangzhou.nas.aliyuncs.com |
| EnabledRam |
boolean |
RAM ポリシーが有効かどうかを示します。 |
false |
| FileSystemId |
string |
ファイルシステムの ID。 |
091yj49baxscll2**** |
| ModifyTime |
string |
アクセスポイントが最後に変更済みとなった時間。時間は ISO 8601 標準に従い、協定世界時 (UTC) で表されます。フォーマット: yyyy-MM-ddTHH:mm:ssZ。 |
2026-06-24T02:10:23Z |
| PosixUser |
object |
POSIX ユーザー。 |
|
| PosixGroupId |
integer |
10 |
|
| PosixUserId |
integer |
156 |
|
| PosixSecondaryGroupIds |
array |
||
|
integer |
[100,123] |
||
| RootPath |
string |
ルートディレクトリ。 |
/ |
| RootPathPermission |
object |
ルートディレクトリの権限。 |
|
| OwnerGroupId |
integer |
12 |
|
| OwnerUserId |
integer |
1 |
|
| Permission |
string |
0755 |
|
| RootPathStatus |
string |
現在のルートディレクトリのステータス。 有効な値:
|
2 |
| Status |
string |
現在のアクセスポイントのステータス。 有効な値:
説明
ステータスが Active の場合にのみ、ファイルシステムをマウントできます。 |
Active |
| VSwitchId |
string |
vSwitch の ID。 |
vsw-2zevmwkwyztjuoffg**** |
| VpcId |
string |
VPC の ID。 |
vpc-2zesj9afh3y518k9o**** |
| Tags |
array<object> |
アクセスポイントのタグリスト。 |
|
|
object |
アクセスポイントのタグリスト。 |
||
| Key |
string |
TestKey |
|
| Value |
string |
TestValue |
|
| AgenticSpaceId |
string |
AgenticSpace ID。 |
agentic-229oypxjgpau2**** |
| CreateTimeUtc |
string |
agentic スペースが作成された時間。時間は ISO 8601 標準に従います。フォーマット: yyyy-MM-ddTHH:mm:ssZ。 |
2026-06-10T10:08:08Z |
| ModifyTimeUtc |
string |
agentic スペースが最後に変更済みとなった時間。時間は ISO 8601 標準に従います。フォーマット: yyyy-MM-ddTHH:mm:ssZ。 |
2026-06-10T10:08:08Z |
| NextToken |
string |
クエリトークン。このパラメーターには、前の API 呼び出しで返された NextToken の値を設定します。 |
52frCAAAAABoZS90cm****== |
| TotalCount |
integer |
アクセスポイントの総数。 |
20 |
例
成功レスポンス
JSONJSON
{
"RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****",
"AccessPoints": [
{
"ARN": "acs:nas:cn-hangzhou:178321033379****:accesspoint/ap-ie15yd****",
"AccessGroup": "DEFAULT_VPC_GROUP_NAME",
"AccessPointId": "ap-ie15y*****\n",
"AccessPointName": "test",
"CreateTime": "2026-03-28T06:32:14Z",
"DomainName": "ap-ie15ydanoz.001014****-w****.cn-hangzhou.nas.aliyuncs.com",
"EnabledRam": false,
"FileSystemId": "091yj49baxscll2****",
"ModifyTime": "2026-06-24T02:10:23Z",
"PosixUser": {
"PosixGroupId": 10,
"PosixUserId": 156,
"PosixSecondaryGroupIds": [
0
]
},
"RootPath": "/",
"RootPathPermission": {
"OwnerGroupId": 12,
"OwnerUserId": 1,
"Permission": "0755"
},
"RootPathStatus": "2",
"Status": "Active",
"VSwitchId": "vsw-2zevmwkwyztjuoffg****\n",
"VpcId": "vpc-2zesj9afh3y518k9o****\n",
"Tags": [
{
"Key": "TestKey",
"Value": "TestValue"
}
],
"AgenticSpaceId": "agentic-229oypxjgpau2****",
"CreateTimeUtc": "2026-06-10T10:08:08Z",
"ModifyTimeUtc": "2026-06-10T10:08:08Z"
}
],
"NextToken": "52frCAAAAABoZS90cm****==",
"TotalCount": 20
}エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | InvalidFilesystemType.NotSupport | The API operation does not support the file system type. | 現在の操作はこのタイプのファイルシステムをサポートしていません。 |
| 403 | InvalidProtocolType.NotSupported | The specified protocol type does not supported. | 指定されたプロトコルの種類はサポートされていません。 |
| 404 | InvalidFileSystem.NotFound | The specified file system does not exist. | 指定されたファイルシステムが存在しません。 |
| 404 | InvalidAccessGroup.NotFound | The specified AccessGroup does not exist. | 指定された権限グループが存在しないか、削除されています。 |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。