다음을 통해 공유

Sim Policies - Create Or Update

  • 참조
서비스:
Mobile Network
API 버전:
2024-04-01

SIM 정책을 만들거나 업데이트합니다. 부모 모바일 네트워크와 동일한 위치에 만들어야 합니다.

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
mobileNetworkName
 path True

string

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

모바일 네트워크의 이름입니다.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

리소스 그룹의 이름입니다. 이름은 대/소문자를 구분하지 않습니다.
simPolicyName
 path True

string

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

SIM 정책의 이름입니다.
subscriptionId
 path True

string (uuid)

대상 구독의 ID입니다. 값은 UUID여야 합니다.
api-version
 query True

string

minLength: 1

이 작업에 사용할 API 버전입니다.

요청 본문

Name 필수 형식 Description
location True

string

리소스가 있는 지리적 위치
properties.defaultSlice True

SliceResourceId

UE에서 명시적으로 지정하지 않는 경우 사용할 기본 조각입니다. 이 조각은 sliceConfigurations 맵에 있어야 합니다. 조각은 SIM 정책과 동일한 위치에 있어야 합니다.
properties.sliceConfigurations True

SliceConfiguration[]

허용되는 조각 및 조각에 사용할 설정입니다. 목록에 중복 항목이 포함되어서는 안 되며 하나 이상의 항목이 포함되어야 합니다.
properties.ueAmbr True

Ambr

지정된 UE의 모든 PDU 세션의 모든 비GBR QoS 흐름에서 최대 비트 전송률을 집계합니다. UE-AMBR에 대한 전체 설명은 3GPP TS23.501 섹션 5.7.2.6을 참조하세요.
properties.registrationTimer

integer (int32)

minimum: 30

UE 정기적인 등록 업데이트 타이머(5G) 또는 UE 주기적 추적 영역 업데이트 타이머(4G)(초).
properties.rfspIndex

integer (int32)

minimum: 1
maximum: 256

3GPP TS 36.413에 정의된 RAT/빈도 선택 우선 순위 인덱스입니다. 이는 선택적 설정이며 기본적으로 지정되지 않습니다.
tags

object

리소스 태그.

응답

Name 형식 Description
200 OK

SimPolicy

업데이트에 성공했습니다. 이 작업은 결과 SIM 정책 리소스를 반환합니다.
201 Created

SimPolicy

성공적으로 만듭니다. 이 작업은 결과 SIM 정책 리소스를 반환합니다.
Other Status Codes

ErrorResponse

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

Create SIM policy

샘플 요청

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

샘플 응답

상태 코드:
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
          }
        ]
      }
    ]
  }
}
상태 코드:
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
          }
        ]
      }
    ]
  }
}

정의

Name Description
Ambr

최대 비트 속도를 집계합니다.
createdByType

리소스를 만든 ID의 형식입니다.
DataNetworkConfiguration

데이터 네트워크 사용을 제어하는 설정
DataNetworkResourceId

데이터 네트워크 리소스에 대한 참조입니다.
ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.
ErrorDetail

오류 세부 정보입니다.
ErrorResponse

오류 응답
PduSessionType

PDU 세션 유형(IPv4/IPv6).
PreemptionCapability

선점 기능.
PreemptionVulnerability

선점 취약성.
ProvisioningState

현재 프로비저닝 상태입니다.
ServiceResourceId

서비스 리소스에 대한 참조입니다.
SimPolicy

SIM 정책 리소스입니다.
SliceConfiguration

조각별 설정
SliceResourceId

조각 리소스에 대한 참조입니다.
systemData

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Ambr

Object

최대 비트 속도를 집계합니다.

Name 형식 Description
downlink

string

pattern: ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$

다운링크 비트 속도입니다.
uplink

string

pattern: ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$

업링크 비트 속도입니다.

createdByType

열거형

리소스를 만든 ID의 형식입니다.

값 Description
Application
Key
ManagedIdentity
User

DataNetworkConfiguration

Object

데이터 네트워크 사용을 제어하는 설정

Name 형식 Default value Description
5qi

integer (int32)

minimum: 0
maximum: 255 		9

기본 5G QoS 흐름 표시기 값입니다. 5QI는 흐름에 제공할 특정 QoS 전달 처리를 식별합니다. 5QI 매개 변수에 대한 전체 설명은 3GPP TS23.501 섹션 5.7.2.1을 참조하고, 5QI 값 정의에 대한 표 5.7.4-1을 참조하세요.
additionalAllowedSessionTypes

PduSessionType[]

기본 세션 유형 외에도 허용되는 세션 형식입니다. 기본 세션 형식을 복제해서는 안됩니다.
allocationAndRetentionPriorityLevel

integer (int32)

minimum: 1
maximum: 15 		9

