Obter operação
Namespace: microsoft.graph.partners.billing
Importante
As APIs na versão /beta
no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Observação
Essa API está disponível para parceiros do CSP (Provedor de Soluções na Nuvem) apenas para acessar seus dados de reconciliação cobrados e não faturados para um locatário. Para saber mais sobre o programa CSP, consulte Microsoft Cloud Solution Provider.
Leia as propriedades e as relações de um objeto de operação .
Essa API está disponível nas seguintes implantações nacionais de nuvem.
Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Permissões
Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.
Tipo de permissão | Permissões menos privilegiadas | Permissões privilegiadas mais altas |
---|---|---|
Delegado (conta corporativa ou de estudante) | PartnerBilling.Read.All | Indisponível. |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Aplicativo | PartnerBilling.Read.All | Indisponível. |
Solicitação HTTP
GET /reports/partners/billing/operations/{id}
Parâmetros de consulta opcionais
Esse método não dá suporte a nenhum parâmetro de consulta OData para ajudar a personalizar a resposta. Para obter informações gerais, acesse Parâmetros de consulta OData.
Cabeçalhos de solicitação
Nome | Descrição |
---|---|
Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Corpo da solicitação
Não forneça um corpo de solicitação para esse método.
Resposta
Se uma operação for concluída com êxito, esse método retornará um 200 OK
código de resposta e um objeto microsoft.graph.partners.billing.exportSuccessOperation no corpo da resposta. A propriedade de navegação resourceLocation no corpo da resposta representa o recurso microsoft.graph.partners.billing.manifest para a operação.
Se uma operação falhar, esse método retornará um 200 OK
código de resposta e um objeto microsoft.graph.partners.billing.failedOperation no corpo da resposta.
Se uma operação ainda estiver em execução, esse método retornará um 200 OK
código de resposta e um objeto microsoft.graph.partners.billing.runningOperation no corpo da resposta.
Exemplos
Exemplo 1: Obter a operação bem-sucedida
Solicitação
O exemplo a seguir mostra uma solicitação que retorna um objeto microsoft.graph.partners.billing.exportSuccessOperation .
GET https://graph.microsoft.com/beta/reports/partners/billing/operations/6fe687d7-1e0f-4bd6-9091-4672691f64bc
Resposta
O exemplo a seguir mostra a resposta para uma operação que foi concluída com êxito.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.partners.billing.exportSuccessOperation",
"id": "6fe687d7-1e0f-4bd6-9091-4672691f64bc",
"status": "succeeded",
"createdDateTime": "2023-03-09T08:12:53",
"lastActionDateTime": "2023-03-09T08:37:48.5046691Z",
"resourceLocation@odata.navigationLink": "https://graph.microsoft.com/beta/reports/partners/billing/manifests/8fe347d7-1e0f-4bd6-9091-4672691f32db"
}
Exemplo 2: Falha na operação de obtenção
Solicitação
O exemplo a seguir mostra uma solicitação que retorna um objeto microsoft.graph.partners.billing.failedOperation .
GET https://graph.microsoft.com/beta/reports/partners/billing/operations/6fe687d7-1e0f-4bd6-9091-4672691f64bc
Resposta
O exemplo a seguir mostra a resposta de uma operação que falhou.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.partners.billing.failedOperation",
"id": "6fe687d7-1e0f-4bd6-9091-4672691f64bc",
"status": "failed",
"createdDateTime": "2023-03-09T08:12:53",
"lastActionDateTime": "2023-03-09T08:37:48.5046691Z",
"error": {
"message": "No data available",
"code": "5000"
}
}
Exemplo 3: a operação Get ainda está em execução
Solicitação
O exemplo a seguir mostra uma solicitação que retorna um objeto microsoft.graph.partners.billing.runningOperation .
GET https://graph.microsoft.com/beta/reports/partners/billing/operations/6fe687d7-1e0f-4bd6-9091-4672691f64bc
Resposta
O exemplo a seguir mostra a resposta para uma operação que ainda está em execução.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.partners.billing.runningOperation",
"id": "6fe687d7-1e0f-4bd6-9091-4672691f64bc",
"status": "running",
"createdDateTime": "2023-03-09T08:12:53",
"lastActionDateTime": "2023-03-09T08:37:48.5046691Z"
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de