共用方式為


Configurations - Create Or Update

更新伺服器的組態。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMySQL/flexibleServers/{serverName}/configurations/{configurationName}?api-version=2024-12-30

URI 參數

名稱 位於 必要 類型 Description
configurationName
path True

string

伺服器組態的名稱。

resourceGroupName
path True

string

minLength: 1
maxLength: 90

資源群組的名稱。 名稱不區分大小寫。

serverName
path True

string

minLength: 1
maxLength: 63
pattern: ^[a-z0-9][-a-z0-9]*(?

伺服器的名稱。

subscriptionId
path True

string (uuid)

目標訂用帳戶的標識碼。 此值必須是 UUID。

api-version
query True

string

minLength: 1

用於此作業的 API 版本。

要求本文

名稱 類型 Description
properties.currentValue

string

組態的目前值。

properties.source

ConfigurationSource

組態的來源。

properties.value

string

組態的值。

回應

名稱 類型 Description
200 OK

Configuration

資源 'Configuration' 更新作業成功

202 Accepted

已接受資源作業。

標題

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

未預期的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱 Description
user_impersonation 模擬您的用戶帳戶

範例

ConfigurationCreateOrUpdate

範例要求

PUT https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup/providers/Microsoft.DBforMySQL/flexibleServers/testserver/configurations/event_scheduler?api-version=2024-12-30

{
  "properties": {
    "source": "user-override",
    "value": "off"
  }
}

範例回覆

{
  "name": "event_scheduler",
  "type": "Microsoft.DBforMySQL/servers/configurations",
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup/providers/Microsoft.DBforMySQL/servers/testserver/configurations/event_scheduler",
  "properties": {
    "description": "Indicates the status of the Event Scheduler.",
    "allowedValues": "ON,OFF,DISABLED",
    "dataType": "Enumeration",
    "defaultValue": "OFF",
    "source": "user-override",
    "value": "ON"
  }
}

定義

名稱 Description
Configuration

表示組態。

ConfigurationSource

組態的來源。

createdByType

建立資源的身分識別類型。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

ErrorDetail

錯誤詳細數據。

ErrorResponse

錯誤回應

IsConfigPendingRestart

如果是擱置重新啟動的組態,則為 。

IsDynamicConfig

如果 為組態動態。

IsReadOnly

如果 是組態只讀。

systemData

與建立和上次修改資源相關的元數據。

Configuration

表示組態。

名稱 類型 Description
id

string (arm-id)

資源的完整資源標識碼。 例如 “/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”

name

string

資源的名稱

properties.allowedValues

string

組態的允許值。

properties.currentValue

string

組態的目前值。

properties.dataType

string

組態的數據類型。

properties.defaultValue

string

組態的預設值。

properties.description

string

組態的描述。

properties.documentationLink

string

用來從社群或 Azure 網站取得文件的連結。

properties.isConfigPendingRestart

IsConfigPendingRestart

如果是擱置重新啟動的組態,則為 。

properties.isDynamicConfig

IsDynamicConfig

如果 為組態動態。

properties.isReadOnly

IsReadOnly

如果 是組態只讀。

properties.source

ConfigurationSource

組態的來源。

properties.value

string

組態的值。

systemData

systemData

包含 createdBy 和 modifiedBy 資訊的 Azure Resource Manager 中繼資料。

type

string

資源的類型。 例如「Microsoft.Compute/virtualMachines」或「Microsoft.Storage/storageAccounts」

ConfigurationSource

組態的來源。

Description
system-default
user-override

createdByType

建立資源的身分識別類型。

Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱 類型 Description
info

object

其他資訊。

type

string

其他信息類型。

ErrorDetail

錯誤詳細數據。

名稱 類型 Description
additionalInfo

ErrorAdditionalInfo[]

錯誤其他資訊。

code

string

錯誤碼。

details

ErrorDetail[]

錯誤詳細數據。

message

string

錯誤訊息。

target

string

錯誤目標。

ErrorResponse

錯誤回應

名稱 類型 Description
error

ErrorDetail

error 物件。

IsConfigPendingRestart

如果是擱置重新啟動的組態,則為 。

Description
True
False

IsDynamicConfig

如果 為組態動態。

Description
True
False

IsReadOnly

如果 是組態只讀。

Description
True
False

systemData

與建立和上次修改資源相關的元數據。

名稱 類型 Description
createdAt

string (date-time)

資源建立的時間戳(UTC)。

createdBy

string

建立資源的身分識別。

createdByType

createdByType

建立資源的身分識別類型。

lastModifiedAt

string (date-time)

上次修改的資源時間戳 (UTC)

lastModifiedBy

string

上次修改資源的身分識別。

lastModifiedByType

createdByType

上次修改資源的身分識別類型。