특정 리소스 종류별로 필터링된 카탈로그 항목의 인벤토리를 확인하는 방법입니다.
사전 요구 사항
자격 증명은 파트너 센터 인증에서 설명됩니다. 이 시나리오는 독립 실행형 앱과 App+사용자 자격 증명을 모두 사용하여 인증을 지원합니다.
하나 이상의 제품 ID. 필요에 따라 SKU ID를 지정할 수도 있습니다.
유효한 값(필수)입니다
resourceType. 허용되는 값의 전체 목록은 지원되는 리소스 종류를 참조하세요.제공된 제품/SKU ID로 참조되는 SKU의 재고를 확인하는 데 필요한 추가 정보 이러한 요구 사항은 제품/SKU 유형에 따라 다를 수 있으며 SKU의InventoryVariables 속성에서 확인할 수 있습니다.
REST 요청
요청 구문
| Method | URI 요청 |
|---|---|
| POST | {baseURL}/v1/extensions/product/checkinventorybyresourcetype?country={country-code}&resourceType={resourceTypeValue} HTTP/1.1 |
URI 매개 변수
다음 쿼리 매개 변수를 사용하여 리소스 종류별로 인벤토리를 확인합니다.
| Name | Type | 필수 | Description |
|---|---|---|---|
| 국가 코드 | string | 예 | 국가/지역 ID입니다. |
| resourceTypeValue | string | 예 | 인벤토리 결과를 필터링할 리소스 종류입니다. 유효한 값은 지원되는 리소스 종류를 참조하세요. |
지원되는 리소스 유형
| 리소스 종류 값 | Description |
|---|---|
| AppService | App Service |
| Avs | Azure VMware 솔루션 |
| AzureDataExplorer | Azure Data Explorer(아주르 데이터 탐색기) |
| AzureFiles | Azure Files |
| 백업 | Azure Backup |
| BlockBlob | 블록 Blob 스토리지 |
| CopilotCredit | Copilot 크레딧 |
| CosmosDb | Azure Cosmos DB (애저 코스모스 DB) |
| Databricks | Azure Databricks |
| DataFactory | Azure Data Factory |
| 전용 호스트 | Azure 전용 호스트 |
| Fabric 용량 | Microsoft Fabric 용량 |
| FoundryAgent | Foundry 에이전트 |
| ManagedDisk | Azure Managed Disk |
| MariaDB | MariaDB를 위한 Azure 데이터베이스 |
| MDC | 클라우드용 Microsoft Defender |
| MySql | Azure Database for MySQL (MySQL을 위한 Azure 데이터베이스) |
| Nutanix | Nutanix |
| OpenAIPTU | Azure OpenAI PTU |
| PostgreSQL | PostgreSQL용 Azure 데이터베이스 |
| RedHat | Red Hat |
| 레드햇오사 | Azure의 Red Hat OpenShift |
| 레디스캐시 | Azure Cache for Redis (Redis를 위한 Azure 캐시) |
| SapHana | Azure의 SAP HANA |
| Sentinel | Microsoft Sentinel |
| SQL데이터베이스 | Azure SQL 데이터베이스들 |
| SqlDataWarehouse | Azure SQL Data Warehouse |
| SuseLinux | 수세 리눅스 |
| Synapse | Azure Synapse Analytics |
| 가상머신 | Azure Virtual Machines |
| VMwareCloudSimple | VMware CloudSimple |
요청 헤더
자세한 내용은 Partner Center REST 헤더를 참조하세요.
요청 본문
하나 이상의 InventoryItem 리소스를 포함하는 InventoryCheckRequest 리소스로 구성된 인벤토리 요청 세부 정보입니다.
요청 본문에 지정된 Azure 구독이 등록되어 있고 Azure RI를 구매할 수 있는지 확인합니다. 등록 프로세스에 대한 자세한 내용은 구독 등록 을 참조하세요.
예제 요청
POST https://api.partnercenter.microsoft.com/v1/extensions/product/checkinventorybyresourcetype?country=US&resourceType=VirtualMachines HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: d1b1981a-e088-4610-870a-eebec96d6bcd
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Content-Type: application/json
{"TargetItems":[{"ProductId":"DZH318Z0BQ3P"}],"InventoryContext":{"customerId":"d6bf25b7-e0a8-4f2d-a31b-97b55cfc774d","azureSubscriptionId":"3A231FBE-37FE-4410-93FD-730D3D5D4C75","armRegionName":"Europe"}}
REST 응답
성공하면 응답 본문에 제한 세부 정보(있는 경우)로 채워진 InventoryItem 개체 컬렉션이 포함됩니다.
메모
입력 InventoryItem이 카탈로그에서 찾을 수 없거나 지정된 리소스 종류에 해당하지 않는 항목을 나타내는 경우 출력 컬렉션에 포함되지 않습니다.
응답 성공 및 오류 코드
각 응답에는 성공 또는 실패와 추가 디버깅 정보를 나타내는 HTTP 상태 코드가 함께 제공됩니다. 네트워크 추적 도구를 사용하여 이 코드, 오류 유형 및 추가 매개 변수를 읽을 수 있습니다. 전체 목록은 파트너 센터 오류 코드를 참조 하세요.
응답 예제
HTTP/1.1 200 OK
Content-Length: 1021
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: d1b1981a-e088-4610-870a-eebec96d6bcd
X-Locale: en-US
[
{
"productId": "DZH318Z0BQ3P",
"skuId": "0039",
"isRestricted": true,
"restrictions": [
{
"reasonCode": "NotAvailableForSubscription",
"description": "Restriction identified of type 'Location' with values 'japanwest'.",
"properties": {
"type": "Location",
"values": "japanwest"
}
}
]
},
{
"productId": "DZH318Z0BQ3P",
"skuId": "0038",
"isRestricted": false,
"restrictions": []
}
]
응답으로 반환되지 않은 제품
제품 또는 SKU를 지정된 구독 및 지역에 사용할 수 있지만 제한 사항이 적용되는 경우 응답에는 제품 isRestricted: true 및 해당 제한 세부 정보가 포함됩니다.
지정된 구독 및 지역에 제품을 사용할 수 없는 경우 응답은 제품을 완전히 생략합니다.
Important
응답에서 누락된 제품을 지정된 구독 및 지역에만 사용할 수 없는 것으로 처리합니다.
| Scenario | CheckInventoryByResourceType 응답 |
|---|---|
| 구독/지역에 사용할 수 없는 제품 | 응답에서 생략된 제품 |
| 사용 가능한 SKU | isRestricted: false |
| 지역에서 제한된 SKU |
isRestricted: true와 함께 반환됨 |