Partilhar via

Sim Policies - Create Or Update

  • Referência
Serviço:
Mobile Network
Versão da API:
2024-04-01

Cria ou atualiza uma política sim. Tem de ser criado na mesma localização que a respetiva rede móvel principal.

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

Parâmetros do URI

Name Em Necessário Tipo Description
mobileNetworkName
 path True

string

O nome da rede móvel.

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

string

O nome do grupo de recursos. O nome não é sensível a maiúsculas e minúsculas.
simPolicyName
 path True

string

O nome da política sim.

Padrão Regex: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$
subscriptionId
 path True

string

uuid

O ID da subscrição de destino. O valor tem de ser um UUID.
api-version
 query True

string

A versão da API a utilizar para esta operação.

Corpo do Pedido

Name Necessário Tipo Description
location True

string

A localização geográfica onde reside o recurso
properties.defaultSlice True

SliceResourceId

O setor predefinido a utilizar se a UE não o especificar explicitamente. Este setor tem de existir no sliceConfigurations mapa. O setor tem de estar na mesma localização que a política do SIM.
properties.sliceConfigurations True

SliceConfiguration[]

Os setores permitidos e as definições a utilizar para os mesmos. A lista não pode conter itens duplicados e tem de conter pelo menos um item.
properties.ueAmbr True

Ambr

Agregar a taxa máxima de bits em todos os fluxos QoS não GBR de todas as sessões de PDU de uma determinada UE. Consulte a secção 3GPP TS23.501 5.7.2.6 para obter uma descrição completa do UE-AMBR.
properties.registrationTimer

integer

Temporizador de atualização de registo periódico da UE (5G) ou temporizador de atualização da área de controlo periódico da UE (4G), em segundos.
properties.rfspIndex

integer

Índice de Prioridade de Seleção RAT/Frequência, definido em TS 36.413 3GPP. Esta é uma definição opcional e, por predefinição, não é especificada.
tags

object

Etiquetas de recursos.

Respostas

Name Tipo Description
200 OK

SimPolicy

Atualização bem-sucedida. A operação devolve o recurso de política sim resultante.
201 Created

SimPolicy

Create com êxito. A operação devolve o recurso de política sim resultante.
Other Status Codes

ErrorResponse

Resposta de erro que descreve o motivo pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation representar a sua conta de utilizador

Exemplos

Create SIM policy

Pedido de amostra

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

Resposta da amostra

Código de estado:
200 
{
  "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
          }
        ]
      }
    ]
  }
}
Código de estado:
201 
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
          }
        ]
      }
    ]
  }
}

Definições

Name Description
Ambr

Taxa máxima de bits agregada.
createdByType

O tipo de identidade que criou o recurso.
DataNetworkConfiguration

Definições que controlam a utilização da rede de dados
DataNetworkResourceId

Referência a um recurso de rede de dados.
ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.
ErrorDetail

O detalhe do erro.
ErrorResponse

Resposta a erros
PduSessionType

Tipo de sessão PDU (IPv4/IPv6).
PreemptionCapability

Capacidade de preempção.
PreemptionVulnerability

Vulnerabilidade de preempção.
ProvisioningState

O estado de aprovisionamento atual.
ServiceResourceId

Referência a um recurso de serviço.
SimPolicy

Recurso de política sim.
SliceConfiguration

Definições por setor
SliceResourceId

Referência a um recurso de setor.
systemData

Metadados relativos à criação e última modificação do recurso.

Ambr

Taxa máxima de bits agregada.

Name Tipo Description
downlink

string

Taxa de bits de downlink.
uplink

string

Taxa de bits de uplink.

createdByType

O tipo de identidade que criou o recurso.

Name Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

DataNetworkConfiguration

Definições que controlam a utilização da rede de dados

Name Tipo Default value Description
5qi

integer

9

Valor do Indicador de Fluxo QoS de 5G predefinido. O 5QI identifica um tratamento de reencaminhamento QoS específico a ser fornecido a um fluxo. Veja 3GPP TS23.501 secção 5.7.2.1 para obter uma descrição completa do parâmetro 5QI e a tabela 5.7.4-1 para a definição dos valores 5QI.
additionalAllowedSessionTypes

PduSessionType[]

Tipos de sessão permitidos para além do tipo de sessão predefinido. Não é necessário duplicar o tipo de sessão predefinido.
allocationAndRetentionPriorityLevel

integer

9

Nível predefinido de prioridade de alocação e retenção do Fluxo QoS (ARP). Os fluxos com maior prioridade preempõem fluxos com prioridade inferior, se as definições de preemptionCapability e preemptionVulnerability permitirem. 1 é o nível de prioridade mais elevado. Se este campo não for especificado, 5qi será utilizado para derivar o valor ARP. Veja 3GPP TS23.501 secção 5.7.2.2 para obter uma descrição completa dos parâmetros do ARP.
allowedServices

ServiceResourceId[]

Lista de serviços que podem ser utilizados como parte desta política sim. A lista não pode conter itens duplicados e tem de conter, pelo menos, um item. Os serviços têm de estar na mesma localização que a política do SIM.
dataNetwork

DataNetworkResourceId

Uma referência à rede de dados à qual estas definições se aplicam. A rede de dados tem de estar na mesma localização que a política do SIM.
defaultSessionType

PduSessionType

IPv4

O tipo de sessão PDU predefinido, que é utilizado se a UE não pedir um tipo de sessão específico.
maximumNumberOfBufferedPackets

integer

10

