diff --git a/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/ResourceHealth.json b/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/ResourceHealth.json new file mode 100644 index 000000000000..03cfb60fdfef --- /dev/null +++ b/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/ResourceHealth.json @@ -0,0 +1,1514 @@ +{ + "swagger": "2.0", + "info": { + "version": "2022-05-01", + "title": "Microsoft.ResourceHealth", + "description": "The Resource Health Client." + }, + "host": "management.azure.com", + "schemes": [ + "https" + ], + "produces": [ + "application/json" + ], + "security": [ + { + "azure_auth": [ + "user_impersonation" + ] + } + ], + "securityDefinitions": { + "azure_auth": { + "type": "oauth2", + "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize", + "flow": "implicit", + "description": "Azure Active Directory OAuth2 Flow", + "scopes": { + "user_impersonation": "impersonate your user account" + } + } + }, + "paths": { + "/subscriptions/{subscriptionId}/providers/Microsoft.ResourceHealth/availabilityStatuses": { + "get": { + "tags": [ + "AvailabilityStatuses" + ], + "operationId": "AvailabilityStatuses_ListBySubscriptionId", + "description": "Lists the current availability status for all the resources in the subscription.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "#/parameters/FilterParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "#/parameters/ExpandParameter" + } + ], + "responses": { + "200": { + "description": "The list of current availability status for all the resources in the subscription", + "schema": { + "$ref": "#/definitions/availabilityStatusListResult" + } + }, + "default": { + "description": "DefaultErrorResponse", + "schema": { + "$ref": "#/definitions/ErrorResponse" + } + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + }, + "x-ms-examples": { + "ListHealthBySubscriptionId": { + "$ref": "./examples/AvailabilityStatuses_ListBySubscriptionId.json" + } + } + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ResourceHealth/availabilityStatuses": { + "get": { + "tags": [ + "AvailabilityStatuses" + ], + "operationId": "AvailabilityStatuses_ListByResourceGroup", + "description": "Lists the current availability status for all the resources in the resource group.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "#/parameters/ResourceGroupNameParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "#/parameters/FilterParameter" + }, + { + "$ref": "#/parameters/ExpandParameter" + } + ], + "responses": { + "200": { + "description": "The list of current availability status for all the resources in the resource group", + "schema": { + "$ref": "#/definitions/availabilityStatusListResult" + } + }, + "default": { + "description": "DefaultErrorResponse", + "schema": { + "$ref": "#/definitions/ErrorResponse" + } + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + }, + "x-ms-examples": { + "ListByResourceGroup": { + "$ref": "./examples/AvailabilityStatuses_ListByResourceGroup.json" + } + } + } + }, + "/providers/Microsoft.ResourceHealth/operations": { + "get": { + "tags": [ + "Operations" + ], + "operationId": "Operations_List", + "description": "Lists available operations for the resourcehealth resource provider", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter" + } + ], + "responses": { + "200": { + "description": "The list of available operations for the resourcehealth resource provider", + "schema": { + "$ref": "#/definitions/operationListResult" + } + }, + "default": { + "description": "DefaultErrorResponse", + "schema": { + "$ref": "#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "GetOperationsList": { + "$ref": "./examples/Operations_List.json" + } + } + } + }, + "/{resourceUri}/providers/Microsoft.ResourceHealth/availabilityStatuses/current": { + "get": { + "tags": [ + "AvailabilityStatuses" + ], + "operationId": "AvailabilityStatuses_GetByResource", + "description": "Gets current availability status for a single resource", + "parameters": [ + { + "name": "resourceUri", + "in": "path", + "required": true, + "type": "string", + "description": "The fully qualified ID of the resource, including the resource name and resource type. Currently the API support not nested and one nesting level resource types : /subscriptions/{subscriptionId}/resourceGroups/{resource-group-name}/providers/{resource-provider-name}/{resource-type}/{resource-name} and /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resource-provider-name}/{parentResourceType}/{parentResourceName}/{resourceType}/{resourceName}", + "x-ms-skip-url-encoding": true + }, + { + "$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "#/parameters/FilterParameter" + }, + { + "$ref": "#/parameters/ExpandParameter" + } + ], + "responses": { + "200": { + "description": "The current availability status for a single resource", + "schema": { + "$ref": "#/definitions/availabilityStatus" + } + }, + "default": { + "description": "DefaultErrorResponse", + "schema": { + "$ref": "#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "GetCurrentHealthByResource": { + "$ref": "./examples/AvailabilityStatus_GetByResource.json" + } + } + } + }, + "/{resourceUri}/providers/Microsoft.ResourceHealth/availabilityStatuses": { + "get": { + "tags": [ + "AvailabilityStatuses" + ], + "operationId": "AvailabilityStatuses_List", + "description": "Lists all historical availability transitions and impacting events for a single resource.", + "parameters": [ + { + "name": "resourceUri", + "in": "path", + "required": true, + "type": "string", + "description": "The fully qualified ID of the resource, including the resource name and resource type. Currently the API support not nested and one nesting level resource types : /subscriptions/{subscriptionId}/resourceGroups/{resource-group-name}/providers/{resource-provider-name}/{resource-type}/{resource-name} and /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resource-provider-name}/{parentResourceType}/{parentResourceName}/{resourceType}/{resourceName}", + "x-ms-skip-url-encoding": true + }, + { + "$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "#/parameters/FilterParameter" + }, + { + "$ref": "#/parameters/ExpandParameter" + } + ], + "responses": { + "200": { + "description": "The list of historical availability statuses for a single resource", + "schema": { + "$ref": "#/definitions/availabilityStatusListResult" + } + }, + "default": { + "description": "DefaultErrorResponse", + "schema": { + "$ref": "#/definitions/ErrorResponse" + } + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + }, + "x-ms-examples": { + "GetHealthHistoryByResource": { + "$ref": "./examples/AvailabilityStatuses_List.json" + } + } + } + }, + "/subscriptions/{subscriptionId}/providers/Microsoft.ResourceHealth/events/{eventTrackingId}/impactedResources": { + "get": { + "tags": [ + "EventImpactedResources" + ], + "operationId": "ImpactedResources_ListBySubscriptionIdAndEventId", + "description": "Lists impacted resources in the subscription by an event.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "#/parameters/EventTrackingIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "#/parameters/FilterParameter" + } + ], + "responses": { + "200": { + "description": "The list of impacted resources in the subscription by an event.", + "schema": { + "$ref": "#/definitions/eventImpactedResourceListResult" + } + }, + "default": { + "description": "DefaultErrorResponse", + "schema": { + "$ref": "#/definitions/ErrorResponse" + } + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + }, + "x-ms-examples": { + "ListImpactedResourcesBySubscriptionId": { + "$ref": "./examples/ImpactedResources_ListBySubscriptionId_ListByEventId.json" + } + } + } + }, + "/subscriptions/{subscriptionId}/providers/Microsoft.ResourceHealth/events/{eventTrackingId}/impactedResources/{impactedResourceName}": { + "get": { + "tags": [ + "EventImpactedResources" + ], + "operationId": "ImpactedResources_Get", + "description": "Gets the specific impacted resource in the subscription by an event.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "#/parameters/EventTrackingIdParameter" + }, + { + "$ref": "#/parameters/ImpactedResourceNameParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter" + } + ], + "responses": { + "200": { + "description": "The details of Impacted Resource.", + "schema": { + "$ref": "#/definitions/eventImpactedResource" + } + }, + "default": { + "description": "DefaultErrorResponse", + "schema": { + "$ref": "#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "ImpactedResourcesGet": { + "$ref": "./examples/ImpactedResources_Get.json" + } + } + } + }, + "/subscriptions/{subscriptionId}/providers/Microsoft.ResourceHealth/events": { + "get": { + "tags": [ + "Events" + ], + "operationId": "Events_ListBySubscriptionId", + "description": "Lists service health events in the subscription.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "#/parameters/FilterParameter" + }, + { + "$ref": "#/parameters/QueryStartTimeParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter" + } + ], + "responses": { + "200": { + "description": "The list of current service health events in the subscription", + "schema": { + "$ref": "#/definitions/events" + } + }, + "default": { + "description": "DefaultErrorResponse", + "schema": { + "$ref": "#/definitions/ErrorResponse" + } + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + }, + "x-ms-examples": { + "ListEventsBySubscriptionId": { + "$ref": "./examples/Events_ListBySubscriptionId.json" + } + } + } + }, + "/subscriptions/{subscriptionId}/providers/Microsoft.ResourceHealth/events/{eventTrackingId}": { + "get": { + "tags": [ + "Event" + ], + "operationId": "Event_GetBySubscriptionIdAndTrackingId", + "description": "Service health event in the subscription by event tracking id", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "#/parameters/FilterParameter" + }, + { + "$ref": "#/parameters/QueryStartTimeParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "#/parameters/EventTrackingIdParameter" + } + ], + "responses": { + "200": { + "description": "Service Health Event in the subscription requested by tracking id.", + "schema": { + "$ref": "#/definitions/event" + } + }, + "default": { + "description": "DefaultErrorResponse", + "schema": { + "$ref": "#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "SecurityAdvisoriesEventBySubscriptionIdAndTrackingId": { + "$ref": "./examples/Event_GetBySubscriptionIdAndTrackingId.json" + } + } + } + }, + "/providers/Microsoft.ResourceHealth/events": { + "get": { + "tags": [ + "Events" + ], + "operationId": "Events_ListByTenantId", + "description": "Lists current service health events in the tenant.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "#/parameters/FilterParameter" + }, + { + "$ref": "#/parameters/QueryStartTimeParameter" + } + ], + "responses": { + "200": { + "description": "The list of service health events in the tenant", + "schema": { + "$ref": "#/definitions/events" + } + }, + "default": { + "description": "DefaultErrorResponse", + "schema": { + "$ref": "#/definitions/ErrorResponse" + } + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + }, + "x-ms-examples": { + "ListEventsByTenantId": { + "$ref": "./examples/Events_ListByTenantId.json" + } + } + } + }, + "/providers/Microsoft.ResourceHealth/events/{eventTrackingId}": { + "get": { + "tags": [ + "Event" + ], + "operationId": "Event_GetByTenantIdAndTrackingId", + "description": "Service health event in the tenant by event tracking id", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "#/parameters/FilterParameter" + }, + { + "$ref": "#/parameters/QueryStartTimeParameter" + }, + { + "$ref": "#/parameters/EventTrackingIdParameter" + } + ], + "responses": { + "200": { + "description": "Service Health Event in the subscription requested by tracking id.", + "schema": { + "$ref": "#/definitions/event" + } + }, + "default": { + "description": "DefaultErrorResponse", + "schema": { + "$ref": "#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "EventByTenantIdAndTrackingId": { + "$ref": "./examples/Event_GetByTenantIdAndTrackingId.json" + } + } + } + }, + "/{resourceUri}/providers/Microsoft.ResourceHealth/events": { + "get": { + "tags": [ + "Events" + ], + "operationId": "Events_ListBySingleResource", + "description": "Lists current service health events for given resource.", + "parameters": [ + { + "name": "resourceUri", + "in": "path", + "required": true, + "type": "string", + "description": "The fully qualified ID of the resource, including the resource name and resource type. Currently the API support not nested and one nesting level resource types : /subscriptions/{subscriptionId}/resourceGroups/{resource-group-name}/providers/{resource-provider-name}/{resource-type}/{resource-name} and /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resource-provider-name}/{parentResourceType}/{parentResourceName}/{resourceType}/{resourceName}", + "x-ms-skip-url-encoding": true + }, + { + "$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "#/parameters/FilterParameter" + } + ], + "responses": { + "200": { + "description": "The list of current service health events for given resource", + "schema": { + "$ref": "#/definitions/events" + } + }, + "default": { + "description": "DefaultErrorResponse", + "schema": { + "$ref": "#/definitions/ErrorResponse" + } + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + }, + "x-ms-examples": { + "ListEventsBySingleResource": { + "$ref": "./examples/Events_ListBySingleResource.json" + } + } + } + } + }, + "definitions": { + "events": { + "type": "object", + "properties": { + "value": { + "type": "array", + "x-ms-identifiers": [], + "items": { + "$ref": "#/definitions/event" + }, + "description": "The list of event." + }, + "nextLink": { + "type": "string", + "description": "The URI to fetch the next page of events. Call ListNext() with this URI to fetch the next page of events." + } + }, + "required": [ + "value" + ], + "description": "The List events operation response." + }, + "event": { + "type": "object", + "description": "Service health event", + "properties": { + "properties": { + "x-ms-client-flatten": true, + "type": "object", + "description": "Properties of event.", + "properties": { + "eventType": { + "type": "string", + "description": "Type of event.", + "enum": [ + "ServiceIssue", + "PlannedMaintenance", + "HealthAdvisory", + "RCA", + "EmergingIssues", + "SecurityAdvisory" + ], + "x-ms-enum": { + "name": "EventTypeValues", + "modelAsString": true + } + }, + "eventSource": { + "type": "string", + "description": "Source of event.", + "enum": [ + "ResourceHealth", + "ServiceHealth" + ], + "x-ms-enum": { + "name": "EventSourceValues", + "modelAsString": true + } + }, + "status": { + "type": "string", + "description": "Current status of event.", + "enum": [ + "Active", + "Resolved" + ], + "x-ms-enum": { + "name": "EventStatusValues", + "modelAsString": true + } + }, + "title": { + "type": "string", + "description": "Title text of event." + }, + "summary": { + "type": "string", + "description": "Summary text of event." + }, + "header": { + "type": "string", + "description": "Header text of event." + }, + "level": { + "type": "string", + "description": "Level of insight.", + "enum": [ + "Critical", + "Warning" + ], + "x-ms-enum": { + "name": "LevelValues", + "modelAsString": true + } + }, + "eventLevel": { + "type": "string", + "description": "Level of event.", + "enum": [ + "Critical", + "Error", + "Warning", + "Informational" + ], + "x-ms-enum": { + "name": "EventLevelValues", + "modelAsString": true + } + }, + "externalIncidentId": { + "type": "string", + "description": "The id of the Incident" + }, + "article": { + "type": "object", + "description": "Article of event.", + "properties": { + "articleContent": { + "type": "string", + "description": "Article content of event." + } + } + }, + "links": { + "type": "array", + "x-ms-identifiers": [], + "description": "Useful links of event.", + "items": { + "$ref": "#/definitions/link" + } + }, + "impactStartTime": { + "type": "string", + "description": "It provides the Timestamp for when the health impacting event started.", + "format": "date-time" + }, + "impactMitigationTime": { + "type": "string", + "description": "It provides the Timestamp for when the health impacting event resolved.", + "format": "date-time" + }, + "impact": { + "type": "array", + "x-ms-identifiers": [], + "description": "List services impacted by the service health event.", + "items": { + "$ref": "#/definitions/impact" + } + }, + "recommendedActions": { + "type": "object", + "description": "Recommended actions of event.", + "properties": { + "message": { + "type": "string", + "description": "Recommended action title for the service health event." + }, + "actions": { + "type": "array", + "x-ms-identifiers": [], + "description": "Recommended actions for the service health event.", + "items": { + "type": "object", + "description": "Recommended action for the service health event.", + "properties": { + "groupId": { + "type": "integer", + "format": "int32", + "description": "Recommended action group Id for the service health event." + }, + "actionText": { + "type": "string", + "description": "Recommended action text" + } + } + } + }, + "localeCode": { + "type": "string", + "description": "Recommended action locale for the service health event." + } + } + }, + "faqs": { + "type": "array", + "x-ms-identifiers": [], + "description": "Frequently asked questions for the service health event.", + "items": { + "$ref": "#/definitions/faq" + } + }, + "isHIR": { + "type": "boolean", + "description": "It provides information if the event is High incident rate event or not." + }, + "enableMicrosoftSupport": { + "type": "boolean", + "description": "Tells if we want to enable or disable Microsoft Support for this event." + }, + "description": { + "type": "string", + "description": "Contains the communication message for the event, that could include summary, root cause and other details." + }, + "platformInitiated": { + "type": "boolean", + "description": "Is true if the event is platform initiated." + }, + "enableChatWithUs": { + "type": "boolean", + "description": "Tells if we want to enable or disable Microsoft Support for this event." + }, + "priority": { + "type": "integer", + "format": "int32", + "description": "Priority level of the event. Has value from 0 to 23. 0 is the highest priority. Service issue events have higher priority followed by planned maintenance and health advisory. Critical events have higher priority followed by error, warning and informational. Furthermore, active events have higher priority than resolved." + }, + "lastUpdateTime": { + "type": "string", + "description": "It provides the Timestamp for when the health impacting event was last updated.", + "format": "date-time" + }, + "hirStage": { + "type": "string", + "description": "Stage for HIR Document" + }, + "additionalInformation": { + "type": "object", + "description": "Additional information", + "properties": { + "message": { + "type": "string", + "description": "Additional information Message" + } + } + }, + "duration": { + "type": "integer", + "description": "duration in seconds", + "format": "int32" + }, + "impactType": { + "type": "string", + "description": "The type of the impact" + } + } + } + }, + "allOf": [ + { + "$ref": "../../../../../common-types/resource-management/v3/types.json#/definitions/ProxyResource" + } + ] + }, + "link": { + "type": "object", + "description": "Useful links for service health event.", + "properties": { + "type": { + "type": "string", + "description": "Type of link.", + "enum": [ + "Button", + "Hyperlink" + ], + "x-ms-enum": { + "name": "LinkTypeValues", + "modelAsString": true + } + }, + "displayText": { + "type": "object", + "description": "Display text of link.", + "properties": { + "value": { + "type": "string", + "description": "Display text of link." + }, + "localizedValue": { + "type": "string", + "description": "Localized display text of link." + } + } + }, + "extensionName": { + "type": "string", + "description": "It provides the name of portal extension to produce link for given service health event." + }, + "bladeName": { + "type": "string", + "description": "It provides the name of portal extension blade to produce link for given service health event." + }, + "parameters": { + "type": "object", + "description": "It provides a map of parameter name and value for portal extension blade to produce lik for given service health event." + } + } + }, + "impact": { + "type": "object", + "description": "Azure service impacted by the service health event.", + "properties": { + "impactedService": { + "type": "string", + "description": "Impacted service name." + }, + "impactedRegions": { + "type": "array", + "x-ms-identifiers": [], + "description": "List regions impacted by the service health event.", + "items": { + "$ref": "#/definitions/impactedServiceRegion" + } + } + } + }, + "impactedServiceRegion": { + "type": "object", + "description": "Azure region impacted by the service health event.", + "properties": { + "impactedRegion": { + "type": "string", + "description": "Impacted region name." + }, + "status": { + "type": "string", + "description": "Current status of event in the region.", + "enum": [ + "Active", + "Resolved" + ], + "x-ms-enum": { + "name": "EventStatusValues", + "modelAsString": true + } + }, + "impactedSubscriptions": { + "type": "array", + "x-ms-identifiers": [], + "description": "List subscription impacted by the service health event.", + "items": { + "type": "string", + "description": "Subscription impacted by the service health event." + } + }, + "impactedTenants": { + "type": "array", + "x-ms-identifiers": [], + "description": "List tenant impacted by the service health event.", + "items": { + "type": "string", + "description": "Tenant impacted by the service health event." + } + }, + "lastUpdateTime": { + "type": "string", + "description": "It provides the Timestamp for when the last update for the service health event.", + "format": "date-time" + }, + "updates": { + "type": "array", + "x-ms-identifiers": [], + "description": "List of updates for given service health event.", + "items": { + "$ref": "#/definitions/update" + } + } + } + }, + "update": { + "type": "object", + "description": "Update for service health event.", + "properties": { + "summary": { + "type": "string", + "description": "Summary text for the given update for the service health event." + }, + "updateDateTime": { + "type": "string", + "description": "It provides the Timestamp for the given update for the service health event.", + "format": "date-time" + } + } + }, + "faq": { + "type": "object", + "description": "Frequently asked question for the service health event", + "properties": { + "question": { + "type": "string", + "description": "FAQ question for the service health event." + }, + "answer": { + "type": "string", + "description": "FAQ answer for the service health event." + }, + "localeCode": { + "type": "string", + "description": "FAQ locale for the service health event." + } + } + }, + "impactedResourceStatus": { + "type": "object", + "description": "impactedResource with health status", + "properties": { + "properties": { + "x-ms-client-flatten": true, + "type": "object", + "description": "Properties of impacted resource status.", + "properties": { + "availabilityState": { + "type": "string", + "description": "Impacted resource status of the resource.", + "enum": [ + "Available", + "Unavailable", + "Degraded", + "Unknown" + ], + "x-ms-enum": { + "name": "AvailabilityStateValues", + "modelAsString": true + } + }, + "title": { + "type": "string", + "description": "Title description of the impacted resource status." + }, + "summary": { + "type": "string", + "description": "Summary description of the impacted resource status." + }, + "reasonType": { + "type": "string", + "description": "When the resource's availabilityState is Unavailable, it describes where the health impacting event was originated.", + "enum": [ + "Unplanned", + "Planned", + "UserInitiated" + ], + "x-ms-enum": { + "name": "ReasonTypeValues", + "modelAsString": true + } + }, + "occurredTime": { + "type": "string", + "description": "Timestamp for when last change in health status occurred.", + "format": "date-time" + } + } + } + }, + "allOf": [ + { + "$ref": "../../../../../common-types/resource-management/v3/types.json#/definitions/ProxyResource" + } + ] + }, + "availabilityStatusListResult": { + "type": "object", + "properties": { + "value": { + "type": "array", + "items": { + "$ref": "#/definitions/availabilityStatus" + }, + "description": "The list of availabilityStatuses." + }, + "nextLink": { + "type": "string", + "description": "The URI to fetch the next page of availabilityStatuses. Call ListNext() with this URI to fetch the next page of availabilityStatuses." + } + }, + "required": [ + "value" + ], + "description": "The List availabilityStatus operation response." + }, + "availabilityStatus": { + "type": "object", + "description": "availabilityStatus of a resource.", + "properties": { + "id": { + "type": "string", + "description": "Azure Resource Manager Identity for the availabilityStatuses resource." + }, + "name": { + "type": "string", + "description": "current." + }, + "type": { + "type": "string", + "description": "Microsoft.ResourceHealth/AvailabilityStatuses." + }, + "location": { + "type": "string", + "description": "Azure Resource Manager geo location of the resource." + }, + "properties": { + "type": "object", + "description": "Properties of availability state.", + "properties": { + "availabilityState": { + "type": "string", + "description": "Availability status of the resource. When it is null, this availabilityStatus object represents an availability impacting event", + "enum": [ + "Available", + "Unavailable", + "Degraded", + "Unknown" + ], + "x-ms-enum": { + "name": "AvailabilityStateValues", + "modelAsString": true + } + }, + "title": { + "type": "string", + "description": "Title description of the availability status." + }, + "summary": { + "type": "string", + "description": "Summary description of the availability status." + }, + "detailedStatus": { + "type": "string", + "description": "Details of the availability status." + }, + "reasonType": { + "type": "string", + "description": "When the resource's availabilityState is Unavailable, it describes where the health impacting event was originated. Examples are planned, unplanned, user initiated or an outage etc." + }, + "rootCauseAttributionTime": { + "type": "string", + "description": "When the resource's availabilityState is Unavailable, it provides the Timestamp for when the health impacting event was received.", + "format": "date-time" + }, + "healthEventType": { + "type": "string", + "description": "In case of an availability impacting event, it describes when the health impacting event was originated. Examples are Lifecycle, Downtime, Fault Analysis etc." + }, + "healthEventCause": { + "type": "string", + "description": "In case of an availability impacting event, it describes where the health impacting event was originated. Examples are PlatformInitiated, UserInitiated etc." + }, + "healthEventCategory": { + "type": "string", + "description": "In case of an availability impacting event, it describes the category of a PlatformInitiated health impacting event. Examples are Planned, Unplanned etc." + }, + "healthEventId": { + "type": "string", + "description": "It is a unique Id that identifies the event" + }, + "resolutionETA": { + "type": "string", + "description": "When the resource's availabilityState is Unavailable and the reasonType is not User Initiated, it provides the date and time for when the issue is expected to be resolved.", + "format": "date-time" + }, + "occuredTime": { + "type": "string", + "description": "Timestamp for when last change in health status occurred.", + "format": "date-time" + }, + "reasonChronicity": { + "type": "string", + "description": "Chronicity of the availability transition.", + "enum": [ + "Transient", + "Persistent" + ], + "x-ms-enum": { + "name": "reasonChronicityTypes", + "modelAsString": true + } + }, + "reportedTime": { + "type": "string", + "description": "Timestamp for when the health was last checked. ", + "format": "date-time" + }, + "recentlyResolved": { + "type": "object", + "description": "An annotation describing a change in the availabilityState to Available from Unavailable with a reasonType of type Unplanned", + "properties": { + "unavailableOccuredTime": { + "type": "string", + "description": "Timestamp for when the availabilityState changed to Unavailable", + "format": "date-time" + }, + "resolvedTime": { + "type": "string", + "description": "Timestamp when the availabilityState changes to Available.", + "format": "date-time" + }, + "unavailableSummary": { + "type": "string", + "description": "Brief description of cause of the resource becoming unavailable." + } + } + }, + "recommendedActions": { + "type": "array", + "description": "Lists actions the user can take based on the current availabilityState of the resource.", + "items": { + "$ref": "#/definitions/recommendedAction" + }, + "x-ms-identifiers": [ + "action" + ] + }, + "serviceImpactingEvents": { + "type": "array", + "description": "Lists the service impacting events that may be affecting the health of the resource.", + "items": { + "$ref": "#/definitions/serviceImpactingEvent" + }, + "x-ms-identifiers": [ + "correlationId" + ] + } + } + } + } + }, + "operationListResult": { + "type": "object", + "properties": { + "value": { + "type": "array", + "items": { + "$ref": "#/definitions/operation" + }, + "x-ms-identifiers": [ + "name" + ], + "description": "List of operations available in the resourcehealth resource provider." + } + }, + "required": [ + "value" + ], + "description": "Lists the operations response." + }, + "operation": { + "description": "Operation available in the resourcehealth resource provider.", + "type": "object", + "properties": { + "name": { + "type": "string", + "description": "Name of the operation." + }, + "display": { + "type": "object", + "description": "Properties of the operation.", + "properties": { + "provider": { + "type": "string", + "description": "Provider name." + }, + "resource": { + "type": "string", + "description": "Resource name." + }, + "operation": { + "type": "string", + "description": "Operation name." + }, + "description": { + "type": "string", + "description": "Description of the operation." + } + } + } + } + }, + "recommendedAction": { + "type": "object", + "description": "Lists actions the user can take based on the current availabilityState of the resource.", + "properties": { + "action": { + "type": "string", + "description": "Recommended action." + }, + "actionUrl": { + "type": "string", + "description": "Link to the action" + }, + "actionUrlText": { + "type": "string", + "description": "Substring of action, it describes which text should host the action url." + } + } + }, + "serviceImpactingEvent": { + "type": "object", + "description": "Lists the service impacting events that may be affecting the health of the resource.", + "properties": { + "eventStartTime": { + "type": "string", + "description": "Timestamp for when the event started.", + "format": "date-time" + }, + "eventStatusLastModifiedTime": { + "type": "string", + "description": "Timestamp for when event was submitted/detected.", + "format": "date-time" + }, + "correlationId": { + "type": "string", + "description": "Correlation id for the event" + }, + "status": { + "type": "object", + "description": "Status of the service impacting event.", + "properties": { + "value": { + "type": "string", + "description": "Current status of the event" + } + } + }, + "incidentProperties": { + "type": "object", + "description": "Properties of the service impacting event.", + "properties": { + "title": { + "type": "string", + "description": "Title of the incident." + }, + "service": { + "type": "string", + "description": "Service impacted by the event." + }, + "region": { + "type": "string", + "description": "Region impacted by the event." + }, + "incidentType": { + "type": "string", + "description": "Type of Event." + } + } + } + } + }, + "statusBanner": { + "type": "object", + "description": "Banner type of emerging issue.", + "properties": { + "title": { + "type": "string", + "description": "The banner title." + }, + "message": { + "type": "string", + "description": "The details of banner." + }, + "cloud": { + "type": "string", + "description": "The cloud type of this banner." + }, + "lastModifiedTime": { + "type": "string", + "description": "The last time modified on this banner.", + "format": "date-time" + } + } + }, + "impactedRegion": { + "type": "object", + "description": "Object of impacted region.", + "properties": { + "id": { + "type": "string", + "description": "The impacted region id." + }, + "name": { + "type": "string", + "description": "The impacted region name." + } + } + }, + "eventImpactedResourceListResult": { + "type": "object", + "properties": { + "value": { + "type": "array", + "items": { + "$ref": "#/definitions/eventImpactedResource" + }, + "description": "The list of eventImpactedResources." + }, + "nextLink": { + "type": "string", + "description": "The URI to fetch the next page of events. Call ListNext() with this URI to fetch the next page of impacted resource." + } + }, + "required": [ + "value" + ], + "description": "The List of eventImpactedResources operation response." + }, + "eventImpactedResource": { + "type": "object", + "description": "Impacted resource for an event.", + "properties": { + "properties": { + "x-ms-client-flatten": true, + "type": "object", + "description": "Properties of impacted resource.", + "properties": { + "targetResourceType": { + "readOnly": true, + "type": "string", + "description": "Resource type within Microsoft cloud." + }, + "targetResourceId": { + "readOnly": true, + "type": "string", + "description": "Identity for resource within Microsoft cloud." + }, + "targetRegion": { + "readOnly": true, + "type": "string", + "description": "Impacted resource region name." + }, + "info": { + "type": "array", + "items": { + "$ref": "#/definitions/keyValueItem" + }, + "description": "Additional information.", + "x-ms-identifiers": [] + } + } + } + }, + "allOf": [ + { + "$ref": "../../../../../common-types/resource-management/v3/types.json#/definitions/ProxyResource" + } + ] + }, + "keyValueItem": { + "type": "object", + "description": "Key value tuple.", + "properties": { + "key": { + "readOnly": true, + "type": "string", + "description": "Key of tuple." + }, + "value": { + "readOnly": true, + "type": "string", + "description": "Value of tuple." + } + } + }, + "ErrorResponse": { + "description": "Error details.", + "type": "object", + "properties": { + "code": { + "description": "The error code.", + "type": "string", + "readOnly": true + }, + "message": { + "description": "The error message.", + "type": "string", + "readOnly": true + }, + "details": { + "description": "The error details.", + "type": "string", + "readOnly": true + } + } + } + }, + "parameters": { + "QueryStartTimeParameter": { + "name": "queryStartTime", + "in": "query", + "required": false, + "type": "string", + "description": "Specifies from when to return events, based on the lastUpdateTime property. For example, queryStartTime = 7/24/2020 OR queryStartTime=7%2F24%2F2020", + "x-ms-parameter-location": "method" + }, + "IssueNameParameter": { + "name": "issueName", + "in": "path", + "description": "The name of the emerging issue.", + "required": true, + "type": "string", + "enum": [ + "default" + ], + "x-ms-enum": { + "name": "IssueNameParameter", + "modelAsString": true + }, + "x-ms-parameter-location": "method" + }, + "ResourceGroupNameParameter": { + "name": "resourceGroupName", + "in": "path", + "required": true, + "type": "string", + "description": "The name of the resource group.", + "x-ms-parameter-location": "method" + }, + "FilterParameter": { + "name": "$filter", + "in": "query", + "required": false, + "type": "string", + "description": "The filter to apply on the operation. For more information please see https://docs.microsoft.com/en-us/rest/api/apimanagement/apis?redirectedfrom=MSDN", + "x-ms-parameter-location": "method" + }, + "ExpandParameter": { + "name": "$expand", + "in": "query", + "required": false, + "type": "string", + "description": "Setting $expand=recommendedactions in url query expands the recommendedactions in the response.", + "x-ms-parameter-location": "method" + }, + "EventTrackingIdParameter": { + "name": "eventTrackingId", + "in": "path", + "required": true, + "type": "string", + "description": "Event Id which uniquely identifies ServiceHealth event.", + "x-ms-parameter-location": "method" + }, + "ImpactedResourceNameParameter": { + "name": "impactedResourceName", + "in": "path", + "description": "Name of the Impacted Resource.", + "required": true, + "type": "string", + "pattern": "^[^*#&+:<>%?]+$", + "x-ms-parameter-location": "method" + } + } +} diff --git a/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/AvailabilityStatus_GetByResource.json b/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/AvailabilityStatus_GetByResource.json new file mode 100644 index 000000000000..61864357e611 --- /dev/null +++ b/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/AvailabilityStatus_GetByResource.json @@ -0,0 +1,41 @@ +{ + "parameters": { + "resourceUri": "resourceUri", + "api-version": "2022-05-01", + "$expand": "recommendedactions" + }, + "responses": { + "200": { + "body": { + "id": "/subscriptions/4abcdefgh-ijkl-mnop-qrstuvwxyz/resourceGroups/rhctestenv/providers/Microsoft.ClassicCompute/virtualMachines /rhctestenvV1PI/providers/Microsoft.ResourceHealth/availabilityStatuses/current", + "name": "current", + "type": "Microsoft.ResourceHealth/AvailabilityStatuses", + "location": "eastus", + "properties": { + "availabilityState": "Unavailable", + "title": "Unavailable", + "summary": "We're sorry, we couldn't automatically recover your virtual machine", + "reasonType": "Unplanned", + "reasonChronicity": "Persistent", + "detailedStatus": "Disk problems are preventing us from automatically recovering your virtual machine", + "occuredTime": "2016-03-29T09:12:00Z", + "reportedTime": "2016-05-04T14:11:29.7598931Z", + "rootCauseAttributionTime": "2016-03-29T09:13:00Z", + "resolutionETA": "2016-03-29T09:37:00Z", + "recommendedActions": [ + { + "action": "To start this virtual machine, open the resource blade and click Start", + "actionUrl": "<#ResourceBlade>", + "actionUrlText": "resource blade" + }, + { + "action": "If you are experiencing problems you believe are caused by Azure, contact support", + "actionUrl": "<#SupportCase>", + "actionUrlText": "contact support" + } + ] + } + } + } + } +} diff --git a/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/AvailabilityStatuses_List.json b/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/AvailabilityStatuses_List.json new file mode 100644 index 000000000000..c37de6307ffb --- /dev/null +++ b/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/AvailabilityStatuses_List.json @@ -0,0 +1,61 @@ +{ + "parameters": { + "resourceUri": "resourceUri", + "api-version": "2022-05-01" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "id": "/subscriptions/4abcdefgh-ijkl-mnop-qrstuvwxyz/resourceGroups/rhctestenv/providers/Microsoft.ClassicCompute/virtualMachines/rhctes tenvV1PI/providers/Microsoft.ResourceHealth/availabilityStatuses/current", + "name": "current", + "type": "Microsoft.ResourceHealth/AvailabilityStatuses", + "location": "eastus", + "properties": { + "availabilityState": "Unavailable", + "title": "Unavailable", + "summary": "We're sorry, we couldn't automatically recover your virtual machine", + "reasonType": "Unplanned", + "reasonChronicity": "Persistent", + "detailedStatus": "Disk problems are preventing us from automatically recovering your virtual machine", + "occuredTime": "2016-03-29T09:12:00Z", + "reportedTime": "2016-05-04T14:11:29.7598931Z", + "rootCauseAttributionTime": "2016-03-29T09:13:00Z", + "resolutionETA": "2016-03-29T09:37:00Z", + "serviceImpactingEvents": [ + { + "eventStartTime": "2016-05-02T19:23:13.7115125Z", + "eventStatusLastModifiedTime": "2016-05-02T19:27:04.9543491Z", + "correlationId": "b56d0180-2d6c-4f7b-b750-c1eca681874c", + "status": { + "value": "Resolved" + }, + "incidentProperties": { + "title": "Virtual Machines - West Europe [West Europe]", + "service": "Virtual Machines", + "region": "East US", + "incidentType": "outage" + } + } + ] + } + }, + { + "id": "/subscriptions/4abcdefgh-ijkl-mnop-qrstuvwxyz/resourceGroups/rhctestenv/providers/Microsoft.ClassicCompute/virtualMachines/rhctes tenvV1PI/providers/Microsoft.ResourceHealth/availabilityStatuses/2016-03-28+16%3a23%3a00Z", + "name": "2016-03-28+16%3a23%3a00Z", + "type": "Microsoft.ResourceHealth/AvailabilityStatuses", + "location": "eastus", + "properties": { + "availabilityState": "Available", + "summary": "This virtual machine is running normally", + "reasonChronicity": "Persistent", + "detailedStatus": "There aren’t any known Azure platform problems affecting this virtual machine", + "occuredTime": "2016-03-28T16:23:00Z" + } + } + ] + } + } + } +} diff --git a/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/AvailabilityStatuses_ListByResourceGroup.json b/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/AvailabilityStatuses_ListByResourceGroup.json new file mode 100644 index 000000000000..7ba9e3454381 --- /dev/null +++ b/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/AvailabilityStatuses_ListByResourceGroup.json @@ -0,0 +1,75 @@ +{ + "parameters": { + "subscriptionId": "subscriptionId", + "resourceGroupName": "resourceGroupName", + "api-version": "2022-05-01", + "$expand": "recommendedactions" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "id": "/providers/Microsoft.ResourceHealth/AvailabilityStatueses/current", + "name": "current", + "type": "Microsoft.ResourceHealth/AvailabilityStatuses", + "location": "eastus", + "properties": { + "availabilityState": "Available", + "title": "Available", + "summary": "Vm is available", + "reasonType": "Unplanned", + "reasonChronicity": "Persistent", + "detailedStatus": "We have not seen any issues with your virtual machine", + "occuredTime": "2016-03-29T09:12:00Z", + "reportedTime": "2016-05-04T14:11:29.7598931Z", + "recentlyResolved": { + "unavailableOccuredTime": "2017-02-28T00:48:00Z", + "resolvedTime": "2017-02-28T00:49:00Z", + "unavailableSummary": "We are sorry your SQL database is unavailable" + }, + "recommendedActions": [ + { + "action": "To start this virtualmachine, open the resource blade and click Start", + "actionUrl": "<#ResourceBlade>", + "actionUrlText": "resourceblade" + } + ] + } + }, + { + "id": "/providers/Microsoft.ResourceHealth/AvailabilityStatueses/current", + "name": "current", + "type": "Microsoft.ResourceHealth/AvailabilityStatuses", + "location": "eastus", + "properties": { + "availabilityState": "Unavailable", + "title": "Unavailable", + "summary": "We are sorry, we couldn't automatically recovery our virtualmachine", + "reasonType": "Unplanned", + "reasonChronicity": "Persistent", + "detailedStatus": "Diskproblemsarepreventingusfromautomaticallyrecoveringyourvirtualmachine", + "occuredTime": "2016-03-29T09:12:00Z", + "reportedTime": "2016-05-04T14:11:29.7598931Z", + "rootCauseAttributionTime": "2016-03-29T09:13:00Z", + "resolutionETA": "2016-03-29T09:37:00Z", + "recommendedActions": [ + { + "action": "To start this virtualmachine, open the resource blade", + "actionUrl": "<#ResourceBlade>", + "actionUrlText": "resourceblade" + }, + { + "action": "If you are experiencing problems you believe are caused by Azure, contact support", + "actionUrl": "<#SupportCase>", + "actionUrlText": "contactsupport" + } + ] + } + } + ], + "nextLink": "{originalRequestUrl}?$skipToken={OpaquePageNumber}" + } + } + } +} diff --git a/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/AvailabilityStatuses_ListBySubscriptionId.json b/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/AvailabilityStatuses_ListBySubscriptionId.json new file mode 100644 index 000000000000..0427734f85b2 --- /dev/null +++ b/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/AvailabilityStatuses_ListBySubscriptionId.json @@ -0,0 +1,74 @@ +{ + "parameters": { + "subscriptionId": "subscriptionId", + "api-version": "2022-05-01", + "$expand": "recommendedactions" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "id": "/providers/Microsoft.ResourceHealth/AvailabilityStatueses/current", + "name": "current", + "type": "Microsoft.ResourceHealth/AvailabilityStatuses", + "location": "eastus", + "properties": { + "availabilityState": "Available", + "title": "Available", + "summary": "Vm is available", + "reasonType": "Unplanned", + "reasonChronicity": "Persistent", + "detailedStatus": "We have not seen any issues with your virtual machine", + "occuredTime": "2016-03-29T09:12:00Z", + "reportedTime": "2016-05-04T14:11:29.7598931Z", + "recentlyResolved": { + "unavailableOccuredTime": "2017-02-28T00:48:00Z", + "resolvedTime": "2017-02-28T00:49:00Z", + "unavailableSummary": "We are sorry your SQL database is unavailable" + }, + "recommendedActions": [ + { + "action": "To start this virtualmachine, open the resource blade and click Start", + "actionUrl": "<#ResourceBlade>", + "actionUrlText": "resourceblade" + } + ] + } + }, + { + "id": "/providers/Microsoft.ResourceHealth/AvailabilityStatueses/current", + "name": "current", + "type": "Microsoft.ResourceHealth/AvailabilityStatuses", + "location": "eastus", + "properties": { + "availabilityState": "Unavailable", + "title": "Unavailable", + "summary": "We are sorry, we couldn't automatically recovery our virtualmachine", + "reasonType": "Unplanned", + "reasonChronicity": "Persistent", + "detailedStatus": "Diskproblemsarepreventingusfromautomaticallyrecoveringyourvirtualmachine", + "occuredTime": "2016-03-29T09:12:00Z", + "reportedTime": "2016-05-04T14:11:29.7598931Z", + "rootCauseAttributionTime": "2016-03-29T09:13:00Z", + "resolutionETA": "2016-03-29T09:37:00Z", + "recommendedActions": [ + { + "action": "To start this virtualmachine, open the resource blade", + "actionUrl": "<#ResourceBlade>", + "actionUrlText": "resourceblade" + }, + { + "action": "If you are experiencing problems you believe are caused by Azure, contact support", + "actionUrl": "<#SupportCase>", + "actionUrlText": "contactsupport" + } + ] + } + } + ], + "nextLink": "{originalRequestUrl}?$skipToken={OpaquePageNumber}" + } + } + } +} diff --git a/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/Event_GetBySubscriptionIdAndTrackingId.json b/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/Event_GetBySubscriptionIdAndTrackingId.json new file mode 100644 index 000000000000..4a98e38f6ded --- /dev/null +++ b/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/Event_GetBySubscriptionIdAndTrackingId.json @@ -0,0 +1,103 @@ +{ + "parameters": { + "subscriptionId": "subscriptionId", + "eventTrackingId": "eventTrackingId", + "api-version": "2022-05-01", + "$filter": "properties/status eq 'Active'", + "queryStartTime": "7/10/2022" + }, + "responses": { + "200": { + "body": { + "id": "/providers/Microsoft.ResourceHealth/events/{eventTrackingId}", + "name": "{eventTrackingId}", + "type": "/providers/Microsoft.ResourceHealth/events", + "properties": { + "eventType": "ServiceIssue", + "eventSource": "ResourceHealth", + "status": "Active", + "title": "ACTIVE: Virtual machines in West US", + "summary": "An outage alert is being investigated. More information will be provided as it is known.", + "header": "Your service might have been impacted by an Azure service issue", + "article": { + "articleContent": "An outage alert is being investigated. More information will be provided as it is known" + }, + "links": [ + { + "type": "Hyperlink", + "displayText": { + "value": "Request RCA", + "localizedValue": "Request RCA" + }, + "extensionName": "Microsoft_Azure_Health", + "bladeName": "RequestRCABlade", + "parameters": { + "trackingId": "{eventTrackingId}", + "rcaRequested": "False" + } + }, + { + "type": "Button", + "displayText": { + "value": "Sign up for updates", + "localizedValue": "Sign up for updates" + }, + "extensionName": "Microsoft_Azure_Health", + "bladeName": "AzureHealthBrowseBlade", + "parameters": { + "trackingId": "{eventTrackingId}" + } + } + ], + "level": "Warning", + "eventLevel": "Informational", + "impactStartTime": "2018-11-07T00:00:00Z", + "impactMitigationTime": "2018-11-08T00:00:00Z", + "impact": [ + { + "impactedService": "Virtual Machines", + "impactedRegions": [ + { + "impactedRegion": "West US", + "status": "Active", + "impactedSubscriptions": [ + "{subscriptionId}" + ], + "impactedTenants": [], + "lastUpdateTime": "2017-12-05T21:05:00Z" + } + ] + } + ], + "recommendedActions": { + "message": "Recommended actions title", + "actions": [ + { + "groupId": 23243, + "actionText": "action 1" + }, + { + "groupId": 23432, + "actionText": "action 2" + } + ], + "localeCode": "en" + }, + "faqs": [ + { + "question": "This is a question", + "answer": "This is an answer", + "localeCode": "en" + } + ], + "isHIR": false, + "enableMicrosoftSupport": true, + "enableChatWithUs": false, + "priority": 2, + "lastUpdateTime": "2018-11-08T00:00:00Z", + "hirStage": "resolved" + } + } + } + } +} diff --git a/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/Event_GetByTenantIdAndTrackingId.json b/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/Event_GetByTenantIdAndTrackingId.json new file mode 100644 index 000000000000..eac6a40acd56 --- /dev/null +++ b/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/Event_GetByTenantIdAndTrackingId.json @@ -0,0 +1,102 @@ +{ + "parameters": { + "eventTrackingId": "eventTrackingId", + "api-version": "2022-05-01", + "$filter": "properties/status eq 'Active'", + "queryStartTime": "7/10/2022" + }, + "responses": { + "200": { + "body": { + "id": "/providers/Microsoft.ResourceHealth/events/{eventTrackingId}", + "name": "{eventTrackingId}", + "type": "/providers/Microsoft.ResourceHealth/events", + "properties": { + "eventType": "ServiceIssue", + "eventSource": "ResourceHealth", + "status": "Active", + "title": "ACTIVE: Virtual machines in West US", + "summary": "An outage alert is being investigated. More information will be provided as it is known.", + "header": "Your service might have been impacted by an Azure service issue", + "article": { + "articleContent": "An outage alert is being investigated. More information will be provided as it is known" + }, + "links": [ + { + "type": "Hyperlink", + "displayText": { + "value": "Request RCA", + "localizedValue": "Request RCA" + }, + "extensionName": "Microsoft_Azure_Health", + "bladeName": "RequestRCABlade", + "parameters": { + "trackingId": "{eventTrackingId}", + "rcaRequested": "False" + } + }, + { + "type": "Button", + "displayText": { + "value": "Sign up for updates", + "localizedValue": "Sign up for updates" + }, + "extensionName": "Microsoft_Azure_Health", + "bladeName": "AzureHealthBrowseBlade", + "parameters": { + "trackingId": "{eventTrackingId}" + } + } + ], + "level": "Warning", + "eventLevel": "Informational", + "impactStartTime": "2018-11-07T00:00:00Z", + "impactMitigationTime": "2018-11-08T00:00:00Z", + "impact": [ + { + "impactedService": "Virtual Machines", + "impactedRegions": [ + { + "impactedRegion": "West US", + "status": "Active", + "impactedSubscriptions": [], + "impactedTenants": [ + "00000000-0000-0000-0000-000000000000" + ], + "lastUpdateTime": "2017-12-05T21:05:00Z" + } + ] + } + ], + "recommendedActions": { + "message": "Recommended actions title", + "actions": [ + { + "groupId": 23243, + "actionText": "action 1" + }, + { + "groupId": 23432, + "actionText": "action 2" + } + ], + "localeCode": "en" + }, + "faqs": [ + { + "question": "This is a question", + "answer": "This is an answer", + "localeCode": "en" + } + ], + "isHIR": false, + "enableMicrosoftSupport": true, + "enableChatWithUs": false, + "priority": 2, + "lastUpdateTime": "2018-11-08T00:00:00Z", + "hirStage": "resolved" + } + } + } + } +} diff --git a/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/Events_ListBySingleResource.json b/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/Events_ListBySingleResource.json new file mode 100644 index 000000000000..9e867ea5ca92 --- /dev/null +++ b/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/Events_ListBySingleResource.json @@ -0,0 +1,104 @@ +{ + "parameters": { + "resourceUri": "subscriptions/4abcdefgh-ijkl-mnop-qrstuvwxyz/resourceGroups/rhctestenv/providers/Microsoft.Compute/virtualMachines/rhctestenvV1PI", + "api-version": "2022-05-01" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "id": "/providers/Microsoft.ResourceHealth/events/BC_1-FXZ", + "name": "BC_1-FXZ", + "type": "/providers/Microsoft.ResourceHealth/events", + "properties": { + "eventType": "ServiceIssue", + "eventSource": "ResourceHealth", + "status": "Active", + "title": "ACTIVE: Virtual machines in West US", + "summary": "An outage alert is being investigated. More information will be provided as it is known.", + "header": "Your service might have been impacted by an Azure service issue", + "article": { + "articleContent": "An outage alert is being investigated. More information will be provided as it is known" + }, + "links": [ + { + "type": "Hyperlink", + "displayText": { + "value": "Request RCA", + "localizedValue": "Request RCA" + }, + "extensionName": "Microsoft_Azure_Health", + "bladeName": "RequestRCABlade", + "parameters": { + "trackingId": "BC_1-FXZ", + "rcaRequested": "False" + } + }, + { + "type": "Button", + "displayText": { + "value": "Sign up for updates", + "localizedValue": "Sign up for updates" + }, + "extensionName": "Microsoft_Azure_Health", + "bladeName": "AzureHealthBrowseBlade", + "parameters": { + "trackingId": "BC_1-FXZ" + } + } + ], + "level": "Warning", + "eventLevel": "Informational", + "impactStartTime": "2018-11-07T00:00:00Z", + "impactMitigationTime": "2018-11-08T00:00:00Z", + "impact": [ + { + "impactedService": "Virtual Machines", + "impactedRegions": [ + { + "impactedRegion": "West US", + "status": "Active", + "impactedSubscriptions": [ + "{subscriptionId}" + ], + "lastUpdateTime": "2017-12-05T21:05:00Z" + } + ] + } + ], + "recommendedActions": { + "message": "Recommended actions title", + "actions": [ + { + "groupId": 23243, + "actionText": "action 1" + }, + { + "groupId": 23432, + "actionText": "action 2" + } + ], + "localeCode": "en" + }, + "faqs": [ + { + "question": "This is a question", + "answer": "This is an answer", + "localeCode": "en" + } + ], + "isHIR": false, + "enableMicrosoftSupport": true, + "enableChatWithUs": false, + "priority": 2, + "lastUpdateTime": "2018-11-08T00:00:00Z", + "hirStage": "active" + } + } + ], + "nextLink": "{originalRequestUrl}?$skipToken={OpaquePageNumber}" + } + } + } +} diff --git a/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/Events_ListBySubscriptionId.json b/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/Events_ListBySubscriptionId.json new file mode 100644 index 000000000000..6c892f279680 --- /dev/null +++ b/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/Events_ListBySubscriptionId.json @@ -0,0 +1,107 @@ +{ + "parameters": { + "subscriptionId": "subscriptionId", + "api-version": "2022-05-01", + "$filter": "service eq 'Virtual Machines' or region eq 'West US'", + "queryStartTime": "7/24/2020" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "id": "/providers/Microsoft.ResourceHealth/events/BC_1-FXZ", + "name": "BC_1-FXZ", + "type": "/providers/Microsoft.ResourceHealth/events", + "properties": { + "eventType": "ServiceIssue", + "eventSource": "ResourceHealth", + "status": "Active", + "title": "ACTIVE: Virtual machines in West US", + "summary": "An outage alert is being investigated. More information will be provided as it is known.", + "header": "Your service might have been impacted by an Azure service issue", + "article": { + "articleContent": "An outage alert is being investigated. More information will be provided as it is known" + }, + "links": [ + { + "type": "Hyperlink", + "displayText": { + "value": "Request RCA", + "localizedValue": "Request RCA" + }, + "extensionName": "Microsoft_Azure_Health", + "bladeName": "RequestRCABlade", + "parameters": { + "trackingId": "BC_1-FXZ", + "rcaRequested": "False" + } + }, + { + "type": "Button", + "displayText": { + "value": "Sign up for updates", + "localizedValue": "Sign up for updates" + }, + "extensionName": "Microsoft_Azure_Health", + "bladeName": "AzureHealthBrowseBlade", + "parameters": { + "trackingId": "BC_1-FXZ" + } + } + ], + "level": "Warning", + "eventLevel": "Informational", + "impactStartTime": "2018-11-07T00:00:00Z", + "impactMitigationTime": "2018-11-08T00:00:00Z", + "impact": [ + { + "impactedService": "Virtual Machines", + "impactedRegions": [ + { + "impactedRegion": "West US", + "status": "Active", + "impactedSubscriptions": [ + "{subscriptionId}" + ], + "impactedTenants": [], + "lastUpdateTime": "2017-12-05T21:05:00Z" + } + ] + } + ], + "recommendedActions": { + "message": "Recommended actions title", + "actions": [ + { + "groupId": 23243, + "actionText": "action 1" + }, + { + "groupId": 23432, + "actionText": "action 2" + } + ], + "localeCode": "en" + }, + "faqs": [ + { + "question": "This is a question", + "answer": "This is an answer", + "localeCode": "en" + } + ], + "isHIR": false, + "enableMicrosoftSupport": true, + "enableChatWithUs": false, + "priority": 2, + "lastUpdateTime": "2018-11-08T00:00:00Z", + "hirStage": "resolved" + } + } + ], + "nextLink": "{originalRequestUrl}?$skipToken={OpaquePageNumber}" + } + } + } +} diff --git a/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/Events_ListByTenantId.json b/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/Events_ListByTenantId.json new file mode 100644 index 000000000000..3cff70b13b01 --- /dev/null +++ b/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/Events_ListByTenantId.json @@ -0,0 +1,106 @@ +{ + "parameters": { + "api-version": "2022-05-01", + "$filter": "service eq 'Virtual Machines' or region eq 'West US'", + "queryStartTime": "7/24/2020" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "id": "/providers/Microsoft.ResourceHealth/events/BC_1-FXZ", + "name": "BC_1-FXZ", + "type": "/providers/Microsoft.ResourceHealth/events", + "properties": { + "eventType": "ServiceIssue", + "eventSource": "ServiceHealth", + "status": "Active", + "title": "ACTIVE: Virtual machines in West US", + "summary": "An outage alert is being investigated. More information will be provided as it is known.", + "header": "Your service might have been impacted by an Azure service issue", + "article": { + "articleContent": "An outage alert is being investigated. More information will be provided as it is known" + }, + "links": [ + { + "type": "Hyperlink", + "displayText": { + "value": "Request RCA", + "localizedValue": "Request RCA" + }, + "extensionName": "Microsoft_Azure_Health", + "bladeName": "RequestRCABlade", + "parameters": { + "trackingId": "BC_1-FXZ", + "rcaRequested": "False" + } + }, + { + "type": "Button", + "displayText": { + "value": "Sign up for updates", + "localizedValue": "Sign up for updates" + }, + "extensionName": "Microsoft_Azure_Health", + "bladeName": "AzureHealthBrowseBlade", + "parameters": { + "trackingId": "BC_1-FXZ" + } + } + ], + "level": "Warning", + "eventLevel": "Informational", + "impactStartTime": "2018-11-07T00:00:00Z", + "impactMitigationTime": "2018-11-08T00:00:00Z", + "impact": [ + { + "impactedService": "Virtual Machines", + "impactedRegions": [ + { + "impactedRegion": "West US", + "status": "Active", + "impactedSubscriptions": [], + "impactedTenants": [ + "00000000-0000-0000-0000-000000000000" + ], + "lastUpdateTime": "2017-12-05T21:05:00Z" + } + ] + } + ], + "recommendedActions": { + "message": "Recommended actions title", + "actions": [ + { + "groupId": 23243, + "actionText": "action 1" + }, + { + "groupId": 23432, + "actionText": "action 2" + } + ], + "localeCode": "en" + }, + "faqs": [ + { + "question": "This is a question", + "answer": "This is an answer", + "localeCode": "en" + } + ], + "isHIR": false, + "enableMicrosoftSupport": true, + "enableChatWithUs": false, + "priority": 2, + "lastUpdateTime": "2018-11-08T00:00:00Z", + "hirStage": "resolved" + } + } + ], + "nextLink": "{originalRequestUrl}?$skipToken={OpaquePageNumber}" + } + } + } +} diff --git a/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/ImpactedResources_Get.json b/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/ImpactedResources_Get.json new file mode 100644 index 000000000000..6b4c7633c322 --- /dev/null +++ b/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/ImpactedResources_Get.json @@ -0,0 +1,22 @@ +{ + "parameters": { + "subscriptionId": "subscriptionId", + "eventTrackingId": "BC_1-FXZ", + "impactedResourceName": "abc-123-ghj-456", + "api-version": "2022-05-01" + }, + "responses": { + "200": { + "body": { + "id": "/subscriptions/{subscripitionId}/providers/Microsoft.ResourceHealth/events/BC_1-FXZ/impactedResources/abc-123-ghj-456", + "name": "abc-123-ghj-456", + "type": "Microsoft.ResourceHealth/events/impactedResources", + "properties": { + "targetResourceType": "Microsoft.Compute/VirtualMachines", + "targetResourceId": "/subscriptions/4970d23e-ed41-4670-9c19-02a1d2808dd9/resourceGroups/TEST/providers/Microsoft.Compute/virtualMachines/testvm", + "targetRegion": "westus" + } + } + } + } +} diff --git a/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/ImpactedResources_ListBySubscriptionId_ListByEventId.json b/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/ImpactedResources_ListBySubscriptionId_ListByEventId.json new file mode 100644 index 000000000000..08c5cdd6e7d0 --- /dev/null +++ b/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/ImpactedResources_ListBySubscriptionId_ListByEventId.json @@ -0,0 +1,62 @@ +{ + "parameters": { + "subscriptionId": "subscriptionId", + "eventTrackingId": "BC_1-FXZ", + "api-version": "2022-05-01", + "$filter": "targetRegion eq 'westus'" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "id": "/subscriptions/{subscripitionId}/providers/Microsoft.ResourceHealth/events/BC_1-FXZ/impactedResources/abc-123-ghj-456", + "name": "abc-123-ghj-456", + "type": "Microsoft.ResourceHealth/events/impactedResources", + "properties": { + "targetResourceType": "Microsoft.Compute/VirtualMachines", + "targetResourceId": "/subscriptions/4970d23e-ed41-4670-9c19-02a1d2808dd9/resourceGroups/TEST/providers/Microsoft.Compute/virtualMachines/testvm", + "targetRegion": "westus" + } + }, + { + "id": "/subscriptions/{subscripitionId}/providers/Microsoft.ResourceHealth/events/BC_1-FXZ/impactedResources/jkl-901-hgy-445", + "name": "jkl-901-hgy-445", + "type": "Microsoft.ResourceHealth/events/impactedResources", + "properties": { + "info": [ + { + "key": "ContainerGrp", + "value": "xyz" + }, + { + "key": "UserGuid", + "value": "guid" + }, + { + "key": "AplicationID", + "value": "Abc" + }, + { + "key": "UserPrincipalObjectId", + "value": "def" + } + ] + } + }, + { + "id": "/subscriptions/{subscripitionId}/providers/Microsoft.ResourceHealth/events/BC_1-FXZ/impactedResources/wer-345-tyu-789", + "name": "wer-345-tyu-789", + "type": "Microsoft.ResourceHealth/events/impactedResources", + "properties": { + "targetResourceType": "Microsoft.Compute/VirtualMachines", + "targetResourceId": "/subscriptions/4970d23e-ed41-4670-9c19-02a1d2808dd9/resourceGroups/Dev2/providers/Microsoft.Compute/virtualMachines/testvm2", + "targetRegion": "westus" + } + } + ], + "nextLink": "{originalRequestUrl}?$skipToken={OpaquePageNumber}" + } + } + } +} diff --git a/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/Operations_List.json b/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/Operations_List.json new file mode 100644 index 000000000000..34f99c92d988 --- /dev/null +++ b/specification/resourcehealth/resource-manager/Microsoft.ResourceHealth/stable/2022-05-01/examples/Operations_List.json @@ -0,0 +1,163 @@ +{ + "parameters": { + "api-version": "2022-05-01" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "Microsoft.ResourceHealth/Operations/read", + "display": { + "provider": "Microsoft ResourceHealth", + "resource": "Availability Status", + "operation": "Get Operations", + "description": "Get the operations available for the Microsoft ResourceHealth" + } + }, + { + "name": "Microsoft.ResourceHealth/Notifications/read", + "display": { + "provider": "Microsoft ResourceHealth", + "resource": "Notification", + "operation": "Receive notification", + "description": "Receives ARM notifications" + } + }, + { + "name": "Microsoft.ResourceHealth/AvailabilityStatuses/read", + "display": { + "provider": "Microsoft ResourceHealth", + "resource": "Availability Status", + "operation": "Get Availability Statuses", + "description": "Gets the availability statuses for all resources in the specified scope" + } + }, + { + "name": "Microsoft.ResourceHealth/AvailabilityStatuses/current/read", + "display": { + "provider": "Microsoft ResourceHealth", + "resource": "Availability Status", + "operation": "Get Availability Status", + "description": "Gets the availability status for the specified resource" + } + }, + { + "name": "Microsoft.ResourceHealth/events/read", + "display": { + "provider": "Microsoft ResourceHealth", + "resource": "Events", + "operation": "Get Service Health Events", + "description": "Get Service Health Events for given subscription" + } + }, + { + "name": "Microsoft.ResourceHealth/emergingissues/read", + "display": { + "provider": "Microsoft ResourceHealth", + "resource": "Emerging Issues", + "operation": "Get Azure Emerging Issues", + "description": "Get Azure services' emerging issues" + } + }, + { + "name": "Microsoft.ResourceHealth/potentialoutages/read", + "display": { + "provider": "Microsoft ResourceHealth" + } + }, + { + "name": "Microsoft.ResourceHealth/impactedResources/read", + "display": { + "provider": "Microsoft ResourceHealth", + "resource": "Impacted Resources", + "operation": "Get Impacted Resources", + "description": "Get Impacted Resources for given subscription" + } + }, + { + "name": "Microsoft.ResourceHealth/register/action", + "display": { + "provider": "Microsoft ResourceHealth", + "resource": "Registration", + "operation": "Register with the Provider", + "description": "Registers the subscription for the Microsoft ResourceHealth" + } + }, + { + "name": "Microsoft.ResourceHealth/unregister/action", + "display": { + "provider": "Microsoft ResourceHealth", + "resource": "Unregistration", + "operation": "Unregister with the Provider", + "description": "Unregisters the subscription for the Microsoft ResourceHealth" + } + }, + { + "name": "Microsoft.Resourcehealth/healthevent/action", + "display": { + "provider": "Microsoft ResourceHealth", + "resource": "Availability Status", + "operation": "HealthEvent Change", + "description": "Denotes the change in health state for the specified resource" + } + }, + { + "name": "Microsoft.Resourcehealth/healthevent/Activated/action", + "display": { + "provider": "Microsoft ResourceHealth", + "resource": "Health Event", + "operation": "Health Event Activated", + "description": "Denotes the change in health state for the specified resource" + } + }, + { + "name": "Microsoft.Resourcehealth/healthevent/Updated/action", + "display": { + "provider": "Microsoft ResourceHealth", + "resource": "Health Event", + "operation": "Health Event Updated", + "description": "Denotes the change in health state for the specified resource" + } + }, + { + "name": "Microsoft.Resourcehealth/healthevent/Resolved/action", + "display": { + "provider": "Microsoft ResourceHealth", + "resource": "Health Event", + "operation": "Health Event Resolved", + "description": "Denotes the change in health state for the specified resource" + } + }, + { + "name": "Microsoft.Resourcehealth/healthevent/InProgress/action", + "display": { + "provider": "Microsoft ResourceHealth", + "resource": "Health Event", + "operation": "Health Event InProgress", + "description": "Denotes the change in health state for the specified resource" + } + }, + { + "name": "Microsoft.Resourcehealth/healthevent/Pending/action", + "display": { + "provider": "Microsoft ResourceHealth", + "resource": "Health Event", + "operation": "Health Event Pending", + "description": "Denotes the change in health state for the specified resource" + } + }, + { + "name": "Microsoft.ResourceHealth/metadata/read", + "display": { + "provider": "Microsoft ResourceHealth", + "resource": "Metadata", + "operation": "Read Metadata", + "description": "Gets Metadata" + } + } + ] + } + } + } +} diff --git a/specification/resourcehealth/resource-manager/readme.md b/specification/resourcehealth/resource-manager/readme.md index 1a70f0122ee1..5b817cc62b46 100644 --- a/specification/resourcehealth/resource-manager/readme.md +++ b/specification/resourcehealth/resource-manager/readme.md @@ -26,15 +26,23 @@ These are the global settings for the ResourceHealth API. ``` yaml openapi-type: arm -tag: package-2020-05-01 +tag: package-2022-05 ``` +### Tag: package-2022-05 + +These settings apply only when `--tag=package-2022-05` is specified on the command line. + +```yaml $(tag) == 'package-2022-05' +input-file: + - Microsoft.ResourceHealth/stable/2022-05-01/ResourceHealth.json +``` ### Tag: package-preview-2022-05-01 These settings apply only when `--tag=package-2022-05-01-preview` is specified on the command line. -```yaml $(tag) == 'package-preview-2022-05-01' +``` yaml $(tag) == 'package-preview-2022-05-01' input-file: - Microsoft.ResourceHealth/preview/2022-05-01-preview/ResourceHealth.json ``` @@ -228,4 +236,4 @@ java: output-folder: $(azure-libraries-for-java-folder)/sdk/resourcehealth/mgmt-v2020_05_01 regenerate-manager: true generate-interface: true -``` \ No newline at end of file +```