Managed Instance Administrators - Get

Servicio:

SQL Database

Versión de la API:

2021-11-01

Obtiene un administrador de instancia administrada.

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

Respuestas

Nombre	Tipo	Description
200 OK	ManagedInstanceAdministrator	Recuperó correctamente el administrador de la instancia administrada especificada.
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. 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 ResourceNotFound: no se encontró el recurso solicitado. 429 SubscriptionTooManyCreateUpdateRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar. 429 SubscriptionTooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar. 503 TooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar. 504 RequestTimeout: la solicitud de servicio superó el tiempo de espera permitido.

Ejemplos

Get administrator of managed instance

Solicitud de ejemplo

HTTP

GET 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

Java

import com.azure.resourcemanager.sql.models.AdministratorName;

/**
 * Samples for ManagedInstanceAdministrators Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedInstanceAdministratorGet.json
     */
    /**
     * Sample code: Get administrator of managed instance.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getAdministratorOfManagedInstance(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedInstanceAdministrators().getWithResponse(
            "Default-SQL-SouthEastAsia", "managedInstance", AdministratorName.ACTIVE_DIRECTORY,
            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"
}

Definiciones

Nombre	Description
AdministratorName
ManagedInstanceAdministrator	Administrador de Azure SQL instancia administrada.
ManagedInstanceAdministratorType	Tipo del administrador de la instancia administrada.

AdministratorName

Nombre	Tipo	Description
ActiveDirectory	string

ManagedInstanceAdministrator

Administrador de Azure SQL instancia administrada.

Nombre	Tipo	Description
id	string	Identificador del recurso.
name	string	Nombre del recurso.
properties.administratorType	ManagedInstanceAdministratorType	Tipo del administrador de la 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 del administrador de la instancia administrada.

Nombre	Tipo	Description
ActiveDirectory	string