Servers - Create

リファレンス

サービス:: MySQL

API バージョン:: 2017-12-01

新しいサーバーを作成するか、既存のサーバーを更新します。更新アクションによって、既存のサーバーが上書きされます。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMySQL/servers/{serverName}?api-version=2017-12-01

URI パラメーター

名前	/	必須	型	説明
resourceGroupName	path	True	string minLength: 1 maxLength: 90	リソースグループの名前。名前では大文字と小文字が区別されません。
serverName	path	True	string	サーバーの名前。
subscriptionId	path	True	string minLength: 1	ターゲットサブスクリプションの ID。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

要求本文

名前	必須	型	説明
location	True	string	リソースが存在する場所。
properties	True	ServerPropertiesForCreate: ServerPropertiesForDefaultCreate ServerPropertiesForRestore ServerPropertiesForGeoRestore ServerPropertiesForReplica	サーバーのプロパティ。
identity		ResourceIdentity	サーバーの Azure Active Directory ID。
sku		Sku	サーバーの SKU (価格レベル)。
tags		object	キーと値のペアの形式のアプリケーション固有のメタデータ。

応答

名前	型	説明
200 OK	Server	わかりました
201 Created	Server	作成
202 Accepted		受け入れられた
Other Status Codes	CloudError	操作が失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
user_impersonation	ユーザーアカウントを偽装する

例

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

要求のサンプル

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

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

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

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

応答のサンプル

状態コード:: 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"
}

状態コード:: 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"
  }
}

状態コード:: 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

要求のサンプル

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

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

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

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

応答のサンプル

状態コード:: 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"
}

状態コード:: 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"
  }
}

状態コード:: 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

要求のサンプル

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

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

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

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

応答のサンプル

状態コード:: 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"
}

状態コード:: 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"
}

状態コード:: 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

要求のサンプル

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

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

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

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

応答のサンプル

状態コード:: 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"
}

状態コード:: 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"
  }
}

状態コード:: 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

定義

名前	説明
CloudError	Batch サービスからのエラー応答。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorResponse	エラー応答
GeoRedundantBackup	Geo 冗長を有効にするか、サーバーバックアップ用に有効にしないか。
IdentityType	ID の種類。リソースの Azure Active Directory プリンシパルを自動的に作成して割り当てるには、これを "SystemAssigned" に設定します。
InfrastructureEncryption	データ保護を強化する新しい暗号化アルゴリズムを使用して、データの 2 つ目の暗号化レイヤーを追加します。値は省略可能ですが、渡される場合は 'Disabled' または 'Enabled' である必要があります。
MinimalTlsVersionEnum	サーバーに最小限の Tls バージョンを適用します。
PrivateEndpointProperty
PrivateEndpointProvisioningState	プライベートエンドポイント接続の状態。
PrivateLinkServiceConnectionStateActionsRequire	プライベートリンクサービス接続に必要なアクション。
PrivateLinkServiceConnectionStateStatus	プライベートリンクサービスの接続状態。
PublicNetworkAccessEnum	このサーバーに対してパブリックネットワークアクセスが許可されているかどうか。値は省略可能ですが、渡される場合は 'Enabled' または 'Disabled' である必要があります
ResourceIdentity	リソースの Azure Active Directory ID 構成。
Server	サーバーを表します。
ServerForCreate	作成するサーバーを表します。
ServerPrivateEndpointConnection	サーバーの下のプライベートエンドポイント接続
ServerPrivateEndpointConnectionProperties	プライベートエンドポイント接続のプロパティ。
ServerPrivateLinkServiceConnectionStateProperty
ServerPropertiesForDefaultCreate	新しいサーバーの作成に使用されるプロパティ。
ServerPropertiesForGeoRestore	geo レプリケートバックアップとは異なるリージョンに復元することで、新しいサーバーを作成するために使用されるプロパティ。
ServerPropertiesForReplica	新しいレプリカを作成するプロパティ。
ServerPropertiesForRestore	バックアップから復元して新しいサーバーを作成するために使用されるプロパティ。
ServerState	ユーザーに表示されるサーバーの状態。
ServerVersion	サーバーのバージョン。
Sku	サーバーの課金情報に関連するプロパティ。
SkuTier	特定の SKU のレベル (Basic など)。
SslEnforcementEnum	サーバーに接続するときに SSL 強制を有効にするか、有効にしないか。
StorageAutogrow	ストレージの自動拡張を有効にします。
StorageProfile	サーバーのストレージプロファイルプロパティ

CloudError

Object

