Start Stop Managed Instance Schedules - Get

Dienst:

SQL Database

API-Version:

2024-05-01-preview

Ruft den Start-/Stopp-Zeitplan der verwalteten Instanz ab.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/startStopSchedules/default?api-version=2024-05-01-preview

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
managedInstanceName	path	True	string	Der Name der verwalteten Instanz.
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, die die Ressource enthält. Sie können diesen Wert aus der Azure Resource Manager-API oder dem Portal abrufen.
startStopScheduleName	path	True	StartStopScheduleName	Name des Start-/Stoppzeitplans der verwalteten Instanz.
subscriptionId	path	True	string	Die Abonnement-ID, die ein Azure-Abonnement identifiziert.
api-version	query	True	string	Die API-Version, die für die Anforderung verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	StartStopManagedInstanceSchedule	Der Start-/Stopp-Zeitplan wurde erfolgreich abgerufen.
Other Status Codes	ErrorResponse	Fehlerantworten: *** 204 ManagementServiceStartStopManagedInstanceScheduleNameInvalid - Benutzer hat versucht, CRUD-Vorgang des Start-/Stop-Zeitplans mit einem Zeitplannamen auszuführen, der sich von 'default' unterscheidet 400 StartStopOfManagedInstanceIsDisabled – Der Start- und Stoppvorgang für verwaltete Instanzen ist nicht aktiviert. 400 ManagementServiceStartStopManagedInstanceScheduleSubscriptionNotEnabledForFeature – Der Benutzer hat versucht, das Start-/Stopp-Feature zu verwenden, ohne dass das Abonnement für das entsprechende Abonnementfeature zugelassen ist. 400 ManagementServiceStartStopManagedInstanceScheduleFeatureDisabled – Der Benutzer hat versucht, das geplante Start-/Stop-Feature azure SQL Managed Instance zu verwenden, das deaktiviert ist. 400 ManagementServiceStartStopManagedInstanceScheduleNotSupportedOnSKU – Geplanter Start-/Stoppvorgang wird für die angegebene SKU nicht unterstützt. 400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform – Beenden der Ausführung für die Instanz, die nicht mit Feature Wave November 2022 ausgeführt wird 400 ManagementServiceStartStopManagedInstanceScheduleOverlap – Überlappen in Zeitplanpaaren. 400 ManagementServiceStartStopManagedInstanceScheduleSmallTimespan – Die Zeit zwischen zwei aufeinander folgenden Aktionen beträgt weniger als 1 Stunde. 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestParametersInvalid – Der bereitgestellte Parametersatz im Textkörper der Anforderung ist entweder leer oder ungültig. 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestTimeZoneInvalid – Der angegebene Zeitzonenparameter ist ungültig. 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestScheduleInvalid – Der bereitgestellte Start-/Stopp-Zeitplan ist ungültig. Der Zeitplan enthält entweder keine Elemente in der Zeitplanliste, oder einige elemente in der Liste weisen ungültige Werte auf. 404 SubscriptionDoesNotHaveServer – Der angeforderte Server wurde nicht gefunden. 404 ServerNotInSubscriptionResourceGroup – Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden. 404 ResourceNotFound – Die angeforderte Ressource wurde nicht gefunden. 404 ManagementServiceStartStopManagedInstanceScheduleNotFound – Schedule ist für eine bestimmte verwaltete Instanz nicht vorhanden. 404 ManagementServiceStartStopManagedInstanceScheduleNameInvalid - Benutzer hat versucht, CRUD-Vorgang des Start-/Stoppzeitplans mit einem Zeitplannamen auszuführen, der sich von 'default' unterscheidet 409 ManagementServiceStartStopManagedInstanceScheduleConflictingOperation – Der versuchte Vorgang zum Erstellen/Aktualisieren/Löschen des Start-/Stopp-Zeitplans in der verwalteten Azure SQL-Instanz ist fehlgeschlagen. Der Zeitplan wurde entweder nicht erstellt oder konnte nicht aktualisiert/gelöscht werden, da er mit einem laufenden geplanten Vorgang beschäftigt war. Versuchen Sie ihre Anfrage später erneut.

