Servers - List

구독의 모든 서버 목록을 가져옵니다.

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

URI 매개 변수

Name In Required Type Description
subscriptionId
path True
  • string

Azure 구독을 식별하는 구독 ID입니다.

api-version
query True
  • string

요청에 사용할 API 버전입니다.

$expand
query
  • string

응답에 포함할 자식 리소스입니다.

응답

Name Type Description
200 OK

서버 목록을 검색 했습니다.

Other Status Codes

오류 응답: * * *

예제

List servers
List servers with expand equals administrators

List servers

Sample Request

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/servers?api-version=2021-02-01-preview

Sample Response

{
  "value": [
    {
      "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"
              }
            }
          }
        ]
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-6661",
      "name": "sqlcrudtest-6661",
      "type": "Microsoft.Sql/servers",
      "location": "japaneast",
      "kind": "v12.0",
      "properties": {
        "fullyQualifiedDomainName": "sqlcrudtest-6661.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"
              }
            }
          }
        ]
      }
    }
  ]
}

List servers with expand equals administrators

Sample Request

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/servers?api-version=2021-02-01-preview

Sample Response

{
  "value": [
    {
      "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"
              }
            }
          }
        ]
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-6661",
      "name": "sqlcrudtest-6661",
      "type": "Microsoft.Sql/servers",
      "location": "japaneast",
      "kind": "v12.0",
      "properties": {
        "fullyQualifiedDomainName": "sqlcrudtest-6661.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"
              }
            }
          }
        ]
      }
    }
  ]
}

정의

AdministratorType

서버 관리자의 유형입니다.

IdentityType

Id 형식입니다. 리소스의 Azure Active Directory 보안 주체를 자동으로 만들고 할당 하려면이를 ' SystemAssigned 됨 '으로 설정 합니다.

PrincipalType

서버 관리자의 보안 주체 유형입니다.

PrivateEndpointConnectionProperties

개인 끝점 연결의 속성입니다.

PrivateEndpointProperty
PrivateEndpointProvisioningState

개인 끝점 연결의 상태입니다.

PrivateLinkServiceConnectionStateActionsRequire

개인 링크 서비스 연결에 필요한 작업입니다.

PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus

개인 링크 서비스 연결 상태입니다.

ResourceIdentity

리소스에 대 한 id 구성을 Azure Active Directory 합니다.

Server

Azure SQL Database 서버입니다.

ServerExternalAdministrator

Active directory 관리자의 속성입니다.

ServerListResult

서버 목록입니다.

ServerNetworkAccessFlag

이 서버에 대 한 공용 끝점 액세스가 허용 되는지 여부입니다. 값은 선택 사항 이지만 전달 된 경우 ' Enabled ' 또는 ' Disabled ' 여야 합니다.

ServerPrivateEndpointConnection

서버 아래의 개인 끝점 연결

ServerWorkspaceFeature

기존 서버에 작업 영역을 만들고 작업 영역에서 연결을 허용 하는지 여부

UserIdentity

리소스에 대 한 id 구성을 Azure Active Directory 합니다.

AdministratorType

서버 관리자의 유형입니다.

Name Type Description
ActiveDirectory
  • string

IdentityType

Id 형식입니다. 리소스의 Azure Active Directory 보안 주체를 자동으로 만들고 할당 하려면이를 ' SystemAssigned 됨 '으로 설정 합니다.

Name Type Description
None
  • string
SystemAssigned
  • string
UserAssigned
  • string

PrincipalType

서버 관리자의 보안 주체 유형입니다.

Name Type Description
Application
  • string
Group
  • string
User
  • string

PrivateEndpointConnectionProperties

개인 끝점 연결의 속성입니다.

Name Type Description
privateEndpoint

연결이 속한 개인 끝점입니다.

privateLinkServiceConnectionState

개인 끝점 연결의 연결 상태입니다.

provisioningState

개인 끝점 연결의 상태입니다.

PrivateEndpointProperty

Name Type Description
id
  • string

개인 끝점의 리소스 id입니다.

PrivateEndpointProvisioningState

개인 끝점 연결의 상태입니다.

Name Type Description
Approving
  • string
Dropping
  • string
Failed
  • string
Ready
  • string
Rejecting
  • string

PrivateLinkServiceConnectionStateActionsRequire

개인 링크 서비스 연결에 필요한 작업입니다.

Name Type Description
None
  • string

PrivateLinkServiceConnectionStateProperty

Name Type Description
actionsRequired

개인 링크 서비스 연결에 필요한 작업입니다.

description
  • string

개인 링크 서비스 연결 설명입니다.

status

