Skip to main content
Astra Automation
Uma versão mais recente deste produto está disponível.
O português é fornecido por meio de tradução automática para sua conveniência. O inglês precede o português em caso de inconsistências.

Criar um novo cronograma para um app

PDFs

POST /accounts/{account_id}/k8s/v1/apps/{app_id}/schedules

Indica os valores desejados para o recurso da API Schedule a ser criado.

Parâmetros

Nome Tipo Em Obrigatório Descrição

id_da_conta

string

caminho

Verdadeiro

ID do recurso de conta que o contém

  • exemplo: {{.Account}}

app_id

string

caminho

Verdadeiro

ID do recurso do aplicativo que o contém

Corpo da solicitação

Indica os valores desejados para o recurso da API Schedule a ser criado.

Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

Tipo de mídia do recurso. Os valores definidos são:

  • "application/astra-schedule"

versão

string

Verdadeiro

Versão do recurso. Os valores definidos são:

  • "1,0"

  • "1,1"

  • "1,2"

  • "1,3"

nome

string

Verdadeiro

String JSON contendo o nome da programação. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 63

habilitado

string

Falso

String JSON que indica se um agendamento está ativo. Os valores definidos são:

  • "verdadeiro" - O cronograma está ativo

  • "false" - O agendamento não está ativo Se não for especificado, o valor padrão é "true".

granularidade

string

Verdadeiro

String JSON que indica a granularidade da programação. Os valores definidos são:

  • "por hora"

  • "diário"

  • "semanalmente"

  • "mensal"

  • "personalizado"

minuto

string

Falso

String JSON contendo um valor numérico que indica o minuto da hora (0 - 59) em que a programação deve ser executada. Os valores definidos são:

  • A expressão regular definida é: "^[0-9]

[1-5][0-9]$" Este campo estará presente se granularidade estiver definida como "hourly", "daily", "weekly" ou "monthly". Ele será retornado com o valor "0" para agendamentos personalizados.

hora

string

Falso

String JSON contendo um valor numérico que indica a hora do dia (0 - 23) em que a programação deve ser executada. Os valores definidos são:

  • A expressão regular definida é: "^[0-9]

[1][0-9]

[2][0-3]$" Este campo está presente se granularidade estiver definida como "daily", "weekly" ou "monthly".

dayOfWeek

string

Falso

String JSON contendo um valor numérico que indica o dia da semana (0-7) em que a programação deve ser executada. Os valores definidos são:

  • A expressão regular definida é: "^[0-7]$" Este campo só está presente se granularidade estiver definida como "semanal".

dayOfMonth

string

Falso

String JSON contendo um valor numérico que indica o dia do mês (1-31) em que a programação deve ser executada. Os valores definidos são:

  • A expressão regular definida é: "^[1-9]

[1-2][0-9]

[3][0-1]$" Este campo só está presente se granularidade estiver definida como "monthly".

recurrenceRule

string

Falso

String JSON contendo uma RFC-5545 Seção 3.8.5.3. Regra de recorrência. Para o parâmetro DTSTART, somente timestamps UTC (indicados pelo sufixo "Z") são suportados, e somente timestamps anteriores à hora atual são suportados. Para as partes da regra RECUR, "FREQ" e "INTERVAL" são as únicas partes suportadas. Para a parte da regra FREQ, "MINUTELY" e "HOURLY" são os únicos valores suportados. Este campo só está presente se granularidade estiver definida como "custom".

snapshotRetention

string

Verdadeiro

String JSON contendo um valor numérico positivo que indica quantos snapshots devem ser mantidos. Zero indica que os snapshots devem ser excluídos após a criação de um backup. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 63

  • A expressão regular definida é: "^(0

([1-9][0-9]*))$"

backupRetention

string

Verdadeiro

String JSON contendo um valor numérico positivo que indica quantos backups devem ser mantidos. Zero indica que nenhum backup deve ser criado. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 63

  • A expressão regular definida é: "^(0

([1-9][0-9]*))$"

bucketID

string

Falso

String JSON contendo um ID de bucket opcional que indica onde o backup deve ser armazenado na criação. Se não for especificado, um bucket selecionado pelo sistema será usado. Os valores definidos são:

  • Conforme o esquema de identificador Astra

replicar

string

Falso

