Servers - Update

Referenz

Dienst:: MariaDB

API-Version:: 2018-06-01

Aktualisiert einen vorhandenen Server. Der Anforderungstext kann eine bis viele der Eigenschaften enthalten, die in der normalen Serverdefinition vorhanden sind.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
resourceGroupName	path	True	string	Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.
serverName	path	True	string	Name des Servers
subscriptionId	path	True	string	Hierbei handelt es sich um die ID des Zielabonnements.
api-version	query	True	string	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name	Typ	Beschreibung
parameters	ServerUpdateParameters	Die erforderlichen Parameter zum Aktualisieren eines Servers.

Antworten

Name	Typ	Beschreibung
200 OK	Server	OK
202 Accepted		Akzeptiert
Other Status Codes	CloudError	Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

ServerUpdate

Beispielanforderung

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

Beispiel für eine Antwort

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

Statuscode:: 202

Definitionen

Name	Beschreibung
CloudError	Eine Fehlerantwort des Batch-Diensts.
ErrorAdditionalInfo	Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
ErrorResponse	Fehlerantwort
GeoRedundantBackup	Aktivieren Sie georedundant oder nicht für die Serversicherung.
MinimalTlsVersionEnum	Erzwingen Sie eine minimale Tls-Version für den Server.
PrivateEndpointProperty	Privater Endpunkt, zu dem die Verbindung gehört.
PrivateEndpointProvisioningState	Zustand der Verbindung mit dem privaten Endpunkt.
PrivateLinkServiceConnectionStateActionsRequire	Die aktionen, die für die Private Link-Dienstverbindung erforderlich sind.
PrivateLinkServiceConnectionStateStatus	Die Private Link-Dienstverbindung status.
PublicNetworkAccessEnum	Gibt an, ob der Öffentliche Netzwerkzugriff für diesen Server zulässig ist oder nicht. Der Wert ist optional, muss aber bei Übergabe "Aktiviert" oder "Deaktiviert" sein.
Server	Stellt einen Server dar.
ServerPrivateEndpointConnection	Liste der privaten Endpunktverbindungen auf einem Server
ServerPrivateEndpointConnectionProperties	Verbindungseigenschaften für private Endpunkte
ServerPrivateLinkServiceConnectionStateProperty	Verbindungsstatus der privaten Endpunktverbindung.
ServerState	Ein Zustand eines Servers, der für den Benutzer sichtbar ist.
ServerUpdateParameters	Die erforderlichen Parameter zum Aktualisieren eines Servers.
ServerVersion	Serverversion.
Sku	Die SKU (Tarif) des Servers.
SkuTier	Die Ebene der jeweiligen SKU, z. B. Basic.
SslEnforcementEnum	Aktivieren Sie die SSL-Erzwingung oder nicht, wenn Sie eine Verbindung mit dem Server herstellen.
StorageAutogrow	Aktivieren Sie die automatische Speichervergrößerung.
StorageProfile	Speicherprofil eines Servers.

CloudError

Eine Fehlerantwort des Batch-Diensts.

Name	Typ	Beschreibung
error	ErrorResponse	Fehlerantwort Fehlermeldung

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name	Typ	Beschreibung
info	object	Zusätzliche Informationen.
type	string	Typ der zusätzlichen Informationen.

ErrorResponse

