Partilhar via


Tipo de recurso recurrencePattern

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Descreve a frequência com que um event recorrente se repete. Este objeto partilhado é utilizado para definir a periodicidade de revisões de acesso, eventos de calendário e atribuições de pacotes de acesso no Microsoft Entra ID.

É possível especificar o padrão de recorrência de um evento recorrente de uma de seis maneiras, dependendo do seu cenário. Para cada tipo de padrão, especifique a quantidade de tempo entre as ocorrências. As ocorrências reais do evento recorrente sempre seguem esse padrão dentro do intervalo de datas que você especifica para o evento. Um evento recorrente é sempre definido por seu recurrencePattern (com que frequência o evento se repete) e seu recurrenceRange (por quanto tempo o evento se repete).

Use a propriedade type para especificar os diferentes tipos de recurrencePattern e a propriedade interval para especificar o tempo entre as ocorrências, que pode ser em número de dias, semanas, meses ou anos, dependendo do type. Observe quais propriedades são necessárias para cada tipo, conforme descrito na tabela a seguir.

Observação Inclua apenas as propriedades necessárias para um padrão de recorrência. Qualquer propriedade que você incluir que não tenha um valor compatível resultará em erro.

Propriedades

Propriedade Tipo Descrição
dayOfMonth Int32 O dia do mês em que ocorre o evento. Obrigatório se type for absoluteMonthly ou absoluteYearly.
daysOfWeek coleção dayOfWeek Uma coleção dos dias da semana em que o evento ocorre. Os valores possíveis são sunday, monday, tuesday, wednesday, thursday, friday, saturday.
Se type for relativeMonthly ou relativeYearly e daysOfWeek especificar mais de um dia, o evento cairá no primeiro dia que satisfizer o padrão.
Obrigatório se type for weekly, relativeMonthly ou relativeYearly.
firstDayOfWeek dayOfWeek O primeiro dia da semana. Os valores possíveis são sunday, monday, tuesday, wednesday, thursday, friday, saturday. O padrão é sunday. Obrigatório se type for weekly.
index weekIndex Especifica em que instância dos dias permitidos especificados em daysOfWeek ocorre o evento, contado a partir da primeira instância do mês. Os valores possíveis são: first, second, third, fourth, last. O padrão é first. Opcional e usado se type for relativeMonthly ou relativeYearly.
interval Int32 O número de unidades entre ocorrências, onde as unidades podem ser em dias, semanas, meses ou anos, dependendo de type. Obrigatório.
month Int32 O mês em que o evento ocorre. É um número entre 1 e 12.
type recurrencePatternType O tipo de padrão da recorrência: daily, weekly, absoluteMonthly, relativeMonthly, absoluteYearly e relativeYearly. Obrigatório. Para obter mais informações, veja valores da propriedade type.

Importante

Para revisões de acesso, apenas são suportadas as propriedades dayOfMonth, interval e type (weekly, absoluteMonthly) .

Valores da propriedade do tipo

Valor da propriedade type Descrição Exemplo Propriedades necessárias
daily O evento se repete com base no número de dias especificado pelo interval entre ocorrências. Repita o evento a cada três dias. type, interval
weekly O evento se repete no mesmo dia ou dias da semana, com base no número de semanas entre cada conjunto de ocorrências. Repita o evento nas segundas e terças-feiras a cada duas semanas. type, interval, daysOfWeek, firstDayOfWeek

Nota: Para revisões de acesso, apenas são suportadas propriedades de intervalo e tipo .
absoluteMonthly O evento se repete no dia especificado do mês (por exemplo, o dia 15), com base no número de meses entre as ocorrências. Repita o evento trimestralmente (a cada três meses) no dia 15. type, interval, dayOfMonth

Nota: Para revisões de acesso, apenas são suportadas as propriedades interval, dayOfMonth e type .
relativeMonthly O evento se repete no dia ou dias específicos da semana, na mesma posição relativa no mês, com base no número de meses entre as ocorrências. Repita o evento na segunda quinta-feira ou sexta-feira a cada três meses. type, interval, daysOfWeek
absoluteYearly O evento se repete no dia e mês específicos, com base no número de anos entre as ocorrências. Repita o evento no dia 15 de março a cada três anos. type, interval, dayOfMonth, month
relativeYearly O evento se repete no dia ou dias específicos da semana, na mesma posição relativa em um mês específico do ano, com base no número de anos entre as ocorrências. Repita o evento na segunda quinta-feira ou sexta-feira de novembro a cada três anos. type, interval, daysOfWeek, month

Relações

Nenhum

Representação JSON

A representação JSON seguinte mostra o tipo de recurso.

{
  "dayOfMonth": 1024,
  "daysOfWeek": ["String"],
  "firstDayOfWeek": "String",
  "index": "String",
  "interval": 1024,
  "month": 1024,
  "type": "String"
}