Sim Policies - Create Or Update

Crea o aggiorna un criterio SIM.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MobileNetwork/mobileNetworks/{mobileNetworkName}/simPolicies/{simPolicyName}?api-version=2022-04-01-preview

Parametri dell'URI

Name In Required Type Description
mobileNetworkName
path True
  • string

Nome della rete mobile.

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

resourceGroupName
path True
  • string

Nome del gruppo di risorse. Per il nome non viene fatta distinzione tra maiuscole e minuscole.

simPolicyName
path True
  • string

Nome del criterio SIM.

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

subscriptionId
path True
  • string

ID della sottoscrizione di destinazione.

api-version
query True
  • string

Versione dell'API da usare per questa operazione.

Corpo della richiesta

Name Required Type Description
location True
  • string

Posizione geografica in cui vive la risorsa

properties.defaultSlice True

Sezione predefinita da usare se ue non lo specifica in modo esplicito. Questa sezione deve essere presente nella sliceConfigurations mappa.

properties.sliceConfigurations True

Le sezioni consentite e le impostazioni da usare per tali sezioni. L'elenco non deve contenere elementi duplicati e deve contenere almeno un elemento.

properties.ueAmbr True

Aggregare la velocità massima di bit in tutti i flussi QoS non GBR di tutte le sessioni PDU di un determinato UE. Per una descrizione completa di UE-AMBR, vedere la sezione 3GPP TS23.501 sezione 5.7.2.6.

properties.registrationTimer
  • integer

Intervallo per la procedura di aggiornamento periodico della registrazione UE, in secondi.

properties.rfspIndex
  • integer

Rat/Frequency Selection Priority Index, definito in 3GPP TS 36.413. Si tratta di un'impostazione facoltativa e per impostazione predefinita non è specificata.

systemData.createdAt
  • string

Timestamp della creazione di risorse (UTC).

systemData.createdBy
  • string

Identità che ha creato la risorsa.

systemData.createdByType

Tipo di identità che ha creato la risorsa.

systemData.lastModifiedAt
  • string

Timestamp dell'ultima modifica della risorsa (UTC)

systemData.lastModifiedBy
  • string

Identità che ha modificato l'ultima risorsa.

systemData.lastModifiedByType

Tipo di identità che ha modificato l'ultima risorsa.

tags
  • object

Tag di risorse.

Risposte

Name Type Description
200 OK

Aggiornamento riuscito. L'operazione restituisce la risorsa dei criteri SIM risultante.

201 Created

Creare correttamente. L'operazione restituisce la risorsa dei criteri SIM risultante.

Other Status Codes

Risposta di errore che descrive perché l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

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

Scopes

Name Description
user_impersonation rappresentare l'account utente

Esempio

Create SIM policy

Sample Request

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/testPolicy?api-version=2022-04-01-preview

{
  "location": "eastus",
  "properties": {
    "registrationTimer": 3240,
    "ueAmbr": {
      "uplink": "500 Mbps",
      "downlink": "1 Gbps"
    },
    "defaultSlice": {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
    },
    "sliceConfigurations": [
      {
        "slice": {
          "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
        },
        "defaultDataNetwork": {
          "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/dataNetworks/testdataNetwork"
        },
        "dataNetworkConfigurations": [
          {
            "dataNetwork": {
              "id": "/subscriptions/subid/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/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/services/testService"
              }
            ]
          }
        ]
      }
    ]
  }
}

Sample Response

{
  "name": "testPolicy",
  "id": "/subscriptions/subid/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",
    "registrationTimer": 3240,
    "ueAmbr": {
      "uplink": "500 Mbps",
      "downlink": "1 Gbps"
    },
    "defaultSlice": {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
    },
    "sliceConfigurations": [
      {
        "slice": {
          "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
        },
        "defaultDataNetwork": {
          "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/dataNetworks/testdataNetwork"
        },
        "dataNetworkConfigurations": [
          {
            "dataNetwork": {
              "id": "/subscriptions/subid/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/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/services/testService"
              }
            ]
          }
        ]
      }
    ]
  }
}
{
  "name": "testPolicy",
  "id": "/subscriptions/subid/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": "Accepted",
    "registrationTimer": 3240,
    "ueAmbr": {
      "uplink": "500 Mbps",
      "downlink": "1 Gbps"
    },
    "defaultSlice": {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
    },
    "sliceConfigurations": [
      {
        "slice": {
          "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
        },
        "defaultDataNetwork": {
          "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/dataNetworks/testdataNetwork"
        },
        "dataNetworkConfigurations": [
          {
            "dataNetwork": {
              "id": "/subscriptions/subid/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/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/services/testService"
              }
            ]
          }
        ]
      }
    ]
  }
}

