Partilhar via


Servers - List

Liste todos os servidores numa determinada subscrição.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.DBforPostgreSQL/servers?api-version=2017-12-01

Parâmetros do URI

Name Em Necessário Tipo Description
subscriptionId
path True

string

O ID da subscrição de destino.

api-version
query True

string

A versão da API a utilizar para esta operação.

Respostas

Name Tipo Description
200 OK

ServerListResult

OK

Other Status Codes

CloudError

Resposta de erro que descreve a razão pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation representar a sua conta de utilizador

Exemplos

ServerList

Sample request

GET https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/servers?api-version=2017-12-01

Sample response

{
  "value": [
    {
      "sku": {
        "name": "B_Gen4_1",
        "tier": "Basic",
        "family": "Gen4",
        "capacity": 1
      },
      "properties": {
        "administratorLogin": "testuser",
        "storageProfile": {
          "storageMB": 5120,
          "backupRetentionDays": 10,
          "geoRedundantBackup": "Disabled"
        },
        "version": "9.5",
        "sslEnforcement": "Enabled",
        "minimalTlsVersion": "TLS1_1",
        "userVisibleState": "Ready",
        "fullyQualifiedDomainName": "pgtestsvc1.postgres.database.azure.com",
        "earliestRestoreDate": "2018-03-04T21:01:55.1498475+00:00",
        "publicNetworkAccess": "Enabled",
        "privateEndpointConnections": []
      },
      "location": "westus",
      "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforPostgreSQL/servers/pgtestsvc1",
      "name": "pgtestsvc1",
      "type": "Microsoft.DBforPostgreSQL/servers"
    },
    {
      "sku": {
        "name": "GP_Gen4_2",
        "tier": "GeneralPurpose",
        "family": "Gen4",
        "capacity": 2
      },
      "properties": {
        "administratorLogin": "testuser",
        "storageProfile": {
          "storageMB": 5120,
          "backupRetentionDays": 7,
          "geoRedundantBackup": "Disabled"
        },
        "version": "9.6",
        "sslEnforcement": "Enabled",
        "minimalTlsVersion": "TLS1_2",
        "userVisibleState": "Ready",
        "fullyQualifiedDomainName": "pgtestsvc2.postgres.database.azure.com",
        "earliestRestoreDate": "2018-03-07T21:01:55.1498475+00:00",
        "publicNetworkAccess": "Enabled",
        "privateEndpointConnections": [
          {
            "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforPostgreSQL/servers/pgtestsvc2/privateEndpointConnections/private-endpoint-name-00000000-1111-2222-3333-444444444444",
            "properties": {
              "provisioningState": "Ready",
              "privateEndpoint": {
                "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/Default-Network/providers/Microsoft.Network/privateEndpoints/private-endpoint-name"
              },
              "privateLinkServiceConnectionState": {
                "status": "Approved",
                "description": "Auto-approved",
                "actionsRequired": "None"
              }
            }
          }
        ]
      },
      "location": "westus",
      "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforPostgreSQL/servers/pgtestsvc2",
      "name": "pgtestsvc2",
      "type": "Microsoft.DBforPostgreSQL/servers"
    },
    {
      "sku": {
        "name": "GP_Gen4_4",
        "tier": "GeneralPurpose",
        "family": "Gen4",
        "capacity": 4
      },
      "properties": {
        "administratorLogin": "testuser",
        "storageProfile": {
          "storageMB": 204800,
          "backupRetentionDays": 35,
          "geoRedundantBackup": "Enabled"
        },
        "version": "9.6",
        "sslEnforcement": "Enabled",
        "minimalTlsVersion": "TLS1_0",
        "userVisibleState": "Ready",
        "fullyQualifiedDomainName": "pgtestsvc3.postgres.database.azure.com",
        "earliestRestoreDate": "2018-03-01T00:11:08.55+00:00",
        "publicNetworkAccess": "Enabled",
        "privateEndpointConnections": [
          {
            "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforPostgreSQL/servers/pgtestsvc3/privateEndpointConnections/private-endpoint-name-00000000-1111-2222-3333-444444444444",
            "properties": {
              "provisioningState": "Ready",
              "privateEndpoint": {
                "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/Default-Network/providers/Microsoft.Network/privateEndpoints/private-endpoint-name"
              },
              "privateLinkServiceConnectionState": {
                "status": "Approved",
                "description": "Auto-approved",
                "actionsRequired": "None"
              }
            }
          }
        ]
      },
      "location": "westus",
      "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg1/providers/Microsoft.DBforPostgreSQL/servers/pgtestsvc3",
      "name": "pgtestsvc3",
      "type": "Microsoft.DBforPostgreSQL/servers"
    },
    {
      "sku": {
        "name": "B_Gen4_2",
        "tier": "Basic",
        "family": "Gen4",
        "capacity": 2
      },
      "properties": {
        "administratorLogin": "cloudsa",
        "storageProfile": {
          "storageMB": 128000,
          "backupRetentionDays": 7,
          "geoRedundantBackup": "Disabled"
        },
        "version": "9.6",
        "sslEnforcement": "Enabled",
        "minimalTlsVersion": "TLS1_0",
        "userVisibleState": "Ready",
        "fullyQualifiedDomainName": "pgtestsvc4.postgres.database.azure.com",
        "earliestRestoreDate": "2018-03-14T21:08:24.637+00:00",
        "publicNetworkAccess": "Enabled",
        "privateEndpointConnections": []
      },
      "location": "westus",
      "tags": {
        "ElasticServer": "1"
      },
      "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforPostgreSQL/servers/pgtestsvc4",
      "name": "pgtestsvc4",
      "type": "Microsoft.DBforPostgreSQL/servers"
    }
  ]
}

