Office 365-IP-Adress- und -URL-WebdienstOffice 365 IP Address and URL web service

Der Office 365-IP-Adress- und URL-Dienst unterstützt Sie beim besseren Erkennen und Differenzieren des Netzwerkdatenverkehrs in Office 365, was es Ihnen erleichtert, Änderungen auszuwerten, zu konfigurieren und auf dem neuesten Stand zu bleiben.The Office 365 IP Address and URL web service helps you better identify and differentiate Office 365 network traffic, making it easier for you to evaluate, configure, and stay up to date with changes. Dieser REST-basierte Webdienst ersetzt die vorherigen herunterladbaren XML-Dateien, die am 2. Oktober 2018 ausliefen.This REST-based web service replaces the previous XML downloadable files, which were phased out on October 2, 2018.

Als Kunde oder Hersteller von Netzwerkumkreisgeräten können Sie den Build für den Webdienst für die Office 365-IP-Adress- und -FQDN-Einträge erstellen.As a customer or a network perimeter device vendor, you can build against the web service for Office 365 IP address and FQDN entries. Sie können direkt in einem Webbrowser auf die Daten zugreifen, indem Sie diese URLs verwenden:You can access the data directly in a web browser using these URLs:

Als Kunde können Sie diesen Webdienst für Folgendes verwenden:As a customer, you can use this web service to:

  • Aktualisieren Sie Ihre PowerShell-Skripte zum Abrufen von Daten auf Office 365-Endpunkten und zum Ändern der Formatierung für Ihre Netzwerkgeräte.Update your PowerShell scripts to obtain Office 365 endpoint data and modify any formatting for your networking devices.
  • Verwenden Sie diese Informationen, um auf Clientcomputern bereitgestellte PAC-Dateien zu aktualisieren.Use this information to update PAC files deployed to client computers.

Als Anbieter von Netzwerkperimetergeräten können Sie diesen Webdienst für Folgendes verwenden:As a network perimeter device vendor, you can use this web service to:

  • Erstellen und testen Sie Gerätesoftware für den Download der Liste für die automatische Konfiguration.Create and test device software to download the list for automated configuration.
  • Suchen Sie die aktuelle Version.Check for the current version.
  • Rufen Sie die aktuellen Änderungen ab.Get the current changes.

Hinweis

Wenn Sie Azure ExpressRoute für die Verbindung mit Office 365 verwenden, lesen Sie bitte Azure ExpressRoute for Office 365, um sich mit den Office 365-Diensten vertraut zu machen, die von Azure ExpressRoute unterstützt werden. If you are using Azure ExpressRoute to connect to Office 365, please review Azure ExpressRoute for Office 365 to familiarize yourself with the Office 365 services supported over Azure ExpressRoute. Bitte lesen Sie auch den Artikel Office 365-URLs und -IP-Adressbereiche, um zu verstehen, welche Netzwerke für Office 365-Apps eine Internetverbindung benötigen.Also review the article Office 365 URLs and IP address ranges to understand which network requests for Office 365 applications require Internet connectivity. Das wird Ihnen helfen, Ihre Umkreis-Sicherheitsgeräte besser zu konfigurieren.This will help to better configure your perimeter security devices.

Weitere Informationen finden Sie unter:For more information, see:

Allgemeine ParameterCommon parameters

Diese Parameter gelten für sämtliche Webdienstmethoden:These parameters are common across all the web service methods:

  • format=<JSON | CSV> – standardmäßig ist die zurückgegebene Datei als JSON formatiert.format=<JSON | CSV> — By default, the returned data format is JSON. Verwenden Sie diesen optionalen Parameter, um die Daten in durch Trennzeichen getrennten Werten (CSV-Format) zurückzuerhalten.Use this optional parameter to return the data in comma-separated values (CSV) format.

  • ClientRequestId=<guid> – eine erforderliche GUID, die Sie für die Clientzuordnung generieren.ClientRequestId=<guid> — A required GUID that you generate for client association. Generieren Sie eine eindeutige GUID für jeden Computer, von dem der Webdienst aufgerufen wird (die auf dieser Seite enthaltenen Skripts generieren eine GUID für Sie).Generate a unique GUID for each machine that calls the web service (the scripts included on this page generate a GUID for you). Nutzen Sie nicht die in den folgenden Beispielen dargestellten GUIDs, da sie künftig durch den Webdienst blockiert werden könnten.Do not use the GUIDs shown in the following examples because they might be blocked by the web service in the future. Das GUID-Format ist xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, wobei x eine hexadezimale Zahl darstellt.GUID format is xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, where x represents a hexadecimal number.

    Wenn Sie eine GUID generieren möchten, können Sie den PowerShell-Befehl New-Guid verwenden oder einen Onlinedienst wie den Online GUID Generator nutzen.To generate a GUID, you can use the New-Guid PowerShell command, or use an online service such as Online GUID Generator.

VersionswebmethodeVersion web method

Microsoft aktualisiert die Office 365-IP-Adress- und -FQDN-Einträge am Ende jeden Monats.Microsoft updates the Office 365 IP address and FQDN entries at the end of each month. Out-of-Band-Updates werden manchmal aufgrund von Supportfällen, Sicherheitsupdates oder sonstigen betrieblichen Anforderungen veröffentlicht.Out-of-band updates are sometimes published due to support incidents, security updates or other operational requirements.

Den Daten für jede veröffentlichte Instanz wird eine Versionsnummer zugewiesen, und mit der Versionswebmethode können Sie nach der neuesten Version jeder Office 365-Dienstinstanz suchen.The data for each published instance is assigned a version number, and the version web method enables you to check for the latest version of each Office 365 service instance. Wir empfehlen, die Version nicht mehr als einmal pro Stunde zu überprüfen.We recommend that you check the version not more than once an hour.

Parameter für die Versionswebmethode sind:Parameters for the version web method are:

  • AllVersions=<true | false> – standardmäßig ist die zurückgegebene Version die neueste.AllVersions=<true | false> — By default, the version returned is the latest. Nehmen Sie diesen optionalen Parameter mit auf, um alle veröffentlichten Versionen seit dem ersten Release des Webdiensts anzufordern.Include this optional parameter to request all published versions since the web service was first released.
  • Format=<JSON | CSV | RSS> – zusätzlich zu den Formaten JSON und CSV unterstützt die Versionswebmethode auch RSS.Format=<JSON | CSV | RSS> — In addition to the JSON and CSV formats, the version web method also supports RSS. Diesen optionalen Parameter können Sie zusammen mit dem Parameter AllVersions=true verwenden, um einen RSS-Feed anzufordern, der mit Outlook oder anderen RSS-Readern genutzt werden kann.You can use this optional parameter along with the AllVersions=true parameter to request an RSS feed that can be used with Outlook or other RSS readers.
  • Instance=<Weltweit | China | Deutschland | USGovDoD | USGovGCCHigh> – dieser optionale Parameter gibt die Instanz an, für die die Version zurückgegeben werden soll.Instance=<Worldwide | China | Germany | USGovDoD | USGovGCCHigh> — This optional parameter specifies the instance to return the version for. Wenn nicht angegeben, werden alle Instanzen zurückgegeben.If omitted, all instances are returned. Gültige Instanzen sind: Weltweit, China, Deutschland, USGovDoD, USGovGCCHigh.Valid instances are: Worldwide, China, Germany, USGovDoD, USGovGCCHigh.

