Managed Server Dns Aliases - Acquire

リファレンス

サービス:: SQL Database

API バージョン:: 2021-11-01

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

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

URI パラメーター

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

要求本文

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

応答

名前	型	説明
200 OK	ManagedServerDnsAlias	マネージドサーバーの DNS エイリアスが正常に取得されました。
202 Accepted		同意
Other Status Codes		エラー応答: *** 400 InvalidManagedServerDnsAliasAcquireRequest - マネージドサーバーの DNS エイリアスの取得要求本文が空または無効です。 400 ManagedServerDnsAliasAcquireRequestInvalidOldManagedServerDnsAliasResourceId - 要求本文の古いマネージドサーバー DNS エイリアス ID が空または無効です (形式は /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstanceName}/dnsAliasName/{dnsAliasName} です)。 400 ManagedServerDnsAliasAcquireRequestOldManagedServerDnsAliasSubscriptionMismatch - 要求本文の古いマネージドサーバー DNS サブスクリプション ID は、要求 URI の ID とは異なります。 400 ManagedServerDnsAliasAcquireRequestOldManagedServerDnsAliasNameMismatch - 要求本文の古いマネージドサーバー DNS エイリアス名は、要求 URI の名前とは異なります。 400 ServerDnsAliasDoesNotExist - サーバー DNS エイリアスがサーバー上に存在しません。 400 UnableToTurnOnTableAuditingForDbOnServerWithServerDnsAlias - テーブル監査が有効になっているデータベースに対してサーバー DNS エイリアスが正しく機能しない 400 UnableToCreateServerDnsAliasDueToTableAuditing - テーブル監査が有効になっているサーバーに対してサーバー DNS エイリアスを作成できません。 400 UnableToCreateServerDnsAliasDueToTableAuditingForDb - データベース '' にテーブル監査またはセキュリティが有効なアクセス機能が有効になっているため、サーバー '{0}{1}' に対してサーバー DNS エイリアスを作成できません。 400 LimitOfServerDnsAliasesPerServerExceeded - 新しいサーバー DNS エイリアスの作成は、サーバーあたりのサーバー DNS エイリアスの許可数を超えます。 400 UnableToTurnOnTableAuditingForServerWithServerDnsAlias - テーブル監査が有効になっているサーバーでサーバー DNS エイリアスが正しく機能しない 400 NameAlreadyExists - 指定された名前は既に存在します。 400 CannotUseReservedDatabaseName - この操作では予約データベース名を使用できません。 400 TokenTooLong - 指定されたトークンが長すぎます。 400 InvalidServerDnsAliasNameForNamedInstance - 無効なサーバー DNS エイリアス名が指定されました。 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 ManagedServerAliasDnsZoneMismatch - Managed Server Alias Dns Zone Mismatch 409 ServerDnsAliasDnsRecordInUse - 要求されたエンドポイントに重複する DNS レコードが存在します。 409 ServerDnsAliasAlreadyExists - サーバー DNS エイリアスは、特定のサーバーに既に存在します。 409 ConflictingServerOperation - サーバーの操作は現在進行中です。 429 SubscriptionTooManyCreateUpdateRequests - 使用可能なリソースによって処理できる最大要求数を超える要求。 429 SubscriptionTooManyRequests - 使用可能なリソースによって処理できる最大要求を超える要求。 429 SubscriptionTooManyCreateUpdateRequests - 使用可能なリソースによって処理できる最大要求数を超える要求。 429 SubscriptionTooManyRequests - 使用可能なリソースによって処理できる最大要求を超える要求。 500 OperationTimedOut - 操作がタイムアウトし、自動的にロールバックされました。操作をやり直してください。 503 TooManyRequests - 使用可能なリソースによって処理できる最大要求数を超える要求。 503 TooManyRequests - 使用可能なリソースによって処理できる最大要求数を超える要求。 504 RequestTimeout - サービス要求が許可されたタイムアウトを超えました。

名前

型

説明

200 OK

ManagedServerDnsAlias

マネージドサーバーの DNS エイリアスが正常に取得されました。

202 Accepted

同意

Other Status Codes

エラー応答: ***

