Een invoegtoepassing ophalen (tenant-invoegtoepassing)

Artikel
08/24/2015

Van toepassing op: Windows Azure Pack

Hiermee haalt u een invoegtoepassing op.

Aanvraag

Vervang ServiceMgmt> door <het eindpuntadres van uw Service Management-API. Vervang AddonId> door <de invoegtoepassings-id van de invoegtoepassing.

Methode	Aanvraag-URI	HTTP-versie
GET	<https:// ServiceMgmt>:30005/addons/<AddonId>	HTTP/1.1

URI-parameters

Geen.

Aanvraagheaders

In de volgende tabel worden vereiste en optionele aanvraagheaders beschreven.

Aanvraagheader	Beschrijving
Autorisatie: Bearer	Vereist. Het autorisatie bearer-token.
x-ms-principal-id	Vereist. De principal-id.
x-ms-client-request-id	Optioneel. De clientaanvraag-id.
x-ms-client-session-id	Optioneel. De clientsessie-id.
x-ms-principal-liveid	Optioneel. De live-principal-id.

Aanvraagbody

In de volgende tabel worden de elementen van de aanvraagbody beschreven.

Elementnaam	Beschrijving
includePrice	Optioneel. De uitbreiding omvat de prijs.
regio	Optioneel. De regio van de invoegtoepassing.
subscriptionId	Optioneel. De abonnements-id.
gebruikersnaam	Optioneel. De gebruikersnaam van de invoegtoepassing.

Er zijn 4 belopties. Als een andere combinatie van opties wordt gebruikt, heeft de bewerking geen aanvraagbody.

Optie	Vereiste
AddonID alleen in de aanroepende URI	Geen aanvraagtekst.
includeprice, region, username & SubscriptionId.	De opgegeven gebruikersnaam en subscriptionId.
Inclusiefprijs, regio & gebruikersnaam	De opgegeven gebruikersnaam.
includeprice, region en subscriptionId	De opgegeven subscriptionId.

Antwoord

Het antwoord bevat een HTTP-statuscode, een set antwoordheaders en een antwoordtekst.

Statuscode

Een geslaagde bewerking retourneert statuscode 200 (OK).

Zie Status- en foutcodes (Windows Azure Pack Service Management) voor meer informatie over statuscodes.

Antwoordheaders

Het antwoord voor deze bewerking bevat standaard HTTP-headers. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.

Hoofdtekst van antwoord

In de volgende tabel worden de belangrijkste elementen van de hoofdtekst van het antwoord beschreven:

Elementnaam	Beschrijving
PlanAddOn	De invoegtoepassing die is opgehaald. Zie PlanAddon (Administrator-object) voor meer informatie.

Voorbeeld

In het volgende codevoorbeeld ziet u een invoegtoepassingsaanvraag ophalen .

GET https://<computer>:30004/addons/MyTeshixk1xiz 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

In het volgende codevoorbeeld ziet u het antwoord Invoegtoepassing ophalen .

{
  "Id": "MyTeshixk1xiz",
  "DisplayName": "My Test Addon",
  "State": 0,
  "ConfigState": 1,
  "QuotaSyncState": 0,
  "LastErrorMessage": null,
  "Advertisements": [
    {
      "LanguageCode": "en-us",
      "DisplayName": "My Test Addon",
      "Description": null
    }
  ],
  "ServiceQuotas": [
    {
      "ServiceName": "sqlservers",
      "ServiceInstanceId": "85D94D4A-6ADF-47A6-BAEF-A01975742308",
      "ServiceDisplayName": "SQL Servers",
      "ServiceInstanceDisplayName": "SQL Servers",
      "ConfigState": 1,
      "QuotaSyncState": 0,
      "Settings": [
        {
          "Key": "Editions",
          "Value": "[{\"groupName\":\"Default\",\"resourceCount\":\"1\",\"resourceSize\":\"10\",\"offerEditionId\":\"1373402022182\"}]"
        }
      ]
    }
  ],
  "SubscriptionCount": 0,
  "AssociatedPlans": [

  ],
  "MaxOccurrencesPerPlan": 1,
  "Price": null
}

Zie ook

Interfaces voor beheerdersplannen

Delen via