Die Rate der Versionswebmethode ist nicht beschränkt, und sie gibt nie 429-HTTP-Antwortcodes zurück.The version web method is not rate limited and does not ever return 429 HTTP Response Codes. Die Antwort auf die Versionswebmethode enthält einen Cache-Control-Header, der empfiehlt, die Daten für eine Stunde zwischenzuspeichern.The response to the version web method does include a cache-control header recommending caching of the data for 1 hour. Das Ergebnis der Versionswebmethode kann ein einzelner Datensatz oder ein Array aus Datensätzen sein.The result from the version web method can be a single record or an array of records. Die Elemente jedes Datensatzes sind:The elements of each record are:

  • instance – die Kurzform der Office 365-Serviceinstanz.instance — The short name of the Office 365 service instance.
  • latest – die neueste Version für Endpunkte der angegebenen Instanz.latest — The latest version for endpoints of the specified instance.
  • versions – eine Liste aller vorherigen Versionen für die angegebene Instanz.versions — A list of all previous versions for the specified instance. Dieses Element wird nur einbezogen, wenn der Parameter AllVersions wahr ist.This element is only included if the AllVersions parameter is true.

Beispiele:Examples:

Anfrage-URI – Beispiel 1: https://endpoints.office.com/version?ClientRequestId=b10c5ed1-bad1-445f-b386-b919946339a7Example 1 request URI: https://endpoints.office.com/version?ClientRequestId=b10c5ed1-bad1-445f-b386-b919946339a7

Dieser URI gibt die aktuelle Version jeder Instanz des Office 365-Diensts zurück. Beispielergebnis:This URI returns the latest version of each Office 365 service instance. Example result:

[
 {
  "instance": "Worldwide",
  "latest": "2018063000"
 },
 {
  "instance": "USGovDoD",
  "latest": "2018063000"
 },
 {
  "instance": "USGovGCCHigh",
  "latest": "2018063000"
 },
 {
  "instance": "China",
  "latest": "2018063000"
 },
 {
  "instance": "Germany",
  "latest": "2018063000"
 }
]

Wichtig

Die GUID für den Parameter „ClientRequestID“ in diesen URIs dient nur als Beispiel. Um die Webdienst-URIs auszuprobieren, erstellen Sie Ihre eigene GUID. Die in den folgenden Beispielen gezeigten GUIDs werden möglicherweise in Zukunft vom Webdienst gesperrt.The GUID for the ClientRequestID parameter in these URIs are only an example. To try the web service URIs out, generate your own GUID. The GUIDs shown in these examples may be blocked by the web service in the future.

Anfrage-URI – Beispiel 2: https://endpoints.office.com/version/Worldwide?ClientRequestId=b10c5ed1-bad1-445f-b386-b919946339a7Example 2 request URI: https://endpoints.office.com/version/Worldwide?ClientRequestId=b10c5ed1-bad1-445f-b386-b919946339a7

Dieser URI gibt die aktuelle Version der angegebenen Instanz des Office 365-Diensts zurück. Beispielergebnis:This URI returns the latest version of the specified Office 365 service instance. Example result:

{
 "instance": "Worldwide",
 "latest": "2018063000"
}

Anfrage-URI – Beispiel 3: https://endpoints.office.com/version/Worldwide?Format=CSV&ClientRequestId=b10c5ed1-bad1-445f-b386-b919946339a7Example 3 request URI: https://endpoints.office.com/version/Worldwide?Format=CSV&ClientRequestId=b10c5ed1-bad1-445f-b386-b919946339a7

Dieser URI zeigt die Ausgabe im CSV-Format an. Beispielergebnis:This URI shows output in CSV format. Example result:

instance,latest
Worldwide,2018063000

Anfrage-URI – Beispiel 4: https://endpoints.office.com/version/Worldwide?AllVersions=true&ClientRequestId=b10c5ed1-bad1-445f-b386-b919946339a7Example 4 request URI: https://endpoints.office.com/version/Worldwide?AllVersions=true&ClientRequestId=b10c5ed1-bad1-445f-b386-b919946339a7

Dieser URI zeigt alle vorherigen Versionen an, die für die Dienstinstanz von Office 365 weltweit veröffentlicht wurden. Beispielergebnis:This URI shows all prior versions that have been published for the Office 365 worldwide service instance. Example result:

{
  "instance": "Worldwide",
  "latest": "2018063000",
  "versions": [
    "2018063000",
    "2018062000"
  ]
}

RSS-Feed-URI – Beispiel 5: https://endpoints.office.com/version/worldwide?clientRequestId=b10c5ed1-bad1-445f-b386-b919946339a7&allVersions=true&format=RSSExample 5 RSS Feed URI: https://endpoints.office.com/version/worldwide?clientRequestId=b10c5ed1-bad1-445f-b386-b919946339a7&allVersions=true&format=RSS

Dieser URI zeigt einen RSS-Feed der veröffentlichten Versionen, die Links zu der Liste der Änderungen für jede Version enthalten. Beispielergebnis:This URI shows an RSS feed of the published versions that include links to the list of changes for each version. Example result:

<?xml version="1.0" encoding="ISO-8859-1"?>
<rss version="2.0" xmlns:a10="https://www.w3.org/2005/Atom">
<channel>
<link>https://aka.ms/o365ip</link>
<description/>
<language>en-us</language>
<lastBuildDate>Thu, 02 Aug 2018 00:00:00 Z</lastBuildDate>
<item>
<guid isPermaLink="false">2018080200</guid>
<link>https://endpoints.office.com/changes/Worldwide/2018080200?singleVersion&clientRequestId=b10c5ed1-bad1-445f-b386-b919946339a7</link> <description>Version 2018080200 includes 2 changes. IPs: 2 added and 0 removed.</description>
<pubDate>Thu, 02 Aug 2018 00:00:00 Z</pubDate>
</item>

EndpunktwebmethodeEndpoints web method

Die Endpunktwebmethode gibt alle Datensätze für IP-Adressbereiche und URLs zurück, die den Office 365-Dienst bilden.The endpoints web method returns all records for IP address ranges and URLs that make up the Office 365 service. Die neuesten Daten aus der Endpunkt-Webmethode sollten immer für die Konfiguration von Netzwerkgeräten verwendet werden.The latest data from the endpoints web method should always be used for network device configuration. Microsoft kündigt neue Ergänzungen 30 Tage vor der Veröffentlichung an, um Ihnen Zeit zum Aktualisieren von Zugriffssteuerungs- und Proxyserver-Umgehungslisten zu lassen.Microsoft provides advance notice 30 days prior to publishing new additions to give you time to update access control lists and proxy server bypass lists. Wir empfehlen Ihnen, die Endpunktwebmethode erst wieder einzusetzen, wenn die Versionswebmethode besagt, dass eine neue Version der Daten verfügbar ist.We recommend that you only call the endpoints web method again when the version web method indicates that a new version of the data is available.

