Tipo de recurso recurrenceRange

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 um intervalo de datas sobre o qual um evento periódico. 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 intervalo de datas para um evento recorrente de uma de três maneiras, dependendo do seu cenário. Como você deve sempre especificar um valor de startDate para o intervalo de datas, é possível especificar um evento recorrente que termina em uma data específica, que não termina ou que termina após um número específico de ocorrências. As ocorrências reais dentro do intervalo de datas sempre seguem o padrão de recorrência que você especifica para o evento recorrente. 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).

Propriedades

Propriedade	Tipo	Descrição
endDate	Data	A data para parar de aplicar o padrão de recorrência. Dependendo do padrão de recorrência do evento, a última ocorrência da reunião pode não ser essa data. Obrigatório se type for endDate.
numberOfOccurrences	Int32	O número de vezes para repetir o evento. Obrigatório e deve ser positivo se type for numbered.
recurrenceTimeZone	Cadeia de caracteres	Fuso horário das propriedades startDate e endDate. Opcional. Se a propriedade não for especificada, será usado o fuso horário do evento.
startDate	Data	A data para começar a aplicar o padrão de recorrência. A primeira ocorrência da reunião pode ser essa data ou posterior, dependendo do padrão de recorrência do evento. Deve ser o mesmo valor da propriedade start do event recorrente. Obrigatório.
type	Cadeia de caracteres	O intervalo de recorrência. Os valores possíveis são: endDate, noEnd, numbered. Obrigatório.

Use a propriedade type para especificar os diferentes tipos de recorrenceRange. Observe as propriedades necessárias para cada tipo, conforme descrito na tabela a seguir.

propriedade type	Tipo de intervalo de recorrência	Descrição	Exemplo	Propriedades necessárias
endDate	Intervalo com data final	O evento se repete em todos os dias que se encaixam no padrão de recorrência correspondente entre startDate e endDate, incluindo essas datas.	Repita o evento no período entre 1º de junho de 2017 e 15 de junho de 2017.	type, startDate, endDate
noEnd	Intervalo sem uma data final	O evento se repete em todos os dias que se encaixam no padrão de recorrência correspondente começando em startDate.	Repita o evento no intervalo de datas que começa em 1º de junho de 2017, indefinidamente.	type, startDate
numbered	Intervalo com número específico de ocorrências	O evento se repete para numberOfOccurrences com base no padrão de recorrência começando em startDate.	Repita o evento no período que começa em 1º de junho de 2017, para dez ocorrências.	type, startDate, numberOfOccurrences

Relações

Nenhum

Representação JSON

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

{
  "endDate": "String (timestamp)",
  "numberOfOccurrences": 1024,
  "recurrenceTimeZone": "string",
  "startDate": "String (timestamp)",
  "type": "String"
}