Compartir a través de


Managed Instance Administrators - List By Instance

Obtiene una lista de administradores de instancias administradas.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/administrators?api-version=2023-08-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
managedInstanceName
path True

string

Nombre de la instancia administrada.

resourceGroupName
path True

string

Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor desde la API de Azure Resource Manager o el portal.

subscriptionId
path True

string

Identificador de suscripción que identifica una suscripción de Azure.

api-version
query True

string

Versión de la API que se va a usar para la solicitud.

Respuestas

Nombre Tipo Description
200 OK

ManagedInstanceAdministratorListResult

Se recuperó correctamente la lista de administradores de instancias administradas.

Other Status Codes

ErrorResponse

Respuestas de error: ***

  • 400 SubredMissingRequiredDelegation: la subred seleccionada no está delegada para SQL Managed Instance.

  • 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 ServerNotInSubscription: el servidor especificado no existe en la suscripción especificada.

  • 404 ResourceNotFound: no se encontró el recurso solicitado.

  • 429 SubscriptionTooManyCreateUpdateRequests: solicitudes más allá de las solicitudes máximas que pueden procesar los recursos disponibles.

  • 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 pueden procesar los recursos disponibles.

  • 504 RequestTimeout: la solicitud de servicio superó el tiempo de espera permitido.

Ejemplos

List administrators of managed instance

Solicitud de ejemplo

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

Respuesta de muestra

{
  "value": [
    {
      "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
ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

ManagedInstanceAdministrator

Un administrador de instancia administrada de Azure SQL.

ManagedInstanceAdministratorListResult

Lista de administradores de instancias administradas.

ManagedInstanceAdministratorType

Tipo de administrador de instancia administrada.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.

type

string

Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Detalles del error.

message

string

Mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

ManagedInstanceAdministrator

Un administrador de instancia administrada de Azure SQL.

Nombre Tipo Description
id

string

Identificador de 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 (uuid)

SID (id. de objeto) del administrador de instancia administrada.

properties.tenantId

string (uuid)

Identificador de inquilino del administrador de la instancia administrada.

type

string

Tipo de recurso.

ManagedInstanceAdministratorListResult

Lista de administradores de instancias administradas.

Nombre Tipo Description
nextLink

string

Vínculo para recuperar la siguiente página de resultados.

value

ManagedInstanceAdministrator[]

Matriz de resultados.

ManagedInstanceAdministratorType

Tipo de administrador de instancia administrada.

Valor Description
ActiveDirectory