Parameter für die Endpunktwebmethode sind:Parameters for the endpoints web method are:

  • ServiceAreas=<Common | Exchange | SharePoint | Skype> – eine durch Trennzeichen getrennte Liste von Dienstbereichen.ServiceAreas=<Common | Exchange | SharePoint | Skype> — A comma-separated list of service areas. Gültige Elemente sind_Common_, Exchange, SharePoint und Skype.Valid items are Common, Exchange, SharePoint, and Skype. Da Common-Dienstbereich-Elemente Voraussetzung für alle anderen Dienstbereiche sind, bezieht der Webdienst sie stets mit ein.Because Common service area items are a prerequisite for all other service areas, the web service always includes them. Wenn Sie diesen Parameter nicht miteinschließen, werden alle Dienstbereiche zurückgegeben.If you do not include this parameter, all service areas are returned.
  • TenantName=<tenant_name> – Ihr Office 365-Mandantenname.TenantName=<tenant_name> — Your Office 365 tenant name. Der Webdienst übernimmt Ihren angegebenen Namen und fügt ihn in URL-Teile ein, die den Mandantennamen enthalten.The web service takes your provided name and inserts it in parts of URLs that include the tenant name. Wenn Sie keinen Mandantennamen angeben, haben diese URL-Teile das Platzhalterzeichen (*).If you don't provide a tenant name, those parts of URLs have the wildcard character (*).
  • NoIPv6=<true | false> – legen Sie für diesen Wert true fest, um IPv6-Adressen von der Ausgabe auszuschließen, wenn Sie IPv6 nicht in Ihrem Netzwerk verwenden.NoIPv6=<true | false> — Set the value to true to exclude IPv6 addresses from the output if you don't use IPv6 in your network.
  • Instance=<Weltweit | China | Deutschland | USGovDoD | USGovGCCHigh> – dieser erforderliche Parameter gibt die Instanz an, von der die Endpunkte zurückgegeben werden sollen.Instance=<Worldwide | China | Germany | USGovDoD | USGovGCCHigh> — This required parameter specifies the instance from which to return the endpoints. Gültige Instanzen sind: Weltweit, China, Deutschland, USGovDoD und USGovGCCHigh.Valid instances are: Worldwide, China, Germany, USGovDoD, and USGovGCCHigh.

Wenn Sie die Endpunktwebmethode zu häufig von derselben Client-IP-Adresse abrufen, erhalten Sie möglicherweise den HTTP-Antwortcode 429 (zu viele Anforderungen).If you call the endpoints web method too many times from the same client IP address, you might receive HTTP response code 429 (Too Many Requests). Wenn Sie diesen Antwortcode erhalten, warten Sie eine Stunde, bevor Sie Ihre Anforderung wiederholen, oder generieren Sie eine neue GUID für sie.If you get this response code, wait 1 hour before repeating your request, or generate a new GUID for the request. Als allgemein bewährte Methode rufen Sie die Endpunktwebmethode nur auf, wenn die Versionswebmethode besagt, dass eine neue Version verfügbar ist.As a general best practice, only call the endpoints web method when the version web method indicates that a new version is available.

Das Ergebnis der Endpunktwebmethode ist ein Array aus Datensätzen, in dem jeder Datensatz einen bestimmten Endpunktsatz darstellt.The result from the endpoints web method is an array of records in which each record represents a specific endpoint set. Die Elemente für jeden Datensatz sind:The elements for each record are:

  • id – die unveränderliche ID-Nummer des Endpunktsatzes.id — The immutable id number of the endpoint set.
  • serviceArea – der Servicebereich, zu dem Folgendes gehört: Common, Exchange, SharePoint oder Skype.serviceArea — The service area that this is part of: Common, Exchange, SharePoint, or Skype.
  • urls – URLs für den Endpunktsatz.urls — URLs for the endpoint set. ein JSON-Array von DNS-Einträgen.A JSON array of DNS records. Weggelassen, falls leer.Omitted if blank.
  • tcpPorts – TCP-Ports für den Endpunktsatz.tcpPorts — TCP ports for the endpoint set. Alle Ports-Elemente sind als eine durch Trennzeichen getrennte Liste von Ports oder Portbereichen formatiert, die durch einen Bindestrich (-) getrennt sind.All ports elements are formatted as a comma-separated list of ports or port ranges separated by a dash character (-). Ports werden auf alle IP-Adressen und alle URLs im Endpunktsatz für eine bestimmte Kategorie angewendet.Ports apply to all IP addresses and all URLs in the endpoint set for a given category. Weggelassen, falls leer.Omitted if blank.
  • udpPorts – UDP-Ports für die IP-Adressbereiche in diesem Endpunktsatz.udpPorts — UDP ports for the IP address ranges in this endpoint set. Weggelassen, falls leer.Omitted if blank.
  • ips – die zu diesem Endpunktsatz gehörigen IP-Adressbereiche (den aufgeführten TCP- oder UDP-Ports zugeordnet).ips — The IP address ranges associated with this endpoint set as associated with the listed TCP or UDP ports. ein JSON-Array von IP-Adressbereichen.A JSON array of IP address ranges. Weggelassen, falls leer.Omitted if blank.
  • category – die Kategorie „Konnektivität“ des Endpunktsatzes.category — The connectivity category for the endpoint set. Gültige Werte sind Optimize, Allow und Default.Valid values are Optimize, Allow, and Default. Wenn Sie die Ausgabe der Endpunktwebmethode für die Kategorie einer bestimmten IP-Adresse oder URL durchsuchen, kann die Abfrage mehrere Kategorien zurückgeben.If you search the endpoints web method output for the category of a specific IP address or URL, it is possible that your query will return multiple categories. Folgen Sie in diesem Fall der Empfehlung für die Kategorie mit der höchsten Priorität.In such a case, follow the recommendation for the highest priority category. Wenn der Endpunkt beispielsweise sowohl in Optimize als auch Allow angezeigt wird, sollten Sie den Anforderungen für Optimize entsprechen.For example, if the endpoint appears in both Optimize and Allow, you should follow the requirements for Optimize. Erforderlich.Required.
  • expressRoute – True, wenn dieser Endpunktsatz über ExpressRoute weitergeleitet wird; False, wenn nicht.expressRoute — True if this endpoint set is routed over ExpressRoute, False if not.
  • required – True, wenn für diesen Endpunktsatz Konnektivität erforderlich ist, damit Office 365 unterstützt wird.required — True if this endpoint set is required to have connectivity for Office 365 to be supported. False, wenn dieser Endpunktsatz optional ist.False if this endpoint set is optional.
  • notes – für optionale Endpunkte beschreibt dieser Text die Office 365-Funktionalität, die nicht verfügbar wäre, wenn der Zugriff auf IP-Adressen oder URLs in diesem Endpunktsatz nicht auf Netzwerkebene möglich ist.notes — For optional endpoints, this text describes Office 365 functionality that would be unavailable if IP addresses or URLs in this endpoint set cannot be accessed at the network layer. Weggelassen, falls leer.Omitted if blank.

