Server Dns Aliases - Acquire

Service:

SQL Database

API Version:

2021-11-01

別のサーバーからサーバー DNS エイリアスを取得します。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/dnsAliases/{dnsAliasName}/acquire?api-version=2021-11-01

URI パラメーター

名前	/	必須	型	説明
dnsAliasName	path	True	string	サーバー DNS エイリアスの名前。
resourceGroupName	path	True	string	リソースが含まれているリソース グループの名前。 この値は、Azure リソース マネージャー API またはポータルから取得できます。
serverName	path	True	string	別名が指すサーバーの名前。
subscriptionId	path	True	string	Azure サブスクリプションを識別するサブスクリプション ID。
api-version	query	True	string	要求で使用する API のバージョン。

要求本文

名前	必須	型	説明
oldServerDnsAliasId	True	string	代わりに、このサーバーを指すように取得されるサーバー エイリアスの ID。

応答

名前	型	説明
200 OK	ServerDnsAlias	サーバー DNS エイリアスが正常に取得されました。
202 Accepted		同意
Other Status Codes		エラー応答: *** 400 InvalidServerDnsAliasAcquireRequest - 取得サーバー DNS エイリアス要求本文が空または無効です (古いサーバー エイリアス ID が含まれている必要があります。 例: /subscriptions/00000000-1111-2222-3333-4444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1)。 400 ServerDnsAliasAcquireRequestInvalidOldServerDnsAliasId - 要求本文の古いサーバー DNS エイリアス ID が空または無効です (/subscriptions/000000000-1111-2222-3333-44444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1)。 400 ServerDnsAliasDoesNotExist - サーバー DNS エイリアスがサーバー上に存在しません。 400 UnableToTurnOnTableAuditingForDbOnServerWithServerDnsAlias - テーブル監査が有効になっているデータベースに対してサーバー DNS エイリアスが正しく機能しない 400 UnableToCreateServerDnsAliasDueToTableAuditing - テーブル監査が有効になっているサーバーに対してサーバー DNS エイリアスを作成できません。 400 UnableToCreateServerDnsAliasDueToTableAuditingForDb - データベース '' にテーブル監査またはセキュリティが有効なアクセス機能が有効になっているため、サーバー '{0}{1}' に対してサーバー DNS エイリアスを作成できません。 400 LimitOfServerDnsAliasesPerServerExceeded - 新しいサーバー DNS エイリアスの作成は、サーバーあたりのサーバー DNS エイリアスの許可数を超えます。 400 UnableToTurnOnTableAuditingForServerWithServerDnsAlias - テーブル監査が有効になっているサーバーでサーバー DNS エイリアスが正しく機能しない 400 CannotUseReservedDatabaseName - この操作では予約データベース名を使用できません。 400 TokenTooLong - 指定されたトークンが長すぎます。 400 UnableToResolveRemoteServer - 無効なサーバー名または DNS 接続の問題により、リモート パートナー サーバー名を解決できませんでした。 400 InvalidServerName - 指定されたサーバー名が無効です。 400 InvalidIdentifier - 識別子に NULL または無効な Unicode 文字が含まれています。 400 InvalidServerDnsAliasName - 無効なサーバー DNS エイリアス名が指定されました。 400 ServerNotFound - 要求されたサーバーが見つかりませんでした。 404 OperationIdNotFound - Id を持つ操作が存在しません。 404 ResourceNotFound - 要求されたリソースが見つかりませんでした。 404 OperationIdNotFound - Id を持つ操作が存在しません。 404 ServerNotInSubscriptionResourceGroup - 指定されたサーバーが、指定されたリソース グループとサブスクリプションに存在しません。 404 ServerNotInSubscription - 指定されたサブスクリプションに指定されたサーバーが存在しません。 409 OperationCancelled - 操作がユーザーによって取り消されました。 409 OperationInterrupted - 同じリソースに対する別の操作によって中断されたため、リソースに対する操作を完了できませんでした。 409 ServerDnsAliasBusy - サーバー DNS エイリアスが別の操作でビジー状態です。 409 SubscriptionDisabled - サブスクリプションが無効になっています。 409 ServerDnsAliasDnsRecordInUse - 要求されたエンドポイントに重複する DNS レコードが存在します。 409 ServerDnsAliasAlreadyExists - サーバー DNS エイリアスは、特定のサーバーに既に存在します。 409 ConflictingServerOperation - サーバーの操作は現在進行中です。 429 SubscriptionTooManyCreateUpdateRequests - 使用可能なリソースによって処理できる最大要求数を超える要求。 429 SubscriptionTooManyRequests - 使用可能なリソースによって処理できる最大要求を超える要求。 429 SubscriptionTooManyCreateUpdateRequests - 使用可能なリソースによって処理できる最大要求数を超える要求。 429 SubscriptionTooManyRequests - 使用可能なリソースによって処理できる最大要求を超える要求。 500 OperationTimedOut - 操作がタイムアウトし、自動的にロールバックされました。 操作をやり直してください。 503 TooManyRequests - 使用可能なリソースによって処理できる最大要求数を超える要求。 503 TooManyRequests - 使用可能なリソースによって処理できる最大要求数を超える要求。 504 RequestTimeout - サービス要求が許可されたタイムアウトを超えました。

例

Acquire server DNS alias

Sample Request

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-new-server/dnsAliases/dns-alias-name-1/acquire?api-version=2021-11-01

{
  "oldServerDnsAliasId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1"
}

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.models.ServerDnsAliasAcquisition;

/** Samples for ServerDnsAliases Acquire. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ServerDnsAliasAcquire.json
     */
    /**
     * Sample code: Acquire server DNS alias.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void acquireServerDNSAlias(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServerDnsAliases().acquire("Default", "dns-alias-new-server",
            "dns-alias-name-1",
            new ServerDnsAliasAcquisition().withOldServerDnsAliasId(
                "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1"),
            Context.NONE);
    }
}

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

Sample Response

Status code:

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-new-server/dnsAliases/dns-alias-name-1",
  "name": "server-dns-alias-name-1",
  "type": "Microsoft.Sql/servers/dnsAliases",
  "properties": {
    "azureDnsRecord": "dns-alias-name-1.database.windows.net"
  }
}

Status code:

202

定義

名前	説明
ServerDnsAlias	サーバー DNS エイリアス。
ServerDnsAliasAcquisition	サーバー DNS エイリアス取得要求。

ServerDnsAlias

サーバー DNS エイリアス。

名前	型	説明
id	string	リソースの ID
name	string	リソース名。
properties.azureDnsRecord	string	エイリアスの完全修飾 DNS レコード
type	string	リソースの種類。

ServerDnsAliasAcquisition

サーバー DNS エイリアス取得要求。

名前	型	説明
oldServerDnsAliasId	string	代わりに、このサーバーを指すように取得されるサーバー エイリアスの ID。