Sims - Create Or Update

SIM을 만들거나 업데이트합니다.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MobileNetwork/simGroups/{simGroupName}/sims/{simName}?api-version=2022-04-01-preview

URI 매개 변수

Name In Required Type Description
resourceGroupName
path True
  • string

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

simGroupName
path True
  • string

SIM 그룹의 이름입니다.

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

simName
path True
  • string

SIM의 이름입니다.

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

subscriptionId
path True
  • string

대상 구독의 ID입니다.

api-version
query True
  • string

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

요청 본문

Name Required Type Description
properties.internationalMobileSubscriberIdentity True
  • string

SIM에 대한 IMSI(국제 모바일 구독자 ID)입니다.

properties.authenticationKey
  • string

SIM의 Ki 값입니다.

properties.deviceType
  • string

이 SIM이 연결된 디바이스 유형을 기록하는 데 사용할 수 있는 선택적 자유 형식 텍스트 필드(예: '비디오 카메라')입니다. Azure Portal 사용하면 이 값에 따라 SIM을 그룹화하고 필터링할 수 있습니다.

properties.integratedCircuitCardIdentifier
  • string

SIM에 대한 ICCID(통합 회로 카드 ID)입니다.

properties.operatorKeyCode
  • string

SIM의 Opc 값입니다.

properties.simPolicy

이 SIM에서 사용하는 SIM 정책입니다.

properties.staticIpConfiguration

이 SIM에 할당된 고정 IP 주소 목록입니다. 각 주소는 {연결된 데이터 네트워크, slice}로 구성된 정의된 네트워크 범위에 할당됩니다.

systemData.createdAt
  • string

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

systemData.createdBy
  • string

리소스를 만든 ID입니다.

systemData.createdByType

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

systemData.lastModifiedAt
  • string

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

systemData.lastModifiedBy
  • string

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

systemData.lastModifiedByType

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

응답

Name Type Description
200 OK

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

201 Created

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

Other Status Codes

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

보안

azure_auth

Azure Active Directory OAuth2 Flow.

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

Scopes

Name Description
user_impersonation 사용자 계정 가장

예제

Create SIM

Sample Request

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/simGroups/testSimGroup/sims/testSim?api-version=2022-04-01-preview

{
  "properties": {
    "integratedCircuitCardIdentifier": "8900000000000000000",
    "internationalMobileSubscriberIdentity": "00000",
    "authenticationKey": "00000000000000000000000000000000",
    "operatorKeyCode": "00000000000000000000000000000000",
    "deviceType": "Video camera",
    "simPolicy": {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/MySimPolicy"
    },
    "staticIpConfiguration": [
      {
        "attachedDataNetwork": {
          "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork"
        },
        "slice": {
          "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
        },
        "staticIp": {
          "ipv4Address": "2.4.0.1"
        }
      }
    ]
  }
}

Sample Response

{
  "name": "testSim",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/simGroups/testSimGroup/sims/testSim",
  "type": "Microsoft.MobileNetwork/simGroups/sims",
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "simState": "Enabled",
    "integratedCircuitCardIdentifier": "8900000000000000000",
    "internationalMobileSubscriberIdentity": "00000",
    "deviceType": "Video camera",
    "simPolicy": {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/MySimPolicy"
    },
    "staticIpConfiguration": [
      {
        "attachedDataNetwork": {
          "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork"
        },
        "slice": {
          "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
        },
        "staticIp": {
          "ipv4Address": "2.4.0.1"
        }
      }
    ]
  }
}
{
  "name": "testSim",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/simGroups/testSimGroup/sims/testSim",
  "type": "Microsoft.MobileNetwork/simGroups/sims",
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "simState": "Enabled",
    "integratedCircuitCardIdentifier": "8900000000000000000",
    "internationalMobileSubscriberIdentity": "00000",
    "deviceType": "Video camera",
    "simPolicy": {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/MySimPolicy"
    },
    "staticIpConfiguration": [
      {
        "attachedDataNetwork": {
          "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork"
        },
        "slice": {
          "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
        },
        "staticIp": {
          "ipv4Address": "2.4.0.1"
        }
      }
    ]
  }
}

정의

AttachedDataNetworkResourceId

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

createdByType

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

ErrorAdditionalInfo

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

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

오류 응답

