uip ou calendários

Sintaxe e opções para "uip ou Calendars", que gerencia calendários de datas excluídas usadas por gatilhos de tempo do Orchestrator.

uip or calendars gerencia calendários — as listas com escopo de tenant de datas excluídas (também chamadas de "Dias não úteis") que gatilhos de tempo consultam para ignorar execuções agendadas. Cada calendário tem um nome, um fuso horário e uma lista de datas excluídas.

Resumo

uip or calendars <verb> [options]

Verbo

Texto	Finalidade
list	Liste calendários no tenant.
get	Busca um calendário por chave, incluindo as datas excluídas.
create	Crie um calendário com um fuso horário opcional.
update	Renomear ou alterar o fuso horário de um calendário por chave.
delete	Exclua um calendário por chave.

Todos os verbos honram as opções globais (--output, --output-filter, --log-level, --log-file). Os códigos de saída seguem o contrato padrão.

uip ou lista de calendários

Liste todos os calendários no tenant. Retorna os campos de resumo (id, name, timeZoneId, excludedDates, key). Use calendars get para um único calendário.

Opções

Short	Long	Valor	Padrão	Description
-l	--limit	Número	50	Tamanho da página
—	--offset	Número	0	Ignorar contagem.
—	--all-fields	Bandeira	desativada	Retorna a carga útil da API completa em vez do resumo selecionado.

Exemplos

uip or calendars list
uip or calendars list --limit 100
uip or calendars list --output-filter 'Data[].{k:key, n:name}'

Formato dos dados (--output json)

{
  "Code": "CalendarList",
  "Data": [
    {
      "name": "US Holidays",
      "timeZoneId": "America/New_York",
      "excludedDates": ["2025-07-04", "2025-12-25"],
      "key": "a1b2c3d4-0000-0000-0000-000000000001",
      "id": 1001
    }
  ]
}

uip ou calendários get

Busca um calendário por chave GUID. Retorna detalhes completos, incluindo datas excluídas.

Argumentos

Name	Required	Finalidade
<calendar-key>	sim	Chave de calendário (GUID). Encontre-o com calendars list.

Opções

Short	Long	Valor	Padrão	Description
—	--all-fields	Bandeira	desativada	Retorna a carga útil da API completa em vez do resumo selecionado.

Exemplos

uip or calendars get a1b2c3d4-0000-0000-0000-000000000001
uip or calendars get a1b2c3d4-0000-0000-0000-000000000001 \
    --output-filter 'Data.excludedDates'

Formato dos dados (--output json)

{
  "Code": "CalendarGet",
  "Data": {
    "name": "US Holidays",
    "timeZoneId": "America/New_York",
    "excludedDates": ["2025-07-04", "2025-12-25"],
    "key": "a1b2c3d4-0000-0000-0000-000000000001",
    "id": 1001
  }
}

criação de uip ou calendários

Crie um novo calendário. Os calendários têm o escopo de tenant. O fuso horário é UTC se --time-zone for omitido.

Argumentos

Name	Required	Finalidade
<name>	sim	Nome do calendário.

Opções

Short	Long	Valor	Padrão	Description
—	--time-zone	ID tz	UTC	Fuso horário do calendário (por exemplo, Europe/Bucharest).

Exemplos

uip or calendars create "EU Holidays" --time-zone "Europe/Bucharest"
uip or calendars create "US Holidays"

Formato dos dados (--output json)

{
  "Code": "CalendarCreated",
  "Data": {
    "name": "EU Holidays",
    "timeZoneId": "Europe/Bucharest",
    "excludedDates": [],
    "key": "a1b2c3d4-0000-0000-0000-000000000010",
    "id": 1010
  }
}

Observação:

Esse verbo cria o registro de calendário com uma lista excludedDates . O preenchimento de datas excluídas não é exposto por meio da CLI — use a interface gráfica do Orchestrator ou a API diretamente.

atualização de uip ou calendários

Atualize um calendário pela chave GUID. Apenas os campos que você fornece mudam; as demais são preservadas.

Argumentos

Name	Required	Finalidade
<calendar-key>	sim	Chave de calendário (GUID).

Opções

Short	Long	Valor	Padrão	Description
—	--name	text	Inalterado	Novo nome.
—	--time-zone	ID tz	Inalterado	Novo fuso horário.

Exemplos

uip or calendars update a1b2c3d4-0000-0000-0000-000000000010 \
    --name "EU Public Holidays"

uip or calendars update a1b2c3d4-0000-0000-0000-000000000010 \
    --time-zone "Europe/Berlin"

Formato dos dados (--output json)

{
  "Code": "CalendarUpdated",
  "Data": {
    "name": "EU Public Holidays",
    "timeZoneId": "Europe/Bucharest",
    "excludedDates": [],
    "key": "a1b2c3d4-0000-0000-0000-000000000010",
    "id": 1010
  }
}

exclusão de uip ou calendários

Exclui um calendário por chave GUID.

Argumentos

Name	Required	Finalidade
<calendar-key>	sim	Chave de calendário (GUID).

Opções

Short	Long	Valor	Padrão	Description
-y	--yes	Bandeira	—	Obrigatório. Confirma esta operação irreversível — a CLI nunca solicita.

Exemplos

uip or calendars delete a1b2c3d4-0000-0000-0000-000000000010 --yes

Formato dos dados (--output json)

{
  "Code": "CalendarDeleted",
  "Data": {
    "Key": "a1b2c3d4-0000-0000-0000-000000000010",
    "Name": "EU Public Holidays",
    "Status": "Deleted successfully"
  }
}

Comandos relacionados

• uip or settings — settings timezones lista IDs de fuso horário válidos para --time-zone.

Veja também

• Opções globais — --output, --output-filter, --log-level, --log-file.
• Códigos de saída — contrato de código de saída padrão.