Elastic Pools - Get

Service:

SQL Database

API-versie:

2023-08-01

Hiermee haalt u een elastische pool op.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/elasticPools/{elasticPoolName}?api-version=2023-08-01

URI-parameters

Name	In	Vereist	Type	Description
elasticPoolName	path	True	string	De naam van de elastische pool.
resourceGroupName	path	True	string	De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API of de portal.
serverName	path	True	string	De naam van de server.
subscriptionId	path	True	string	De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd.
api-version	query	True	string	De API-versie die moet worden gebruikt voor de aanvraag.

Antwoorden

Name	Type	Description
200 OK	ElasticPool	Geslaagd
Other Status Codes	ErrorResponse	Foutreacties: *** 400 ManagedInstanceStoppingOrStopped - Conflicterende bewerking verzonden terwijl het exemplaar de status gestopt/gestopt heeft 400 ManagedInstanceStarting - Conflicterende bewerking verzonden terwijl het exemplaar de beginstatus heeft 400 ElasticPoolOverStorageUsage: er wordt geprobeerd gegevens naar een database te schrijven wanneer de opslaglimiet van de elastische pool is bereikt. 400 ElasticPoolScaleNotSupportedWithInaccessibleDatabases: de elastische pool bevat niet-toegankelijke databases die toegang tot Azure Key Vault hebben verloren voor de TDE-configuratie. Verplaats de toegankelijke databases naar een andere pool voor het schalen of herstellen van de verloren Toegang tot Azure Key Vault voor de niet-toegankelijke databases. 400 CreateElasticPoolAttemptedWhenKeyRotationInProgress : de bewerking elastische pool maken kan op dit moment niet worden uitgevoerd vanwege doorlopende TDE-sleutelrotatie (Transparent Data Encryption) op de server. Probeer de bewerking later opnieuw. 400 InvalidSku: de gebruiker heeft een ongeldige SKU opgegeven. 400 InvalidTierSkuCombination : de opgegeven laag biedt geen ondersteuning voor de opgegeven sKU. 400 ServerQuotaExceeded: de server heeft de limiet bereikt voor toegestane databasedoorvoereenheid. 400 ElasticPoolAlreadyExists : de server bevat al een elastische pool met de opgegeven naam. 400 SubscriptionVcoreQuotaExceeded - Kan de bewerking niet uitvoeren omdat het abonnement het toegestane vCore-quotum zou overschrijden. 400 InvalidInputValueForEdition - Opgegeven editie wordt niet ondersteund voor het inrichten van elastische pools. 400 ElasticPoolDtuBelowLimit : de aangevraagde DTU-waarde is te laag voor de aangevraagde servicelaag voor elastische pools. 400 ElasticPoolDtuAboveLimit : de aangevraagde DTU-waarde is te hoog voor de aangevraagde servicelaag voor elastische pools. 400 InvalidMaxSize - Ongeldige maximale grootte. 400 ElasticPoolDbDtuMaxBelowLimit : het aangevraagde DTU-maximum per database is te laag voor de aangevraagde servicelaag voor elastische pools. 400 ElasticPoolDbDtuMaxAboveLimit : het aangevraagde DTU-maximum per database is te hoog voor de aangevraagde servicelaag voor elastische pools. 400 InvalidInputValueForDatabaseDtuMax - Poging om de DTU max per database in te stellen voor de resourcegroep die niet overeenkomt met de toegestane waarden. 400 ElasticPoolDbDtuMinAboveLimit : de aangevraagde DTU min per database is te hoog voor de aangevraagde servicelaag. 400 ElasticPoolOverStorage: een poging om gegevens naar een database te schrijven wanneer de opslaglimiet van de elastische pool is bereikt. 400 InvalidInputValueForDatabaseDtuMin: probeert de DTU min per database in te stellen voor de resourcegroep die niet overeenkomt met de toegestane waarden. 400 ElasticPoolInconsistentDtuGuaranteeSettings : poging om DTU min te bieden voor databases in de elastische pool die de aangevraagde DTU's van de elastische pool overschrijdt. 400 ElasticPoolDtuUnsupported : gebruiker heeft geprobeerd een elastische pool te maken of bij te werken met een DTU-capaciteit die niet wordt ondersteund. 400 ElasticPoolStorageAboveLimitGB - Probeert de opslaglimiet voor elastische pools onder de ondersteunde limiet in te stellen. 400 ElasticPoolsNotEnabled - Elastische pools zijn niet ingeschakeld in deze regio. 400 ElasticPoolNotEmpty - Aanvraag om een elastische pool te verwijderen die niet leeg is. 400 ElasticPoolStorageBelowLimitGB - Poging om de opslaglimiet voor elastische pools onder de ondersteunde limiet in te stellen. 400 ElasticPoolStorageNotAllowedGB - Probeert de opslaglimiet voor elastische pools in gb in te stellen die niet overeenkomt met de toegestane waarden. 400 ElasticPoolDatabaseLimit - De elastische pool heeft de limiet bereikt voor het aantal databases. 400 ElasticPoolDecreaseStorageLimitBelowUsage- Poging om de opslaglimiet van de elastische pool onder het opslaggebruik te verlagen. 400 InvalidInputValueDatabaseDtuMinLargerThanMax - Poging om de DTU min per database hoger in te stellen dan de DTU max per database. 400 ElasticPoolInconsistentVcoreGuaranteeSettings: het aantal databases en VCore min per database kan niet groter zijn dan aangevraagde VCores van de elastische pool. 400 ElasticPoolStorageBelowLimitMB - Probeert de opslaglimiet voor elastische pools onder de ondersteunde limiet in te stellen. 400 ElasticPoolStorageNotAllowedMB - Probeert de opslaglimiet voor elastische pools in mb in te stellen die niet overeenkomt met de toegestane waarden. 400 ElasticPoolCapacityStorageNotAllowedMB - Poging om de opslaglimiet voor elastische pools in mb in te stellen die niet overeenkomt met de toegestane waarden. 400 InvalidReadScaleUnits - Gebruiker heeft geprobeerd een waarde voor leesschaal op te geven die niet wordt ondersteund. 400 ElasticPoolStorageAboveLimitMB - Probeert de opslaglimiet voor elastische pools onder de ondersteunde limiet in te stellen. 400 RegionDoesNotSupportVersion - Een gebruiker heeft geprobeerd een server van een opgegeven versie te maken op een locatie waar die serverversie niet wordt ondersteund. 400 InvalidTier : de gebruiker heeft een ongeldige laag opgegeven. 400 SourceDatabaseEditionCouldNotBeUpgraded: de brondatabase kan geen hogere editie hebben dan de doeldatabase. 400 TargetDatabaseEditionCouldNotBeDowngraded : de doeldatabase mag geen lagere editie hebben dan de brondatabase. 400 ElasticPoolUpdateHkNotAllowed: de elastische pool kan de servicelaag niet verlagen van Premium naar Standard of Basic, omdat een of meer van de databases geoptimaliseerde objecten gebruiken. 400 UpdateNotAllowedIfGeoDrOperationInProgress - De bewerking is niet toegestaan omdat de kopieer- of failoverbewerking voor de database '{0}' op de server '{1}' momenteel wordt uitgevoerd. 400 RegionDoesNotAllowProvisioning : de geselecteerde locatie accepteert geen nieuwe Windows Azure SQL Database-servers. Dit kan later worden gewijzigd. 400 HSElasticPoolUpdateSloPRMSNotSupported - De servicedoelstellingtoewijzing voor de database is mislukt. Neem contact op met de klantondersteuning van Microsoft en geef de servernaam, databasenaam en activiteits-id op. 400 ElasticPoolOverFileSpace - Onvoldoende bestandsruimte in de elastische pool. 400 ElasticPoolDbDtuMinBelowLimit : de aangevraagde DTU-min per database is te laag voor de aangevraagde servicelaag voor elastische pools. 400 ElasticPoolDbVcoreMaxBelowLimit - De aangevraagde VCore max per database is te laag voor de aangevraagde servicelaag voor elastische pools. 400 ElasticPoolDbVcoreMaxAboveLimit : het aangevraagde VCore-maximum per database is te hoog voor de aangevraagde servicelaag voor elastische pools. 400 InvalidInputValueForDatabaseVcoreMax- Poging om het maximum aantal VCores per database in te stellen voor de resourcegroep die niet overeenkomt met de toegestane waarden. 400 ElasticPoolDbVcoreMinBelowLimit - De aangevraagde VCore min per database is te laag voor de aangevraagde servicelaag voor elastische pools. 400 InvalidInputValueForDatabaseVcoreMin- Poging om de VCore min per database in te stellen voor de resourcegroep die niet overeenkomt met de toegestane waarden. 400 PartnerDBNotCompatibleForSGXEnclave - Poging om geoDR-koppeling in te stellen of SLO bij te werken voor een enclavedatabase wordt alleen ondersteund wanneer beide databases worden uitgevoerd op DC-seriehardware. 400 InvalidInputValueDatabaseVcoreMinLargerThanMax - Poging om de VCore min per database hoger in te stellen dan de VCore max per database. 400 InvalidLicenseType : gebruiker heeft geprobeerd een database of elastische pool te maken of bij te werken met een niet-ondersteund licentietype. 400 ProvisioningDisabled - Geeft het foutbericht weer van de resourcebewerking autor zoals dat is, zonder wijzigingen 400 CapacityGroupThresholdExceeded: aangevraagde serviceniveaudoelstelling en opslaggrootte worden toegewezen aan specifieke capaciteitsgroep en momenteel heeft resources voor deze capaciteitsgroep drempelwaarde bereikt en verdere acties moeten worden uitgevoerd voordat er meer databases in deze ringen kunnen worden geplaatst. 400 CapacityGroupThresholdCheckFail - Controle van resourcebeperking capaciteitsgroep is mislukt, dus kan niet controleren of er voldoende capaciteit bestaat om de bewerking te voltooien. 400 InvalidPublicMaintenanceConfiguration : gebruiker heeft geprobeerd om een configuratie voor openbaar onderhoud op te geven die niet kan worden geconverteerd naar een interne id (onjuiste of verkeerde regio). 404 ServerNotInSubscriptionResourceGroup - Opgegeven server bestaat niet in de opgegeven resourcegroep en het opgegeven abonnement. 404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden 404 ElasticPoolNotFound - De opgegeven elastische pool bestaat niet voor de opgegeven server. 404 OperationIdNotFound - De bewerking met id bestaat niet. 404 ResourceNotFound : de aangevraagde resource is niet gevonden. 405 NotSupported : deze functionaliteit wordt niet ondersteund. 409 ElasticPoolBusy - Er is een beheerbewerking uitgevoerd op een elastische pool die bezet is. 409 ServerDisabled - Server is uitgeschakeld. 409 SimultaneousSkuChangeNotAllowed - Bewerkingen voor wijziging van servicedoelstelling kunnen niet tegelijkertijd worden uitgevoerd op beide databases van een replicatierelatie. 409 ElasticPoolUpdateLinksNotInCatchup - Kan elastische pool niet bijwerken terwijl een van de databases een kopieer- of geo-replicatiefailoverbewerking uitvoert. 409 CannotCancelOperation - De beheerbewerking heeft een status die niet kan worden geannuleerd. 409 OperationCancelled - De bewerking is geannuleerd door de gebruiker. 409 Bewerking onderbroken: de bewerking op de resource kan niet worden voltooid omdat deze is onderbroken door een andere bewerking op dezelfde resource. 429 SubscriptionTooManyCreateUpdateRequests - Aanvragen buiten het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources. 429 SubscriptionTooManyRequests : aanvragen buiten het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources. 500 ElasticPoolFailedMoveDbToElasticPool - Kan de database niet verplaatsen naar een elastische pool vanwege interne resourcebeperkingen. Dit kan een tijdelijke situatie zijn. Probeer het opnieuw. 500 OperationTimedOut: er is een time-out opgetreden voor de bewerking en wordt automatisch teruggedraaid. Voer de bewerking opnieuw uit. 503 ServiceTemporarilyUnavailable - Functie tijdelijk niet beschikbaar. 503 TooManyRequests : aanvragen die buiten het maximum aantal aanvragen kunnen worden verwerkt door beschikbare resources.