ProvisioningState

현재 프로비전 상태입니다.

Sim

SIM 리소스입니다.

SimPolicyResourceId

SIM 정책 리소스에 대한 참조입니다.

SimState

SIM 리소스의 상태입니다.

SimStaticIpProperties

특정 연결된 데이터 네트워크 및 조각로 범위가 지정된 SIM에 대한 고정 IP 구성입니다.

SliceResourceId

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

StaticIp

정의된 네트워크 범위에서 사용할 SIM의 고정 IP 구성입니다.

systemData

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

AttachedDataNetworkResourceId

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

Name Type Description
id
  • string

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

createdByType

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

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • 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

오류 개체입니다.

ProvisioningState

현재 프로비전 상태입니다.

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

Sim

SIM 리소스입니다.

Name Type Description
id
  • string

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

name
  • string

리소스의 이름입니다.

properties.authenticationKey
  • string

SIM의 Ki 값입니다.

properties.deviceType
  • string

이 SIM이 연결된 디바이스 유형을 기록하는 데 사용할 수 있는 선택적 자유 형식 텍스트 필드(예: '비디오 카메라')입니다. Azure Portal 사용하면 이 값에 따라 SIM을 그룹화하고 필터링할 수 있습니다.

properties.integratedCircuitCardIdentifier
  • string

SIM에 대한 ICCID(통합 회로 카드 ID)입니다.

properties.internationalMobileSubscriberIdentity
  • string

SIM에 대한 IMSI(국제 모바일 구독자 ID)입니다.

properties.operatorKeyCode
  • string

SIM의 Opc 값입니다.

properties.provisioningState

SIM 리소스의 프로비전 상태입니다.

properties.simPolicy

이 SIM에서 사용하는 SIM 정책입니다.

properties.simState

SIM 리소스의 상태입니다.

properties.staticIpConfiguration

이 SIM에 할당된 고정 IP 주소 목록입니다. 각 주소는 {연결된 데이터 네트워크, slice}로 구성된 정의된 네트워크 범위에 할당됩니다.

systemData

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

systemData.createdAt
  • string

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

systemData.createdBy
  • string

리소스를 만든 ID입니다.

systemData.createdByType

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

systemData.lastModifiedAt
  • string

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

systemData.lastModifiedBy
  • string

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

systemData.lastModifiedByType

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

type
  • string

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

SimPolicyResourceId

SIM 정책 리소스에 대한 참조입니다.

Name Type Description
id
  • string

SIM 정책 리소스 ID입니다.

SimState

SIM 리소스의 상태입니다.

Name Type Description
Disabled
  • string

사용하도록 설정하는 데 필요한 모든 구성이 없기 때문에 SIM을 사용할 수 없습니다.

Enabled
  • string

SIM을 사용할 수 있습니다.

Invalid
  • string

연결된 구성 중 일부가 잘못되었으므로 SIM을 사용하도록 설정할 수 없습니다.

SimStaticIpProperties

특정 연결된 데이터 네트워크 및 조각로 범위가 지정된 SIM에 대한 고정 IP 구성입니다.

Name Type Description
attachedDataNetwork

고정 IP 주소를 사용할 연결된 데이터 네트워크입니다. 연결된 데이터 네트워크와 조각의 조합은 IP 주소의 네트워크 범위를 정의합니다.

slice

고정 IP 주소를 사용할 네트워크 조각입니다. 연결된 데이터 네트워크와 조각의 조합은 IP 주소의 네트워크 범위를 정의합니다.

staticIp

정의된 네트워크 범위에서 사용할 SIM의 고정 IP 구성입니다.

SliceResourceId

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

Name Type Description
id
  • string

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

StaticIp

정의된 네트워크 범위에서 사용할 SIM의 고정 IP 구성입니다.

Name Type Description
ipv4Address
  • string

이 네트워크 범위에서 SIM에 할당된 IPv4 주소입니다. 이 주소는 연결된 데이터 네트워크에 정의된 userEquipmentStaticAddressPoolPrefix에 있어야 합니다.

systemData

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

Name Type Description
createdAt
  • string

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

createdBy
  • string

리소스를 만든 ID입니다.

createdByType

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

lastModifiedAt
  • string

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

lastModifiedBy
  • string

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

lastModifiedByType

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