Partilhar via


Event - fetch Billling Communication Details By Subscription Id And Tracking Id

Detalhes do evento de integridade do serviço específicos na assinatura por ID de acompanhamento de eventos. Isso pode ser usado para buscar propriedades confidenciais para o tipo de evento Faturamento.

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.ResourceHealth/events/{eventTrackingId}/fetchBillingCommunicationDetails?api-version=2025-05-01

Parâmetros do URI

Name Em Necessário Tipo Description
eventTrackingId
path True

string

ID do evento, que identifica exclusivamente o evento ServiceHealth.

subscriptionId
path True

string

minLength: 1

A ID da assinatura de destino.

api-version
query True

string

minLength: 1

A versão da API a utilizar para esta operação.

Respostas

Name Tipo Description
200 OK

event

Detalhes do evento de integridade do serviço na assinatura solicitada pela ID de rastreamento.

Other Status Codes

ErrorResponse

DefaultErrorResponse

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation personificar a sua conta de utilizador

Exemplos

BillingEventDetailsBySubscriptionIdAndTrackingId

Pedido de amostra

POST https://management.azure.com/subscriptions/subscriptionId/providers/Microsoft.ResourceHealth/events/eventTrackingId/fetchBillingCommunicationDetails?api-version=2025-05-01

Resposta da amostra

{
  "id": "/providers/Microsoft.ResourceHealth/events/{eventTrackingId}",
  "name": "{eventTrackingId}",
  "type": "/providers/Microsoft.ResourceHealth/events",
  "properties": {
    "eventType": "Billing",
    "eventSubType": "Underbilling",
    "eventSource": "ServiceHealth",
    "status": "Active",
    "title": "Upcoming billing changes to your resources",
    "summary": "Upcoming billing changes to your resources.",
    "header": "Your service might have been impacted by an Azure service issue",
    "article": {
      "articleContent": "<html>Upcoming billing changes to your resources</html>"
    },
    "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": "Warning",
    "isEventSensitive": false,
    "impactStartTime": "2025-06-12T14:45:48.1203530Z",
    "impactMitigationTime": "2025-07-14T15:43:48.1203530Z",
    "impact": [
      {
        "impactedService": "Microsoft Cost Management",
        "impactedServiceGuid": "80853877-1df8-40c2-9c79-44c0d1c95e01",
        "impactedRegions": [
          {
            "impactedRegion": "Global",
            "status": "Active",
            "impactedSubscriptions": [
              "{subscriptionId}"
            ],
            "impactedTenants": [],
            "lastUpdateTime": "2025-05-13T15:43:48.1203530Z",
            "updates": [
              {
                "summary": "Upcoming billing changes to your resources.",
                "updateDateTime": "2025-05-13T15:43:48.1203530Z"
              }
            ]
          }
        ]
      }
    ],
    "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"
      }
    ],
    "newRate": 1,
    "oldRate": 0.88,
    "currencyType": "USD",
    "billingId": "595959",
    "isHIR": false,
    "enableMicrosoftSupport": true,
    "enableChatWithUs": false,
    "priority": 2,
    "lastUpdateTime": "2025-05-13T15:43:48.1203530Z",
    "hirStage": "resolved"
  }
}

Definições

Name Description
Actions

Ações recomendadas para o evento de integridade do serviço.

AdditionalInformation

Informações adicionais

Article

Artigo do evento.

createdByType

O tipo de identidade que criou o recurso.

DisplayText

Exibir texto do link.

ErrorResponse

Detalhes do erro.

event

Evento de estado de funcionamento do serviço

EventLevelValues

Nível do evento.

EventSourceValues

Fonte do evento.

EventStatusValues

Estado atual do evento.

EventSubTypeValues

Subtipo de evento.

EventTypeValues

Tipo de evento.

faq

Perguntas frequentes sobre o evento de integridade do serviço

impact

Serviço do Azure afetado pelo evento de integridade do serviço.

impactedServiceRegion

Região do Azure afetada pelo evento de integridade do serviço.

LevelValues

Nível de perceção.

link

Links úteis para o evento de integridade do serviço.

LinkTypeValues

Tipo de ligação.

RecommendedActions

Ações recomendadas de evento.

systemData

Metadados referentes à criação e última modificação do recurso.

update

Atualização para o evento de integridade do serviço.

Actions

Ações recomendadas para o evento de integridade do serviço.

Name Tipo Description
actionText

string

Texto da ação recomendada

groupId

integer (int32)

Id do grupo de ação recomendado para o evento de integridade do serviço.

AdditionalInformation

Informações adicionais

Name Tipo Description
message

string

Informações adicionais Mensagem

Article

Artigo do evento.

Name Tipo Description
articleContent

string

Conteúdo do artigo do evento.

articleId

string

ID do artigo

parameters

object

Ele fornece um mapa de nome e valor do parâmetro

createdByType

