Managed Instance Administrators - Create Or Update

Servizio:

SQL Database

Versione API:

2021-11-01

Crea o aggiorna un amministratore dell'istanza gestita.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
administratorName	path	True	AdministratorName
managedInstanceName	path	True	string	Nome dell'istanza gestita.
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.
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	ManagedInstanceAdministratorType	Tipo dell'amministratore dell'istanza gestita.
properties.login	True	string	Nome di accesso dell'amministratore dell'istanza gestita.
properties.sid	True	string	SID (ID oggetto) dell'amministratore dell'istanza gestita.
properties.tenantId		string	ID tenant dell'amministratore dell'istanza gestita.

Risposte

Nome	Tipo	Descrizione
200 OK	ManagedInstanceAdministrator	Aggiornato correttamente l'amministratore dell'istanza gestita.
201 Created	ManagedInstanceAdministrator	È stato creato correttamente l'amministratore dell'istanza gestita.
202 Accepted		Accettato
Other Status Codes		Risposte agli errori: ** 400 InvalidManagedServerAdministratorType - Tipo di amministratore non valido specificato nelle proprietà. 400 InvalidResourceRequestBody: le proprietà della risorsa o della risorsa nel corpo della richiesta sono vuote o non valide. 400 InvalidManagedServerAzureADAdminDeleteOperation - Utente ha tentato di eliminare l'amministratore di Azure Active Server gestito quando AzureADOnlyAuthentication è impostato, usare prima l'API azureADOnlyAuthentications. 400 InvalidManagedServerAADOnlyAuthTypePropertyName - Solo il tipo di autenticazione di Azure Active Directory gestito deve essere predefinito 400 InvalidParameterValue: un valore non valido è stato assegnato a un parametro. 400 InvalidLoginName: il nome di accesso specificato non è valido. 400 PrincipalNotFoundInTenant - Ricerca di AzureAD non ha restituito risultati per questo nome. 400 ServerPrincipalHasDuplicateDisplayNameInAad - Ricerca di AzureAD ha restituito più risultati per questo nome. 400 ManagedInstanceIsBusy: Istanza gestita è occupato con un'altra richiesta. 400 InvalidPrincipalType: questo tipo di entità non è supportato in Windows Azure SQL Database. 400 ServerPrincipalCreateLoginBadSyntax - Errore di sintassi durante l'esecuzione dell'istruzione Create Login per l'amministratore di Azure AD. 400 ServicePrincipalLookupInAadFailed - Ricerca di AzureAD non riuscita a causa di errori dell'infrastruttura del servizio. 400 TenantNotFoundInActiveDirectory : il tenant non è disponibile in Active Directory. 400 InvalidUsername : il nome utente specificato contiene caratteri non validi. 400 ManagedInstanceHasNoPermissionsToAccessAad - Tentativo di eseguire l'operazione, che implica un account di accesso o un account di accesso non esistente in cui l'esecuzione dell'entità non ha autorizzazioni. 403 ServicePrincipalLookupInAadFailedIdentityForbidden - Ricerca di AzureAD non riuscita perché msi non ha concesso autorizzazioni di lettura in AAD. 404 ServerNotInSubscription: il server specificato non esiste nella sottoscrizione specificata. 404 ManagedInstanceNotInSubscriptionResourceGroup - Istanza gestita specificata non esiste nel gruppo di risorse e nella sottoscrizione specificati. 404 SubscriptionNotFound : la sottoscrizione richiesta non è stata trovata. 404 OperationIdNotFound: l'operazione con ID non esiste. 404 ResourceNotFound : la risorsa richiesta non è stata trovata. 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. 409 ServerPrincipalAlreadyExists - Tentativo di creare entità server con nome non univoco. 409 ServerPrincipalCurncipalCurrentlyLoggedIn - Auto-spiegazione. 409 ServerPrincipalOwnsJobs - Tentare di rimuovere un account di accesso quando ha processi attivi. 409 ServerPrincipalIsGrantorOfPermissions - Tentare di eliminare un'entità server, ovvero un grantor delle autorizzazioni. 409 ServerPrincipalOwnsDatabase - Modificare il proprietario dei database prima di eliminare l'account di accesso. 409 ServerPrincipalUsedInTriggerOrEventNotification - Tentativo di eliminare l'account di accesso, usato come contesto di esecuzione di un trigger o di una notifica degli eventi. 409 ServerPrincipalOwnsObjects - Tentativo di eliminare un account di accesso, che possiede oggetti. 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. 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. 500 ActiveDirectoryLookupTimedOut- Impossibile completare l'operazione in questo momento. Riprova più tardi. 503 TooManyRequests : richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili. 503 TooManyRequests : richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili. 504 RequestTimeout : la richiesta di servizio ha superato il timeout consentito.

Esempio

Create administrator of managed instance

Update administrator of managed instance

