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 |
---|---|---|---|---|
attached
|
path | True |
string maxLength: 64pattern: ^[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. |
packet
|
path | True |
string maxLength: 64pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
O nome do plano de controle do núcleo do pacote. |
packet
|
path | True |
string maxLength: 64pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
O nome do plano de dados do núcleo do pacote. |
resource
|
path | True |
string minLength: 1maxLength: 90 |
O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas. |
subscription
|
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 |
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 |
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 |
Atualize com êxito. A operação retorna o recurso de rede de dados anexado resultante. |
|
201 Created |
Crie com êxito. A operação retorna o recurso de rede de dados anexado resultante. |
|
Other Status Codes |
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 |
---|---|
Attached |
Recurso de rede de dados anexado. Deve ser criado no mesmo local que o plano de dados do núcleo de pacote pai. |
created |
O tipo de identidade que criou o recurso. |
Error |
As informações adicionais do erro de gerenciamento de recursos. |
Error |
O detalhe do erro. |
Error |
Resposta de erro |
Interface |
Propriedades da interface |
Napt |
As configurações de conversão de porta e endereço de rede a serem usadas para a rede de dados anexada. |
Napt |
Se o endereço de rede e a conversão de porta estão habilitados. |
Pinhole |
Tempos de expiração de pinholes NAPT inativos, em segundos. Todos os temporizadores devem ter pelo menos 1 segundo. |
Port |
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.) |
Port |
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. |
Provisioning |
O estado de provisionamento atual. |
system |
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 |
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 |
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 |
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 |
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 |
As informações adicionais do erro. |
|
code |
string |
O código de erro. |
details |
Os detalhes do erro. |
|
message |
string |
A mensagem de erro. |
target |
string |
O destino do erro. |
ErrorResponse
Resposta de erro
Nome | Tipo | Description |
---|---|---|
error |
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: 1maximum: 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 | Enabled |
Se o NAPT está habilitado para conexões com essa rede de dados anexada. |
|
pinholeLimits |
integer (int32) minimum: 1maximum: 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 |
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.) |
||
portReuseHoldTime |
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: 1024maximum: 65535 |
49999 |
O número máximo da porta |
minPort |
integer (int32) minimum: 1024maximum: 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 |
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 |
O tipo de identidade que modificou o recurso pela última vez. |