Servers - Create

Servizio:

MySQL

Versione API:

2017-12-01

Crea un nuovo server o aggiorna un server esistente. L'azione di aggiornamento sovrascriverà il server esistente.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMySQL/servers/{serverName}?api-version=2017-12-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	Necessario	Tipo	Descrizione
location	True	string	Posizione in cui risiede la risorsa.
properties	True	ServerPropertiesForCreate: ServerPropertiesForDefaultCreate ServerPropertiesForRestore ServerPropertiesForGeoRestore ServerPropertiesForReplica	Proprietà del server.
identity		ResourceIdentity	Identità di Azure Active Directory del server.
sku		Sku	SKU (piano tariffario) del server.
tags		object	Metadati specifici dell'applicazione sotto forma di coppie chiave-valore.

Risposte

Nome	Tipo	Descrizione
200 OK	Server	OK
201 Created	Server	Data di creazione
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

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Create a database as a point in time restore

Create a new server

Create a replica server

Create a server as a geo restore

Create a database as a point in time restore

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TargetResourceGroup/providers/Microsoft.DBforMySQL/servers/targetserver?api-version=2017-12-01

{
  "location": "brazilsouth",
  "properties": {
    "restorePointInTime": "2017-12-14T00:00:37.467Z",
    "createMode": "PointInTimeRestore",
    "sourceServerId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/SourceResourceGroup/providers/Microsoft.DBforMySQL/servers/sourceserver"
  },
  "sku": {
    "name": "GP_Gen5_2",
    "tier": "GeneralPurpose",
    "family": "Gen5",
    "capacity": 2
  },
  "tags": {
    "ElasticServer": "1"
  }
}

Python

from typing import Any, IO, Union

from azure.identity import DefaultAzureCredential

from azure.mgmt.rdbms.mysql import MySQLManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-rdbms
# USAGE
    python server_create_point_in_time_restore.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 = MySQLManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="ffffffff-ffff-ffff-ffff-ffffffffffff",
    )

    response = client.servers.begin_create(
        resource_group_name="TargetResourceGroup",
        server_name="targetserver",
        parameters={
            "location": "brazilsouth",
            "properties": {
                "createMode": "PointInTimeRestore",
                "restorePointInTime": "2017-12-14T00:00:37.467Z",
                "sourceServerId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/SourceResourceGroup/providers/Microsoft.DBforMySQL/servers/sourceserver",
            },
            "sku": {"capacity": 2, "family": "Gen5", "name": "GP_Gen5_2", "tier": "GeneralPurpose"},
            "tags": {"ElasticServer": "1"},
        },
    ).result()
    print(response)


# x-ms-original-file: specification/mysql/resource-manager/Microsoft.DBforMySQL/legacy/stable/2017-12-01/examples/ServerCreatePointInTimeRestore.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

dotnet

using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.MySql;
using Azure.ResourceManager.MySql.Models;
using Azure.ResourceManager.Resources;

// Generated from example definition: specification/mysql/resource-manager/Microsoft.DBforMySQL/legacy/stable/2017-12-01/examples/ServerCreatePointInTimeRestore.json
// this example is just showing the usage of "Servers_Create" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "ffffffff-ffff-ffff-ffff-ffffffffffff";
string resourceGroupName = "TargetResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this MySqlServerResource
MySqlServerCollection collection = resourceGroupResource.GetMySqlServers();

// invoke the operation
string serverName = "targetserver";
MySqlServerCreateOrUpdateContent content = new MySqlServerCreateOrUpdateContent(new MySqlServerPropertiesForRestore(new ResourceIdentifier("/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/SourceResourceGroup/providers/Microsoft.DBforMySQL/servers/sourceserver"), DateTimeOffset.Parse("2017-12-14T00:00:37.467Z")), new AzureLocation("brazilsouth"))
{
    Sku = new MySqlSku("GP_Gen5_2")
    {
        Tier = MySqlSkuTier.GeneralPurpose,
        Capacity = 2,
        Family = "Gen5",
    },
    Tags =
    {
    ["ElasticServer"] = "1",
    },
};
ArmOperation<MySqlServerResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, serverName, content);
MySqlServerResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
MySqlServerData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