개인 링크 서비스 연결 상태입니다.

PrivateLinkServiceConnectionStateStatus

개인 링크 서비스 연결 상태입니다.

Name Type Description
Approved
  • string
Disconnected
  • string
Pending
  • string
Rejected
  • string

ResourceIdentity

리소스에 대 한 id 구성을 Azure Active Directory 합니다.

Name Type Description
principalId
  • string

Azure Active Directory 보안 주체 id입니다.

tenantId
  • string

Azure Active Directory 테 넌 트 id입니다.

type

Id 형식입니다. 리소스의 Azure Active Directory 보안 주체를 자동으로 만들고 할당 하려면이를 ' SystemAssigned 됨 '으로 설정 합니다.

userAssignedIdentities

사용할 사용자 할당 id의 리소스 id

Server

Azure SQL Database 서버입니다.

Name Type Description
id
  • string

리소스 ID입니다.

identity

서버의 Azure Active Directory id입니다.

kind
  • string

Sql server의 종류입니다. Azure Portal 환경에 사용 되는 메타 데이터입니다.

location
  • string

리소스 위치.

name
  • string

리소스 이름입니다.

properties.administratorLogin
  • string

서버에 대 한 관리자 사용자 이름입니다. 만든 후에는 변경할 수 없습니다.

properties.administratorLoginPassword
  • string

서버를 만드는 데 필요한 관리자 로그인 암호입니다.

properties.administrators

서버의 Azure Active Directory id입니다.

properties.federatedClientId
  • string

다중 테 넌 트 CMK 시나리오에 사용 되는 클라이언트 id입니다.

properties.fullyQualifiedDomainName
  • string

서버의 정규화 된 도메인 이름입니다.

properties.keyId
  • string

암호화에 사용할 키의 CMK URI입니다.

properties.minimalTlsVersion
  • string

최소 TLS 버전 허용 되는 값: ' 1.0 ', ' 1.1 ', ' 1.2 '

properties.primaryUserAssignedIdentityId
  • string

기본적으로 사용 되는 사용자 할당 id의 리소스 id입니다.

properties.privateEndpointConnections

서버의 개인 끝점 연결 목록

properties.publicNetworkAccess

이 서버에 대 한 공용 끝점 액세스가 허용 되는지 여부입니다. 값은 선택 사항 이지만 전달 된 경우 ' Enabled ' 또는 ' Disabled ' 여야 합니다.

properties.restrictOutboundNetworkAccess

이 서버에 대 한 아웃 바운드 네트워크 액세스를 제한할지 여부입니다. 값은 선택 사항 이지만 전달 된 경우 ' Enabled ' 또는 ' Disabled ' 여야 합니다.

properties.state
  • string

서버의 상태입니다.

properties.version
  • string

서버의 버전입니다.

properties.workspaceFeature

기존 서버에 작업 영역을 만들고 작업 영역에서 연결을 허용 하는지 여부

tags
  • object

리소스 태그.

type
  • string

리소스 종류.

ServerExternalAdministrator

Active directory 관리자의 속성입니다.

Name Type Description
administratorType

서버 관리자의 유형입니다.

azureADOnlyAuthentication
  • boolean

Azure Active Directory 인증만 사용 됩니다.

login
  • string

서버 관리자의 로그인 이름입니다.

principalType

서버 관리자의 보안 주체 유형입니다.

sid
  • string

서버 관리자의 SID (개체 ID)입니다.

tenantId
  • string

관리자의 테 넌 트 ID입니다.

ServerListResult

서버 목록입니다.

Name Type Description
nextLink
  • string

다음 결과 페이지를 검색 하는 링크입니다.

value

결과의 배열입니다.

ServerNetworkAccessFlag

이 서버에 대 한 공용 끝점 액세스가 허용 되는지 여부입니다. 값은 선택 사항 이지만 전달 된 경우 ' Enabled ' 또는 ' Disabled ' 여야 합니다.

Name Type Description
Disabled
  • string
Enabled
  • string

ServerPrivateEndpointConnection

서버 아래의 개인 끝점 연결

Name Type Description
id
  • string

리소스 ID입니다.

properties

개인 끝점 연결 속성

ServerWorkspaceFeature

기존 서버에 작업 영역을 만들고 작업 영역에서 연결을 허용 하는지 여부

Name Type Description
Connected
  • string
Disconnected
  • string

UserIdentity

리소스에 대 한 id 구성을 Azure Active Directory 합니다.

Name Type Description
clientId
  • string

Azure Active Directory 클라이언트 id입니다.

principalId
  • string

Azure Active Directory 보안 주체 id입니다.