Voorbeelden

Get a Hyperscale elastic pool

Get an elastic pool

Get an elastic pool with Availability Zone

Get an elastic pool with preferred enclave type parameter

Get an elastic pool with serverless properties

Get a Hyperscale elastic pool

Voorbeeldaanvraag

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102?api-version=2023-08-01

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/HyperscaleElasticPoolGet.json
// this example is just showing the usage of "ElasticPools_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ElasticPoolResource created on azure
// for more information of creating ElasticPoolResource, please refer to the document of ElasticPoolResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "sqlcrudtest-2369";
string serverName = "sqlcrudtest-8069";
string elasticPoolName = "sqlcrudtest-8102";
ResourceIdentifier elasticPoolResourceId = ElasticPoolResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName, elasticPoolName);
ElasticPoolResource elasticPool = client.GetElasticPoolResource(elasticPoolResourceId);

// invoke the operation
ElasticPoolResource result = await elasticPool.GetAsync();

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ElasticPoolData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Voorbeeldrespons

Statuscode:

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
  "name": "sqlcrudtest-8102",
  "type": "Microsoft.Sql/servers/elasticPools",
  "location": "Japan East",
  "kind": "vcore,pool",
  "sku": {
    "name": "HS_Gen5",
    "tier": "Hyperscale",
    "family": "Gen5",
    "capacity": 4
  },
  "properties": {
    "state": "Ready",
    "creationDate": "2021-08-26T03:46:20.57Z",
    "maxSizeBytes": 0,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 4
    },
    "zoneRedundant": false,
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default",
    "highAvailabilityReplicaCount": 2
  }
}