Risposta di esempio

Codice di stato:

201

{
  "sku": {
    "name": "GP_Gen5_2",
    "tier": "GeneralPurpose",
    "family": "Gen5",
    "capacity": 2
  },
  "properties": {
    "administratorLogin": "cloudsa",
    "storageProfile": {
      "storageMB": 128000,
      "backupRetentionDays": 7,
      "geoRedundantBackup": "Enabled"
    },
    "version": "5.7",
    "sslEnforcement": "Enabled",
    "userVisibleState": "Ready",
    "fullyQualifiedDomainName": "targetserver.mysql.database.azure.com",
    "earliestRestoreDate": "2018-03-14T18:02:41.577+00:00"
  },
  "location": "brazilsouth",
  "tags": {
    "ElasticServer": "1"
  },
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMySQL/servers/targetserver",
  "name": "targetserver",
  "type": "Microsoft.DBforMySQL/servers"
}

Codice di stato:

200

{
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMySQL/servers/targetserver",
  "name": "targetserver",
  "type": "Microsoft.DBforMySQL/servers",
  "location": "brazilsouth",
  "sku": {
    "name": "GP_Gen5_2",
    "tier": "GeneralPurpose",
    "family": "Gen5",
    "capacity": 2
  },
  "tags": {
    "elasticServer": "1"
  },
  "properties": {
    "administratorLogin": "cloudsa",
    "storageProfile": {
      "storageMB": 128000,
      "backupRetentionDays": 7,
      "geoRedundantBackup": "Enabled"
    },
    "version": "5.7",
    "sslEnforcement": "Enabled",
    "userVisibleState": "Ready",
    "fullyQualifiedDomainName": "targetserver.mysql.database.azure.com",
    "earliestRestoreDate": "2018-03-14T18:02:41.577+00:00"
  }
}

Codice di stato:

202

Azure-AsyncOperation: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforMySQL/locations/southeastasia/azureAsyncOperation/e276a03a-1770-4549-86f5-0edffae8997c?api-version=2021-12-01-preview
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforMySQL/locations/southeastasia/operationResults/e276a03a-1770-4549-86f5-0edffae8997c?api-version=2021-12-01-preview

Create a new server

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMySQL/servers/mysqltestsvc4?api-version=2017-12-01

{
  "location": "westus",
  "properties": {
    "administratorLogin": "cloudsa",
    "administratorLoginPassword": "<administratorLoginPassword>",
    "sslEnforcement": "Enabled",
    "storageProfile": {
      "storageMB": 128000,
      "backupRetentionDays": 7,
      "geoRedundantBackup": "Enabled"
    },
    "createMode": "Default"
  },
  "sku": {
    "name": "GP_Gen5_2",
    "tier": "GeneralPurpose",
    "capacity": 2,
    "family": "Gen5"
  },
  "tags": {
    "ElasticServer": "1"
  }
}

Python

from typing import Any, IO, Union

from azure.identity import DefaultAzureCredential

from azure.mgmt.rdbms.mysql import MySQLManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-rdbms
# USAGE
    python server_create.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 = MySQLManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="ffffffff-ffff-ffff-ffff-ffffffffffff",
    )

    response = client.servers.begin_create(
        resource_group_name="testrg",
        server_name="mysqltestsvc4",
        parameters={
            "location": "westus",
            "properties": {
                "administratorLogin": "cloudsa",
                "administratorLoginPassword": "<administratorLoginPassword>",
                "createMode": "Default",
                "sslEnforcement": "Enabled",
                "storageProfile": {"backupRetentionDays": 7, "geoRedundantBackup": "Enabled", "storageMB": 128000},
            },
            "sku": {"capacity": 2, "family": "Gen5", "name": "GP_Gen5_2", "tier": "GeneralPurpose"},
            "tags": {"ElasticServer": "1"},
        },
    ).result()
    print(response)


