Поделиться через


Nat Gateways - Create Or Update

Создает или обновляет шлюз NAT.

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

Параметры URI

Имя В Обязательно Тип Описание
natGatewayName
path True

string

Имя шлюза NAT.

resourceGroupName
path True

string

Имя группы ресурсов.

subscriptionId
path True

string

Учетные данные подписки, которые однозначно определяют подписку Microsoft Azure. Идентификатор подписки входит в состав URI для каждого вызова службы.

api-version
query True

string

Версия КЛИЕНТСКОго API.

Текст запроса

Имя Тип Описание
id

string

Идентификатор ресурса.

location

string

Расположение ресурса.

properties.idleTimeoutInMinutes

integer

Время ожидания простоя шлюза NAT.

properties.publicIpAddresses

SubResource[]

Массив общедоступных IP-адресов, связанных с ресурсом шлюза NAT.

properties.publicIpPrefixes

SubResource[]

Массив префиксов общедоступных IP-адресов, связанных с ресурсом шлюза NAT.

sku

NatGatewaySku

Номер SKU шлюза NAT.

tags

object

Теги ресурсов.

zones

string[]

Список зон доступности, обозначающих зону, в которой должен быть развернут шлюз Nat.

Ответы

Имя Тип Описание
200 OK

NatGateway

Обновите успешно. Операция возвращает полученный ресурс NatGateway.

201 Created

NatGateway

Создайте успешное создание. Операция возвращает полученный ресурс NatGateway.

202 Accepted

Принято и операция будет выполняться асинхронно.

Other Status Codes

CloudError

Ответ на ошибку, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
user_impersonation олицетворения учетной записи пользователя

Примеры

Create nat gateway

Образец запроса

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

{
  "location": "westus",
  "sku": {
    "name": "Standard"
  },
  "properties": {
    "publicIpAddresses": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/PublicIpAddress1"
      }
    ],
    "publicIpPrefixes": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/publicIPPrefixes/PublicIpPrefix1"
      }
    ]
  }
}

Пример ответа

{
  "name": "test-natGateway",
  "sku": {
    "name": "Standard"
  },
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/natGateways/test-natGateway",
  "location": "westus",
  "properties": {
    "idleTimeoutInMinutes": 5,
    "provisioningState": "Succeeded",
    "publicIpAddresses": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/PublicIpAddress1"
      }
    ],
    "publicIpPrefixes": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/publicIPPrefixes/PublicIpPrefix1"
      }
    ],
    "subnets": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1"
      }
    ]
  },
  "type": "Microsoft.Network/natGateways"
}
{
  "name": "test-natGateway",
  "sku": {
    "name": "Standard"
  },
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/natGateways/test-natGateway",
  "location": "westus",
  "properties": {
    "idleTimeoutInMinutes": 5,
    "provisioningState": "Succeeded",
    "publicIpAddresses": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/PublicIpAddress1"
      }
    ],
    "publicIpPrefixes": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/publicIPPrefixes/PublicIpPrefix1"
      }
    ],
    "subnets": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1"
      }
    ]
  },
  "type": "Microsoft.Network/natGateways"
}

Определения

Имя Описание
CloudError

Ответ на ошибку службы.

CloudErrorBody

Ответ на ошибку службы.

NatGateway

Ресурс шлюза Nat.

NatGatewaySku

Номер SKU шлюза NAT.

NatGatewaySkuName

Имя SKU шлюза Nat.

ProvisioningState

Текущее состояние подготовки.

SubResource

Ссылка на другой подресурс.

CloudError

Ответ на ошибку службы.

Имя Тип Описание
error

CloudErrorBody

Текст ошибки облака.

CloudErrorBody

Ответ на ошибку службы.

Имя Тип Описание
code

string

Идентификатор ошибки. Коды являются инвариантными и предназначены для программного использования.

details

CloudErrorBody[]

Список дополнительных сведений об ошибке.

message

string

Сообщение, описывающее ошибку, предназначенное для отображения в пользовательском интерфейсе.

target

string

Целевой объект конкретной ошибки. Например, имя свойства в ошибке.

NatGateway

Ресурс шлюза Nat.

Имя Тип Описание
etag

string

Уникальная строка только для чтения, которая изменяется при обновлении ресурса.

id

string

Идентификатор ресурса.

location

string

Расположение ресурса.

name

string

Имя ресурса.

properties.idleTimeoutInMinutes

integer

Время ожидания простоя шлюза NAT.

properties.provisioningState

ProvisioningState

Состояние подготовки ресурса шлюза NAT.

properties.publicIpAddresses

SubResource[]

Массив общедоступных IP-адресов, связанных с ресурсом шлюза NAT.

properties.publicIpPrefixes

SubResource[]

Массив префиксов общедоступных IP-адресов, связанных с ресурсом шлюза NAT.

properties.resourceGuid

string

Свойство GUID ресурса ресурса шлюза NAT.

properties.subnets

SubResource[]

Массив ссылок на подсети с помощью этого ресурса шлюза NAT.

sku

NatGatewaySku

Номер SKU шлюза NAT.

tags

object

Теги ресурсов.

type

string

Тип ресурса.

zones

string[]

Список зон доступности, обозначающих зону, в которой должен быть развернут шлюз Nat.

NatGatewaySku

Номер SKU шлюза NAT.

Имя Тип Описание
name

NatGatewaySkuName

Имя SKU шлюза Nat.

NatGatewaySkuName

Имя SKU шлюза Nat.

Имя Тип Описание
Standard

string

ProvisioningState

Текущее состояние подготовки.

Имя Тип Описание
Deleting

string

Failed

string

Succeeded

string

Updating

string

SubResource

Ссылка на другой подресурс.

Имя Тип Описание
id

string

Идентификатор ресурса.