Freigeben über


Public IP Prefixes - Create Or Update

Erstellt oder aktualisiert ein statisches oder dynamisches öffentliches IP-Präfix.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIpPrefixName}?api-version=2024-05-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
publicIpPrefixName
path True

string

Der Name des öffentlichen IP-Präfixes.

resourceGroupName
path True

string

Der Name der Ressourcengruppe.

subscriptionId
path True

string

Die Abonnementanmeldeinformationen, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.

api-version
query True

string

Client-API-Version.

Anforderungstext

Name Typ Beschreibung
extendedLocation

ExtendedLocation

Der erweiterte Speicherort der öffentlichen IP-Adresse.

id

string

Ressourcen-ID.

location

string

Ressourcenspeicherort.

properties.customIPPrefix

SubResource

Das customIpPrefix, dem dieses Präfix zugeordnet ist.

properties.ipTags

IpTag[]

Die Liste der Tags, die dem öffentlichen IP-Präfix zugeordnet sind.

properties.natGateway

NatGateway

NatGateway des öffentlichen IP-Präfixes.

properties.prefixLength

integer

Die Länge des öffentlichen IP-Präfixes.

properties.publicIPAddressVersion

IPVersion

Die öffentliche IP-Adressversion.

sku

PublicIPPrefixSku

Die öffentliche IP-Präfix-SKU.

tags

object

Ressourcentags.

zones

string[]

Eine Liste der Verfügbarkeitszonen, aus der die für die Ressource zugeordnete IP-Adresse angegeben wird.

Antworten

Name Typ Beschreibung
200 OK

PublicIPPrefix

Aktualisierung erfolgreich. Der Vorgang gibt die resultierende PublicIPPrefix-Ressource zurück.

201 Created

PublicIPPrefix

Erstellen Sie erfolgreich. Der Vorgang gibt die resultierende PublicIPPrefix-Ressource zurück.

Other Status Codes

CloudError

Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

Create public IP prefix allocation method
Create public IP prefix defaults

Create public IP prefix allocation method

Beispielanforderung

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/publicIPPrefixes/test-ipprefix?api-version=2024-05-01

{
  "location": "westus",
  "properties": {
    "publicIPAddressVersion": "IPv4",
    "prefixLength": 30
  },
  "sku": {
    "name": "Standard",
    "tier": "Regional"
  }
}

Beispiel für eine Antwort

{
  "name": "test-ipprefix",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/publicIPPrefixes/test-ipprefix",
  "etag": "W/\"00000000-0000-0000-0000-00000000\"",
  "location": "westus",
  "zones": [
    "1"
  ],
  "properties": {
    "provisioningState": "Succeeded",
    "resourceGuid": "00000000-0000-0000-0000-00000000",
    "publicIPAddressVersion": "IPv4",
    "prefixLength": 30,
    "ipPrefix": "192.168.254.2/30",
    "ipTags": []
  },
  "sku": {
    "name": "Standard",
    "tier": "Regional"
  },
  "type": "Microsoft.Network/publicIPPrefixes"
}
{
  "name": "test-ipprefix",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/test-ipprefix",
  "etag": "W/\"00000000-0000-0000-0000-00000000\"",
  "location": "westus",
  "zones": [
    "1"
  ],
  "properties": {
    "provisioningState": "Succeeded",
    "resourceGuid": "00000000-0000-0000-0000-00000000",
    "publicIPAddressVersion": "IPv4",
    "prefixLength": 30,
    "ipPrefix": "192.168.254.2/30",
    "ipTags": []
  },
  "sku": {
    "name": "Standard",
    "tier": "Regional"
  },
  "type": "Microsoft.Network/publicIPPrefixes"
}

Create public IP prefix defaults

Beispielanforderung

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/publicIPPrefixes/test-ipprefix?api-version=2024-05-01

{
  "location": "westus",
  "properties": {
    "prefixLength": 30
  },
  "sku": {
    "name": "Standard"
  }
}

Beispiel für eine Antwort

