Start Stop Managed Instance Schedules - Create Or Update

Referência

Service:: SQL Database

API Version:: 2023-08-01-preview

Cria ou atualiza o agendamento Iniciar/Parar da instância gerenciada.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
managedInstanceName	path	True	string	O nome da instância gerenciada.
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal.
startStopScheduleName	path	True	StartStopScheduleName	Nome do agendamento Iniciar/Parar da instância gerenciada.
subscriptionId	path	True	string	A ID de assinatura que identifica uma assinatura do Azure.
api-version	query	True	string	A versão da API a ser usada para a solicitação.

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
properties.scheduleList	True	ScheduleItem[]	Lista de agendamento.
properties.description		string	A descrição da agenda.
properties.timeZoneId		string	O fuso horário da agenda.

Respostas

Nome	Tipo	Description
200 OK	StartStopManagedInstanceSchedule	Defina com êxito o agendamento Iniciar/Parar.
201 Created	StartStopManagedInstanceSchedule	Criou com êxito o agendamento Iniciar/Parar.
Other Status Codes	ErrorResponse	Respostas de erro: *** 204 ManagementServiceStartStopManagedInstanceScheduleNameInvalid - O usuário tentou executar a operação CRUD do agendamento Iniciar/Parar com um nome de agenda diferente de 'default' 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestParametersInvalid – o conjunto fornecido de parâmetros no corpo da solicitação é vazio ou inválido. 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestTimeZoneInvalid – o parâmetro de fuso horário fornecido é inválido. 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestScheduleInvalid – o agendamento de Início/Parada fornecido é inválido. A agenda não contém itens na lista de agendamento ou alguns dos itens na lista têm valores inválidos. 400 StartStopOfManagedInstanceIsDisabled – a operação iniciar e parar na instância gerenciada não está habilitada. 400 ManagementServiceStartStopManagedInstanceScheduleSubscriptionNotEnabledForFeature - O usuário tentou usar o recurso Iniciar/Parar sem ter a assinatura permitida para o recurso de assinatura apropriado. 400 ManagementServiceStartStopManagedInstanceScheduleFeatureDisabled - O usuário tentou usar o recurso de início/parada agendado Instância Gerenciada de SQL do Azure, que está desabilitado. 400 ManagementServiceStartStopManagedInstanceScheduleNotSupportedOnSKU – Não há suporte para a operação de início/parada agendada na SKU fornecida. 400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform – Parar executado na instância que não está em execução com o Feature Wave novembro de 2022 400 ManagementServiceStartStopManagedInstanceScheduleOverlap – Sobreposição em pares de agendamento. 400 ManagementServiceStartStopManagedInstanceScheduleSmallTimespan – o tempo entre duas ações sucessivas é menor que 1 hora. 404 ManagementServiceStartStopManagedInstanceScheduleNameInvalid - O usuário tentou executar a operação CRUD do agendamento Iniciar/Parar com um nome de agenda diferente de 'default' 404 SubscriptionDoesNotHaveServer – O servidor solicitado não foi encontrado 404 ServerNotInSubscriptionResourceGroup – O servidor especificado não existe no grupo de recursos e na assinatura especificados. 404 ResourceNotFound – O recurso solicitado não foi encontrado. 404 ManagementServiceStartStopManagedInstanceScheduleNotFound – O agendamento não existe para uma determinada instância gerenciada. 409 ManagementServiceStartStopManagedInstanceScheduleConflictingOperation – Falha na tentativa de criar/atualizar/excluir a operação de agendamento Iniciar/Parar no Instância Gerenciada de SQL do Azure. O agendamento não foi criado ou não pôde ser atualizado/excluído, pois estava ocupado com uma operação agendada em andamento. Tente realizar a solicitação novamente mais tarde.

Nome

Tipo

Description

200 OK

StartStopManagedInstanceSchedule

Defina com êxito o agendamento Iniciar/Parar.

201 Created

StartStopManagedInstanceSchedule

Criou com êxito o agendamento Iniciar/Parar.

Other Status Codes

ErrorResponse

Respostas de erro: ***