기본 QoS 흐름 할당 및 보존 우선 순위(ARP) 수준입니다. preemptionCapability 및 preemptionVulnerability 설정에서 허용하는 경우 우선 순위가 높은 흐름은 우선 순위가 낮은 흐름을 선점합니다. 1은 가장 높은 수준의 우선 순위입니다. 이 필드를 지정하지 않으면 5qi ARP 값을 파생하는 데 사용됩니다. ARP 매개 변수에 대한 전체 설명은 3GPP TS23.501 섹션 5.7.2.2를 참조하세요.
allowedServices

ServiceResourceId[]

이 SIM 정책의 일부로 사용할 수 있는 서비스 목록입니다. 목록에 중복 항목이 포함되어서는 안 되며 하나 이상의 항목이 포함되어야 합니다. 서비스는 SIM 정책과 동일한 위치에 있어야 합니다.
dataNetwork

DataNetworkResourceId

이러한 설정이 적용되는 데이터 네트워크에 대한 참조입니다. 데이터 네트워크는 SIM 정책과 동일한 위치에 있어야 합니다.
defaultSessionType

PduSessionType

IPv4

UE가 특정 세션 형식을 요청하지 않는 경우 사용되는 기본 PDU 세션 형식입니다.
maximumNumberOfBufferedPackets

integer (int32)

minimum: 0 		10

긴 대기 시간 통신 - 확장 버퍼링을 위해 사용자 평면에서 버퍼링할 최대 다운링크 패킷 수입니다. 전체 설명은 3GPP TS29.272 v15.10.0 섹션 7.3.188을 참조하세요. 모든 PDU 세션에서 버퍼링된 패킷에 대한 내부 제한이 있기 때문에 이 최대값은 보장되지 않습니다.
preemptionCapability

PreemptionCapability

NotPreempt

기본 QoS 흐름 선점 기능입니다. QoS Flow의 선점 기능은 우선 순위 수준이 낮은 다른 QoS Flow를 선점할 수 있는지 여부를 제어합니다. ARP 매개 변수에 대한 전체 설명은 3GPP TS23.501 섹션 5.7.2.2를 참조하세요.
preemptionVulnerability

PreemptionVulnerability

Preemptable

기본 QoS 흐름 선점 취약성. QoS 흐름의 선점 취약성은 우선 순위 수준이 높은 QoS Flow에서 선점할 수 있는지 여부를 제어합니다. ARP 매개 변수에 대한 전체 설명은 3GPP TS23.501 섹션 5.7.2.2를 참조하세요.
sessionAmbr

Ambr

지정된 PDU 세션의 모든 비GBR QoS 흐름에서 최대 비트 전송률을 집계합니다. Session-AMBR에 대한 전체 설명은 3GPP TS23.501 섹션 5.7.2.6을 참조하세요.

DataNetworkResourceId

Object

데이터 네트워크 리소스에 대한 참조입니다.

Name 형식 Description
id

string

