Pobieranie subskrypcji dla użytkownika
Dotyczy: Windows Azure Pack
Pobiera subskrypcje należące do użytkownika.
Żądanie
Zastąp ciąg <ServiceMgmt> adresem punktu końcowego interfejsu API zarządzania usługami.
Metoda |
Identyfikator URI żądania |
Wersja PROTOKOŁU HTTP |
|---|---|---|
GET |
<https:// ServiceMgmt>:30004/subscriptions |
HTTP/1.1 |
Parametry identyfikatora URI
W poniższej tabeli opisano parametry identyfikatora URI.
Parametr identyfikatora URI |
Opis |
|---|---|
Userid |
Wymagane. Identyfikator użytkownika. |
Filtr |
Opcjonalny. Ciąg do użycia jako filtr zapytania. |
Nagłówki żądań
Nagłówek żądania |
Opis |
|---|---|
Autoryzacja: elementu nośnego |
Wymagane. Token elementu nośnego autoryzacji. |
x-ms-principal-id |
Wymagane. Identyfikator podmiotu zabezpieczeń. |
x-ms-client-request-id |
Opcjonalny. Identyfikator żądania klienta. |
x-ms-client-session-id |
Opcjonalny. Identyfikator sesji klienta. |
x-ms-principal-liveid |
Opcjonalny. Główny identyfikator na żywo. |
Reakcja
Odpowiedź zawiera kod stanu HTTP, zestaw nagłówków odpowiedzi i treść odpowiedzi.
Kod stanu
Operacja zakończona powodzeniem zwraca kod stanu 200 (OK).
Aby uzyskać informacje o kodach stanu, zobacz Status and Error Codes (Windows Azure Pack Service Management).
Nagłówki odpowiedzi
Odpowiedź na tę operację obejmuje standardowe nagłówki HTTP. Wszystkie nagłówki standardowe są zgodne ze specyfikacją protokołu HTTP/1.1.
Treść odpowiedzi
W poniższej tabeli opisano kluczowe elementy treści odpowiedzi.
Nazwa elementu |
Opis |
|---|---|
elementy |
Lista wyników zapytania AdminSubscription (obiekt administratora). |
filteredTotalCount |
Łączna liczba zwracanych elementów przed zastosowaniem stronicowania i po zastosowaniu filtrowania. |
totalCount |
Łączna liczba zwracanych elementów przed zastosowaniem stronicowania i filtrowania. |
Przykład
Poniższy przykład kodu przedstawia żądanie List User Subscriptions (Lista subskrypcji użytkowników ).
GET https:// <computer>:30004/subscriptions?UserId=newcustomer@mycustomers.com HTTP/1.1
Authorization: Bearer
x-ms-client-request-id: 5f7abeba-03fd-41ab-92f1-1ef4ee5507f3-2013-07-09 22:02:35Z
x-ms-client-session-id: 4d317dde-d7c1-495e-a819-9802dc021e2f
x-ms-principal-id: <computer>\Administrator
Accept-Language: en-US
x-ms-principal-liveid: <computer>\Administrator
Host: <computer>:30004
Poniższy przykład kodu przedstawia odpowiedź List User Subscriptions (Lista subskrypcji użytkowników ).
{
"items": [
{
"SubscriptionID": "f172f02f-389f-48e4-a536-7a8dd0c0c629",
"SubscriptionName": "Hosting Plan One",
"AccountAdminLiveEmailId": "newcustomer@mycustomers.com",
"ServiceAdminLiveEmailId": null,
"CoAdminNames": [
],
"AddOnReferences": [
],
"AddOns": [
],
"State": 1,
"QuotaSyncState": 0,
"ActivationSyncState": 0,
"PlanId": "Hostihixchp2f",
"Services": [
{
"Type": "sqlservers",
"State": "registered",
"QuotaSyncState": 0,
"ActivationSyncState": 0,
"BaseQuotaSettings": [
{
"Key": "Editions",
"Value": "[{\"displayName\":\"Default\",\"groupName\":\"Default\",\"resourceCount\":\"10\",\"resourceSize\":\"1024\",\"resourceSizeLimit\":\"1024\",\"offerEditionId\":\"070913050037\",\"groupType\":null}]"
}
]
}
],
"LastErrorMessage": null,
"Features": null,
"OfferFriendlyName": "Hosting Plan One",
"OfferCategory": null,
"Created": "2013-07-09T17:08:58.717"
}
],
"filteredTotalCount": 1,
"totalCount": 1
}