204 ManagementServiceStartStopManagedInstanceScheduleNameInvalid - O usuário tentou executar a operação CRUD do agendamento Iniciar/Parar com um nome de agenda diferente de 'default'
400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestParametersInvalid – o conjunto fornecido de parâmetros no corpo da solicitação é vazio ou inválido.
400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestTimeZoneInvalid – o parâmetro de fuso horário fornecido é inválido.
400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestScheduleInvalid – o agendamento de Início/Parada fornecido é inválido. A agenda não contém itens na lista de agendamento ou alguns dos itens na lista têm valores inválidos.
400 StartStopOfManagedInstanceIsDisabled – a operação iniciar e parar na instância gerenciada não está habilitada.
400 ManagementServiceStartStopManagedInstanceScheduleSubscriptionNotEnabledForFeature - O usuário tentou usar o recurso Iniciar/Parar sem ter a assinatura permitida para o recurso de assinatura apropriado.
400 ManagementServiceStartStopManagedInstanceScheduleFeatureDisabled - O usuário tentou usar o recurso de início/parada agendado Instância Gerenciada de SQL do Azure, que está desabilitado.
400 ManagementServiceStartStopManagedInstanceScheduleNotSupportedOnSKU – Não há suporte para a operação de início/parada agendada na SKU fornecida.
400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform – Parar executado na instância que não está em execução com o Feature Wave novembro de 2022
400 ManagementServiceStartStopManagedInstanceScheduleOverlap – Sobreposição em pares de agendamento.
400 ManagementServiceStartStopManagedInstanceScheduleSmallTimespan – o tempo entre duas ações sucessivas é menor que 1 hora.
404 ManagementServiceStartStopManagedInstanceScheduleNameInvalid - O usuário tentou executar a operação CRUD do agendamento Iniciar/Parar com um nome de agenda diferente de 'default'
404 SubscriptionDoesNotHaveServer – O servidor solicitado não foi encontrado
404 ServerNotInSubscriptionResourceGroup – O servidor especificado não existe no grupo de recursos e na assinatura especificados.
404 ResourceNotFound – O recurso solicitado não foi encontrado.
404 ManagementServiceStartStopManagedInstanceScheduleNotFound – O agendamento não existe para uma determinada instância gerenciada.
409 ManagementServiceStartStopManagedInstanceScheduleConflictingOperation – Falha na tentativa de criar/atualizar/excluir a operação de agendamento Iniciar/Parar no Instância Gerenciada de SQL do Azure. O agendamento não foi criado ou não pôde ser atualizado/excluído, pois estava ocupado com uma operação agendada em andamento. Tente realizar a solicitação novamente mais tarde.

Exemplos

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.

Sample Request

HTTP

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-preview

{
  "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"
      }
    ]
  }
}

Sample Response

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.

Sample Request

HTTP

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-preview

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

Sample Response

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

Definições

Nome	Description
createdByType	O tipo de identidade que criou o recurso.
DayOfWeek	Dia de início.
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
ScheduleItem	Agende informações que descrevem quando o servidor deve ser iniciado ou interrompido.
StartStopManagedInstanceSchedule	Agenda inicial/parada da instância gerenciada.
StartStopScheduleName	Nome do agendamento Iniciar/Parar da instância gerenciada.
systemData	Metadados relativos à criação e à última modificação do recurso.

createdByType

O tipo de identidade que criou o recurso.

Nome	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

DayOfWeek

Dia de início.

Nome	Tipo	Description
Friday	string
Monday	string
Saturday	string
Sunday	string
Thursday	string
Tuesday	string
Wednesday	string

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

ScheduleItem

Agende informações que descrevem quando o servidor deve ser iniciado ou interrompido.

Nome	Tipo	Description
startDay	DayOfWeek	Dia de início.
startTime	string	Hora de início.
stopDay	DayOfWeek	Dia de parada.
stopTime	string	Hora de parar.

StartStopManagedInstanceSchedule

Agenda inicial/parada da instância gerenciada.

Nome	Tipo	Valor padrão	Description
id	string		ID do recurso.
name	string		Nome do recurso.
properties.description	string		A descrição da agenda.
properties.nextExecutionTime	string		Carimbo de data/hora quando a próxima ação será executada no fuso horário de agendamento correspondente.
properties.nextRunAction	string		Próxima ação a ser executada (Iniciar ou Parar)
properties.scheduleList	ScheduleItem[]		Lista de agendamento.
properties.timeZoneId	string	UTC	O fuso horário da agenda.
systemData	systemData		Dados do sistema do recurso agendado.
type	string		Tipo de recurso.

StartStopScheduleName

Nome do agendamento Iniciar/Parar da instância gerenciada.

Nome	Tipo	Description
default	string

systemData

Metadados relativos à criação e à última modificação do recurso.

Nome	Tipo	Description
createdAt	string	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

Share via

Start Stop Managed Instance Schedules - Create Or Update

Parâmetros de URI

Corpo da solicitação

Respostas

Exemplos

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

Sample Request

Sample Response

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

Sample Request

Sample Response

Definições

createdByType

DayOfWeek

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ScheduleItem

StartStopManagedInstanceSchedule

StartStopScheduleName

systemData

Recursos adicionais