Create administrator of managed instance

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/administrators/ActiveDirectory?api-version=2021-11-01

{
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "44444444-3333-2222-1111-000000000000",
    "tenantId": "55555555-4444-3333-2222-111111111111"
  }
}

Java

import com.azure.resourcemanager.sql.fluent.models.ManagedInstanceAdministratorInner;
import com.azure.resourcemanager.sql.models.AdministratorName;
import com.azure.resourcemanager.sql.models.ManagedInstanceAdministratorType;
import java.util.UUID;

/**
 * Samples for ManagedInstanceAdministrators CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedInstanceAdministratorCreate.
     * json
     */
    /**
     * Sample code: Create administrator of managed instance.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createAdministratorOfManagedInstance(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedInstanceAdministrators().createOrUpdate(
            "Default-SQL-SouthEastAsia", "managedInstance", AdministratorName.ACTIVE_DIRECTORY,
            new ManagedInstanceAdministratorInner()
                .withAdministratorType(ManagedInstanceAdministratorType.ACTIVE_DIRECTORY).withLogin("bob@contoso.com")
                .withSid(UUID.fromString("44444444-3333-2222-1111-000000000000")).withTenantId(
                    UUID.fromString("55555555-4444-3333-2222-111111111111")),
            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/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/administrators/ActiveDirectory",
  "name": "ActiveDirectory",
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "44444444-3333-2222-1111-000000000000",
    "tenantId": "55555555-4444-3333-2222-111111111111"
  },
  "type": "Microsoft.Sql/managedInstances/administrators"
}

Codice di stato:

201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/administrators/ActiveDirectory",
  "name": "ActiveDirectory",
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "44444444-3333-2222-1111-000000000000",
    "tenantId": "55555555-4444-3333-2222-111111111111"
  },
  "type": "Microsoft.Sql/managedInstances/administrators"
}

Codice di stato:

202

Update administrator of managed instance

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/administrators/ActiveDirectory?api-version=2021-11-01

{
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "44444444-3333-2222-1111-000000000000",
    "tenantId": "55555555-4444-3333-2222-111111111111"
  }
}

Java

import com.azure.resourcemanager.sql.fluent.models.ManagedInstanceAdministratorInner;
import com.azure.resourcemanager.sql.models.AdministratorName;
import com.azure.resourcemanager.sql.models.ManagedInstanceAdministratorType;
import java.util.UUID;

/**
 * Samples for ManagedInstanceAdministrators CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedInstanceAdministratorUpdate.
     * json
     */
    /**
     * Sample code: Update administrator of managed instance.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateAdministratorOfManagedInstance(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedInstanceAdministrators().createOrUpdate(
            "Default-SQL-SouthEastAsia", "managedInstance", AdministratorName.ACTIVE_DIRECTORY,
            new ManagedInstanceAdministratorInner()
                .withAdministratorType(ManagedInstanceAdministratorType.ACTIVE_DIRECTORY).withLogin("bob@contoso.com")
                .withSid(UUID.fromString("44444444-3333-2222-1111-000000000000")).withTenantId(
                    UUID.fromString("55555555-4444-3333-2222-111111111111")),
            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/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/administrators/ActiveDirectory",
  "name": "ActiveDirectory",
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "44444444-3333-2222-1111-000000000000",
    "tenantId": "55555555-4444-3333-2222-111111111111"
  },
  "type": "Microsoft.Sql/managedInstances/administrators"
}

Codice di stato:

201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/administrators/ActiveDirectory",
  "name": "ActiveDirectory",
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "44444444-3333-2222-1111-000000000000",
    "tenantId": "55555555-4444-3333-2222-111111111111"
  },
  "type": "Microsoft.Sql/managedInstances/administrators"
}

Codice di stato:

202

Definizioni

Nome	Descrizione
AdministratorName
ManagedInstanceAdministrator	Amministratore dell'istanza gestita di Azure SQL.
ManagedInstanceAdministratorType	Tipo dell'amministratore dell'istanza gestita.

AdministratorName

Nome	Tipo	Descrizione
ActiveDirectory	string

ManagedInstanceAdministrator

Amministratore dell'istanza gestita di Azure SQL.

Nome	Tipo	Descrizione
id	string	ID risorsa.
name	string	Nome risorsa.
properties.administratorType	ManagedInstanceAdministratorType	Tipo dell'amministratore dell'istanza gestita.
properties.login	string	Nome di accesso dell'amministratore dell'istanza gestita.
properties.sid	string	SID (ID oggetto) dell'amministratore dell'istanza gestita.
properties.tenantId	string	ID tenant dell'amministratore dell'istanza gestita.
type	string	Tipo di risorsa.

ManagedInstanceAdministratorType

Tipo dell'amministratore dell'istanza gestita.

Nome	Tipo	Descrizione
ActiveDirectory	string