Microsoft.MobileNetwork mobileNetworks/services
Definicja zasobu Bicep
Typ zasobu mobileNetworks/services można wdrożyć z operacjami docelowymi:
- Grupy zasobów — zobacz polecenia wdrażania grupy zasobów
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.
Format zasobu
Aby utworzyć zasób Microsoft.MobileNetwork/mobileNetworks/services, dodaj następujący kod Bicep do szablonu.
resource symbolicname 'Microsoft.MobileNetwork/mobileNetworks/services@2024-02-01' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
parent: resourceSymbolicName
properties: {
pccRules: [
{
ruleName: 'string'
rulePrecedence: int
ruleQosPolicy: {
5qi: int
allocationAndRetentionPriorityLevel: int
guaranteedBitRate: {
downlink: 'string'
uplink: 'string'
}
maximumBitRate: {
downlink: 'string'
uplink: 'string'
}
preemptionCapability: 'string'
preemptionVulnerability: 'string'
}
serviceDataFlowTemplates: [
{
direction: 'string'
ports: [
'string'
]
protocol: 'string'
remoteIpList: 'string'
templateName: 'string'
}
]
trafficControl: 'string'
}
]
servicePrecedence: int
serviceQosPolicy: {
5qi: int
allocationAndRetentionPriorityLevel: int
maximumBitRate: {
downlink: 'string'
uplink: 'string'
}
preemptionCapability: 'string'
preemptionVulnerability: 'string'
}
}
}
Wartości właściwości
mobileNetworks/services
| Nazwa | Opis | Wartość |
|---|---|---|
| name | Nazwa zasobu Zobacz, jak ustawić nazwy i typy dla zasobów podrzędnych w aplikacji Bicep. |
ciąg (wymagany) Limit znaków: 1–64 Prawidłowe znaki: Alfanumeryczne i łączniki. Zacznij od alfanumerycznego. Następujące wyrazy nie mogą być używane samodzielnie jako nazwa: default, requested, service. |
| location | Lokalizacja geograficzna, w której znajduje się zasób | ciąg (wymagany) |
| tags | Tagi zasobów. | Słownik nazw tagów i wartości. Zobacz Tagi w szablonach |
| Nadrzędny | W Bicep można określić zasób nadrzędny dla zasobu podrzędnego. Tę właściwość należy dodać tylko wtedy, gdy zasób podrzędny jest zadeklarowany poza zasobem nadrzędnym. Aby uzyskać więcej informacji, zobacz Zasób podrzędny poza zasobem nadrzędnym. |
Nazwa symboliczna zasobu typu : mobileNetworks |
| properties | Właściwości usługi. | ServicePropertiesFormat (wymagany) |
ServicePropertiesFormat
| Nazwa | Opis | Wartość |
|---|---|---|
| pccRules | Zestaw reguł zasad przepływu danych, które tworzą tę usługę. | PccRuleConfiguration[] (wymagane) Ograniczenia: Minimalna długość = 1 |
| servicePrecedence | Wartość pierwszeństwa używana do określania między usługami podczas identyfikowania wartości QoS do użycia dla określonej karty SIM. Niższa wartość oznacza wyższy priorytet. Ta wartość powinna być unikatowa wśród wszystkich usług skonfigurowanych w sieci komórkowej. | int (wymagane) Ograniczenia: Wartość minimalna = 0 Maksymalna wartość = 255 |
| serviceQosPolicy | Zasady QoS do użycia dla pakietów pasujących do tej usługi. Można to przesłonić dla określonych przepływów przy użyciu pola ruleQosPolicy w pccRuleConfiguration. Jeśli to pole ma wartość null, zasady SIM ue zdefiniują ustawienia QoS. | QosPolicy |
PccRuleConfiguration
| Nazwa | Opis | Wartość |
|---|---|---|
| Rulename | Nazwa reguły. Musi to być unikatowe w ramach usługi nadrzędnej. Nie można używać żadnego z następujących zastrzeżonych ciągów — default, requested lub service. |
ciąg (wymagany) Ograniczenia: Maksymalna długość = 64 Wzorzec = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
| rulePrecedence | Wartość pierwszeństwa używana do decydowania między regułami zasad przepływu danych podczas identyfikowania wartości QoS do użycia dla określonej karty SIM. Niższa wartość oznacza wyższy priorytet. Ta wartość powinna być unikatowa wśród wszystkich reguł zasad przepływu danych skonfigurowanych w sieci komórkowej. | int (wymagane) Ograniczenia: Wartość minimalna = 0 Maksymalna wartość = 255 |
| ruleQosPolicy | Zasady QoS do użycia dla pakietów pasujących do tej reguły. Jeśli to pole ma wartość null, usługa nadrzędna zdefiniuje ustawienia QoS. | PccRuleQosPolicy |
| serviceDataFlowTemplates | Zestaw szablonów przepływu danych do użycia dla tej reguły zasad przepływu danych. | ServiceDataFlowTemplate[] (wymagane) Ograniczenia: Minimalna długość = 1 Maksymalna długość = 15 |
| trafficControl | Określa, czy przepływy zgodne z tą regułą zasad przepływu danych są dozwolone. | "Zablokowane" "Włączone" |
PccRuleQosPolicy
| Nazwa | Opis | Wartość |
|---|---|---|
| 5qi | Wartość wskaźnika przepływu QoS 5G. 5QI identyfikuje konkretne leczenie przekazywania QoS, które ma zostać dostarczone do przepływu. Zobacz sekcję 3GPP TS23.501 5.7.2.1, aby uzyskać pełny opis parametru 5QI i tabelę 5.7.4-1, aby uzyskać definicję wartości 5QI. | int Ograniczenia: Minimalna wartość = 1 Maksymalna wartość = 127 |
| allocationAndRetentionPriorityLevel | Poziom alokacji i przechowywania przepływu QoS (ARP). Przepływy z wywłaszczanym priorytetem przepływy o niższym priorytcie, jeśli ustawienia preemptionCapability i preemptionVulnerability zezwalają na nie. 1 jest najwyższym poziomem priorytetu. Jeśli to pole nie zostanie określone, 5qi zostanie użyte do uzyskania wartości ARP. Aby uzyskać pełny opis parametrów protokołu ARP, zobacz sekcję 3GPP TS23.501 5.7.2.2. |
int Ograniczenia: Minimalna wartość = 1 Wartość maksymalna = 15 |
| guaranteedBitRate | Gwarantowana szybkość bitów (GBR) dla wszystkich przepływów danych usługi korzystających z tej reguły zasad przepływu danych. To jest ustawienie opcjonalne. Jeśli nie podasz wartości, dla reguły zasad przepływu danych nie będzie ustawiony gbR, która używa tej definicji QoS. | Ambr |
| maximumBitRate | Maksymalna szybkość bitów (MBR) dla wszystkich przepływów danych usługi korzystających z tej reguły lub usługi zasad przepływu danych. | Ambr (wymagane) |
| preemptionCapability | Możliwość wywłaszczania przepływu QoS. Możliwość wywłaszczania przepływu QoS steruje tym, czy może wywłaszczać inny przepływ QoS z niższym priorytetem. Aby uzyskać pełny opis parametrów protokołu ARP, zobacz sekcję 3GPP TS23.501 5.7.2.2. | "MayPreempt" "NotPreempt" |
| preemptionVulnerability | Luka w zabezpieczeniach wywłaszczania przepływu QoS. Luka w zabezpieczeniach dotycząca wywłaszczania przepływu QoS steruje tym, czy może zostać wywłaszczone przez przepływ QoS z wyższym poziomem priorytetu. Aby uzyskać pełny opis parametrów protokołu ARP, zobacz sekcję 3GPP TS23.501 5.7.2.2. | "NotPreemptable" "Wywłaszczalne" |
Ambr
| Nazwa | Opis | Wartość |
|---|---|---|
| Downlink | Szybkość bitów pasma. | ciąg (wymagany) Ograniczenia: Wzorzec = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
| Uplink | Szybkość połączenia bitowego. | ciąg (wymagany) Ograniczenia: Wzorzec = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
ServiceDataFlowTemplate
| Nazwa | Opis | Wartość |
|---|---|---|
| kierunek | Kierunek tego przepływu. | "Dwukierunkowe" "Link do dołu" "Pasma" (wymagane) |
| ports | Porty, z którymi będą łączyć się interfejsy użytkownika dla tego przepływu. Można określić zero lub więcej portów lub zakresów portów. Jeśli określisz co najmniej jeden port lub zakres portów, musisz określić wartość inną niż ip w protocol polu. To jest ustawienie opcjonalne. Jeśli nie określisz tego parametru, połączenia będą dozwolone na wszystkich portach. Zakresy portów muszą być określone jako {FirstPort}-{LastPort}. Na przykład: [8080, 8082-8085]. |
ciąg[] Ograniczenia: Wzorzec = ^([1-9]|[1-9][0-9]{1,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5])(-([1-9]|[1-9][0-9]{1,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]))?$ |
| Protokół | Lista dozwolonych protokołów dla tego przepływu. Jeśli chcesz, aby ten przepływ mógł używać dowolnego protokołu w pakiecie protokołów internetowych, użyj wartości ip. Jeśli chcesz zezwolić tylko na wybór protokołów, musisz użyć odpowiedniego numeru protokołu internetowego przypisanego przez IANA dla każdego protokołu, zgodnie z opisem w temacie https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml. Na przykład w przypadku protokołu UDP należy użyć wartości 17. Jeśli używasz wartości ip , musisz pozostawić pole port nieokreślone. |
ciąg (wymagany) Ograniczenia: Minimalna długość = 1 Wzorzec = ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$"} |
| remoteIpList | Zdalny adres IP, z którym będą nawiązywane połączenia z interfejsami użytkownika dla tego przepływu. Jeśli chcesz zezwolić na połączenia na dowolnym adresie IP, użyj wartości any. W przeciwnym razie należy podać każdy z zdalnych adresów IP, z którymi będzie nawiązywać połączenie z wystąpieniem rdzeni pakietów dla tego przepływu. Należy podać każdy adres IP w notacji CIDR, w tym maskę sieci (na przykład 192.0.2.54/24). |
ciąg (wymagany) Ograniczenia: Minimalna długość = 1 Wzorzec = ^(any|(([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])))$"} |
| nazwa_szablonu | Nazwa szablonu przepływu danych. Musi to być unikatowe w ramach nadrzędnej reguły zasad przepływu danych. Nie można używać żadnego z następujących zastrzeżonych ciągów — default, requested lub service. |
ciąg (wymagany) Ograniczenia: Maksymalna długość = 64 Wzorzec = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
QosPolicy
| Nazwa | Opis | Wartość |
|---|---|---|
| 5qi | Wartość wskaźnika przepływu QoS 5G. 5QI identyfikuje konkretne leczenie przekazujące QoS, które ma zostać dostarczone do przepływu. Zobacz sekcję 3GPP TS23.501 5.7.2.1, aby uzyskać pełny opis parametru 5QI i tabelę 5.7.4-1, aby uzyskać definicję wartości 5QI. | int Ograniczenia: Minimalna wartość = 1 Maksymalna wartość = 127 |
| allocationAndRetentionPriorityLevel | Poziom alokacji i przechowywania przepływu QoS (ARP). Przepływy z przepływami o wyższym priorytcie z niższym priorytetem, jeśli ustawienia preemptionCapability i preemptionVulnerability zezwalają na nie. 1 jest najwyższym poziomem priorytetu. Jeśli to pole nie zostanie określone, 5qi zostanie użyte do uzyskania wartości ARP. Aby uzyskać pełny opis parametrów ARP, zobacz sekcję 3GPP TS23.501 5.7.2.2. |
int Ograniczenia: Minimalna wartość = 1 Maksymalna wartość = 15 |
| maximumBitRate | Maksymalna szybkość bitów (MBR) dla wszystkich przepływów danych usługi korzystających z tej reguły lub usługi zasad przepływu danych. | Ambr (wymagane) |
| preemptionCapability | Możliwość wywłaszczania przepływu QoS. Możliwość wywłaszczania przepływu QoS określa, czy może wywłaszać inny przepływ QoS z niższym poziomem priorytetu. Aby uzyskać pełny opis parametrów ARP, zobacz sekcję 3GPP TS23.501 5.7.2.2. | "MayPreempt" "NotPreempt" |
| preemptionVulnerability | Luka w zabezpieczeniach dotycząca wywłaszczania przepływu QoS. Luka w zabezpieczeniach wywłaszczania przepływu QoS steruje tym, czy może zostać wywłaszczone przez przepływ QoS z wyższym poziomem priorytetu. Aby uzyskać pełny opis parametrów ARP, zobacz sekcję 3GPP TS23.501 5.7.2.2. | "NotPreemptable" "Możliwe do wywłaszczania" |
Szablony szybkiego startu
Następujące szablony szybkiego startu wdrażają ten typ zasobu.
| Template | Opis |
|---|---|
Tworzenie pełnego wdrożenia 5G Core |
Ten szablon tworzy wszystkie zasoby wymagane do wdrożenia prywatnej sieci 5G Core, w tym aprowizacji simów i tworzenia przykładowych zasad QoS. Opcjonalnie można ją wdrożyć w klastrze Kubernetes działającym na urządzeniu Azure Stack Edge. |
| Tworzenie zasad sim |
Ten szablon tworzy zasady usługi i sim dla istniejącej sieci komórkowej. |
Definicja zasobu szablonu usługi ARM
Typ zasobu mobileNetworks/services można wdrożyć z operacjami docelowymi:
- Grupy zasobów — zobacz polecenia wdrażania grupy zasobów
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.
Format zasobu
Aby utworzyć zasób Microsoft.MobileNetwork/mobileNetworks/services, dodaj następujący kod JSON do szablonu.
{
"type": "Microsoft.MobileNetwork/mobileNetworks/services",
"apiVersion": "2024-02-01",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"properties": {
"pccRules": [
{
"ruleName": "string",
"rulePrecedence": "int",
"ruleQosPolicy": {
"5qi": "int",
"allocationAndRetentionPriorityLevel": "int",
"guaranteedBitRate": {
"downlink": "string",
"uplink": "string"
},
"maximumBitRate": {
"downlink": "string",
"uplink": "string"
},
"preemptionCapability": "string",
"preemptionVulnerability": "string"
},
"serviceDataFlowTemplates": [
{
"direction": "string",
"ports": [ "string" ],
"protocol": "string",
"remoteIpList": "string",
"templateName": "string"
}
],
"trafficControl": "string"
}
],
"servicePrecedence": "int",
"serviceQosPolicy": {
"5qi": "int",
"allocationAndRetentionPriorityLevel": "int",
"maximumBitRate": {
"downlink": "string",
"uplink": "string"
},
"preemptionCapability": "string",
"preemptionVulnerability": "string"
}
}
}
Wartości właściwości
mobileNetworks/services
| Nazwa | Opis | Wartość |
|---|---|---|
| typ | Typ zasobu | "Microsoft.MobileNetwork/mobileNetworks/services" |
| apiVersion | Wersja interfejsu API zasobów | '2024-02-01' |
| name | Nazwa zasobu Zobacz, jak ustawiać nazwy i typy dla zasobów podrzędnych w szablonach usługi ARM JSON. |
ciąg (wymagany) Limit znaków: 1–64 Prawidłowe znaki: Alfanumeryczne i łączniki. Zacznij od alfanumerycznego. Następujące słowa nie mogą być używane samodzielnie jako nazwa: default, requested, service. |
| location | Lokalizacja geograficzna, w której znajduje się zasób | ciąg (wymagany) |
| tags | Tagi zasobów. | Słownik nazw tagów i wartości. Zobacz Tagi w szablonach |
| properties | Właściwości usługi. | ServicePropertiesFormat (wymagany) |
ServicePropertiesFormat
| Nazwa | Opis | Wartość |
|---|---|---|
| pccRules | Zestaw reguł zasad przepływu danych, które tworzą tę usługę. | PccRuleConfiguration[] (wymagane) Ograniczenia: Minimalna długość = 1 |
| servicePrecedence | Wartość pierwszeństwa używana do decydowania między usługami podczas identyfikowania wartości QoS do użycia dla określonej karty SIM. Niższa wartość oznacza wyższy priorytet. Ta wartość powinna być unikatowa wśród wszystkich usług skonfigurowanych w sieci komórkowej. | int (wymagane) Ograniczenia: Wartość minimalna = 0 Maksymalna wartość = 255 |
| serviceQosPolicy | Zasady QoS do użycia dla pakietów pasujących do tej usługi. Można to przesłonić dla określonych przepływów przy użyciu pola ruleQosPolicy w pccRuleConfiguration. Jeśli to pole ma wartość null, zasady SIM ue zdefiniują ustawienia QoS. | QosPolicy |
PccRuleConfiguration
| Nazwa | Opis | Wartość |
|---|---|---|
| Rulename | Nazwa reguły. Musi to być unikatowe w ramach usługi nadrzędnej. Nie można używać żadnego z następujących zastrzeżonych ciągów — default, requested lub service. |
ciąg (wymagany) Ograniczenia: Maksymalna długość = 64 Wzorzec = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
| rulePrecedence | Wartość pierwszeństwa używana do decydowania między regułami zasad przepływu danych podczas identyfikowania wartości QoS do użycia dla określonej karty SIM. Niższa wartość oznacza wyższy priorytet. Ta wartość powinna być unikatowa wśród wszystkich reguł zasad przepływu danych skonfigurowanych w sieci komórkowej. | int (wymagane) Ograniczenia: Wartość minimalna = 0 Maksymalna wartość = 255 |
| ruleQosPolicy | Zasady QoS do użycia dla pakietów pasujących do tej reguły. Jeśli to pole ma wartość null, usługa nadrzędna zdefiniuje ustawienia QoS. | PccRuleQosPolicy |
| serviceDataFlowTemplates | Zestaw szablonów przepływu danych do użycia dla tej reguły zasad przepływu danych. | ServiceDataFlowTemplate[] (wymagane) Ograniczenia: Minimalna długość = 1 Maksymalna długość = 15 |
| trafficControl | Określa, czy przepływy zgodne z tą regułą zasad przepływu danych są dozwolone. | "Zablokowane" "Włączone" |
PccRuleQosPolicy
| Nazwa | Opis | Wartość |
|---|---|---|
| 5qi | Wartość wskaźnika przepływu QoS 5G. 5QI identyfikuje konkretne leczenie przekazywania QoS, które ma zostać dostarczone do przepływu. Zobacz sekcję 3GPP TS23.501 5.7.2.1, aby uzyskać pełny opis parametru 5QI i tabelę 5.7.4-1, aby uzyskać definicję wartości 5QI. | int Ograniczenia: Minimalna wartość = 1 Maksymalna wartość = 127 |
| allocationAndRetentionPriorityLevel | Poziom alokacji i przechowywania przepływu QoS (ARP). Przepływy z wywłaszczanym priorytetem przepływy o niższym priorytcie, jeśli ustawienia preemptionCapability i preemptionVulnerability zezwalają na nie. 1 jest najwyższym poziomem priorytetu. Jeśli to pole nie zostanie określone, 5qi zostanie użyte do uzyskania wartości ARP. Aby uzyskać pełny opis parametrów protokołu ARP, zobacz sekcję 3GPP TS23.501 5.7.2.2. |
int Ograniczenia: Minimalna wartość = 1 Wartość maksymalna = 15 |
| guaranteedBitRate | Gwarantowana szybkość bitów (GBR) dla wszystkich przepływów danych usługi korzystających z tej reguły zasad przepływu danych. To jest ustawienie opcjonalne. Jeśli nie podasz wartości, dla reguły zasad przepływu danych nie będzie ustawiony gbR, która używa tej definicji QoS. | Ambr |
| maximumBitRate | Maksymalna szybkość bitów (MBR) dla wszystkich przepływów danych usługi korzystających z tej reguły lub usługi zasad przepływu danych. | Ambr (wymagane) |
| preemptionCapability | Możliwość wywłaszczania przepływu QoS. Możliwość wywłaszczania przepływu QoS steruje tym, czy może wywłaszczać inny przepływ QoS z niższym priorytetem. Aby uzyskać pełny opis parametrów protokołu ARP, zobacz sekcję 3GPP TS23.501 5.7.2.2. | "MayPreempt" "NotPreempt" |
| preemptionVulnerability | Luka w zabezpieczeniach wywłaszczania przepływu QoS. Luka w zabezpieczeniach dotycząca wywłaszczania przepływu QoS steruje tym, czy może zostać wywłaszczone przez przepływ QoS z wyższym poziomem priorytetu. Aby uzyskać pełny opis parametrów protokołu ARP, zobacz sekcję 3GPP TS23.501 5.7.2.2. | "NotPreemptable" "Wywłaszczalne" |
Ambr
| Nazwa | Opis | Wartość |
|---|---|---|
| Downlink | Szybkość bitów pasma. | ciąg (wymagany) Ograniczenia: Wzorzec = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
| Uplink | Szybkość połączenia bitowego. | ciąg (wymagany) Ograniczenia: Wzorzec = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
ServiceDataFlowTemplate
| Nazwa | Opis | Wartość |
|---|---|---|
| kierunek | Kierunek tego przepływu. | "Dwukierunkowe" "Link do dołu" "Pasma" (wymagane) |
| ports | Porty, z którymi będą łączyć się interfejsy użytkownika dla tego przepływu. Można określić zero lub więcej portów lub zakresów portów. Jeśli określisz co najmniej jeden port lub zakres portów, musisz określić wartość inną niż ip w protocol polu. To jest ustawienie opcjonalne. Jeśli nie określisz tego parametru, połączenia będą dozwolone na wszystkich portach. Zakresy portów muszą być określone jako {FirstPort}-{LastPort}. Na przykład: [8080, 8082-8085]. |
ciąg[] Ograniczenia: Wzorzec = ^([1-9]|[1-9][0-9]{1,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5])(-([1-9]|[1-9][0-9]{1,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]))?$ |
| Protokół | Lista dozwolonych protokołów dla tego przepływu. Jeśli chcesz, aby ten przepływ mógł używać dowolnego protokołu w pakiecie protokołów internetowych, użyj wartości ip. Jeśli chcesz zezwolić tylko na wybór protokołów, musisz użyć odpowiedniego numeru protokołu internetowego przypisanego przez IANA dla każdego protokołu, zgodnie z opisem w temacie https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml. Na przykład w przypadku protokołu UDP należy użyć wartości 17. Jeśli używasz wartości ip , musisz pozostawić pole port nieokreślone. |
ciąg (wymagany) Ograniczenia: Minimalna długość = 1 Wzorzec = ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$"} |
| remoteIpList | Zdalny adres IP, z którym będą nawiązywane połączenia z interfejsami użytkownika dla tego przepływu. Jeśli chcesz zezwolić na połączenia na dowolnym adresie IP, użyj wartości any. W przeciwnym razie należy podać każdy z zdalnych adresów IP, z którymi będzie nawiązywać połączenie z wystąpieniem rdzeni pakietów dla tego przepływu. Należy podać każdy adres IP w notacji CIDR, w tym maskę sieci (na przykład 192.0.2.54/24). |
ciąg (wymagany) Ograniczenia: Minimalna długość = 1 Wzorzec = ^(any|(([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])))$"} |
| nazwa_szablonu | Nazwa szablonu przepływu danych. Musi to być unikatowe w ramach nadrzędnej reguły zasad przepływu danych. Nie można używać żadnego z następujących zastrzeżonych ciągów — default, requested lub service. |
ciąg (wymagany) Ograniczenia: Maksymalna długość = 64 Wzorzec = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
QosPolicy
| Nazwa | Opis | Wartość |
|---|---|---|
| 5qi | Wartość wskaźnika przepływu QoS 5G. 5QI identyfikuje konkretne leczenie przekazywania QoS, które ma zostać dostarczone do przepływu. Zobacz sekcję 3GPP TS23.501 5.7.2.1, aby uzyskać pełny opis parametru 5QI i tabelę 5.7.4-1, aby uzyskać definicję wartości 5QI. | int Ograniczenia: Minimalna wartość = 1 Maksymalna wartość = 127 |
| allocationAndRetentionPriorityLevel | Poziom alokacji i przechowywania przepływu QoS (ARP). Przepływy z wywłaszczanym priorytetem przepływy o niższym priorytcie, jeśli ustawienia preemptionCapability i preemptionVulnerability zezwalają na nie. 1 jest najwyższym poziomem priorytetu. Jeśli to pole nie zostanie określone, 5qi zostanie użyte do uzyskania wartości ARP. Aby uzyskać pełny opis parametrów protokołu ARP, zobacz sekcję 3GPP TS23.501 5.7.2.2. |
int Ograniczenia: Minimalna wartość = 1 Wartość maksymalna = 15 |
| maximumBitRate | Maksymalna szybkość bitów (MBR) dla wszystkich przepływów danych usługi korzystających z tej reguły lub usługi zasad przepływu danych. | Ambr (wymagane) |
| preemptionCapability | Możliwość wywłaszczania przepływu QoS. Możliwość wywłaszczania przepływu QoS steruje tym, czy może wywłaszczać inny przepływ QoS z niższym priorytetem. Aby uzyskać pełny opis parametrów protokołu ARP, zobacz sekcję 3GPP TS23.501 5.7.2.2. | "MayPreempt" "NotPreempt" |
| preemptionVulnerability | Luka w zabezpieczeniach wywłaszczania przepływu QoS. Luka w zabezpieczeniach dotycząca wywłaszczania przepływu QoS steruje tym, czy może zostać wywłaszczone przez przepływ QoS z wyższym poziomem priorytetu. Aby uzyskać pełny opis parametrów protokołu ARP, zobacz sekcję 3GPP TS23.501 5.7.2.2. | "NotPreemptable" "Wywłaszczalne" |
Szablony szybkiego startu
Następujące szablony szybkiego startu wdrażają ten typ zasobu.
| Template | Opis |
|---|---|
| Tworzenie pełnego wdrożenia 5G Core |
Ten szablon tworzy wszystkie zasoby wymagane do wdrożenia prywatnego rdzenia 5G, w tym aprowizowanie simów i tworzenie przykładowych zasad QoS. Można ją opcjonalnie wdrożyć w klastrze Kubernetes działającym na urządzeniu Azure Stack Edge. |
| Tworzenie zasad sim |
Ten szablon tworzy zasady usługi i sim dla istniejącej sieci komórkowej. |
Definicja zasobu narzędzia Terraform (dostawcy AzAPI)
Typ zasobu mobileNetworks/services można wdrożyć z operacjami docelowymi:
- Grupy zasobów
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.
Format zasobu
Aby utworzyć zasób Microsoft.MobileNetwork/mobileNetworks/services, dodaj następujący program Terraform do szablonu.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.MobileNetwork/mobileNetworks/services@2024-02-01"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
body = jsonencode({
properties = {
pccRules = [
{
ruleName = "string"
rulePrecedence = int
ruleQosPolicy = {
5qi = int
allocationAndRetentionPriorityLevel = int
guaranteedBitRate = {
downlink = "string"
uplink = "string"
}
maximumBitRate = {
downlink = "string"
uplink = "string"
}
preemptionCapability = "string"
preemptionVulnerability = "string"
}
serviceDataFlowTemplates = [
{
direction = "string"
ports = [
"string"
]
protocol = "string"
remoteIpList = "string"
templateName = "string"
}
]
trafficControl = "string"
}
]
servicePrecedence = int
serviceQosPolicy = {
5qi = int
allocationAndRetentionPriorityLevel = int
maximumBitRate = {
downlink = "string"
uplink = "string"
}
preemptionCapability = "string"
preemptionVulnerability = "string"
}
}
})
}
Wartości właściwości
mobileNetworks/services
| Nazwa | Opis | Wartość |
|---|---|---|
| typ | Typ zasobu | "Microsoft.MobileNetwork/mobileNetworks/services@2024-02-01" |
| name | Nazwa zasobu | ciąg (wymagany) Limit znaków: 1–64 Prawidłowe znaki: Alfanumeryczne i łączniki. Zacznij od alfanumerycznego. Następujące słowa nie mogą być używane samodzielnie jako nazwa: default, requested, service. |
| location | Lokalizacja geograficzna, w której znajduje się zasób | ciąg (wymagany) |
| parent_id | Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu. | Identyfikator zasobu typu: mobileNetworks |
| tags | Tagi zasobów. | Słownik nazw tagów i wartości. |
| properties | Właściwości usługi. | ServicePropertiesFormat (wymagany) |
ServicePropertiesFormat
| Nazwa | Opis | Wartość |
|---|---|---|
| pccRules | Zestaw reguł zasad przepływu danych, które tworzą tę usługę. | PccRuleConfiguration[] (wymagane) Ograniczenia: Minimalna długość = 1 |
| servicePrecedence | Wartość pierwszeństwa używana do decydowania między usługami podczas identyfikowania wartości QoS do użycia dla określonej karty SIM. Niższa wartość oznacza wyższy priorytet. Ta wartość powinna być unikatowa wśród wszystkich usług skonfigurowanych w sieci komórkowej. | int (wymagane) Ograniczenia: Minimalna wartość = 0 Maksymalna wartość = 255 |
| serviceQosPolicy | Zasady QoS do użycia dla pakietów pasujących do tej usługi. Można to zastąpić dla określonych przepływów przy użyciu pola ruleQosPolicy w pccRuleConfiguration. Jeśli to pole ma wartość null, zasady karty SIM ue zdefiniują ustawienia QoS. | QosPolicy |
PccRuleConfiguration
| Nazwa | Opis | Wartość |
|---|---|---|
| Rulename | Nazwa reguły. Musi to być unikatowe w ramach usługi nadrzędnej. Nie można używać żadnego z następujących ciągów zarezerwowanych — default, requested lub service. |
ciąg (wymagany) Ograniczenia: Maksymalna długość = 64 Wzorzec = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
| rulePrecedence | Wartość pierwszeństwa używana do decydowania między regułami zasad przepływu danych podczas identyfikowania wartości QoS do użycia dla określonej karty SIM. Niższa wartość oznacza wyższy priorytet. Ta wartość powinna być unikatowa wśród wszystkich reguł zasad przepływu danych skonfigurowanych w sieci mobilnej. | int (wymagane) Ograniczenia: Minimalna wartość = 0 Maksymalna wartość = 255 |
| ruleQosPolicy | Zasady QoS do użycia dla pakietów pasujących do tej reguły. Jeśli to pole ma wartość null, usługa nadrzędna zdefiniuje ustawienia QoS. | PccRuleQosPolicy |
| serviceDataFlowTemplates | Zestaw szablonów przepływu danych do użycia dla tej reguły zasad przepływu danych. | ServiceDataFlowTemplate[] (wymagane) Ograniczenia: Minimalna długość = 1 Maksymalna długość = 15 |
| trafficControl | Określa, czy przepływy zgodne z tą regułą zasad przepływu danych są dozwolone. | "Zablokowane" "Włączone" |
PccRuleQosPolicy
| Nazwa | Opis | Wartość |
|---|---|---|
| 5qi | Wartość wskaźnika przepływu QoS 5G. 5QI identyfikuje konkretne leczenie przekazujące QoS, które ma zostać dostarczone do przepływu. Zobacz sekcję 3GPP TS23.501 5.7.2.1, aby uzyskać pełny opis parametru 5QI i tabelę 5.7.4-1, aby uzyskać definicję wartości 5QI. | int Ograniczenia: Minimalna wartość = 1 Maksymalna wartość = 127 |
| allocationAndRetentionPriorityLevel | Poziom alokacji i przechowywania przepływu QoS (ARP). Przepływy z przepływami o wyższym priorytcie z niższym priorytetem, jeśli ustawienia preemptionCapability i preemptionVulnerability zezwalają na nie. 1 jest najwyższym poziomem priorytetu. Jeśli to pole nie zostanie określone, 5qi zostanie użyte do uzyskania wartości ARP. Aby uzyskać pełny opis parametrów ARP, zobacz sekcję 3GPP TS23.501 5.7.2.2. |
int Ograniczenia: Minimalna wartość = 1 Maksymalna wartość = 15 |
| guaranteedBitRate | Gwarantowana szybkość bitów (GBR) dla wszystkich przepływów danych usługi korzystających z tej reguły zasad przepływu danych. To jest ustawienie opcjonalne. Jeśli nie podasz wartości, nie będzie ustawione gbr dla reguły zasad przepływu danych, która używa tej definicji QoS. | Ambr |
| maximumBitRate | Maksymalna szybkość bitów (MBR) dla wszystkich przepływów danych usługi korzystających z tej reguły lub usługi zasad przepływu danych. | Ambr (wymagane) |
| preemptionCapability | Możliwość wywłaszczania przepływu QoS. Możliwość wywłaszczania przepływu QoS określa, czy może wywłaszać inny przepływ QoS z niższym poziomem priorytetu. Aby uzyskać pełny opis parametrów ARP, zobacz sekcję 3GPP TS23.501 5.7.2.2. | "MayPreempt" "NotPreempt" |
| preemptionVulnerability | Luka w zabezpieczeniach dotycząca wywłaszczania przepływu QoS. Luka w zabezpieczeniach wywłaszczania przepływu QoS steruje tym, czy może zostać wywłaszczone przez przepływ QoS z wyższym poziomem priorytetu. Aby uzyskać pełny opis parametrów ARP, zobacz sekcję 3GPP TS23.501 5.7.2.2. | "NotPreemptable" "Wywłaszczalne" |
Ambr
| Nazwa | Opis | Wartość |
|---|---|---|
| Downlink | Szybkość połączenia bitowego w dół. | ciąg (wymagany) Ograniczenia: Wzorzec = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
| Uplink | Szybkość bitów pasma. | ciąg (wymagany) Ograniczenia: Wzorzec = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
ServiceDataFlowTemplate
| Nazwa | Opis | Wartość |
|---|---|---|
| kierunek | Kierunek tego przepływu. | "Dwukierunkowe" "Link do dołu" "Pasma" (wymagane) |
| ports | Porty, z którymi będą łączyć się interfejsy użytkownika dla tego przepływu. Można określić zero lub więcej portów lub zakresów portów. Jeśli określisz co najmniej jeden port lub zakresy portów, musisz określić wartość inną niż ip w protocol polu. To jest ustawienie opcjonalne. Jeśli nie określisz go, połączenia będą dozwolone na wszystkich portach. Zakresy portów muszą być określone jako {FirstPort}-{LastPort}. Na przykład: [8080, 8082-8085]. |
ciąg[] Ograniczenia: Wzorzec = ^([1-9]|[1-9][0-9]{1,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5])(-([1-9]|[1-9][0-9]{1,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]))?$ |
| Protokół | Lista dozwolonych protokołów dla tego przepływu. Jeśli chcesz, aby ten przepływ mógł używać dowolnego protokołu w pakiecie protokołów internetowych, użyj wartości ip. Jeśli chcesz zezwolić tylko na wybór protokołów, musisz użyć odpowiedniego numeru protokołu internetowego przypisanego przez IANA dla każdego protokołu, zgodnie z opisem w temacie https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml. Na przykład w przypadku protokołu UDP należy użyć wartości 17. Jeśli używasz wartości ip , musisz pozostawić pole port nieokreślone. |
ciąg (wymagany) Ograniczenia: Minimalna długość = 1 Wzorzec = ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$"} |
| remoteIpList | Zdalny adres IP( es), z którym interfejsy użytkownika będą łączyć się dla tego przepływu. Jeśli chcesz zezwolić na połączenia na dowolnym adresie IP, użyj wartości any. W przeciwnym razie należy podać każde z zdalnych adresów IP, z którymi będzie łączyć się wystąpienie podstawowe pakietu dla tego przepływu. Należy podać każdy adres IP w notacji CIDR, w tym maskę sieci (na przykład 192.0.2.54/24). |
ciąg (wymagany) Ograniczenia: Minimalna długość = 1 Wzorzec = ^(any|(([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])))$"} |
| templateName | Nazwa szablonu przepływu danych. Musi to być unikatowe w ramach nadrzędnej reguły zasad przepływu danych. Nie można używać żadnego z następujących ciągów zarezerwowanych — default, requested lub service. |
ciąg (wymagany) Ograniczenia: Maksymalna długość = 64 Wzorzec = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
QosPolicy
| Nazwa | Opis | Wartość |
|---|---|---|
| 5qi | Wartość wskaźnika przepływu QoS 5G. 5QI identyfikuje konkretne leczenie przekazujące QoS, które ma zostać dostarczone do przepływu. Zobacz sekcję 3GPP TS23.501 5.7.2.1, aby uzyskać pełny opis parametru 5QI i tabelę 5.7.4-1, aby uzyskać definicję wartości 5QI. | int Ograniczenia: Minimalna wartość = 1 Maksymalna wartość = 127 |
| allocationAndRetentionPriorityLevel | Poziom alokacji i przechowywania przepływu QoS (ARP). Przepływy z przepływami o wyższym priorytcie z niższym priorytetem, jeśli ustawienia preemptionCapability i preemptionVulnerability zezwalają na nie. 1 jest najwyższym poziomem priorytetu. Jeśli to pole nie zostanie określone, 5qi zostanie użyte do uzyskania wartości ARP. Aby uzyskać pełny opis parametrów ARP, zobacz sekcję 3GPP TS23.501 5.7.2.2. |
int Ograniczenia: Minimalna wartość = 1 Maksymalna wartość = 15 |
| maximumBitRate | Maksymalna szybkość bitów (MBR) dla wszystkich przepływów danych usługi korzystających z tej reguły lub usługi zasad przepływu danych. | Ambr (wymagane) |
| preemptionCapability | Możliwość wywłaszczania przepływu QoS. Możliwość wywłaszczania przepływu QoS określa, czy może wywłaszać inny przepływ QoS z niższym poziomem priorytetu. Aby uzyskać pełny opis parametrów ARP, zobacz sekcję 3GPP TS23.501 5.7.2.2. | "MayPreempt" "NotPreempt" |
| preemptionVulnerability | Luka w zabezpieczeniach dotycząca wywłaszczania przepływu QoS. Luka w zabezpieczeniach wywłaszczania przepływu QoS steruje tym, czy może zostać wywłaszczone przez przepływ QoS z wyższym poziomem priorytetu. Aby uzyskać pełny opis parametrów ARP, zobacz sekcję 3GPP TS23.501 5.7.2.2. | "NotPreemptable" "Wywłaszczalne" |
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla