Freigeben über


Manage account profiles - Get organization profile

Ruft das Organisationsprofil ab.

GET https://api.partnercenter.microsoft.com/v{version}/profiles/organization

URI-Parameter

Name In Erforderlich Typ Beschreibung
version
path True

string

API-Version.

Anforderungsheader

Name Erforderlich Typ Beschreibung
Authorization True

string

Autorisierungs-Bearertoken

Accept True

string

Zulässiger Inhaltstyp; anwendung/json des weit verbreiteten Typs

ms-correlationid

string

Wird intern zum Nachverfolgen von Anforderungen verwendet. Wenn keine ms-correlationid angegeben wird, generiert der Server für jede Anforderung eine neue.

ms-requestid

string

Wird für die Idempotenz von Anforderungen verwendet. Wenn keine ms-requestid angegeben wird, generiert der Server für jede Anforderung eine neue anforderung.

Antworten

Name Typ Beschreibung
200 OK

Microsoft.Partner.Sdk.Contracts.V1.OrganizationProfile

Die Anforderung war erfolgreich. Der Antworttext enthält das Organisationsprofil.

Media Types: "application/json", "application/xml", "text/xml", "text/json"

400 Bad Request

Es fehlte eine oder eine ungültige Eingabe. Der Antworttext enthält die Fehlerdetails.

Media Types: "application/json", "application/xml", "text/xml", "text/json"

401 Unauthorized

Die Anforderung wurde nicht authentifiziert. Der Client muss sich zuerst beim Partner-API-Dienst authentifizieren.

Media Types: "application/json", "application/xml", "text/xml", "text/json"

403 Forbidden

Die Anforderung wurde authentifiziert, wurde aber abgelehnt, da der Aufrufer nicht über die Rechte zum Aufrufen verfügt.

Media Types: "application/json", "application/xml", "text/xml", "text/json"

404 Not Found

Die Ressource wurde mit den angegebenen Eingabeparametern nicht gefunden oder nicht verfügbar.

Media Types: "application/json", "application/xml", "text/xml", "text/json"

500 Internal Server Error

Der Partner-API-Dienst oder eine seiner Abhängigkeiten konnte die Anforderung nicht erfüllen. Anrufer versuchen dies möglicherweise erneut.

Media Types: "application/json", "application/xml", "text/xml", "text/json"

Definitionen

Name Beschreibung
Microsoft.Partner.Sdk.Contracts.V1.Address

Stellt eine Adresse für einen Kunden oder Partner dar.

Microsoft.Partner.Sdk.Contracts.V1.Common.Link

Link stellt einen URI und die HTTP-Methode dar, die die gewünschte Aktion für den Zugriff auf die Ressource angibt.

Microsoft.Partner.Sdk.Contracts.V1.Common.ResourceAttributes

Bezieht sich auf die allgemeinen Objektattribute

Microsoft.Partner.Sdk.Contracts.V1.Common.ResourceLinks

Navigationslinks für die Ressource

Microsoft.Partner.Sdk.Contracts.V1.OrganizationProfile

Beschreibt das Organisationsprofil eines Partners.

System.Collections.Generic.KeyValuePair[System.String,System.String]

Microsoft.Partner.Sdk.Contracts.V1.Address

Stellt eine Adresse für einen Kunden oder Partner dar.

Name Typ Beschreibung
addressLine1

string

Ruft die erste Zeile der Adresse ab oder legt sie fest.

addressLine2

string

Ruft die zweite Zeile der Adresse ab oder legt sie fest. Diese Eigenschaft ist optional.

city

string

Ruft die Stadt ab oder legt sie fest.

country

string

Ruft das Land/die Region im ISO-Ländercodeformat ab oder legt es fest.

firstName

string

Dient zum Abrufen oder Festlegen des Vornamens eines Kontakts im Unternehmen/der Organisation des Kunden.

lastName

string

Dient zum Abrufen oder Festlegen des Nachnamens eines Kontakts im Unternehmen/der Organisation des Kunden.

phoneNumber

string

Ruft die Telefonnummer eines Kontakts im Unternehmen/der Organisation des Kunden ab oder legt diese fest. Diese Eigenschaft ist optional.

postalCode

string

Ruft die Postleitzahl ab oder legt sie fest.

region

string

Dient zum Abrufen oder Festlegen des Bereichs.

state

string

Dient zum Abrufen oder Festlegen des Zustands.

Link stellt einen URI und die HTTP-Methode dar, die die gewünschte Aktion für den Zugriff auf die Ressource angibt.

Name Typ Beschreibung
headers

System.Collections.Generic.KeyValuePair[System.String,System.String][]

Ruft die Verknüpfungsheader ab.

method

string

Die Methode.

uri

string

Der URI.

Microsoft.Partner.Sdk.Contracts.V1.Common.ResourceAttributes

Bezieht sich auf die allgemeinen Objektattribute

Name Typ Beschreibung
etag

string

Ruft das etag ab oder legt es fest. Die Objektversion in Anbietern.

objectType

string

Der Objekttyp.

Navigationslinks für die Ressource

Name Typ Beschreibung
next

Microsoft.Partner.Sdk.Contracts.V1.Common.Link

Die nächste Seite mit Elementen.

previous

Microsoft.Partner.Sdk.Contracts.V1.Common.Link

Die vorherige Seite mit Elementen.

self

Microsoft.Partner.Sdk.Contracts.V1.Common.Link

Der Selbst-URI.

Microsoft.Partner.Sdk.Contracts.V1.OrganizationProfile

Beschreibt das Organisationsprofil eines Partners.

Name Typ Beschreibung
attributes

Microsoft.Partner.Sdk.Contracts.V1.Common.ResourceAttributes

Ruft die Attribute ab.

companyName

string

GEts oder legt den Namen des Unternehmens oder der Organisation fest.

culture

string

Ruft die bevorzugte Kultur für Kommunikation und Währung ab, z. B. "en-us".

defaultAddress

Microsoft.Partner.Sdk.Contracts.V1.Address

Ruft die Standardadresse des Unternehmens oder der Organisation ab oder legt sie fest.

domain

string

Ruft die Domäne des Unternehmens oder der Organisation ab oder legt sie fest.

email

string

Ruft die E-Mails des Unternehmens oder der Organisation ab oder legt sie fest.

id

string

Ruft den Bezeichner der Organisation ab oder legt sie fest.

language

string

Ruft die bevorzugte Sprache für die Kommunikation ab oder legt sie fest.

links

Microsoft.Partner.Sdk.Contracts.V1.Common.ResourceLinks

Ruft die Verknüpfungen ab oder legt sie fest.

profileType enum:
  • billing_profile
  • legal_business_profile
  • mpn_profile
  • organization_profile
  • support_profile

Ruft den Partnerprofiltyp ab.

tenantId

string

Dient zum Abrufen oder Festlegen des Mandantenbezeichners.

System.Collections.Generic.KeyValuePair[System.String,System.String]

Name Typ Beschreibung
key

string

value

string