Sim Policies - Create Or Update

Создает или обновляет политику SIM-карты.

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

Параметры URI

Name In Required Type Description
mobileNetworkName
path True
  • string

Имя мобильной сети.

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

resourceGroupName
path True
  • string

Имя группы ресурсов. Регистр букв в имени не учитывается.

simPolicyName
path True
  • string

Имя политики SIM-карты.

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

subscriptionId
path True
  • string

Идентификатор целевой подписки.

api-version
query True
  • string

Версия API, используемая для данной операции.

Текст запроса

Name Required Type Description
location True
  • string

Географическое расположение, в котором находится ресурс.

properties.defaultSlice True

Используемый по умолчанию срез, если UE не указывает его явным образом. Этот срез должен существовать на sliceConfigurations карте.

properties.sliceConfigurations True

Разрешенные срезы и параметры для них. Список не должен содержать повторяющиеся элементы и должен содержать по крайней мере один элемент.

properties.ueAmbr True

Агрегировать максимальную скорость передачи данных по всем потокам качества обслуживания, не относящихся к GBR, для всех сеансов PDU заданного UE. Полное описание UE-AMBR см. в разделе 5.7.2.6 3GPP TS23.501.

properties.registrationTimer
  • integer

Интервал для процедуры периодического обновления регистрации UE в секундах.

properties.rfspIndex
  • integer

RAT/Frequency Selection Priority Index, определенный в 3GPP TS 36.413. Это необязательный параметр, и по умолчанию он не указан.

systemData.createdAt
  • string

Метка времени создания ресурса (UTC).

systemData.createdBy
  • string

Удостоверение, создающее ресурс.

systemData.createdByType

Тип удостоверения, создавшего ресурс.

systemData.lastModifiedAt
  • string

Метка времени последнего изменения ресурса (UTC)

systemData.lastModifiedBy
  • string

Удостоверение, которое последнее изменение ресурса.

systemData.lastModifiedByType

Тип удостоверения, который последний раз изменил ресурс.

tags
  • object

Теги ресурсов.

Ответы

Name Type Description
200 OK

Обновление выполнено успешно. Операция возвращает полученный ресурс политики SIM-карты.

201 Created

Создайте успешно. Операция возвращает полученный ресурс политики SIM-карты.

Other Status Codes

Ответ об ошибке, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory.

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

Scopes

Name Description
user_impersonation олицетворения учетной записи пользователя

Примеры

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"
              }
            ]
          }
        ]
      }
    ]
  }
}

Определения

Ambr

Агрегировать максимальную скорость передачи данных.

createdByType

Тип удостоверения, создавшего ресурс.

DataNetworkConfiguration

Параметры, управляющие использованием сети данных

DataNetworkResourceId

Ссылка на ресурс сети данных.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

ErrorDetail

Сведения об ошибке.

ErrorResponse

Сообщение об ошибке

PduSessionType

Тип сеанса PDU (IPv4/IPv6).

PreemptionCapability

Возможность вытеснения.

PreemptionVulnerability

Уязвимость вытеснения.

ProvisioningState

Текущее состояние подготовки.

ServiceResourceId

Ссылка на ресурс службы.

SimPolicy

Ресурс политики SIM.

SliceConfiguration

Параметры для каждого среза

SliceResourceId

Ссылка на ресурс среза.

systemData

Метаданные, относящиеся к созданию и последнему модификации ресурса.

Ambr

Агрегировать максимальную скорость передачи данных.

Name Type Description
downlink
  • string

Скорость передачи данных вниз.

uplink
  • string

Скорость передачи исходящей связи.

createdByType

Тип удостоверения, создавшего ресурс.

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

DataNetworkConfiguration

Параметры, управляющие использованием сети данных

Name Type Default Value Description
5qi
  • integer
9

Значение индикатора QoS Flow 5G QoS по умолчанию. 5QI определяет конкретное лечение перенаправления качества обслуживания, которое будет предоставлено потоку. Это значение не должно быть стандартизированным значением 5QI, соответствующим потоку качества обслуживания (гарантированной скорости передачи данных) GBR. Недопустимые значения GBR 5QI: 1, 2, 3, 4, 65, 66, 67, 71, 72, 73, 74, 75, 76, 82, 83, 84 и 85. Полное описание параметра 5QI см. в разделе 3GPP TS23.501 5.7.2.1 и таблице 5.7.4-1 для определения значений GBR 5QI.

additionalAllowedSessionTypes
  • string[]

Допустимые типы сеансов в дополнение к типу сеанса по умолчанию. Не должен дублировать тип сеанса по умолчанию.

allocationAndRetentionPriorityLevel
  • integer
9

Уровень распределения и приоритета хранения (ARP) по умолчанию для потока качества обслуживания. Потоки с более высоким приоритетом вытесняют потоки с более низким приоритетом, если параметры preemptionCapability и preemptionVulnerability разрешают его. 1 — это самый высокий уровень приоритета. Если это поле не указано, 5qi используется для получения значения ARP. Полное описание параметров ARP см. в разделе 5.7.2.2. 3GPP TS23.501.

allowedServices

Список служб, которые можно использовать в рамках этой политики SIM-карты. Список не должен содержать повторяющиеся элементы и должен содержать по крайней мере один элемент.

dataNetwork

Ссылка на сеть данных, к которым применяются эти параметры.

