Servers - Update

참조

서비스:: MariaDB

API 버전:: 2018-06-01

기존 서버를 업데이트합니다. 요청 본문에는 일반 서버 정의에 있는 속성 중 하나에서 많은 속성이 포함될 수 있습니다.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{serverName}?api-version=2018-06-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
resourceGroupName	path	True	string	리소스 그룹의 이름. 이름은 대소문자를 구분하지 않습니다.
serverName	path	True	string	서버의 이름입니다.
subscriptionId	path	True	string	대상 구독의 ID입니다.
api-version	query	True	string	이 작업에 사용할 API 버전입니다.

요청 본문

Name	형식	Description
parameters	ServerUpdateParameters	서버를 업데이트하는 데 필요한 매개 변수입니다.

응답

Name	형식	Description
200 OK	Server	정상
202 Accepted		수락됨
Other Status Codes	CloudError	작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

ServerUpdate

샘플 요청

PATCH https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMariaDB/servers/mariadbtestsvc4?api-version=2018-06-01

{
  "properties": {
    "administratorLoginPassword": "<administratorLoginPassword>",
    "sslEnforcement": "Disabled"
  }
}


import com.azure.resourcemanager.mariadb.models.Server;
import com.azure.resourcemanager.mariadb.models.SslEnforcementEnum;

/**
 * Samples for Servers Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/mariadb/resource-manager/Microsoft.DBforMariaDB/stable/2018-06-01/examples/ServerUpdate.json
     */
    /**
     * Sample code: ServerUpdate.
     * 
     * @param manager Entry point to MariaDBManager.
     */
    public static void serverUpdate(com.azure.resourcemanager.mariadb.MariaDBManager manager) {
        Server resource = manager.servers()
            .getByResourceGroupWithResponse("testrg", "mariadbtestsvc4", com.azure.core.util.Context.NONE).getValue();
        resource.update().withAdministratorLoginPassword("<administratorLoginPassword>")
            .withSslEnforcement(SslEnforcementEnum.DISABLED).apply();
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

from typing import Any, IO, Union

from azure.identity import DefaultAzureCredential

from azure.mgmt.rdbms.mariadb import MariaDBManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-rdbms
# USAGE
    python server_update.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = MariaDBManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="ffffffff-ffff-ffff-ffff-ffffffffffff",
    )

    response = client.servers.begin_update(
        resource_group_name="testrg",
        server_name="mariadbtestsvc4",
        parameters={
            "properties": {"administratorLoginPassword": "<administratorLoginPassword>", "sslEnforcement": "Disabled"}
        },
    ).result()
    print(response)