# x-ms-original-file: specification/mysql/resource-manager/Microsoft.DBforMySQL/legacy/stable/2017-12-01/examples/ServerCreate.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

dotnet

using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.MySql;
using Azure.ResourceManager.MySql.Models;
using Azure.ResourceManager.Resources;

// Generated from example definition: specification/mysql/resource-manager/Microsoft.DBforMySQL/legacy/stable/2017-12-01/examples/ServerCreate.json
// this example is just showing the usage of "Servers_Create" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "ffffffff-ffff-ffff-ffff-ffffffffffff";
string resourceGroupName = "testrg";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this MySqlServerResource
MySqlServerCollection collection = resourceGroupResource.GetMySqlServers();

// invoke the operation
string serverName = "mysqltestsvc4";
MySqlServerCreateOrUpdateContent content = new MySqlServerCreateOrUpdateContent(new MySqlServerPropertiesForDefaultCreate("cloudsa", "<administratorLoginPassword>")
{
    SslEnforcement = MySqlSslEnforcementEnum.Enabled,
    StorageProfile = new MySqlStorageProfile()
    {
        BackupRetentionDays = 7,
        GeoRedundantBackup = MySqlGeoRedundantBackup.Enabled,
        StorageInMB = 128000,
    },
}, new AzureLocation("westus"))
{
    Sku = new MySqlSku("GP_Gen5_2")
    {
        Tier = MySqlSkuTier.GeneralPurpose,
        Capacity = 2,
        Family = "Gen5",
    },
    Tags =
    {
    ["ElasticServer"] = "1",
    },
};
ArmOperation<MySqlServerResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, serverName, content);
MySqlServerResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
MySqlServerData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

Risposta di esempio

Codice di stato:

201

{
  "sku": {
    "name": "GP_Gen5_2",
    "tier": "GeneralPurpose",
    "family": "Gen5",
    "capacity": 2
  },
  "properties": {
    "administratorLogin": "cloudsa",
    "storageProfile": {
      "storageMB": 128000,
      "backupRetentionDays": 7,
      "geoRedundantBackup": "Enabled"
    },
    "version": "5.7",
    "sslEnforcement": "Enabled",
    "userVisibleState": "Ready",
    "fullyQualifiedDomainName": "mysqltestsvc4.mysql.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.DBforMySQL/servers/mysqltestsvc4",
  "name": "mysqltestsvc4",
  "type": "Microsoft.DBforMySQL/servers"
}

Codice di stato:

200

{
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMySQL/servers/mysqltestsvc4",
  "name": "mysqltestsvc4",
  "type": "Microsoft.DBforMySQL/servers",
  "location": "westus",
  "sku": {
    "name": "GP_Gen5_2",
    "tier": "GeneralPurpose",
    "family": "Gen5",
    "capacity": 2
  },
  "tags": {
    "elasticServer": "1"
  },
  "properties": {
    "administratorLogin": "cloudsa",
    "storageProfile": {
      "storageMB": 128000,
      "backupRetentionDays": 7,
      "geoRedundantBackup": "Enabled"
    },
    "version": "5.7",
    "sslEnforcement": "Enabled",
    "userVisibleState": "Ready",
    "fullyQualifiedDomainName": "mysqltestsvc4.mysql.database.azure.com",
    "earliestRestoreDate": "2018-03-14T18:02:41.577+00:00"
  }
}

Codice di stato:

202

Azure-AsyncOperation: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforMySQL/locations/southeastasia/azureAsyncOperation/e276a03a-1770-4549-86f5-0edffae8997c?api-version=2021-12-01-preview
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforMySQL/locations/southeastasia/operationResults/e276a03a-1770-4549-86f5-0edffae8997c?api-version=2021-12-01-preview

Create a replica server

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TargetResourceGroup/providers/Microsoft.DBforMySQL/servers/targetserver?api-version=2017-12-01

{
  "location": "westus",
  "properties": {
    "createMode": "Replica",
    "sourceServerId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/MasterResourceGroup/providers/Microsoft.DBforMySQL/servers/masterserver"
  }
}

Python

from typing import Any, IO, Union

from azure.identity import DefaultAzureCredential

from azure.mgmt.rdbms.mysql import MySQLManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-rdbms
# USAGE
    python server_create_replica_mode.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 = MySQLManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="ffffffff-ffff-ffff-ffff-ffffffffffff",
    )

    response = client.servers.begin_create(
        resource_group_name="TargetResourceGroup",
        server_name="targetserver",
        parameters={
            "location": "westus",
            "properties": {
                "createMode": "Replica",
                "sourceServerId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/MasterResourceGroup/providers/Microsoft.DBforMySQL/servers/masterserver",
            },
        },
    ).result()
    print(response)


