Pobieranie subskrypcji dla powiadomienia
Dotyczy: Windows Azure Pack
Używany przez interfejs API zarządzania usługami do pobierania informacji o subskrypcji.
Żądanie
Zastąp ciąg <NotificationEndpoint> adresem punktu końcowego dla interfejsu API REST powiadomień niestandardowego dostawcy zasobów Windows Azure Pack. Zastąp wartość <Id> identyfikatorem subskrypcji do pobrania.
Metoda |
Identyfikator URI żądania |
Wersja PROTOKOŁU HTTP |
|---|---|---|
GET |
<http:// NotificationEndpoint>/subscriptions/<Id> |
HTTP/1.1 |
Parametry identyfikatora URI
Brak.
Nagłówki żądań
W poniższej tabeli opisano wymagane i opcjonalne nagłówki żądań.
Nagłówek żądania |
Opis |
|---|---|
Autoryzacja: Podstawowa |
Wymagane. Podstawowy token 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. |
Treść żądania
Brak.
Reakcja
Odpowiedź zawiera kod stanu HTTP, zestaw nagłówków odpowiedzi i treść odpowiedzi.
Kod stanu
Zwraca kod stanu 200 (OK), jeśli operacja zakończyła się pomyślnie.
Aby uzyskać informacje o kodach stanu, zobacz Status and Error Codes (Windows Azure Pack Service Management).
Nagłówki odpowiedzi
Odpowiedź dla tej operacji obejmuje standardowe nagłówki HTTP. Wszystkie standardowe nagłówki są zgodne ze specyfikacją protokołu HTTP/1.1.
Treść odpowiedzi
W poniższej tabeli opisano kluczowe elementy treści odpowiedzi:
Nazwa elementu |
Opis |
|---|---|
Subskrypcja |
Pobrana subskrypcja. Aby uzyskać więcej informacji, zobacz Subskrypcja (obiekt punktu końcowego powiadomień). |
Przykład
W poniższym przykładzie pokazano pobieranie subskrypcji dla żądania powiadomienia .
GET https://<NotificationEndpoint>:30010/subscriptions/ec66ec96-8edd-4916-be45-607959155c2a HTTP/1.1
Referer: https://<Computer>:30004/subscriptions/ec66ec96-8edd-4916-be45-607959155c2a
Accept-Language: en-US
x-ms-client-request-id: ef2c5d93-a957-439b-9210-de52107322c1-2014-07-09 23:45:22Z
x-ms-client-session-id: a519f0aa-53e9-4522-94fd-3c55607a6b65
x-ms-principal-id: <Computer>%5cAdministrator
x-ms-request-id: 684b6822d29e4aac96fe45110881e525.2014-07-09T23:45:24.2267567Z
Authorization: Basic <encoded username and password>
Content-Type: application/json; charset=utf-8
Host: <Computer>:30010
Content-Length: 0
Expect: 100-continue
Poniższy przykład kodu przedstawia odpowiedź JSON na potrzeby pobierania subskrypcji dla powiadomienia.
{
"SubscriptionId": "ec66ec96-8edd-4916-be45-607959155c2a",
"SubscriptionName": null,
"State": 1,
"LifecycleState": 0,
"LastErrorMessage": null,
"QuotaSettings": [
{
"Key": "Editions",
"Value": "[{\"displayName\":\"Default\",\"groupName\":\"Default\",\"resourceCount\":\"10\",\"resourceSize\":\"1024\",\"resourceSizeLimit\":\"0\",\"offerEditionId\":\"32814080310\",\"groupType\":\"Shared\"}]"
}
],
"AdminId": "notauser@contoso.com",
"CoAdminIds": [
]
}
Uwagi
Właściwość QuotaSettings musi zostać wypełniona w odpowiedzi.
Jeśli dostawca zasobów korzysta z asynchronicznej operacji subskrypcji, dostawca zasobów zwraca błąd 202 z operacji asynchronicznej, funkcja TBD jest następnie wywoływana co 10 sekund przez interfejs API zarządzania usługami, aby określić, czy operacja została ukończona.
TbD jest używany podczas uaktualniania systemu z Windows Azure Pack w wersji 1.