Get an elastic pool

Voorbeeldaanvraag

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102?api-version=2023-08-01

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/ElasticPoolGet.json
// this example is just showing the usage of "ElasticPools_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ElasticPoolResource created on azure
// for more information of creating ElasticPoolResource, please refer to the document of ElasticPoolResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "sqlcrudtest-2369";
string serverName = "sqlcrudtest-8069";
string elasticPoolName = "sqlcrudtest-8102";
ResourceIdentifier elasticPoolResourceId = ElasticPoolResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName, elasticPoolName);
ElasticPoolResource elasticPool = client.GetElasticPoolResource(elasticPoolResourceId);

// invoke the operation
ElasticPoolResource result = await elasticPool.GetAsync();

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ElasticPoolData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Voorbeeldrespons

Statuscode:

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
  "name": "sqlcrudtest-8102",
  "type": "Microsoft.Sql/servers/elasticPools",
  "location": "Japan East",
  "kind": null,
  "sku": {
    "name": "GP_Gen5_2",
    "tier": "GeneralPurpose",
    "capacity": 2
  },
  "properties": {
    "creationDate": "2017-10-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "minCapacity": 0.25,
      "maxCapacity": 1
    },
    "zoneRedundant": true,
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
  }
}

Get an elastic pool with Availability Zone

