monitoring.status-pages.create

Publish a status page at {slug}.status.{root}

POST /monitoring/api/status-pagesIAM monitoring:CreateStatusPageChanges state

The slug is the host label, unique across Deutsche Cloud; a few words (ews, www, status, api, …) are reserved. At most 5 pages per organization. The page is public at once; add components with put-components.

Request syntax

POST /monitoring/api/status-pages
{
  "slug": "string",
  "title": "string",
  "description": "string"
}

Request body

  • slugRequired

    string

    The host label: {slug}.status.{root}. 3–63 lower-case letters, digits, dashes; unique across the platform (409 when taken); reserved words (www, status, api, …) are refused with 400

  • titleRequired

    string

    Shown at the top of the page: one line, up to 120 characters

  • descriptionOptional

    string

    Plain text under the title, up to 1000 characters; none when omitted

    May be null.

Response

201 with the page: { id, slug, title, description, url, createdAt, updatedAt }. 400 for a reserved slug; 409 when the address is taken, or (code QuotaExceeded) past the organization’s quota monitoring.status-pages (5 by default, 1 on a trial; a quota can be raised).

A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.

Errors

  • 400The request does not pass the schema above. The body is { "error": …, "issues": […] }, one issue per field.
  • 401No credentials, or an access key that is unknown, revoked or expired.
  • 403The caller's policies do not allow monitoring:CreateStatusPage on this resource. The body names the action and the resource, and the refusal is recorded in the audit log.
  • 404The resource does not exist in your organization.

Examples

The required parameters only, with example values. Replace id and the other placeholders with your own.

dcloud monitoring status-pages create --slug example --title example

Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_monitoring_status-pages_create.