Servers - List

Obtiene una lista de todos los servidores de la suscripción.

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

Parámetros de identificador URI

Name In Required Type Description
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

Recursos secundarios que se incluirán en la respuesta.

Respuestas

Name Type Description
200 OK

Recuperó correctamente la lista de servidores.

Other Status Codes

Respuestas de error: :

Ejemplos

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

Definiciones

AdministratorType

Tipo del administrador de servidor.

IdentityType

Tipo de identidad. Establezca esta opción en "SystemAssigned" para crear y asignar automáticamente una Azure Active Directory principal 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

Acciones necesarias para la conexión del servicio Private Link.

PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus

Estado de conexión del servicio private link.

ResourceIdentity

Azure Active Directory de identidad para un recurso.

Server

Un servidor Azure SQL Database servidor.

ServerExternalAdministrator

Propiedades de un administrador de Active Directory.

ServerListResult

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 de identidad para un recurso.

AdministratorType

Tipo del administrador de servidor.

Name Type Description
ActiveDirectory
  • string

IdentityType

Tipo de identidad. Establezca esta opción en "SystemAssigned" para crear y asignar automáticamente una Azure Active Directory principal 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

Id. 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

Acciones necesarias para la conexión del servicio Private Link.

Name Type Description
None
  • string

PrivateLinkServiceConnectionStateProperty

Name Type Description
actionsRequired

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 de identidad para un recurso.

Name Type Description
principalId
  • string

Identificador Azure Active Directory principal.

tenantId
  • string

El Azure Active Directory de inquilino.

type

Tipo de identidad. Establezca esta opción en "SystemAssigned" para crear y asignar automáticamente una Azure Active Directory principal para el recurso.

userAssignedIdentities

Los identificadores de recursos de las identidades asignadas por el usuario que se usarán

Server

Un servidor Azure SQL Database servidor.

Name Type Description
id
  • string

Identificador del recurso.

identity

La Azure Active Directory identidad del servidor.

kind
  • string

Tipo de sql server. Se trata de metadatos usados para la Azure Portal usuario.

location
  • string

Ubicación del recurso

name
  • string

Nombre del recurso.

properties.administratorLogin
  • string

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

properties.administratorLoginPassword
  • string

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

properties.administrators

La Azure Active Directory identidad del servidor.

properties.federatedClientId
  • string

El 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 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 va a 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 restringe o no el acceso de red saliente para 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 de servidor.

azureADOnlyAuthentication
  • boolean

Azure Active Directory 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

Identificador de inquilino del administrador.

ServerListResult

Lista de servidores.

Name Type Description
nextLink
  • string

Vínculo para recuperar la siguiente página 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 de identidad para un recurso.

Name Type Description
clientId
  • string

Identificador Azure Active Directory cliente.

principalId
  • string

Identificador Azure Active Directory principal.