Administrators Microsoft Entra - Get

Ottiene informazioni su un amministratore di server associato a un Microsoft Entra principal.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}/administrators/{objectId}?api-version=2025-08-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
objectId
path True

string

Identificatore oggetto del principio Microsoft Entra.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.

serverName
path True

string

minLength: 3
maxLength: 63
pattern: ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*

Il nome del server.

subscriptionId
path True

string (uuid)

ID della sottoscrizione di destinazione. Il valore deve essere un UUID.

api-version
query True

string

minLength: 1

Versione dell'API da usare per questa operazione.

Risposte

Nome Tipo Descrizione
200 OK

AdministratorMicrosoftEntra

Operazione Azure completata con successo.

Other Status Codes

ErrorResponse

Risposta di errore imprevista.

Sicurezza

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

Get information about a server administrator associated to a Microsoft Entra principal.

Esempio di richiesta

GET https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver/administrators/oooooooo-oooo-oooo-oooo-oooooooooooo?api-version=2025-08-01

Risposta di esempio

{
  "name": "exampleuser@contoso.com",
  "type": "Microsoft.DBforPostgreSQL/flexibleServers/administrators",
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver/administrators/oooooooo-oooo-oooo-oooo-oooooooooooo",
  "properties": {
    "objectId": "oooooooo-oooo-oooo-oooo-oooooooooooo",
    "principalName": "exampleuser@contoso.com",
    "principalType": "User",
    "tenantId": "tttttttt-tttt-tttt-tttt-tttttttttttt"
  }
}

Definizioni

Nome Descrizione
AdministratorMicrosoftEntra

Amministratore server associato a un Microsoft Entra principal.

createdByType

Tipo di identità che ha creato la risorsa.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

PrincipalType

Tipo di principio Microsoft Entra a cui è associato l'amministratore del server.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

AdministratorMicrosoftEntra

Amministratore server associato a un Microsoft Entra principal.

Nome Tipo Descrizione
id

string (arm-id)

ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Nome della risorsa

properties.objectId

string

Identificatore oggetto del principio Microsoft Entra.

properties.principalName

string

Nome del preside di Microsoft Entra.

properties.principalType

PrincipalType

Tipo di principio Microsoft Entra a cui è associato l'amministratore del server.

properties.tenantId

string

Identificatore dell'inquilino in cui esiste il principale Microsoft Entra.

systemData

systemData

Azure Resource Manager metadati contenenti informazioni createBy e modifiedBy.

type

string

Tipo di risorsa. Ad esempio: "Microsoft. Compute/virtualMachines" oppure "Microsoft. Storage/storageAccounts"

createdByType

Tipo di identità che ha creato la risorsa.

Valore Descrizione
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

PrincipalType

Tipo di principio Microsoft Entra a cui è associato l'amministratore del server.

Valore Descrizione
Unknown

Il tipo principale non è noto o non specificato.

User

Un utente Microsoft Entra.

Group

Un gruppo Microsoft Entra.

ServicePrincipal

Un Microsoft Entra service principal, tipicamente rappresenta l'identità di un'applicazione o di un servizio.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome Tipo Descrizione
createdAt

string (date-time)

Timestamp della creazione della risorsa (UTC).

createdBy

string

Identità che ha creato la risorsa.

createdByType

createdByType

Tipo di identità che ha creato la risorsa.

lastModifiedAt

string (date-time)

Timestamp dell'ultima modifica della risorsa (UTC)

lastModifiedBy

string

Identità che ha modificato l'ultima volta la risorsa.

lastModifiedByType

createdByType

Tipo di identità che ha modificato l'ultima volta la risorsa.