Server Azure AD Administrators - Create Or Update

Riferimento

Servizio:: SQL Database

Versione API:: 2021-11-01

Crea o aggiorna un amministratore di Azure Active Directory esistente.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
administratorName	path	True	AdministratorName	Nome dell'amministratore di Active Directory del server.
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.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
properties.administratorType	True	AdministratorType	Tipo dell'amministratore di sever.
properties.login	True	string	Nome di accesso dell'amministratore del server.
properties.sid	True	string	SID (ID oggetto) dell'amministratore del server.
properties.tenantId		string	ID tenant dell'amministratore.

Risposte

Nome	Tipo	Descrizione
200 OK	ServerAzureADAdministrator	È stato aggiornato correttamente un amministratore di Azure Active Directory.
201 Created	ServerAzureADAdministrator	È stato creato correttamente un amministratore di Azure Active Directory.
202 Accepted		Accettato
Other Status Codes		Risposte agli errori: ** 400 InvalidServerAdministratorTypePropertyName - Tipo di amministratore active directory 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 che non è consentito, usare l'API azureADOnlyAuthentications. 400 InvalidServerAzureADAdminDeleteOperation - Utente ha tentato di eliminare l'amministratore di Azure Active Server quando AzureADOnlyAuthentication è impostato, usare prima l'API azureADOnlyAuthentications. 400 ServerAdministratorNameAlreadyExists - Utente ha tentato di impostare l'amministratore esterno e il nome dell'entità esiste già nel database 'master'. 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato 404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati. 404 OperationIdNotFound: l'operazione con ID non esiste. 409 OperationCancelled: l'operazione è stata annullata dall'utente. 409 Operazione interrotta: impossibile completare l'operazione sulla risorsa perché è stata interrotta da un'altra operazione sulla stessa risorsa. 429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili. 429 SubscriptionTooManyRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili. 500 OperationTimedOut: l'operazione viene timeout e viene eseguito automaticamente il rollback. Ripetere l'operazione. 503 TooManyRequests : richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

Esempio

Creates or updates an existing Azure Active Directory administrator.

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

{
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c",
    "tenantId": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c"
  }
}


import com.azure.resourcemanager.sql.fluent.models.ServerAzureADAdministratorInner;
import com.azure.resourcemanager.sql.models.AdministratorName;
import com.azure.resourcemanager.sql.models.AdministratorType;
import java.util.UUID;

/**
 * Samples for ServerAzureADAdministrators CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/AdministratorCreateOrUpdate.json
     */
    /**
     * Sample code: Creates or updates an existing Azure Active Directory administrator.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createsOrUpdatesAnExistingAzureActiveDirectoryAdministrator(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServerAzureADAdministrators().createOrUpdate("sqlcrudtest-4799",
            "sqlcrudtest-6440", AdministratorName.ACTIVE_DIRECTORY,
            new ServerAzureADAdministratorInner().withAdministratorType(AdministratorType.ACTIVE_DIRECTORY)
                .withLogin("bob@contoso.com").withSid(UUID.fromString("c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c"))
                .withTenantId(UUID.fromString("c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c")),
            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

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

Codice di stato:: 201

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

Codice di stato:: 202

Definizioni

Nome	Descrizione
AdministratorName	Nome dell'amministratore di Active Directory del server.
AdministratorType	Tipo dell'amministratore di sever.
ServerAzureADAdministrator	Amministratore di Azure Active Directory.

AdministratorName

Nome dell'amministratore di Active Directory del server.

Nome	Tipo	Descrizione
ActiveDirectory	string

AdministratorType

Tipo dell'amministratore di sever.

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 dell'amministratore di sever.
properties.azureADOnlyAuthentication	boolean	Solo autenticazione di Azure Active Directory abilitata.
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.

Condividi tramite