O tipo de identidade que criou o recurso.

Valor Description
Application
Key
ManagedIdentity
User

DisplayText

Exibir texto do link.

Name Tipo Description
localizedValue

string

Texto de exibição localizado do link.

value

string

Exibir texto do link.

ErrorResponse

Detalhes do erro.

Name Tipo Description
code

string

O código de erro.

details

string

Os detalhes do erro.

message

string

A mensagem de erro.

event

Evento de estado de funcionamento do serviço

Name Tipo Description
id

string

ID de recurso totalmente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

O nome do recurso

properties.additionalInformation

AdditionalInformation

Informações adicionais

properties.article

Article

Artigo do evento.

properties.billingId

string

Informações do identificador de faturação.

properties.currencyType

string

Informações sobre o tipo de moeda de faturação. Exemplo: USD, CAD

properties.description

string

Contém a mensagem de comunicação para o evento, que pode incluir resumo, causa raiz e outros detalhes. Use o ponto de extremidade fetchEventDetails para obter a descrição de eventos confidenciais.

properties.duration

integer (int32)

Duração em segundos

properties.enableChatWithUs

boolean

Informa se queremos habilitar ou desabilitar o Suporte da Microsoft para esse evento.

properties.enableMicrosoftSupport

boolean

Informa se queremos habilitar ou desabilitar o Suporte da Microsoft para esse evento.

properties.eventLevel

EventLevelValues

Nível do evento.

properties.eventSource

EventSourceValues

Fonte do evento.

properties.eventSubType

EventSubTypeValues

Subtipo de evento.

properties.eventTags

string[]

Uma lista de tags de metadados associadas ao evento. Os valores possíveis incluem: -Action Recomendado: Você pode exigir ações para evitar possíveis interrupções ou mitigar riscos para seus serviços. Recomenda-se avaliar estas ações e o potencial impacto nos seus serviços.

  • Falso positivo: após investigação, determinamos que seu serviço está íntegro e que os problemas de serviço não afetaram seus serviços conforme comunicado originalmente.
  • PIR preliminar: Para nossos maiores e mais impactantes problemas de serviço, uma Revisão Preliminar de Pós-Incidente (PIR) é publicada geralmente dentro de 72 horas após a mitigação, para resumir o que aprendemos até agora com a investigação ainda em andamento.
  • PIR Final: Para problemas de serviço, uma Revisão Final de Incidente Pós (PIR) pode ser publicada para fornecer detalhes ou aprendizados adicionais. Às vezes, isso exige que concluamos uma retrospetiva interna, geralmente dentro de 14 dias após a mitigação.
properties.eventType

EventTypeValues

Tipo de evento.

properties.externalIncidentId

string

O id do incidente

properties.faqs

faq[]

Perguntas frequentes sobre o evento de integridade do serviço.

properties.header

string

Texto do cabeçalho do evento.

properties.hirStage

string

Estágio para o documento HIR

properties.impact

impact[]

Listar serviços afetados pelo evento de integridade do serviço.

properties.impactMitigationTime

string (date-time)

Ele fornece o carimbo de data/hora para quando o evento com impacto na integridade foi resolvido.

properties.impactStartTime

string (date-time)

Ele fornece o carimbo de data/hora para quando o evento com impacto na integridade foi iniciado.

properties.impactType

string

O tipo de impacto

properties.isEventSensitive

boolean

Se verdadeiro, o evento pode conter dados confidenciais. Use o ponto de extremidade post events/{trackingId}/fetchEventDetails para buscar dados confidenciais, consulte https://learn.microsoft.com/en-us/azure/service-health/security-advisories-elevated-access

properties.isHIR

boolean

Ele fornece informações se o evento é evento de alta taxa de incidentes ou não.

properties.lastUpdateTime

string (date-time)

Ele fornece o carimbo de data/hora para quando o evento com impacto na integridade foi atualizado pela última vez.

properties.level

LevelValues

Nível de perceção.

properties.links

link[]

Links úteis do evento.

properties.newRate

number (double)

Informações de alteração da taxa de faturamento - nova tarifa

properties.oldRate

number (double)

Informações de alteração da taxa de faturamento - tarifa antiga

properties.platformInitiated

boolean

É verdade se o evento for iniciado pela plataforma.

properties.priority

integer (int32)

Nível de prioridade do evento. Tem valor de 0 a 23. 0 é a prioridade máxima. Os eventos de problemas de serviço têm maior prioridade, seguidos de manutenção planejada e aconselhamento de saúde. Os eventos críticos têm maior prioridade, seguidos de erros, avisos e informações. Além disso, os acontecimentos ativos têm maior prioridade do que os resolvidos.

properties.reason

string

O motivo do incidente

properties.recommendedActions

RecommendedActions

Ações recomendadas de evento.

properties.status

EventStatusValues

Estado atual do evento.

properties.summary

string