Voorbeeldaanvraag

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102?api-version=2023-08-01

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/GetElasticPoolWithAvailabilityZone.json
// this example is just showing the usage of "ElasticPools_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ElasticPoolResource created on azure
// for more information of creating ElasticPoolResource, please refer to the document of ElasticPoolResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "sqlcrudtest-2369";
string serverName = "sqlcrudtest-8069";
string elasticPoolName = "sqlcrudtest-8102";
ResourceIdentifier elasticPoolResourceId = ElasticPoolResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName, elasticPoolName);
ElasticPoolResource elasticPool = client.GetElasticPoolResource(elasticPoolResourceId);

// invoke the operation
ElasticPoolResource result = await elasticPool.GetAsync();

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ElasticPoolData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Voorbeeldrespons

Statuscode:

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
  "name": "sqlcrudtest-8102",
  "type": "Microsoft.Sql/servers/elasticPools",
  "location": "Japan East",
  "kind": null,
  "sku": {
    "name": "GP_Gen5_2",
    "tier": "GeneralPurpose",
    "capacity": 2
  },
  "properties": {
    "creationDate": "2017-10-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "minCapacity": 0.25,
      "maxCapacity": 1
    },
    "zoneRedundant": true,
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1",
    "availabilityZone": "1"
  }
}