Definições

Name Description
CloudError

Uma resposta de erro do serviço Batch.

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

ErrorResponse

Resposta a Erros

GeoRedundantBackup

Ative Georredundante ou não para cópia de segurança do servidor.

IdentityType

O tipo de identidade. Defina esta opção como "SystemAssigned" para criar e atribuir automaticamente um principal do Azure Active Directory para o recurso.

InfrastructureEncryption

Adicione uma segunda camada de encriptação para os seus dados através de um novo algoritmo de encriptação que proporciona proteção de dados adicional. O valor é opcional, mas se for transmitido, tem de ser "Desativado" ou "Ativado".

MinimalTlsVersionEnum

Impor uma versão mínima de Tls para o servidor.

PrivateEndpointProperty
PrivateEndpointProvisioningState

Estado da ligação de ponto final privado.

PrivateLinkServiceConnectionStateActionsRequire

As ações necessárias para a ligação do serviço de ligação privada.

PrivateLinkServiceConnectionStateStatus

O estado da ligação do serviço de ligação privada.

PublicNetworkAccessEnum

Se o acesso à rede pública é ou não permitido para este servidor. O valor é opcional, mas se for transmitido, tem de ser "Ativado" ou "Desativado"

ResourceIdentity

Configuração de identidade do Azure Active Directory para um recurso.

Server

Representa um servidor.

ServerListResult

Uma lista de servidores.

ServerPrivateEndpointConnection

Uma ligação de ponto final privado num servidor

ServerPrivateEndpointConnectionProperties

Propriedades de uma ligação de ponto final privado.

ServerPrivateLinkServiceConnectionStateProperty
ServerState

Um estado de um servidor que é visível para o utilizador.

ServerVersion

A versão de um servidor.

Sku

Propriedades relacionadas com informações de faturação de um servidor.

SkuTier

O escalão do SKU específico, por exemplo, Básico.

SslEnforcementEnum

Ative a imposição de ssl ou não quando ligar ao servidor.

StorageAutogrow

