Aracılığıyla paylaş

Services - Create Or Update

  • Başvuru
Service:
Mobile Network
API Version:
2024-04-01

Bir hizmeti oluşturur veya güncelleştirir. Üst mobil ağıyla aynı konumda oluşturulmalıdır.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MobileNetwork/mobileNetworks/{mobileNetworkName}/services/{serviceName}?api-version=2024-04-01

URI Parametreleri

Name İçinde Gerekli Tür Description
mobileNetworkName
 path True

string

Mobil ağın adı.

Regex pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$
resourceGroupName
 path True

string

Kaynak grubunun adı. Ad büyük/küçük harfe duyarlı değildir.
serviceName
 path True

string

Hizmetin adı. Aşağıdaki ayrılmış dizelerden hiçbirini kullanmamalısınız: default, requested veya service

Regex pattern: ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$
subscriptionId
 path True

string

uuid

Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.
api-version
 query True

string

Bu işlem için kullanılacak API sürümü.

İstek Gövdesi

Name Gerekli Tür Description
location True

string

Kaynağın bulunduğu coğrafi konum
properties.pccRules True

PccRuleConfiguration[]

Bu hizmeti oluşturan veri akışı ilkesi kuralları kümesi.
properties.servicePrecedence True

integer

Belirli bir SIM için kullanılacak QoS değerlerini tanımlarken hizmetler arasında karar vermek için kullanılan öncelik değeri. Daha düşük bir değer, daha yüksek bir öncelik anlamına gelir. Bu değer, mobil ağda yapılandırılan tüm hizmetler arasında benzersiz olmalıdır.
properties.serviceQosPolicy

QosPolicy

Bu hizmetle eşleşen paketler için kullanılacak QoS ilkesi. Bu, bir PccRuleConfiguration içindeki ruleQosPolicy alanı kullanılarak belirli akışlar için geçersiz kılınabilir. Bu alan null ise, UE'nin SIM ilkesi QoS ayarlarını tanımlar.
tags

object

Kaynak etiketleri.

Yanıtlar

Name Tür Description
200 OK

Service

Güncelleştirme başarılı. İşlem, sonuçta elde edilen hizmet kaynağını döndürür.
201 Created

Service

İçerik Oluşturucu başarılı. İşlem, sonuçta elde edilen hizmet kaynağını döndürür.
Other Status Codes

ErrorResponse

İşlemin neden başarısız olduğunu açıklayan hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation kullanıcı hesabınızın kimliğine bürünme

Örnekler

Create service

Sample Request

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/services/TestService?api-version=2024-04-01

{
  "location": "eastus",
  "properties": {
    "servicePrecedence": 255,
    "serviceQosPolicy": {
      "5qi": 9,
      "allocationAndRetentionPriorityLevel": 9,
      "preemptionCapability": "NotPreempt",
      "preemptionVulnerability": "Preemptable",
      "maximumBitRate": {
        "uplink": "500 Mbps",
        "downlink": "1 Gbps"
      }
    },
    "pccRules": [
      {
        "ruleName": "default-rule",
        "rulePrecedence": 255,
        "ruleQosPolicy": {
          "5qi": 9,
          "allocationAndRetentionPriorityLevel": 9,
          "preemptionCapability": "NotPreempt",
          "preemptionVulnerability": "Preemptable",
          "maximumBitRate": {
            "uplink": "500 Mbps",
            "downlink": "1 Gbps"
          }
        },
        "trafficControl": "Enabled",
        "serviceDataFlowTemplates": [
          {
            "templateName": "IP-to-server",
            "direction": "Uplink",
            "protocol": [
              "ip"
            ],
            "remoteIpList": [
              "10.3.4.0/24"
            ],
            "ports": []
          }
        ]
      }
    ]
  }
}

Sample Response

