Long Term Retention Managed Instance Backups - List By Resource Group Instance

Referens

Tjänst:: SQL Database

API-version:: 2021-11-01

Listor de långsiktiga kvarhållningssäkerhetskopiorna för en viss hanterad instans.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionManagedInstances/{managedInstanceName}/longTermRetentionManagedInstanceBackups?api-version=2021-11-01

Med valfria parametrar:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionManagedInstances/{managedInstanceName}/longTermRetentionManagedInstanceBackups?onlyLatestPerDatabase={onlyLatestPerDatabase}&databaseState={databaseState}&api-version=2021-11-01

URI-parametrar

Name	I	Obligatorisk	Typ	Description
locationName	path	True	string	Platsen för databasen.
managedInstanceName	path	True	string	Namnet på den hanterade instansen.
resourceGroupName	path	True	string	Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.
subscriptionId	path	True	string	Prenumerations-ID:t som identifierar en Azure-prenumeration.
api-version	query	True	string	DEN API-version som ska användas för begäran.
databaseState	query		databaseState	Om du vill fråga mot enbart live-databaser, bara borttagna databaser eller alla databaser.
onlyLatestPerDatabase	query		boolean	Om du bara vill hämta den senaste säkerhetskopian för varje databas eller inte.

Svar

Name	Typ	Description
200 OK	ManagedInstanceLongTermRetentionBackupListResult	Listan över säkerhetskopior har hämtats.
Other Status Codes		Felsvar: *** 404 SubscriptionDoesNotHaveServer – den begärda servern hittades inte 404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen.

Name

Typ

Description

200 OK

ManagedInstanceLongTermRetentionBackupListResult

Listan över säkerhetskopior har hämtats.

Other Status Codes

Felsvar: ***

404 SubscriptionDoesNotHaveServer – den begärda servern hittades inte
404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen.

Exempel

Get all long term retention backups under the managed instance.

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionManagedInstanceBackups?api-version=2021-11-01


/**
 * Samples for LongTermRetentionManagedInstanceBackups ListByResourceGroupInstance.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ResourceGroupBasedManagedInstanceLongTermRetentionBackupListByInstance.json
     */
    /**
     * Sample code: Get all long term retention backups under the managed instance.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getAllLongTermRetentionBackupsUnderTheManagedInstance(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionManagedInstanceBackups()
            .listByResourceGroupInstance("testResourceGroup", "japaneast", "testInstance", null, null,
                com.azure.core.util.Context.NONE);
    }
}

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

Exempelsvar

Statuskod:: 200

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase1/longTermRetentionManagedInstanceBackups/55555555-6666-7777-8888-999999999999;131637960820000000",
      "name": "55555555-6666-7777-8888-999999999999;131637960820000000",
      "type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
      "properties": {
        "managedInstanceName": "testInstance",
        "managedInstanceCreateTime": "2017-03-10T08:00:00Z",
        "databaseName": "testDatabase1",
        "databaseDeletionTime": null,
        "backupTime": "2017-08-23T08:00:00Z",
        "backupStorageRedundancy": "Geo"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase2/longTermRetentionManagedInstanceBackups/12341234-1234-1234-1234-123123123123;131657960820000000",
      "name": "12341234-1234-1234-1234-123123123123;131657960820000000",
      "type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
      "properties": {
        "managedInstanceName": "testInstance",
        "managedInstanceCreateTime": "2017-03-10T08:00:00Z",
        "databaseName": "testDatabase2",
        "databaseDeletionTime": null,
        "backupTime": "2017-08-30T08:00:00Z",
        "backupStorageRedundancy": "Geo"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase3/longTermRetentionManagedInstanceBackups/43214321-4321-4321-4321-321321321321;131677960820000000",
      "name": "43214321-4321-4321-4321-321321321321;131667960820000000",
      "type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
      "properties": {
        "managedInstanceName": "testInstance",
        "managedInstanceCreateTime": "2017-03-10T08:00:00Z",
        "databaseName": "testDatabase3",
        "databaseDeletionTime": null,
        "backupTime": "2017-09-06T08:00:00Z",
        "backupStorageRedundancy": "Geo"
      }
    }
  ]
}

Definitioner

Name	Description
BackupStorageRedundancy	Lagringsredundanstypen för säkerhetskopian
databaseState	Om du vill fråga mot enbart live-databaser, bara borttagna databaser eller alla databaser.
ManagedInstanceLongTermRetentionBackup	En långsiktig kvarhållningssäkerhetskopia för en hanterad databas.
ManagedInstanceLongTermRetentionBackupListResult	En lista över säkerhetskopior av långsiktig kvarhållning för hanterade databaser.

BackupStorageRedundancy

Lagringsredundanstypen för säkerhetskopian

Name	Typ	Description
Geo	string
GeoZone	string
Local	string
Zone	string

databaseState

Om du vill fråga mot enbart live-databaser, bara borttagna databaser eller alla databaser.

Name	Typ	Description
All	string
Deleted	string
Live	string

ManagedInstanceLongTermRetentionBackup

En långsiktig kvarhållningssäkerhetskopia för en hanterad databas.

Name	Typ	Description
id	string	Resurs-ID.
name	string	Resursnamn.
properties.backupExpirationTime	string	Den tid som den långsiktiga kvarhållningssäkerhetskopian upphör att gälla.
properties.backupStorageRedundancy	BackupStorageRedundancy	Lagringsredundanstypen för säkerhetskopian
properties.backupTime	string	Den tid då säkerhetskopieringen togs
properties.databaseDeletionTime	string	Borttagningstiden för databasen
properties.databaseName	string	Namnet på databasen som säkerhetskopian tillhör
properties.managedInstanceCreateTime	string	Instansens skapandetid.
properties.managedInstanceName	string	Den hanterade instans som säkerhetskopieringsdatabasen tillhör.
type	string	Resurstyp.

ManagedInstanceLongTermRetentionBackupListResult

En lista över säkerhetskopior av långsiktig kvarhållning för hanterade databaser.

Name	Typ	Description
nextLink	string	Länka för att hämta nästa sida med resultat.
value	ManagedInstanceLongTermRetentionBackup[]	Matris med resultat.

Dela via

Long Term Retention Managed Instance Backups - List By Resource Group Instance

URI-parametrar

Svar

Exempel

Get all long term retention backups under the managed instance.

Exempelbegäran

Exempelsvar

Definitioner

BackupStorageRedundancy

databaseState

ManagedInstanceLongTermRetentionBackup

ManagedInstanceLongTermRetentionBackupListResult

Ytterligare resurser