Start Stop Managed Instance Schedules - Get

Tjänst:: SQL Database

API-version:: 2023-08-01

Hämtar den hanterade instansens start-/stoppschema.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
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.
startStopScheduleName	path	True	StartStopScheduleName	Namnet på start-/stoppschemat för den hanterade instansen.
subscriptionId	path	True	string	Det prenumerations-ID som identifierar en Azure-prenumeration.
api-version	query	True	string	DEN API-version som ska användas för begäran.

Svar

Name	Typ	Description
200 OK	StartStopManagedInstanceSchedule	Start-/stoppschemat har hämtats.
Other Status Codes	ErrorResponse	Felsvar: *** 204 ManagementServiceStartStopManagedInstanceScheduleNameInvalid – Användaren försökte utföra CRUD-driften av start-/stoppschemat med ett annat schemanamn än "standard" 400 ManagementServiceStartStopManagedInstanceScheduleSmallTimespan – Tiden mellan två efterföljande åtgärder är mindre än 1 timme. 400 ManagementServiceStartStopManagedInstanceScheduleSubscriptionNotEnabledForFeature – Användaren försökte använda start-/stoppfunktionen utan att ha prenumerationen tillåten för lämplig prenumerationsfunktion. 400 ManagementServiceStartStopManagedInstanceScheduleNotSupportedOnSKU – schemalagd start-/stoppåtgärd stöds inte på den angivna SKU:n. 400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform – Stoppa körs på den instans som inte körs med Feature Wave november 2022 400 StartStopOfManagedInstanceIsDisabled – Start- och stoppåtgärden på den hanterade instansen är inte aktiverad. 400 ManagementServiceStartStopManagedInstanceScheduleFeatureDisabled – Användaren försökte använda den schemalagda funktionen Start/Stop Azure SQL Managed Instance, som är inaktiverad. 400 ManagementServiceStartStopManagedInstanceScheduleOverlap – Överlappning i schemapar. 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestParametersInvalid – Den angivna uppsättningen parametrar i brödtexten i begäran är antingen tom eller ogiltig. 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestTimeZoneInvalid – den angivna tidszonsparametern är ogiltig. 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestScheduleInvalid – det angivna start-/stoppschemat är ogiltigt. Schemat innehåller antingen inga objekt i schemalistan eller så har vissa av objekten i listan ogiltiga värden. 404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen. 404 SubscriptionDoesNotHaveServer – Den begärda servern hittades inte 404 ResourceNotFound – Den begärda resursen hittades inte. 404 ManagementServiceStartStopManagedInstanceScheduleNotFound – Schemat finns inte för en viss hanterad instans. 404 ManagementServiceStartStopManagedInstanceScheduleNameInvalid – Användaren försökte utföra CRUD-driften av start-/stoppschemat med ett annat schemanamn än "standard" 409 ManagementServiceStartStopManagedInstanceScheduleConflictingOperation – Det gick inte att skapa/uppdatera/ta bort start-/stoppschemat i Azure SQL Managed Instance. Schemat skapades inte eller kunde inte uppdateras/tas bort eftersom det var upptaget med en pågående schemalagd åtgärd. Försök igen senare.

Name

Typ

Description

200 OK

StartStopManagedInstanceSchedule

Start-/stoppschemat har hämtats.

Other Status Codes

ErrorResponse

Felsvar: ***

