Servers - Update

Tjänst:

MariaDB

API-version:

2018-06-01

Uppdateringar en befintlig server. Begärandetexten kan innehålla en till många av de egenskaper som finns i den normala serverdefinitionen.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
resourceGroupName	path	True	string	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
serverName	path	True	string	Namnet på servern.
subscriptionId	path	True	string	ID för målprenumerationen.
api-version	query	True	string	Den API-version som ska användas för den här åtgärden.

Begärandetext

Name	Typ	Description
parameters	ServerUpdateParameters	De parametrar som krävs för att uppdatera en server.

Svar

Name	Typ	Description
200 OK	Server	OK
202 Accepted		Har godkänts
Other Status Codes	CloudError	Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

ServerUpdate

Exempelbegäran

HTTP

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"
  }
}

Java

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

Python

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

Go

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

JavaScript

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

Exempelsvar

Statuskod:

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"
}

Statuskod:

202

Definitioner

Name	Description
CloudError	Ett felsvar från Batch-tjänsten.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorResponse	Felsvar
GeoRedundantBackup	Aktivera geo-redundant eller inte för serversäkerhetskopiering.
MinimalTlsVersionEnum	Framtvinga en minimal Tls-version för servern.
PrivateEndpointProperty	Privat slutpunkt som anslutningen tillhör.
PrivateEndpointProvisioningState	Tillstånd för den privata slutpunktsanslutningen.
PrivateLinkServiceConnectionStateActionsRequire	De åtgärder som krävs för privat länktjänstanslutning.
PrivateLinkServiceConnectionStateStatus	Anslutningsstatus för tjänsten private link.
PublicNetworkAccessEnum	Om offentlig nätverksåtkomst tillåts för den här servern eller inte. Värdet är valfritt, men om det skickas måste det vara "Aktiverat" eller "Inaktiverat"
Server	Representerar en server.
ServerPrivateEndpointConnection	Lista över privata slutpunktsanslutningar på en server
ServerPrivateEndpointConnectionProperties	Egenskaper för privat slutpunktsanslutning
ServerPrivateLinkServiceConnectionStateProperty	Anslutningstillstånd för den privata slutpunktsanslutningen.
ServerState	Ett tillstånd för en server som är synlig för användaren.
ServerUpdateParameters	De parametrar som krävs för att uppdatera en server.
ServerVersion	Serverversion.
Sku	Serverns SKU (prisnivå).
SkuTier	Nivån för den specifika SKU:n, t.ex. Basic.
SslEnforcementEnum	Aktivera ssl-tillämpning eller inte när du ansluter till servern.
StorageAutogrow	Aktivera Automatisk ökning av lagring.
StorageProfile	Lagringsprofil för en server.

CloudError

Ett felsvar från Batch-tjänsten.

Name	Typ	Description
error	ErrorResponse	Felsvar Felmeddelande

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Den ytterligare informationstypen.

ErrorResponse

