Managed Instance Administrators - Create Or Update

Referencia

Servicio:: SQL Database

Versión de la API:: 2021-11-01

Crea o actualiza un administrador de instancia administrada.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
administratorName	path	True	AdministratorName
managedInstanceName	path	True	string	El nombre de la instancia administrada.
resourceGroupName	path	True	string	Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor en la API del Administrador de recursos o el portal de Azure.
subscriptionId	path	True	string	El id. de suscripción que identifica una suscripción de Azure.
api-version	query	True	string	La versión de API que se usará para la solicitud.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
properties.administratorType	True	ManagedInstanceAdministratorType	Tipo de administrador de instancia administrada.
properties.login	True	string	Nombre de inicio de sesión del administrador de la instancia administrada.
properties.sid	True	string	SID (id. de objeto) del administrador de la instancia administrada.
properties.tenantId		string	Identificador de inquilino del administrador de la instancia administrada.

Respuestas

Nombre	Tipo	Description
200 OK	ManagedInstanceAdministrator	Se actualizó correctamente el administrador de la instancia administrada.
201 Created	ManagedInstanceAdministrator	Ha creado correctamente el administrador de la instancia administrada.
202 Accepted		Aceptado
Other Status Codes		Respuestas de error: *** 400 InvalidManagedServerAdministratorType: tipo de administrador no válido especificado en las propiedades. 400 InvalidResourceRequestBody: las propiedades de recurso o recurso del cuerpo de la solicitud están vacías o no son válidas. 400 InvalidManagedServerAzureADAdminDeleteOperation: el usuario intentó eliminar el administrador de Azure Active Azure del servidor administrado cuando se establece AzureADOnlyAuthentication, use primero la API azureADOnlyAuthentications. 400 InvalidManagedServerAADOnlyAuthTypePropertyName: el tipo de autenticación solo de Azure Active Directory del servidor administrado debe ser Predeterminado. 400 InvalidParameterValue: se ha dado un valor no válido a un parámetro. 400 InvalidLoginName: el nombre de inicio de sesión proporcionado no es válido. 400 PrincipalNotFoundInTenant: La búsqueda de AzureAD no devolvió ningún resultado para este nombre. 400 ServerPrincipalHasDuplicateDisplayNameInAad: La búsqueda de AzureAD devolvió varios resultados para este nombre. 400 ManagedInstanceIsBusy: Instancia administrada está ocupado con otra solicitud. 400 InvalidPrincipalType: este tipo de entidad de seguridad no se admite en Windows Azure SQL Database. 400 ServerPrincipalCreateLoginBadSyntax: se produjo un error de sintaxis al ejecutar la instrucción Create Login para el administrador de Azure AD. 400 ServicePrincipalLookupInAadFailed: error de búsqueda de AzureAD debido a errores de infraestructura de servicio. 400 TenantNotFoundInActiveDirectory: el inquilino no está disponible en Active Directory. 400 InvalidUsername: el nombre de usuario proporcionado contiene caracteres no válidos. 400 ManagedInstanceHasNoPermissionsToAccessAad: intento de realizar la operación, lo que implica un inicio de sesión o inicio de sesión no existente en el que la entidad de seguridad en ejecución no tiene permisos. 403 ServicePrincipalLookupInAadFailedIdentityForbidden: error en la búsqueda de AzureAD porque no se concedieron permisos de lectura en AAD. 404 ServerNotInSubscription: el servidor especificado no existe en la suscripción especificada. 404 ManagedInstanceNotInSubscriptionResourceGroup: la instancia administrada especificada no existe en el grupo de recursos y la suscripción especificados. 404 SubscriptionNotFound: no se encontró la suscripción solicitada. 404 OperationIdNotFound: la operación con id. no existe. 404 ResourceNotFound: no se encontró el recurso solicitado. 409 OperationCancelled: el usuario canceló la operación. 409 OperationInterrupted: no se pudo completar la operación en el recurso porque se interrumpió por otra operación en el mismo recurso. 409 ServerPrincipalAlreadyExists: intenta crear una entidad de seguridad de servidor con un nombre no único. 409 ServerPrincipalCurrentlyLoggedIn: autoexplicativo. 409 ServerPrincipalOwnsJobs: intente quitar un inicio de sesión cuando tenga trabajos activos. 409 ServerPrincipalIsGrantorOfPermissions: intenta quitar una entidad de seguridad de servidor, que es un receptor de permisos. 409 ServerPrincipalOwnsDatabase: cambie el propietario de las bases de datos antes de quitar el inicio de sesión. 409 ServerPrincipalUsedInTriggerOrEventNotification: intento de quitar el inicio de sesión, que se usa como contexto de ejecución de un desencadenador o notificación de eventos. 409 ServerPrincipalOwnsObjects: intenta quitar un inicio de sesión, que posee objetos. 429 SuscripciónTooManyCreateUpdateRequests: solicitudes más allá del número máximo de solicitudes que pueden procesar los recursos disponibles. 429 SubscriptionTooManyRequests: solicitudes más allá del número máximo de solicitudes que pueden procesar los recursos disponibles. 429 SuscripciónTooManyCreateUpdateRequests: solicitudes más allá del número máximo de solicitudes que pueden procesar los recursos disponibles. 429 SubscriptionTooManyRequests: solicitudes más allá del número máximo de solicitudes que pueden procesar los recursos disponibles. 500 OperationTimedOut: se agota el tiempo de espera de la operación y se revierte automáticamente. Vuelva a intentar la operación y, 500 ActiveDirectoryLookupTimedOut: la operación no se pudo completar en este momento. Vuelva a intentarlo más tarde. 503 TooManyRequests: solicitudes más allá del número máximo de solicitudes que se pueden procesar mediante recursos disponibles. 503 TooManyRequests: solicitudes más allá del número máximo de solicitudes que se pueden procesar mediante recursos disponibles. 504 RequestTimeout: la solicitud de servicio superó el tiempo de espera permitido.

Ejemplos

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.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

Respuesta de muestra

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

Solicitud de ejemplo

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.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

Respuesta de muestra

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

Definiciones

Nombre	Description
AdministratorName
ManagedInstanceAdministrator	Un administrador de Azure SQL instancia administrada.
ManagedInstanceAdministratorType	Tipo de administrador de instancia administrada.

AdministratorName

Nombre	Tipo	Description
ActiveDirectory	string

ManagedInstanceAdministrator

Un administrador de Azure SQL instancia administrada.

Nombre	Tipo	Description
id	string	Identificador del recurso.
name	string	Nombre del recurso.
properties.administratorType	ManagedInstanceAdministratorType	Tipo de administrador de instancia administrada.
properties.login	string	Nombre de inicio de sesión del administrador de la instancia administrada.
properties.sid	string	SID (id. de objeto) del administrador de la instancia administrada.
properties.tenantId	string	Identificador de inquilino del administrador de la instancia administrada.
type	string	Tipo de recurso.

ManagedInstanceAdministratorType

Tipo de administrador de instancia administrada.

Nombre	Tipo	Description
ActiveDirectory	string

Compartir a través de

Managed Instance Administrators - Create Or Update

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Ejemplos

Create administrator of managed instance

Solicitud de ejemplo

Respuesta de muestra

Update administrator of managed instance

Solicitud de ejemplo

Respuesta de muestra

Definiciones

AdministratorName

ManagedInstanceAdministrator

ManagedInstanceAdministratorType

Recursos adicionales