{
  "name": "test-ipprefix",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/publicIPPrefixes/test-ipprefix",
  "etag": "W/\"00000000-0000-0000-0000-00000000\"",
  "location": "westus",
  "properties": {
    "provisioningState": "Succeeded",
    "resourceGuid": "00000000-0000-0000-0000-00000000",
    "publicIPAddressVersion": "IPv4",
    "prefixLength": 30,
    "ipPrefix": "192.168.254.2/30",
    "ipTags": []
  },
  "sku": {
    "name": "Standard"
  },
  "type": "Microsoft.Network/publicIPPrefixes"
}
{
  "name": "test-ipprefix",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/publicIPPrefixes/test-ipprefix",
  "etag": "W/\"00000000-0000-0000-0000-00000000\"",
  "location": "westus",
  "properties": {
    "provisioningState": "Succeeded",
    "resourceGuid": "00000000-0000-0000-0000-00000000",
    "publicIPAddressVersion": "IPv4",
    "prefixLength": 30,
    "ipPrefix": "192.168.254.2/30",
    "ipTags": []
  },
  "sku": {
    "name": "Standard"
  },
  "type": "Microsoft.Network/publicIPPrefixes"
}

Definitionen

Name Beschreibung
CloudError

Eine Fehlerantwort des Diensts.

CloudErrorBody

Eine Fehlerantwort des Diensts.

ExtendedLocation

Komplexer ExtendedLocation-Typ.

ExtendedLocationTypes

Der Typ des erweiterten Speicherorts.

IpTag

Enthält das dem Objekt zugeordnete IpTag.

IPVersion

IP-Adressversion.

NatGateway

Nat Gateway-Ressource.

NatGatewaySku

SKU des NAT-Gateways.

NatGatewaySkuName

Name der NAT-Gateway-SKU.

ProvisioningState

Der aktuelle Bereitstellungsstatus.

PublicIPPrefix

Öffentliche IP-Präfixressource.

PublicIPPrefixSku

SKU eines öffentlichen IP-Präfixes.

PublicIPPrefixSkuName

Name einer öffentlichen IP-Präfix-SKU.

PublicIPPrefixSkuTier

Ebene einer öffentlichen IP-Präfix-SKU.

ReferencedPublicIpAddress

Verweisen auf eine öffentliche IP-Adresse.

SubResource

Verweisen auf eine andere Unterressource.

CloudError

Eine Fehlerantwort des Diensts.

Name Typ Beschreibung
error

CloudErrorBody

Cloudfehlertext.

CloudErrorBody

Eine Fehlerantwort des Diensts.

Name Typ Beschreibung
code

string

Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollen programmgesteuert genutzt werden.

details

CloudErrorBody[]

Eine Liste mit zusätzlichen Details zum Fehler.

message

string

Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet ist.

target

string

Das Ziel des bestimmten Fehlers. Beispielsweise der Name der Eigenschaft im Fehler.

ExtendedLocation

Komplexer ExtendedLocation-Typ.

Name Typ Beschreibung
name

string

Der Name des erweiterten Speicherorts.

type

ExtendedLocationTypes

Der Typ des erweiterten Speicherorts.

ExtendedLocationTypes

Der Typ des erweiterten Speicherorts.

Wert Beschreibung
EdgeZone

IpTag

Enthält das dem Objekt zugeordnete IpTag.

Name Typ Beschreibung
ipTagType

string

Der IP-Tagtyp. Beispiel: FirstPartyUsage.

tag

string

Der Wert des IP-Tags, das der öffentlichen IP zugeordnet ist. Beispiel: SQL.

IPVersion

IP-Adressversion.

Wert Beschreibung
IPv4
IPv6

NatGateway

Nat Gateway-Ressource.

Name Typ Beschreibung
etag

string

Eine eindeutige schreibgeschützte Zeichenfolge, die sich ändert, wenn die Ressource aktualisiert wird.

id

string

Ressourcen-ID.

location

string

Ressourcenspeicherort.

name

string

Ressourcenname.

properties.idleTimeoutInMinutes

integer

Das Leerlauftimeout des NAT-Gateways.

properties.provisioningState

ProvisioningState

Der Bereitstellungsstatus der NAT-Gatewayressource.