# x-ms-original-file: specification/mysql/resource-manager/Microsoft.DBforMySQL/legacy/stable/2017-12-01/examples/ServerCreateReplicaMode.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

dotnet

using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.MySql;
using Azure.ResourceManager.MySql.Models;
using Azure.ResourceManager.Resources;

// Generated from example definition: specification/mysql/resource-manager/Microsoft.DBforMySQL/legacy/stable/2017-12-01/examples/ServerCreateReplicaMode.json
// this example is just showing the usage of "Servers_Create" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "ffffffff-ffff-ffff-ffff-ffffffffffff";
string resourceGroupName = "TargetResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this MySqlServerResource
MySqlServerCollection collection = resourceGroupResource.GetMySqlServers();

// invoke the operation
string serverName = "targetserver";
MySqlServerCreateOrUpdateContent content = new MySqlServerCreateOrUpdateContent(new MySqlServerPropertiesForReplica(new ResourceIdentifier("/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/MasterResourceGroup/providers/Microsoft.DBforMySQL/servers/masterserver")), new AzureLocation("westus"));
ArmOperation<MySqlServerResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, serverName, content);
MySqlServerResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
MySqlServerData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

Risposta di esempio

Codice di stato:

201

{
  "sku": {
    "name": "GP_Gen5_2",
    "tier": "GeneralPurpose",
    "family": "Gen5",
    "capacity": 2
  },
  "properties": {
    "administratorLogin": "cloudsa",
    "storageProfile": {
      "storageMB": 128000,
      "backupRetentionDays": 14,
      "geoRedundantBackup": "Enabled"
    },
    "version": "5.7",
    "sslEnforcement": "Enabled",
    "userVisibleState": "Ready",
    "fullyQualifiedDomainName": "targetserver.mysql.database.azure.com",
    "earliestRestoreDate": "2018-03-14T18:02:41.577+00:00",
    "replicationRole": "Replica",
    "masterServerId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/MasterResourceGroup/providers/Microsoft.DBforMySQL/servers/masterserver",
    "replicaCapacity": 0
  },
  "location": "westus",
  "tags": {
    "ElasticServer": "1"
  },
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TargetResourceGroup/providers/Microsoft.DBforMySQL/servers/targetserver",
  "name": "targetserver",
  "type": "Microsoft.DBforMySQL/servers"
}

Codice di stato:

200

