Servers - Update

Service:

MariaDB

API-versie:

2018-06-01

Updates een bestaande server. De aanvraagbody kan een of veel van de eigenschappen bevatten die aanwezig zijn in de normale serverdefinitie.

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

URI-parameters

Name	In	Vereist	Type	Description
resourceGroupName	path	True	string	De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.
serverName	path	True	string	De naam van de server.
subscriptionId	path	True	string	De id van het doelabonnement.
api-version	query	True	string	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name	Type	Description
parameters	ServerUpdateParameters	De vereiste parameters voor het bijwerken van een server.

Antwoorden

Name	Type	Description
200 OK	Server	OK
202 Accepted		Geaccepteerd
Other Status Codes	CloudError	Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	uw gebruikersaccount imiteren

Voorbeelden

ServerUpdate

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name	Description
CloudError	Een foutreactie van de Batch-service.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorResponse	Foutreactie
GeoRedundantBackup	Schakel geografisch redundant of niet in voor serverback-up.
MinimalTlsVersionEnum	Dwing een minimale TLS-versie af voor de server.
PrivateEndpointProperty	Privé-eindpunt waartoe de verbinding behoort.
PrivateEndpointProvisioningState	Status van de privé-eindpuntverbinding.
PrivateLinkServiceConnectionStateActionsRequire	De acties die zijn vereist voor een private link-serviceverbinding.
PrivateLinkServiceConnectionStateStatus	De verbindingsstatus van de Private Link-service.
PublicNetworkAccessEnum	Of openbare netwerktoegang is toegestaan voor deze server. De waarde is optioneel, maar als deze is doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' zijn
Server	Vertegenwoordigt een server.
ServerPrivateEndpointConnection	Lijst met privé-eindpuntverbindingen op een server
ServerPrivateEndpointConnectionProperties	Eigenschappen van privé-eindpuntverbinding
ServerPrivateLinkServiceConnectionStateProperty	Verbindingsstatus van de privé-eindpuntverbinding.
ServerState	Een status van een server die zichtbaar is voor de gebruiker.
ServerUpdateParameters	De vereiste parameters voor het bijwerken van een server.
ServerVersion	Serverversie.
Sku	De SKU (prijscategorie) van de server.
SkuTier	De laag van de specifieke SKU, bijvoorbeeld Basic.
SslEnforcementEnum	Ssl-afdwinging inschakelen of niet wanneer u verbinding maakt met de server.
StorageAutogrow	Automatisch vergroten van opslag inschakelen.
StorageProfile	Opslagprofiel van een server.

CloudError

Een foutreactie van de Batch-service.

Name	Type	Description
error	ErrorResponse	Foutreactie Foutbericht

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het type aanvullende informatie.

ErrorResponse

