Managed Instance Administrators - Create Or Update

Référence

Service:: SQL Database

API Version:: 2021-11-01

Crée ou met à jour un administrateur de instance managé.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
administratorName	path	True	AdministratorName
managedInstanceName	path	True	string	Nom de l'instance managée.
resourceGroupName	path	True	string	Nom du groupe de ressources qui contient la ressource. Vous pouvez obtenir cette valeur à partir de l’API Azure Resource Manager ou du portail.
subscriptionId	path	True	string	L’ID d’abonnement d’un abonnement Azure.
api-version	query	True	string	Version de l’API à utiliser pour la requête.

Corps de la demande

Nom	Obligatoire	Type	Description
properties.administratorType	True	ManagedInstanceAdministratorType	Type de l’administrateur instance managé.
properties.login	True	string	Nom de connexion de l’administrateur instance managé.
properties.sid	True	string	SID (ID d’objet) de l’administrateur instance managé.
properties.tenantId		string	ID de locataire de l’administrateur instance managé.

Réponses

Nom	Type	Description
200 OK	ManagedInstanceAdministrator	Mise à jour réussie de l’administrateur instance managé.
201 Created	ManagedInstanceAdministrator	L’administrateur de instance managé a été créé.
202 Accepted		Accepté
Other Status Codes		Réponses d’erreur : *** 400 InvalidManagedServerAdministratorType : type d’administrateur non valide spécifié dans les propriétés. 400 InvalidResourceRequestBody : la ressource ou les propriétés de ressource dans le corps de la demande sont vides ou non valides. 400 InvalidManagedServerAzureADAdminDeleteOperation : l’utilisateur a essayé de supprimer le serveur managé Administrateur Azure Active Azure quand AzureADOnlyAuthentication est défini. Utilisez d’abord l’API azureADOnlyAuthentications. 400 InvalidManagedServerAADOnlyAuthTypePropertyName - Le type d’authentification Azure Active Directory du serveur managé uniquement doit être par défaut 400 InvalidParameterValue : une valeur non valide a été donnée à un paramètre. 400 InvalidLoginName : le nom de connexion fourni n’est pas valide. 400 PrincipalNotFoundInTenant - AzureAD Lookup n’a retourné aucun résultat pour ce nom. 400 ServerPrincipalHasDuplicateDisplayNameInAad - AzureAD Lookup a retourné plusieurs résultats pour ce nom. 400 ManagedInstanceIsBusy : Managed Instance est occupé par une autre requête. 400 InvalidPrincipalType : ce type de principal n’est pas pris en charge dans Windows Azure SQL Database. 400 ServerPrincipalCreateLoginBadSyntax : erreur de syntaxe lors de l’exécution de l’instruction Create Login pour l’administrateur Azure AD. 400 ServicePrincipalLookupInAadFailed : la recherche AzureAD a échoué en raison d’erreurs d’infrastructure de service. 400 TenantNotFoundInActiveDirectory : le locataire n’est pas disponible dans Active Directory. 400 InvalidUsername : le nom d’utilisateur fourni contient des caractères non valides. 400 ManagedInstanceHasNoPermissionsToAccessAad : tentative d’exécution d’une opération, qui implique une connexion ou une connexion non existante sur laquelle le principal en cours d’exécution n’a aucune autorisation. 403 ServicePrincipalLookupInAadFailedIdentityForbidden - La recherche AzureAD a échoué, car MSI n’a pas reçu d’autorisations de lecture sur AAD. 404 ServerNotInSubscription : le serveur spécifié n’existe pas dans l’abonnement spécifié. 404 ManagedInstanceNotInSubscriptionResourceGroup : le instance managé spécifié n’existe pas dans le groupe de ressources et l’abonnement spécifiés. 404 SubscriptionNotFound : l’abonnement demandé est introuvable. 404 OperationIdNotFound : l’opération avec ID n’existe pas. 404 ResourceNotFound : la ressource demandée est introuvable. 409 OperationCancelled : l’opération a été annulée par l’utilisateur. 409 Opération interrompue : l’opération sur la ressource n’a pas pu être terminée, car elle a été interrompue par une autre opération sur la même ressource. 409 ServerPrincipalAlreadyExists : tentative de création d’un principal de serveur avec un nom non unique. 409 ServerPrincipalCurrentlyLoggedIn : explicite. 409 ServerPrincipalOwnsJobs : tentative de suppression d’une connexion lorsqu’elle a des travaux actifs. 409 ServerPrincipalIsGrantorOfPermissions : tentative de suppression d’un principal de serveur, qui est un octroi d’autorisations. 409 ServerPrincipalOwnsDatabase : modifiez le propriétaire de la ou des bases de données avant de supprimer la connexion. 409 ServerPrincipalUsedInTriggerOrEventNotification : tentative de suppression de la connexion, qui est utilisée comme contexte d’exécution d’un déclencheur ou d’une notification d’événement. 409 ServerPrincipalOwnsObjects : tentative de suppression d’une connexion qui possède des objets. 429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles. 429 SubscriptionTooManyRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles. 429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles. 429 SubscriptionTooManyRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles. 500 OperationTimedOut : l’opération a expiré et a été automatiquement restaurée. Réessayez l’opération. 500 ActiveDirectoryLookupTimedOut : l’opération n’a pas pu être terminée pour l’instant. Veuillez réessayer plus tard. 503 TooManyRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles. 503 TooManyRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles. 504 RequestTimeout : la demande de service a dépassé le délai d’expiration autorisé.

Exemples

Create administrator of managed instance

Update administrator of managed instance

Create administrator of managed instance

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


import com.azure.core.util.Context;
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")),
            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

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

Status code:: 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"
}

Status code:: 202

Update administrator of managed instance

Sample Request

HTTP
Java

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


import com.azure.core.util.Context;
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")),
            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

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

Status code:: 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"
}

Status code:: 202

Définitions

Nom	Description
AdministratorName
ManagedInstanceAdministrator	Administrateur instance géré Azure SQL.
ManagedInstanceAdministratorType	Type de l’administrateur instance managé.

AdministratorName

Nom	Type	Description
ActiveDirectory	string

ManagedInstanceAdministrator

Administrateur instance géré Azure SQL.

Nom	Type	Description
id	string	ID de la ressource
name	string	Nom de la ressource.
properties.administratorType	ManagedInstanceAdministratorType	Type de l’administrateur instance managé.
properties.login	string	Nom de connexion de l’administrateur instance managé.
properties.sid	string	SID (ID d’objet) de l’administrateur instance managé.
properties.tenantId	string	ID de locataire de l’administrateur instance managé.
type	string	Type de ressource.

ManagedInstanceAdministratorType

Type de l’administrateur instance managé.

Nom	Type	Description
ActiveDirectory	string

Managed Instance Administrators - Create Or Update

Paramètres URI

Corps de la demande

Réponses

Exemples

Create administrator of managed instance

Sample Request

Sample Response

Update administrator of managed instance

Sample Request

Sample Response

Définitions

AdministratorName

ManagedInstanceAdministrator

ManagedInstanceAdministratorType

Ressources supplémentaires