Maintenance Windows - Create Or Update

データベースのメンテナンス期間の設定を設定します。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/maintenanceWindows/current?api-version=2025-01-01&maintenanceWindowName={maintenanceWindowName}

URI パラメーター

名前 / 必須 型 説明
databaseName
path True

string

データベースの名前。

resourceGroupName
path True

string

minLength: 1
maxLength: 90

リソース グループの名前。 名前の大文字と小文字は区別されません。

serverName
path True

string

サーバーの名前。

subscriptionId
path True

string (uuid)

ターゲット サブスクリプションの ID。 値は UUID である必要があります。

api-version
query True

string

minLength: 1

この操作に使用する API バージョン。

maintenanceWindowName
query True

string

メンテナンス期間の名前。

要求本文

名前 型 説明
properties.timeRanges

MaintenanceWindowTimeRange[]

メンテナンス期間の時間範囲。

応答

名前 型 説明
200 OK

要求は成功しました。

Other Status Codes

ErrorResponse

予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 Flow.

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前 説明
user_impersonation ユーザー アカウントを偽装する

例

Sets maintenance window settings for a selected database.

要求のサンプル

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdwdb/maintenanceWindows/current?api-version=2025-01-01&maintenanceWindowName=current

{
  "properties": {
    "timeRanges": [
      {
        "dayOfWeek": "Saturday",
        "duration": "PT60M",
        "startTime": "00:00:00"
      }
    ]
  }
}

応答のサンプル

定義

名前 説明
createdByType

リソースを作成した ID の種類。

DayOfWeek

メンテナンス期間の日。

ErrorAdditionalInfo

リソース管理エラーの追加情報。

ErrorDetail

エラーの詳細。

ErrorResponse

エラー応答

MaintenanceWindows

メンテナンス期間。

MaintenanceWindowTimeRange

メンテナンス期間の時間範囲。

systemData

リソースの作成と最後の変更に関連するメタデータ。

createdByType

リソースを作成した ID の種類。

値 説明
User
Application
ManagedIdentity
Key

DayOfWeek

メンテナンス期間の日。

値 説明
Sunday

日曜日

Monday

月曜日

Tuesday

火曜日

Wednesday

水曜日

Thursday

木曜日

Friday

金曜日

Saturday

土曜日

ErrorAdditionalInfo

リソース管理エラーの追加情報。

名前 型 説明
info

object

追加情報。

type

string

追加情報の種類。

ErrorDetail

エラーの詳細。

名前 型 説明
additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。

code

string

エラー コード。

details

ErrorDetail[]

エラーの詳細。

message

string

エラー メッセージ。

target

string

エラーターゲット。

ErrorResponse

エラー応答

名前 型 説明
error

ErrorDetail

エラー オブジェクト。

MaintenanceWindows

メンテナンス期間。

名前 型 説明
id

string (arm-id)

リソースの完全修飾リソース ID。 例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

リソースの名前

properties.timeRanges

MaintenanceWindowTimeRange[]

メンテナンス期間の時間範囲。

systemData

systemData

create By と modifiedBy の情報を含む Azure Resource Manager メタデータ。

type

string

リソースの型。 例えば「Microsoft。Compute/virtualMachines」または「Microsoft」などです。ストレージ/ストレージアカウント」

MaintenanceWindowTimeRange

メンテナンス期間の時間範囲。

名前 型 説明
dayOfWeek

DayOfWeek

メンテナンス期間の日。

duration

string

メンテナンス期間 (分単位)。

startTime

string

午前 12 時からの開始時刻の分オフセット。

systemData

リソースの作成と最後の変更に関連するメタデータ。

名前 型 説明
createdAt

string (date-time)

リソース作成のタイムスタンプ (UTC)。

createdBy

string

リソースを作成した ID。

createdByType

createdByType

リソースを作成した ID の種類。

lastModifiedAt

string (date-time)

リソースの最終変更のタイムスタンプ (UTC)

lastModifiedBy

string

リソースを最後に変更した ID。

lastModifiedByType

createdByType

リソースを最後に変更した ID の種類。