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

File Storage NAS:ModifyAutoSnapshotPolicy

最終更新日:Apr 04, 2026

自動スナップショットポリシーを変更します。ファイルシステムに適用されている自動スナップショットポリシーを変更すると、その変更は、そのファイルシステムに対して後続で作成されるスナップショットに直ちに適用されます。

操作説明

  • スナップショット機能はパブリックプレビュー段階であり、無料で提供されます。File Storage NAS サービスレベルアグリーメント (SLA) はパブリックプレビューでは保証されません。

  • この機能は、拡張超高速型 NAS ファイルシステムのみでサポートされています。

今すぐお試しください

この 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:ModifyAutoSnapshotPolicy

update

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

AutoSnapshotPolicyId

string

必須

自動スナップショットポリシーの ID。

DescribeAutoSnapshotPolicies 操作を呼び出して、利用可能な自動スナップショットポリシーを表示できます。

sp-extreme-233e6****

AutoSnapshotPolicyName

string

任意

自動スナップショットポリシーの名前。このパラメーターを指定しない場合、ポリシー名は変更されません。

制限事項:

  • 名前の長さは 2~128 文字である必要があります。

  • 名前は英字で始まる必要があります。

  • 名前に使用できる文字は、数字、英字、コロン (:)、アンダースコア (_)、ハイフン (-) です。`http://` または `https://` で始めることはできません。

FinanceJoshua

RepeatWeekdays

string

任意

自動スナップショットを作成する曜日。

サイクル:週。

有効値:1~7。値 1 は月曜日を示します。1 週間以内に複数の自動スナップショットを作成する場合は、月曜日から日曜日までの複数の曜日をコンマ (,) で区切って指定できます。最大 7 日間指定できます。

1,7

RetentionDays

integer

任意

自動スナップショットの保存期間。

単位:日。

有効値:

  • -1 (デフォルト):自動スナップショットは永続的に保持されます。自動スナップショットの数が上限を超えると、最も古い自動スナップショットが自動的に削除されます。

  • 1~65536:自動スナップショットは指定された日数保持されます。自動スナップショットの保存期間が終了すると、自動スナップショットは自動的に削除されます。

30

TimePoints

string

任意

自動スナップショットを作成する時刻。

単位:時。

有効値:0~23。0~23 の値は、00:00 から 23:00 までの合計 24 時間を示します。たとえば、値 1 は 01:00 を示します。1 日に複数の自動スナップショットを作成する場合は、複数の時刻をコンマ (,) で区切って指定できます。最大 24 個の時刻を指定できます。

0,1

レスポンスフィールド

フィールド

説明

object

RequestId

string

リクエスト ID。

リクエストが成功したかどうかに関係なく、すべてのレスポンスは一意のリクエスト ID を返します。

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

成功レスポンス

JSONJSON

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

エラーコード

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

変更履歴

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