# Azure Cloud Health management API

> Azure Cloud Health management API on Apizie: 33 endpoints (List the operations for the provider, List HealthModel resources by subscription ID, List HealthModel resources by resource group, Get a HealthModel, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:azure-arm-cloudhealth`
- Category: Cloud
- Status: byok
- Source: https://learn.microsoft.com/rest/api/azure/
- Page: https://zieapi.vercel.app/api/cloud/azure-arm-cloudhealth
- OpenAPI: https://zieapi.vercel.app/api/cloud/azure-arm-cloudhealth/openapi.json

Azure Resource Manager API for Cloud Health: manage these Azure resources in your subscription with a Microsoft Entra access token.

## Endpoints

### List the operations for the provider
`GET https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/operations-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |

### List HealthModel resources by subscription ID
`GET https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/health-models-list-by-subscription` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |

### List HealthModel resources by resource group
`GET https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/health-models-list-by-resource-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |

### Get a HealthModel
`GET https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/health-models-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| healthModelName | string | yes | Name of health model resource |

### Create a HealthModel
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/health-models-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| healthModelName | string | yes | Name of health model resource |
| body | object | yes | JSON request body |

### Update a HealthModel
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/health-models-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| healthModelName | string | yes | Name of health model resource |
| body | object | yes | JSON request body |

### Delete a HealthModel
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/health-models-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| healthModelName | string | yes | Name of health model resource |

### List AuthenticationSetting resources by HealthModel
`GET https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/authentication-settings-list-by-health-model` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| healthModelName | string | yes | Name of health model resource |

### Get a AuthenticationSetting
`GET https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/authentication-settings-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| healthModelName | string | yes | Name of health model resource |
| authenticationSettingName | string | yes | Name of the authentication setting. Must be unique within a health model. |

### Create a AuthenticationSetting
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/authentication-settings-create-or-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| healthModelName | string | yes | Name of health model resource |
| authenticationSettingName | string | yes | Name of the authentication setting. Must be unique within a health model. |
| body | object | yes | JSON request body |

### Delete a AuthenticationSetting
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/authentication-settings-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| healthModelName | string | yes | Name of health model resource |
| authenticationSettingName | string | yes | Name of the authentication setting. Must be unique within a health model. |

### List DiscoveryRule resources by HealthModel
`GET https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/discovery-rules-list-by-health-model` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| timestamp | string | no | Timestamp to use for the operation. When specified, the version of the resource at this point in time is retrieved. If not specified, the… |
| healthModelName | string | yes | Name of health model resource |

### Get a DiscoveryRule
`GET https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/discovery-rules-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| healthModelName | string | yes | Name of health model resource |
| discoveryRuleName | string | yes | Name of the discovery rule. Must be unique within a health model. |

### Create a DiscoveryRule
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/discovery-rules-create-or-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| healthModelName | string | yes | Name of health model resource |
| discoveryRuleName | string | yes | Name of the discovery rule. Must be unique within a health model. |
| body | object | yes | JSON request body |

### Delete a DiscoveryRule
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/discovery-rules-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| healthModelName | string | yes | Name of health model resource |
| discoveryRuleName | string | yes | Name of the discovery rule. Must be unique within a health model. |

### List Entity resources by HealthModel
`GET https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/entities-list-by-health-model` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| timestamp | string | no | Timestamp to use for the operation. When specified, the version of the resource at this point in time is retrieved. If not specified, the… |
| healthModelName | string | yes | Name of health model resource |

### Get a Entity
`GET https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/entities-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| healthModelName | string | yes | Name of health model resource |
| entityName | string | yes | Name of the entity. Must be unique within a health model. |

### Create a Entity
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/entities-create-or-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| healthModelName | string | yes | Name of health model resource |
| entityName | string | yes | Name of the entity. Must be unique within a health model. |
| body | object | yes | JSON request body |

### Delete a Entity
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/entities-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| healthModelName | string | yes | Name of health model resource |
| entityName | string | yes | Name of the entity. Must be unique within a health model. |

### Add a data annotation to an entity
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/entities-add-data-annotation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| healthModelName | string | yes | Name of health model resource |
| entityName | string | yes | Name of the entity. Must be unique within a health model. |
| body | object | yes | JSON request body |

### Retrieve data annotations for an entity
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/entities-get-data-annotations` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| healthModelName | string | yes | Name of health model resource |
| entityName | string | yes | Name of the entity. Must be unique within a health model. |
| body | object | yes | JSON request body |

### Retrieve the health state transition history for an entity
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/entities-get-history` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| healthModelName | string | yes | Name of health model resource |
| entityName | string | yes | Name of the entity. Must be unique within a health model. |
| body | object | yes | JSON request body |

### Retrieve the time series history for a signal on an entity
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/entities-get-signal-history` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| healthModelName | string | yes | Name of health model resource |
| entityName | string | yes | Name of the entity. Must be unique within a health model. |
| body | object | yes | JSON request body |

### Get recommended signal configurations for a given Entity (only applicable for Entities representing Azure…
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/entities-get-signal-recommendations` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| healthModelName | string | yes | Name of health model resource |
| entityName | string | yes | Name of the entity. Must be unique within a health model. |

### Ingest a health report for a specific signal on an entity (the entity must already exist)
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/entities-ingest-health-report` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| healthModelName | string | yes | Name of health model resource |
| entityName | string | yes | Name of the entity. Must be unique within a health model. |
| body | object | yes | JSON request body |

### List Relationship resources by HealthModel
`GET https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/relationships-list-by-health-model` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| timestamp | string | no | Timestamp to use for the operation. When specified, the version of the resource at this point in time is retrieved. If not specified, the… |
| healthModelName | string | yes | Name of health model resource |

### Get a Relationship
`GET https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/relationships-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| healthModelName | string | yes | Name of health model resource |
| relationshipName | string | yes | Name of the relationship. Must be unique within a health model. For example, a concatenation of parentEntityName and childEntityName can… |

### Create a Relationship
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/relationships-create-or-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| healthModelName | string | yes | Name of health model resource |
| relationshipName | string | yes | Name of the relationship. Must be unique within a health model. For example, a concatenation of parentEntityName and childEntityName can… |
| body | object | yes | JSON request body |

### Delete a Relationship
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/relationships-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| healthModelName | string | yes | Name of health model resource |
| relationshipName | string | yes | Name of the relationship. Must be unique within a health model. For example, a concatenation of parentEntityName and childEntityName can… |

### List SignalDefinition resources by HealthModel
`GET https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/signal-definitions-list-by-health-model` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| timestamp | string | no | Timestamp to use for the operation. When specified, the version of the resource at this point in time is retrieved. If not specified, the… |
| healthModelName | string | yes | Name of health model resource |

### Get a SignalDefinition
`GET https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/signal-definitions-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| healthModelName | string | yes | Name of health model resource |
| signalDefinitionName | string | yes | Name of the signal definition. Must be unique within a health model. |

### Create a SignalDefinition
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/signal-definitions-create-or-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| healthModelName | string | yes | Name of health model resource |
| signalDefinitionName | string | yes | Name of the signal definition. Must be unique within a health model. |
| body | object | yes | JSON request body |

### Delete a SignalDefinition
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/signal-definitions-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| healthModelName | string | yes | Name of health model resource |
| signalDefinitionName | string | yes | Name of the signal definition. Must be unique within a health model. |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/operations-list" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Azure Cloud Health management API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/cloud:azure-arm-cloudhealth/operations-list with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Azure Cloud Health management API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Azure Cloud Health management itself also needs your own key from azure.com.

### Can AI agents use the Azure Cloud Health management API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:azure-arm-cloudhealth.

### What is the status of the Azure Cloud Health management API?
Needs your own provider key (bring your own key)