다음을 통해 공유

Sims - Create Or Update

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

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

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

URI 매개 변수

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

string

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

string

SIM 그룹의 이름입니다.

regex 패턴: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$
simName
 path True

string

SIM의 이름입니다.

regex 패턴: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$
subscriptionId
 path True

string

uuid

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

string

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

요청 본문

Name 필수 형식 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

SimPolicyResourceId

이 SIM에서 사용하는 SIM 정책입니다. SIM 정책은 SIM과 동일한 위치에 있어야 합니다.
properties.staticIpConfiguration

SimStaticIpProperties[]

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

응답

Name 형식 Description
200 OK

Sim

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

Sim

Create 성공했습니다. 작업은 결과 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

샘플 요청

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/simGroups/testSimGroup/sims/testSim?api-version=2024-04-01

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

샘플 응답

상태 코드:
200 
{
  "name": "testSim",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/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",
    "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"
    },
    "integratedCircuitCardIdentifier": "8900000000000000000",
    "internationalMobileSubscriberIdentity": "00000",
    "deviceType": "Video camera",
    "simPolicy": {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/MySimPolicy"
    },
    "staticIpConfiguration": [
      {
        "attachedDataNetwork": {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork"
        },
        "slice": {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
        },
        "staticIp": {
          "ipv4Address": "2.4.0.1"
        }
      }
    ]
  }
}
상태 코드:
201 
Azure-AsyncOperation: https://management.azure.com/providers/Microsoft.MobileNetwork/locations/testLocation/operationStatuses/testOperation?api-version=2024-04-01
{
  "name": "testSim",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/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": "Created",
    "simState": "Enabled",
    "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"
    },
    "integratedCircuitCardIdentifier": "8900000000000000000",
    "internationalMobileSubscriberIdentity": "00000",
    "deviceType": "Video camera",
    "simPolicy": {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/MySimPolicy"
    },
    "staticIpConfiguration": [
      {
        "attachedDataNetwork": {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork"
        },
        "slice": {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
        },
        "staticIp": {
          "ipv4Address": "2.4.0.1"
        }
      }
    ]
  }
}

정의

Name Description
AttachedDataNetworkResourceId

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

리소스를 만든 ID 유형입니다.
ErrorAdditionalInfo

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

오류 세부 정보입니다.
ErrorResponse

오류 응답
ProvisioningState

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

SIM 리소스.
SimPolicyResourceId

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

SIM 리소스의 상태입니다.
SimStaticIpProperties

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

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

정의된 네트워크 scope 사용할 SIM의 고정 IP 구성입니다.
systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

AttachedDataNetworkResourceId

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

Name 형식 Description
id

string

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

createdByType

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

Name 형식 Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

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

Name 형식 Description
info

object

추가 정보입니다.
type

string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.
code

string

오류 코드입니다.
details

ErrorDetail[]

오류 세부 정보입니다.
message

string

오류 메시지입니다.
target

string

오류 대상입니다.

ErrorResponse

오류 응답

Name 형식 Description
error

ErrorDetail

Error 개체.

ProvisioningState

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

Name 형식 Description
Accepted

string

Canceled

string

Deleted

string

Deleting

string

Failed

string

Succeeded

string

Unknown

string

Sim

SIM 리소스.

Name 형식 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

ProvisioningState

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

SimPolicyResourceId

이 SIM에서 사용하는 SIM 정책입니다. SIM 정책은 SIM과 동일한 위치에 있어야 합니다.
properties.simState

SimState

SIM 리소스의 상태입니다.
properties.siteProvisioningState

object

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

SimStaticIpProperties[]

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

string

이 SIM을 제공한 SIM 공급업체의 공개 키 지문 있습니다(있는 경우).
properties.vendorName

string

이 SIM을 제공한 SIM 공급업체의 이름(있는 경우)입니다.
systemData

systemData

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

string

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

SimPolicyResourceId

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

Name 형식 Description
id

string

SIM 정책 리소스 ID입니다.

SimState

SIM 리소스의 상태입니다.

Name 형식 Description
Disabled

string

사용하도록 설정하는 데 필요한 모든 구성이 없으므로 SIM을 사용할 수 없습니다.
Enabled

string

SIM을 사용할 수 있습니다.
Invalid

string

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

SimStaticIpProperties

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

Name 형식 Description
attachedDataNetwork

AttachedDataNetworkResourceId

고정 IP 주소를 사용할 연결된 데이터 네트워크입니다. 연결된 데이터 네트워크와 조각의 조합은 IP 주소의 네트워크 scope 정의합니다. 연결된 데이터 네트워크는 SIM과 동일한 위치에 있어야 합니다.
slice

SliceResourceId

고정 IP 주소를 사용할 네트워크 조각입니다. 연결된 데이터 네트워크와 조각의 조합은 IP 주소의 네트워크 scope 정의합니다. 조각은 SIM과 동일한 위치에 있어야 합니다.
staticIp

StaticIp

정의된 네트워크 scope 사용할 SIM의 고정 IP 구성입니다.

SliceResourceId

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

Name 형식 Description
id

string

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

StaticIp

정의된 네트워크 scope 사용할 SIM의 고정 IP 구성입니다.

Name 형식 Description
ipv4Address

string

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

systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

Name 형식 Description
createdAt

string

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

string

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

createdByType

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

string

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

string

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

createdByType

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