Beispiele:Examples:

Anfrage-URI – Beispiel 1: https://endpoints.office.com/endpoints/Worldwide?ClientRequestId=b10c5ed1-bad1-445f-b386-b919946339a7Example 1 request URI: https://endpoints.office.com/endpoints/Worldwide?ClientRequestId=b10c5ed1-bad1-445f-b386-b919946339a7

Dieser URI ruft alle Endpunkte für die Instanz von Office 365 weltweit für alle Workloads ab.This URI obtains all endpoints for the Office 365 worldwide instance for all workloads. Das Beispielergebnis zeigt einen Auszug der Ausgabe:Example result that shows an excerpt of the output:

[
 {
  "id": 1,
  "serviceArea": "Exchange",
  "serviceAreaDisplayName": "Exchange Online",
  "urls":
   [
    "*.protection.outlook.com"
   ],
  "ips":
   [
    "2a01:111:f403::/48", "23.103.132.0/22", "23.103.136.0/21", "23.103.198.0/23", "23.103.212.0/22", "40.92.0.0/14", "40.107.0.0/17", "40.107.128.0/18", "52.100.0.0/14", "213.199.154.0/24", "213.199.180.128/26", "94.245.120.64/26", "207.46.163.0/24", "65.55.88.0/24", "216.32.180.0/23", "23.103.144.0/20", "65.55.169.0/24", "207.46.100.0/24", "2a01:111:f400:7c00::/54", "157.56.110.0/23", "23.103.200.0/22", "104.47.0.0/17", "2a01:111:f400:fc00::/54", "157.55.234.0/24", "157.56.112.0/24", "52.238.78.88/32"
   ],
  "tcpPorts": "443",
  "expressRoute": true,
  "category": "Allow"
 },
 {
  "id": 2,
  "serviceArea": "Exchange",
  "serviceAreaDisplayName": "Exchange Online",
  "urls":
   [
    "*.mail.protection.outlook.com"
   ],

Beachten Sie, dass die vollständige Ausgabe der Anforderung in diesem Beispiel weitere Endpunktsätze enthalten würde.Note that the full output of the request in this example would contain other endpoint sets.

Anfrage-URI – Beispiel 2: https://endpoints.office.com/endpoints/Worldwide?ServiceAreas=Exchange&ClientRequestId=b10c5ed1-bad1-445f-b386-b919946339a7Example 2 request URI: https://endpoints.office.com/endpoints/Worldwide?ServiceAreas=Exchange&ClientRequestId=b10c5ed1-bad1-445f-b386-b919946339a7

In diesem Beispiel werden nur Endpunkte für die Instanz von Office 365 weltweit für Exchange Online und Abhängigkeiten abgerufen.This example obtains endpoints for the Office 365 Worldwide instance for Exchange Online and dependencies only.

Die Ausgabe für Beispiel 2 ähnelt Beispiel 1 mit dem Unterschied, dass die Ergebnisse keine Endpunkte für SharePoint Online oder Skype for Business Online enthalten würden.The output for example 2 is similar to example 1 except that the results would not include endpoints for SharePoint Online or Skype for Business Online.

ÄnderungswebmethodeChanges web method

Die Änderungswebmethode gibt die neuesten Updates zurück, die veröffentlicht wurden, typischerweise die Änderungen des vorherigen Monats an IP-Adressbereichen und URLs.The changes web method returns the most recent updates that have been published, typically the previous month's changes to IP address ranges and URLs.

Die wichtigsten Änderungen an Endpunktdaten sind neue URLs und IP-Adressen.The most critical changes to endpoints data are new URLs and IP addresses. Wenn eine IP-Adresse nicht zu einer Firewall-Zugriffssteuerungsliste oder eine URL nicht zu einer Proxyserver-Umgehungsliste hinzugefügt wird, kann dies zu einem Ausfall für Benutzer von Office 365 auf diesem Netzwerkgerät führen.Failure to add an IP address to a firewall access control list or a URL to a proxy server bypass list can cause an outage for Office 365 users behind that network device. Ungeachtet betrieblicher Anforderungen werden neue Endpunkte 30 Tage vor dem Datum, an dem die Endpunkte bereitgestellt werden, im Webdienst veröffentlicht, um Ihnen Zeit zum Aktualisieren von Zugriffssteuerungs- und Proxyserver-Umgehungslisten zu lassen.Notwithstanding operational requirements, new endpoints are published to the web service 30 days in advance of the date the endpoints are provisioned for use to give you time to update access control lists and proxy server bypass lists.

Die nötigen Parameter für die Änderungswebmethode sind:The required parameter for the changes web method is:

  • Version=<YYYYMMDDNN> – Erforderlicher URL-Routenparameter.Version=<YYYYMMDDNN> — Required URL route parameter. Dieser Wert steht für die Version, die derzeit implementiert ist.This value is the version that you have currently implemented. Der Webdienst wird die Änderungen seit dieser Version zurückgeben.The web service will return the changes since that version. Das Format ist JJJJMMTTNN, wobei NN eine natürliche Zahl ist, die erhöht wird, falls mehrere Versionen am gleichen Tag herausgegeben werden müssen. Dabei steht 00 für das erste Update an einen bestimmten Tag.The format is YYYYMMDDNN, where NN is a natural number incremented if there are multiple versions required to be published on a single day, with 00 representing the first update for a given day. Der Webdienst erfordert, dass der Versions-Parameter genau 10 Ziffern enthält.The web service requires the version parameter to contain exactly 10 digits.

Für die Änderungswebmethode sind die Gebühren auf dieselbe Art und Weise beschränkt wie bei der Endpunktwebmethode.The changes web method is rate limited in the same way as the endpoints web method. Wenn Sie einen 429-HTTP-Antwortcode erhalten, warten Sie eine Stunde, bevor Sie Ihre Anforderung wiederholen, oder generieren Sie eine neue GUID für sie.If you receive a 429 HTTP response code, wait 1 hour before repeating your request or generate a new GUID for the request.

Das Ergebnis der Änderungswebmethode ist ein Array aus Datensätzen, in dem jeder Datensatz eine Änderung in einer bestimmten Version der Endpunkte darstellt.The result from the changes web method is an array of records in which each record represents a change in a specific version of the endpoints. Die Elemente für jeden Datensatz sind:The elements for each record are:

  • id – die unveränderliche ID des Änderungsdatensatzes.id — The immutable id of the change record.
  • endpointSetId – die ID des Endpunktsatz-Datensatzes, der geändert wird.endpointSetId — The ID of the endpoint set record that is changed.
  • disposition – beschreibt, was die Änderung am Endpunktsatz bewirkt hat.disposition — Describes what the change did to the endpoint set record. Die Werte sind change, add oder remove.Values are change, add, or remove.
  • Auswirkung – nicht alle Änderungen sind für jede Umgebung gleichermaßen wichtig.impact — Not all changes will be equally important to every environment. Dieses Element beschreibt die erwartete Wirkung auf die Umgebung eines Unternehmensnetzwerkumkreises infolge dieser Änderung.This element describes the expected impact to an enterprise network perimeter environment as a result of this change. Dieses Element wird nur in Änderungsdatensätze der Version 2018112800 und höher einbezogen.This element is included only in change records of version 2018112800 and later. Die Optionen für die Wirkung sind: AddedIp – eine IP-Adresse wurde zu Office 365 hinzugefügt und ist in Kürze im Dienst online.Options for the impact are: — AddedIp – An IP address was added to Office 365 and will be live on the service soon. Dies stellt eine Änderung dar, die Sie an einer Firewall oder einem anderem Netzwerkumkreisgerät der Schicht 3 vornehmen müssen.This represents a change you need to take on a firewall or other layer 3 network perimeter device. Wenn Sie dies nicht hinzufügen, bevor wir starten, erleben Sie möglicherweise einen Ausfall.If you don’t add this before we start using it, you may experience an outage. – AddedUrl – ein URL wurde Office 365 hinzugefügt und ist in Kürze im Dienst live.— AddedUrl – A URL was added to Office 365 and will be live on the service soon. Dies stellt eine Änderung dar, die Sie auf einem Netzwerkumkreisgerät für die Proxyserver- oder URL-Analyse vornehmen müssen.This represents a change you need to take on a proxy server or URL parsing network perimeter device. Wenn Sie diesen URL nicht hinzufügen, bevor wir starten, erleben Sie möglicherweise einen Ausfall.If you don’t add this URL before we start using it, you may experience an outage. – AddedIpAndUrl: Sowohl eine IP-Adresse als auch ein URL wurden hinzugefügt.— AddedIpAndUrl — Both an IP address and a URL were added. Dies stellt eine Änderung dar, die Sie entweder auf einem Firewall-Gerät der Schicht 3 oder einem Gerät zur Proxyserver- oder URL-Analyse vornehmen müssen.This represents a change you need to take on either a firewall layer 3 device or a proxy server or URL parsing device. Wenn Sie diese IP bzw. URL nicht hinzufügen, bevor wir starten, erleben Sie möglicherweise einen Ausfall.If you don’t add this IP/URL pair before we start using it, you may experience an outage. – RemovedIpOrUrl: Mindestens eine IP-Adresse oder URL wurde aus Office 365 entfernt.— RemovedIpOrUrl – At least one IP address or URL was removed from Office 365. Sie entfernen die Netzwerkendpunkte von ihren Umkreisgeräten, aber dafür gibt es keinen Stichtag.Remove the network endpoints from your perimeter devices, but there’s no deadline for you to do this. – ChangedIsExpressRoute: Das Supportattribut „Express Route“ wurde geändert.— ChangedIsExpressRoute – The ExpressRoute support attribute was changed. Wenn Sie ExpressRoute verwenden, müssen Sie möglicherweise je nach Konfiguration Maßnahmen ergreifen.If you use ExpressRoute, you might need to take action depending on your configuration. – MovedIpOrUrl: Eine IP-Adresse oder URL wurde zwischen diesem Endpunktsatz und einem anderen verschoben.— MovedIpOrUrl – We moved an IP address or Url between this endpoint set and another one. Im Allgemeinen ist keine Aktion erforderlich.Generally no action is required. – RemovedDuplicateIpOrUrl: Eine doppelte IP-Adresse oder URL wurde entfernt, diese ist aber immer noch für Office 365 veröffentlicht.— RemovedDuplicateIpOrUrl – We removed a duplicate IP address or Url but it’s still published for Office 365. Im Allgemeinen ist keine Aktion erforderlich.Generally no action is required. – OtherNonPriorityChanges: Es wurde etwas weniger wichtiges als alle anderen Optionen geändert, z. B. die Inhalte eines Notizfelds.— OtherNonPriorityChanges – We changed something less critical than all of the other options, such as the contents of a note field.
  • version – die Version des veröffentlichten Endpunktsatzes, in dem die Änderung eingeführt wurde.version — The version of the published endpoint set in which the change was introduced. Versionsnummern besitzen das Format JJJJMMTTNN, wobei NN eine natürliche Zahl ist, die erhöht wird, falls mehrere Versionen am gleichen Tag herausgegeben werden sollen.Version numbers are of the format YYYYMMDDNN, where NN is a natural number incremented if there are multiple versions required to be published on a single day.
  • previous – eine Unterstruktur, die vorherige Werte von Änderungselementen im Endpunktsatz angibt.previous — A substructure detailing previous values of changed elements on the endpoint set. Dies ist bei neu hinzugefügten Endpunktsätzen nicht enthalten.This will not be included for newly added endpoint sets. Umfasst ExpressRoute, serviceArea, category, required, tcpPorts, udpPorts und notes.Includes ExpressRoute, serviceArea, category, required, tcpPorts, udpPorts, and notes.
  • current – eine Unterstruktur, die aktualisierte Werte von Änderungselementen im Endpunktsatz angibt.current — A substructure detailing updated values of changes elements on the endpoint set. Umfasst ExpressRoute, serviceArea, category, required, tcpPorts, udpPorts und notes.Includes ExpressRoute, serviceArea, category, required, tcpPorts, udpPorts, and notes.
  • add – eine Unterstruktur, die Elemente angibt, die zu Endpunktsatzsammlungen hinzugefügt werden sollen.add — A substructure detailing items to be added to endpoint set collections. Wird weggelassen, wenn es keine Ergänzungen gibt.Omitted if there are no additions. – effectiveDate: definiert die Daten, wann die Ergänzungen live im Dienst sind.— effectiveDate — Defines the data when the additions will be live in the service. – ips: Elemente, die dem Array ips hinzugefügt werden sollen.— ips — Items to be added to the ips array. – urls: Elemente, die zum Array urls hinzugefügt werden sollen.— urls- Items to be added to the urls array.
  • remove – eine Unterstruktur, die aus dem Endpunktsatz zu entfernende Elemente angibt.remove — A substructure detailing items to be removed from the endpoint set. Wird weggelassen, wenn es keine Entfernungen gibt.Omitted if there are no removals. – ips: Elemente, die aus dem Array ips entfernt werden sollen.— ips — Items to be removed from the ips array. – urls: Elemente, die aus dem Array urls entfernt werden sollen.— urls- Items to be removed from the urls array.

Beispiele:Examples:

Anfrage-URI – Beispiel 1: https://endpoints.office.com/changes/worldwide/0000000000?ClientRequestId=b10c5ed1-bad1-445f-b386-b919946339a7Example 1 request URI: https://endpoints.office.com/changes/worldwide/0000000000?ClientRequestId=b10c5ed1-bad1-445f-b386-b919946339a7

Dies fordert alle vorherigen Änderungen an der Dienstinstanz von Office 365 weltweit an. Beispielergebnis:This requests all previous changes to the Office 365 worldwide service instance. Example result:

[
 {
  "id": 424,
  "endpointSetId": 32,
  "disposition": "Change",
  "version": "2018062700",
  "remove":
   {
    "urls":
     [
      "*.api.skype.com", "skypegraph.skype.com"
     ]
   }
 },
 {
  "id": 426,
  "endpointSetId": 31,
  "disposition": "Change",
  "version": "2018062700",
  "add":
   {
    "effectiveDate": "20180609",
    "ips":
     [
      "51.140.203.190/32"
     ]
   },
  "remove":
   {
    "ips":
     [

Anfrage-URI – Beispiel 2: https://endpoints.office.com/changes/worldwide/2018062700?ClientRequestId=b10c5ed1-bad1-445f-b386-b919946339a7Example 2 request URI: https://endpoints.office.com/changes/worldwide/2018062700?ClientRequestId=b10c5ed1-bad1-445f-b386-b919946339a7

Dies fordert Änderungen seit der angegebenen Version der Instanz von Office 365 weltweite an. Die angegebene Version ist in diesem Fall die neueste. Beispielergebnis:This requests changes since the specified version to the Office 365 Worldwide instance. In this case, the version specified is the latest. Example result:

[
  {
    "id":3,
    "endpointSetId":33,
    "changeDescription":"Removing old IP prefixes",
    "disposition":"Change",
    "version":"2018031301",
    "remove":{
      "ips":["65.55.127.0/24","66.119.157.192/26","66.119.158.0/25",
      "111.221.76.128/25","111.221.77.0/26","207.46.5.0/24"]
    }
  },
  {
    "id":4,
    "endpointSetId":45,
    "changeDescription":"Removing old IP prefixes",
    "disposition":"Change",
    "version":"2018031301",
    "remove":{
      "ips":["13.78.93.8/32","40.113.87.220/32","40.114.149.220/32",
      "40.117.100.83/32","40.118.214.164/32","104.208.31.113/32"]
    }
  }
]

PowerShell-SkriptExample PowerShell Script

Sie können dieses PowerShell-Skript ausführen, um festzustellen, ob es Aktionen gibt, die Sie für aktualisierte Daten setzen müssen.You can run this PowerShell script to see if there are actions you need to take for updated data. Sie können dieses Skript als geplante Aufgabe ausführen, um nach einer Versionsaktualisierung zu suchen.You can run this script as a scheduled task to check for a version update. Um zu vermeiden, dass der Webdienst überlastet ist, versuchen Sie, das Skript nicht mehr als einmal pro Stunde auszuführen.To avoid excessive load on the web service, try not to run the script more than once an hour.

Dieses Skript führt folgende Aktionen aus:The script does the following:

  • Überprüfen der Versionsnummer der aktuellen Office 365 weltweit-Instanzendpunkte durch Aufrufen der Webdienst-REST-API.Checks the version number of the current Office 365 Worldwide instance endpoints by calling the web service REST API.

  • Suchen nach einer aktuellen Versionsdatei unter $Env:TEMP\O365_endpoints_latestversion.txt.Checks for a current version file at $Env:TEMP\O365_endpoints_latestversion.txt. Der Pfad der globalen Variablen $Env:TEMP ist in der Regel C:\Users\<username>\AppData\Local\Temp.The path of the global variable $Env:TEMP is usually C:\Users\<username>\AppData\Local\Temp.

  • Wenn dies das erste Mal ist, dass das Skript ausgeführt wurde, gibt es die aktuelle Version sowie alle aktuellen IP-Adressen und URLs zurück, schreibt die Endpunkt-Version in die Datei $Env:TEMP\O365_endpoints_latestversion.txt und die Endpunkt-Datenausgabe in die Datei $Env:TEMP\O365_endpoints_data.txt.If this is the first time the script has been run, the script returns the current version and all current IP addresses and URLs, writes the endpoints version to the file $Env:TEMP\O365_endpoints_latestversion.txt and the endpoints data output to the file $Env:TEMP\O365_endpoints_data.txt. Sie können den Pfad und/oder den Namen der Ausgabedatei ändern, indem Sie die folgenden Zeilen bearbeiten:You can modify the path and/or name of the output file by editing these lines:

    $versionpath = $Env:TEMP + "\O365_endpoints_latestversion.txt"
    $datapath = $Env:TEMP + "\O365_endpoints_data.txt"
    
  • Wenn die neueste Webdienst-Version bei jeder nachfolgenden Ausführung des Skripts mit der Version in der Datei O365_endpoints_latestversion.txt identisch ist, wird das Skript beendet, ohne Änderungen vorzunehmen.On each subsequent execution of the script, if the latest web service version is identical to the version in the O365_endpoints_latestversion.txt file, the script exits without making any changes.

  • Wenn die neueste Webdienst-Version neuer als die Version in der Datei O365_endpoints_latestversion.txt ist, gibt das Skript die Endpunkte und Filter für die Endpunkte der Kategorien Allow und Optimize zurück, aktualisiert die Version in der Datei O365_endpoints_latestversion.txt und schreibt die aktualisierten Daten in die Datei O365_endpoints_data.txt.When the latest web service version is newer than the version in the O365_endpoints_latestversion.txt file, the script returns the endpoints and filters for the Allow and Optimize category endpoints, updates the version in the O365_endpoints_latestversion.txt file, and writes the updated data to the O365_endpoints_data.txt file.

Das Skript generiert eine eindeutige ClientRequestId für den Computer, auf dem es ausgeführt wird, und verwendet diese ID über mehrere Aufrufe hinweg.The script generates a unique ClientRequestId for the computer it is executed on, and reuses this ID across multiple calls. Diese ID wird in der Datei O365_endpoints_latestversion.txt gespeichert.This ID is stored in the O365_endpoints_latestversion.txt file.

Ausführen des PowerShell-SkriptsTo run the PowerShell script

  1. Kopieren Sie das Skript, und speichern Sie es auf der Festplatte oder am Speicherort des Skripts als Get-O365WebServiceUpdates.ps1.Copy the script and save it to your local hard drive or script location as Get-O365WebServiceUpdates.ps1.

  2. Führen Sie das Skript in Ihrem bevorzugten Skript-Editor, z. B. PowerShell ISE oder VS Code, oder auf einer PowerShell-Konsole mithilfe des folgenden Befehls aus:Execute the script in your preferred script editor such as the PowerShell ISE or VS Code, or from a PowerShell console using the following command:

    powershell.exe -file <path>\Get-O365WebServiceUpdates.ps1
    

    Es gibt keine Parameter, die an das Skript weiterzugeben sind.There are no parameters to pass to the script.

<# Get-O365WebServiceUpdates.ps1
From https://aka.ms/ipurlws
v1.1 8/6/2019

DESCRIPTION
This script calls the REST API of the Office 365 IP and URL Web Service (Worldwide instance)
and checks to see if there has been a new update since the version stored in an existing
$Env:TEMP\O365_endpoints_latestversion.txt file in your user directory's temp folder
(usually C:\Users\<username>\AppData\Local\Temp).
If the file doesn't exist, or the latest version is newer than the current version in the
file, the script returns IPs and/or URLs that have been changed, added or removed in the latest
update and writes the new version and data to the output file $Env:TEMP\O365_endpoints_data.txt.

USAGE
Run as a scheduled task every 60 minutes.

PARAMETERS
n/a

PREREQUISITES
PS script execution policy: Bypass
PowerShell 3.0 or later
Does not require elevation
#>

#Requires -Version 3.0

# web service root URL
$ws = "https://endpoints.office.com"
# path where output files will be stored
$versionpath = $Env:TEMP + "\O365_endpoints_latestversion.txt"
$datapath = $Env:TEMP + "\O365_endpoints_data.txt"

# fetch client ID and version if version file exists; otherwise create new file and client ID
if (Test-Path $versionpath) {
    $content = Get-Content $versionpath
    $clientRequestId = $content[0]
    $lastVersion = $content[1]
    Write-Output ("Version file exists! Current version: " + $lastVersion)
}
else {
    Write-Output ("First run! Creating version file at " + $versionpath + ".")
    $clientRequestId = [GUID]::NewGuid().Guid
    $lastVersion = "0000000000"
    @($clientRequestId, $lastVersion) | Out-File $versionpath
}

# call version method to check the latest version, and pull new data if version number is different
$version = Invoke-RestMethod -Uri ($ws + "/version/Worldwide?clientRequestId=" + $clientRequestId)
if ($version.latest -gt $lastVersion) {
    Write-Host "New version of Office 365 worldwide commercial service instance endpoints detected"
    # write the new version number to the version file
    @($clientRequestId, $version.latest) | Out-File $versionpath
    # invoke endpoints method to get the new data
    $endpointSets = Invoke-RestMethod -Uri ($ws + "/endpoints/Worldwide?clientRequestId=" + $clientRequestId)
    # filter results for Allow and Optimize endpoints, and transform these into custom objects with port and category
    # URL results
    $flatUrls = $endpointSets | ForEach-Object {
        $endpointSet = $_
        $urls = $(if ($endpointSet.urls.Count -gt 0) { $endpointSet.urls } else { @() })
        $urlCustomObjects = @()
        if ($endpointSet.category -in ("Allow", "Optimize")) {
            $urlCustomObjects = $urls | ForEach-Object {
                [PSCustomObject]@{
                    category = $endpointSet.category;
                    url      = $_;
                    tcpPorts = $endpointSet.tcpPorts;
                    udpPorts = $endpointSet.udpPorts;
                }
            }
        }
        $urlCustomObjects
    }
    # IPv4 results
    $flatIp4s = $endpointSets | ForEach-Object {
        $endpointSet = $_
        $ips = $(if ($endpointSet.ips.Count -gt 0) { $endpointSet.ips } else { @() })
        # IPv4 strings contain dots
        $ip4s = $ips | Where-Object { $_ -like '*.*' }
        $ip4CustomObjects = @()
        if ($endpointSet.category -in ("Allow", "Optimize")) {
            $ip4CustomObjects = $ip4s | ForEach-Object {
                [PSCustomObject]@{
                    category = $endpointSet.category;
                    ip = $_;
                    tcpPorts = $endpointSet.tcpPorts;
                    udpPorts = $endpointSet.udpPorts;
                }
            }
        }
        $ip4CustomObjects
    }
    # IPv6 results
    $flatIp6s = $endpointSets | ForEach-Object {
        $endpointSet = $_
        $ips = $(if ($endpointSet.ips.Count -gt 0) { $endpointSet.ips } else { @() })
        # IPv6 strings contain colons
        $ip6s = $ips | Where-Object { $_ -like '*:*' }
        $ip6CustomObjects = @()
        if ($endpointSet.category -in ("Optimize")) {
            $ip6CustomObjects = $ip6s | ForEach-Object {
                [PSCustomObject]@{
                    category = $endpointSet.category;
                    ip = $_;
                    tcpPorts = $endpointSet.tcpPorts;
                    udpPorts = $endpointSet.udpPorts;
                }
            }
        }
        $ip6CustomObjects
    }

    # write output to screen
    Write-Output ("Client Request ID: " + $clientRequestId)
    Write-Output ("Last Version: " + $lastVersion)
    Write-Output ("New Version: " + $version.latest)
    Write-Output ""
    Write-Output "IPv4 Firewall IP Address Ranges"
    ($flatIp4s.ip | Sort-Object -Unique) -join "," | Out-String
    Write-Output "IPv6 Firewall IP Address Ranges"
    ($flatIp6s.ip | Sort-Object -Unique) -join "," | Out-String
    Write-Output "URLs for Proxy Server"
    ($flatUrls.url | Sort-Object -Unique) -join "," | Out-String
    Write-Output ("IP and URL data written to " + $datapath)

    # write output to data file
    Write-Output "Office 365 IP and UL Web Service data" | Out-File $datapath
    Write-Output "Worldwide instance" | Out-File $datapath -Append
    Write-Output "" | Out-File $datapath -Append
    Write-Output ("Version: " + $version.latest) | Out-File $datapath -Append
    Write-Output "" | Out-File $datapath -Append
    Write-Output "IPv4 Firewall IP Address Ranges" | Out-File $datapath -Append
    ($flatIp4s.ip | Sort-Object -Unique) -join "," | Out-File $datapath -Append
    Write-Output "" | Out-File $datapath -Append
    Write-Output "IPv6 Firewall IP Address Ranges" | Out-File $datapath -Append
    ($flatIp6s.ip | Sort-Object -Unique) -join "," | Out-File $datapath -Append
    Write-Output "" | Out-File $datapath -Append
    Write-Output "URLs for Proxy Server" | Out-File $datapath -Append
    ($flatUrls.url | Sort-Object -Unique) -join "," | Out-File $datapath -Append
}
else {
    Write-Host "Office 365 worldwide commercial service instance endpoints are up-to-date."
}

Python-BeispielskriptExample Python Script

Hier ist ein Python-Skript, das mit Python 3.6.3 unter Windows 10 getestet wurde. Sie können es ausführen, um festzustellen, ob es Aktionen gibt, die Sie für aktualisierte Daten ausführen müssen. Dieses Skript überprüft die Versionsnummer für Endpunkte mit der Instanz von Office 365 weltweit. Wenn eine Änderung vorhanden ist, lädt es die Endpunkte herunter und filtert nach den Endpunkten der Kategorie Zulassen und Optimieren. Außerdem verwendet es eine eindeutige ClientRequestId über mehrere Anrufe hinweg und speichert die aktuelle Version in einer temporären Datei. Sie sollten dieses Skript einmal pro Stunde aufrufen, um zu überprüfen, ob ein Versionsupdate vorhanden ist.Here is a Python script, tested with Python 3.6.3 on Windows 10, that you can run to see if there are actions you need to take for updated data. This script checks the version number for the Office 365 Worldwide instance endpoints. When there is a change, it downloads the endpoints and filters for the Allow and Optimize category endpoints. It also uses a unique ClientRequestId across multiple calls and saves the latest version found in a temporary file. You should call this script once an hour to check for a version update.

import json
import tempfile
from pathlib import Path
import urllib.request
import uuid
# helper to call the webservice and parse the response
def webApiGet(methodName, instanceName, clientRequestId):
    ws = "https://endpoints.office.com"
    requestPath = ws + '/' + methodName + '/' + instanceName + '?clientRequestId=' + clientRequestId
    request = urllib.request.Request(requestPath)
    with urllib.request.urlopen(request) as response:
        return json.loads(response.read().decode())
# path where client ID and latest version number will be stored
datapath = Path(tempfile.gettempdir() + '/endpoints_clientid_latestversion.txt')
# fetch client ID and version if data exists; otherwise create new file
if datapath.exists():
    with open(datapath, 'r') as fin:
        clientRequestId = fin.readline().strip()
        latestVersion = fin.readline().strip()
else:
    clientRequestId = str(uuid.uuid4())
    latestVersion = '0000000000'
    with open(datapath, 'w') as fout:
        fout.write(clientRequestId + '\n' + latestVersion)
# call version method to check the latest version, and pull new data if version number is different
version = webApiGet('version', 'Worldwide', clientRequestId)
if version['latest'] > latestVersion:
    print('New version of Office 365 worldwide commercial service instance endpoints detected')
    # write the new version number to the data file
    with open(datapath, 'w') as fout:
        fout.write(clientRequestId + '\n' + version['latest'])
    # invoke endpoints method to get the new data
    endpointSets = webApiGet('endpoints', 'Worldwide', clientRequestId)
    # filter results for Allow and Optimize endpoints, and transform these into tuples with port and category
    flatUrls = []
    for endpointSet in endpointSets:
        if endpointSet['category'] in ('Optimize', 'Allow'):
            category = endpointSet['category']
            urls = endpointSet['urls'] if 'urls' in endpointSet else []
            tcpPorts = endpointSet['tcpPorts'] if 'tcpPorts' in endpointSet else ''
            udpPorts = endpointSet['udpPorts'] if 'udpPorts' in endpointSet else ''
            flatUrls.extend([(category, url, tcpPorts, udpPorts) for url in urls])
    flatIps = []
    for endpointSet in endpointSets:
        if endpointSet['category'] in ('Optimize', 'Allow'):
            ips = endpointSet['ips'] if 'ips' in endpointSet else []
            category = endpointSet['category']
            # IPv4 strings have dots while IPv6 strings have colons
            ip4s = [ip for ip in ips if '.' in ip]
            tcpPorts = endpointSet['tcpPorts'] if 'tcpPorts' in endpointSet else ''
            udpPorts = endpointSet['udpPorts'] if 'udpPorts' in endpointSet else ''
            flatIps.extend([(category, ip, tcpPorts, udpPorts) for ip in ip4s])
    print('IPv4 Firewall IP Address Ranges')
    print(','.join(sorted(set([ip for (category, ip, tcpPorts, udpPorts) in flatIps]))))
    print('URLs for Proxy Server')
    print(','.join(sorted(set([url for (category, url, tcpPorts, udpPorts) in flatUrls]))))

    # TODO send mail (e.g. with smtplib/email modules) with new endpoints data
else:
    print('Office 365 worldwide commercial service instance endpoints are up-to-date')

Versionsverwaltung der WebdienstschnittstelleWeb Service interface versioning

Möglicherweise sind Updates für die Parameter oder Ergebnisse für diese Webdienstmethoden zukünftig erforderlich.Updates to the parameters or results for these web service methods may be required in the future. Nach der Veröffentlichung der allgemein verfügbaren Version dieser Webdienste wird Microsoft angemessene Anstrengungen unternehmen, um die Aktualisierung des Webdiensts im Voraus anzukündigen.After the general availability version of these web services is published, Microsoft will make reasonable efforts to provide advance notice of material updates to the web service. Wenn Microsoft der Auffassung ist, dass für ein Update Änderungen an Clients nötig sind, die den Webdienst verwenden, wird Microsoft die vorherige Version (um eine Version älter) des Webdienstes für mindestens 12 Monate nach der Veröffentlichung der neuen Version verfügbar halten.When Microsoft believes that an update will require changes to clients using the web service, Microsoft will keep the previous version (one version back) of the web service available for at least 12 months after the release of the new version. Kunden, die während dieses Zeitraums kein Upgrade durchführen, können möglicherweise nicht auf den Webdienst und seine Methoden zugreifen.Customers who do not upgrade during that time may be unable to access the web service and its methods. Kunden müssen sicherstellen, dass die Clients des Webdiensts fehlerfrei weiterarbeiten, wenn die folgenden Änderungen an der Signatur der Webdienstschnittstelle vorgenommen werden:Customers must ensure that clients of the web service continue working without error if the following changes are made to the web service interface signature:

  • Hinzufügen eines neuen optionalen Parameters zu einer vorhandenen Webmethode, die nicht notwendigerweise von älteren Clients bereitgestellt werden muss und das Ergebnis nicht beeinträchtigt, das ein älterer Client erhält.Adding a new optional parameter to an existing web method that doesn't have to be provided by older clients and doesn't impact the result an older client receives.
  • Hinzufügen eines neuen benannten Attributs zu einem der REST-Antwortelemente oder zusätzlicher Spalten zur Antwort-CSV.Adding a new named attribute in one of the response REST items or additional columns to the response CSV.
  • Hinzufügen einer neuen Webmethode unter einem neuen Namen, die nicht von älteren Clients aufgerufen wird.Adding a new web method with a new name that is not called by the older clients.

UpdatebenachrichtigungenUpdate notifications

Sie können einige unterschiedliche Methoden nutzen, um E-Mail-Benachrichtigungen zu erhalten, wenn Änderungen an den IP-Adressen und URLs im Webdienst veröffentlicht werden.You can use a few different methods to get email notifications when changes to the IP addresses and URLs are published to the web service.

Exportieren einer Proxy-PAC-DateiExporting a Proxy PAC file

Get-PacFile ist ein PowerShell-Skript, das die neuesten Netzwerkendpunkte aus dem IP-Adress- und URL-Webdienst von Office 365 liest und eine PAC-Beispieldatei erstellt.Get-PacFile is a PowerShell script that reads the latest network endpoints from the Office 365 IP Address and URL web service and creates a sample PAC file. Informationen zur Verwendung von Get-PacFile finden Sie unter Verwenden einer PAC-Datei für das direkte Routing von wichtigem Office 365-Datenverkehr.For information on using Get-PacFile, see Use a PAC file for direct routing of vital Office 365 traffic.

URLs und IP-Adressbereiche für Office 365Office 365 URLs and IP address ranges

Verwalten von Office 365-EndpunktenManaging Office 365 endpoints

Häufig gestellte Fragen zu Office 365-EndpunktenOffice 365 endpoints FAQ

Prinzipien von Office 365-NetzwerkverbindungenOffice 365 Network Connectivity Principles

Office 365-Netzwerk- und LeistungsoptimierungOffice 365 network and performance tuning

Bewerten der Office 365-NetzwerkkonnektivitätAssessing Office 365 network connectivity

Medienqualität und Netzwerkverbindungsleistung in Skype for Business OnlineMedia Quality and Network Connectivity Performance in Skype for Business Online

Optimieren Ihres Netzwerks für Skype for Business OnlineOptimizing your network for Skype for Business Online

Office 365-Leistungsoptimierung mit Basisplänen und LeistungsverlaufOffice 365 performance tuning using baselines and performance history

Plan zur Problembehandlung für Office 365Performance troubleshooting plan for Office 365