共用方式為


Sims - Create Or Update

建立或更新 SIM 卡。

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

URI 參數

名稱 位於 必要 類型 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

目標訂用帳戶的標識碼。 此值必須是 UUID。

api-version
query True

string

用於此作業的 API 版本。

要求本文

名稱 必要 類型 Description
properties.internationalMobileSubscriberIdentity True

string

SIM 卡的國際行動裝置訂閱者身分識別 (IMSI) 。

properties.authenticationKey

string

SIM 卡的 Ki 值。

properties.deviceType

string

選擇性自由格式文字欄位,可用來錄製與此 SIM 卡相關聯的裝置類型,例如「視訊相機」。 Azure 入口網站 允許根據此值來分組和篩選 SIM。

properties.integratedCircuitCardIdentifier

string

SIM 卡的整合卡標識碼 () 。

properties.operatorKeyCode

string

SIM 卡的 Opc 值。

properties.simPolicy

SimPolicyResourceId

此 SIM 卡所使用的 SIM 原則。 SIM 原則必須位於與 SIM 卡相同的位置。

properties.staticIpConfiguration

SimStaticIpProperties[]

指派給此 SIM 卡的靜態 IP 位址清單。 每個地址都會在定義的網路範圍指派,由 {附加的數據網路、配量}組成。

回應

名稱 類型 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

範圍

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

範例回覆

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

定義

名稱 Description
AttachedDataNetworkResourceId

附加數據網路資源的參考。

createdByType

建立資源的身分識別類型。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

ErrorDetail

錯誤詳細數據。

ErrorResponse

錯誤回應

ProvisioningState

目前的布建狀態。

Sim

SIM 資源。

SimPolicyResourceId

SIM 卡原則資源的參考。

SimState

SIM 資源的狀態。

SimStaticIpProperties

SIM 卡的靜態 IP 組態,範圍限定於特定的鏈接數據網路和配量。

SliceResourceId

配量資源的參考。

StaticIp

SIM 卡在定義的網路範圍中使用的靜態 IP 組態。

systemData

與建立和上次修改資源相關的元數據。

AttachedDataNetworkResourceId

附加數據網路資源的參考。

名稱 類型 Description
id

string

鏈接的數據網路資源標識碼。

createdByType

建立資源的身分識別類型。

名稱 類型 Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱 類型 Description
info

object

其他資訊。

type

string

其他信息類型。

ErrorDetail

錯誤詳細數據。

名稱 類型 Description
additionalInfo

ErrorAdditionalInfo[]

錯誤其他資訊。

code

string

錯誤碼。

details

ErrorDetail[]

錯誤詳細資料。

message

string

錯誤訊息。

target

string

錯誤目標。

ErrorResponse

錯誤回應

名稱 類型 Description
error

ErrorDetail

error 物件。

ProvisioningState

目前的布建狀態。

名稱 類型 Description
Accepted

string

Canceled

string

Deleted

string

Deleting

string

Failed

string

Succeeded

string

Unknown

string

Sim

SIM 資源。

名稱 類型 Description
id

string

資源的完整資源識別碼。 例如“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”

name

string

資源的名稱

properties.authenticationKey

string

SIM 卡的 Ki 值。

properties.deviceType

string

選擇性自由格式文字欄位,可用來錄製與此 SIM 卡相關聯的裝置類型,例如「視訊相機」。 Azure 入口網站 允許根據此值來分組和篩選 SIM。

properties.integratedCircuitCardIdentifier

string

SIM 卡的整合卡標識碼 () 。

properties.internationalMobileSubscriberIdentity

string

SIM 卡的國際行動裝置訂閱者身分識別 (IMSI) 。

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 位址清單。 每個地址都會在定義的網路範圍指派,由 {附加的數據網路、配量}組成。

properties.vendorKeyFingerprint

string

如果有的話,提供此 SIM 卡之 SIM 廠商的公鑰指紋。

properties.vendorName

string

如果有的話,提供此 SIM 卡的 SIM 廠商名稱。

systemData

systemData

Azure Resource Manager 包含 createdBy 和 modifiedBy 資訊的中繼資料。

type

string

資源類型。 例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts”

SimPolicyResourceId

SIM 卡原則資源的參考。

名稱 類型 Description
id

string

SIM 原則資源識別碼。

SimState

SIM 資源的狀態。

名稱 類型 Description
Disabled

string

SIM 卡已停用,因為並非所有啟用所需的設定都存在。

Enabled

string

已啟用 SIM 卡。

Invalid

string

無法啟用 SIM 卡,因為某些相關聯的組態無效。

SimStaticIpProperties

SIM 卡的靜態 IP 組態,範圍限定於特定的鏈接數據網路和配量。

名稱 類型 Description
attachedDataNetwork

AttachedDataNetworkResourceId

將使用靜態IP位址的附加資料網路。 鏈接數據網路和配量的組合會定義IP位址的網路範圍。 連接的數據網路必須位於與 SIM 卡相同的位置。

slice

SliceResourceId

將使用靜態IP位址的網路配量。 鏈接數據網路和配量的組合會定義IP位址的網路範圍。 配量必須位於與 SIM 卡相同的位置。

staticIp

StaticIp

SIM 卡在定義的網路範圍中使用的靜態 IP 組態。

SliceResourceId

配量資源的參考。

名稱 類型 Description
id

string

配量資源標識碼。

StaticIp

SIM 卡在定義的網路範圍中使用的靜態 IP 組態。

名稱 類型 Description
ipv4Address

string

在此網路範圍指派給 SIM 卡的 IPv4 位址。 此位址必須位於鏈接數據網路中定義的userEquipmentStaticAddressPoolPrefix 中。

systemData

與建立和上次修改資源相關的元數據。

名稱 類型 Description
createdAt

string

資源建立的時間戳 (UTC) 。

createdBy

string

建立資源的身分識別。

createdByType

createdByType

建立資源的身分識別類型。

lastModifiedAt

string

上次修改的資源時間戳 (UTC)

lastModifiedBy

string

上次修改資源的身分識別。

lastModifiedByType

createdByType

上次修改資源的身分識別類型。