Compartilhar via


Attached Data Networks - Create Or Update

Cria ou atualiza uma rede de dados anexada. Deve ser criado no mesmo local que o plano de dados do núcleo de pacote pai.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/{packetCoreControlPlaneName}/packetCoreDataPlanes/{packetCoreDataPlaneName}/attachedDataNetworks/{attachedDataNetworkName}?api-version=2024-04-01

Parâmetros de URI

Nome Em Obrigatório Tipo Description
attachedDataNetworkName
path True

string

maxLength: 64
pattern: ^[a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])*(\.[a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])*)*$

O nome da rede de dados anexada.

packetCoreControlPlaneName
path True

string

maxLength: 64
pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$

O nome do plano de controle do núcleo do pacote.

packetCoreDataPlaneName
path True

string

maxLength: 64
pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$

O nome do plano de dados do núcleo do pacote.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

subscriptionId
path True

string (uuid)

A ID da assinatura de destino. O valor deve ser uma UUID.

api-version
query True

string

minLength: 1

A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome Obrigatório Tipo Description
location True

string

A localização geográfica onde o recurso reside

properties.dnsAddresses True

string[]

pattern: ^(([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$

Os servidores DNS a serem sinalizados para UEs a serem usados para essa rede de dados anexada. Essa configuração é obrigatória – se você não quiser servidores DNS, deverá fornecer uma matriz vazia.

properties.userPlaneDataInterface True

InterfaceProperties

A interface do plano do usuário na rede de dados. Para redes 5G, essa é a interface N6. Para redes 4G, essa é a interface SGi.

properties.naptConfiguration

NaptConfiguration

A configuração de NAPT (conversão de porta e endereço de rede). Se isso não for especificado, a rede de dados anexada usará uma configuração de NAPT padrão com o NAPT habilitado.

properties.userEquipmentAddressPoolPrefix

string[]

pattern: ^(([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])(\/([0-9]|[1-2][0-9]|3[0-2]))$

Os prefixos do pool de endereços UE (equipamento de usuário) para a rede de dados anexada da qual a instância principal do pacote atribuirá dinamicamente endereços IP a UEs. A instância principal do pacote atribui um endereço IP a uma UE quando a UE configura uma sessão de PDU. Você deve definir pelo menos um dos usuáriosEquipmentAddressPoolPrefix e userEquipmentStaticAddressPoolPrefix. Se você definir ambos, eles deverão ter o mesmo tamanho.

properties.userEquipmentStaticAddressPoolPrefix

string[]

pattern: ^(([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])(\/([0-9]|[1-2][0-9]|3[0-2]))$

Os prefixos do pool de endereços UE (equipamento de usuário) para a rede de dados anexada da qual a instância principal do pacote atribuirá endereços IP estáticos aos UEs. A instância principal do pacote atribui um endereço IP a uma UE quando a UE configura uma sessão de PDU. O endereço IP estático de uma UE específica é definido em StaticIPConfiguration no recurso SIM correspondente. Pelo menos um dos usuáriosEquipmentAddressPoolPrefix e userEquipmentStaticAddressPoolPrefix deve ser definido. Se ambos forem definidos, eles deverão ter o mesmo tamanho.

tags

object

Marcas de recurso.

Respostas

Nome Tipo Description
200 OK

AttachedDataNetwork

Atualize com êxito. A operação retorna o recurso de rede de dados anexado resultante.

201 Created

AttachedDataNetwork

Crie com êxito. A operação retorna o recurso de rede de dados anexado resultante.

Other Status Codes

ErrorResponse

Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

Create attached data network

Solicitação de exemplo

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork?api-version=2024-04-01

{
  "location": "eastus",
  "properties": {
    "userPlaneDataInterface": {
      "name": "N6"
    },
    "dnsAddresses": [
      "1.1.1.1"
    ],
    "naptConfiguration": {
      "enabled": "Enabled",
      "portRange": {
        "minPort": 1024,
        "maxPort": 49999
      },
      "portReuseHoldTime": {
        "tcp": 120,
        "udp": 60
      },
      "pinholeLimits": 65536,
      "pinholeTimeouts": {
        "tcp": 180,
        "udp": 30,
        "icmp": 30
      }
    },
    "userEquipmentAddressPoolPrefix": [
      "2.2.0.0/16"
    ],
    "userEquipmentStaticAddressPoolPrefix": [
      "2.4.0.0/16"
    ]
  }
}

Resposta de exemplo

{
  "name": "TestAttachedDataNetwork",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork",
  "type": "Microsoft.MobileNetwork/attachedDataNetwork",
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  },
  "location": "eastus",
  "tags": {},
  "properties": {
    "provisioningState": "Succeeded",
    "userPlaneDataInterface": {
      "name": "N6"
    },
    "dnsAddresses": [
      "1.1.1.1"
    ],
    "naptConfiguration": {
      "enabled": "Enabled",
      "portRange": {
        "minPort": 1024,
        "maxPort": 49999
      },
      "portReuseHoldTime": {
        "tcp": 120,
        "udp": 60
      },
      "pinholeLimits": 65536,
      "pinholeTimeouts": {
        "tcp": 180,
        "udp": 30,
        "icmp": 30
      }
    },
    "userEquipmentAddressPoolPrefix": [
      "2.2.0.0/16"
    ],
    "userEquipmentStaticAddressPoolPrefix": [
      "2.4.0.0/16"
    ]
  }
}
Azure-AsyncOperation: https://management.azure.com/providers/Microsoft.MobileNetwork/locations/testLocation/operationStatuses/testOperation?api-version=2024-04-01
{
  "name": "TestAttachedDataNetwork",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork",
  "type": "Microsoft.MobileNetwork/attachedDataNetwork",
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  },
  "location": "eastus",
  "tags": {},
  "properties": {
    "provisioningState": "Created",
    "userPlaneDataInterface": {
      "name": "N6"
    },
    "dnsAddresses": [
      "1.1.1.1"
    ],
    "naptConfiguration": {
      "enabled": "Enabled",
      "portRange": {
        "minPort": 1024,
        "maxPort": 49999
      },
      "portReuseHoldTime": {
        "tcp": 120,
        "udp": 60
      },
      "pinholeLimits": 65536,
      "pinholeTimeouts": {
        "tcp": 180,
        "udp": 30,
        "icmp": 30
      }
    },
    "userEquipmentAddressPoolPrefix": [
      "2.2.0.0/16"
    ],
    "userEquipmentStaticAddressPoolPrefix": [
      "2.4.0.0/16"
    ]
  }
}

Definições

Nome Description
AttachedDataNetwork

Recurso de rede de dados anexado. Deve ser criado no mesmo local que o plano de dados do núcleo de pacote pai.

createdByType

O tipo de identidade que criou o recurso.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

InterfaceProperties

Propriedades da interface

NaptConfiguration

As configurações de conversão de porta e endereço de rede a serem usadas para a rede de dados anexada.

NaptEnabled

Se o endereço de rede e a conversão de porta estão habilitados.

PinholeTimeouts

Tempos de expiração de pinholes NAPT inativos, em segundos. Todos os temporizadores devem ter pelo menos 1 segundo.

PortRange

Intervalo de números de porta a serem usados como portas traduzidas em cada endereço traduzido. Se não for especificado e o NAPT estiver habilitado, esse intervalo será de 1.024 a 49.999. (Portas menores de 1.024 não devem ser usadas porque são portas de finalidade especial reservadas pela IANA. As portas 50.000 e posteriores são reservadas para uso não NAPT.)

PortReuseHoldTimes

O tempo mínimo (em segundos) que passará antes de uma porta que foi usada por um pinhole fechado pode ser reciclado para uso por outro pinhole. Todos os tempos de retenção devem ser, no mínimo, 1 segundo.

ProvisioningState

O estado de provisionamento atual.

systemData

Metadados relativos à criação e última modificação do recurso.

AttachedDataNetwork

Recurso de rede de dados anexado. Deve ser criado no mesmo local que o plano de dados do núcleo de pacote pai.

Nome Tipo Description
id

string (arm-id)

ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

location

string

A localização geográfica onde o recurso reside

name

string

O nome do recurso

properties.dnsAddresses

string[]

pattern: ^(([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$

Os servidores DNS a serem sinalizados para UEs a serem usados para essa rede de dados anexada. Essa configuração é obrigatória – se você não quiser servidores DNS, deverá fornecer uma matriz vazia.

properties.naptConfiguration

NaptConfiguration

A configuração de NAPT (conversão de porta e endereço de rede). Se isso não for especificado, a rede de dados anexada usará uma configuração de NAPT padrão com o NAPT habilitado.

properties.provisioningState

ProvisioningState

O estado de provisionamento do recurso de rede de dados anexado.

properties.userEquipmentAddressPoolPrefix

string[]

pattern: ^(([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])(\/([0-9]|[1-2][0-9]|3[0-2]))$

Os prefixos do pool de endereços UE (equipamento de usuário) para a rede de dados anexada da qual a instância principal do pacote atribuirá dinamicamente endereços IP a UEs. A instância principal do pacote atribui um endereço IP a uma UE quando a UE configura uma sessão de PDU. Você deve definir pelo menos um dos usuáriosEquipmentAddressPoolPrefix e userEquipmentStaticAddressPoolPrefix. Se você definir ambos, eles deverão ter o mesmo tamanho.

properties.userEquipmentStaticAddressPoolPrefix

string[]

pattern: ^(([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])(\/([0-9]|[1-2][0-9]|3[0-2]))$

Os prefixos do pool de endereços UE (equipamento de usuário) para a rede de dados anexada da qual a instância principal do pacote atribuirá endereços IP estáticos aos UEs. A instância principal do pacote atribui um endereço IP a uma UE quando a UE configura uma sessão de PDU. O endereço IP estático de uma UE específica é definido em StaticIPConfiguration no recurso SIM correspondente. Pelo menos um dos usuáriosEquipmentAddressPoolPrefix e userEquipmentStaticAddressPoolPrefix deve ser definido. Se ambos forem definidos, eles deverão ter o mesmo tamanho.

properties.userPlaneDataInterface

InterfaceProperties

A interface do plano do usuário na rede de dados. Para redes 5G, essa é a interface N6. Para redes 4G, essa é a interface SGi.

systemData

systemData

Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy.

tags

object

Marcas de recurso.

type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

createdByType

O tipo de identidade que criou o recurso.

Valor Description
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorResponse

Resposta de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

InterfaceProperties

Propriedades da interface

Nome Tipo Description
bfdIpv4Endpoints

string[]

pattern: ^(([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$

Os endereços IPv4 dos pontos de extremidade para os quais enviar investigações BFD.

ipv4Address

string

pattern: ^(([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$

O endereço IPv4.

ipv4AddressList

string[]

pattern: ^(([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$

A lista de endereços IPv4 para um sistema de vários nós.

ipv4Gateway

string

pattern: ^(([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$

O gateway IPv4 padrão (roteador).

ipv4Subnet

string

pattern: ^(([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])(\/([0-9]|[1-2][0-9]|3[0-2]))$

A sub-rede IPv4.

name

string

O nome lógico dessa interface. Isso deve corresponder a uma das interfaces configuradas em seu dispositivo Azure Stack Edge.

vlanId

integer (int32)

minimum: 1
maximum: 4094

Identificador VLAN da interface de rede. Exemplo: 501.

NaptConfiguration

As configurações de conversão de porta e endereço de rede a serem usadas para a rede de dados anexada.

Nome Tipo Valor padrão Description
enabled

NaptEnabled

Enabled

Se o NAPT está habilitado para conexões com essa rede de dados anexada.

pinholeLimits

integer (int32)

minimum: 1
maximum: 65536
65536

Número máximo de pinholes UDP e TCP que podem ser abertos simultaneamente na interface principal. Para redes 5G, essa é a interface N6. Para redes 4G, essa é a interface SGi.

pinholeTimeouts

PinholeTimeouts

Tempos de expiração de pinholes NAPT inativos, em segundos. Todos os temporizadores devem ter pelo menos 1 segundo.

portRange

PortRange

Intervalo de números de porta a serem usados como portas traduzidas em cada endereço traduzido. Se não for especificado e o NAPT estiver habilitado, esse intervalo será de 1.024 a 49.999. (Portas menores de 1.024 não devem ser usadas porque são portas de finalidade especial reservadas pela IANA. As portas 50.000 e posteriores são reservadas para uso não NAPT.)

portReuseHoldTime

PortReuseHoldTimes

O tempo mínimo (em segundos) que passará antes de uma porta que foi usada por um pinhole fechado pode ser reciclado para uso por outro pinhole. Todos os tempos de espera devem ser de pelo menos 1 segundo.

NaptEnabled

Se o endereço de rede e a conversão de porta estão habilitados.

Valor Description
Disabled

O NAPT está desabilitado

Enabled

O NAPT está habilitado

PinholeTimeouts

Tempos de expiração de pinholes NAPT inativos, em segundos. Todos os temporizadores devem ter pelo menos 1 segundo.

Nome Tipo Valor padrão Description
icmp

integer (int32)

minimum: 1
30

Tempo limite de pinhole para pinholes ICMP em segundos. O padrão para o Eco ICMP é de 30 segundos.

tcp

integer (int32)

minimum: 1
180

Tempo limite de pinhole para pinholes TCP em segundos. O padrão para TCP é de 3 minutos.

udp

integer (int32)

minimum: 1
30

Tempo limite de pinhole para pinholes UDP em segundos. O padrão para UDP é 30 segundos.

PortRange

Intervalo de números de porta a serem usados como portas traduzidas em cada endereço traduzido. Se não for especificado e o NAPT estiver habilitado, esse intervalo será de 1.024 a 49.999. (Portas menores de 1.024 não devem ser usadas porque são portas de finalidade especial reservadas pela IANA. As portas 50.000 e posteriores são reservadas para uso não NAPT.)

Nome Tipo Valor padrão Description
maxPort

integer (int32)

minimum: 1024
maximum: 65535
49999

O número máximo da porta

minPort

integer (int32)

minimum: 1024
maximum: 65535
1024

O número mínimo da porta

PortReuseHoldTimes

O tempo mínimo (em segundos) que passará antes de uma porta que foi usada por um pinhole fechado pode ser reciclado para uso por outro pinhole. Todos os tempos de retenção devem ser, no mínimo, 1 segundo.

Nome Tipo Valor padrão Description
tcp

integer (int32)

minimum: 1
120

Tempo mínimo em segundos que passará antes que uma porta TCP usada por um pinhole fechado possa ser reutilizado. O padrão para TCP é de 2 minutos.

udp

integer (int32)

minimum: 1
60

Tempo mínimo em segundos que passará antes que uma porta UDP usada por um pinhole fechado possa ser reutilizado. O padrão para UDP é de 1 minuto.

ProvisioningState

O estado de provisionamento atual.

Valor Description
Accepted
Canceled
Deleted
Deleting
Failed
Succeeded
Unknown

systemData

Metadados relativos à criação e última modificação do recurso.

Nome Tipo Description
createdAt

string (date-time)

O carimbo de data/hora da criação de recursos (UTC).

createdBy

string

A identidade que criou o recurso.

createdByType

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt

string (date-time)

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy

string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.