Server Azure AD Administrators - List By Server

Servizio:

SQL Database

Versione API:

2021-11-01

Ottiene un elenco di amministratori di Azure Active Directory in un server.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string	Nome del gruppo di risorse contenente la risorsa. È possibile ottenere questo valore dall'API di Gestione risorse di Azure o dal portale.
serverName	path	True	string	Nome del server.
subscriptionId	path	True	string	ID sottoscrizione che identifica una sottoscrizione di Azure.
api-version	query	True	string	Versione dell'API da usare per la richiesta.

Risposte

Nome	Tipo	Descrizione
200 OK	AdministratorListResult	È stato recuperato l'elenco degli amministratori di Azure Active Directory.
Other Status Codes		Risposte di errore: 400 InvalidServerAdministratorTypePropertyName - Tipo di amministratore active directory del server deve essere ActiveDirectory 400 InvalidResourceRequestBody: le proprietà della risorsa o della risorsa nel corpo della richiesta sono vuote o non valide. 400 InvalidServerAzureADOnlyAuthenticationParameter : l'utente ha tentato di impostare il parametro AzureADOnlyAuthentication su false, ma usare invece l'API azureADOnlyAuthentications. 400 InvalidServerAzureADAdminDeleteOperation: l'utente ha tentato di eliminare l'amministratore di Azure Active Server quando è impostato AzureADOnlyAuthentications, usare prima l'API azureADOnlyAuthentications. 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato 404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati. 404 ResourceNotFound: la risorsa richiesta non è stata trovata.

Esempio

Gets a list of Azure Active Directory administrator.

Esempio di richiesta

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

/**
 * 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", 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

Risposta di esempio

Codice di stato:

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

Definizioni

Nome	Descrizione
AdministratorListResult	Elenco di amministratori di Active Directory.
AdministratorType	Tipo di amministratore del server.
ServerAzureADAdministrator	Amministratore di Azure Active Directory.

AdministratorListResult

Elenco di amministratori di Active Directory.

Nome	Tipo	Descrizione
nextLink	string	Collegamento per recuperare la pagina successiva dei risultati.
value	ServerAzureADAdministrator[]	Matrice di risultati.

AdministratorType

Tipo di amministratore del server.

Nome	Tipo	Descrizione
ActiveDirectory	string

ServerAzureADAdministrator

Amministratore di Azure Active Directory.

Nome	Tipo	Descrizione
id	string	ID risorsa.
name	string	Nome risorsa.
properties.administratorType	AdministratorType	Tipo di amministratore del server.
properties.azureADOnlyAuthentication	boolean	Autenticazione di Azure Active Directory abilitata solo.
properties.login	string	Nome di accesso dell'amministratore del server.
properties.sid	string	SID (ID oggetto) dell'amministratore del server.
properties.tenantId	string	ID tenant dell'amministratore.
type	string	Tipo di risorsa.