Foutreactie

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Aanvullende informatie over de fout.
code	string	De foutcode.
details	ErrorResponse[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

GeoRedundantBackup

Schakel geografisch redundant of niet in voor serverback-up.

Name	Type	Description
Disabled	string
Enabled	string

MinimalTlsVersionEnum

Dwing een minimale TLS-versie af voor de server.

Name	Type	Description
TLS1_0	string
TLS1_1	string
TLS1_2	string
TLSEnforcementDisabled	string

PrivateEndpointProperty

Privé-eindpunt waartoe de verbinding behoort.

Name	Type	Description
id	string	Resource-id van het privé-eindpunt.

PrivateEndpointProvisioningState

Status van de privé-eindpuntverbinding.

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

PrivateLinkServiceConnectionStateActionsRequire

De acties die zijn vereist voor een private link-serviceverbinding.

Name	Type	Description
None	string

PrivateLinkServiceConnectionStateStatus

De verbindingsstatus van de Private Link-service.

Name	Type	Description
Approved	string
Disconnected	string
Pending	string
Rejected	string

PublicNetworkAccessEnum

Of openbare netwerktoegang is toegestaan voor deze server. De waarde is optioneel, maar als deze is doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' zijn

Name	Type	Description
Disabled	string
Enabled	string

Server

Vertegenwoordigt een server.

Name	Type	Description
id	string	Volledig gekwalificeerde resource-id voor de resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	De geografische locatie waar de resource zich bevindt
name	string	De naam van de resource
properties.administratorLogin	string	De aanmeldingsnaam van de beheerder van een server. Kan alleen worden opgegeven wanneer de server wordt gemaakt (en is vereist voor het maken).
properties.earliestRestoreDate	string	Tijdstip waarop het vroegste herstelpunt wordt gemaakt (ISO8601 indeling)
properties.fullyQualifiedDomainName	string	De fully qualified domain name van een server.
properties.masterServerId	string	De hoofdserver-id van een replicaserver.
properties.minimalTlsVersion	MinimalTlsVersionEnum	Dwing een minimale TLS-versie af voor de server.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	Lijst met privé-eindpuntverbindingen op een server
properties.publicNetworkAccess	PublicNetworkAccessEnum	Of openbare netwerktoegang is toegestaan voor deze server. De waarde is optioneel, maar als deze is doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' zijn
properties.replicaCapacity	integer	Het maximum aantal replica's dat een hoofdserver kan hebben.
properties.replicationRole	string	De replicatiefunctie van de server.
properties.sslEnforcement	SslEnforcementEnum	Ssl-afdwinging inschakelen of niet wanneer u verbinding maakt met de server.
properties.storageProfile	StorageProfile	Opslagprofiel van een server.
properties.userVisibleState	ServerState	Een status van een server die zichtbaar is voor de gebruiker.
properties.version	ServerVersion	Serverversie.
sku	Sku	De SKU (prijscategorie) van de server.
tags	object	Resourcetags.
type	string	Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

ServerPrivateEndpointConnection

Lijst met privé-eindpuntverbindingen op een server

Name	Type	Description
id	string	Resource-id van de privé-eindpuntverbinding.
properties	ServerPrivateEndpointConnectionProperties	Eigenschappen van privé-eindpuntverbinding

ServerPrivateEndpointConnectionProperties

Eigenschappen van privé-eindpuntverbinding

Name	Type	Description
privateEndpoint	PrivateEndpointProperty	Privé-eindpunt waartoe de verbinding behoort.
privateLinkServiceConnectionState	ServerPrivateLinkServiceConnectionStateProperty	Verbindingsstatus van de privé-eindpuntverbinding.
provisioningState	PrivateEndpointProvisioningState	Status van de privé-eindpuntverbinding.

ServerPrivateLinkServiceConnectionStateProperty

Verbindingsstatus van de privé-eindpuntverbinding.

Name	Type	Description
actionsRequired	PrivateLinkServiceConnectionStateActionsRequire	De acties die zijn vereist voor een private link-serviceverbinding.
description	string	De beschrijving van de private link-serviceverbinding.
status	PrivateLinkServiceConnectionStateStatus	De verbindingsstatus van de Private Link-service.

ServerState

Een status van een server die zichtbaar is voor de gebruiker.

Name	Type	Description
Disabled	string
Dropping	string
Ready	string

ServerUpdateParameters

De vereiste parameters voor het bijwerken van een server.

Name	Type	Description
properties.administratorLoginPassword	string	Het wachtwoord van de beheerdersaanmelding.
properties.minimalTlsVersion	MinimalTlsVersionEnum	Dwing een minimale TLS-versie af voor de server.
properties.publicNetworkAccess	PublicNetworkAccessEnum	Of openbare netwerktoegang is toegestaan voor deze server. De waarde is optioneel, maar als deze is doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' zijn
properties.replicationRole	string	De replicatiefunctie van de server.
properties.sslEnforcement	SslEnforcementEnum	Ssl-afdwinging inschakelen of niet wanneer u verbinding maakt met de server.
properties.storageProfile	StorageProfile	Opslagprofiel van een server.
properties.version	ServerVersion	De versie van een server.
sku	Sku	De SKU (prijscategorie) van de server.
tags	object	Toepassingsspecifieke metagegevens in de vorm van sleutel-waardeparen.

ServerVersion

Serverversie.

Name	Type	Description
10.2	string
10.3	string

Sku

De SKU (prijscategorie) van de server.

Name	Type	Description
capacity	integer	De capaciteit voor omhoog/uitschalen, die de rekeneenheden van de server vertegenwoordigt.
family	string	De hardwarefamilie.
name	string	De naam van de SKU, meestal laag + familie + kernen, bijvoorbeeld B_Gen4_1, GP_Gen5_8.
size	string	De groottecode, die door de resource moet worden geïnterpreteerd, indien van toepassing.
tier	SkuTier	De laag van de specifieke SKU, bijvoorbeeld Basic.

SkuTier

De laag van de specifieke SKU, bijvoorbeeld Basic.

Name	Type	Description
Basic	string
GeneralPurpose	string
MemoryOptimized	string

SslEnforcementEnum

Ssl-afdwinging inschakelen of niet wanneer u verbinding maakt met de server.

Name	Type	Description
Disabled	string
Enabled	string

StorageAutogrow

Automatisch vergroten van opslag inschakelen.

Name	Type	Description
Disabled	string
Enabled	string

StorageProfile

Opslagprofiel van een server.

Name	Type	Description
backupRetentionDays	integer	Back-upretentiedagen voor de server.
geoRedundantBackup	GeoRedundantBackup	Schakel geografisch redundant of niet in voor serverback-up.
storageAutogrow	StorageAutogrow	Automatisch vergroten van opslag inschakelen.
storageMB	integer	Maximale opslag die is toegestaan voor een server.