Compartir a través de

Start Stop Managed Instance Schedules - Create Or Update

  • Referencia
Servicio:
SQL Database
Versión de la API:
2023-08-01

Crea o actualiza la programación start/Stop de la instancia administrada.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
managedInstanceName
 path True

string

Nombre de la instancia administrada.
resourceGroupName
 path True

string

Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor desde la API de Azure Resource Manager o el portal.
startStopScheduleName
 path True

StartStopScheduleName

Nombre de la programación Start/Stop de la instancia administrada.
subscriptionId
 path True

string

Identificador de suscripción que identifica una suscripción de Azure.
api-version
 query True

string

Versión de la API que se va a usar para la solicitud.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
properties.scheduleList True

ScheduleItem[]

Lista de programación.
properties.description

string

Descripción de la programación.
properties.timeZoneId

string

Zona horaria de la programación.

Respuestas

Nombre Tipo Description
200 OK

StartStopManagedInstanceSchedule

Establezca correctamente la programación Start/Stop.
201 Created

StartStopManagedInstanceSchedule

Se creó correctamente la programación Start/Stop.
Other Status Codes

ErrorResponse

Respuestas de error: ***

  • 204 ManagementServiceStartStopManagedInstanceScheduleNameInvalid: el usuario intentó realizar la operación CRUD de la programación Start/Stop con un nombre de programación diferente del "predeterminado".

  • 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestParametersInvalid: el conjunto proporcionado de parámetros en el cuerpo de la solicitud está vacío o no es válido.

  • 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestTimeZoneInvalid: el parámetro de zona horaria proporcionado no es válido.

  • 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestScheduleInvalid: la programación de inicio y detención proporcionada no es válida. La programación no contiene ningún elemento de la lista de programaciones o algunos de los elementos de la lista tienen valores no válidos.

  • 400 ManagementServiceStartStopManagedInstanceScheduleSmallTimespan: el tiempo entre dos acciones sucesivas es inferior a 1 hora.

  • 400 ManagementServiceStartStopManagedInstanceScheduleSubscriptionNotEnabledForFeature: el usuario intentó usar la característica Start/Stop sin tener la suscripción permitida para la característica de suscripción adecuada.

  • 400 ManagementServiceStartStopManagedInstanceScheduleNotSupportedOnSKU: la operación start/stop programada no se admite en la SKU especificada.

  • 400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform: detenga la ejecución en la instancia que no se ejecuta con Feature Wave de noviembre de 2022

  • 400 StartStopOfManagedInstanceIsDisabled: la operación de inicio y detención en la instancia administrada no está habilitada.

  • 400 ManagementServiceStartStopManagedInstanceScheduleFeatureDisabled: el usuario intentó usar la característica Start/Stop Azure SQL Managed Instance programada, que está deshabilitada.

  • 400 ManagementServiceStartStopManagedInstanceScheduleOverlap: superposición en pares de programación.

  • 404 ManagementServiceStartStopManagedInstanceScheduleNameInvalid: el usuario intentó realizar la operación CRUD de la programación Start/Stop con un nombre de programación diferente del "predeterminado".

  • 404 ServerNotInSubscriptionResourceGroup: el servidor especificado no existe en el grupo de recursos y la suscripción especificados.

  • 404 SubscriptionDoesNotHaveServer: no se encontró el servidor solicitado.

  • 404 ResourceNotFound: no se encontró el recurso solicitado.

  • 404 ManagementServiceStartStopManagedInstanceScheduleNotFound: la programación no existe para una instancia administrada determinada.

  • 409 ManagementServiceStartStopManagedInstanceScheduleConflictingOperation: error al intentar la operación de creación, actualización y eliminación de la programación Start/Stop en la instancia administrada de Azure SQL. La programación no se creó o no se pudo actualizar o eliminar porque estaba ocupada con una operación programada en curso. Vuelva a intentar la solicitud más adelante.

Ejemplos

Creates or updates the managed instance's Start/Stop schedule with all optional parameters specified.
Creates or updates the managed instance's Start/Stop schedule with no optional parameters specified.

Creates or updates the managed instance's Start/Stop schedule with all optional parameters specified.

Solicitud de ejemplo

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