# x-ms-original-file: specification/mariadb/resource-manager/Microsoft.DBforMariaDB/stable/2018-06-01/examples/ServerUpdate.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armmariadb_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/mariadb/armmariadb"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/7a2ac91de424f271cf91cc8009f3fe9ee8249086/specification/mariadb/resource-manager/Microsoft.DBforMariaDB/stable/2018-06-01/examples/ServerUpdate.json
func ExampleServersClient_BeginUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armmariadb.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewServersClient().BeginUpdate(ctx, "testrg", "mariadbtestsvc4", armmariadb.ServerUpdateParameters{
		Properties: &armmariadb.ServerUpdateParametersProperties{
			AdministratorLoginPassword: to.Ptr("<administratorLoginPassword>"),
			SSLEnforcement:             to.Ptr(armmariadb.SSLEnforcementEnumDisabled),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.Server = armmariadb.Server{
	// 	Name: to.Ptr("mariadbtestsvc4"),
	// 	Type: to.Ptr("Microsoft.DBforMariaDB/servers"),
	// 	ID: to.Ptr("/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMariaDB/servers/mariadbtestsvc4"),
	// 	Location: to.Ptr("westus"),
	// 	Tags: map[string]*string{
	// 		"ElasticServer": to.Ptr("1"),
	// 	},
	// 	Properties: &armmariadb.ServerProperties{
	// 		AdministratorLogin: to.Ptr("cloudsa"),
	// 		EarliestRestoreDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-03-14T18:02:41.577Z"); return t}()),
	// 		FullyQualifiedDomainName: to.Ptr("mariadbtestsvc4.mariadb.database.azure.com"),
	// 		SSLEnforcement: to.Ptr(armmariadb.SSLEnforcementEnumDisabled),
	// 		StorageProfile: &armmariadb.StorageProfile{
	// 			BackupRetentionDays: to.Ptr[int32](7),
	// 			GeoRedundantBackup: to.Ptr(armmariadb.GeoRedundantBackupEnabled),
	// 			StorageMB: to.Ptr[int32](128000),
	// 		},
	// 		UserVisibleState: to.Ptr(armmariadb.ServerStateReady),
	// 		Version: to.Ptr(armmariadb.ServerVersionTen3),
	// 	},
	// 	SKU: &armmariadb.SKU{
	// 		Name: to.Ptr("GP_Gen4_2"),
	// 		Capacity: to.Ptr[int32](2),
	// 		Family: to.Ptr("Gen4"),
	// 		Tier: to.Ptr(armmariadb.SKUTierGeneralPurpose),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { MariaDBManagementClient } = require("@azure/arm-mariadb");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Updates an existing server. The request body can contain one to many of the properties present in the normal server definition.
 *
 * @summary Updates an existing server. The request body can contain one to many of the properties present in the normal server definition.
 * x-ms-original-file: specification/mariadb/resource-manager/Microsoft.DBforMariaDB/stable/2018-06-01/examples/ServerUpdate.json
 */
async function serverUpdate() {
  const subscriptionId = "ffffffff-ffff-ffff-ffff-ffffffffffff";
  const resourceGroupName = "testrg";
  const serverName = "mariadbtestsvc4";
  const parameters = {
    administratorLoginPassword: "<administratorLoginPassword>",
    sslEnforcement: "Disabled",
  };
  const credential = new DefaultAzureCredential();
  const client = new MariaDBManagementClient(credential, subscriptionId);
  const result = await client.servers.beginUpdateAndWait(resourceGroupName, serverName, parameters);
  console.log(result);
}

serverUpdate().catch(console.error);

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

샘플 응답

상태 코드:: 200

{
  "sku": {
    "name": "GP_Gen4_2",
    "tier": "GeneralPurpose",
    "family": "Gen4",
    "capacity": 2
  },
  "properties": {
    "administratorLogin": "cloudsa",
    "storageProfile": {
      "storageMB": 128000,
      "backupRetentionDays": 7,
      "geoRedundantBackup": "Enabled"
    },
    "version": "10.3",
    "sslEnforcement": "Disabled",
    "userVisibleState": "Ready",
    "fullyQualifiedDomainName": "mariadbtestsvc4.mariadb.database.azure.com",
    "earliestRestoreDate": "2018-03-14T18:02:41.577+00:00"
  },
  "location": "westus",
  "tags": {
    "ElasticServer": "1"
  },
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMariaDB/servers/mariadbtestsvc4",
  "name": "mariadbtestsvc4",
  "type": "Microsoft.DBforMariaDB/servers"
}

상태 코드:: 202

정의

Name	Description
CloudError	Batch 서비스의 오류 응답입니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorResponse	오류 응답
GeoRedundantBackup	서버 백업에 지역 중복 여부를 사용하도록 설정합니다.
MinimalTlsVersionEnum	서버에 최소 Tls 버전을 적용합니다.
PrivateEndpointProperty	연결이 속한 프라이빗 엔드포인트입니다.
PrivateEndpointProvisioningState	프라이빗 엔드포인트 연결의 상태입니다.
PrivateLinkServiceConnectionStateActionsRequire	프라이빗 링크 서비스 연결에 필요한 작업입니다.
PrivateLinkServiceConnectionStateStatus	프라이빗 링크 서비스 연결 상태.
PublicNetworkAccessEnum	이 서버에 대한 공용 네트워크 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다.
Server	서버를 나타냅니다.
ServerPrivateEndpointConnection	서버의 프라이빗 엔드포인트 연결 목록
ServerPrivateEndpointConnectionProperties	프라이빗 엔드포인트 연결 속성
ServerPrivateLinkServiceConnectionStateProperty	프라이빗 엔드포인트 연결의 연결 상태입니다.
ServerState	사용자에게 표시되는 서버의 상태입니다.
ServerUpdateParameters	서버를 업데이트하는 데 필요한 매개 변수입니다.
ServerVersion	서버 버전입니다.
Sku	서버의 SKU(가격 책정 계층)입니다.
SkuTier	특정 SKU의 계층(예: Basic)입니다.
SslEnforcementEnum	서버에 연결할 때 ssl 적용을 사용하도록 설정합니다.
StorageAutogrow	스토리지 자동 증가를 사용하도록 설정합니다.
StorageProfile	서버의 스토리지 프로필입니다.

CloudError

Batch 서비스의 오류 응답입니다.

Name	형식	Description
error	ErrorResponse	오류 응답 오류 메시지

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorResponse

오류 응답

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorResponse[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

GeoRedundantBackup

서버 백업에 지역 중복 여부를 사용하도록 설정합니다.

Name	형식	Description
Disabled	string
Enabled	string

MinimalTlsVersionEnum

서버에 최소 Tls 버전을 적용합니다.

Name	형식	Description
TLS1_0	string
TLS1_1	string
TLS1_2	string
TLSEnforcementDisabled	string

PrivateEndpointProperty

연결이 속한 프라이빗 엔드포인트입니다.

Name	형식	Description
id	string	프라이빗 엔드포인트의 리소스 ID입니다.

PrivateEndpointProvisioningState

프라이빗 엔드포인트 연결의 상태입니다.

Name	형식	Description
Approving	string
Dropping	string
Failed	string
Ready	string
Rejecting	string

PrivateLinkServiceConnectionStateActionsRequire

프라이빗 링크 서비스 연결에 필요한 작업입니다.

Name	형식	Description
None	string

PrivateLinkServiceConnectionStateStatus

프라이빗 링크 서비스 연결 상태.

Name	형식	Description
Approved	string
Disconnected	string
Pending	string
Rejected	string

PublicNetworkAccessEnum

이 서버에 대한 공용 네트워크 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다.

Name	형식	Description
Disabled	string
Enabled	string

Server

서버를 나타냅니다.

Name	형식	Description
id	string	리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	리소스가 있는 지리적 위치
name	string	리소스의 이름입니다.
properties.administratorLogin	string	서버의 관리자 로그인 이름입니다. 서버를 만들 때만 지정할 수 있습니다(만들기에 필요).
properties.earliestRestoreDate	string	가장 빠른 복원 지점 생성 시간(ISO8601 형식)
properties.fullyQualifiedDomainName	string	서버의 정규화된 도메인 이름입니다.
properties.masterServerId	string	복제본(replica) 서버의 master 서버 ID입니다.
properties.minimalTlsVersion	MinimalTlsVersionEnum	서버에 최소 Tls 버전을 적용합니다.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	서버의 프라이빗 엔드포인트 연결 목록
properties.publicNetworkAccess	PublicNetworkAccessEnum	이 서버에 대한 공용 네트워크 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다.
properties.replicaCapacity	integer	master 서버에 있을 수 있는 최대 복제본 수입니다.
properties.replicationRole	string	서버의 복제 역할입니다.
properties.sslEnforcement	SslEnforcementEnum	서버에 연결할 때 ssl 적용을 사용하도록 설정합니다.
properties.storageProfile	StorageProfile	서버의 스토리지 프로필입니다.
properties.userVisibleState	ServerState	사용자에게 표시되는 서버의 상태입니다.
properties.version	ServerVersion	서버 버전입니다.
sku	Sku	서버의 SKU(가격 책정 계층)입니다.
tags	object	리소스 태그.
type	string	리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

ServerPrivateEndpointConnection

서버의 프라이빗 엔드포인트 연결 목록

Name	형식	Description
id	string	프라이빗 엔드포인트 연결의 리소스 ID입니다.
properties	ServerPrivateEndpointConnectionProperties	프라이빗 엔드포인트 연결 속성

ServerPrivateEndpointConnectionProperties

프라이빗 엔드포인트 연결 속성

Name	형식	Description
privateEndpoint	PrivateEndpointProperty	연결이 속한 프라이빗 엔드포인트입니다.
privateLinkServiceConnectionState	ServerPrivateLinkServiceConnectionStateProperty	프라이빗 엔드포인트 연결의 연결 상태입니다.
provisioningState	PrivateEndpointProvisioningState	프라이빗 엔드포인트 연결의 상태입니다.

ServerPrivateLinkServiceConnectionStateProperty

프라이빗 엔드포인트 연결의 연결 상태입니다.

Name	형식	Description
actionsRequired	PrivateLinkServiceConnectionStateActionsRequire	프라이빗 링크 서비스 연결에 필요한 작업입니다.
description	string	프라이빗 링크 서비스 연결 설명입니다.
status	PrivateLinkServiceConnectionStateStatus	프라이빗 링크 서비스 연결 상태.

ServerState

사용자에게 표시되는 서버의 상태입니다.

Name	형식	Description
Disabled	string
Dropping	string
Ready	string

ServerUpdateParameters

서버를 업데이트하는 데 필요한 매개 변수입니다.

Name	형식	Description
properties.administratorLoginPassword	string	관리자 로그인의 암호입니다.
properties.minimalTlsVersion	MinimalTlsVersionEnum	서버에 최소 Tls 버전을 적용합니다.
properties.publicNetworkAccess	PublicNetworkAccessEnum	이 서버에 대한 공용 네트워크 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다.
properties.replicationRole	string	서버의 복제 역할입니다.
properties.sslEnforcement	SslEnforcementEnum	서버에 연결할 때 ssl 적용을 사용하도록 설정합니다.
properties.storageProfile	StorageProfile	서버의 스토리지 프로필입니다.
properties.version	ServerVersion	서버의 버전입니다.
sku	Sku	서버의 SKU(가격 책정 계층)입니다.
tags	object	키-값 쌍 형태의 애플리케이션별 메타데이터입니다.

ServerVersion

서버 버전입니다.

Name	형식	Description
10.2	string
10.3	string

Sku

서버의 SKU(가격 책정 계층)입니다.

Name	형식	Description
capacity	integer	서버의 컴퓨팅 단위를 나타내는 스케일 업/아웃 용량입니다.
family	string	하드웨어 제품군입니다.
name	string	sku의 이름(일반적으로 계층 + 제품군 + 코어)(예: B_Gen4_1, GP_Gen5_8)입니다.
size	string	리소스에서 적절하게 해석할 크기 코드입니다.
tier	SkuTier	특정 SKU의 계층(예: Basic)입니다.

SkuTier

특정 SKU의 계층(예: Basic)입니다.

Name	형식	Description
Basic	string
GeneralPurpose	string
MemoryOptimized	string

SslEnforcementEnum

서버에 연결할 때 ssl 적용을 사용하도록 설정합니다.

Name	형식	Description
Disabled	string
Enabled	string

StorageAutogrow

스토리지 자동 증가를 사용하도록 설정합니다.

Name	형식	Description
Disabled	string
Enabled	string

StorageProfile

서버의 스토리지 프로필입니다.

Name	형식	Description
backupRetentionDays	integer	서버의 백업 보존 기간(일)입니다.
geoRedundantBackup	GeoRedundantBackup	서버 백업에 지역 중복 여부를 사용하도록 설정합니다.
storageAutogrow	StorageAutogrow	스토리지 자동 증가를 사용하도록 설정합니다.
storageMB	integer	서버에 허용되는 최대 스토리지입니다.

다음을 통해 공유

Servers - Update

URI 매개 변수

요청 본문

응답

보안

azure_auth

범위

예제

ServerUpdate

샘플 요청

샘플 응답

정의

CloudError

ErrorAdditionalInfo

ErrorResponse

GeoRedundantBackup

MinimalTlsVersionEnum

PrivateEndpointProperty

PrivateEndpointProvisioningState

PrivateLinkServiceConnectionStateActionsRequire

PrivateLinkServiceConnectionStateStatus

PublicNetworkAccessEnum

Server

ServerPrivateEndpointConnection

ServerPrivateEndpointConnectionProperties

ServerPrivateLinkServiceConnectionStateProperty

ServerState

ServerUpdateParameters

ServerVersion

Sku

SkuTier

SslEnforcementEnum

StorageAutogrow

StorageProfile

추가 리소스