Dela via

Servers - Get

  • Referens
Tjänst:
Cosmos DB for PostgreSQL
API-version:
2023-03-02-preview

Hämtar information om en server i klustret.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/serverGroupsv2/{clusterName}/servers/{serverName}?api-version=2023-03-02-preview

URI-parametrar

Name I Obligatorisk Typ Description
clusterName
 path True

string

Namnet på klustret.

Reguljärt uttrycksmönster: ^(?![0-9]+$)(?!-)[a-z0-9-]{3,40}(?<!-)$
resourceGroupName
 path True

string

Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
serverName
 path True

string

Namnet på servern.

Reguljärt uttrycksmönster: ^[-\w\._]+$
subscriptionId
 path True

string

uuid

ID för målprenumerationen. Värdet måste vara ett UUID.
api-version
 query True

string

Den API-version som ska användas för den här åtgärden.

Svar

Name Typ Description
200 OK

ClusterServer

OK
Other Status Codes

ErrorResponse

Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation Personifiera ditt användarkonto.

Exempel

Get the server of cluster

Exempelbegäran

GET https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup/providers/Microsoft.DBforPostgreSQL/serverGroupsv2/testcluster1/servers/testcluster1-c?api-version=2023-03-02-preview

Exempelsvar

Statuskod:
200 
{
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup/providers/Microsoft.DBforPostgreSQL/serverGroupsv2/testcluster1/servers/testcluster1-c",
  "name": "testcluster1-c",
  "type": "Microsoft.DBforPostgreSQL/serverGroupsv2/servers",
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  },
  "properties": {
    "fullyQualifiedDomainName": "testcluster1-c.postgres.database.azure.com",
    "postgresqlVersion": "12",
    "citusVersion": "9.5",
    "availabilityZone": "1",
    "role": "Coordinator",
    "serverEdition": "MemoryOptimized",
    "storageQuotaInMb": 10000,
    "vCores": 4,
    "enableHa": true,
    "enablePublicIpAccess": true,
    "state": "Ready",
    "haState": "Healthy",
    "administratorLogin": "citus",
    "isReadOnly": false
  }
}

Definitioner

Name Description
ClusterServer

Representerar en server i ett kluster.
createdByType

Den typ av identitet som skapade resursen.
ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.
ErrorDetail

Felinformationen.
ErrorResponse

Felsvar
ServerRole

Rollen för en server.
systemData

Metadata som rör skapande och senaste ändring av resursen.

ClusterServer

Representerar en server i ett kluster.

Name Typ Description
id

string

Fullständigt kvalificerat resurs-ID för resursen. Till exempel "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name

string

Namnet på resursen
properties.administratorLogin

string

Administratörens inloggningsnamn för servrarna i klustret.
properties.availabilityZone

string

Tillgänglighetszoninformation för servern.
properties.citusVersion

string

Citus-tilläggsversionen av servern.
properties.enableHa

boolean

Om hög tillgänglighet (HA) är aktiverat eller inte för servern.
properties.enablePublicIpAccess

boolean

Om offentlig åtkomst är aktiverad på servern.
properties.fullyQualifiedDomainName

string

Det fullständigt kvalificerade domännamnet för en server.
properties.haState

string

Ett tillstånd för HA-funktionen för klustret.
properties.isReadOnly

boolean

Om serverdatabasen är inställd på skrivskyddad av systemunderhåll beroende på hög diskutrymmesanvändning.
properties.postgresqlVersion

string

Den större PostgreSQL-versionen av servern.
properties.role

ServerRole

Serverns roll i klustret.
properties.serverEdition

string

Utgåvan av en server.
properties.state

string

Ett tillstånd för ett kluster/en server som är synligt för användaren.
properties.storageQuotaInMb

integer

Lagring av en server i MB.
properties.vCores

integer

Antalet virtuella kärnor för en server.
systemData

systemData

Azure Resource Manager metadata som innehåller createdBy och modifiedBy information.
type

string

Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

createdByType

Den typ av identitet som skapade resursen.

Name Typ Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name Typ Description
info

object

Ytterligare information.
type

string

Den ytterligare informationstypen.

ErrorDetail

Felinformationen.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Ytterligare information om felet.
code

string

Felkoden.
details

ErrorDetail[]

Felinformationen.
message

string

Felmeddelandet.
target

string

Felmålet.

ErrorResponse

Felsvar

Name Typ Description
error

ErrorDetail

Felobjektet.

ServerRole

Rollen för en server.

Name Typ Description
Coordinator

string

Worker

string

systemData

Metadata som rör skapande och senaste ändring av resursen.

Name Typ Description
createdAt

string

Tidsstämpeln för resursskapande (UTC).
createdBy

string

Identiteten som skapade resursen.
createdByType

createdByType

Den typ av identitet som skapade resursen.
lastModifiedAt

string

Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy

string

Identiteten som senast ändrade resursen.
lastModifiedByType

createdByType

Den typ av identitet som senast ändrade resursen.