204 ManagementServiceStartStopManagedInstanceScheduleNameInvalid – Användaren försökte utföra CRUD-driften av start-/stoppschemat med ett annat schemanamn än "standard"
400 ManagementServiceStartStopManagedInstanceScheduleSmallTimespan – Tiden mellan två efterföljande åtgärder är mindre än 1 timme.
400 ManagementServiceStartStopManagedInstanceScheduleSubscriptionNotEnabledForFeature – Användaren försökte använda start-/stoppfunktionen utan att ha prenumerationen tillåten för lämplig prenumerationsfunktion.
400 ManagementServiceStartStopManagedInstanceScheduleNotSupportedOnSKU – schemalagd start-/stoppåtgärd stöds inte på den angivna SKU:n.
400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform – Stoppa körs på den instans som inte körs med Feature Wave november 2022
400 StartStopOfManagedInstanceIsDisabled – Start- och stoppåtgärden på den hanterade instansen är inte aktiverad.
400 ManagementServiceStartStopManagedInstanceScheduleFeatureDisabled – Användaren försökte använda den schemalagda funktionen Start/Stop Azure SQL Managed Instance, som är inaktiverad.
400 ManagementServiceStartStopManagedInstanceScheduleOverlap – Överlappning i schemapar.
400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestParametersInvalid – Den angivna uppsättningen parametrar i brödtexten i begäran är antingen tom eller ogiltig.
400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestTimeZoneInvalid – den angivna tidszonsparametern är ogiltig.
400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestScheduleInvalid – det angivna start-/stoppschemat är ogiltigt. Schemat innehåller antingen inga objekt i schemalistan eller så har vissa av objekten i listan ogiltiga värden.
404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen.
404 SubscriptionDoesNotHaveServer – Den begärda servern hittades inte
404 ResourceNotFound – Den begärda resursen hittades inte.
404 ManagementServiceStartStopManagedInstanceScheduleNotFound – Schemat finns inte för en viss hanterad instans.
404 ManagementServiceStartStopManagedInstanceScheduleNameInvalid – Användaren försökte utföra CRUD-driften av start-/stoppschemat med ett annat schemanamn än "standard"
409 ManagementServiceStartStopManagedInstanceScheduleConflictingOperation – Det gick inte att skapa/uppdatera/ta bort start-/stoppschemat i Azure SQL Managed Instance. Schemat skapades inte eller kunde inte uppdateras/tas bort eftersom det var upptaget med en pågående schemalagd åtgärd. Försök igen senare.

Exempel

Gets the managed instance's Start/Stop schedule.

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

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/StartStopManagedInstanceScheduleGet.json
// this example is just showing the usage of "StartStopManagedInstanceSchedules_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://free.blessedness.top/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 ManagedInstanceResource created on azure
// for more information of creating ManagedInstanceResource, please refer to the document of ManagedInstanceResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "schedulerg";
string managedInstanceName = "schedulemi";
ResourceIdentifier managedInstanceResourceId = ManagedInstanceResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, managedInstanceName);
ManagedInstanceResource managedInstance = client.GetManagedInstanceResource(managedInstanceResourceId);

// get the collection of this ManagedInstanceStartStopScheduleResource
ManagedInstanceStartStopScheduleCollection collection = managedInstance.GetManagedInstanceStartStopSchedules();

// invoke the operation
ManagedInstanceStartStopScheduleName startStopScheduleName = ManagedInstanceStartStopScheduleName.Default;
NullableResponse<ManagedInstanceStartStopScheduleResource> response = await collection.GetIfExistsAsync(startStopScheduleName);
ManagedInstanceStartStopScheduleResource result = response.HasValue ? response.Value : null;

if (result == null)
{
    Console.WriteLine("Succeeded with null as result");
}
else
{
    // 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
    ManagedInstanceStartStopScheduleData 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

Exempelsvar

Statuskod:: 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"
}

Definitioner

Name	Description
createdByType	Den typ av identitet som skapade resursen.
DayOfWeek	Startdag.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
ScheduleItem	Schemalägg information som beskriver när servern ska startas eller stoppas.
StartStopManagedInstanceSchedule	Start-/stoppschema för den hanterade instansen.
StartStopScheduleName	Namnet på start-/stoppschemat för den hanterade instansen.
systemData	Metadata som rör skapande och senaste ändring av resursen.

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Description
User
Application
ManagedIdentity
Key

DayOfWeek

Uppräkning

Startdag.

Värde	Description
Sunday
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Objekt

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Objekt

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

ScheduleItem

Objekt

Schemalägg information som beskriver när servern ska startas eller stoppas.

Name	Typ	Description
startDay	DayOfWeek	Startdag.
startTime	string	Starttid.
stopDay	DayOfWeek	Stoppa dagen.
stopTime	string	Stopptid.