String JSON que indica se o agendamento aciona a replicação AppMirror para cada snapshot. Só entra em vigor se o aplicativo tiver um relacionamento AppMirror definido. Os valores definidos são:

  • "verdadeiro" - O agendamento aciona a replicação do AppMirror

  • "false" - O agendamento não aciona a replicação do AppMirror. Se não for especificado, o valor padrão é "false".

metadados
Exemplo de solicitação 
{
  "type": "application/astra-schedule",
  "version": "1.3",
  "name": "Backup Schedule",
  "enabled": "true",
  "granularity": "monthly",
  "minute": "0",
  "hour": "0",
  "dayOfMonth": "1",
  "snapshotRetention": "12",
  "backupRetention": "12"
}

Resposta

Status: 201, Returns the newly created schedule resource in the JSON response body.
Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

Tipo de mídia do recurso. Os valores definidos são:

  • "application/astra-schedule"

versão

string

Verdadeiro

Versão do recurso. Os valores definidos são:

  • "1,0"

  • "1,1"

  • "1,2"

  • "1,3"

id

string

Verdadeiro

Identificador globalmente único do recurso. Os valores definidos são:

  • Em conformidade com o esquema UUIDv4

nome

string

Verdadeiro

String JSON contendo o nome da programação. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 63

habilitado

string

Verdadeiro

String JSON que indica se um agendamento está ativo. Os valores definidos são:

  • "verdadeiro" - O cronograma está ativo

  • "false" - O agendamento não está ativo Se não for especificado, o valor padrão é "true".

granularidade

string

Verdadeiro

String JSON que indica a granularidade da programação. Os valores definidos são:

  • "por hora"

  • "diário"

  • "semanalmente"

  • "mensal"

  • "personalizado"

minuto

string

Verdadeiro

String JSON contendo um valor numérico que indica o minuto da hora (0 - 59) em que a programação deve ser executada. Os valores definidos são:

  • A expressão regular definida é: "^[0-9]

[1-5][0-9]$" Este campo estará presente se granularidade estiver definida como "hourly", "daily", "weekly" ou "monthly". Ele será retornado com o valor "0" para agendamentos personalizados.

hora

string

Falso

String JSON contendo um valor numérico que indica a hora do dia (0 - 23) em que a programação deve ser executada. Os valores definidos são:

  • A expressão regular definida é: "^[0-9]

[1][0-9]

[2][0-3]$" Este campo está presente se granularidade estiver definida como "daily", "weekly" ou "monthly".

dayOfWeek

string

Falso

String JSON contendo um valor numérico que indica o dia da semana (0-7) em que a programação deve ser executada. Os valores definidos são:

  • A expressão regular definida é: "^[0-7]$" Este campo só está presente se granularidade estiver definida como "semanal".

dayOfMonth

string

Falso

String JSON contendo um valor numérico que indica o dia do mês (1-31) em que a programação deve ser executada. Os valores definidos são:

  • A expressão regular definida é: "^[1-9]

[1-2][0-9]

[3][0-1]$" Este campo só está presente se granularidade estiver definida como "monthly".

recurrenceRule

string

Falso

String JSON contendo uma RFC-5545 Seção 3.8.5.3. Regra de recorrência. Para o parâmetro DTSTART, somente timestamps UTC (indicados pelo sufixo "Z") são suportados, e somente timestamps anteriores à hora atual são suportados. Para as partes da regra RECUR, "FREQ" e "INTERVAL" são as únicas partes suportadas. Para a parte da regra FREQ, "MINUTELY" e "HOURLY" são os únicos valores suportados. Este campo só está presente se granularidade estiver definida como "custom".

snapshotRetention

string

Verdadeiro

String JSON contendo um valor numérico positivo que indica quantos snapshots devem ser mantidos. Zero indica que os snapshots devem ser excluídos após a criação de um backup. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 63

  • A expressão regular definida é: "^(0

([1-9][0-9]*))$"

backupRetention

string

Verdadeiro

String JSON contendo um valor numérico positivo que indica quantos backups devem ser mantidos. Zero indica que nenhum backup deve ser criado. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 63

  • A expressão regular definida é: "^(0

([1-9][0-9]*))$"

bucketID

string

Falso

