Atualizar um período de manutenção

Atualize um período de manutenção com uma data final no futuro.

Funções obrigatórias

Você pode chamar esse endpoint com sucesso com qualquer um dos seguintes roles atribuídos:

Solicitar

URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0

PATCH /groups/{PROJECT-ID}/maintenanceWindows/{MW-ID}

Parâmetros do caminho da solicitação

Nome	Tipo	Descrição
`PROJECT-ID`	string	Identificador único do projeto.
`MW-ID`	string	Identificador exclusivo da janela de manutenção que você deseja atualizar.

Solicitar parâmetros de query

Nome	Tipo	necessidade	Descrição	Default
pretty	booleano	Opcional	Sinalizador que indica se o corpo da resposta está em um formato pretty-print.	`false`
envelope	booleano	Opcional	Sinalizador que indica se deve envolver a resposta em um envelope. Alguns clientes de API não podem acessar os cabeçalhos de resposta HTTP ou o código de status. Para corrigir isso, defina envelope=true na query. Para endpoints que retornam um resultado, o corpo da resposta inclui: `status`: Código de resposta HTTP `content`: Corpo de resposta esperado	`false`

Parâmetros do corpo da solicitação

O corpo da solicitação deve incluir pelo menos um dos seguintes campos:

Parâmetro do corpo	Tipo	necessidade	Descrição
`alertTypeNames`	array de strings	Obrigatório	Tipos de alerta para silenciar durante a janela de manutenção. Por exemplo: `HOST`, `REPLICA_SET`, `CLUSTER`, `AGENT`, `BACKUP`
`startDate`	string	Obrigatório	Timestamp in ISO 8601 date and time format in UTC when the maintenance window starts.
`endDate`	string	Obrigatório	Timestamp in ISO 8601 date and time format in UTC when the maintenance window ends.
`description`	string	Opcional	Descrição do período de manutenção.

Resposta

Nome	Tipo	Descrição
`id`	string	Identificador único do período de manutenção.
`groupId`	string	Identificador único do projeto ao qual este período de manutenção se aplica.
`created`	string	Timestamp in ISO 8601 date and time format in UTC when the maintenance window was created.
`updated`	string	Timestamp in ISO 8601 date and time format in UTC when the maintenance window was last updated.
`startDate`	string	Timestamp in ISO 8601 date and time format in UTC when the maintenance window starts.
`endDate`	string	Timestamp in ISO 8601 date and time format in UTC when the maintenance window ends.
`alertTypeNames`	array de strings	Tipos de alerta para silenciar durante a janela de manutenção. Por exemplo: `HOST`, `REPLICA_SET`, `CLUSTER`, `AGENT`, `BACKUP`
`description`	string	Descrição do período de manutenção. Este campo aparece apenas se você fornecer uma descrição do período de manutenção.

Exemplo de solicitação

1curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \2     --header "Accept: application/json" \3     --header "Content-Type: application/json" \4     --include \5     --request PATCH "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{PROJECT-ID}/maintenanceWindows/{MW-ID}" \6     --data '7       {8         "alertTypeNames" : [ "HOST", "REPLICA_SET" ]9       }'

Exemplo de resposta

Cabeçalho de resposta

HTTP/1.1 401 UnauthorizedContent-Type: application/json;charset=ISO-8859-1Date: {dateInUnixFormat}WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=falseContent-Length: {requestLengthInBytes}Connection: keep-alive

HTTP/1.1 201 CreatedVary: Accept-EncodingContent-Type: application/jsonStrict-Transport-Security: max-age=300Date: {dateInUnixFormat}Connection: keep-aliveContent-Length: {requestLengthInBytes}X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}

Corpo de resposta

1{2  "alertTypeNames" : [ "HOST", "REPLICA_SET" ],3  "created" : "2015-10-22T20:49:35Z",4  "description" : "my description",5  "endDate" : "2015-10-23T23:30:00Z",6  "groupId" : "{PROJECT-ID}",7  "id" : "56294bdfd4c643eef5176b73",8  "startDate" : "2015-10-23T22:00:00Z",9  "updated" : "2015-10-22T20:49:35Z",10  "links" : []11}

Voltar

criar

Excluir