Server Azure AD Administrators - List By Server

Service:

SQL Database

API Version:

2021-11-01

Ruft eine Liste der Azure Active Directory-Administratoren auf einem Server ab.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.
serverName	path	True	string	Name des Servers
subscriptionId	path	True	string	Abonnement-ID für ein Azure-Abonnement.
api-version	query	True	string	API-Version, die für die Anforderung verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	AdministratorListResult	Die Liste der Azure Active Directory-Administratoren wurde erfolgreich abgerufen.
Other Status Codes		Fehlerantworten: *** 400 InvalidServerAdministratorTypePropertyName: Active Directory-Administratortyp des Servers sollte ActiveDirectory sein. 400 InvalidResourceRequestBody: Die Ressourcen- oder Ressourceneigenschaften im Anforderungstext sind leer oder ungültig. 400 InvalidServerAzureADOnlyAuthenticationParameter: Der Benutzer hat versucht, den AzureADOnlyAuthentication-Parameter auf false festzulegen, was nicht zulässig ist. Verwenden Sie stattdessen die AZUREADOnlyAuthentications-API. 400 InvalidServerAzureADAdminDeleteOperation : Benutzer hat versucht, server Azure Active Azure admin zu löschen, wenn AzureADOnlyAuthentication festgelegt ist. Verwenden Sie zuerst die azureADOnlyAuthentications-API. 404 SubscriptionDoesNotHaveServer: Der angeforderte Server wurde nicht gefunden. 404 ServerNotInSubscriptionResourceGroup: Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden. 404 ResourceNotFound: Die angeforderte Ressource wurde nicht gefunden.

Beispiele

Gets a list of Azure Active Directory administrator.

Sample Request

HTTP

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

Java

import com.azure.core.util.Context;

/** Samples for ServerAzureADAdministrators ListByServer. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/AdministratorList.json
     */
    /**
     * Sample code: Gets a list of Azure Active Directory administrator.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getsAListOfAzureActiveDirectoryAdministrator(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServerAzureADAdministrators().listByServer("sqlcrudtest-4799",
            "sqlcrudtest-6440", 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

Sample Response

Status code:

200

{
  "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
      }
    }
  ]
}

Definitionen

Name	Beschreibung
AdministratorListResult	Eine Liste von Active Directory-Administratoren.
AdministratorType	Typ des Serveradministrators.
ServerAzureADAdministrator	Azure Active Directory-Administrator

AdministratorListResult

Eine Liste von Active Directory-Administratoren.

Name	Typ	Beschreibung
nextLink	string	Link zum Abrufen der nächsten Ergebnisseite.
value	ServerAzureADAdministrator[]	Array von Ergebnissen.

AdministratorType

Typ des Serveradministrators.

Name	Typ	Beschreibung
ActiveDirectory	string

ServerAzureADAdministrator

Azure Active Directory-Administrator

Name	Typ	Beschreibung
id	string	Ressourcen-ID
name	string	Name der Ressource.
properties.administratorType	AdministratorType	Typ des Serveradministrators.
properties.azureADOnlyAuthentication	boolean	Nur Azure Active Directory-Authentifizierung aktiviert.
properties.login	string	Anmeldename des Serveradministrators.
properties.sid	string	SID (Objekt-ID) des Serveradministrators.
properties.tenantId	string	Mandanten-ID des Administrators.
type	string	Der Ressourcentyp.