Batch サービスからのエラー応答。

名前	型	説明
error	ErrorResponse	エラー応答失敗した操作のエラーの詳細を返す、すべての Azure Resource Manager API の一般的なエラー応答。 (これは、OData エラー応答形式にも従います)。

ErrorAdditionalInfo

Object

リソース管理エラーの追加情報。

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ErrorResponse

Object

エラー応答

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラーコード。
details	ErrorResponse[]	エラーの詳細。
message	string	エラーメッセージ。
target	string	エラーターゲット。

GeoRedundantBackup

列挙

Geo 冗長を有効にするか、サーバーバックアップ用に有効にしないか。

値	説明
Disabled
Enabled

IdentityType

列挙

ID の種類。リソースの Azure Active Directory プリンシパルを自動的に作成して割り当てるには、これを "SystemAssigned" に設定します。

値	説明
SystemAssigned

InfrastructureEncryption

列挙

データ保護を強化する新しい暗号化アルゴリズムを使用して、データの 2 つ目の暗号化レイヤーを追加します。値は省略可能ですが、渡される場合は 'Disabled' または 'Enabled' である必要があります。

値	説明
Disabled	保存データの追加 (第 2) 層の暗号化
Enabled	保存データの暗号化の単一レイヤーの既定値。

MinimalTlsVersionEnum

列挙

サーバーに最小限の Tls バージョンを適用します。

値	説明
TLS1_0
TLS1_1
TLS1_2
TLSEnforcementDisabled

PrivateEndpointProperty

Object

名前	型	説明
id	string	プライベートエンドポイントのリソース ID。

PrivateEndpointProvisioningState

列挙

プライベートエンドポイント接続の状態。

値	説明
Approving
Dropping
Failed
Ready
Rejecting

PrivateLinkServiceConnectionStateActionsRequire

列挙

プライベートリンクサービス接続に必要なアクション。

値	説明
None

PrivateLinkServiceConnectionStateStatus

列挙

プライベートリンクサービスの接続状態。

値	説明
Approved
Disconnected
Pending
Rejected

PublicNetworkAccessEnum

列挙

このサーバーに対してパブリックネットワークアクセスが許可されているかどうか。値は省略可能ですが、渡される場合は 'Enabled' または 'Disabled' である必要があります

値	説明
Disabled
Enabled

ResourceIdentity

Object

リソースの Azure Active Directory ID 構成。

名前	型	説明
principalId	string (uuid)	Azure Active Directory プリンシパル ID。
tenantId	string (uuid)	Azure Active Directory テナント ID。
type	IdentityType	ID の種類。リソースの Azure Active Directory プリンシパルを自動的に作成して割り当てるには、これを "SystemAssigned" に設定します。

Server

Object

サーバーを表します。

名前	型	説明
id	string	リソースの完全修飾リソース ID。例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ResourceIdentity	サーバーの Azure Active Directory ID。
location	string	リソースが存在する地理的な場所
name	string	リソースの名前
properties.administratorLogin	string	サーバーの管理者のログイン名。サーバーの作成時にのみ指定できます (作成に必要です)。
properties.byokEnforcement	string	カスタマーマネージドキーでサーバーデータ暗号化が有効になっているかどうかを示す状態。
properties.earliestRestoreDate	string (date-time)	最も早い復元ポイントの作成時刻 (ISO8601形式)
properties.fullyQualifiedDomainName	string	サーバーの完全修飾ドメイン名。
properties.infrastructureEncryption	InfrastructureEncryption	サーバーでインフラストラクチャ暗号化が有効になっているかどうかを示す状態。
properties.masterServerId	string	レプリカサーバーのマスターサーバー ID。
properties.minimalTlsVersion	MinimalTlsVersionEnum	サーバーに最小限の Tls バージョンを適用します。
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	サーバー上のプライベートエンドポイント接続の一覧
properties.publicNetworkAccess	PublicNetworkAccessEnum	このサーバーに対してパブリックネットワークアクセスが許可されているかどうか。値は省略可能ですが、渡される場合は 'Enabled' または 'Disabled' である必要があります
properties.replicaCapacity	integer (int32) minimum: 0	マスターサーバーで使用できるレプリカの最大数。
properties.replicationRole	string	サーバーのレプリケーションロール。
properties.sslEnforcement	SslEnforcementEnum	サーバーに接続するときに SSL 強制を有効にするか、有効にしないか。
properties.storageProfile	StorageProfile	サーバーのストレージプロファイル。
properties.userVisibleState	ServerState	ユーザーに表示されるサーバーの状態。
properties.version	ServerVersion	サーバーのバージョン。
sku	Sku	サーバーの SKU (価格レベル)。
tags	object	リソースタグ。
type	string	リソースの種類。例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

ServerForCreate

Object

作成するサーバーを表します。

名前	型	説明
identity	ResourceIdentity	サーバーの Azure Active Directory ID。
location	string	リソースが存在する場所。
properties	ServerPropertiesForCreate: ServerPropertiesForDefaultCreate ServerPropertiesForGeoRestore ServerPropertiesForReplica ServerPropertiesForRestore	サーバーのプロパティ。
sku	Sku	サーバーの SKU (価格レベル)。
tags	object	キーと値のペアの形式のアプリケーション固有のメタデータ。

ServerPrivateEndpointConnection

Object

サーバーの下のプライベートエンドポイント接続

名前	型	説明
id	string	プライベートエンドポイント接続のリソース ID。
properties	ServerPrivateEndpointConnectionProperties	プライベートエンドポイント接続のプロパティ

ServerPrivateEndpointConnectionProperties

Object

プライベートエンドポイント接続のプロパティ。

名前	型	説明
privateEndpoint	PrivateEndpointProperty	接続が属するプライベートエンドポイント。
privateLinkServiceConnectionState	ServerPrivateLinkServiceConnectionStateProperty	プライベートエンドポイント接続の接続状態。
provisioningState	PrivateEndpointProvisioningState	プライベートエンドポイント接続の状態。

ServerPrivateLinkServiceConnectionStateProperty

Object

名前	型	説明
actionsRequired	PrivateLinkServiceConnectionStateActionsRequire	プライベートリンクサービス接続に必要なアクション。
description	string	プライベートリンクサービスの接続の説明。
status	PrivateLinkServiceConnectionStateStatus	プライベートリンクサービスの接続状態。

ServerPropertiesForDefaultCreate

Object

新しいサーバーの作成に使用されるプロパティ。

名前	型	説明
administratorLogin	string	サーバーの管理者のログイン名。サーバーの作成時にのみ指定できます (作成に必要です)。パスワードを更新するときは、ログイン名が必要です。
administratorLoginPassword	string (password)	管理者ログインのパスワード。
createMode	string: Default	新しいサーバーを作成するモード。
infrastructureEncryption	InfrastructureEncryption	サーバーでインフラストラクチャ暗号化が有効になっているかどうかを示す状態。
minimalTlsVersion	MinimalTlsVersionEnum	サーバーに最小限の Tls バージョンを適用します。
publicNetworkAccess	PublicNetworkAccessEnum	このサーバーに対してパブリックネットワークアクセスが許可されているかどうか。値は省略可能ですが、渡される場合は 'Enabled' または 'Disabled' である必要があります
sslEnforcement	SslEnforcementEnum	サーバーに接続するときに SSL 強制を有効にするか、有効にしないか。
storageProfile	StorageProfile	サーバーのストレージプロファイル。
version	ServerVersion	サーバーのバージョン。

ServerPropertiesForGeoRestore

Object

geo レプリケートバックアップとは異なるリージョンに復元することで、新しいサーバーを作成するために使用されるプロパティ。

名前	型	説明
createMode	string: GeoRestore	新しいサーバーを作成するモード。
infrastructureEncryption	InfrastructureEncryption	サーバーでインフラストラクチャ暗号化が有効になっているかどうかを示す状態。
minimalTlsVersion	MinimalTlsVersionEnum	サーバーに最小限の Tls バージョンを適用します。
publicNetworkAccess	PublicNetworkAccessEnum	このサーバーに対してパブリックネットワークアクセスが許可されているかどうか。値は省略可能ですが、渡される場合は 'Enabled' または 'Disabled' である必要があります
sourceServerId	string	復元元のソースサーバー ID。
sslEnforcement	SslEnforcementEnum	サーバーに接続するときに SSL 強制を有効にするか、有効にしないか。
storageProfile	StorageProfile	サーバーのストレージプロファイル。
version	ServerVersion	サーバーのバージョン。

ServerPropertiesForReplica

Object

新しいレプリカを作成するプロパティ。