pattern: ^/[sS][uU][bB][sS][cC][rR][iI][pP][tT][iI][oO][nN][sS]/[^/?#]+/[rR][eE][sS][oO][uU][rR][cC][eE][gG][rR][oO][uU][pP][sS]/[^/?#]+/[pP][rR][oO][vV][iI][dD][eE][rR][sS]/[mM][iI][cC][rR][oO][sS][oO][fF][tT]\.[mM][oO][bB][iI][lL][eE][nN][eE][tT][wW][oO][rR][kK]/[mM][oO][bB][iI][lL][eE][nN][eE][tT][wW][oO][rR][kK][sS]/[^/?#]+/[dD][aA][tT][aA][nN][eE][tT][wW][oO][rR][kK][sS]/[^/?#]+$

데이터 네트워크 리소스 ID입니다.

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.
type

string

추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.
code

string

오류 코드입니다.
details

ErrorDetail[]

오류 세부 정보입니다.
message

string

오류 메시지입니다.
target

string

오류 대상입니다.

ErrorResponse

Object

오류 응답

Name 형식 Description
error

ErrorDetail

오류 개체입니다.

PduSessionType

열거형

PDU 세션 유형(IPv4/IPv6).

값 Description
IPv4
IPv6

PreemptionCapability

열거형

선점 기능.

값 Description
MayPreempt

5월 선점
NotPreempt

선점할 수 없음

PreemptionVulnerability

열거형

선점 취약성.

값 Description
NotPreemptable

선점할 수 없음
Preemptable

선점될 수 있음

ProvisioningState

열거형

현재 프로비저닝 상태입니다.

값 Description
Accepted
Canceled
Deleted
Deleting
Failed
Succeeded
Unknown

ServiceResourceId

Object

서비스 리소스에 대한 참조입니다.

Name 형식 Description
id

string

pattern: ^/[sS][uU][bB][sS][cC][rR][iI][pP][tT][iI][oO][nN][sS]/[^/?#]+/[rR][eE][sS][oO][uU][rR][cC][eE][gG][rR][oO][uU][pP][sS]/[^/?#]+/[pP][rR][oO][vV][iI][dD][eE][rR][sS]/[mM][iI][cC][rR][oO][sS][oO][fF][tT]\.[mM][oO][bB][iI][lL][eE][nN][eE][tT][wW][oO][rR][kK]/[mM][oO][bB][iI][lL][eE][nN][eE][tT][wW][oO][rR][kK][sS]/[^/?#]+/[sS][eE][rR][vV][iI][cC][eE][sS]/[^/?#]+$

서비스 리소스 ID입니다.

SimPolicy

Object

SIM 정책 리소스입니다.

Name 형식 Default value Description
id

string (arm-id)

리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location

string

리소스가 있는 지리적 위치
name

string

리소스의 이름
properties.defaultSlice

SliceResourceId

UE에서 명시적으로 지정하지 않는 경우 사용할 기본 조각입니다. 이 조각은 sliceConfigurations 맵에 있어야 합니다. 조각은 SIM 정책과 동일한 위치에 있어야 합니다.
properties.provisioningState

ProvisioningState

SIM 정책 리소스의 프로비전 상태입니다.
properties.registrationTimer

integer (int32)

minimum: 30 		3240

UE 정기적인 등록 업데이트 타이머(5G) 또는 UE 주기적 추적 영역 업데이트 타이머(4G)(초).
properties.rfspIndex

integer (int32)

minimum: 1
maximum: 256

3GPP TS 36.413에 정의된 RAT/빈도 선택 우선 순위 인덱스입니다. 이는 선택적 설정이며 기본적으로 지정되지 않습니다.
properties.siteProvisioningState

object

해당 사이트에서 이 SIM 정책의 프로비저닝 상태에 대한 사이트 사전입니다.
properties.sliceConfigurations

SliceConfiguration[]

허용되는 조각 및 조각에 사용할 설정입니다. 목록에 중복 항목이 포함되어서는 안 되며 하나 이상의 항목이 포함되어야 합니다.
properties.ueAmbr

Ambr

지정된 UE의 모든 PDU 세션의 모든 비GBR QoS 흐름에서 최대 비트 전송률을 집계합니다. UE-AMBR에 대한 전체 설명은 3GPP TS23.501 섹션 5.7.2.6을 참조하세요.
systemData

systemData

createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.
tags

object

리소스 태그.
type

string

리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

SliceConfiguration

Object

조각별 설정

Name 형식 Description
dataNetworkConfigurations

DataNetworkConfiguration[]

허용되는 데이터 네트워크 및 해당 네트워크에 사용할 설정입니다. 목록에 중복 항목이 포함되어서는 안 되며 하나 이상의 항목이 포함되어야 합니다.
defaultDataNetwork

DataNetworkResourceId

UE에서 명시적으로 지정하지 않는 경우 사용할 기본 데이터 네트워크입니다. 이 개체에 대한 구성은 dataNetworkConfigurations 맵에 있어야 합니다. 데이터 네트워크는 SIM 정책과 동일한 위치에 있어야 합니다.
slice

SliceResourceId

이러한 설정이 적용되는 조각에 대한 참조입니다. 조각은 SIM 정책과 동일한 위치에 있어야 합니다.

SliceResourceId

Object

조각 리소스에 대한 참조입니다.

Name 형식 Description
id

string

pattern: ^/[sS][uU][bB][sS][cC][rR][iI][pP][tT][iI][oO][nN][sS]/[^/?#]+/[rR][eE][sS][oO][uU][rR][cC][eE][gG][rR][oO][uU][pP][sS]/[^/?#]+/[pP][rR][oO][vV][iI][dD][eE][rR][sS]/[mM][iI][cC][rR][oO][sS][oO][fF][tT]\.[mM][oO][bB][iI][lL][eE][nN][eE][tT][wW][oO][rR][kK]/[mM][oO][bB][iI][lL][eE][nN][eE][tT][wW][oO][rR][kK][sS]/[^/?#]+/[sS][lL][iI][cC][eE][sS]/[^/?#]+$

리소스 ID를 조각화합니다.

systemData

Object

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name 형식 Description
createdAt

string (date-time)

리소스 만들기의 타임스탬프(UTC)입니다.
createdBy

string

리소스를 만든 ID입니다.
createdByType

createdByType

리소스를 만든 ID의 형식입니다.
lastModifiedAt

string (date-time)

리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy

string

리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType

createdByType

리소스를 마지막으로 수정한 ID의 형식입니다.