다음을 통해 공유


Availability Statuses - Get By Resource

단일 리소스에 대한 현재 가용성 상태를 가져옵니다.

GET https://management.azure.com/{resourceUri}/providers/Microsoft.ResourceHealth/availabilityStatuses/current?api-version=2024-02-01
GET https://management.azure.com/{resourceUri}/providers/Microsoft.ResourceHealth/availabilityStatuses/current?api-version=2024-02-01&$filter={$filter}&$expand={$expand}

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
resourceUri
path True

string

리소스 이름 및 리소스 종류를 포함하여 리소스의 정규화된 ID입니다. 현재 API는 중첩되지 않고 중첩 수준 리소스 종류인 /subscriptions/{subscriptionId}/resourceGroups/{resource-group-name}/providers/{resource-provider-name}/{resource-type}/{resource-name을 지원합니다. } 및 /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resource-provider-name}/{parentResourceType}/{parentResourceName}/{resourceType}/{resourceName}

api-version
query True

string

minLength: 1

이 작업에 사용할 API 버전입니다.

$expand
query

string

url 쿼리에서 $expand=recommendedactions를 설정하면 응답의 권장 동작이 확장됩니다.

$filter
query

string

작업에 적용할 필터입니다. 자세한 내용은 https://docs.microsoft.com/en-us/rest/api/apimanagement/apis?redirectedfrom=MSDN 참조하세요.

응답

Name 형식 Description
200 OK

availabilityStatus

단일 리소스의 현재 가용성 상태

Other Status Codes

ErrorResponse

DefaultErrorResponse

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

GetCurrentHealthByResource

샘플 요청

GET https://management.azure.com/resourceUri/providers/Microsoft.ResourceHealth/availabilityStatuses/current?api-version=2024-02-01&$expand=recommendedactions

샘플 응답

{
  "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",
    "context": "Platform Initiated",
    "category": "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"
      }
    ]
  }
}

정의

Name Description
AvailabilityStateValues

리소스의 영향을 받은 리소스 상태입니다.

availabilityStatus

리소스의 availabilityStatus입니다.

ErrorResponse

오류 세부 정보입니다.

IncidentProperties

이벤트에 영향을 미치는 서비스의 속성입니다.

Properties

가용성 상태의 속성입니다.

reasonChronicityTypes

가용성 전환의 만성.

RecentlyResolved

계획되지 않은 형식의 reasonType을 사용하여 availabilityState를 사용할 수 없음에서 사용 가능으로 변경한 것을 설명하는 주석

recommendedAction

리소스의 현재 availabilityState에 따라 사용자가 수행할 수 있는 작업을 나열합니다.

serviceImpactingEvent

리소스의 상태에 영향을 미칠 수 있는 이벤트에 영향을 주는 서비스를 나열합니다.

Status

서비스에 영향을 미치는 이벤트의 상태입니다.

AvailabilityStateValues

리소스의 영향을 받은 리소스 상태입니다.

Description
Available
Degraded
Unavailable
Unknown

availabilityStatus

리소스의 availabilityStatus입니다.

Name 형식 Description
id

string

availabilityStatuses 리소스에 대한 Azure Resource Manager ID입니다.

location

string

리소스의 Azure Resource Manager 지리적 위치입니다.

name

string

전류.

properties

Properties

가용성 상태의 속성입니다.

type

string

Microsoft.ResourceHealth/AvailabilityStatuses.

ErrorResponse

오류 세부 정보입니다.

Name 형식 Description
code

string

오류 코드입니다.

details

string

오류 세부 정보입니다.

message

string

오류 메시지입니다.

IncidentProperties

이벤트에 영향을 미치는 서비스의 속성입니다.

Name 형식 Description
incidentType

string

이벤트 유형입니다.

region

string

이벤트의 영향을 받는 지역입니다.

service

string

이벤트의 영향을 받는 서비스입니다.

title

string

인시던트 제목입니다.

Properties

가용성 상태의 속성입니다.

Name 형식 Description
articleId

string

아티클 ID

availabilityState

AvailabilityStateValues

리소스의 가용성 상태입니다. null인 경우 이 availabilityStatus 개체는 가용성에 영향을 주는 이벤트를 나타냅니다.

category

string

컨텍스트 필드를 Platform으로 설정하면 이벤트가 계획되었거나 계획되지 않은 경우 이 필드가 반영됩니다. 컨텍스트 필드에 Platform 값이 없으면 이 필드는 무시됩니다.

context

string