Texto resumido do evento. Use o ponto de extremidade fetchEventDetails para obter um resumo de eventos confidenciais.

properties.title

string

Texto do título do evento.

systemData

systemData

Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.

type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

EventLevelValues

Nível do evento.

Valor Description
Critical
Error
Informational
Warning

EventSourceValues

Fonte do evento.

Valor Description
ResourceHealth
ServiceHealth

EventStatusValues

Estado atual do evento.

Valor Description
Active
Resolved

EventSubTypeValues

Subtipo de evento.

Valor Description
ForeignExchangeRateChange
MeterIDChanges
Overbilling
PriceChanges
Retirement
TaxChanges
UnauthorizedPartyAbuse
Underbilling

EventTypeValues

Tipo de evento.

Valor Description
Billing
EmergingIssues
HealthAdvisory
PlannedMaintenance
RCA
SecurityAdvisory
ServiceIssue

faq

Perguntas frequentes sobre o evento de integridade do serviço

Name Tipo Description
answer

string

Resposta de FAQ para o evento de integridade do serviço.

localeCode

string

Localidade de perguntas frequentes para o evento de integridade do serviço.

question

string

Pergunta FAQ para o evento de integridade do serviço.

impact

Serviço do Azure afetado pelo evento de integridade do serviço.

Name Tipo Description
impactedRegions

impactedServiceRegion[]

Liste as regiões afetadas pelo evento de integridade do serviço.

impactedService

string

Nome do serviço afetado.

impactedServiceGuid

string

GUID de serviço afetado. Este é o identificador permanente do serviço afetado.

impactedServiceRegion

Região do Azure afetada pelo evento de integridade do serviço.

Name Tipo Description
impactedRegion

string

Nome da região afetada.

impactedSubscriptions

string[]

Listar a assinatura afetada pelo evento de integridade do serviço.

impactedTenants

string[]

Listar locatário afetado pelo evento de integridade do serviço.

lastUpdateTime

string (date-time)

Ele fornece o carimbo de data/hora para quando a última atualização para o evento de integridade do serviço.

status

EventStatusValues

Situação atual do evento na região.

updates

update[]

Lista de atualizações para determinado evento de integridade do serviço. Use o ponto de extremidade fetchEventDetails para obter atualizações de eventos confidenciais.

LevelValues

Nível de perceção.

Valor Description
Critical
Warning

Links úteis para o evento de integridade do serviço.

Name Tipo Description
bladeName

string

Ele fornece o nome da folha de extensão do portal para produzir link para determinado evento de integridade do serviço.

displayText

DisplayText

Exibir texto do link.

extensionName

string

Ele fornece o nome da extensão do portal para produzir link para determinado evento de integridade do serviço.

parameters

object

Ele fornece um mapa de nome de parâmetro e valor para a folha de extensão do portal para produzir lik para determinado evento de integridade do serviço.

type

LinkTypeValues

Tipo de ligação.

LinkTypeValues

Tipo de ligação.

Valor Description
Button
Hyperlink

RecommendedActions

Ações recomendadas de evento.

Name Tipo Description
actions

Actions[]

Ações recomendadas para o evento de integridade do serviço.

localeCode

string

Localidade de ação recomendada para o evento de integridade do serviço.

message

string

Título da ação recomendada para o evento de integridade do serviço.

systemData

Metadados referentes à criação e última modificação do recurso.

Name Tipo Description
createdAt

string (date-time)

O carimbo de data/hora da criação de recursos (UTC).

createdBy

string

A identidade que criou o recurso.

createdByType

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt

string (date-time)

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy

string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.

update

Atualização para o evento de integridade do serviço.

Name Tipo Description
eventTags

string[]

Uma lista de tags de metadados associadas ao evento. Os valores possíveis incluem: -Action Recomendado: Você pode exigir ações para evitar possíveis interrupções ou mitigar riscos para seus serviços. Recomenda-se avaliar estas ações e o potencial impacto nos seus serviços.

  • Falso positivo: após investigação, determinamos que seu serviço está íntegro e que os problemas de serviço não afetaram seus serviços conforme comunicado originalmente.
  • PIR preliminar: Para nossos maiores e mais impactantes problemas de serviço, uma Revisão Preliminar de Pós-Incidente (PIR) é publicada geralmente dentro de 72 horas após a mitigação, para resumir o que aprendemos até agora com a investigação ainda em andamento.
  • PIR Final: Para problemas de serviço, uma Revisão Final de Incidente Pós (PIR) pode ser publicada para fornecer detalhes ou aprendizados adicionais. Às vezes, isso exige que concluamos uma retrospetiva interna, geralmente dentro de 14 dias após a mitigação.
summary

string

Texto de resumo para a atualização fornecida para o evento de integridade do serviço.

updateDateTime

string (date-time)

Ele fornece o carimbo de data/hora para a atualização fornecida para o evento de integridade do serviço.