Status code:
200 
{
  "name": "testPolicy",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/services/TestService",
  "type": "Microsoft.MobileNetwork/service",
  "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",
    "servicePrecedence": 255,
    "serviceQosPolicy": {
      "5qi": 9,
      "allocationAndRetentionPriorityLevel": 9,
      "preemptionCapability": "NotPreempt",
      "preemptionVulnerability": "Preemptable",
      "maximumBitRate": {
        "uplink": "500 Mbps",
        "downlink": "1 Gbps"
      }
    },
    "pccRules": [
      {
        "ruleName": "default-rule",
        "rulePrecedence": 255,
        "ruleQosPolicy": {
          "5qi": 9,
          "allocationAndRetentionPriorityLevel": 9,
          "preemptionCapability": "NotPreempt",
          "preemptionVulnerability": "Preemptable",
          "maximumBitRate": {
            "uplink": "500 Mbps",
            "downlink": "1 Gbps"
          }
        },
        "trafficControl": "Enabled",
        "serviceDataFlowTemplates": [
          {
            "templateName": "IP-to-server",
            "direction": "Uplink",
            "protocol": [
              "ip"
            ],
            "remoteIpList": [
              "10.3.4.0/24"
            ],
            "ports": []
          }
        ]
      }
    ]
  }
}
Status code:
201 
Azure-AsyncOperation: https://management.azure.com/providers/Microsoft.MobileNetwork/locations/testLocation/operationStatuses/testOperation?api-version=2024-04-01
Response Body
{
  "name": "testPolicy",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/services/TestService",
  "type": "Microsoft.MobileNetwork/service",
  "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",
    "servicePrecedence": 255,
    "serviceQosPolicy": {
      "5qi": 9,
      "allocationAndRetentionPriorityLevel": 9,
      "preemptionCapability": "NotPreempt",
      "preemptionVulnerability": "Preemptable",
      "maximumBitRate": {
        "uplink": "500 Mbps",
        "downlink": "1 Gbps"
      }
    },
    "pccRules": [
      {
        "ruleName": "default-rule",
        "rulePrecedence": 255,
        "ruleQosPolicy": {
          "5qi": 9,
          "allocationAndRetentionPriorityLevel": 9,
          "preemptionCapability": "NotPreempt",
          "preemptionVulnerability": "Preemptable",
          "maximumBitRate": {
            "uplink": "500 Mbps",
            "downlink": "1 Gbps"
          }
        },
        "trafficControl": "Enabled",
        "serviceDataFlowTemplates": [
          {
            "templateName": "IP-to-server",
            "direction": "Uplink",
            "protocol": [
              "ip"
            ],
            "remoteIpList": [
              "10.3.4.0/24"
            ],
            "ports": []
          }
        ]
      }
    ]
  }
}

Tanımlar

Name Description
Ambr

Maksimum bit hızını toplama.
createdByType

Kaynağı oluşturan kimliğin türü.
ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.
ErrorDetail

Hata ayrıntısı.
ErrorResponse

Hata yanıtı
PccRuleConfiguration

Veri akışı ilkesi kuralı yapılandırması
PccRuleQosPolicy

Veri akışı ilkesi kuralı QoS ilkesi
PreemptionCapability

Ön kullanım özelliği.
PreemptionVulnerability

Ön kullanım güvenlik açığı.
ProvisioningState

Geçerli sağlama durumu.
QosPolicy

QoS ilkesi
SdfDirection

Hizmet veri akışı yönü.
Service

Hizmet kaynağı. Üst mobil ağıyla aynı konumda oluşturulmalıdır.
ServiceDataFlowTemplate

Veri akışı şablonu
systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
TrafficControlPermission

Trafik denetimi izni.

Ambr

Maksimum bit hızını toplama.

Name Tür Description
downlink

string

Aşağı bağlantı bit hızı.
uplink

string

Yukarı bağlantı bit hızı.

createdByType

Kaynağı oluşturan kimliğin türü.

Name Tür Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

Name Tür Description
info

object

Ek bilgiler.
type

string

Ek bilgi türü.

ErrorDetail

Hata ayrıntısı.

Name Tür Description
additionalInfo

ErrorAdditionalInfo[]

Hata ek bilgileri.
code

string

Hata kodu.
details

ErrorDetail[]

Hata ayrıntıları.
message

string

Hata iletisi.
target

string

Hata hedefi.

ErrorResponse

Hata yanıtı

Name Tür Description
error

ErrorDetail

Hata nesnesi.

PccRuleConfiguration

Veri akışı ilkesi kuralı yapılandırması

Name Tür Varsayılan değer Description
ruleName

string

Kuralın adı. Bu, üst hizmet içinde benzersiz olmalıdır. Aşağıdaki ayrılmış dizelerden hiçbirini kullanmamalısınız: defaultveya requestedservice.
rulePrecedence

integer

Belirli bir SIM için kullanılacak QoS değerlerini tanımlarken veri akışı ilkesi kuralları arasında karar vermek için kullanılan öncelik değeri. Daha düşük bir değer daha yüksek öncelik anlamına gelir. Bu değer, mobil ağda yapılandırılan tüm veri akışı ilkesi kuralları arasında benzersiz olmalıdır.
ruleQosPolicy

PccRuleQosPolicy

Bu kuralla eşleşen paketler için kullanılacak QoS ilkesi. Bu alan null ise, üst hizmet QoS ayarlarını tanımlar.
serviceDataFlowTemplates

ServiceDataFlowTemplate[]

Bu veri akışı ilke kuralı için kullanılacak veri akışı şablonları kümesi.
trafficControl

TrafficControlPermission

Enabled

Bu veri akışı ilkesi kuralıyla eşleşen akışlara izin verilip verilmeyeceğini belirler.