이벤트가 생성되면 고객 또는 리소스 플랫폼에 의해 트리거될 수 있으며 이 필드는 이를 보여 줍니다. 이 필드는 이 개체의 범주 필드에 연결됩니다.

detailedStatus

string

가용성 상태에 대한 세부 정보입니다.

healthEventCategory

string

가용성에 영향을 주는 이벤트의 경우 PlatformInitiated 상태 영향 이벤트의 범주를 설명합니다. 예는 계획됨, 계획되지 않은 등입니다.

healthEventCause

string

가용성에 영향을 주는 이벤트의 경우 상태에 영향을 주는 이벤트가 발생한 위치를 설명합니다. 예를 들어 PlatformInitiated, UserInitiated 등이 있습니다.

healthEventId

string

이벤트를 식별하는 고유 ID입니다.

healthEventType

string

가용성에 영향을 주는 이벤트의 경우 상태에 영향을 주는 이벤트가 시작된 시기를 설명합니다. 예를 들어 수명 주기, 가동 중지 시간, 오류 분석 등이 있습니다.

occuredTime

string (date-time)

상태의 마지막 변경이 발생한 경우에 대한 타임스탬프입니다.

reasonChronicity

reasonChronicityTypes

가용성 전환의 만성.

reasonType

string

리소스의 availabilityState를 사용할 수 없는 경우 상태에 영향을 미치는 이벤트가 발생한 위치를 설명합니다. 예를 들어 계획, 계획되지 않은 사용자 시작 또는 중단 등이 있습니다.

recentlyResolved

RecentlyResolved

계획되지 않은 형식의 reasonType을 사용하여 availabilityState를 사용할 수 없음에서 사용 가능으로 변경한 것을 설명하는 주석

recommendedActions

recommendedAction[]

리소스의 현재 availabilityState에 따라 사용자가 수행할 수 있는 작업을 나열합니다.

reportedTime

string (date-time)

상태를 마지막으로 확인한 시간에 대한 타임스탬프입니다.

resolutionETA

string (date-time)

리소스의 availabilityState를 사용할 수 없으며 reasonType이 사용자 시작이 아닌 경우 문제가 해결될 것으로 예상되는 날짜와 시간을 제공합니다.

rootCauseAttributionTime

string (date-time)

리소스의 availabilityState를 사용할 수 없는 경우 상태에 영향을 주는 이벤트가 수신된 시기에 대한 타임스탬프를 제공합니다.

serviceImpactingEvents

serviceImpactingEvent[]

리소스의 상태에 영향을 미칠 수 있는 이벤트에 영향을 주는 서비스를 나열합니다.

summary

string

가용성 상태에 대한 요약 설명입니다.

title

string

가용성 상태에 대한 제목 설명입니다.

reasonChronicityTypes

가용성 전환의 만성.

Description
Persistent
Transient

RecentlyResolved

계획되지 않은 형식의 reasonType을 사용하여 availabilityState를 사용할 수 없음에서 사용 가능으로 변경한 것을 설명하는 주석

Name 형식 Description
resolvedTime

string (date-time)

availabilityState가 사용 가능으로 변경되는 타임스탬프입니다.

unavailableOccuredTime

string (date-time)

availabilityState가 사용할 수 없음으로 변경된 경우의 타임스탬프

unavailableSummary

string

리소스를 사용할 수 없게 되는 원인에 대한 간략한 설명입니다.

recommendedAction

리소스의 현재 availabilityState에 따라 사용자가 수행할 수 있는 작업을 나열합니다.

Name 형식 Description
_ActionUrl.Comment

string

작업에 대한 주석

action

string

권장되는 작업입니다.

actionUrl

string

작업에 연결

actionUrlText

string

작업의 부분 문자열은 작업 URL을 호스트해야 하는 텍스트를 설명합니다.

serviceImpactingEvent

리소스의 상태에 영향을 미칠 수 있는 이벤트에 영향을 주는 서비스를 나열합니다.

Name 형식 Description
correlationId

string

이벤트의 상관 관계 ID

eventStartTime

string (date-time)

이벤트가 시작된 시기에 대한 타임스탬프입니다.

eventStatusLastModifiedTime

string (date-time)

이벤트가 제출/검색된 시간에 대한 타임스탬프입니다.

incidentProperties

IncidentProperties

이벤트에 영향을 미치는 서비스의 속성입니다.

status

Status

서비스에 영향을 미치는 이벤트의 상태입니다.

Status

서비스에 영향을 미치는 이벤트의 상태입니다.

Name 형식 Description
value

string

이벤트의 현재 상태