Definizioni

Ambr

Velocità massima di bit aggregata.

createdByType

Tipo di identità che ha creato la risorsa.

DataNetworkConfiguration

Impostazioni che controllano l'uso della rete dati

DataNetworkResourceId

Riferimento a una risorsa di rete dati.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

PduSessionType

Tipo di sessione PDU (IPv4/IPv6).

PreemptionCapability

Funzionalità di precedenza.

PreemptionVulnerability

Vulnerabilità di precedenza.

ProvisioningState

Stato di provisioning corrente.

ServiceResourceId

Riferimento a una risorsa del servizio.

SimPolicy

Risorsa criteri SIM.

SliceConfiguration

Impostazioni per sezione

SliceResourceId

Riferimento a una risorsa slice.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Ambr

Velocità massima di bit aggregata.

Name Type Description
downlink
  • string

Velocità di bit downlink.

uplink
  • string

Velocità dei bit uplink.

createdByType

Tipo di identità che ha creato la risorsa.

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

DataNetworkConfiguration

Impostazioni che controllano l'uso della rete dati

Name Type Default Value Description
5qi
  • integer
9

Valore predefinito dell'indicatore QoS del flusso QoS 5G. La 5QI identifica un trattamento di inoltro QoS specifico da fornire a un flusso. Non deve essere un valore 5QI standardizzato corrispondente a un flusso QoS QoS (bit rate garantito). I valori GBR 5QI illegali sono: 1, 2, 3, 4, 65, 66, 67, 71, 72, 73, 74, 75, 76, 82, 83, 84 e 85. Vedere 3GPP TS23.501 sezione 5.7.2.1 per una descrizione completa del parametro 5QI e la tabella 5.7.4-1 per la definizione dei quali sono i valori GBR 5QI.

additionalAllowedSessionTypes
  • string[]

Tipi di sessione consentiti oltre al tipo di sessione predefinito. Non deve duplicare il tipo di sessione predefinito.

allocationAndRetentionPriorityLevel
  • integer
9

Livello predefinito di allocazione del flusso QoS e priorità di conservazione (ARP). I flussi con priorità più alta preempt passano con priorità più bassa, se le impostazioni di preemptionCapability e preemptionVulnerability lo consentono. 1 è il livello di priorità più alto. Se questo campo non viene specificato, 5qi viene usato per derivare il valore ARP. Per una descrizione completa dei parametri ARP, vedere la sezione 3GPP TS23.501 sezione 5.7.2.2.

allowedServices

Elenco di servizi che possono essere usati come parte di questo criterio SIM. L'elenco non deve contenere elementi duplicati e deve contenere almeno un elemento.

dataNetwork

Riferimento alla rete dati a cui si applicano queste impostazioni

defaultSessionType IPv4

Tipo di sessione PDU predefinito, che viene usato se ue non richiede un tipo di sessione specifico.

preemptionCapability NotPreempt

Funzionalità di precedenza del flusso QoS predefinita. La funzionalità di precedenza di un flusso QoS controlla se può anteporre un altro flusso QoS con un livello di priorità inferiore. Per una descrizione completa dei parametri ARP, vedere la sezione 3GPP TS23.501 sezione 5.7.2.2.

preemptionVulnerability Preemptable

Vulnerabilità di precedenza del flusso QoS predefinita. La vulnerabilità di precedenza di un flusso QoS controlla se può essere annullata da un flusso QoS con un livello di priorità superiore. Per una descrizione completa dei parametri ARP, vedere la sezione 3GPP TS23.501 sezione 5.7.2.2.

sessionAmbr

Aggregare la frequenza massima di bit in tutti i flussi QoS non GBR di una determinata sessione PDU. Per una descrizione completa di Session-AMBR, vedere la sezione 3GPP TS23.501 sezione 5.7.2.6.

DataNetworkResourceId

Riferimento a una risorsa di rete dati.