defaultSessionType IPv4

Тип сеанса PDU по умолчанию, который используется, если UE не запрашивает определенный тип сеанса.

preemptionCapability NotPreempt

Возможность вытеснения потока качества обслуживания по умолчанию. Возможность вытеснения потока качества обслуживания определяет, может ли он вытеснить другой поток качества обслуживания с более низким уровнем приоритета. Полное описание параметров ARP см. в разделе 5.7.2.2. 3GPP TS23.501.

preemptionVulnerability Preemptable

Уязвимость вытеснения потока качества обслуживания по умолчанию. Уязвимость вытеснения потока качества обслуживания управляет тем, может ли он быть вытеснирован потоком качества обслуживания с более высоким уровнем приоритета. Полное описание параметров ARP см. в разделе 5.7.2.2. 3GPP TS23.501.

sessionAmbr

Агрегировать максимальную скорость передачи данных для всех потоков качества обслуживания, отличных от GBR, заданного сеанса PDU. Полное описание сеанса AMBR см. в разделе 5.7.2.6 3GPP TS23.501.

DataNetworkResourceId

Ссылка на ресурс сети данных.

Name Type Description
id
  • string

Идентификатор ресурса сети данных.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Name Type Description
info
  • object

Дополнительные сведения.

type
  • string

Дополнительный тип сведений.

ErrorDetail

Сведения об ошибке.

Name Type Description
additionalInfo

Дополнительные сведения об ошибке.

code
  • string

Код ошибки.

details

Сведения об ошибке.

message
  • string

Сообщение об ошибке.

target
  • string

Целевой объект ошибки.

ErrorResponse

Сообщение об ошибке

Name Type Description
error

Объект ошибки.

PduSessionType

Тип сеанса PDU (IPv4/IPv6).

Name Type Description
IPv4
  • string
IPv6
  • string

PreemptionCapability

Возможность вытеснения.

Name Type Description
MayPreempt
  • string

Май упрещает

NotPreempt
  • string

Не удается вытеснять

PreemptionVulnerability

Уязвимость вытеснения.

Name Type Description
NotPreemptable
  • string

Невозможно вытеснять

Preemptable
  • string

Может быть вытеснено

ProvisioningState

Текущее состояние подготовки.

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

ServiceResourceId

Ссылка на ресурс службы.

Name Type Description
id
  • string

Идентификатор ресурса службы.

SimPolicy

Ресурс политики SIM.

Name Type Default Value Description
id
  • string

Полный идентификатор ресурса. Например, /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location
  • string

Географическое расположение, в котором находится ресурс.

name
  • string

Имя ресурса.

properties.defaultSlice

Используемый по умолчанию срез, если UE не указывает его явным образом. Этот срез должен существовать на sliceConfigurations карте.

properties.provisioningState

Состояние подготовки ресурса политики SIM-карты.

properties.registrationTimer
  • integer
3240

Интервал для процедуры периодического обновления регистрации UE в секундах.

properties.rfspIndex
  • integer

RAT/Frequency Selection Priority Index, определенный в 3GPP TS 36.413. Это необязательный параметр, и по умолчанию он не указан.

properties.sliceConfigurations

Разрешенные срезы и параметры для них. Список не должен содержать повторяющиеся элементы и должен содержать по крайней мере один элемент.

properties.ueAmbr

Агрегировать максимальную скорость передачи данных по всем потокам качества обслуживания, не относящихся к GBR, для всех сеансов PDU заданного UE. Полное описание UE-AMBR см. в разделе 5.7.2.6 3GPP TS23.501.

systemData

Метаданные Azure Resource Manager, содержащие сведения createdBy и modifiedBy.

systemData.createdAt
  • string

Метка времени создания ресурса (UTC).

systemData.createdBy
  • string

Удостоверение, создающее ресурс.

systemData.createdByType

Тип удостоверения, создавшего ресурс.

systemData.lastModifiedAt
  • string

Метка времени последнего изменения ресурса (UTC)

systemData.lastModifiedBy
  • string

Удостоверение, которое последнее изменение ресурса.

systemData.lastModifiedByType

Тип удостоверения, который последний раз изменил ресурс.

tags
  • object

Теги ресурсов.

type
  • string

Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

SliceConfiguration

Параметры для каждого среза

Name Type Description
dataNetworkConfigurations

Разрешенные сети данных и параметры, используемые для них. Список не должен содержать повторяющиеся элементы и должен содержать по крайней мере один элемент.

defaultDataNetwork

Сеть данных по умолчанию, используемая, если UE не указывает ее явным образом. Конфигурация для этого объекта должна существовать на dataNetworkConfigurations карте.

slice

Ссылка на срез, к которому применяются эти параметры.

SliceResourceId

Ссылка на ресурс среза.

Name Type Description
id
  • string

Идентификатор ресурса среза.

systemData

Метаданные, относящиеся к созданию и последнему модификации ресурса.

Name Type Description
createdAt
  • string

Метка времени создания ресурса (UTC).

createdBy
  • string

Удостоверение, создающее ресурс.

createdByType

Тип удостоверения, создавшего ресурс.

lastModifiedAt
  • string

Метка времени последнего изменения ресурса (UTC)

lastModifiedBy
  • string

Удостоверение, которое последнее изменение ресурса.

lastModifiedByType

Тип удостоверения, который последний раз изменил ресурс.