Criando Programações
Você pode usar o Programador de Recursos para criar programações e adicionar recursos, datas, horários de início e término às programações, além de revisar e editar a programação antes de salvá-la.
Visão Geral de Tarefas
- Preencha os pré-requisitos e crie as políticas necessárias.
- Adicione informações básicas de programação (nome da programação, descrição, ação e tags (opcionalmente).
- Selecione um compartimento e recursos
- Aplicar Parâmetros (opcional)
- Adicionar datas e horários à programação
- Revise e salve a programação
- Monitorar e gerenciar programações (editar, desativar, ativar, excluir, conforme necessário)
Pré-requisitos:
Antes de criar uma programação, verifique os requisitos listados aqui e crie as políticas necessárias para permitir que os usuários criem programações e programações para gerenciar recursos.
- Administradores, crie as políticas necessárias descritas na próxima seção desta página.
- Usuários, verifique seus direitos de acesso e obtenha as permissões necessárias do administrador para criar programações.
- Antes de criar uma programação, certifique-se de ter as seguintes informações:
- Os nomes das tenancies, compartimentos, regiões e organizações em que os recursos estão
- A lista de recursos a serem afetados pelas ações programadas
- As datas e horas das ações de início e parada a serem incluídas nas programações
- Verifique se há conflitos de programação. Procure programações existentes que usem os mesmos recursos que você está programando ao mesmo tempo em que as está programando.
Políticas Obrigatórias
Para poder criar ou gerenciar uma programação, você deve criar uma política para conceder aos usuários permissão para gerenciar programações (consulte o Exemplo 1) E deve criar uma política para política a fim de conceder permissão de programações para gerenciar recursos (consulte o Exemplo 2).
Exemplo 1. Esta política dá aos usuários permissão para gerenciar (listar, criar, excluir, ativar e outros) programações de recursos em sua tenancy.
General example
Allow group <groupname> to manage resource-schedule-family in tenancy
Specific example
Allow group ResourceScheduleAdmins to manage resource-schedule-family in tenancy
Exemplo 2. Esta política fornece uma permissão de programação de recurso para executar uma ação em um recurso.
Quando uma programação de recursos é criada, por padrão, ela não tem permissão para executar uma ação nos recursos de destino; portanto, você deve conceder permissão a ela.
Esta política concede uma permissão de programação para gerenciar recursos predefinidos, como instâncias em um compartimento.
General example
Allow any-user to manage <resource_type>
in compartment id <compartment_ocid> where all
{request.principal.type='resourceschedule',
request.principal.id='<ocid_of_resourceschedule>'}
Specific example
Allow any-user to manage instance in
compartment id ocid.compartment.oc1...q7fa where all
{request.principal.type='resourceschedule',
request.principal.id='ocid.resourceschedule.oc1.iad.axgr...dt8zb'}
Para obter mais informações, consulte Autenticação e Autorização, Políticas do Programador de Recursos e Políticas de Exemplo.
Autenticação e Autorização de Autenticação
Esta página descreve o processo do IAM do Identity and Access Management usado para garantir o acesso seguro ao Programador de Recursos.
Cada serviço do Oracle Cloud Infrastructure integra-se ao serviço IAM para autenticação e autorização em relação a todas as interfaces (a Console, SDK ou CLI e API REST).
Um administrador da sua organização precisa configurar grupos , compartimentos epolíticas que controlam quais usuários podem acessar quais serviços, quais recursos e o tipo de acesso. Por exemplo, as políticas controlam quem pode criar novos usuários, criar e gerenciar a rede na nuvem, iniciar instâncias, criar buckets, fazer download de objetos e assim por diante. Para obter mais informações, consulte Gerenciando Domínios de Identidades. Para ver detalhes específicos sobre a gravação de políticas para cada um dos diferentes serviços, consulte a Referência de Políticas.
Exemplo de política
Permita que o grupo ResourceScheduleAdmins execute operações administrativas com programações de recursos, incluindo Criar, Atualizar, Mover e Excluir.
Allow group ResourceScheduleAdmins to manage resource-schedule in tenancy
Se você for um usuário (mas não um administrador) que precisa usar os recursos do Oracle Cloud Infrastructure que sua empresa possui, entre em contato com o administrador para configurar um ID de usuário para você. Um administrador pode confirmar o(s) compartimento(s) que você deverá usar.
Para usar qualquer uma das operações da API do Programador de Recursos, você deve estar autorizado em uma política do serviço IAM. Se você não estiver autorizado, entre em contato com o administrador. Se você for um administrador que precisa gravar políticas para conceder acesso aos usuários, consulte Gerenciando Domínios de Identidades.
Adicionando informações básicas de cronograma
- Na página Programações do Programador de Recursos, selecione Criar uma Programação. A página Criar informações Básicas da programação é aberta. Na página Informações Básicas:
- Informe o nome de um agendamento.
- Opcional: Informe uma descrição de Programação
- No campo Ação a ser executada, selecione Iniciar ou Interromper.
- No campo Programar Compartimento, use o menu para selecionar o compartimento no qual você deseja que a nova programação seja.
- Opcional: Selecione Mostrar opções avançadas. Você pode aplicar tags aos seus recursos para ajudar a organizá-los de acordo com suas necessidades comerciais. Você pode aplicar tags no momento da criação de um recurso ou pode atualizá-lo posteriormente com tags. Consulte Adicionando Tags para obter informações sobre como adicionar tags a recursos. Para obter informações gerais sobre como aplicar tags, consulte Tags de Recursos.
Adicionando recursos
Importante
O Programador de Recursos suporta os seguintes tipos de recursos:- Instâncias de Computação
- Pools de instâncias de computação
- Autonomous Databases
- Recursos da função
Ele poderá suportar outros recursos em versões futuras. Para ver a lista de recursos suportados, use a API ListResourceTypes .
Observação
O Programador de Recursos pode processar apenas 200 recursos por programação. Se você selecionar Dinâmico, o Programador de Recursos adicionará os primeiros 200 recursos que ele vê na fila. Não é possível selecionar manualmente os recursos ou definir a ordem dos recursos que são adicionados dinamicamente. Se você criar um segundo agendamento e selecionar Dinâmico, o Agendador de recursos adicionará o mesmo conjunto de 200 recursos que ele fez antes. Para programar mais de 200 recursos, crie quantas programações forem necessárias, selecione recursos Estáticos e adicione até 200 recursos por programação, na ordem desejada. Para obter mais informações, consulte Dynamic Resource Management e Static Resource Management.- No painel esquerdo da página Criar Programações, selecione Recursos. A página Recursos e a lista de recursos existentes no compartimento selecionado são exibidas.
- Conforme necessário, selecione outro compartimento.
- Selecione um ou mais recursos na lista de recursos ou altere os critérios de seleção conforme descrito nas próximas etapas.
- No campo Método de seleção de recursos, selecione o tipo de recurso que você deseja gerenciar com a programação, Estático ou Dinâmico. Quando você procura recursos, apenas o tipo selecionado é mostrado.
- No campo Pesquisar e filtrar, use a seleção padrão (compartimento Tudo) para procurar recursos ou selecione Compartimento e use o menu para selecionar outro compartimento para procurar recursos. Os seguintes tipos de recursos estão disponíveis para pesquisa.
- Compartimento
- Tipo de recurso
- Status
- Etiquetas
- A tabela a seguir mostra os tipos de recursos e as descrições de cada um.
Tipos 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 Instância do Autonomous Database ou (Compute) 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 Aplicar filtro para executar a pesquisa e exibir a lista de recursos encontrados.
Aplicar Parâmetros (opcional)
Você pode usar a página Aplicar Parâmetros para opcionalmente adicionar parâmetros aos recursos selecionados ao criar ou editar uma programação.Observação
No momento, o Programador de Recursos suporta apenas o parâmetro Corpo no recurso Função. Ele pode suportar outros parâmetros em versões futuras.- No painel esquerdo da página Criar Programações, selecione Aplicar Parâmetros.
- Selecione um nome de parâmetro no menu.
- Opcional: Informe um valor para o parâmetro.
- Selecione um ou mais recursos aos quais aplicar o parâmetro.
- Selecione Próximo para ir até a página Programações ou se não houver outras alterações na programação, selecione Revisar, verifique as alterações e selecione Salvar programação (se estiver criando uma programação) ou Editar programação (se estiver editando uma programação).
Adicionando Informações de Agendamento
Use a página Programação para adicionar datas e horas para iniciar e interromper a programação. Você pode inserir manualmente as informações usando os formulários da IU ou com uma expressão Cron, ou usar a CLI ou a API para adicionar informações de programação.
Usando os Forms da Interface de Usuário
Você pode usar os formulários da interface do usuário para adicionar informações de tempo à programação, selecionar um compartimento para a programação e configurar parâmetros adicionais para a programação. Usando uma Expressão Cron para obter informações sobre como usar Cron para definir a programação. Observação
O Programador de Recursos usa somente a hora UTC. Ele não altera automaticamente os horários de programação quando a hora local muda do horário padrão para o horário de verão ou do horário de verão para o horário padrão.- Informe um intervalo para a programação.
- No campo Intervalo, use o menu para selecionar o intervalo de tempo da programação. As opções são:
- Único
- Horária
- Todo Dia
- Semana
- Mensalmente
Criando uma Programação Única
- Selecione o Campo Intervalo para exibir o menu.
- Selecione Uma vez. A caixa de diálogo única é exibida.
- No campo Hora, informe a hora UTC em formato de 24 horas. Veja a nota sobre a hora UTC acima.
- Selecione o ícone do calendário para selecionar uma data e hora em que a ação especificada na programação será iniciada.
- Selecione Próximo para revisar a programação, incluindo as informações Básicas, Recursos e Programação.
- Depois de revisar a programação, selecione Criar para salvar a programação. A ação (iniciar/parar) é executada nos recursos selecionados na data e hora selecionadas.
Criando uma programação por hora
- Selecione o campo Intervalo para exibir o menu.
- Selecione Por Hora. A caixa de diálogo Por hora será aberta.
- No campo Hora, informe a hora UTC em formato de 24 horas. Veja a nota sobre a hora UTC acima.
- No campo Data de início, informe a data de início no formato MM/DD/AAAA ou use o ícone de calendário para selecionar uma data e hora.
- Para definir a data de término, selecione o campo Data de término e use o calendário para inserir a data e a hora de término/
Criando uma programação diária
- Selecione o Campo Intervalo para exibir o menu.
- Selecione Daily. A caixa de diálogo Diário é aberta.
- No campo Repetir a cada, informe a frequência com que deseja que a programação seja executada ou use o menu para selecionar um intervalo. O valor mínimo é 1. O valor máximo é 99.
- No campo Dias da semana, selecione Selecionar... para escolher quais dias da semana executar a programação. Você pode selecionar um ou mais dias da semana, um de cada vez. Selecione o X ao lado de um nome exibido para excluí-lo da lista de dias selecionados.
- No campo Horário Inicial, informe o horário UTC em horas e minutos no formato de 24 horas. Veja a nota sobre a hora UTC acima.
- No campo Data de início, informe a data de início no formato MM/DD/AAAA ou use o ícone de calendário para selecionar uma data e hora.
- Para definir a data de término, selecione o campo Data de término e use o calendário para inserir a data e a hora de término/
Criando uma Programação Semanal
- Selecione o Campo Intervalo para exibir o menu.
- Selecione Semanal. A caixa de diálogo Semanal será aberta.
- No campo Repetir a cada, informe a frequência com que deseja que a programação se repita. Por exemplo, 1 = a cada semana, 2 = a cada duas semanas, 3 = a cada três semanas. O número mínimo de semanas é 1. O número máximo de semanas é 99.
- No campo Dia(s) da semana, selecione os dias da semana que você deseja que a programação seja executada. Você pode selecionar um ou mais dias, um de cada vez. Para remover um dia, selecione o X ao lado do dia.
- No campo Data inicial, use o calendário para selecionar a data e a hora de início da programação.
- Opcional: no campo Data final, use o calendário para selecionar a data e a hora em que a programação termina.
Criando um Cronograma Mensal
- Selecione o Campo Intervalo para exibir o menu.
- Selecione Mensal. A caixa de diálogo Mensal será aberta.
- No campo Repetir a cada, informe a frequência com que deseja que a programação se repita. Por exemplo, 1 = todo mês, 2 = a cada dois meses, 3 = a cada três meses. O número mínimo de meses é 1. O número máximo de meses é 99.
- No campo Dia(s) do mês, selecione o número do dia do mês que você deseja que a programação seja executada. Por exemplo, 1 é o primeiro dia do mês, 17 é o décimo sétimo dia do mês. Você pode selecionar um ou mais dias, um de cada vez. Para remover um dia, selecione o X ao lado do dia.
- No campo Hora de início, use o calendário para selecionar uma data e uma hora UTC em que a programação começa. Veja a nota sobre a hora UTC acima.
- No campo Data final, use o calendário para selecionar a data e a hora UTC em que a programação termina.
Usando uma Expressão Cron
Você pode usar uma expressão Cron para definir a programação. Consulte Usando os Formulários da Interface do Usuário para obter informações sobre como usar os formulários da interface do usuário para definir a programação.
/Observação
O Programador de Recursos usa somente a hora UTC. Ele não altera automaticamente os horários de programação quando a hora local muda do horário padrão para o horário de verão ou do horário de verão para o horário padrão.- Na janela Programação, selecione Cron para exibir a janela Cron.
- Insira uma expressão Cron válida para definir o intervalo de agendamento, a data e hora de início e a data e hora de término. Por exemplo: Exemplos
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.30 13 * * mon-fri
Esta expressão define a programação para ser executada a cada 2 horas no 15o dia de qualquer mês.0 */2 15 * *
- No campo Data inicial, informe a data inicial manualmente ou use o calendário para selecionar uma data
- Opcional: no campo Data final, informe a data final manualmente ou use o calendário para selecionar uma data
Detalhes da Expressão Cron
Uma expressão cron é uma sequência de cinco campos, cada um separado por um espaço em branco.
Digite a expressão cron no seguinte formato:
Você pode usar os seguintes valores em uma expressão cron:
- <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. Observação
Não é possível criar uma programação que seja acionada em um intervalo inferior a uma hora. Apenas intervalos de uma hora ou mais são permitidos. Por exemplo, você pode criar uma programação com a expressão0 * 15 * *
para executar a programação a cada hora no dia 15 de qualquer mês. Não é possível definir uma programação com*/15 * 15 * *
que seria a cada 15 minutos 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. Observe que o Programador de Recursos não suporta o intervalo de 30 minutos mostrado nessa página.
Revisando um Cronograma
Revisar e editar uma programação ou criar uma nova a partir de uma existente é a etapa final do processo para criar uma programação.
Importante
Para gerenciar programações do Programador de Recursos, você deve ter permissões para acessá-las e alterá-las. Para obter mais informações, consulte Autenticação e Autorização, Políticas do Programador de Recursos e Políticas de Exemplo.- Depois de concluir as principais etapas (Básico, Recursos e Programação) para criar uma programação, selecione Revisar. A janela Revisar inclui uma seção separada para cada etapa principal para criar uma programação. Cada seção mostra todas as informações inseridas ou selecionadas nessa parte do processo para criar um cronograma.
- Revise e edite as informações em cada seção, conforme necessário.
- Quando terminar, a janela será fechada e retornará à lista de agendamentos. Enquanto o Programador de Recursos cria a programação, o status da solicitação de serviço da programação diz Criando. Quando a solicitação de serviço é concluída, o status diz Bem-sucedido. Se as informações na programação nova ou atualizada forem inválidas, o Programador de recursos retornará o erro 400 (solicitação inválida, entrada inválida). A solicitação de atualização falha e nenhuma alteração é aplicada à programação.
- Na página Programações do Programador de Recursos, selecione Criar uma Programação. A página Criar informações Básicas da programação é aberta. Na página Informações Básicas:
Use o comando Criar CLI de Programação do Programador de Recursos e os parâmetros necessários para criar uma programação.
oci resource-scheduler schedule create --action, --compartment-id | -c, --recurrence-details, --defined-tags, --description, --display-name, --freeform-tags, -? | -h | --help, --resource-filters, --resources, --time-starts
Para obter uma lista completa de parâmetros e valores para todos os comandos da CLI do Programador de Recursos, consulte a CLI do Scheduler de Recursos.
Para obter uma lista completa de parâmetros e valores para comandos da CLI, consulte a Referência de Comandos da CLI.
Use a API CreateSchedule do Programador de Recursos para criar uma programação. Para obter uma lista completa de APIs do agendador de recursos, consulte APIs do agendador de recursos.