Sim Policies - Create Or Update
Crée ou met à jour une stratégie SIM. Doit être créé au même emplacement que son réseau mobile parent.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MobileNetwork/mobileNetworks/{mobileNetworkName}/simPolicies/{simPolicyName}?api-version=2024-04-01
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
mobile
|
path | True |
string |
Nom du réseau mobile. Modèle d’expression régulière: |
resource
|
path | True |
string |
Nom du groupe de ressources. Le nom ne respecte pas la casse. |
sim
|
path | True |
string |
Nom de la stratégie SIM. Modèle d’expression régulière: |
subscription
|
path | True |
string uuid |
ID de l’abonnement cible. La valeur doit être un UUID. |
api-version
|
query | True |
string |
Version de l’API à utiliser pour cette opération. |
Corps de la demande
Nom | Obligatoire | Type | Description |
---|---|---|---|
location | True |
string |
Emplacement géographique où réside la ressource |
properties.defaultSlice | True |
Tranche par défaut à utiliser si l’UE ne le spécifie pas explicitement. Cette tranche doit exister dans la |
|
properties.sliceConfigurations | True |
Les tranches autorisées et les paramètres à utiliser pour elles. La liste ne doit pas contenir d’éléments en double et doit contenir au moins un élément. |
|
properties.ueAmbr | True |
Agréger le débit maximal sur tous les flux QoS non GBR de toutes les sessions PDU d’une UE donnée. Consultez 3GPP TS23.501, section 5.7.2.6 pour obtenir une description complète de l’UE-AMBR. |
|
properties.registrationTimer |
integer |
Minuteur de mise à jour de l’inscription périodique UE (5G) ou minuteur de mise à jour de la zone de suivi périodique UE (4G), en secondes. |
|
properties.rfspIndex |
integer |
Rat/Frequency Selection Priority Index, défini dans 3GPP TS 36.413. Il s’agit d’un paramètre facultatif et, par défaut, n’est pas spécifié. |
|
tags |
object |
Balises de ressource. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
Mise à jour réussie. L’opération retourne la ressource de stratégie SIM résultante. |
|
201 Created |
Create réussi. L’opération retourne la ressource de stratégie SIM résultante. |
|
Other Status Codes |
Réponse d’erreur décrivant la raison de l’échec de l’opération. |
Sécurité
azure_auth
Flux OAuth2 Azure Active Directory.
Type:
oauth2
Flux:
implicit
URL d’autorisation:
https://login.microsoftonline.com/common/oauth2/authorize
Étendues
Nom | Description |
---|---|
user_impersonation | Emprunter l’identité de votre compte d’utilisateur |
Exemples
Create SIM policy
Exemple de requête
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/testPolicy?api-version=2024-04-01
{
"location": "eastus",
"properties": {
"registrationTimer": 3240,
"ueAmbr": {
"uplink": "500 Mbps",
"downlink": "1 Gbps"
},
"defaultSlice": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
},
"sliceConfigurations": [
{
"slice": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
},
"defaultDataNetwork": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/dataNetworks/testdataNetwork"
},
"dataNetworkConfigurations": [
{
"dataNetwork": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/dataNetworks/testdataNetwork"
},
"sessionAmbr": {
"uplink": "500 Mbps",
"downlink": "1 Gbps"
},
"5qi": 9,
"allocationAndRetentionPriorityLevel": 9,
"preemptionCapability": "NotPreempt",
"preemptionVulnerability": "Preemptable",
"defaultSessionType": "IPv4",
"additionalAllowedSessionTypes": [],
"allowedServices": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/services/testService"
}
],
"maximumNumberOfBufferedPackets": 200
}
]
}
]
}
}
Exemple de réponse
{
"name": "testPolicy",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/testPolicy",
"type": "Microsoft.MobileNetwork/simPolicy",
"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",
"siteProvisioningState": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite": "Provisioned",
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite2": "Provisioned"
},
"registrationTimer": 3240,
"ueAmbr": {
"uplink": "500 Mbps",
"downlink": "1 Gbps"
},
"defaultSlice": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
},
"sliceConfigurations": [
{
"slice": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
},
"defaultDataNetwork": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/dataNetworks/testdataNetwork"
},
"dataNetworkConfigurations": [
{
"dataNetwork": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/dataNetworks/testdataNetwork"
},
"sessionAmbr": {
"uplink": "500 Mbps",
"downlink": "1 Gbps"
},
"5qi": 9,
"allocationAndRetentionPriorityLevel": 9,
"preemptionCapability": "NotPreempt",
"preemptionVulnerability": "Preemptable",
"defaultSessionType": "IPv4",
"additionalAllowedSessionTypes": [],
"allowedServices": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/services/testService"
}
],
"maximumNumberOfBufferedPackets": 200
}
]
}
]
}
}
Azure-AsyncOperation: https://management.azure.com/providers/Microsoft.MobileNetwork/locations/testLocation/operationStatuses/testOperation?api-version=2024-04-01
{
"name": "testPolicy",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/testPolicy",
"type": "Microsoft.MobileNetwork/simPolicy",
"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",
"siteProvisioningState": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite": "Adding",
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite2": "Adding"
},
"registrationTimer": 3240,
"ueAmbr": {
"uplink": "500 Mbps",
"downlink": "1 Gbps"
},
"defaultSlice": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
},
"sliceConfigurations": [
{
"slice": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
},
"defaultDataNetwork": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/dataNetworks/testdataNetwork"
},
"dataNetworkConfigurations": [
{
"dataNetwork": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/dataNetworks/testdataNetwork"
},
"sessionAmbr": {
"uplink": "500 Mbps",
"downlink": "1 Gbps"
},
"5qi": 9,
"allocationAndRetentionPriorityLevel": 9,
"preemptionCapability": "NotPreempt",
"preemptionVulnerability": "Preemptable",
"defaultSessionType": "IPv4",
"additionalAllowedSessionTypes": [],
"allowedServices": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/services/testService"
}
],
"maximumNumberOfBufferedPackets": 200
}
]
}
]
}
}
Définitions
Nom | Description |
---|---|
Ambr |
Agréger le débit binaire maximal. |
created |
Type d’identité qui a créé la ressource. |
Data |
Paramètres contrôlant l’utilisation du réseau de données |
Data |
Référence à une ressource réseau de données. |
Error |
Informations supplémentaires sur l’erreur de gestion des ressources. |
Error |
Détail de l’erreur. |
Error |
Réponse d’erreur |
Pdu |
Type de session PDU (IPv4/IPv6). |
Preemption |
Fonctionnalité de préemption. |
Preemption |
Vulnérabilité de préemption. |
Provisioning |
État d’approvisionnement actuel. |
Service |
Référence à une ressource de service. |
Sim |
Ressource de stratégie SIM. |
Slice |
Paramètres par tranche |
Slice |
Référence à une ressource de tranche. |
system |
Métadonnées relatives à la création et à la dernière modification de la ressource. |
Ambr
Agréger le débit binaire maximal.
Nom | Type | Description |
---|---|---|
downlink |
string |
Débit de liaison descendante. |
uplink |
string |
Débit de liaison montante. |
createdByType
Type d’identité qui a créé la ressource.
Nom | Type | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DataNetworkConfiguration
Paramètres contrôlant l’utilisation du réseau de données
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
5qi |
integer |
9 |
Valeur par défaut de l’indicateur de flux QoS 5G. Le 5QI identifie un traitement de transfert QoS spécifique à fournir à un flux. Consultez la section 5.7.2.1 du 3GPP TS23.501 pour obtenir une description complète du paramètre 5QI et le tableau 5.7.4-1 pour la définition des valeurs 5QI. |
additionalAllowedSessionTypes |
Types de session autorisés en plus du type de session par défaut. Ne doit pas dupliquer le type de session par défaut. |
||
allocationAndRetentionPriorityLevel |
integer |
9 |
Niveau d’allocation et de priorité de rétention (ARP) de flux QoS par défaut. Les flux avec une priorité plus élevée préemptent les flux avec une priorité inférieure, si les paramètres de |
allowedServices |
Liste des services qui peuvent être utilisés dans le cadre de cette stratégie SIM. La liste ne doit pas contenir d’éléments en double et doit contenir au moins un élément. Les services doivent se trouver au même emplacement que la stratégie SIM. |
||
dataNetwork |
Référence au réseau de données auquel ces paramètres s’appliquent. Le réseau de données doit se trouver au même emplacement que la stratégie SIM. |
||
defaultSessionType | IPv4 |
Type de session PDU par défaut, qui est utilisé si l’UE ne demande pas de type de session spécifique. |
|
maximumNumberOfBufferedPackets |
integer |
10 |
Nombre maximal de paquets de liaison descendante à mettre en mémoire tampon au niveau du plan utilisateur pour communication à latence élevée - Mise en mémoire tampon étendue. Pour obtenir une description complète, consultez 3GPP TS29.272 v15.10.0, section 7.3.188. Ce maximum n’est pas garanti, car il existe une limite interne sur les paquets mis en mémoire tampon sur toutes les sessions PDU. |
preemptionCapability | NotPreempt |
Fonctionnalité de préemption de flux QoS par défaut. La capacité de préemption d’un flux QoS détermine si ce flux peut préempter un autre flux QoS ayant un niveau de priorité inférieur. Pour obtenir une description complète des paramètres ARP, consultez la section 5.7.2.2 du 3GPP TS23.501. |
|
preemptionVulnerability | Preemptable |
Vulnérabilité de préemption de flux QoS par défaut. La vulnérabilité de préemption d’un flux QoS contrôle s’il peut être préempté par un flux QoS avec un niveau de priorité plus élevé. Pour obtenir une description complète des paramètres ARP, consultez la section 5.7.2.2 du 3GPP TS23.501. |
|
sessionAmbr |
Agréger le débit maximal sur tous les flux QoS non GBR d’une session PDU donnée. Consultez la section 5.7.2.6 du 3GPP TS23.501 pour obtenir une description complète de Session-AMBR. |
DataNetworkResourceId
Référence à une ressource réseau de données.
Nom | Type | Description |
---|---|---|
id |
string |
ID de ressource réseau de données. |
ErrorAdditionalInfo
Informations supplémentaires sur l’erreur de gestion des ressources.
Nom | Type | Description |
---|---|---|
info |
object |
Informations supplémentaires |
type |
string |
Type d’informations supplémentaires. |
ErrorDetail
Détail de l’erreur.
Nom | Type | Description |
---|---|---|
additionalInfo |
Informations supplémentaires sur l’erreur. |
|
code |
string |
Code d'erreur. |
details |
Détails de l’erreur. |
|
message |
string |
Message d’erreur. |
target |
string |
Cible d’erreur. |
ErrorResponse
Réponse d’erreur
Nom | Type | Description |
---|---|---|
error |
Objet d’erreur. |
PduSessionType
Type de session PDU (IPv4/IPv6).
Nom | Type | Description |
---|---|---|
IPv4 |
string |
|
IPv6 |
string |
PreemptionCapability
Fonctionnalité de préemption.
Nom | Type | Description |
---|---|---|
MayPreempt |
string |
Préempter de mai |
NotPreempt |
string |
Impossible de préempter |
PreemptionVulnerability
Vulnérabilité de préemption.
Nom | Type | Description |
---|---|---|
NotPreemptable |
string |
Impossible de préemption |
Preemptable |
string |
Peut être préempté |
ProvisioningState
État d’approvisionnement actuel.
Nom | Type | Description |
---|---|---|
Accepted |
string |
|
Canceled |
string |
|
Deleted |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Unknown |
string |
ServiceResourceId
Référence à une ressource de service.
Nom | Type | Description |
---|---|---|
id |
string |
ID de ressource de service. |
SimPolicy
Ressource de stratégie SIM.
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
id |
string |
ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} » |
|
location |
string |
Emplacement géographique où réside la ressource |
|
name |
string |
nom de la ressource. |
|
properties.defaultSlice |
Tranche par défaut à utiliser si l’UE ne le spécifie pas explicitement. Cette tranche doit exister dans la |
||
properties.provisioningState |
État d’approvisionnement de la ressource de stratégie SIM. |
||
properties.registrationTimer |
integer |
3240 |
Minuteur de mise à jour de l’inscription périodique UE (5G) ou minuteur de mise à jour de zone de suivi périodique UE (4G), en secondes. |
properties.rfspIndex |
integer |
Rat/Frequency Selection Priority Index, défini dans 3GPP TS 36.413. Il s’agit d’un paramètre facultatif et, par défaut, n’est pas spécifié. |
|
properties.siteProvisioningState |
object |
Dictionnaire de sites à l’état d’approvisionnement de cette stratégie SIM sur ce site. |
|
properties.sliceConfigurations |
Les tranches autorisées et les paramètres à utiliser pour elles. La liste ne doit pas contenir d’éléments en double et doit contenir au moins un élément. |
||
properties.ueAmbr |
Agréger le débit maximal sur tous les flux QoS non GBR de toutes les sessions PDU d’une UE donnée. Consultez 3GPP TS23.501, section 5.7.2.6 pour obtenir une description complète de l’UE-AMBR. |
||
systemData |
Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy. |
||
tags |
object |
Balises de ressource. |
|
type |
string |
Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts » |
SliceConfiguration
Paramètres par tranche
Nom | Type | Description |
---|---|---|
dataNetworkConfigurations |
Réseaux de données autorisés et paramètres à utiliser pour eux. La liste ne doit pas contenir d’éléments en double et doit contenir au moins un élément. |
|
defaultDataNetwork |
Réseau de données par défaut à utiliser si l’UE ne le spécifie pas explicitement. La configuration de cet objet doit exister dans la |
|
slice |
Référence à la tranche à laquelle ces paramètres s’appliquent. La tranche doit se trouver au même emplacement que la stratégie SIM. |
SliceResourceId
Référence à une ressource de tranche.
Nom | Type | Description |
---|---|---|
id |
string |
Segmenter l’ID de ressource. |
systemData
Métadonnées relatives à la création et à la dernière modification de la ressource.
Nom | Type | Description |
---|---|---|
createdAt |
string |
Horodatage de la création de ressources (UTC). |
createdBy |
string |
Identité qui a créé la ressource. |
createdByType |
Type d’identité qui a créé la ressource. |
|
lastModifiedAt |
string |
Horodatage de la dernière modification de la ressource (UTC) |
lastModifiedBy |
string |
Identité qui a modifié la dernière ressource. |
lastModifiedByType |
Type d’identité qui a modifié la dernière ressource. |