Server Dns Aliases - Acquire

서비스:

SQL Database

API 버전:

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 매개 변수

Name	In(다음 안에)	필수	형식	Description
dnsAliasName	path	True	string	서버 dns 별칭의 이름입니다.
resourceGroupName	path	True	string	리소스를 포함하는 리소스 그룹의 이름입니다. Azure Resource Manager API 또는 포털에서 이 값을 가져올 수 있습니다.
serverName	path	True	string	별칭이 가리키는 서버의 이름입니다.
subscriptionId	path	True	string	Azure 구독을 식별하는 구독 ID입니다.
api-version	query	True	string	요청에 사용할 API 버전입니다.

요청 본문

Name	필수	형식	Description
oldServerDnsAliasId	True	string	대신 이 서버를 가리키도록 획득할 서버 별칭의 ID입니다.

응답

Name	형식	Description
200 OK	ServerDnsAlias	서버 DNS 별칭을 성공적으로 획득했습니다.
202 Accepted		수락됨
Other Status Codes		오류 응답: *** 400 InvalidServerDnsAliasAcquireRequest - 획득 서버 DNS 별칭 요청 본문이 비어 있거나 잘못되었습니다(이전 서버 별칭 ID를 포함해야 함, 예: /subscriptions/000000000-1111-2222-3333-44444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1). 400 ServerDnsAliasAcquireRequestInvalidOldServerDnsAliasId - 요청 본문의 이전 서버 DNS 별칭 ID가 비어 있거나 잘못되었습니다(/subscriptions/00000000-1111 형식이어야 함)-2222-3333-444444444444/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}' 서버에 대해 서버 DNS 별칭을 만들 수 없습니다. 데이터베이스 '{1}'에 테이블 감사 또는 보안 사용 액세스 기능이 활성화되어 있기 때문입니다. 400 LimitOfServerDnsAliasesPerServerExceeded - 새 서버 Dns 별칭을 만들면 서버당 허용되는 서버 DNS 별칭 수를 초과합니다. 400 UnableToTurnOnTableAuditingForServerWithServerDnsAlias - 테이블 감사가 켜져 있는 서버에 대해 서버 Dns 별칭이 제대로 작동하지 않음 400 CannotUseReservedDatabaseName - 이 작업에서 예약된 데이터베이스 이름을 사용할 수 없습니다. 400 TokenTooLong - 제공된 토큰이 너무 깁니다. 400 UnableToResolveRemoteServer - 잘못된 서버 이름 또는 DNS 연결 문제로 인해 원격 파트너 서버 이름을 확인할 수 없습니다. 400 InvalidServerName - 잘못된 서버 이름이 지정되었습니다. 400 InvalidIdentifier - 식별자에 NULL 또는 잘못된 유니코드 문자가 포함되어 있습니다. 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

샘플 요청

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.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"),
            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/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"
  }
}

상태 코드:

202

정의

Name	Description
ServerDnsAlias	서버 DNS 별칭입니다.
ServerDnsAliasAcquisition	서버 dns 별칭 획득 요청입니다.

ServerDnsAlias

Object

서버 DNS 별칭입니다.

Name	형식	Description
id	string	리소스 ID입니다.
name	string	리소스 이름입니다.
properties.azureDnsRecord	string	별칭에 대한 정규화된 DNS 레코드
type	string	리소스 종류입니다.

ServerDnsAliasAcquisition

Object

서버 dns 별칭 획득 요청입니다.

Name	형식	Description
oldServerDnsAliasId	string	대신 이 서버를 가리키도록 획득할 서버 별칭의 ID입니다.