PccRuleQosPolicy

Veri akışı ilkesi kuralı QoS ilkesi

Name Tür Varsayılan değer Description
5qi

integer

9

5G QoS Akış Göstergesi değeri. 5QI, akışa sağlanacak belirli bir QoS iletme işlemini tanımlar. 5QI parametresinin tam açıklaması için 3GPP TS23.501 bölüm 5.7.2.1'e ve 5QI değerlerinin tanımı için 5.7.4-1 tablosuna bakın.
allocationAndRetentionPriorityLevel

integer

9

QoS Akış ayırma ve bekletme önceliği (ARP) düzeyi. Daha yüksek öncelikli akışlar, ayarları preemptionCapability ve preemptionVulnerability izin vermeleri durumunda daha düşük önceliğe sahip akışlar. 1 en yüksek öncelik düzeyidir. Bu alan belirtilmezse 5qi ARP değerini türetmek için kullanılır. ARP parametrelerinin tam açıklaması için bkz. 3GPP TS23.501 bölüm 5.7.2.2.
guaranteedBitRate

Ambr

Bu veri akışı ilke kuralını kullanan tüm hizmet veri akışları için garanti edilen bit hızı (GBR). Bu isteğe bağlı bir ayardır. Bir değer sağlamazsanız, bu QoS tanımını kullanan veri akışı ilkesi kuralı için gbr ayarlanmaz.
maximumBitRate

Ambr

Bu veri akışı ilkesi kuralını veya hizmetini kullanan tüm hizmet veri akışları için en yüksek bit hızı (MBR).
preemptionCapability

PreemptionCapability

NotPreempt

QoS Akışı ön kullanım özelliği. QoS Akışı'nın ön kullanım özelliği, daha düşük öncelik düzeyine sahip başka bir QoS Akışı'nı önceden ayarlayıp önelemeyeceğini denetler. ARP parametrelerinin tam açıklaması için bkz. 3GPP TS23.501 bölüm 5.7.2.2.
preemptionVulnerability

PreemptionVulnerability

Preemptable

QoS Akışı ön kullanım güvenlik açığı. QoS Akışı'nın önalım güvenlik açığı, daha yüksek öncelik düzeyine sahip bir QoS Akışı tarafından önlenip önlenemez olduğunu denetler. ARP parametrelerinin tam açıklaması için bkz. 3GPP TS23.501 bölüm 5.7.2.2.

PreemptionCapability

Ön kullanım özelliği.

Name Tür Description
MayPreempt

string

Mayıs öncesi
NotPreempt

string

Önceden ayarlanamaz

PreemptionVulnerability

Ön kullanım güvenlik açığı.

Name Tür Description
NotPreemptable

string

Ön yükleme yapılamaz
Preemptable

string

Önalımlı olabilir

ProvisioningState

Geçerli sağlama durumu.

Name Tür Description
Accepted

string

Canceled

string

Deleted

string

Deleting

string

Failed

string

Succeeded

string

Unknown

string

QosPolicy

QoS ilkesi

Name Tür Varsayılan değer Description
5qi

integer

9

5G QoS Akış Göstergesi değeri. 5QI, akışa sağlanacak belirli bir QoS iletme işlemini tanımlar. 5QI parametresinin tam açıklaması için 3GPP TS23.501 bölüm 5.7.2.1'e ve 5QI değerlerinin tanımı için 5.7.4-1 tablosuna bakın.
allocationAndRetentionPriorityLevel

integer

9

QoS Akış ayırma ve bekletme önceliği (ARP) düzeyi. Daha yüksek öncelikli akışlar, ayarları preemptionCapability ve preemptionVulnerability izin vermeleri durumunda daha düşük önceliğe sahip akışlar. 1 en yüksek öncelik düzeyidir. Bu alan belirtilmezse 5qi ARP değerini türetmek için kullanılır. ARP parametrelerinin tam açıklaması için bkz. 3GPP TS23.501 bölüm 5.7.2.2.
maximumBitRate

Ambr

Bu veri akışı ilkesi kuralını veya hizmetini kullanan tüm hizmet veri akışları için en yüksek bit hızı (MBR).
preemptionCapability

PreemptionCapability

NotPreempt

QoS Akışı ön kullanım özelliği. QoS Akışı'nın ön kullanım özelliği, daha düşük öncelik düzeyine sahip başka bir QoS Akışı'nı önceden ayarlayıp önelemeyeceğini denetler. ARP parametrelerinin tam açıklaması için bkz. 3GPP TS23.501 bölüm 5.7.2.2.
preemptionVulnerability

PreemptionVulnerability

Preemptable