properties.publicIpAddresses

SubResource[]

Ein Array von öffentlichen IP-Adressen, die der NAT-Gatewayressource zugeordnet sind.

properties.publicIpPrefixes

SubResource[]

Ein Array von öffentlichen IP-Präfixen, die der Nat-Gatewayressource zugeordnet sind.

properties.resourceGuid

string

Die RESSOURCEN-GUID-Eigenschaft der NAT-Gatewayressource.

properties.subnets

SubResource[]

Ein Array von Verweisen auf die Subnetze mithilfe dieser NAT-Gatewayressource.

sku

NatGatewaySku

Die NAT-Gateway-SKU.

tags

object

Ressourcentags.

type

string

Ressourcentyp.

zones

string[]

Eine Liste der Verfügbarkeitszonen, die die Zone angeben, in der Nat-Gateway bereitgestellt werden soll.

NatGatewaySku

SKU des NAT-Gateways.

Name Typ Beschreibung
name

NatGatewaySkuName

Name der NAT-Gateway-SKU.

NatGatewaySkuName

Name der NAT-Gateway-SKU.

Wert Beschreibung
Standard

ProvisioningState

Der aktuelle Bereitstellungsstatus.

Wert Beschreibung
Deleting
Failed
Succeeded
Updating

PublicIPPrefix

Öffentliche IP-Präfixressource.

Name Typ Beschreibung
etag

string

Eine eindeutige schreibgeschützte Zeichenfolge, die sich ändert, wenn die Ressource aktualisiert wird.

extendedLocation

ExtendedLocation

Der erweiterte Speicherort der öffentlichen IP-Adresse.

id

string

Ressourcen-ID.

location

string

Ressourcenspeicherort.

name

string

Ressourcenname.

properties.customIPPrefix

SubResource

Das customIpPrefix, dem dieses Präfix zugeordnet ist.

properties.ipPrefix

string

Das zugewiesene Präfix.

properties.ipTags

IpTag[]

Die Liste der Tags, die dem öffentlichen IP-Präfix zugeordnet sind.

properties.loadBalancerFrontendIpConfiguration

SubResource

Der Verweis auf die Front-End-IP-Konfiguration des Lastenausgleichs, die dem öffentlichen IP-Präfix zugeordnet ist.

properties.natGateway

NatGateway

NatGateway des öffentlichen IP-Präfixes.

properties.prefixLength

integer

Die Länge des öffentlichen IP-Präfixes.

properties.provisioningState

ProvisioningState

Der Bereitstellungsstatus der öffentlichen IP-Präfixressource.

properties.publicIPAddressVersion

IPVersion

Die öffentliche IP-Adressversion.

properties.publicIPAddresses

ReferencedPublicIpAddress[]

Die Liste aller referenzierten PublicIPAddresses.

properties.resourceGuid

string

Die Ressourcen-GUID-Eigenschaft der öffentlichen IP-Präfixressource.

sku

PublicIPPrefixSku

Die öffentliche IP-Präfix-SKU.

tags

object

Ressourcentags.

type

string

Ressourcentyp.

zones

string[]

Eine Liste der Verfügbarkeitszonen, aus der die für die Ressource zugeordnete IP-Adresse angegeben wird.

PublicIPPrefixSku

SKU eines öffentlichen IP-Präfixes.

Name Typ Beschreibung
name

PublicIPPrefixSkuName

Name einer öffentlichen IP-Präfix-SKU.

tier

PublicIPPrefixSkuTier

Ebene einer öffentlichen IP-Präfix-SKU.

PublicIPPrefixSkuName

Name einer öffentlichen IP-Präfix-SKU.

Wert Beschreibung
Standard

PublicIPPrefixSkuTier

Ebene einer öffentlichen IP-Präfix-SKU.

Wert Beschreibung
Global
Regional

ReferencedPublicIpAddress

Verweisen auf eine öffentliche IP-Adresse.

Name Typ Beschreibung
id

string

Die PublicIPAddress-Referenz.

SubResource

Verweisen auf eine andere Unterressource.

Name Typ Beschreibung
id

string

Ressourcen-ID.