Beispiele

Gets the managed instance's Start/Stop schedule.

Beispielanforderung

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/schedulerg/providers/Microsoft.Sql/managedInstances/schedulemi/startStopSchedules/default?api-version=2024-05-01-preview

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.sql import SqlManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-sql
# USAGE
    python start_stop_managed_instance_schedule_get.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = SqlManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-1111-2222-3333-444444444444",
    )

    response = client.start_stop_managed_instance_schedules.get(
        resource_group_name="schedulerg",
        managed_instance_name="schedulemi",
        start_stop_schedule_name="default",
    )
    print(response)


# x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/preview/2024-05-01-preview/examples/StartStopManagedInstanceScheduleGet.json
if __name__ == "__main__":
    main()

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

Beispiel für eine Antwort

Statuscode:

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/schedulerg/providers/Microsoft.Sql/managedInstances/schedulemi/startStopSchedules/default",
  "name": "default",
  "systemData": {
    "createdBy": "string",
    "createdByType": "User",
    "createdAt": "2021-08-26T04:41:33.937Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-08-27T04:41:33.937Z"
  },
  "properties": {
    "description": "This is a schedule for our Dev/Test environment.",
    "nextExecutionTime": "2021-08-26T14:00:00",
    "nextRunAction": "Stop",
    "scheduleList": [
      {
        "startDay": "Thursday",
        "startTime": "06:00 PM",
        "stopDay": "Thursday",
        "stopTime": "05:00 PM"
      },
      {
        "startDay": "Thursday",
        "startTime": "03:00 PM",
        "stopDay": "Thursday",
        "stopTime": "02:00 PM"
      }
    ],
    "timeZoneId": "Central European Standard Time"
  },
  "type": "Microsoft.Sql/managedInstances/startStopSchedules"
}

Definitionen

Name	Beschreibung
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
DayOfWeek	Starttag.
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
ScheduleItem	Planen Sie Informationen, die beschreiben, wann der Server gestartet oder beendet werden soll.
StartStopManagedInstanceSchedule	Start-/Stoppzeitplan der verwalteten Instanz.
StartStopScheduleName	Name des Start-/Stoppzeitplans der verwalteten Instanz.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
Application
Key
ManagedIdentity
User

DayOfWeek

Enumeration

Starttag.

Wert	Beschreibung
Friday
Monday
Saturday
Sunday
Thursday
Tuesday
Wednesday

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

ScheduleItem

Objekt

Planen Sie Informationen, die beschreiben, wann der Server gestartet oder beendet werden soll.

Name	Typ	Beschreibung
startDay	DayOfWeek	Starttag.
startTime	string	Startzeit.
stopDay	DayOfWeek	Stopptag.
stopTime	string	Stoppzeit.

StartStopManagedInstanceSchedule

Objekt

Start-/Stoppzeitplan der verwalteten Instanz.

Name	Typ	Standardwert	Beschreibung
id	string		Ressourcen-ID.
name	string		Ressourcenname.
properties.description	string		Die Beschreibung des Zeitplans.
properties.nextExecutionTime	string		Zeitstempel, wenn die nächste Aktion in der entsprechenden Zeitplanzeitzone ausgeführt wird.
properties.nextRunAction	string		Nächste auszuführende Aktion (Start oder Beenden)
properties.scheduleList	ScheduleItem[]		Zeitplanliste.
properties.timeZoneId	string	UTC	Die Zeitzone des Zeitplans.
systemData	systemData		Systemdaten der geplanten Ressource.
type	string		Ressourcentyp.

StartStopScheduleName

Enumeration

Name des Start-/Stoppzeitplans der verwalteten Instanz.

Wert	Beschreibung
default

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.