Verwendung von IP-Adressen migrieren

Bevor Sie einen Client auf eine API-Version migrieren 2022-03-29 oder später, überprüfen Sie Ihren Code auf die Verwendung der primary_ipv4_address Eigentum. Wie in der Beispiele, ab Version 2022-03-29, Die primary_ipv4_address Die Zeichenfolgeeigenschaft wird ersetzt durch die primary_ip Objekteigenschaft, die eine address Untereigenschaft. Daher müssen Sie alle Vorkommen von primary_ipv4_address in ersetzen, und zwar in primary_ip.address der für Ihre Programmiersprache geeigneten Weise.

Während primary_ipv4_address nur in den NetworkInterface-, NetworkInterfaceReference-und NetworkInterfacePrototype-Schemas (und ihren eng verwandten BareMetalNetworkInterface-Schemas) angezeigt wird, werden diese Schemas in der VPC-API umfassend verwendet. Obwohl sich die inkompatible Änderung auf die Eigenschaft primary_ipv4_address beschränkte, waren daher viele Operationen davon betroffen. Eine vollständige Liste finden Sie unter Geänderte Operationen.

Verwendung von Sicherheitsgruppenzuordnungen migrieren

Als Bestandteil des Release 2021-02-23 wurden Zielmethoden für Sicherheitsgruppen verfügbar gemacht und die ursprünglichen spezifischen Methoden für Netzschnittstellen, wurden nicht weiter unterstützt. In API-Version 2022-03-29 wird die Unterstützung für diese veralteten Methoden entfernt. Wie unter Beispiele gezeigt, enthalten die Zielmethoden der Sicherheitsgruppe die Funktionalität der veralteten Methoden. Sicherheitsgruppenziele ermöglichen auch die Zuordnung von Sicherheitsgruppen zu anderen VPC-Ressourcen (z. B. Endpunktgateways und Lastausgleichsfunktionen).

Von den veralteten Methoden GET und PUT wurden NetworkInterface-Antwortschemas zurückgegeben. Die neuen Methoden GET und PUT geben jedoch NetworkInterfaceReference-Antwortschemas zurück. Wenn Ihr Client über die Eigenschaften in NetworkInterfaceReference hinaus auf Eigenschaften zugegriffen hat, muss Ihr Client GET /instances/{instance_id}/network_interfaces/{id} aufrufen, um diese Eigenschaften separat abzurufen.

Wenn Ihr Client zuvor auf die Eigenschaft network_interfaces[] zugegriffen hat, die von GET /security_groups zurückgegeben wird, muss er außerdem auf die Eigenschaft targets[] zugreifen. Wenn Ihr Client über die Eigenschaften in NetworkInterfaceReference hinaus auf Eigenschaften in network_interfaces[] zugegriffen hat, müssen Sie GET /instances/{instance_id}/network_interfaces/{id} aufrufen, um diese Eigenschaften separat abzurufen.

Beispiele für IP-Adressen

In den folgenden Beispielen wird dargestellt, wie ein Aufruf POST /instances zum Bereitstellen einer Instanz mit einer bestimmten IP-Adresse in der zugehörigen primären Netzschnittstelle vor bzw. nach der versionsgesteuerten Änderung von 2022-03-29 ausgeführt wurde bzw. wird, und wie die betreffende IP-Adresse abgerufen wird.

API-Version 2022-03-28 oder niedriger angeben:

curl -X POST \
  "$vpc_api_endpoint/v1/instances?version=2022-03-28&generation=2" \
  -H "Authorization: Bearer $iam_token" \
  -d '{
        "image": {"id": "'"$image_id"'"},
        "keys": [{"id": "'"$key_id"'"}],
        "primary_network_interface": {
          "primary_ipv4_address": "10.240.0.5",
          "subnet": {"id": "'"$subnet_id"'"}
        },
        "zone": {"name": "'"$zone"'"}
      }'

So wird die Adresse abgerufen:

curl -X GET \
  "$vpc_api_endpoint/v1/instances/$instance_id?version=2022-03-28&generation=2" \
  -H "Authorization: Bearer $iam_token" | jq '.primary_network_interface.primary_ipv4_address'

API-Version 2022-03-29 oder höher angeben:

curl -X POST \
  "$vpc_api_endpoint/v1/instances?version=2022-03-29&generation=2" \
  -H "Authorization: Bearer $iam_token" \
  -d '{
        "image": {"id": "'"$image_id"'"},
        "keys": [{"id": "'"$key_id"'"}],
        "primary_network_interface": {
          "primary_ip": {
            "address": "10.240.0.5"
          },
          "subnet": {"id": "'"$subnet_id"'"}
        },
        "zone": {"name": "'"$zone"'"}
      }'