名前	型	説明
createMode	string: Replica	新しいサーバーを作成するモード。
infrastructureEncryption	InfrastructureEncryption	サーバーでインフラストラクチャ暗号化が有効になっているかどうかを示す状態。
minimalTlsVersion	MinimalTlsVersionEnum	サーバーに最小限の Tls バージョンを適用します。
publicNetworkAccess	PublicNetworkAccessEnum	このサーバーに対してパブリックネットワークアクセスが許可されているかどうか。値は省略可能ですが、渡される場合は 'Enabled' または 'Disabled' である必要があります
sourceServerId	string	レプリカを作成するマスターサーバー ID。
sslEnforcement	SslEnforcementEnum	サーバーに接続するときに SSL 強制を有効にするか、有効にしないか。
storageProfile	StorageProfile	サーバーのストレージプロファイル。
version	ServerVersion	サーバーのバージョン。

ServerPropertiesForRestore

Object

バックアップから復元して新しいサーバーを作成するために使用されるプロパティ。

名前	型	説明
createMode	string: PointInTimeRestore	新しいサーバーを作成するモード。
infrastructureEncryption	InfrastructureEncryption	サーバーでインフラストラクチャ暗号化が有効になっているかどうかを示す状態。
minimalTlsVersion	MinimalTlsVersionEnum	サーバーに最小限の Tls バージョンを適用します。
publicNetworkAccess	PublicNetworkAccessEnum	このサーバーに対してパブリックネットワークアクセスが許可されているかどうか。値は省略可能ですが、渡される場合は 'Enabled' または 'Disabled' である必要があります
restorePointInTime	string (date-time)	復元ポイントの作成時刻 (ISO8601形式)。復元元の時刻を指定します。
sourceServerId	string	復元元のソースサーバー ID。
sslEnforcement	SslEnforcementEnum	サーバーに接続するときに SSL 強制を有効にするか、有効にしないか。
storageProfile	StorageProfile	サーバーのストレージプロファイル。
version	ServerVersion	サーバーのバージョン。

ServerState

列挙

ユーザーに表示されるサーバーの状態。

値	説明
Disabled
Dropping
Inaccessible
Ready

ServerVersion

列挙

サーバーのバージョン。

値	説明
5.6
5.7
8.0

Sku

Object

サーバーの課金情報に関連するプロパティ。

名前	型	説明
capacity	integer (int32) minimum: 0	サーバーのコンピューティングユニットを表すスケールアップ/スケールアウト容量。
family	string	ハードウェアのファミリ。
name	string	sku の名前。通常は、階層 + ファミリ + コア (B_Gen4_1、GP_Gen5_8など)。
size	string	必要に応じてリソースによって解釈されるサイズコード。
tier	SkuTier	特定の SKU のレベル (Basic など)。

SkuTier

列挙

特定の SKU のレベル (Basic など)。

値	説明
Basic
GeneralPurpose
MemoryOptimized

SslEnforcementEnum

列挙

サーバーに接続するときに SSL 強制を有効にするか、有効にしないか。

値	説明
Disabled
Enabled

StorageAutogrow

列挙

ストレージの自動拡張を有効にします。

値	説明
Disabled
Enabled

StorageProfile

Object

サーバーのストレージプロファイルプロパティ

名前	型	説明
backupRetentionDays	integer (int32)	サーバーのバックアップ保有日数。
geoRedundantBackup	GeoRedundantBackup	Geo 冗長を有効にするか、サーバーバックアップ用に有効にしないか。
storageAutogrow	StorageAutogrow	ストレージの自動拡張を有効にします。
storageMB	integer (int32)	サーバーに対して許可される最大ストレージ数。

次の方法で共有

Servers - Create

URI パラメーター

要求本文

応答

セキュリティ

azure_auth

スコープ

例

Create a database as a point in time restore

要求のサンプル

応答のサンプル

Create a new server

要求のサンプル

応答のサンプル

Create a replica server

要求のサンプル

応答のサンプル

Create a server as a geo restore

要求のサンプル

応答のサンプル

定義

CloudError

ErrorAdditionalInfo

ErrorResponse

GeoRedundantBackup

IdentityType

InfrastructureEncryption

MinimalTlsVersionEnum

PrivateEndpointProperty

PrivateEndpointProvisioningState

PrivateLinkServiceConnectionStateActionsRequire

PrivateLinkServiceConnectionStateStatus

PublicNetworkAccessEnum

ResourceIdentity

Server

ServerForCreate

ServerPrivateEndpointConnection

ServerPrivateEndpointConnectionProperties

ServerPrivateLinkServiceConnectionStateProperty

ServerPropertiesForDefaultCreate

ServerPropertiesForGeoRestore

ServerPropertiesForReplica

ServerPropertiesForRestore

ServerState

ServerVersion

Sku

SkuTier

SslEnforcementEnum

StorageAutogrow

StorageProfile

その他のリソース