Fehlerantwort

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Fehlerinformationen.
code	string	Der Fehlercode.
details	ErrorResponse[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

GeoRedundantBackup

Aktivieren Sie georedundant oder nicht für die Serversicherung.

Name	Typ	Beschreibung
Disabled	string
Enabled	string

MinimalTlsVersionEnum

Erzwingen Sie eine minimale Tls-Version für den Server.

Name	Typ	Beschreibung
TLS1_0	string
TLS1_1	string
TLS1_2	string
TLSEnforcementDisabled	string

PrivateEndpointProperty

Privater Endpunkt, zu dem die Verbindung gehört.

Name	Typ	Beschreibung
id	string	Ressourcen-ID des privaten Endpunkts.

PrivateEndpointProvisioningState

Zustand der Verbindung mit dem privaten Endpunkt.

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

PrivateLinkServiceConnectionStateActionsRequire

Die aktionen, die für die Private Link-Dienstverbindung erforderlich sind.

Name	Typ	Beschreibung
None	string

PrivateLinkServiceConnectionStateStatus

Die Private Link-Dienstverbindung status.

Name	Typ	Beschreibung
Approved	string
Disconnected	string
Pending	string
Rejected	string

PublicNetworkAccessEnum

Gibt an, ob der Öffentliche Netzwerkzugriff für diesen Server zulässig ist oder nicht. Der Wert ist optional, muss aber bei Übergabe "Aktiviert" oder "Deaktiviert" sein.

Name	Typ	Beschreibung
Disabled	string
Enabled	string

Server

Stellt einen Server dar.

Name	Typ	Beschreibung
id	string	Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Der geografische Standort, an dem sich die Ressource befindet
name	string	Der Name der Ressource
properties.administratorLogin	string	Der Anmeldename des Administrators eines Servers. Kann nur angegeben werden, wenn der Server erstellt wird (und für die Erstellung erforderlich ist).
properties.earliestRestoreDate	string	Erstellungszeit des frühesten Wiederherstellungspunkts (ISO8601 Format)
properties.fullyQualifiedDomainName	string	Der vollqualifizierte Domänenname eines Servers.
properties.masterServerId	string	Die master Server-ID eines Replikatservers.
properties.minimalTlsVersion	MinimalTlsVersionEnum	Erzwingen Sie eine minimale Tls-Version für den Server.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	Liste der privaten Endpunktverbindungen auf einem Server
properties.publicNetworkAccess	PublicNetworkAccessEnum	Gibt an, ob der Öffentliche Netzwerkzugriff für diesen Server zulässig ist oder nicht. Der Wert ist optional, muss aber bei Übergabe "Aktiviert" oder "Deaktiviert" sein.
properties.replicaCapacity	integer	Die maximale Anzahl von Replikaten, die ein master Server haben kann.
properties.replicationRole	string	Die Replikationsrolle des Servers.
properties.sslEnforcement	SslEnforcementEnum	Aktivieren Sie die SSL-Erzwingung oder nicht, wenn Sie eine Verbindung mit dem Server herstellen.
properties.storageProfile	StorageProfile	Speicherprofil eines Servers.
properties.userVisibleState	ServerState	Ein Zustand eines Servers, der für den Benutzer sichtbar ist.
properties.version	ServerVersion	Serverversion.
sku	Sku	Die SKU (Tarif) des Servers.
tags	object	Ressourcentags.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

ServerPrivateEndpointConnection

Liste der privaten Endpunktverbindungen auf einem Server

Name	Typ	Beschreibung
id	string	Ressourcen-ID der privaten Endpunktverbindung.
properties	ServerPrivateEndpointConnectionProperties	Verbindungseigenschaften für private Endpunkte

ServerPrivateEndpointConnectionProperties

Verbindungseigenschaften für private Endpunkte

Name	Typ	Beschreibung
privateEndpoint	PrivateEndpointProperty	Privater Endpunkt, zu dem die Verbindung gehört.
privateLinkServiceConnectionState	ServerPrivateLinkServiceConnectionStateProperty	Verbindungsstatus der privaten Endpunktverbindung.
provisioningState	PrivateEndpointProvisioningState	Zustand der Verbindung mit dem privaten Endpunkt.

ServerPrivateLinkServiceConnectionStateProperty

Verbindungsstatus der privaten Endpunktverbindung.

Name	Typ	Beschreibung
actionsRequired	PrivateLinkServiceConnectionStateActionsRequire	Die aktionen, die für die Private Link-Dienstverbindung erforderlich sind.
description	string	Die Verbindungsbeschreibung des Private Link-Diensts.
status	PrivateLinkServiceConnectionStateStatus	Die Private Link-Dienstverbindung status.

ServerState

Ein Zustand eines Servers, der für den Benutzer sichtbar ist.

Name	Typ	Beschreibung
Disabled	string
Dropping	string
Ready	string

ServerUpdateParameters

Die erforderlichen Parameter zum Aktualisieren eines Servers.

Name	Typ	Beschreibung
properties.administratorLoginPassword	string	Das Kennwort der Administratoranmeldung.
properties.minimalTlsVersion	MinimalTlsVersionEnum	Erzwingen Sie eine minimale Tls-Version für den Server.
properties.publicNetworkAccess	PublicNetworkAccessEnum	Gibt an, ob der Öffentliche Netzwerkzugriff für diesen Server zulässig ist oder nicht. Der Wert ist optional, muss aber bei Übergabe "Aktiviert" oder "Deaktiviert" sein.
properties.replicationRole	string	Die Replikationsrolle des Servers.
properties.sslEnforcement	SslEnforcementEnum	Aktivieren Sie die SSL-Erzwingung oder nicht, wenn Sie eine Verbindung mit dem Server herstellen.
properties.storageProfile	StorageProfile	Speicherprofil eines Servers.
properties.version	ServerVersion	Die Version eines Servers.
sku	Sku	Die SKU (Tarif) des Servers.
tags	object	Anwendungsspezifische Metadaten in Form von Schlüssel-Wert-Paaren.

ServerVersion

Serverversion.

Name	Typ	Beschreibung
10.2	string
10.3	string

Sku

Die SKU (Tarif) des Servers.

Name	Typ	Beschreibung
capacity	integer	Die Kapazität für hochskalieren/ausskalieren, die die Computeeinheiten des Servers darstellt.
family	string	Die Hardwarefamilie.
name	string	Der Name der sku, in der Regel Ebene + Familie + Kerne, z. B. B_Gen4_1, GP_Gen5_8.
size	string	Der Größencode, der je nach Ressource interpretiert werden soll.
tier	SkuTier	Die Ebene der jeweiligen SKU, z. B. Basic.

SkuTier

Die Ebene der jeweiligen SKU, z. B. Basic.

Name	Typ	Beschreibung
Basic	string
GeneralPurpose	string
MemoryOptimized	string

SslEnforcementEnum

Aktivieren Sie die SSL-Erzwingung oder nicht, wenn Sie eine Verbindung mit dem Server herstellen.

Name	Typ	Beschreibung
Disabled	string
Enabled	string

StorageAutogrow

Aktivieren Sie die automatische Speichervergrößerung.

Name	Typ	Beschreibung
Disabled	string
Enabled	string

StorageProfile

Speicherprofil eines Servers.

Name	Typ	Beschreibung
backupRetentionDays	integer	Sicherungsaufbewahrungstage für den Server.
geoRedundantBackup	GeoRedundantBackup	Aktivieren Sie georedundant oder nicht für die Serversicherung.
storageAutogrow	StorageAutogrow	Aktivieren Sie die automatische Speichervergrößerung.
storageMB	integer	Maximal zulässiger Speicher für einen Server.

Freigeben über

Servers - Update

URI-Parameter

Anforderungstext

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

ServerUpdate

Beispielanforderung

Beispiel für eine Antwort

Definitionen

CloudError

ErrorAdditionalInfo

ErrorResponse

GeoRedundantBackup

MinimalTlsVersionEnum

PrivateEndpointProperty

PrivateEndpointProvisioningState

PrivateLinkServiceConnectionStateActionsRequire

PrivateLinkServiceConnectionStateStatus

PublicNetworkAccessEnum

Server

ServerPrivateEndpointConnection

ServerPrivateEndpointConnectionProperties

ServerPrivateLinkServiceConnectionStateProperty

ServerState

ServerUpdateParameters

ServerVersion

Sku

SkuTier

SslEnforcementEnum

StorageAutogrow

StorageProfile

Zusätzliche Ressourcen