So wird die Adresse abgerufen:

curl -X GET \
  "$vpc_api_endpoint/v1/instances/$instance_id?version=2022-03-29&generation=2" \
  -H "Authorization: Bearer $iam_token" | jq '.primary_network_interface.primary_ip.address'

In den folgenden Beispielen wird dargestellt, wie ein Aufruf POST /instances/{id}/network_interface zum Erstellen einer neuen Netzschnittstelle in einer vorhandenen Instanz mit einer bestimmten IP-Adresse vor bzw. nach der versionsgesteuerten Änderung von 2022-03-29 ausgeführt wurde bzw. wird, und wie die Adresse abgerufen wird.

API-Version 2022-03-28 oder niedriger angeben:

curl -X POST \
  "$vpc_api_endpoint/v1/instances/$instance_id/network_interfaces?version=2022-03-28&generation=2" \
  -H "Authorization: Bearer $iam_token" \
  -d '{
        "primary_ipv4_address": "10.240.0.5",
        "subnet": {"id": "'"$subnet_id"'"}
      }'

So wird die Adresse abgerufen:

curl -X GET \
  "$vpc_api_endpoint/v1/instances/$instance_id/network_interfaces/$network_interface_id?version=2022-03-28&generation=2" \
  -H "Authorization: Bearer $iam_token" | jq '.primary_ipv4_address'

API-Version 2022-03-29 oder höher angeben:

curl -X POST \
  "$vpc_api_endpoint/v1/instances/$instance_id/network_interfaces?version=2022-03-29&generation=2" \
  -H "Authorization: Bearer $iam_token" \
  -d '{
        "primary_ip":
          {
           "address": "10.240.0.5"
          },
        "subnet": {"id": "'"$subnet_id"'"}
      }'

So wird die Adresse abgerufen:

curl -X GET \
  "$vpc_api_endpoint/v1/instances/$instance_id/network_interfaces/$network_interface_id?version=2022-03-29&generation=2" \
  -H "Authorization: Bearer $iam_token" | jq '.primary_ip.address'

In den Beispielen wird jq als Parser ein Drittanbieter-Tool verwendet, das unter der MIT-Lizenz lizenziert ist. Einige Betriebssysteme enthalten dies standardmäßig jq nicht. Installieren Sie diese vor jq der Verwendung oder verwenden Sie einen anderen JSON-Parser.

Beispiele für Sicherheitsgruppenzuordnungen

In den folgenden Beispielen wird dargestellt, wie eine Netzschnittstelle vor bzw. nach der versionsgesteuerten Änderung von 2022-03-29 in eine Sicherheitsgruppe eingefügt wurde bzw. wird.

API-Version 2022-03-28 oder niedriger angeben:

curl -X PUT \
  "$vpc_api_endpoint/v1/security_groups/$security_group_id/network_interfaces/$id?version=2022-03-28&generation=2" \
  -H "Authorization: Bearer $iam_token"

API-Version 2022-03-29 oder höher angeben:

curl -X PUT \
  "$vpc_api_endpoint/v1/security_groups/$security_group_id/targets/$id?version=2022-03-29&generation=2" \
  -H "Authorization: Bearer $iam_token"

In den folgenden Beispielen wird dargestellt, wie eine Netzschnittstelle vor bzw. nach der versionsgesteuerten Änderung von 2022-03-29 aus einer Sicherheitsgruppe entfernt wurde bzw. wird.

API-Version 2022-03-28 oder niedriger angeben:

curl -X DELETE \
  "$vpc_api_endpoint/v1/security_groups/$security_group_id/network_interfaces/$id?version=2022-03-28&generation=2" \
  -H "Authorization: Bearer $iam_token"

API-Version 2022-03-29 oder höher angeben:

curl -X DELETE \
  "$vpc_api_endpoint/v1/security_groups/$security_group_id/targets/$id?version=2022-03-29&generation=2" \
  -H "Authorization: Bearer $iam_token"

IP-Adressen

In der folgenden Tabelle sind die Vorgänge aufgeführt, bei denen die primary_ipv4_address gewechselt zu primary_ip in den Anforderungstexten, Antworttexten oder beiden. Ein Punkt (.) gibt an, dass primary_ipv4_address im Antwortschema der höchsten Ebene in primary_ip geändert wurde.

Sicherheitsgruppenzuordnungen

In der folgenden Tabelle sind die Methoden oder Eigenschaften aufgeführt, die im Rahmen der vollständigen Umstellung auf Sicherheitsgruppen-Ziele entfernt wurden.