{
  "properties": {
    "timeZoneId": "Central European Standard Time",
    "description": "This is a schedule for our Dev/Test environment.",
    "scheduleList": [
      {
        "startDay": "Thursday",
        "startTime": "18:00",
        "stopDay": "Thursday",
        "stopTime": "17:00"
      },
      {
        "startDay": "Thursday",
        "startTime": "15:00",
        "stopDay": "Thursday",
        "stopTime": "14:00"
      }
    ]
  }
}

Respuesta de muestra

status code:
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"
}
status code:
201 
{
  "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-26T04: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"
}

Creates or updates the managed instance's Start/Stop schedule with no optional parameters specified.

Solicitud de ejemplo

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

{
  "properties": {
    "scheduleList": [
      {
        "startDay": "Thursday",
        "startTime": "18:00",
        "stopDay": "Thursday",
        "stopTime": "17:00"
      },
      {
        "startDay": "Thursday",
        "startTime": "15:00",
        "stopDay": "Thursday",
        "stopTime": "14:00"
      }
    ]
  }
}

Respuesta de muestra

status code:
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": "",
    "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": "UTC"
  },
  "type": "Microsoft.Sql/managedInstances/startStopSchedules"
}
status code:
201 
{
  "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-26T04:41:33.937Z"
  },
  "properties": {
    "description": "",
    "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": "UTC"
  },
  "type": "Microsoft.Sql/managedInstances/startStopSchedules"
}

Definiciones

Nombre Description
createdByType

Tipo de identidad que creó el recurso.
DayOfWeek

Día de inicio.
ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.
ErrorDetail

Detalle del error.
ErrorResponse

Respuesta de error
ScheduleItem

Información de programación que describe cuándo se debe iniciar o detener el servidor.
StartStopManagedInstanceSchedule

Programación de inicio y detención de la instancia administrada.
StartStopScheduleName

Nombre de la programación Start/Stop de la instancia administrada.
systemData

Metadatos relativos a la creación y última modificación del recurso.

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor Description
Application
Key
ManagedIdentity
User

DayOfWeek

Enumeración

Día de inicio.

Valor Description
Friday
Monday
Saturday
Sunday
Thursday
Tuesday
Wednesday

ErrorAdditionalInfo

Object

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.
type

string

Tipo de información adicional.

ErrorDetail

Object

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.
code

string

Código de error.
details

ErrorDetail[]

Detalles del error.
message

string

Mensaje de error.
target

string

Destino del error.

ErrorResponse

Object

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

ScheduleItem

Object

Información de programación que describe cuándo se debe iniciar o detener el servidor.

Nombre Tipo Description
startDay

DayOfWeek

Día de inicio.
startTime

string

Hora de comienzo.
stopDay

DayOfWeek

Deténgase el día.
stopTime

string

Tiempo de detención.

StartStopManagedInstanceSchedule

Object

Programación de inicio y detención de la instancia administrada.

Nombre Tipo Valor predeterminado Description
id

string

Identificador de recurso.
name

string

Nombre del recurso.
properties.description

string

Descripción de la programación.
properties.nextExecutionTime

string

Marca de tiempo cuando se ejecute la siguiente acción en la zona horaria de programación correspondiente.
properties.nextRunAction

string

Siguiente acción que se va a ejecutar (Iniciar o detener)
properties.scheduleList

ScheduleItem[]

Lista de programación.
properties.timeZoneId

string

UTC

Zona horaria de la programación.
systemData

systemData

Datos del sistema del recurso programado.
type

string

Tipo de recurso.

StartStopScheduleName

Enumeración

Nombre de la programación Start/Stop de la instancia administrada.

Valor Description
default

systemData

Object

Metadatos relativos a la creación y última modificación del recurso.

Nombre Tipo Description
createdAt

string (date-time)

Marca de tiempo de creación de recursos (UTC).
createdBy

string

Identidad que creó el recurso.
createdByType

createdByType

Tipo de identidad que creó el recurso.
lastModifiedAt

string (date-time)

Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy

string

Identidad que modificó por última vez el recurso.
lastModifiedByType

createdByType

Tipo de identidad que modificó por última vez el recurso.