Compartir a través de

Server Dns Aliases - Get

Servicio:
SQL Database
Versión de la API:
2023-08-01

Obtiene un alias DNS de servidor.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
dnsAliasName
 path True

string

Nombre del alias dns del servidor.
resourceGroupName
 path True

string

Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor desde la API de Azure Resource Manager o el portal.
serverName
 path True

string

Nombre del servidor al que apunta el alias.
subscriptionId
 path True

string

Identificador de suscripción que identifica una suscripción de Azure.
api-version
 query True

string

Versión de la API que se va a usar para la solicitud.

Respuestas

Nombre Tipo Description
200 OK

ServerDnsAlias

Recuperó correctamente el alias DNS del servidor especificado.
Other Status Codes

ErrorResponse

Respuestas de error: ***

  • 400 ManagedInstanceStoppingOrStopped: operación en conflicto enviada mientras la instancia está en estado de detención o detención

  • 400 ManagedInstanceStarting: operación en conflicto enviada mientras la instancia está en estado de inicio

  • 400 InvalidServerDnsAliasAcquireRequest: el cuerpo de la solicitud de alias DNS del servidor de adquisición está vacío o no es válido (debe contener el identificador de alias del servidor anterior, por ejemplo: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1).

  • 400 ServerDnsAliasAcquireRequestInvalidOldServerDnsAliasId: el identificador de alias DNS del servidor antiguo en el cuerpo de la solicitud está vacío o no es válido (debe tener el formato : /subscriptions/00000000-1111-2222-3333-44444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1).

  • 400 UnableToResolveRemoteServer: no se pudo resolver el nombre del servidor asociado remoto debido a problemas de conectividad dns o nombre de servidor no válidos.

  • 400 CannotUseReservedDatabaseName: no se puede usar el nombre reservado de la base de datos en esta operación.

  • 400 InvalidServerName: nombre de servidor no válido especificado.

  • 400 InvalidIdentifier: el identificador contiene NULL o un carácter unicode no válido.

  • 400 TokenTooLong: el token proporcionado es demasiado largo.

  • 400 InvalidServerDnsAliasName: se proporcionó un nombre de alias DNS de servidor no válido.

  • 400 ServerDnsAliasDoesNotExist: el alias DNS del servidor no existe en un servidor.

  • 400 ServerNotFound: no se encontró el servidor solicitado.

  • 400 UnableToTurnOnTableAuditingForDbOnServerWithServerDnsAlias- Los alias dns del servidor no funcionan correctamente para la base de datos que tiene activada la auditoría de tablas

  • 400 UnableToCreateServerDnsAliasDueToTableAuditing: no se puede crear el alias DNS del servidor para el servidor que tenga activada la auditoría de tablas.

  • 400 UnableToCreateServerDnsAliasDueToTableAuditingForDb - No se puede crear el alias DNS del servidor "{0}" porque la base de datos "{1}" tiene habilitada la característica Auditoría de tablas o Acceso habilitado para seguridad.

  • 400 LimitOfServerDnsAliasesPerServerExceeded: la creación de un nuevo alias dns de servidor superará el número permitido de alias DNS de servidor por servidor.

  • 400 UnableToTurnOnTableAuditingForServerWithServerDnsAlias- Los alias dns del servidor no funcionan correctamente para el servidor que tiene activada la auditoría de tablas

  • 404 ServerNotInSubscriptionResourceGroup: el servidor especificado no existe en el grupo de recursos y la suscripción especificados.

  • 404 SubscriptionDoesNotHaveServer: no se encontró el servidor solicitado.

  • 404 ResourceNotFound: no se encontró el recurso solicitado.

  • 404 ServerNotInSubscription: el servidor especificado no existe en la suscripción especificada.

  • 404 ServerNotInSubscriptionResourceGroup: el servidor especificado no existe en el grupo de recursos y la suscripción especificados.

  • 409 ConflictingServerOperation: una operación está actualmente en curso para el servidor.

  • 409 SubscriptionDisabled: la suscripción está deshabilitada.

  • 409 ServerDnsAliasDnsRecordInUse: existe un registro DNS duplicado para el punto de conexión solicitado.

  • 409 ServerDnsAliasAlreadyExists: el alias DNS del servidor ya existe en un servidor determinado.

  • 409 ServerDnsAliasBusy: el alias DNS del servidor está ocupado con otra operación.

  • 429 SubscriptionTooManyCreateUpdateRequests: solicitudes más allá de las solicitudes máximas que pueden procesar los recursos disponibles.

  • 429 SubscriptionTooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.

  • 503 TooManyRequests: solicitudes más allá de las solicitudes máximas que pueden procesar los recursos disponibles.

  • 504 RequestTimeout: la solicitud de servicio superó el tiempo de espera permitido.

Ejemplos

Get server DNS alias

Solicitud de ejemplo

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

Respuesta de muestra

status code:
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"
  }
}

Definiciones

Nombre Description
ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.
ErrorDetail

Detalle del error.
ErrorResponse

Respuesta de error
ServerDnsAlias

Alias DNS del servidor.

ErrorAdditionalInfo

Object

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.
type

string

Tipo de información adicional.

ErrorDetail

Object

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.
code

string

Código de error.
details

ErrorDetail[]

Detalles del error.
message

string

Mensaje de error.
target

string

Destino del error.

ErrorResponse

Object

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

ServerDnsAlias

Object

Alias DNS del servidor.

Nombre Tipo Description
id

string

Identificador de recurso.
name

string

Nombre del recurso.
properties.azureDnsRecord

string

Registro DNS completo para alias
type

string

Tipo de recurso.