Servers - Update

Service:

MariaDB

API Version:

2018-06-01

Aggiorna un server esistente. Il corpo della richiesta può contenere una a molte delle proprietà presenti nella definizione del server normale.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string	Nome del gruppo di risorse. Per il nome non viene fatta distinzione tra maiuscole e minuscole.
serverName	path	True	string	Nome del server.
subscriptionId	path	True	string	ID della sottoscrizione di destinazione.
api-version	query	True	string	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Tipo	Descrizione
parameters	ServerUpdateParameters	Parametri obbligatori per l'aggiornamento di un server.

Risposte

Nome	Tipo	Descrizione
200 OK	Server	OK
202 Accepted		Accettato
Other Status Codes	CloudError	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

ServerUpdate

Sample Request

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

Sample Response

Status code:

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

Status code:

202

Definizioni

Nome	Descrizione
CloudError	Risposta di errore dal servizio Batch.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorResponse	Risposta di errore
GeoRedundantBackup	Abilitare o meno la ridondanza geografica per il backup del server.
MinimalTlsVersionEnum	Applicare una versione minima di Tls per il server.
PrivateEndpointProperty	Endpoint privato a cui appartiene la connessione.
PrivateEndpointProvisioningState	Stato della connessione dell'endpoint privato.
PrivateLinkServiceConnectionStateActionsRequire	Azioni necessarie per la connessione al servizio di collegamento privato.
PrivateLinkServiceConnectionStateStatus	Stato della connessione al servizio di collegamento privato.
PublicNetworkAccessEnum	Indica se l'accesso alla rete pubblica è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled'
Server	Rappresenta un server.
ServerPrivateEndpointConnection	Elenco di connessioni di endpoint privato in un server
ServerPrivateEndpointConnectionProperties	Proprietà di connessione dell'endpoint privato
ServerPrivateLinkServiceConnectionStateProperty	Stato di connessione della connessione dell'endpoint privato.
ServerState	Stato di un server visibile all'utente.
ServerUpdateParameters	Parametri obbligatori per l'aggiornamento di un server.
ServerVersion	Versione del server.
Sku	SKU (piano tariffario) del server.
SkuTier	Livello dello SKU specifico, ad esempio Basic.
SslEnforcementEnum	Abilitare o meno l'imposizione ssl quando ci si connette al server.
StorageAutogrow	Abilitare l'aumento automatico dell'archiviazione.
StorageProfile	Profilo di archiviazione di un server.

CloudError

Risposta di errore dal servizio Batch.

Nome	Tipo	Descrizione
error	ErrorResponse	Risposta di errore Messaggio di errore

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorResponse

Risposta di errore

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorResponse[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

GeoRedundantBackup

Abilitare o meno la ridondanza geografica per il backup del server.

Nome	Tipo	Descrizione
Disabled	string
Enabled	string

MinimalTlsVersionEnum

Applicare una versione minima di Tls per il server.

Nome	Tipo	Descrizione
TLS1_0	string
TLS1_1	string
TLS1_2	string
TLSEnforcementDisabled	string

PrivateEndpointProperty

Endpoint privato a cui appartiene la connessione.

Nome	Tipo	Descrizione
id	string	ID risorsa dell'endpoint privato.

PrivateEndpointProvisioningState

Stato della connessione dell'endpoint privato.

Nome	Tipo	Descrizione
Approving	string
Dropping	string
Failed	string
Ready	string
Rejecting	string

PrivateLinkServiceConnectionStateActionsRequire

Azioni necessarie per la connessione al servizio di collegamento privato.

Nome	Tipo	Descrizione
None	string

PrivateLinkServiceConnectionStateStatus

Stato della connessione al servizio di collegamento privato.

Nome	Tipo	Descrizione
Approved	string
Disconnected	string
Pending	string
Rejected	string

PublicNetworkAccessEnum

Indica se l'accesso alla rete pubblica è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled'

Nome	Tipo	Descrizione
Disabled	string
Enabled	string

Server

Rappresenta un server.

Nome	Tipo	Descrizione
id	string	ID di risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Posizione geografica in cui risiede la risorsa
name	string	nome della risorsa.
properties.administratorLogin	string	Nome di accesso dell'amministratore di un server. Può essere specificato solo quando il server viene creato (ed è necessario per la creazione).
properties.earliestRestoreDate	string	Tempo di creazione del punto di ripristino meno recente (formato ISO8601)
properties.fullyQualifiedDomainName	string	Nome di dominio completo di un server.
properties.masterServerId	string	ID server master di un server di replica.
properties.minimalTlsVersion	MinimalTlsVersionEnum	Applicare una versione minima di Tls per il server.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	Elenco di connessioni di endpoint privato in un server
properties.publicNetworkAccess	PublicNetworkAccessEnum	Indica se l'accesso alla rete pubblica è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled'
properties.replicaCapacity	integer	Numero massimo di repliche che un server master può avere.
properties.replicationRole	string	Ruolo di replica del server.
properties.sslEnforcement	SslEnforcementEnum	Abilitare o meno l'imposizione ssl quando ci si connette al server.
properties.storageProfile	StorageProfile	Profilo di archiviazione di un server.
properties.userVisibleState	ServerState	Stato di un server visibile all'utente.
properties.version	ServerVersion	Versione del server.
sku	Sku	SKU (piano tariffario) del server.
tags	object	Tag delle risorse.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

ServerPrivateEndpointConnection

Elenco di connessioni di endpoint privato in un server

Nome	Tipo	Descrizione
id	string	ID risorsa della connessione dell'endpoint privato.
properties	ServerPrivateEndpointConnectionProperties	Proprietà di connessione dell'endpoint privato

ServerPrivateEndpointConnectionProperties

Proprietà di connessione dell'endpoint privato

Nome	Tipo	Descrizione
privateEndpoint	PrivateEndpointProperty	Endpoint privato a cui appartiene la connessione.
privateLinkServiceConnectionState	ServerPrivateLinkServiceConnectionStateProperty	Stato di connessione della connessione dell'endpoint privato.
provisioningState	PrivateEndpointProvisioningState	Stato della connessione dell'endpoint privato.

ServerPrivateLinkServiceConnectionStateProperty

Stato di connessione della connessione dell'endpoint privato.

Nome	Tipo	Descrizione
actionsRequired	PrivateLinkServiceConnectionStateActionsRequire	Azioni necessarie per la connessione al servizio di collegamento privato.
description	string	Descrizione della connessione al servizio di collegamento privato.
status	PrivateLinkServiceConnectionStateStatus	Stato della connessione al servizio di collegamento privato.

ServerState

Stato di un server visibile all'utente.

Nome	Tipo	Descrizione
Disabled	string
Dropping	string
Ready	string

ServerUpdateParameters

Parametri obbligatori per l'aggiornamento di un server.

Nome	Tipo	Descrizione
properties.administratorLoginPassword	string	Password dell'account di accesso dell'amministratore.
properties.minimalTlsVersion	MinimalTlsVersionEnum	Applicare una versione minima di Tls per il server.
properties.publicNetworkAccess	PublicNetworkAccessEnum	Indica se l'accesso alla rete pubblica è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled'
properties.replicationRole	string	Ruolo di replica del server.
properties.sslEnforcement	SslEnforcementEnum	Abilitare o meno l'imposizione ssl quando ci si connette al server.
properties.storageProfile	StorageProfile	Profilo di archiviazione di un server.
properties.version	ServerVersion	Versione di un server.
sku	Sku	SKU (piano tariffario) del server.
tags	object	Metadati specifici dell'applicazione sotto forma di coppie chiave-valore.

ServerVersion

Versione del server.

Nome	Tipo	Descrizione
10.2	string
10.3	string

Sku

SKU (piano tariffario) del server.

Nome	Tipo	Descrizione
capacity	integer	Capacità di aumento/riduzione, che rappresenta le unità di calcolo del server.
family	string	Famiglia di hardware.
name	string	Nome dello SKU, in genere, tier + family + cores, ad esempio B_Gen4_1, GP_Gen5_8.
size	string	Codice delle dimensioni da interpretare in base alla risorsa in base alle esigenze.
tier	SkuTier	Livello dello SKU specifico, ad esempio Basic.

SkuTier

Livello dello SKU specifico, ad esempio Basic.

Nome	Tipo	Descrizione
Basic	string
GeneralPurpose	string
MemoryOptimized	string

SslEnforcementEnum

Abilitare o meno l'imposizione ssl quando ci si connette al server.

Nome	Tipo	Descrizione
Disabled	string
Enabled	string

StorageAutogrow

Abilitare l'aumento automatico dell'archiviazione.

Nome	Tipo	Descrizione
Disabled	string
Enabled	string

StorageProfile

Profilo di archiviazione di un server.

Nome	Tipo	Descrizione
backupRetentionDays	integer	Giorni di conservazione dei backup per il server.
geoRedundantBackup	GeoRedundantBackup	Abilitare o meno la ridondanza geografica per il backup del server.
storageAutogrow	StorageAutogrow	Abilitare l'aumento automatico dell'archiviazione.
storageMB	integer	Spazio di archiviazione massimo consentito per un server.