Server Azure AD Administrators - List By Server

Obtiene una lista de administradores de Azure Active Directory en un servidor.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/administrators?api-version=2022-02-01-preview

Parámetros de identificador URI

Name In Required Type Description
resourceGroupName
path True
  • string

Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor en la API del Administrador de recursos o el portal de Azure.

serverName
path True
  • string

El nombre del servidor.

subscriptionId
path True
  • string

El id. de suscripción que identifica una suscripción de Azure.

api-version
query True
  • string

La versión de API que se usará para la solicitud.

Respuestas

Name Type Description
200 OK

Recuperó correctamente la lista de administradores de Azure Active Directory.

Other Status Codes

Respuestas de error: ***

  • 400 InvalidServerAdministratorTypePropertyName: el tipo de administrador de Active Directory del servidor debe ser ActiveDirectory

  • 400 InvalidResourceRequestBody: las propiedades de recurso o recurso del cuerpo de la solicitud están vacías o no son válidas.

  • 400 InvalidServerAzureADOnlyAuthenticationParameter: el usuario intentó establecer el parámetro AzureADOnlyAuthentication en false, que no está permitido, use azureADOnlyAuthentications API en su lugar.

  • 400 InvalidServerAzureADAdminDeleteOperation: el usuario intentó eliminar el administrador de Azure Active Azure del servidor cuando se establece AzureADOnlyAuthentication, use primero la API azureADOnlyAuthentications.

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

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

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

Ejemplos

Gets a list of Azure Active Directory administrator.

Sample Request

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-4799/providers/Microsoft.Sql/servers/sqlcrudtest-6440/administrators?api-version=2022-02-01-preview

Sample Response

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-4799/providers/Microsoft.Sql/servers/sqlcrudtest-6440/administrators/ActiveDirectory",
      "name": "ActiveDirectory",
      "type": "Microsoft.Sql/servers/administrators",
      "properties": {
        "administratorType": "ActiveDirectory",
        "login": "bob@contoso.com",
        "sid": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c",
        "tenantId": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c",
        "azureADOnlyAuthentication": true
      }
    }
  ]
}

Definiciones

AdministratorListResult

Una lista de administradores de Active Directory.

AdministratorType

Tipo del administrador del servidor.

ServerAzureADAdministrator

Administrador de Azure Active Directory.

AdministratorListResult

Una lista de administradores de Active Directory.

Name Type Description
nextLink
  • string

Vínculo para recuperar la página siguiente de resultados.

value

Matriz de resultados.

AdministratorType

Tipo del administrador del servidor.

Name Type Description
ActiveDirectory
  • string

ServerAzureADAdministrator

Administrador de Azure Active Directory.

Name Type Description
id
  • string

Identificador del recurso.

name
  • string

Nombre del recurso.

properties.administratorType

Tipo del administrador del servidor.

properties.azureADOnlyAuthentication
  • boolean

Autenticación solo de Azure Active Directory habilitada.

properties.login
  • string

Nombre de inicio de sesión del administrador del servidor.

properties.sid
  • string

SID (id. de objeto) del administrador del servidor.

properties.tenantId
  • string

Id. de inquilino del administrador.

type
  • string

Tipo de recurso.