Ativar o Aumento Automático de Armazenamento.

StorageProfile

Propriedades do Perfil de Armazenamento de um servidor

CloudError

Uma resposta de erro do serviço Batch.

Name Tipo Description
error

ErrorResponse

Resposta a Erros
Resposta de erro comum para todas as APIs Resource Manager do Azure para devolver detalhes de erro para operações falhadas. (Isto também segue o formato de resposta a erros OData.)

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

Name Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorResponse

Resposta a Erros

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorResponse[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

GeoRedundantBackup

Ative Georredundante ou não para cópia de segurança do servidor.

Name Tipo Description
Disabled

string

Enabled

string

IdentityType

O tipo de identidade. Defina esta opção como "SystemAssigned" para criar e atribuir automaticamente um principal do Azure Active Directory para o recurso.

Name Tipo Description
SystemAssigned

string

InfrastructureEncryption

Adicione uma segunda camada de encriptação para os seus dados através de um novo algoritmo de encriptação que proporciona proteção de dados adicional. O valor é opcional, mas se for transmitido, tem de ser "Desativado" ou "Ativado".

Name Tipo Description
Disabled

string

Camada adicional (2ª) de encriptação para dados inativos

Enabled

string

Valor predefinido para uma única camada de encriptação para dados inativos.

MinimalTlsVersionEnum

Impor uma versão mínima de Tls para o servidor.

Name Tipo Description
TLS1_0

string

TLS1_1

string

TLS1_2

string

TLSEnforcementDisabled

string

PrivateEndpointProperty

Name Tipo Description
id

string

ID de recurso do ponto final privado.

PrivateEndpointProvisioningState

Estado da ligação de ponto final privado.

Name Tipo Description
Approving

string

Dropping

string

Failed

string

Ready

string

Rejecting

string

PrivateLinkServiceConnectionStateActionsRequire

As ações necessárias para a ligação do serviço de ligação privada.

Name Tipo Description
None

string

PrivateLinkServiceConnectionStateStatus

O estado da ligação do serviço de ligação privada.

Name Tipo Description
Approved

string

Disconnected

string

Pending

string

Rejected

string

PublicNetworkAccessEnum

Se o acesso à rede pública é ou não permitido para este servidor. O valor é opcional, mas se for transmitido, tem de ser "Ativado" ou "Desativado"

Name Tipo Description
Disabled

string

Enabled

string

ResourceIdentity

Configuração de identidade do Azure Active Directory para um recurso.

Name Tipo Description
principalId

string

O ID principal do Azure Active Directory.

tenantId

string

O ID de inquilino do Azure Active Directory.

type

IdentityType

O tipo de identidade. Defina esta opção como "SystemAssigned" para criar e atribuir automaticamente um principal do Azure Active Directory para o recurso.

Server

Representa um servidor.

Name Tipo Description
id

string

ID de recurso completamente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

ResourceIdentity

A identidade do Azure Active Directory do servidor.

location

string

A localização geográfica onde o recurso se encontra

name

string

O nome do recurso

properties.administratorLogin

string

O nome de início de sessão do administrador de um servidor. Só pode ser especificado quando o servidor está a ser criado (e é necessário para a criação).

properties.byokEnforcement

string

Estado que mostra se a encriptação de dados do servidor está ativada com chaves geridas pelo cliente.

properties.earliestRestoreDate

string

Tempo de criação do ponto de restauro mais antigo (formato ISO8601)

properties.fullyQualifiedDomainName

string

O nome de domínio completamente qualificado de um servidor.

properties.infrastructureEncryption

InfrastructureEncryption

Estado a mostrar se o servidor ativou a encriptação da infraestrutura.

properties.masterServerId

string

O ID do servidor principal de um servidor de réplica.

properties.minimalTlsVersion

MinimalTlsVersionEnum

Impor uma versão mínima de Tls para o servidor.

properties.privateEndpointConnections

ServerPrivateEndpointConnection[]

Lista de ligações de ponto final privado num servidor

properties.publicNetworkAccess

PublicNetworkAccessEnum

Se o acesso à rede pública é ou não permitido para este servidor. O valor é opcional, mas se for transmitido, tem de ser "Ativado" ou "Desativado"

properties.replicaCapacity

integer

O número máximo de réplicas que um servidor principal pode ter.

properties.replicationRole

string

A função de replicação do servidor.

properties.sslEnforcement

SslEnforcementEnum

Ative a imposição de ssl ou não quando ligar ao servidor.

properties.storageProfile

StorageProfile

Perfil de armazenamento de um servidor.

properties.userVisibleState

ServerState

Um estado de um servidor que é visível para o utilizador.

properties.version

ServerVersion

Versão do servidor.

sku

Sku

O SKU (escalão de preço) do servidor.

tags

object

Etiquetas de recursos.

type

string

O tipo de recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

ServerListResult

Uma lista de servidores.

Name Tipo Description
value

Server[]

A lista de servidores

ServerPrivateEndpointConnection

Uma ligação de ponto final privado num servidor

Name Tipo Description
id

string

ID do Recurso da Ligação de Ponto Final Privado.

properties

ServerPrivateEndpointConnectionProperties

Propriedades de ligação de ponto final privado

ServerPrivateEndpointConnectionProperties

Propriedades de uma ligação de ponto final privado.

Name Tipo Description
privateEndpoint

PrivateEndpointProperty

Ponto final privado ao qual a ligação pertence.

privateLinkServiceConnectionState

ServerPrivateLinkServiceConnectionStateProperty

Estado de ligação da ligação de ponto final privado.

provisioningState

PrivateEndpointProvisioningState

Estado da ligação de ponto final privado.

ServerPrivateLinkServiceConnectionStateProperty

Name Tipo Description
actionsRequired

PrivateLinkServiceConnectionStateActionsRequire

As ações necessárias para a ligação do serviço de ligação privada.

description

string

A descrição da ligação do serviço de ligação privada.

status

PrivateLinkServiceConnectionStateStatus

O estado da ligação do serviço de ligação privada.

ServerState

Um estado de um servidor que é visível para o utilizador.

Name Tipo Description
Disabled

string

Dropping

string

Inaccessible

string

Ready

string

ServerVersion

A versão de um servidor.

Name Tipo Description
10

string

10.0

string

10.2

string

11

string

9.5

string

9.6

string

Sku

Propriedades relacionadas com informações de faturação de um servidor.

Name Tipo Description
capacity

integer

A capacidade de aumento/aumento horizontal, que representa as unidades de computação do servidor.

family

string

A família de hardware.

name

string

O nome do sku, normalmente, camada + família + núcleos, por exemplo, B_Gen4_1, GP_Gen5_8.

size

string

O código de tamanho, a ser interpretado pelo recurso conforme adequado.

tier

SkuTier

O escalão do SKU específico, por exemplo, Básico.

SkuTier

O escalão do SKU específico, por exemplo, Básico.

Name Tipo Description
Basic

string

GeneralPurpose

string

MemoryOptimized

string

SslEnforcementEnum

Ative a imposição de ssl ou não quando ligar ao servidor.

Name Tipo Description
Disabled

string

Enabled

string

StorageAutogrow

Ativar o Aumento Automático de Armazenamento.

Name Tipo Description
Disabled

string

Enabled

string

StorageProfile

Propriedades do Perfil de Armazenamento de um servidor

Name Tipo Description
backupRetentionDays

integer

Dias de retenção de cópias de segurança para o servidor.

geoRedundantBackup

GeoRedundantBackup

Ative Georredundante ou não para cópia de segurança do servidor.

storageAutogrow

StorageAutogrow

Ativar o Aumento Automático de Armazenamento.

storageMB

integer

Armazenamento máximo permitido para um servidor.