String JSON contendo um ID de bucket opcional que indica onde o backup deve ser armazenado na criação. Se não for especificado, um bucket selecionado pelo sistema será usado. Os valores definidos são:

  • Conforme o esquema de identificador Astra

replicar

string

Falso

String JSON que indica se o agendamento aciona a replicação AppMirror para cada snapshot. Só entra em vigor se o aplicativo tiver um relacionamento AppMirror definido. Os valores definidos são:

  • "verdadeiro" - O agendamento aciona a replicação do AppMirror

  • "false" - O agendamento não aciona a replicação do AppMirror. Se não for especificado, o valor padrão é "false".

metadados
Exemplo de resposta 
{
  "type": "application/astra-schedule",
  "version": "1.3",
  "id": "49cbc480-5f7d-51e2-8f30-52b9a83a03b1",
  "name": "Backup Schedule",
  "enabled": "true",
  "granularity": "monthly",
  "minute": "0",
  "hour": "0",
  "dayOfMonth": "1",
  "snapshotRetention": "12",
  "backupRetention": "12",
  "metadata": {
    "labels": [],
    "creationTimestamp": "2022-10-06T20:58:16.305662Z",
    "modificationTimestamp": "2022-10-06T20:58:16.305662Z",
    "createdBy": "8f84cf09-8036-51e4-b579-bd30cb07b269"
  }
}

Resposta

Status: 401, Unauthorized
Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

status

string

Verdadeiro

ID de correlação

string

Falso
Exemplo de resposta 
{
  "type": "https://astra.netapp.io/problems/3",
  "title": "Missing bearer token",
  "detail": "The request is missing the required bearer token.",
  "status": "401"
}

Resposta

Status: 400, Bad request
Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

status

string

Verdadeiro

ID de correlação

string

Falso

invalidFields

array["invalidFields"]

Falso

Lista de campos inválidos no corpo da requisição
Exemplo de resposta 
{
  "type": "https://astra.netapp.io/problems/5",
  "title": "Invalid query parameters",
  "detail": "The supplied query parameters are invalid.",
  "status": "400"
}

Resposta

Status: 409, Conflict
Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

status

string

Verdadeiro

ID de correlação

string

Falso
Exemplo de resposta 
{
  "type": "https://astra.netapp.io/problems/10",
  "title": "JSON resource conflict",
  "detail": "The request body JSON contains a field that conflicts with an idempotent value.",
  "status": "409"
}

Resposta

Status: 403, Forbidden
Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

status

string

Verdadeiro

ID de correlação

string

Falso
Exemplo de resposta 
{
  "type": "https://astra.netapp.io/problems/11",
  "title": "Operation not permitted",
  "detail": "The requested operation isn't permitted.",
  "status": "403"
}

Erro

Status: 404, Not found
Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

status

string

Verdadeiro

ID de correlação

string

Falso
Exemplo de resposta de erro 
{
  "type": "https://astra.netapp.io/problems/2",
  "title": "Collection not found",
  "detail": "The collection specified in the request URI wasn't found.",
  "status": "404"
}

Definições

Ver definições

tipo_astra_label

Nome Tipo Obrigatório Descrição

nome

string

Verdadeiro

valor

string

Verdadeiro

type_astra_metadados_update

Metadados especificados pelo cliente e pelo serviço associados ao recurso. Os valores definidos são:

  • Está em conformidade com o esquema de metadados Astra. Se não for especificado na criação, um objeto de metadados será criado sem rótulos. Se não for especificado na atualização, os rótulos do objeto de metadados, creationTimestamp e createdBy, serão preservados sem modificação.

Nome Tipo Obrigatório Descrição

etiquetas

array["tipo_astra_label"]

Falso

CriaçãoTimestamp

string

Falso

Alteração do Timestamp

string

Falso

CreatedBy

string

Falso

modifiedBy

string

Falso

invalidParams

Nome Tipo Obrigatório Descrição

nome

string

Verdadeiro

Nome do parâmetro de consulta inválido

razão

string

Verdadeiro

Motivo pelo qual o parâmetro de consulta é inválido

invalidFields

Nome Tipo Obrigatório Descrição

nome

string

Verdadeiro

Nome do campo inválido no corpo da requisição

razão

string

Verdadeiro

Motivo pelo qual o campo do corpo da solicitação é inválido