{
  "sku": {
    "name": "GP_Gen5_2",
    "tier": "GeneralPurpose",
    "family": "Gen5",
    "capacity": 2
  },
  "properties": {
    "administratorLogin": "cloudsa",
    "storageProfile": {
      "storageMB": 128000,
      "backupRetentionDays": 14,
      "geoRedundantBackup": "Enabled"
    },
    "version": "5.7",
    "sslEnforcement": "Enabled",
    "userVisibleState": "Ready",
    "fullyQualifiedDomainName": "targetserver.mysql.database.azure.com",
    "earliestRestoreDate": "2018-03-14T18:02:41.577+00:00",
    "replicationRole": "Replica",
    "masterServerId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/MasterResourceGroup/providers/Microsoft.DBforMySQL/servers/masterserver",
    "replicaCapacity": 0
  },
  "location": "westus",
  "tags": {
    "ElasticServer": "1"
  },
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TargetResourceGroup/providers/Microsoft.DBforMySQL/servers/targetserver",
  "name": "targetserver",
  "type": "Microsoft.DBforMySQL/servers"
}

Codice di stato:

202

Azure-AsyncOperation: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforMySQL/locations/southeastasia/azureAsyncOperation/e276a03a-1770-4549-86f5-0edffae8997c?api-version=2021-12-01-preview
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforMySQL/locations/southeastasia/operationResults/e276a03a-1770-4549-86f5-0edffae8997c?api-version=2021-12-01-preview

Create a server as a geo restore

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TargetResourceGroup/providers/Microsoft.DBforMySQL/servers/targetserver?api-version=2017-12-01

{
  "location": "westus",
  "properties": {
    "createMode": "GeoRestore",
    "sourceServerId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/SourceResourceGroup/providers/Microsoft.DBforMySQL/servers/sourceserver"
  },
  "sku": {
    "name": "GP_Gen5_2",
    "tier": "GeneralPurpose",
    "family": "Gen5",
    "capacity": 2
  },
  "tags": {
    "ElasticServer": "1"
  }
}

Python

from typing import Any, IO, Union

from azure.identity import DefaultAzureCredential

from azure.mgmt.rdbms.mysql import MySQLManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-rdbms
# USAGE
    python server_create_geo_restore_mode.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 = MySQLManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="ffffffff-ffff-ffff-ffff-ffffffffffff",
    )

    response = client.servers.begin_create(
        resource_group_name="TargetResourceGroup",
        server_name="targetserver",
        parameters={
            "location": "westus",
            "properties": {
                "createMode": "GeoRestore",
                "sourceServerId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/SourceResourceGroup/providers/Microsoft.DBforMySQL/servers/sourceserver",
            },
            "sku": {"capacity": 2, "family": "Gen5", "name": "GP_Gen5_2", "tier": "GeneralPurpose"},
            "tags": {"ElasticServer": "1"},
        },
    ).result()
    print(response)


# x-ms-original-file: specification/mysql/resource-manager/Microsoft.DBforMySQL/legacy/stable/2017-12-01/examples/ServerCreateGeoRestoreMode.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

dotnet

using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.MySql;
using Azure.ResourceManager.MySql.Models;
using Azure.ResourceManager.Resources;

// Generated from example definition: specification/mysql/resource-manager/Microsoft.DBforMySQL/legacy/stable/2017-12-01/examples/ServerCreateGeoRestoreMode.json
// this example is just showing the usage of "Servers_Create" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "ffffffff-ffff-ffff-ffff-ffffffffffff";
string resourceGroupName = "TargetResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this MySqlServerResource
MySqlServerCollection collection = resourceGroupResource.GetMySqlServers();

// invoke the operation
string serverName = "targetserver";
MySqlServerCreateOrUpdateContent content = new MySqlServerCreateOrUpdateContent(new MySqlServerPropertiesForGeoRestore(new ResourceIdentifier("/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/SourceResourceGroup/providers/Microsoft.DBforMySQL/servers/sourceserver")), new AzureLocation("westus"))
{
    Sku = new MySqlSku("GP_Gen5_2")
    {
        Tier = MySqlSkuTier.GeneralPurpose,
        Capacity = 2,
        Family = "Gen5",
    },
    Tags =
    {
    ["ElasticServer"] = "1",
    },
};
ArmOperation<MySqlServerResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, serverName, content);
MySqlServerResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
MySqlServerData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