O número máximo de pacotes de downlink a colocar em memória intermédia no plano de utilizador para Comunicação de Alta Latência – Memória Intermédia Expandida. Consulte a secção 3GPP TS29.272 v15.10.0 7.3.188 para obter uma descrição completa. Este máximo não é garantido porque existe um limite interno em pacotes em memória intermédia em todas as sessões de PDU.
preemptionCapability

PreemptionCapability

NotPreempt

Capacidade predefinida de preempção do Fluxo de QoS. A capacidade de preempção de um Fluxo de QoS controla se pode antecipar outro Fluxo de QoS com um nível de prioridade inferior. Veja 3GPP TS23.501 secção 5.7.2.2 para obter uma descrição completa dos parâmetros do ARP.
preemptionVulnerability

PreemptionVulnerability

Preemptable

Vulnerabilidade predefinida de preempção do Fluxo de QoS. A vulnerabilidade de preempção de um Fluxo de QoS controla se pode ser preempida por um Fluxo de QoS com um nível de prioridade mais elevado. Veja 3GPP TS23.501 secção 5.7.2.2 para obter uma descrição completa dos parâmetros do ARP.
sessionAmbr

Ambr

Agregar a taxa máxima de bits em todos os fluxos QoS não GBR de uma determinada sessão PDU. Consulte a secção 3GPP TS23.501 5.7.2.6 para obter uma descrição completa do Session-AMBR.

DataNetworkResourceId

Referência a um recurso de rede de dados.

Name Tipo Description
id

string

ID do recurso de rede de dados.

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

Name Tipo Description
info

object

As informações adicionais.
type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.
code

string

O código de erro.
details

ErrorDetail[]

Os detalhes do erro.
message

string

A mensagem de erro.
target

string

O destino do erro.

ErrorResponse

Resposta a erros

Name Tipo Description
error

ErrorDetail

O objeto de erro.

PduSessionType

Tipo de sessão PDU (IPv4/IPv6).

Name Tipo Description
IPv4

string

IPv6

string

PreemptionCapability

Capacidade de preempção.

Name Tipo Description
MayPreempt

string

May preempt
NotPreempt

string

Não é possível preemptar

PreemptionVulnerability

Vulnerabilidade de preempção.

Name Tipo Description
NotPreemptable

string

Não é possível preemptar
Preemptable

string

Pode ser preempida

ProvisioningState

O estado de aprovisionamento atual.

Name Tipo Description
Accepted

string

Canceled

string

Deleted

string

Deleting

string

Failed

string

Succeeded

string

Unknown

string

ServiceResourceId

Referência a um recurso de serviço.

Name Tipo Description
id

string

ID do recurso de serviço.

SimPolicy

Recurso de política sim.

Name Tipo Default value Description
id

string

ID de recurso completamente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location

string

A localização geográfica onde o recurso se encontra
name

string

O nome do recurso
properties.defaultSlice

SliceResourceId

O setor predefinido a utilizar se a UE não o especificar explicitamente. Este setor tem de existir no sliceConfigurations mapa. O setor tem de estar na mesma localização que a política do SIM.
properties.provisioningState

ProvisioningState

O estado de aprovisionamento do recurso de política do SIM.
properties.registrationTimer

integer

3240

Temporizador de atualização de registo periódico da UE (5G) ou temporizador de atualização da área de controlo periódico da UE (4G), em segundos.
properties.rfspIndex

integer

Índice de Prioridade de Seleção RAT/Frequência, definido em TS 36.413 3GPP. Esta é uma definição opcional e, por predefinição, não é especificada.
properties.siteProvisioningState

object

Um dicionário de sites para o estado de aprovisionamento desta política sim nesse site.
properties.sliceConfigurations

SliceConfiguration[]

Os setores permitidos e as definições a utilizar para os mesmos. A lista não pode conter itens duplicados e tem de conter, pelo menos, um item.
properties.ueAmbr

Ambr

Agregar a taxa máxima de bits em todos os fluxos QoS não GBR de todas as sessões de PDU de uma determinada UE. Consulte a secção 3GPP TS23.501 5.7.2.6 para obter uma descrição completa do UE-AMBR.
systemData

systemData

O Azure Resource Manager metadados que contêm informações createdBy e modifiedBy.
tags

object

Etiquetas de recursos.
type

string

O tipo de recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

SliceConfiguration

Definições por setor

Name Tipo Description
dataNetworkConfigurations

DataNetworkConfiguration[]

As redes de dados permitidas e as definições a utilizar para as mesmas. A lista não pode conter itens duplicados e tem de conter, pelo menos, um item.
defaultDataNetwork

DataNetworkResourceId

A rede de dados predefinida a utilizar se a UE não a especificar explicitamente. A configuração deste objeto tem de existir no dataNetworkConfigurations mapa. A rede de dados tem de estar na mesma localização que a política do SIM.
slice

SliceResourceId

Uma referência ao setor a que estas definições se aplicam. O setor tem de estar na mesma localização que a política do SIM.

SliceResourceId

Referência a um recurso de setor.

Name Tipo Description
id

string

Segmentar O ID do recurso.

systemData

Metadados relativos à criação e última modificação do recurso.

Name Tipo Description
createdAt

string

O carimbo de data/hora da criação de recursos (UTC).
createdBy

string

A identidade que criou o recurso.
createdByType

createdByType

O tipo de identidade que criou o recurso.
lastModifiedAt

string

O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy

string

A identidade que modificou o recurso pela última vez.
lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.