다음을 통해 공유


Invoices - Download Documents By Billing Subscription

여러 청구서 문서(청구서 pdf, 세금 영수증, 신용 메모)를 zip 파일로 다운로드하는 URL을 가져옵니다. 이 작업은 계약 유형이 Microsoft 파트너 계약 또는 Microsoft 고객 계약인 청구 계정에 대해 지원됩니다.

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/default/billingSubscriptions/{subscriptionId}/downloadDocuments?api-version=2024-04-01

URI 매개 변수

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

string

pattern: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$

청구 구독을 고유하게 식별하는 ID입니다.

api-version
query True

string

클라이언트 요청과 함께 사용할 API의 버전입니다. 현재 버전은 2024-04-01입니다.

요청 본문

Name 형식 Description
parameters

DocumentDownloadRequest[]

개별 문서에 대한 다운로드 세부 정보 목록입니다.

응답

Name 형식 Description
200 OK

DocumentDownloadResult

URL이 만료될 때까지 엔터티를 다운로드하는 데 사용할 수 있는 보안 URL입니다.

202 Accepted

클라이언트가 작업 결과를 보기 위해 폴링할 수 있는 '위치' 헤더를 반환하는 작업에 허용되는 결과입니다.

헤더

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

작업이 실패한 이유를 설명하는 오류 응답입니다.

예제

InvoicesDownloadDocumentsByBillingSubscription

샘플 요청

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/default/billingSubscriptions/00000000-0000-0000-0000-000000000000/downloadDocuments?api-version=2024-04-01

[
  {
    "documentName": "12345678",
    "invoiceName": "E123456789"
  },
  {
    "documentName": "12345678",
    "invoiceName": "E987654321"
  }
]

샘플 응답

{
  "expiryTime": "2023-02-16T17:32:28Z",
  "url": "https://myaccount.blob.core.windows.net/invoices/1383724.pdf?sv=2019-02-02&sr=b&sp=r"
}
Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/default/billingSubscriptions/00000000-0000-0000-0000-000000000000/operationResults/invoiceDownload_11111111-1111-1111-1111-111111111111?api-version=2024-04-01
Retry-After: 10

정의

Name Description
DocumentDownloadRequest

개별 문서에 대한 다운로드 세부 정보 목록입니다.

DocumentDownloadResult

URL이 만료될 때까지 엔터티를 다운로드하는 데 사용할 수 있는 보안 URL입니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

오류 응답

DocumentDownloadRequest

개별 문서에 대한 다운로드 세부 정보 목록입니다.

Name 형식 Description
documentName

string

청구서 문서를 고유하게 식별하는 ID입니다. 이 ID는 청구서 PDF, 신용 메모 또는 세금 영수증의 식별자일 수 있습니다. 생략하면 청구서에 대한 최신 청구서 PDF가 반환됩니다.

invoiceName

string

청구서를 고유하게 식별하는 ID입니다.

DocumentDownloadResult

URL이 만료될 때까지 엔터티를 다운로드하는 데 사용할 수 있는 보안 URL입니다.

Name 형식 Description
expiryTime

string

다운로드 URL이 만료되는 시간(UTC)입니다.

url

string

PDF 또는 .zip 파일의 URL입니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.

type

string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.

code

string

오류 코드입니다.

details

ErrorDetail[]

오류 세부 정보입니다.

message

string

오류 메시지입니다.

target

string

오류 대상입니다.

ErrorResponse

오류 응답

Name 형식 Description
error

ErrorDetail

오류 개체입니다.