Servers - List By Resource Group

Obtiene una lista de servidores de un grupo de recursos.

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

Parámetros de identificador URI

Name In Required Type Description
resourceGroupName
path True
  • string

Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor en la API del Administrador de recursos o el portal de Azure.

subscriptionId
path True
  • string

El id. de suscripción que identifica una suscripción de Azure.

api-version
query True
  • string

La versión de API que se usará para la solicitud.

$expand
query
  • string

Los recursos secundarios que se van a incluir en la respuesta.

Respuestas

Name Type Description
200 OK

Recuperó correctamente la lista de servidores.

Other Status Codes

Respuestas de error: ***

Ejemplos

List servers by resource group
List servers by resource group with $expand=administrators

List servers by resource group

Sample Request

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/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 by resource group with $expand=administrators

Sample Request

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/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"
              }
            }
          }
        ]
      }
    }
  ]
}

Definiciones

AdministratorType

Tipo del administrador del servidor.

IdentityType

Tipo de identidad. Establézcalo en "SystemAssigned" para crear y asignar automáticamente una entidad de seguridad de Azure Active Directory para el recurso.

PrincipalType

Tipo de entidad de seguridad del administrador del servidor.

PrivateEndpointConnectionProperties

Propiedades de una conexión de punto de conexión privado.

PrivateEndpointProperty
PrivateEndpointProvisioningState

Estado de la conexión del punto de conexión privado.

PrivateLinkServiceConnectionStateActionsRequire

Las acciones necesarias para la conexión del servicio Private Link.

PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus

Estado de conexión del servicio Private Link.

ResourceIdentity

Azure Active Directory configuración de identidad de un recurso.

Server

Un servidor Azure SQL Database.

ServerExternalAdministrator

Propiedades de un administrador de Active Directory.

ServerListResult

Una lista de servidores.

ServerNetworkAccessFlag

Si se permite o no el acceso al punto de conexión público para este servidor. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado".

ServerPrivateEndpointConnection

Una conexión de punto de conexión privado en un servidor

ServerWorkspaceFeature

Si el servidor existente tiene o no un área de trabajo creada y si permite la conexión desde el área de trabajo

UserIdentity

Azure Active Directory configuración de identidad de un recurso.

AdministratorType

Tipo del administrador del servidor.

Name Type Description
ActiveDirectory
  • string

IdentityType

Tipo de identidad. Establézcalo en "SystemAssigned" para crear y asignar automáticamente una entidad de seguridad de Azure Active Directory para el recurso.

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

PrincipalType

Tipo de entidad de seguridad del administrador del servidor.

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

PrivateEndpointConnectionProperties

Propiedades de una conexión de punto de conexión privado.

Name Type Description
privateEndpoint

Punto de conexión privado al que pertenece la conexión.

privateLinkServiceConnectionState

Estado de conexión de la conexión del punto de conexión privado.

provisioningState

Estado de la conexión del punto de conexión privado.

PrivateEndpointProperty

Name Type Description
id
  • string

Identificador de recurso del punto de conexión privado.

PrivateEndpointProvisioningState

Estado de la conexión del punto de conexión privado.

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

PrivateLinkServiceConnectionStateActionsRequire

Las acciones necesarias para la conexión del servicio Private Link.

Name Type Description
None
  • string

PrivateLinkServiceConnectionStateProperty

Name Type Description
actionsRequired

Las acciones necesarias para la conexión del servicio Private Link.

description
  • string

Descripción de la conexión del servicio Private Link.

status

Estado de conexión del servicio Private Link.

PrivateLinkServiceConnectionStateStatus

Estado de conexión del servicio Private Link.

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

ResourceIdentity

Azure Active Directory configuración de identidad de un recurso.

Name Type Description
principalId
  • string

Identificador de Azure Active Directory entidad de seguridad.

tenantId
  • string

Identificador de inquilino de Azure Active Directory.

type

Tipo de identidad. Establézcalo en "SystemAssigned" para crear y asignar automáticamente una entidad de seguridad de Azure Active Directory para el recurso.

userAssignedIdentities

Identificadores de recurso de las identidades asignadas por el usuario que se van a usar

Server

Un servidor Azure SQL Database.

Name Type Description
id
  • string

Identificador del recurso.

identity

Identidad Azure Active Directory del servidor.

kind
  • string

Tipo de sql Server. Estos son los metadatos que se usan para la experiencia de Azure Portal.

location
  • string

Ubicación del recurso

name
  • string

Nombre del recurso.

properties.administratorLogin
  • string

Nombre de usuario del administrador para el servidor. Una vez creado, no se puede cambiar.

properties.administratorLoginPassword
  • string

Contraseña de inicio de sesión del administrador (necesaria para la creación del servidor).

properties.administrators

Identidad Azure Active Directory del servidor.

properties.federatedClientId
  • string

Identificador de cliente usado para el escenario de CMK entre inquilinos

properties.fullyQualifiedDomainName
  • string

Nombre de dominio completo del servidor.

properties.keyId
  • string

URI de CMK de la clave que se va a usar para el cifrado.

properties.minimalTlsVersion
  • string

Versión mínima de TLS. Valores permitidos: '1.0', '1.1', '1.2'

properties.primaryUserAssignedIdentityId
  • string

Identificador de recurso de una identidad asignada por el usuario que se usará de forma predeterminada.

properties.privateEndpointConnections

Lista de conexiones de punto de conexión privado en un servidor

properties.publicNetworkAccess

Si se permite o no el acceso al punto de conexión público para este servidor. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado".

properties.restrictOutboundNetworkAccess

Si se va a restringir o no el acceso de red saliente a este servidor. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado".

properties.state
  • string

Estado del servidor.

properties.version
  • string

Versión del servidor.

properties.workspaceFeature

Si el servidor existente tiene o no un área de trabajo creada y si permite la conexión desde el área de trabajo

tags
  • object

Etiquetas del recurso.

type
  • string

Tipo de recurso.

ServerExternalAdministrator

Propiedades de un administrador de Active Directory.

Name Type Description
administratorType

Tipo del administrador del servidor.

azureADOnlyAuthentication
  • boolean

Azure Active Directory solo la autenticación habilitada.

login
  • string

Nombre de inicio de sesión del administrador del servidor.

principalType

Tipo de entidad de seguridad del administrador del servidor.

sid
  • string

SID (id. de objeto) del administrador del servidor.

tenantId
  • string

Id. de inquilino del administrador.

ServerListResult

Una lista de servidores.

Name Type Description
nextLink
  • string

Vínculo para recuperar la página siguiente de resultados.

value

Matriz de resultados.

ServerNetworkAccessFlag

Si se permite o no el acceso al punto de conexión público para este servidor. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado".

Name Type Description
Disabled
  • string
Enabled
  • string

ServerPrivateEndpointConnection

Una conexión de punto de conexión privado en un servidor

Name Type Description
id
  • string

Identificador del recurso.

properties

Propiedades de conexión de punto de conexión privado

ServerWorkspaceFeature

Si el servidor existente tiene o no un área de trabajo creada y si permite la conexión desde el área de trabajo

Name Type Description
Connected
  • string
Disconnected
  • string

UserIdentity

Azure Active Directory configuración de identidad de un recurso.

Name Type Description
clientId
  • string

Identificador de cliente Azure Active Directory.

principalId
  • string

Identificador de Azure Active Directory entidad de seguridad.