Documentação do Oracle Cloud Infrastructure

Criando uma Programação do Programador de Recursos

Crie uma programação do Programador de Recursos para reduzir os custos dos recursos em sua tenancy iniciando e interrompendo-os automaticamente conforme necessário.

Para obter informações sobre pré-requisitos, consulte Programações do Programador de Recursos.

  • Na página da lista Programações, selecione Criar programação. Se precisar de ajuda para localizar a página da lista, consulte Listando Programações do Programador de Recursos.

    A criação de uma programação do Programador de Recursos consiste em concluir as seguintes páginas:

    Execute cada um dos seguintes workflows pela ordem. Você pode retornar a uma página anterior, selecionando Anterior.

    Informações Gerais

    A página Informações Gerais é onde você fornece as informações básicas para a programação.

    Digite as seguintes informações:

    • Nome da programação: Informe o nome da programação que você está criando.
    • Descrição da programação: (Opcional) Forneça uma descrição da programação.
    • Ação a ser executada: Selecione uma das seguintes ações a serem aplicadas à programação:
      • Início
      • Interromper
    • Método de seleção de recursos: Selecione um dos seguintes métodos de seleção de recursos:
      • Estático: Esta opção aplica a programação aos recursos nomeados específicos. Se você selecionar essa opção, todos os recursos disponíveis serão listados na página. Marque a caixa de seleção das que deseja incluir na programação. Você pode especificar um compartimento e aplicar filtros para restringir a lista de recursos disponíveis. Este processo é descrito posteriormente na seção a seguir.
      • Dinâmico: Esta opção aplica a programação a todos os recursos que atendem aos critérios de pesquisa no momento da execução da programação. Se você selecionar essa opção, todos os recursos listados na página serão incluídos automaticamente no agendamento. Você pode especificar um compartimento e aplicar filtros para restringir a lista de recursos disponíveis. Este processo é descrito posteriormente na seção a seguir.
    • Compartimento: Selecione o compartimento no qual a programação reside.
    • Tags: Selecione Adicionar tag. Se você tiver permissões para criar um recurso, também terá permissões para aplicar tags de formato livre a esse recurso. Para aplicar uma tag definida, você deve ter permissões para usar o namespace da tag. Para obter mais informações sobre tags, consulte Tags de Recurso. Se você não tiver certeza se deseja aplicar tags, ignore essa opção ou pergunte a um administrador. Você pode aplicar tags posteriormente.

    Selecione Próximo.

    Recursos

    A página Recursos é onde as instâncias de computação e os bancos de dados autônomos podem suportar outros recursos em releases futuras.

    Pesquisar e filtrar: Use as opções de filtro para localizar e limitar os recursos para seleção de recursos estáticos e dinâmicos. Os seguintes tipos de recursos estão disponíveis para pesquisa:

    • Compartimento: Navegue até o compartimento no qual você deseja localizar recursos se não quiser aceitar o compartimento Tudo padrão para procurar recursos. O compartimento selecionado é listado na caixa Pesquisar e filtrar. Se você excluir sua seleção, o compartimento Tudo padrão será usado.
    • Tipo de recurso: Selecione um ou mais dos seguintes tipos de recursos:
      • Instância
      • InstancePool
      • AutonomousDatabase
      • Função
    • Status: Selecione Selecionar tudo ou selecione um ou mais dos seguintes tipos de status:
      • DISPONÍVEL
      • EM EXECUÇÃO
      • INTERROMPIDO
    • Tags: Selecione um tipo de tag na lista e informe o valor correspondente para pesquisar recursos.

      Selecione Corresponder a qualquer valor ou selecione Especificar valores correspondentes e informe o valor a ser correspondido. Selecione + para adicionar valores correspondentes adicionais.

    Além de aplicar filtros predefinidos, você também pode inserir seus próprios filtros de pesquisa com base nas categorias de informações dos recursos. Qualquer recurso que tenha coisas em comum com os termos de filtro inseridos será exibido, com as correspondências mais próximas na parte superior.

    A tabela a seguir mostra os tipos de recursos e as descrições de cada um.

    Filtros de Recurso
    Nome do Filtro Descrição
    Compartimento Use a definição padrão selecionada (Tudo) ou selecione Compartimento para exibir o menu Seleção de Compartimento. Na caixa de diálogo Seleção de Compartimento, selecione pesquisar Compartimentos e use o menu para selecionar o compartimento que contém os recursos que você deseja programar. Selecione Aplicar Filtro para selecionar o compartimento ou selecione Limpar para fechar a caixa de diálogo sem fazer uma seleção.
    Nome para exibição Selecione Nome para exibição na lista para abrir a caixa de diálogo Nome para exibição. Informe o nome para exibição do recurso a ser pesquisado e selecione Aplicar Filtro para selecioná-lo. Quando o recurso for mostrado na tabela, marque a caixa de seleção para selecioná-lo para ser usado na programação. Selecione Aplicar Filtro para selecionar o nome para exibição ou selecione Limpar para fechar a caixa de diálogo sem fazer uma seleção.
    OCID Selecione OCID no campo Digite o OCID do recurso a ser pesquisado.
    Tipo de recurso Selecione Tipo de Recurso na lista para abrir a caixa de diálogo Pesquisar. Selecione Autonomous Database ou ( Compute ) Instance ou ambos. Somente os recursos do tipo selecionado são mostrados na lista. Selecione Aplicar Filtro para selecionar o tipo de recurso ou selecione Limpar para fechar a caixa de diálogo sem fazer uma seleção.

    Observação. Você deve listar pelo menos um tipo de recurso. Se você limpar todas as seleções, nenhum recurso será listado e a pesquisa será desativada.
    Status A seleção padrão é Tudo. Para exibir programações com um status diferente, selecione Status para abrir o menu Pesquisar. Selecione um ou todos os seguintes status: Disponível, Criando, Atualizando, Excluindo, Excluído, Com falha, Inativo, Interrompido ou Encerrado.

    Observação. Se você não selecionar um status, a caixa de diálogo será fechada sem salvar uma seleção.
    Horário de criação Informe a hora UTC em que o recurso foi criado

    Selecione Próximo.

    Aplicar parâmetros

    A página Aplicar parâmetros é onde você adiciona parâmetros aos recursos selecionados ao criar ou editar uma programação. O uso dos recursos Aplicar parâmetros é opcional e pode não estar ativado quando você está criando sua programação.

    1. Selecione um parâmetro na lista Parâmetro.
      Observação

      O Programador de Recursos só suporta o parâmetro Corpo no recurso Função.
    2. Informe um valor JSON para o parâmetro.
    3. Selecione um ou mais recursos aos quais aplicar o parâmetro.

    Selecione Próximo.

    Cronograma

    A página Programação é onde você adiciona datas e horas para iniciar e interromper a programação. Você pode inserir manualmente as informações usando a interface do Formulário ou com uma expressão Cron.

    Digite as seguintes informações:

    Selecione um dos tipos de programação a seguir:

    Cada um desses tipos de programação é descrito nas seções a seguir.

    Observação

    O Programador de Recursos usa somente o horário UTC. Ele não altera automaticamente os horários dos cronogramas quando as horas locais mudam de horário padrão para horário de verão ou de horário de verão para horário padrão.

    Interface do Form

    Você pode usar a interface do Form para adicionar informações de tempo à programação, para selecionar um compartimento para a programação e para configurar outros parâmetros para a programação.

    Digite as seguintes informações:

    • Intervalo: Selecione o intervalo de tempo na lista. As opções incluem Uma vez, Por Hora, Diariamente, Semanalmente e Mensalmente.
    • Repetir a cada: Informe o número de períodos de intervalo que você selecionou anteriormente para a atividade programada ocorrer. O período do intervalo é exibido ao lado da caixa. Por exemplo, se você quiser que a programação ocorra a cada duas semanas, digite "Semanalmente" para o Intervalo e "2" para Repetir a cada.
    • Dia(s) da semana: (somente intervalos semanais e mensais) Selecione os dias da semana em que a programação é executada.
    • Horário: Informe o horário UTC no formato de 24 horas. Por exemplo, 1:00pm seria 13:00.
    • Data inicial: Informe a data ou use a ferramenta de calendário para especificar a data inicial.
    • Data final: (Opcional) Informe a data ou use a ferramenta de calendário para especificar a data final.

    Você não pode criar uma programação que seja acionada em um intervalo de menos de uma hora. Apenas intervalos de uma hora ou mais são permitidos. No entanto, você pode criar duas programações de 1 hora para a mesma operação nos mesmos recursos que iniciam com 30 minutos de intervalo para realizar a mesma coisa que executar uma programação a cada 30 minutos. Enquanto cada cronograma funciona por hora, eles são executados a cada 30 minutos, se revezando.

    Por exemplo: você pode criar um agendamento para ser executado por hora com um horário de início como 12:00 p.m. em uma lista de instâncias e outro agendamento que é executado por hora com a mesma ação e conjunto de instâncias, com um horário de início como 12:30 p.m., A ação é efetivamente executada a cada 30 minutos, mesmo que cada agendamento tenha um intervalo por hora.

    Programações Cron

    Você pode usar uma expressão cron para definir o agendamento.

    Digite as seguintes informações:

    • Detalhes da recorrência: (Opcional) Informe quaisquer detalhes relacionados à recorrência da programação cron.
    • Horário: Informe o horário UTC no formato de 24 horas. Por exemplo, 1:00pm seria 13:00.
    • Data inicial: Informe a data ou use a ferramenta de calendário para especificar a data inicial.
    • Data final: (Opcional) Informe a data ou use a ferramenta de calendário para especificar a data final.

    Uma expressão cron é uma sequência de cinco campos, cada um separado por um espaço em branco. Informe a expressão cron no seguinte formato, usando os seguintes valores:

    • <minute>: 0 a 59
    • <hora>: 0 a 23
    • <dias do mês>: 1 a 31
    • <meses>: de 1 a 12 (de janeiro a dezembro)
    • <dias da semana>: 1 a 7 (de segunda a domingo)

    Por exemplo, para executar a programação às 23:00 no dia 15 de qualquer mês, digite a seguinte expressão: 0 23 15 * *

    Um campo também pode ter os seguintes caracteres especiais:

    Caracteres Especiais
    Caractere Descrição
    * Asterisco: Representa qualquer valor.
    , Vírgula: Separador para mais de um valor. Por exemplo, para <dias da semana>, 2,3 representa terça-feira e quarta-feira.
    - Dash: Faixa de valores. Por exemplo, para <dias da semana>, de 1 a 3 representa de segunda a quarta.
    / Barra: valores da etapa. Por exemplo, para <hour>, */3 representa a cada 3 horas.

    Você não pode criar uma programação que seja acionada em um intervalo de menos de uma hora. Apenas intervalos de uma hora ou mais são permitidos. Por exemplo, você pode criar uma programação com a expressão 0 * 15 * * para executar a programação a cada hora no 15º dia de qualquer mês. Não é possível definir uma programação com */15 * 15 * * que seria a cada 15 minutos no 15º dia de qualquer mês.

    Importante

    O Programador de Recursos não suporta o intervalo de 30 minutos mostrado nessa página. O intervalo mínimo do Programador de Recursos é de uma hora.

    No entanto, você pode criar duas programações de 1 hora para a mesma operação nos mesmos recursos que iniciam com 30 minutos de intervalo para realizar a mesma coisa que executar uma programação a cada 30 minutos. Enquanto cada cronograma funciona por hora, eles são executados a cada 30 minutos, se revezando.

    Por exemplo, você pode criar um agendamento para ser executado por hora com um horário de início como 12:00pm em uma lista de instâncias, e outro agendamento que executa HOURLY com a mesma ação e conjunto de instâncias, com um horário de início como 12:30pm. A ação é executada efetivamente a cada 30 minutos, mesmo que cada agendamento tenha um intervalo por hora.

    O Programador de Recursos usa somente a hora UTC. Ele não altera automaticamente os horários dos cronogramas quando as horas locais mudam de horário padrão para horário de verão ou de horário de verão para horário padrão.

    Informe uma expressão Cron válida para definir o intervalo de programação, a data e a hora iniciais e a data e a hora finais. Por exemplo:

    30 13 * * mon-fri

    Esta expressão significa todas as semanas às 13:30 UTC todas as segundas-feiras, terças-feiras, quartas-feiras, quintas-feiras e sextas-feiras.

    0 */2 15 * *

    Esta expressão define a programação para ser executada a cada 2 horas no 15o dia de qualquer mês.

    Para obter mais informações sobre como criar e formatar expressões Cron, consulte Criando uma Programação de Expressão Cron.

    Selecione Próximo.

    Revisar

    Revise o conteúdo da página Revisar. Selecione Editar para atualizar as definições em qualquer uma das seções. Quando as definições forem totalmente verificadas, selecione Criar programação. A programação criada aparece na página da lista Programações.

  • Use o comando oci resource-scheduler schedule create e os parâmetros necessários para criar uma programação.

    oci resource-scheduler schedule create --action (START_RESOURCE | STOP_RESOURCE) 
--compartment-id compartment_ocid recurrence-type (CRON | ICAL)
--recurrence-details recurrence_details [OPTIONS]

    recurrence-type pode ser uma destas opções:

    • ICAL: Formatação RFC-5545
    • CRON: UNIX cron

    recurrence_details é a frequência de recorrência de uma programação. O campo de frequência pode estar em conformidade com a formatação RFC-5545 ou com a formatação cron UNIX para recorrências, com base no valor especificado pelo parâmetro recurrence_type.

    Para obter uma lista completa de parâmetros e valores para comandos da CLI, consulte a Referência de Comandos da CLI.

  • Execute a operação CreateSchedule para criar uma programação do Programador de Recursos.