Server Dns Aliases - Get

Tjänst:: SQL Database

API-version:: 2023-08-01

Hämtar ett DNS-alias för servern.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/dnsAliases/{dnsAliasName}?api-version=2023-08-01

URI-parametrar

Name	I	Obligatorisk	Typ	Description
dnsAliasName	path	True	string	Namnet på serverns DNS-alias.
resourceGroupName	path	True	string	Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.
serverName	path	True	string	Namnet på den server som aliaset pekar på.
subscriptionId	path	True	string	Det prenumerations-ID som identifierar en Azure-prenumeration.
api-version	query	True	string	DEN API-version som ska användas för begäran.

Svar

Name	Typ	Description
200 OK	ServerDnsAlias	Det angivna DNS-aliaset för servern har hämtats.
Other Status Codes	ErrorResponse	Felsvar: *** 400 ManagedInstanceStoppingOrS toppad – Konfliktåtgärd som skickas när instansen är i stopptillstånd 400 ManagedInstanceStarting – Konfliktåtgärd som skickas när instansen är i starttillstånd 400 InvalidServerDnsAliasAcquireRequest – begärandetexten för server-DNS-alias är tom eller ogiltig (den bör innehålla det gamla serveralias-ID:t, till exempel: /subscriptions/00000000-1111-2222-3333-4444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1). 400 ServerDnsAliasAcquireRequestInvalidOldServerDnsAliasId – Det gamla DNS-alias-ID:t i begärandetexten är tomt eller ogiltigt (det bör ha formuläret: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1). 400 UnableToResolveRemoteServer – Det gick inte att lösa namnet på fjärrpartnerservern på grund av ett ogiltigt servernamn eller DNS-anslutningsproblem. 400 CannotUseReservedDatabaseName – Det går inte att använda reserverat databasnamn i den här åtgärden. 400 InvalidServerName – Ogiltigt servernamn har angetts. 400 InvalidIdentifier – Identifieraren innehåller NULL eller ett ogiltigt unicode-tecken. 400 TokenTooLong – den angivna token är för lång. 400 InvalidServerDnsAliasName – Ogiltigt DNS-alias för server angavs. 400 ServerDnsAliasDoesNotExist – Serverns DNS-alias finns inte på en server. 400 ServerNotFound – Den begärda servern hittades inte. 400 UnableToTurnOnTableAuditingForDbOnServerWithServerDnsAlias – Serverns Dns-alias fungerar inte korrekt för databas som har Tabellgranskning aktiverat 400 UnableToCreateServerDnsAliasDueToTableAuditing – Serverns DNS-alias kan inte skapas för en server som har aktiverat tabellgranskning. 400 UnableToCreateServerDnsAliasDueToTableAuditingForDb – Dns-alias för server kan inte skapas för serverns{0}eftersom databasen{1}har funktionen Table Auditing eller Security Enabled Access aktiverat. 400 LimitOfServerDnsAliasesPerServerExceededed – Om du skapar ett nytt Server Dns-alias överskrids det tillåtna antalet DNS-serveralias per server. 400 UnableToTurnOnTableAuditingForServerWithServerDnsAlias – Serverns DNS-alias fungerar inte korrekt för server som har Table Auditing aktiverat 404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen. 404 SubscriptionDoesNotHaveServer – Den begärda servern hittades inte 404 ResourceNotFound – Den begärda resursen hittades inte. 404 ServerNotInSubscription – Den angivna servern finns inte i den angivna prenumerationen. 404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen. 409 ConflictingServerOperation – En åtgärd pågår för närvarande för servern. 409 SubscriptionDisabled – Prenumerationen är inaktiverad. 409 ServerDnsAliasDnsRecordInUse – Det finns en duplicerad DNS-post för den begärda slutpunkten. 409 ServerDnsAliasAlreadyExists – Serverns DNS-alias finns redan på en viss server. 409 ServerDnsAliasBusy – Serverns DNS-alias är upptaget med en annan åtgärd. 429 SubscriptionTooManyCreateUpdateRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 429 SubscriptionTooManyRequests – Begäranden utöver maxbegäranden som kan bearbetas av tillgängliga resurser. 503 TooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 504 RequestTimeout – Tjänstbegäran överskred den tillåtna tidsgränsen.

Name

Typ

Description

200 OK

ServerDnsAlias

Det angivna DNS-aliaset för servern har hämtats.

Other Status Codes

ErrorResponse

Felsvar: ***

