Condividi tramite


Servers - Get

Ottiene un server.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}?api-version=2021-11-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}?$expand={$expand}&api-version=2021-11-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
resourceGroupName
path True

string

Nome del gruppo di risorse contenente la risorsa. È possibile ottenere questo valore dall'API di Gestione risorse di Azure o dal portale.

serverName
path True

string

Nome del server.

subscriptionId
path True

string

ID sottoscrizione che identifica una sottoscrizione di Azure.

api-version
query True

string

Versione dell'API da usare per la richiesta.

$expand
query

string

Risorse figlio da includere nella risposta.

Risposte

Nome Tipo Descrizione
200 OK

Server

È stato recuperato correttamente il server specificato.

Other Status Codes

Risposte di errore:

  • 404 SubscriptionNotFound: la sottoscrizione richiesta non è stata trovata.

  • 404 ResourceNotFound: la risorsa richiesta non è stata trovata.

Esempio

Get server
Get server with $expand=administrators/activedirectory

Get server

Esempio di richiesta

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645?api-version=2021-11-01

Risposta di esempio

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645",
  "name": "sqlcrudtest-4645",
  "type": "Microsoft.Sql/servers",
  "location": "japaneast",
  "kind": "v12.0",
  "properties": {
    "fullyQualifiedDomainName": "sqlcrudtest-4645.database.windows.net",
    "administratorLogin": "dummylogin",
    "version": "12.0",
    "state": "Ready",
    "workspaceFeature": "Connected",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "privateEndpointConnections": [
      {
        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645/privateEndpointConnections/private-endpoint-name-00000000-1111-2222-3333-444444444444",
        "properties": {
          "provisioningState": "Ready",
          "privateEndpoint": {
            "id": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-Network/providers/Microsoft.Network/privateEndpoints/private-endpoint-name"
          },
          "privateLinkServiceConnectionState": {
            "status": "Approved",
            "description": "Auto-approved",
            "actionsRequired": "None"
          }
        }
      }
    ]
  }
}

Get server with $expand=administrators/activedirectory

Esempio di richiesta

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645?api-version=2021-11-01

Risposta di esempio

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645",
  "name": "sqlcrudtest-4645",
  "type": "Microsoft.Sql/servers",
  "location": "japaneast",
  "kind": "v12.0",
  "properties": {
    "fullyQualifiedDomainName": "sqlcrudtest-4645.database.windows.net",
    "administratorLogin": "dummylogin",
    "version": "12.0",
    "state": "Ready",
    "workspaceFeature": "Connected",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "privateEndpointConnections": [
      {
        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645/privateEndpointConnections/private-endpoint-name-00000000-1111-2222-3333-444444444444",
        "properties": {
          "provisioningState": "Ready",
          "privateEndpoint": {
            "id": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-Network/providers/Microsoft.Network/privateEndpoints/private-endpoint-name"
          },
          "privateLinkServiceConnectionState": {
            "status": "Approved",
            "description": "Auto-approved",
            "actionsRequired": "None"
          }
        }
      }
    ]
  }
}

Definizioni

Nome Descrizione
AdministratorType

Tipo di amministratore del server.

IdentityType

Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di Azure Active Directory per la risorsa.

PrincipalType

Tipo di entità dell'amministratore del server.

PrivateEndpointConnectionProperties

Proprietà di una connessione endpoint privato.

PrivateEndpointProperty
PrivateEndpointProvisioningState

Stato della connessione dell'endpoint privato.

PrivateLinkServiceConnectionStateActionsRequire

Azioni necessarie per la connessione al servizio di collegamento privato.

PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus

Stato della connessione al servizio di collegamento privato.

ResourceIdentity

Configurazione dell'identità di Azure Active Directory per una risorsa.

Server

Un server di database Azure SQL.

ServerExternalAdministrator

Proprietà di un amministratore di Active Directory.

ServerNetworkAccessFlag

Indica se l'accesso all'endpoint pubblico è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled'

ServerPrivateEndpointConnection

Una connessione endpoint privato in un server

ServerWorkspaceFeature

Indica se nel server esistente è stata creata un'area di lavoro e se consente la connessione dall'area di lavoro

UserIdentity

Configurazione dell'identità di Azure Active Directory per una risorsa.

AdministratorType

Tipo di amministratore del server.

Nome Tipo Descrizione
ActiveDirectory

string

IdentityType

Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di Azure Active Directory per la risorsa.

Nome Tipo Descrizione
None

string

SystemAssigned

string

SystemAssigned,UserAssigned

string

UserAssigned

string

PrincipalType

Tipo di entità dell'amministratore del server.

Nome Tipo Descrizione
Application

string

Group

string

User

string

PrivateEndpointConnectionProperties

Proprietà di una connessione endpoint privato.

Nome Tipo Descrizione
groupIds

string[]

ID gruppo.

privateEndpoint

PrivateEndpointProperty

Endpoint privato a cui appartiene la connessione.