400 InvalidManagedServerDnsAliasAcquireRequest - マネージドサーバーの DNS エイリアスの取得要求本文が空または無効です。
400 ManagedServerDnsAliasAcquireRequestInvalidOldManagedServerDnsAliasResourceId - 要求本文の古いマネージドサーバー DNS エイリアス ID が空または無効です (形式は /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstanceName}/dnsAliasName/{dnsAliasName} です)。
400 ManagedServerDnsAliasAcquireRequestOldManagedServerDnsAliasSubscriptionMismatch - 要求本文の古いマネージドサーバー DNS サブスクリプション ID は、要求 URI の ID とは異なります。
400 ManagedServerDnsAliasAcquireRequestOldManagedServerDnsAliasNameMismatch - 要求本文の古いマネージドサーバー DNS エイリアス名は、要求 URI の名前とは異なります。
400 ServerDnsAliasDoesNotExist - サーバー DNS エイリアスがサーバー上に存在しません。
400 UnableToTurnOnTableAuditingForDbOnServerWithServerDnsAlias - テーブル監査が有効になっているデータベースに対してサーバー DNS エイリアスが正しく機能しない
400 UnableToCreateServerDnsAliasDueToTableAuditing - テーブル監査が有効になっているサーバーに対してサーバー DNS エイリアスを作成できません。
400 UnableToCreateServerDnsAliasDueToTableAuditingForDb - データベース '' にテーブル監査またはセキュリティが有効なアクセス機能が有効になっているため、サーバー '{0}{1}' に対してサーバー DNS エイリアスを作成できません。
400 LimitOfServerDnsAliasesPerServerExceeded - 新しいサーバー DNS エイリアスの作成は、サーバーあたりのサーバー DNS エイリアスの許可数を超えます。
400 UnableToTurnOnTableAuditingForServerWithServerDnsAlias - テーブル監査が有効になっているサーバーでサーバー DNS エイリアスが正しく機能しない
400 NameAlreadyExists - 指定された名前は既に存在します。
400 CannotUseReservedDatabaseName - この操作では予約データベース名を使用できません。
400 TokenTooLong - 指定されたトークンが長すぎます。
400 InvalidServerDnsAliasNameForNamedInstance - 無効なサーバー DNS エイリアス名が指定されました。
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 ManagedServerAliasDnsZoneMismatch - Managed Server Alias Dns Zone Mismatch
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 managed server DNS alias.

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

{
  "oldManagedServerDnsAliasResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/old-mi/dnsAliases/alias1"
}


import com.azure.resourcemanager.sql.models.ManagedServerDnsAliasAcquisition;

/**
 * Samples for ManagedServerDnsAliases Acquire.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedServerDnsAliasAcquire.json
     */
    /**
     * Sample code: Acquire managed server DNS alias.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void acquireManagedServerDNSAlias(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedServerDnsAliases().acquire("Default", "new-mi",
            "dns-alias-mi",
            new ManagedServerDnsAliasAcquisition().withOldManagedServerDnsAliasResourceId(
                "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/old-mi/dnsAliases/alias1"),
            com.azure.core.util.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

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/new-mi/dnsAliases/alias1",
  "name": "alias1",
  "type": "Microsoft.Sql/managedInstances/dnsAliases",
  "properties": {
    "azureDnsRecord": "alias1.abcd1234.database.windows.net"
  }
}

状態コード:: 202

定義

名前	説明
ManagedServerDnsAlias	マネージドサーバーの DNS エイリアス。
ManagedServerDnsAliasAcquisition	マネージドサーバーの DNS エイリアス取得要求。

ManagedServerDnsAlias

マネージドサーバーの DNS エイリアス。

名前	型	説明
id	string	リソースの ID
name	string	リソース名。
properties.azureDnsRecord	string	マネージドサーバーエイリアスの完全修飾 DNS レコード
properties.publicAzureDnsRecord	string	マネージドサーバーエイリアスの完全修飾パブリック DNS レコード
type	string	リソースの種類。

ManagedServerDnsAliasAcquisition

マネージドサーバーの DNS エイリアス取得要求。

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

次の方法で共有

Managed Server Dns Aliases - Acquire

URI パラメーター

要求本文

応答

例

Acquire managed server DNS alias.

要求のサンプル

応答のサンプル

定義

ManagedServerDnsAlias

ManagedServerDnsAliasAcquisition

その他のリソース