取得訂用帳戶的註冊狀態
如何取得已啟用購買 Azure 保留 VM 實例的客戶訂用帳戶訂用帳戶註冊狀態。
若要使用合作夥伴中心 API 購買 Azure 保留的 VM 實例,您必須至少有一個現有的 CSP Azure 訂用帳戶。 註冊訂用帳戶方法可讓您註冊現有的 CSP Azure 訂用帳戶,讓其能夠購買 Azure 保留的 VM 實例。 這個方法可讓您擷取該註冊的狀態。
必要條件
認證,如合作夥伴中心驗證所述。 此案例支援使用獨立應用程式和 App+使用者認證進行驗證。
客戶識別碼 (
customer-tenant-id
)。 如果您不知道客戶的識別碼,您可以選取 [客戶] 工作區,然後從客戶清單中選取客戶,然後從客戶清單中查詢該識別碼,然後查閱合作夥伴中心。 在客戶的 [帳戶] 頁面上,尋找 [客戶帳戶資訊] 區段中的 [Microsoft 識別碼] 。 Microsoft 識別碼與客戶識別碼 ()customer-tenant-id
相同。訂用帳戶識別碼。
C#
若要取得訂用帳戶的註冊狀態,請先使用 IAggregatePartner.Customers.ById 方法來識別客戶。 然後,使用訂用帳戶識別碼呼叫 Subscription.ById () 方法來識別訂用帳戶,以取得訂用帳戶作業的介面。 接下來,使用 RegistrationStatus 屬性來取得目前訂閱註冊狀態作業的介面,並呼叫 Get 或GetAsync方法來擷取SubscriptionRegistrationStatus物件。
// IAggregatePartner partnerOperations;
// var selectedCustomerId;
// var selectedSubscriptionId;
// Retrieve a subscription's registration status details.
var subscriptionRegistrationDetails = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).RegistrationStatus.Get();
REST 要求
要求的語法
方法 | 要求 URI |
---|---|
GET | {baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/registrationstatus HTTP/1.1 |
URI 參數
使用下列路徑參數來識別客戶和訂用帳戶。
名稱 | 類型 | 必要 | 描述 |
---|---|---|---|
customer-id | string | Yes | 識別客戶的 GUID 格式字串。 |
subscription-id | string | Yes | 識別訂用帳戶的 GUID 格式字串。 |
要求標頭
如需詳細資訊,請參閱合作夥伴中心 REST 標頭。
要求本文
無。
要求範例
GET https://api.partnercenter.microsoft.com/v1/customers/<customer-id>/subscriptions/<subscription-id>/registrationstatus HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
Content-Type: application/json
Content-Length: 1029
Expect: 100-continue
Connection: Keep-Alive
REST 回應
如果成功,回應本文會包含 SubscriptionRegistrationStatus 資源。
回應成功和錯誤碼
每個回應都隨附 HTTP 狀態碼,會指出成功與否以及其他的偵錯資訊。 請使用網路追蹤工具來讀取此錯誤碼、錯誤類型和其他參數。 如需完整清單,請參閱錯誤碼。
回應範例
HTTP/1.1 200 OK
Content-Length: 177
Content-Type: application/json; charset=utf-8
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-CV: InswEQre402koceL.0
MS-ServerId: 030020344
{
"subscriptionId":"<subscription-id>",
"status":"NotRegistered",
"attributes":{
"objectType":"SubscriptionRegistrationStatus"
}
}