400 ManagedInstanceStoppingOrS toppad – Konfliktåtgärd som skickas när instansen är i stopptillstånd
400 ManagedInstanceStarting – Konfliktåtgärd som skickas när instansen är i starttillstånd
400 InvalidServerDnsAliasAcquireRequest – begärandetexten för server-DNS-alias är tom eller ogiltig (den bör innehålla det gamla serveralias-ID:t, till exempel: /subscriptions/00000000-1111-2222-3333-4444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1).
400 ServerDnsAliasAcquireRequestInvalidOldServerDnsAliasId – Det gamla DNS-alias-ID:t i begärandetexten är tomt eller ogiltigt (det bör ha formuläret: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1).
400 UnableToResolveRemoteServer – Det gick inte att lösa namnet på fjärrpartnerservern på grund av ett ogiltigt servernamn eller DNS-anslutningsproblem.
400 CannotUseReservedDatabaseName – Det går inte att använda reserverat databasnamn i den här åtgärden.
400 InvalidServerName – Ogiltigt servernamn har angetts.
400 InvalidIdentifier – Identifieraren innehåller NULL eller ett ogiltigt unicode-tecken.
400 TokenTooLong – den angivna token är för lång.
400 InvalidServerDnsAliasName – Ogiltigt DNS-alias för server angavs.
400 ServerDnsAliasDoesNotExist – Serverns DNS-alias finns inte på en server.
400 ServerNotFound – Den begärda servern hittades inte.
400 UnableToTurnOnTableAuditingForDbOnServerWithServerDnsAlias – Serverns Dns-alias fungerar inte korrekt för databas som har Tabellgranskning aktiverat
400 UnableToCreateServerDnsAliasDueToTableAuditing – Serverns DNS-alias kan inte skapas för en server som har aktiverat tabellgranskning.
400 UnableToCreateServerDnsAliasDueToTableAuditingForDb – Dns-alias för server kan inte skapas för serverns{0}eftersom databasen{1}har funktionen Table Auditing eller Security Enabled Access aktiverat.
400 LimitOfServerDnsAliasesPerServerExceededed – Om du skapar ett nytt Server Dns-alias överskrids det tillåtna antalet DNS-serveralias per server.
400 UnableToTurnOnTableAuditingForServerWithServerDnsAlias – Serverns DNS-alias fungerar inte korrekt för server som har Table Auditing aktiverat
404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen.
404 SubscriptionDoesNotHaveServer – Den begärda servern hittades inte
404 ResourceNotFound – Den begärda resursen hittades inte.
404 ServerNotInSubscription – Den angivna servern finns inte i den angivna prenumerationen.
404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen.
409 ConflictingServerOperation – En åtgärd pågår för närvarande för servern.
409 SubscriptionDisabled – Prenumerationen är inaktiverad.
409 ServerDnsAliasDnsRecordInUse – Det finns en duplicerad DNS-post för den begärda slutpunkten.
409 ServerDnsAliasAlreadyExists – Serverns DNS-alias finns redan på en viss server.
409 ServerDnsAliasBusy – Serverns DNS-alias är upptaget med en annan åtgärd.
429 SubscriptionTooManyCreateUpdateRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.
429 SubscriptionTooManyRequests – Begäranden utöver maxbegäranden som kan bearbetas av tillgängliga resurser.
503 TooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.
504 RequestTimeout – Tjänstbegäran överskred den tillåtna tidsgränsen.

Exempel

Get server DNS alias

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-server/dnsAliases/dns-alias-name-1?api-version=2023-08-01

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/ServerDnsAliasGet.json
// this example is just showing the usage of "ServerDnsAliases_Get" 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://free.blessedness.top/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 SqlServerResource created on azure
// for more information of creating SqlServerResource, please refer to the document of SqlServerResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "Default";
string serverName = "dns-alias-server";
ResourceIdentifier sqlServerResourceId = SqlServerResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName);
SqlServerResource sqlServer = client.GetSqlServerResource(sqlServerResourceId);

// get the collection of this SqlServerDnsAliasResource
SqlServerDnsAliasCollection collection = sqlServer.GetSqlServerDnsAliases();

// invoke the operation
string dnsAliasName = "dns-alias-name-1";
NullableResponse<SqlServerDnsAliasResource> response = await collection.GetIfExistsAsync(dnsAliasName);
SqlServerDnsAliasResource result = response.HasValue ? response.Value : null;

if (result == null)
{
    Console.WriteLine("Succeeded with null as result");
}
else
{
    // 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
    SqlServerDnsAliasData 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

Exempelsvar

Statuskod:: 200

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

Definitioner

Name	Description
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
ServerDnsAlias	Ett DNS-alias för servern.

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Objekt

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Objekt

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

ServerDnsAlias

Objekt

Ett DNS-alias för servern.

Name	Typ	Description
id	string	Resurs-ID.
name	string	Resursnamn.
properties.azureDnsRecord	string	Den fullständigt kvalificerade DNS-posten för alias
type	string	Resurstyp.

Dela via

Server Dns Aliases - Get

URI-parametrar

Svar

Exempel

Get server DNS alias

Exempelbegäran

Exempelsvar

Definitioner

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ServerDnsAlias