Partilhar via


Start Stop Managed Instance Schedules - Create Or Update

Cria ou atualiza a agenda Start/Stop 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

Parâmetros do URI

Name Em Necessá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 da API do Azure Resource Manager ou do portal.

startStopScheduleName
path True

StartStopScheduleName

Nome da agenda Start/Stop 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 do Pedido

Name Necessário Tipo Description
properties.scheduleList True

ScheduleItem[]

Lista de horários.

properties.description

string

A descrição do horário.

properties.timeZoneId

string

O fuso horário da agenda.

Respostas

Name Tipo Description
200 OK

StartStopManagedInstanceSchedule

Defina com êxito o cronograma Start/Stop.

201 Created

StartStopManagedInstanceSchedule

Criado com êxito o cronograma Start/Stop.

Other Status Codes

ErrorResponse

Respostas de erro: ***

  • 204 ManagementServiceStartStopManagedInstanceScheduleNameInvalid - O usuário tentou executar a operação CRUD da agenda Start/Stop com um nome de agenda diferente de 'default'

  • 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestParametersInvalid - O conjunto de parâmetros fornecido no corpo da solicitação está vazio ou é inválido.

  • 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestTimeZoneInvalid - O parâmetro de fuso horário fornecido é inválido.

  • 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestScheduleInvalid - O agendamento Start/Stop fornecido é inválido. A agenda não contém itens na lista de agendas ou alguns dos itens na lista têm valores inválidos.

  • 400 ManagementServiceStartStopManagedInstanceScheduleSmallTimespan - O tempo entre duas ações sucessivas é inferior a 1 hora.

  • 400 ManagementServiceStartStopManagedInstanceScheduleSubscriptionNotEnabledForFeature - O usuário tentou usar o recurso Start/Stop sem ter a assinatura permitidalistada para o recurso de assinatura apropriado.

  • 400 ManagementServiceStartStopManagedInstanceScheduleNotSupportedOnSKU - A operação Start/Stop agendada não é suportada no SKU fornecido.

  • 400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform - Pare executado na instância que não está sendo executada com o Feature Wave novembro de 2022

  • 400 StartStopOfManagedInstanceIsDisabled - Iniciar e parar a operação na instância gerenciada não está habilitado.

  • 400 ManagementServiceStartStopManagedInstanceScheduleFeatureDisabled - O usuário tentou usar o recurso agendado Start/Stop Azure SQL Managed Instance, que está desabilitado.

  • 400 ManagementServiceStartStopManagedInstanceScheduleOverlap - Sobreposição em pares de agendas.

  • 404 ManagementServiceStartStopManagedInstanceScheduleNameInvalid - O usuário tentou executar a operação CRUD da agenda Start/Stop com um nome de agenda diferente de 'default'

  • 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na assinatura especificados.

  • 404 SubscriptionDoesNotHaveServer - O servidor solicitado não foi encontrado

  • 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 operação da agenda Start/Stop na Instância Gerenciada SQL do Azure. A agenda não foi criada ou não pôde ser atualizada/excluída, pois estava ocupada com uma operação agendada em andamento. Tente novamente o seu pedido 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.

Pedido de amostra

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

Resposta da amostra

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

Pedido de amostra

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

Resposta da amostra

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

Name Description
createdByType

O tipo de identidade que criou o recurso.

DayOfWeek

Dia de início.

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

ScheduleItem

Informações de agendamento descrevendo quando o servidor deve ser iniciado ou interrompido.

StartStopManagedInstanceSchedule

Agenda Start/Stop da instância gerenciada.

StartStopScheduleName

Nome da agenda Start/Stop da instância gerenciada.

systemData

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

createdByType

O tipo de identidade que criou o recurso.

Valor Description
User
Application
ManagedIdentity
Key

DayOfWeek

Dia de início.

Valor Description
Sunday
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

Name Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.

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

Name Tipo Description
error

ErrorDetail

O objeto de erro.

ScheduleItem

Informações de agendamento descrevendo quando o servidor deve ser iniciado ou interrompido.

Name Tipo Description
startDay

DayOfWeek

Dia de início.

startTime

string

Hora de início.

stopDay

DayOfWeek

Dia de parada.

stopTime

string

Tempo de paragem.

StartStopManagedInstanceSchedule

Agenda Start/Stop da instância gerenciada.

Name Tipo Default value Description
id

string

ID do recurso.

name

string

Nome do recurso.

properties.description

string

A descrição do horário.

properties.nextExecutionTime

string

Carimbo de data/hora quando a próxima ação será executada no fuso horário da agenda correspondente.

properties.nextRunAction

string

Próxima ação a ser executada (Iniciar ou Parar)

properties.scheduleList

ScheduleItem[]

Lista de horários.

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 da agenda Start/Stop da instância gerenciada.

Valor Description
default

systemData

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

Name Tipo Description
createdAt

string (date-time)

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 (date-time)

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.