Risposta di esempio

Codice di stato:

201

{
  "sku": {
    "name": "GP_Gen5_2",
    "tier": "GeneralPurpose",
    "family": "Gen5",
    "capacity": 2
  },
  "properties": {
    "administratorLogin": "cloudsa",
    "storageProfile": {
      "storageMB": 128000,
      "backupRetentionDays": 14,
      "geoRedundantBackup": "Enabled"
    },
    "version": "5.7",
    "sslEnforcement": "Enabled",
    "userVisibleState": "Ready",
    "fullyQualifiedDomainName": "targetserver.mysql.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.DBforMySQL/servers/targetserver",
  "name": "targetserver",
  "type": "Microsoft.DBforMySQL/servers"
}

Codice di stato:

200

{
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMySQL/servers/targetserver",
  "name": "targetserver",
  "type": "Microsoft.DBforMySQL/servers",
  "location": "westus",
  "sku": {
    "name": "GP_Gen5_2",
    "tier": "GeneralPurpose",
    "family": "Gen5",
    "capacity": 2
  },
  "tags": {
    "elasticServer": "1"
  },
  "properties": {
    "administratorLogin": "cloudsa",
    "storageProfile": {
      "storageMB": 128000,
      "backupRetentionDays": 14,
      "geoRedundantBackup": "Enabled"
    },
    "version": "5.7",
    "sslEnforcement": "Enabled",
    "userVisibleState": "Ready",
    "fullyQualifiedDomainName": "targetserver.mysql.database.azure.com",
    "earliestRestoreDate": "2018-03-14T18:02:41.577+00:00"
  }
}

Codice di stato:

202

Azure-AsyncOperation: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforMySQL/locations/southeastasia/azureAsyncOperation/e276a03a-1770-4549-86f5-0edffae8997c?api-version=2021-12-01-preview
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforMySQL/locations/southeastasia/operationResults/e276a03a-1770-4549-86f5-0edffae8997c?api-version=2021-12-01-preview

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.
IdentityType	Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di Azure Active Directory per la risorsa.
InfrastructureEncryption	Aggiungere un secondo livello di crittografia per i dati usando un nuovo algoritmo di crittografia che offre ulteriore protezione dei dati. Il valore è facoltativo, ma se passato, deve essere "Disabilitato" o "Abilitato".
MinimalTlsVersionEnum	Applicare una versione tls minima per il server.
PrivateEndpointProperty
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'
ResourceIdentity	Configurazione delle identità di Azure Active Directory per una risorsa.
Server	Rappresenta un server.
ServerForCreate	Rappresenta un server da creare.
ServerPrivateEndpointConnection	Una connessione endpoint privato in un server
ServerPrivateEndpointConnectionProperties	Proprietà di una connessione endpoint privato.
ServerPrivateLinkServiceConnectionStateProperty
ServerPropertiesForDefaultCreate	Proprietà usate per creare un nuovo server.
ServerPropertiesForGeoRestore	Le proprietà usate per creare un nuovo server ripristinando un'area diversa da un backup con replica geografica.
ServerPropertiesForReplica	Proprietà per creare una nuova replica.
ServerPropertiesForRestore	Le proprietà usate per creare un nuovo server ripristinando da un backup.
ServerState	Stato di un server visibile all'utente.
ServerVersion	Versione di un server.
Sku	Informazioni di fatturazione relative alle proprietà di un server.
SkuTier	Livello dello SKU specifico, ad esempio Basic.
SslEnforcementEnum	Abilitare l'applicazione ssl o meno quando ci si connette al server.
StorageAutogrow	Abilitare l'aumento automatico dell'archiviazione.
StorageProfile	Proprietà del profilo di archiviazione di un server

CloudError

Risposta di errore dal servizio Batch.

Nome	Tipo	Descrizione
error	ErrorResponse	Risposta di errore Risposta di errore comune per tutte le API di Resource Manager di Azure per restituire i dettagli degli errori per le operazioni non riuscite. Questo segue anche il formato di risposta di errore OData.

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

IdentityType

Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di Azure Active Directory per la risorsa.

Nome	Tipo	Descrizione
SystemAssigned	string

InfrastructureEncryption

Aggiungere un secondo livello di crittografia per i dati usando un nuovo algoritmo di crittografia che offre ulteriore protezione dei dati. Il valore è facoltativo, ma se passato, deve essere "Disabilitato" o "Abilitato".

Nome	Tipo	Descrizione
Disabled	string	Ulteriore livello di crittografia (secondo) per i dati inattivi
Enabled	string	Valore predefinito per un singolo livello di crittografia per i dati inattivi.

MinimalTlsVersionEnum

Applicare una versione tls minima per il server.

Nome	Tipo	Descrizione
TLS1_0	string
TLS1_1	string
TLS1_2	string
TLSEnforcementDisabled	string

PrivateEndpointProperty

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

ResourceIdentity

Configurazione delle identità di Azure Active Directory per una risorsa.

Nome	Tipo	Descrizione
principalId	string	ID entità di Azure Active Directory.
tenantId	string	ID tenant di Azure Active Directory.
type	IdentityType	Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di Azure Active Directory per la risorsa.

Server

Rappresenta un server.

Nome	Tipo	Descrizione
id	string	ID di risorsa completo per la risorsa. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ResourceIdentity	Identità di Azure Active Directory del server.
location	string	Posizione geografica in cui vive 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 (e è necessario per la creazione).
properties.byokEnforcement	string	Stato che mostra se la crittografia dei dati del server è abilitata con chiavi gestite dal cliente.
properties.earliestRestoreDate	string	Tempo di creazione del punto di ripristino più recente (formato ISO8601)
properties.fullyQualifiedDomainName	string	Nome di dominio completo di un server.
properties.infrastructureEncryption	InfrastructureEncryption	Stato che mostra se la crittografia dell'infrastruttura abilitata per il server.
properties.masterServerId	string	ID server master di un server di replica.
properties.minimalTlsVersion	MinimalTlsVersionEnum	Applicare una versione tls minima per il server.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	Elenco delle connessioni endpoint private in un server
properties.publicNetworkAccess	PublicNetworkAccessEnum	Se l'accesso alla rete pubblica è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere "Abilitato" o "Disabilitato"
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 l'applicazione ssl o meno 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 di risorse.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

ServerForCreate

Rappresenta un server da creare.

Nome	Tipo	Descrizione
identity	ResourceIdentity	Identità di Azure Active Directory del server.
location	string	La posizione in cui risiede la risorsa.
properties	ServerPropertiesForCreate: ServerPropertiesForDefaultCreate ServerPropertiesForGeoRestore ServerPropertiesForReplica ServerPropertiesForRestore	Proprietà del server.
sku	Sku	SKU (piano tariffario) del server.
tags	object	Metadati specifici dell'applicazione sotto forma di coppie chiave-valore.

ServerPrivateEndpointConnection

Una connessione 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 una connessione 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

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.

ServerPropertiesForDefaultCreate

Proprietà usate per creare un nuovo server.

Nome	Tipo	Descrizione
administratorLogin	string	Nome di accesso dell'amministratore di un server. Può essere specificato solo quando il server viene creato (e è necessario per la creazione). Il nome di accesso è obbligatorio durante l'aggiornamento della password.
administratorLoginPassword	string	Password dell'account di accesso dell'amministratore.
createMode	string: Default	Modalità per creare un nuovo server.
infrastructureEncryption	InfrastructureEncryption	Stato che mostra se la crittografia dell'infrastruttura abilitata per il server.
minimalTlsVersion	MinimalTlsVersionEnum	Applicare una versione tls minima per il server.
publicNetworkAccess	PublicNetworkAccessEnum	Se l'accesso alla rete pubblica è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere "Abilitato" o "Disabilitato"
sslEnforcement	SslEnforcementEnum	Abilitare l'applicazione ssl o meno quando ci si connette al server.
storageProfile	StorageProfile	Profilo di archiviazione di un server.
version	ServerVersion	Versione del server.

ServerPropertiesForGeoRestore

Le proprietà usate per creare un nuovo server ripristinando un'area diversa da un backup con replica geografica.

Nome	Tipo	Descrizione
createMode	string: GeoRestore	Modalità per creare un nuovo server.
infrastructureEncryption	InfrastructureEncryption	Stato che mostra se la crittografia dell'infrastruttura abilitata per il server.
minimalTlsVersion	MinimalTlsVersionEnum	Applicare una versione tls minima per il server.
publicNetworkAccess	PublicNetworkAccessEnum	Se l'accesso alla rete pubblica è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere "Abilitato" o "Disabilitato"
sourceServerId	string	ID del server di origine da cui eseguire il ripristino.
sslEnforcement	SslEnforcementEnum	Abilitare l'applicazione ssl o meno quando ci si connette al server.
storageProfile	StorageProfile	Profilo di archiviazione di un server.
version	ServerVersion	Versione del server.

ServerPropertiesForReplica

Proprietà per creare una nuova replica.

Nome	Tipo	Descrizione
createMode	string: Replica	Modalità per creare un nuovo server.
infrastructureEncryption	InfrastructureEncryption	Stato che mostra se la crittografia dell'infrastruttura abilitata per il server.
minimalTlsVersion	MinimalTlsVersionEnum	Applicare una versione tls minima per il server.
publicNetworkAccess	PublicNetworkAccessEnum	Se l'accesso alla rete pubblica è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere "Abilitato" o "Disabilitato"
sourceServerId	string	ID server master da cui creare la replica.
sslEnforcement	SslEnforcementEnum	Abilitare l'applicazione ssl o meno quando ci si connette al server.
storageProfile	StorageProfile	Profilo di archiviazione di un server.
version	ServerVersion	Versione del server.

ServerPropertiesForRestore

Le proprietà usate per creare un nuovo server ripristinando da un backup.

Nome	Tipo	Descrizione
createMode	string: PointInTimeRestore	Modalità per creare un nuovo server.
infrastructureEncryption	InfrastructureEncryption	Stato che mostra se la crittografia dell'infrastruttura abilitata per il server.
minimalTlsVersion	MinimalTlsVersionEnum	Applicare una versione tls minima per il server.
publicNetworkAccess	PublicNetworkAccessEnum	Se l'accesso alla rete pubblica è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere "Abilitato" o "Disabilitato"
restorePointInTime	string	Tempo di creazione del punto di ripristino (ISO8601 formato), specificando il tempo da cui eseguire il ripristino.
sourceServerId	string	ID del server di origine da cui eseguire il ripristino.
sslEnforcement	SslEnforcementEnum	Abilitare l'applicazione ssl o meno quando ci si connette al server.
storageProfile	StorageProfile	Profilo di archiviazione di un server.
version	ServerVersion	Versione del server.

ServerState

Stato di un server visibile all'utente.

Nome	Tipo	Descrizione
Disabled	string
Dropping	string
Inaccessible	string
Ready	string

ServerVersion

Versione di un server.

Nome	Tipo	Descrizione
5.6	string
5.7	string
8.0	string

Sku

Informazioni di fatturazione relative alle proprietà di un server.

Nome	Tipo	Descrizione
capacity	integer	Capacità di scalabilità orizzontale/out, che rappresenta le unità di calcolo del server.
family	string	Famiglia di hardware.
name	string	Nome dello sku, in genere, livello + famiglia + core, ad esempio B_Gen4_1, GP_Gen5_8.
size	string	Codice di dimensione 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 l'applicazione ssl o meno 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

Proprietà del 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.