Name Type Description
id
  • string

ID risorsa di rete dati.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Name Type Description
info
  • object

Informazioni aggiuntive.

type
  • string

Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Name Type Description
additionalInfo

Informazioni aggiuntive sull'errore.

code
  • string

Codice di errore.

details

Dettagli dell'errore.

message
  • string

Messaggio di errore.

target
  • string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Name Type Description
error

Oggetto error.

PduSessionType

Tipo di sessione PDU (IPv4/IPv6).

Name Type Description
IPv4
  • string
IPv6
  • string

PreemptionCapability

Funzionalità di precedenza.

Name Type Description
MayPreempt
  • string

Può precedere

NotPreempt
  • string

Impossibile anteporre il preempt

PreemptionVulnerability

Vulnerabilità di precedenza.

Name Type Description
NotPreemptable
  • string

Non può essere superato

Preemptable
  • string

Può essere preempted

ProvisioningState

Stato di provisioning corrente.

Name Type Description
Accepted
  • string
Canceled
  • string
Deleted
  • string
Deleting
  • string
Failed
  • string
Succeeded
  • string
Unknown
  • string

ServiceResourceId

Riferimento a una risorsa del servizio.

Name Type Description
id
  • string

ID risorsa del servizio.

SimPolicy

Risorsa criteri SIM.

Name Type Default Value Description
id
  • string

ID di risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location
  • string

Posizione geografica in cui risiede la risorsa

name
  • string

nome della risorsa.

properties.defaultSlice

Sezione predefinita da usare se ue non lo specifica in modo esplicito. Questa sezione deve essere presente nella sliceConfigurations mappa.

properties.provisioningState

Stato di provisioning della risorsa criteri SIM.

properties.registrationTimer
  • integer
3240

Intervallo per la procedura di aggiornamento periodico della registrazione UE, in secondi.

properties.rfspIndex
  • integer

Rat/Frequency Selection Priority Index, definito in 3GPP TS 36.413. Si tratta di un'impostazione facoltativa e per impostazione predefinita non è specificata.

properties.sliceConfigurations

Le sezioni consentite e le impostazioni da usare per tali sezioni. L'elenco non deve contenere elementi duplicati e deve contenere almeno un elemento.

properties.ueAmbr

Aggregare la velocità massima di bit in tutti i flussi QoS non GBR di tutte le sessioni PDU di un determinato UE. Per una descrizione completa di UE-AMBR, vedere la sezione 3GPP TS23.501 sezione 5.7.2.6.

systemData

Azure Resource Manager metadati contenenti le informazioni createdBy e modifiedBy.

systemData.createdAt
  • string

Timestamp della creazione di risorse (UTC).

systemData.createdBy
  • string

Identità che ha creato la risorsa.

systemData.createdByType

Tipo di identità che ha creato la risorsa.

systemData.lastModifiedAt
  • string

Timestamp dell'ultima modifica della risorsa (UTC)

systemData.lastModifiedBy
  • string

Identità che ha modificato l'ultima volta la risorsa.

systemData.lastModifiedByType

Tipo di identità che ha modificato l'ultima volta la risorsa.

tags
  • object

Tag delle risorse.

type
  • string

Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

SliceConfiguration

Impostazioni per sezione

Name Type Description
dataNetworkConfigurations

Le reti dati consentite e le impostazioni da usare per tali reti. L'elenco non deve contenere elementi duplicati e deve contenere almeno un elemento.

defaultDataNetwork

La rete dati predefinita da usare se l'UE non lo specifica in modo esplicito. La configurazione per questo oggetto deve esistere nella dataNetworkConfigurations mappa.

slice

Riferimento alla sezione a cui si applicano queste impostazioni

SliceResourceId

Riferimento a una risorsa slice.

Name Type Description
id
  • string

ID risorsa slice.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Name Type Description
createdAt
  • string

Timestamp della creazione di risorse (UTC).

createdBy
  • string

Identità che ha creato la risorsa.

createdByType

Tipo di identità che ha creato la risorsa.

lastModifiedAt
  • string

Timestamp dell'ultima modifica della risorsa (UTC)

lastModifiedBy
  • string

Identità che ha modificato l'ultima volta la risorsa.

lastModifiedByType

Tipo di identità che ha modificato l'ultima volta la risorsa.