Servers - Get

Referencia

Szolgáltatás:: SQL Database

API-verzió:: 2021-11-01

Megkap egy kiszolgálót.

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

Opcionális paraméterekkel:

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
resourceGroupName	path	True	string	Az erőforrást tartalmazó erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból vagy a portálról szerezheti be.
serverName	path	True	string	A kiszolgáló neve.
subscriptionId	path	True	string	Az Azure-előfizetést azonosító előfizetés-azonosító.
api-version	query	True	string	A kéréshez használni kívánt API-verzió.
$expand	query		string	A válaszba belefoglalandó gyermekerőforrások.

Válaszok

Name	Típus	Description
200 OK	Server	Sikeresen lekérte a megadott kiszolgálót.
Other Status Codes		Hibaválaszok: *** 404 SubscriptionNotFound – A kért előfizetés nem található. 404 ResourceNotFound – A kért erőforrás nem található.

Name

Típus

Description

200 OK

Server

Sikeresen lekérte a megadott kiszolgálót.

Other Status Codes

Hibaválaszok: ***

404 SubscriptionNotFound – A kért előfizetés nem található.
404 ResourceNotFound – A kért erőforrás nem található.

Példák

Get server

Get server with $expand=administrators/activedirectory

Get server

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


/**
 * Samples for Servers GetByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ServerGet.json
     */
    /**
     * Sample code: Get server.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getServer(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServers().getByResourceGroupWithResponse("sqlcrudtest-7398",
            "sqlcrudtest-4645", null, 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

Mintaválasz

Állapotkód:: 200

{
  "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

Mintakérelem

HTTP
Java

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


/**
 * Samples for Servers GetByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ServerGetWithExpandEqualsAdministrators.json
     */
    /**
     * Sample code: Get server with $expand=administrators/activedirectory.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getServerWithExpandAdministratorsActivedirectory(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServers().getByResourceGroupWithResponse("sqlcrudtest-7398",
            "sqlcrudtest-4645", null, 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

Mintaválasz

Állapotkód:: 200

{
  "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"
          }
        }
      }
    ]
  }
}

Definíciók

Name	Description
AdministratorType	A rendszergazda típusa.
IdentityType	Az identitás típusa. Állítsa ezt a "SystemAssigned" értékre, hogy automatikusan létrehozhasson és hozzárendelhessen egy Azure Active Directory-tagot az erőforráshoz.
PrincipalType	A rendszergazda egyszerű típusa.
PrivateEndpointConnectionProperties	Privát végpontkapcsolat tulajdonságai.
PrivateEndpointProperty
PrivateEndpointProvisioningState	A privát végpontkapcsolat állapota.
PrivateLinkServiceConnectionStateActionsRequire	A privát kapcsolat szolgáltatáskapcsolatához szükséges műveletek.
PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus	A privát kapcsolat szolgáltatás kapcsolati állapota.
ResourceIdentity	Azure Active Directory-identitáskonfiguráció egy erőforráshoz.
Server	Egy Azure SQL Database-kiszolgáló.
ServerExternalAdministrator	Az Active Directory-rendszergazda tulajdonságai.
ServerNetworkAccessFlag	Azt jelzi, hogy engedélyezett-e nyilvános végpont-hozzáférés ehhez a kiszolgálóhoz. Az érték megadása nem kötelező, de ha be van adva, "Engedélyezve" vagy "Letiltva" értéknek kell lennie
ServerPrivateEndpointConnection	Privát végpontkapcsolat egy kiszolgáló alatt
ServerWorkspaceFeature	Azt jelzi, hogy a meglévő kiszolgáló rendelkezik-e munkaterület létrehozásával, és engedélyezi-e a kapcsolatot a munkaterületről
UserIdentity	Azure Active Directory-identitáskonfiguráció egy erőforráshoz.

AdministratorType

Enumerálás

A rendszergazda típusa.

Érték	Description
ActiveDirectory

IdentityType

Enumerálás

Az identitás típusa. Állítsa ezt a "SystemAssigned" értékre, hogy automatikusan létrehozhasson és hozzárendelhessen egy Azure Active Directory-tagot az erőforráshoz.

Érték	Description
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

PrincipalType

Enumerálás

A rendszergazda egyszerű típusa.

Érték	Description
Application
Group
User

PrivateEndpointConnectionProperties

Objektum

Privát végpontkapcsolat tulajdonságai.

Name	Típus	Description
groupIds	string[]	Csoportazonosítók.
privateEndpoint	PrivateEndpointProperty	Privát végpont, amelyhez a kapcsolat tartozik.
privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	A privát végpont kapcsolati állapota.
provisioningState	PrivateEndpointProvisioningState	A privát végpontkapcsolat állapota.

PrivateEndpointProperty

Objektum

Name	Típus	Description
id	string	A privát végpont erőforrás-azonosítója.

PrivateEndpointProvisioningState

Enumerálás

A privát végpontkapcsolat állapota.

Érték	Description
Approving
Dropping
Failed
Ready
Rejecting

PrivateLinkServiceConnectionStateActionsRequire

Enumerálás

A privát kapcsolat szolgáltatáskapcsolatához szükséges műveletek.

Érték	Description
None

PrivateLinkServiceConnectionStateProperty

Objektum

Name	Típus	Description
actionsRequired	PrivateLinkServiceConnectionStateActionsRequire	A privát kapcsolat szolgáltatáskapcsolatához szükséges műveletek.
description	string	A privát kapcsolat szolgáltatás kapcsolatának leírása.
status	PrivateLinkServiceConnectionStateStatus	A privát kapcsolat szolgáltatás kapcsolati állapota.

PrivateLinkServiceConnectionStateStatus

Enumerálás

A privát kapcsolat szolgáltatás kapcsolati állapota.

Érték	Description
Approved
Disconnected
Pending
Rejected

ResourceIdentity

Objektum

Azure Active Directory-identitáskonfiguráció egy erőforráshoz.

Name	Típus	Description
principalId	string (uuid)	Az Azure Active Directory egyszerű azonosítója.
tenantId	string (uuid)	Az Azure Active Directory bérlőazonosítója.
type	IdentityType	Az identitás típusa. Állítsa ezt a "SystemAssigned" értékre, hogy automatikusan létrehozhasson és hozzárendelhessen egy Azure Active Directory-tagot az erőforráshoz.
userAssignedIdentities	<string, UserIdentity>	A felhasználó által hozzárendelt használt identitások erőforrás-azonosítói

Server

Objektum

Egy Azure SQL Database-kiszolgáló.

Name	Típus	Description
id	string	Erőforrás-azonosító.
identity	ResourceIdentity	A kiszolgáló Azure Active Directory-identitása.
kind	string	Az SQL Server típusa. Ez az Azure Portal felhasználói élményéhez használt metaadatok.
location	string	Erőforrás helye.
name	string	Erőforrás neve.
properties.administratorLogin	string	A kiszolgáló rendszergazdai felhasználóneve. A létrehozás után nem módosítható.
properties.administratorLoginPassword	string	A rendszergazda bejelentkezési jelszava (a kiszolgáló létrehozásához szükséges).
properties.administrators	ServerExternalAdministrator	A kiszolgáló Azure Active Directory-rendszergazdája.
properties.federatedClientId	string (uuid)	A bérlők közötti CMK-forgatókönyvhöz használt ügyfélazonosító
properties.fullyQualifiedDomainName	string	A kiszolgáló teljes tartományneve.
properties.keyId	string	A titkosításhoz használandó kulcs CMK URI-ja.
properties.minimalTlsVersion	string	Minimális TLS-verzió. Engedélyezett értékek: "1.0", "1.1", "1.2"
properties.primaryUserAssignedIdentityId	string (arm-id)	A felhasználó által hozzárendelt identitás erőforrás-azonosítója, amelyet alapértelmezés szerint használni szeretne.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	A kiszolgáló magánvégpont-kapcsolatainak listája
properties.publicNetworkAccess	ServerNetworkAccessFlag	Azt jelzi, hogy engedélyezett-e nyilvános végpont-hozzáférés ehhez a kiszolgálóhoz. Az érték megadása nem kötelező, de ha be van adva, "Engedélyezve" vagy "Letiltva" értéknek kell lennie
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	A kiszolgáló kimenő hálózati hozzáférésének korlátozása. Az érték megadása nem kötelező, de ha be van adva, "Engedélyezve" vagy "Letiltva" értéknek kell lennie
properties.state	string	A kiszolgáló állapota.
properties.version	string	A kiszolgáló verziója.
properties.workspaceFeature	ServerWorkspaceFeature	Azt jelzi, hogy a meglévő kiszolgáló rendelkezik-e munkaterület létrehozásával, és engedélyezi-e a kapcsolatot a munkaterületről
tags	object	Erőforráscímkék.
type	string	Erőforrás típusa.

ServerExternalAdministrator

Objektum

Az Active Directory-rendszergazda tulajdonságai.

Name	Típus	Description
administratorType	AdministratorType	A rendszergazda típusa.
azureADOnlyAuthentication	boolean	Csak az Azure Active Directory hitelesítése engedélyezett.
login	string	A kiszolgáló rendszergazdájának bejelentkezési neve.
principalType	PrincipalType	A rendszergazda egyszerű típusa.
sid	string (uuid)	A kiszolgáló rendszergazdájának SID-azonosítója (objektumazonosítója).
tenantId	string (uuid)	A rendszergazda bérlőazonosítója.

ServerNetworkAccessFlag

Enumerálás

Azt jelzi, hogy engedélyezett-e nyilvános végpont-hozzáférés ehhez a kiszolgálóhoz. Az érték megadása nem kötelező, de ha be van adva, "Engedélyezve" vagy "Letiltva" értéknek kell lennie

Érték	Description
Disabled
Enabled

ServerPrivateEndpointConnection

Objektum

Privát végpontkapcsolat egy kiszolgáló alatt

Name	Típus	Description
id	string	Erőforrás-azonosító.
properties	PrivateEndpointConnectionProperties	Privát végpont kapcsolati tulajdonságai

ServerWorkspaceFeature

Enumerálás

Azt jelzi, hogy a meglévő kiszolgáló rendelkezik-e munkaterület létrehozásával, és engedélyezi-e a kapcsolatot a munkaterületről

Érték	Description
Connected
Disconnected

UserIdentity

Objektum

Azure Active Directory-identitáskonfiguráció egy erőforráshoz.

Name	Típus	Description
clientId	string (uuid)	Az Azure Active Directory-ügyfél azonosítója.
principalId	string (uuid)	Az Azure Active Directory egyszerű azonosítója.

Megosztás a következőn keresztül:

Servers - Get

URI-paraméterek

Válaszok

Példák

Get server

Mintakérelem

Mintaválasz

Get server with $expand=administrators/activedirectory

Mintakérelem

Mintaválasz

Definíciók

AdministratorType

IdentityType

PrincipalType

PrivateEndpointConnectionProperties

PrivateEndpointProperty

PrivateEndpointProvisioningState

PrivateLinkServiceConnectionStateActionsRequire

PrivateLinkServiceConnectionStateProperty

PrivateLinkServiceConnectionStateStatus

ResourceIdentity

Server

ServerExternalAdministrator

ServerNetworkAccessFlag

ServerPrivateEndpointConnection

ServerWorkspaceFeature

UserIdentity

További források