QoS Akışı ön kullanım güvenlik açığı. QoS Akışı'nın önalım güvenlik açığı, daha yüksek öncelik düzeyine sahip bir QoS Akışı tarafından önlenip önlenemez olduğunu denetler. ARP parametrelerinin tam açıklaması için bkz. 3GPP TS23.501 bölüm 5.7.2.2.

SdfDirection

Hizmet veri akışı yönü.

Name Tür Description
Bidirectional

string

HEM BAE'ye hem de BAE'den akan trafik.
Downlink

string

Veri ağından BAE'ye akan trafik.
Uplink

string

BAE'den veri ağına akan trafik.

Service

Hizmet kaynağı. Üst mobil ağıyla aynı konumda oluşturulmalıdır.

Name Tür Description
id

string

Kaynağın tam kaynak kimliği. Örneğin, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location

string

Kaynağın bulunduğu coğrafi konum
name

string

Kaynağın adı
properties.pccRules

PccRuleConfiguration[]

Bu hizmeti oluşturan veri akışı ilkesi kuralları kümesi.
properties.provisioningState

ProvisioningState

Hizmet kaynağının sağlama durumu.
properties.servicePrecedence

integer

Belirli bir SIM için kullanılacak QoS değerlerini tanımlarken hizmetler arasında karar vermek için kullanılan öncelik değeri. Daha düşük bir değer daha yüksek öncelik anlamına gelir. Bu değer, mobil ağda yapılandırılan tüm hizmetler arasında benzersiz olmalıdır.
properties.serviceQosPolicy

QosPolicy

Bu hizmetle eşleşen paketler için kullanılacak QoS ilkesi. Bu, bir PccRuleConfiguration içindeki ruleQosPolicy alanı kullanılarak belirli akışlar için geçersiz kılınabilir. Bu alan null ise, UE'nin SIM ilkesi QoS ayarlarını tanımlar.
systemData

systemData

Azure Resource Manager createdBy ve modifiedBy bilgilerini içeren meta veriler.
tags

object

Kaynak etiketleri.
type

string

Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

ServiceDataFlowTemplate

Veri akışı şablonu

Name Tür Description
direction

SdfDirection

Bu akışın yönü.
ports

string[]

UE'lerin bu akış için bağlanacağı bağlantı noktası... Sıfır veya daha fazla bağlantı noktası veya bağlantı noktası aralığı belirtebilirsiniz. Bir veya daha fazla bağlantı noktası veya bağlantı noktası aralığı belirtirseniz, alanı dışında ipprotocol bir değer belirtmeniz gerekir. Bu isteğe bağlı bir ayardır. Belirtmezseniz tüm bağlantı noktalarında bağlantılara izin verilir. Bağlantı noktası aralıkları - olarak belirtilmelidir. Örneğin: [8080, 8082-8085].
protocol

string[]

Bu akış için izin verilen protokollerin listesi. Bu akışın internet protokolü paketindeki herhangi bir protokolü kullanabilmesini istiyorsanız değerini ipkullanın. Yalnızca bir protokol seçimine izin vermek istiyorsanız, içinde açıklandığı gibi her protokol için ilgili IANA Atanan İnternet Protokolü Numarası'nı https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtmlkullanmanız gerekir. Örneğin, UDP için 17 kullanmanız gerekir. Değeri ip kullanırsanız, alanı port belirtilmemiş olarak bırakmanız gerekir.
remoteIpList

string[]

UE'lerin bu akış için bağlanacağı uzak IP adresleri. Herhangi bir IP adresinde bağlantılara izin vermek istiyorsanız değerini anykullanın. Aksi takdirde, paket çekirdek örneğinin bu akış için bağlanacağı uzak IP adreslerinin her birini sağlamanız gerekir. Netmask da dahil olmak üzere her IP adresini CIDR gösteriminde sağlamanız gerekir (örneğin, 192.0.2.54/24).
templateName

string

Veri akışı şablonunun adı. Bu, üst veri akışı ilkesi kuralı içinde benzersiz olmalıdır. Aşağıdaki ayrılmış dizelerden hiçbirini kullanmamalısınız: defaultveya requestedservice.

systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name Tür Description
createdAt

string

Kaynak oluşturma (UTC) zaman damgası.
createdBy

string

Kaynağı oluşturan kimlik.
createdByType

createdByType

Kaynağı oluşturan kimliğin türü.
lastModifiedAt

string

Kaynağın son değişikliğinin zaman damgası (UTC)
lastModifiedBy

string

Kaynağı en son değiştiren kimlik.
lastModifiedByType

createdByType

Kaynağı en son değiştiren kimliğin türü.

TrafficControlPermission

Trafik denetimi izni.

Name Tür Description
Blocked

string

Bu kuralla eşleşen trafiğin akışına izin verilmiyor.
Enabled

string

Bu kuralla eşleşen trafiğin akışına izin verilir.