Get an elastic pool with preferred enclave type parameter

Voorbeeldaanvraag

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102?api-version=2023-08-01

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/ElasticPoolGetWithPreferredEnclaveType.json
// this example is just showing the usage of "ElasticPools_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ElasticPoolResource created on azure
// for more information of creating ElasticPoolResource, please refer to the document of ElasticPoolResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "sqlcrudtest-2369";
string serverName = "sqlcrudtest-8069";
string elasticPoolName = "sqlcrudtest-8102";
ResourceIdentifier elasticPoolResourceId = ElasticPoolResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName, elasticPoolName);
ElasticPoolResource elasticPool = client.GetElasticPoolResource(elasticPoolResourceId);

// invoke the operation
ElasticPoolResource result = await elasticPool.GetAsync();

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ElasticPoolData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Voorbeeldrespons

Statuscode:

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
  "name": "sqlcrudtest-8102",
  "type": "Microsoft.Sql/servers/elasticPools",
  "location": "Japan East",
  "kind": "vcore,pool",
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "family": "Gen5",
    "capacity": 4
  },
  "properties": {
    "state": "Ready",
    "creationDate": "2022-08-26T03:46:20.57Z",
    "maxSizeBytes": 0,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 4
    },
    "zoneRedundant": false,
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default",
    "highAvailabilityReplicaCount": 2,
    "preferredEnclaveType": "VBS"
  }
}

Get an elastic pool with serverless properties

Voorbeeldaanvraag

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102?api-version=2023-08-01

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/GetElasticPoolWithServerlessProperties.json
// this example is just showing the usage of "ElasticPools_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ElasticPoolResource created on azure
// for more information of creating ElasticPoolResource, please refer to the document of ElasticPoolResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "sqlcrudtest-2369";
string serverName = "sqlcrudtest-8069";
string elasticPoolName = "sqlcrudtest-8102";
ResourceIdentifier elasticPoolResourceId = ElasticPoolResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName, elasticPoolName);
ElasticPoolResource elasticPool = client.GetElasticPoolResource(elasticPoolResourceId);

// invoke the operation
ElasticPoolResource result = await elasticPool.GetAsync();

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ElasticPoolData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Voorbeeldrespons

Statuscode:

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
  "name": "sqlcrudtest-8102",
  "type": "Microsoft.Sql/servers/elasticPools",
  "location": "Japan East",
  "kind": null,
  "sku": {
    "name": "GP_S_Gen5_2",
    "tier": "GeneralPurpose",
    "capacity": 2
  },
  "properties": {
    "creationDate": "2017-10-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "minCapacity": 0.5,
    "autoPauseDelay": 60,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 1,
      "autoPauseDelay": 60
    },
    "zoneRedundant": true,
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
  }
}

Definities

Name	Description
AlwaysEncryptedEnclaveType	Het type enclave dat is aangevraagd voor de elastische pool.
AvailabilityZoneType	Hiermee geeft u de beschikbaarheidszone op waaraan de primaire replica van de pool is vastgemaakt.
ElasticPool	Een elastische pool.
ElasticPoolLicenseType	Het licentietype dat moet worden toegepast op deze elastische pool.
ElasticPoolPerDatabaseSettings	Per database-instellingen van een elastische pool.
ElasticPoolState	De status van de elastische pool.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
Sku	Een ARM-resource-SKU.

AlwaysEncryptedEnclaveType

Inventarisatie

Het type enclave dat is aangevraagd voor de elastische pool.

Waarde	Description
Default
VBS

AvailabilityZoneType

Inventarisatie

Hiermee geeft u de beschikbaarheidszone op waaraan de primaire replica van de pool is vastgemaakt.

Waarde	Description
NoPreference
1
2
3

ElasticPool

Object

Een elastische pool.

Name	Type	Description
id	string	Resource-id.
kind	string	Soort elastische pool. Dit zijn metagegevens die worden gebruikt voor de Azure Portal-ervaring.
location	string	Resourcelocatie.
name	string	Resourcenaam.
properties.autoPauseDelay	integer (int32)	Tijd in minuten waarna elastische pool automatisch wordt onderbroken. Een waarde van -1 betekent dat automatische pauze is uitgeschakeld
properties.availabilityZone	AvailabilityZoneType	Hiermee geeft u de beschikbaarheidszone op waaraan de primaire replica van de pool is vastgemaakt.
properties.creationDate	string (date-time)	De aanmaakdatum van de elastische pool (ISO8601-indeling).
properties.highAvailabilityReplicaCount	integer (int32)	Het aantal secundaire replica's dat is gekoppeld aan de elastische pool Bedrijfskritiek, Premium of Hyperscale-editie die wordt gebruikt om hoge beschikbaarheid te bieden. Alleen van toepassing op elastische Hyperscale-pools.
properties.licenseType	ElasticPoolLicenseType	Het licentietype dat moet worden toegepast op deze elastische pool.
properties.maintenanceConfigurationId	string	Onderhoudsconfiguratie-id die is toegewezen aan de elastische pool. Met deze configuratie wordt de periode gedefinieerd waarop de onderhoudsupdates plaatsvinden.
properties.maxSizeBytes	integer (int64)	De opslaglimiet voor de elastische pool van de database in bytes.
properties.minCapacity	number (double)	Minimale capaciteit die de serverloze pool hieronder niet verkleint, indien niet onderbroken
properties.perDatabaseSettings	ElasticPoolPerDatabaseSettings	De instellingen per database voor de elastische pool.
properties.preferredEnclaveType	AlwaysEncryptedEnclaveType	Het type enclave dat is aangevraagd voor de elastische pool.
properties.state	ElasticPoolState	De status van de elastische pool.
properties.zoneRedundant	boolean	Of deze elastische pool zone-redundant is, wat betekent dat de replica's van deze elastische pool worden verdeeld over meerdere beschikbaarheidszones.
sku	Sku	De SKU voor elastische pools. De lijst met SKU's kan variëren per regio en ondersteuningsaanbieding. Gebruik de Capabilities_ListByLocation REST API of de volgende opdracht om de SKU-naam, laag/editie, familie en capaciteit te bepalen die beschikbaar zijn voor uw abonnement in een Azure-regio: az sql elastic-pool list-editions -l <location> -o table
tags	object	Resourcetags.
type	string	Resourcetype.

ElasticPoolLicenseType

Inventarisatie

Het licentietype dat moet worden toegepast op deze elastische pool.

Waarde	Description
LicenseIncluded
BasePrice

ElasticPoolPerDatabaseSettings

Object

Per database-instellingen van een elastische pool.

Name	Type	Description
autoPauseDelay	integer (int32)	Vertraging automatisch onderbreken voor per database binnen de pool
maxCapacity	number (double)	De maximale capaciteit die elke database kan verbruiken.
minCapacity	number (double)	De minimale capaciteit voor alle databases is gegarandeerd.

ElasticPoolState

Inventarisatie

De status van de elastische pool.

Waarde	Description
Creating
Ready
Disabled

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Object

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

Sku

Object

Een ARM-resource-SKU.

Name	Type	Description
capacity	integer (int32)	Capaciteit van de specifieke SKU.
family	string	Als de service verschillende generaties hardware heeft, voor dezelfde SKU, kan die hier worden vastgelegd.
name	string	De naam van de SKU, meestal een letter + cijfercode, bijvoorbeeld P3.
size	string	Grootte van de specifieke SKU
tier	string	De laag of editie van de specifieke SKU, bijvoorbeeld Basic, Premium.