privateLinkServiceConnectionState

PrivateLinkServiceConnectionStateProperty

Stato di connessione della connessione dell'endpoint privato.

provisioningState

PrivateEndpointProvisioningState

Stato della connessione dell'endpoint privato.

PrivateEndpointProperty

Nome Tipo Descrizione
id

string

ID risorsa dell'endpoint privato.

PrivateEndpointProvisioningState

Stato della connessione dell'endpoint privato.

Nome Tipo Descrizione
Approving

string

Dropping

string

Failed

string

Ready

string

Rejecting

string

PrivateLinkServiceConnectionStateActionsRequire

Azioni necessarie per la connessione al servizio di collegamento privato.

Nome Tipo Descrizione
None

string

PrivateLinkServiceConnectionStateProperty

Nome Tipo Descrizione
actionsRequired

PrivateLinkServiceConnectionStateActionsRequire

Azioni necessarie per la connessione al servizio di collegamento privato.

description

string

Descrizione della connessione al servizio di collegamento privato.

status

PrivateLinkServiceConnectionStateStatus

Stato della connessione al servizio di collegamento privato.

PrivateLinkServiceConnectionStateStatus

Stato della connessione al servizio di collegamento privato.

Nome Tipo Descrizione
Approved

string

Disconnected

string

Pending

string

Rejected

string

ResourceIdentity

Configurazione dell'identità di Azure Active Directory per una risorsa.

Nome Tipo Descrizione
principalId

string

ID entità di Azure Active Directory.

tenantId

string

ID tenant di Azure Active Directory.

type

IdentityType

Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di Azure Active Directory per la risorsa.

userAssignedIdentities

<string,  UserIdentity>

ID risorsa delle identità assegnate dall'utente da usare

Server

Un server di database Azure SQL.

Nome Tipo Descrizione
id

string

ID risorsa.

identity

ResourceIdentity

Identità di Azure Active Directory del server.

kind

string

Tipo di sql server. Si tratta di metadati usati per l'esperienza di portale di Azure.

location

string

Percorso della risorsa.

name

string

Nome risorsa.

properties.administratorLogin

string

Nome utente amministratore per il server. Una volta creata, non è possibile modificarla.

properties.administratorLoginPassword

string

Password di accesso dell'amministratore (necessaria per la creazione del server).

properties.administrators

ServerExternalAdministrator

Amministratore di Azure Active Directory del server.

properties.federatedClientId

string

ID client usato per lo scenario cmk tra tenant

properties.fullyQualifiedDomainName

string

Nome di dominio completo del server.

properties.keyId

string

URI cmk della chiave da usare per la crittografia.

properties.minimalTlsVersion

string

Versione minima di TLS. Valori consentiti: '1.0', '1.1', '1.2'

properties.primaryUserAssignedIdentityId

string

ID risorsa di un'identità assegnata dall'utente da usare per impostazione predefinita.

properties.privateEndpointConnections

ServerPrivateEndpointConnection[]

Elenco di connessioni di endpoint privato in un server

properties.publicNetworkAccess

ServerNetworkAccessFlag

Indica se l'accesso all'endpoint pubblico è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled'

properties.restrictOutboundNetworkAccess

ServerNetworkAccessFlag

Indica se limitare o meno l'accesso alla rete in uscita per questo server. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled'

properties.state

string

Stato del server.

properties.version

string

Versione del server.

properties.workspaceFeature

ServerWorkspaceFeature

Indica se nel server esistente è stata creata un'area di lavoro e se consente la connessione dall'area di lavoro

tags

object

Tag delle risorse.

type

string

Tipo di risorsa.

ServerExternalAdministrator

Proprietà di un amministratore di Active Directory.

Nome Tipo Descrizione
administratorType

AdministratorType

Tipo di amministratore del server.

azureADOnlyAuthentication

boolean

Autenticazione di Azure Active Directory abilitata solo.

login

string

Nome di accesso dell'amministratore del server.

principalType

PrincipalType

Tipo di entità dell'amministratore del server.

sid

string

SID (ID oggetto) dell'amministratore del server.

tenantId

string

ID tenant dell'amministratore.

ServerNetworkAccessFlag

Indica se l'accesso all'endpoint pubblico è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled'

Nome Tipo Descrizione
Disabled

string

Enabled

string

ServerPrivateEndpointConnection

Una connessione endpoint privato in un server

Nome Tipo Descrizione
id

string

ID risorsa.

properties

PrivateEndpointConnectionProperties

Proprietà di connessione dell'endpoint privato

ServerWorkspaceFeature

Indica se nel server esistente è stata creata un'area di lavoro e se consente la connessione dall'area di lavoro

Nome Tipo Descrizione
Connected

string

Disconnected

string

UserIdentity

Configurazione dell'identità di Azure Active Directory per una risorsa.

Nome Tipo Descrizione
clientId

string

ID client di Azure Active Directory.

principalId

string

ID entità di Azure Active Directory.