Dela via


Server Azure AD Administrators - List By Server

Hämtar en lista över Azure Active Directory-administratörer på en server.

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

URI-parametrar

Name I Obligatorisk Typ Description
resourceGroupName
path True

string

Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.

serverName
path True

string

Namnet på servern.

subscriptionId
path True

string

Det prenumerations-ID som identifierar en Azure-prenumeration.

api-version
query True

string

DEN API-version som ska användas för begäran.

Svar

Name Typ Description
200 OK

AdministratorListResult

Listan över Azure Active Directory-administratörer har hämtats.

Other Status Codes

ErrorResponse

Felsvar: ***

  • 400 ManagedInstanceStoppingOrS toppad – Konfliktåtgärd som skickas när instansen är i stopptillstånd

  • 400 ManagedInstanceStarting – Konfliktåtgärd som skickas när instansen är i starttillstånd

  • 400 InvalidServerAdministratorTypePropertyName – Server active directory-administratörstypen bör vara ActiveDirectory

  • 400 InvalidResourceRequestBody – Resurs- eller resursegenskaperna i begärandetexten är tomma eller ogiltiga.

  • 400 InvalidServerAzureADOnlyAuthenticationParameter – Användaren försökte ange parametern AzureADOnlyAuthentication till false vilket inte är tillåtet. Använd azureADOnlyAuthentications API i stället.

  • 400 InvalidServerAzureADAdminDeleteOperation – Användaren försökte ta bort serverns Azure Active Azure-administratör när AzureADOnlyAuthentication har angetts. Använd först API:et azureADOnlyAuthentications.

  • 404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen.

  • 404 SubscriptionDoesNotHaveServer – Den begärda servern hittades inte

  • 404 ResourceNotFound – Den begärda resursen hittades inte.

Exempel

Gets a list of Azure Active Directory administrator.

Exempelbegäran

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-4799/providers/Microsoft.Sql/servers/sqlcrudtest-6440/administrators?api-version=2023-08-01

Exempelsvar

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-4799/providers/Microsoft.Sql/servers/sqlcrudtest-6440/administrators/ActiveDirectory",
      "name": "ActiveDirectory",
      "type": "Microsoft.Sql/servers/administrators",
      "properties": {
        "administratorType": "ActiveDirectory",
        "login": "bob@contoso.com",
        "sid": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c",
        "tenantId": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c",
        "azureADOnlyAuthentication": true
      }
    }
  ]
}

Definitioner

Name Description
AdministratorListResult

En lista över Active Directory-administratörer.

AdministratorType

Typ av administratör för serverservern.

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

ErrorDetail

Felinformationen.

ErrorResponse

Felsvar

ServerAzureADAdministrator

Azure Active Directory-administratör.

AdministratorListResult

En lista över Active Directory-administratörer.

Name Typ Description
nextLink

string

Länka för att hämta nästa sida med resultat.

value

ServerAzureADAdministrator[]

Matris med resultat.

AdministratorType

Typ av administratör för serverservern.

Värde Description
ActiveDirectory

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name Typ Description
info

object

Ytterligare information.

type

string

Ytterligare informationstyp.

ErrorDetail

Felinformationen.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Ytterligare information om felet.

code

string

Felkoden.

details

ErrorDetail[]

Felinformationen.

message

string

Felmeddelandet.

target

string

Felmålet.

ErrorResponse

Felsvar

Name Typ Description
error

ErrorDetail

Felobjektet.

ServerAzureADAdministrator

Azure Active Directory-administratör.

Name Typ Description
id

string

Resurs-ID.

name

string

Resursnamn.

properties.administratorType

AdministratorType

Typ av administratör för serverservern.

properties.azureADOnlyAuthentication

boolean

Endast Azure Active Directory-autentisering aktiverat.

properties.login

string

Serveradministratörens inloggningsnamn.

properties.sid

string (uuid)

SID (objekt-ID) för serveradministratören.

properties.tenantId

string (uuid)

Administratörens klientorganisations-ID.

type

string

Resurstyp.