Felsvar

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorResponse[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

GeoRedundantBackup

Aktivera geo-redundant eller inte för serversäkerhetskopiering.

Name	Typ	Description
Disabled	string
Enabled	string

MinimalTlsVersionEnum

Framtvinga en minimal Tls-version för servern.

Name	Typ	Description
TLS1_0	string
TLS1_1	string
TLS1_2	string
TLSEnforcementDisabled	string

PrivateEndpointProperty

Privat slutpunkt som anslutningen tillhör.

Name	Typ	Description
id	string	Resurs-ID för den privata slutpunkten.

PrivateEndpointProvisioningState

Tillstånd för den privata slutpunktsanslutningen.

Name	Typ	Description
Approving	string
Dropping	string
Failed	string
Ready	string
Rejecting	string

PrivateLinkServiceConnectionStateActionsRequire

De åtgärder som krävs för privat länktjänstanslutning.

Name	Typ	Description
None	string

PrivateLinkServiceConnectionStateStatus

Anslutningsstatus för tjänsten private link.

Name	Typ	Description
Approved	string
Disconnected	string
Pending	string
Rejected	string

PublicNetworkAccessEnum

Om offentlig nätverksåtkomst tillåts för den här servern eller inte. Värdet är valfritt, men om det skickas måste det vara "Aktiverat" eller "Inaktiverat"

Name	Typ	Description
Disabled	string
Enabled	string

Server

Representerar en server.

Name	Typ	Description
id	string	Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Den geo-plats där resursen finns
name	string	Namnet på resursen
properties.administratorLogin	string	Administratörens inloggningsnamn för en server. Kan bara anges när servern skapas (och krävs för att skapa).
properties.earliestRestoreDate	string	Tidigaste skapandetid för återställningspunkt (ISO8601 format)
properties.fullyQualifiedDomainName	string	Det fullständigt kvalificerade domännamnet för en server.
properties.masterServerId	string	Huvudserver-ID:t för en replikserver.
properties.minimalTlsVersion	MinimalTlsVersionEnum	Framtvinga en minimal Tls-version för servern.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	Lista över privata slutpunktsanslutningar på en server
properties.publicNetworkAccess	PublicNetworkAccessEnum	Om offentlig nätverksåtkomst tillåts för den här servern eller inte. Värdet är valfritt, men om det skickas måste det vara "Aktiverat" eller "Inaktiverat"
properties.replicaCapacity	integer	Det maximala antalet repliker som en huvudserver kan ha.
properties.replicationRole	string	Serverns replikeringsroll.
properties.sslEnforcement	SslEnforcementEnum	Aktivera ssl-tillämpning eller inte när du ansluter till servern.
properties.storageProfile	StorageProfile	Lagringsprofil för en server.
properties.userVisibleState	ServerState	Ett tillstånd för en server som är synlig för användaren.
properties.version	ServerVersion	Serverversion.
sku	Sku	Serverns SKU (prisnivå).
tags	object	Resurstaggar.
type	string	Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

ServerPrivateEndpointConnection

Lista över privata slutpunktsanslutningar på en server

Name	Typ	Description
id	string	Resurs-ID för den privata slutpunktsanslutningen.
properties	ServerPrivateEndpointConnectionProperties	Egenskaper för privat slutpunktsanslutning

ServerPrivateEndpointConnectionProperties

Egenskaper för privat slutpunktsanslutning

Name	Typ	Description
privateEndpoint	PrivateEndpointProperty	Privat slutpunkt som anslutningen tillhör.
privateLinkServiceConnectionState	ServerPrivateLinkServiceConnectionStateProperty	Anslutningstillstånd för den privata slutpunktsanslutningen.
provisioningState	PrivateEndpointProvisioningState	Tillstånd för den privata slutpunktsanslutningen.

ServerPrivateLinkServiceConnectionStateProperty

Anslutningstillstånd för den privata slutpunktsanslutningen.

Name	Typ	Description
actionsRequired	PrivateLinkServiceConnectionStateActionsRequire	De åtgärder som krävs för privat länktjänstanslutning.
description	string	Beskrivning av tjänstanslutningen för privat länk.
status	PrivateLinkServiceConnectionStateStatus	Anslutningsstatus för tjänsten private link.

ServerState

Ett tillstånd för en server som är synlig för användaren.

Name	Typ	Description
Disabled	string
Dropping	string
Ready	string

ServerUpdateParameters

De parametrar som krävs för att uppdatera en server.

Name	Typ	Description
properties.administratorLoginPassword	string	Lösenordet för administratörsinloggningen.
properties.minimalTlsVersion	MinimalTlsVersionEnum	Framtvinga en minimal Tls-version för servern.
properties.publicNetworkAccess	PublicNetworkAccessEnum	Om offentlig nätverksåtkomst tillåts för den här servern eller inte. Värdet är valfritt, men om det skickas måste det vara "Aktiverat" eller "Inaktiverat"
properties.replicationRole	string	Serverns replikeringsroll.
properties.sslEnforcement	SslEnforcementEnum	Aktivera ssl-tillämpning eller inte när du ansluter till servern.
properties.storageProfile	StorageProfile	Lagringsprofil för en server.
properties.version	ServerVersion	Versionen av en server.
sku	Sku	Serverns SKU (prisnivå).
tags	object	Programspecifika metadata i form av nyckel/värde-par.

ServerVersion

Serverversion.

Name	Typ	Description
10.2	string
10.3	string

Sku

Serverns SKU (prisnivå).

Name	Typ	Description
capacity	integer	Upp- och utskalningskapaciteten som representerar serverns beräkningsenheter.
family	string	Maskinvarufamiljen.
name	string	Namnet på sku:n, vanligtvis nivå + familj + kärnor, t.ex. B_Gen4_1, GP_Gen5_8.
size	string	Storlekskoden som ska tolkas av resursen efter behov.
tier	SkuTier	Nivån för den specifika SKU:n, t.ex. Basic.

SkuTier

Nivån för den specifika SKU:n, t.ex. Basic.

Name	Typ	Description
Basic	string
GeneralPurpose	string
MemoryOptimized	string

SslEnforcementEnum

Aktivera ssl-tillämpning eller inte när du ansluter till servern.

Name	Typ	Description
Disabled	string
Enabled	string

StorageAutogrow

Aktivera Automatisk ökning av lagring.

Name	Typ	Description
Disabled	string
Enabled	string

StorageProfile

Lagringsprofil för en server.

Name	Typ	Description
backupRetentionDays	integer	Kvarhållningsdagar för säkerhetskopior för servern.
geoRedundantBackup	GeoRedundantBackup	Aktivera geo-redundant eller inte för serversäkerhetskopiering.
storageAutogrow	StorageAutogrow	Aktivera Automatisk ökning av lagring.
storageMB	integer	Maximalt antal tillåtna lagringsutrymmen för en server.