共用方式為


Sims - Bulk Upload Encrypted

以加密形式大量上傳 SIM 至 SIM 群組。 SIM 認證必須加密。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MobileNetwork/simGroups/{simGroupName}/uploadEncryptedSims?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_-]*$

subscriptionId
path True

string

uuid

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

api-version
query True

string

用於此作業的 API 版本。

要求本文

名稱 必要 類型 Description
azureKeyIdentifier True

integer

用於加密上傳的 Azure SIM 卡上線公鑰標識碼。

encryptedTransportKey True

string

用於加密 SIM 認證的傳輸金鑰,使用 SIM 卡上線公鑰進行加密。

signedTransportKey True

string

使用 SIM 廠商私鑰簽署的加密傳輸金鑰。

sims True

SimNameAndEncryptedProperties[]

要上傳的 SIM 清單,其中包含加密的屬性。

vendorKeyFingerprint True

string

SIM 廠商公鑰的指紋。 私用對應專案用於簽署加密傳輸金鑰。

version True

integer

上傳檔案格式版本。

回應

名稱 類型 Description
200 OK

AsyncOperationStatus

異步操作已完成。

202 Accepted

已接受。 傳回可查詢以尋找作業目前狀態的作業 URI。

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 模擬您的用戶帳戶

範例

Bulk upload encrypted SIMs to a SIM group

範例要求

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

{
  "version": 1,
  "azureKeyIdentifier": 1,
  "vendorKeyFingerprint": "ABC123",
  "encryptedTransportKey": "ABC123",
  "signedTransportKey": "ABC123",
  "sims": [
    {
      "name": "testSim",
      "properties": {
        "integratedCircuitCardIdentifier": "8900000000000000000",
        "internationalMobileSubscriberIdentity": "00000",
        "encryptedCredentials": "ABC123",
        "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": "testSim2",
      "properties": {
        "integratedCircuitCardIdentifier": "8900000000000000001",
        "internationalMobileSubscriberIdentity": "00000",
        "encryptedCredentials": "ABC123",
        "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.2"
            }
          }
        ]
      }
    }
  ]
}

範例回覆

{
  "id": "/providers/Microsoft.MobileNetwork/locations/testLocation/operationStatuses/testOperation",
  "name": "testOperation",
  "status": "Succeeded",
  "startTime": "2021-08-19T03:36:07.000Z",
  "endTime": "2021-08-19T03:38:07.000Z"
}
Azure-AsyncOperation: https://management.azure.com/providers/Microsoft.MobileNetwork/locations/testLocation/operationStatuses/testOperation?api-version=2024-04-01

定義

名稱 Description
AsyncOperationStatus

異步操作的目前狀態。

AttachedDataNetworkResourceId

鏈接數據網路資源的參考。

EncryptedSimUploadList

要上傳的 SIM。 SIM 認證必須加密。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

ErrorDetail

錯誤詳細數據。

ErrorResponse

錯誤回應

ProvisioningState

目前的布建狀態。

SimNameAndEncryptedProperties

SIM 名稱和加密屬性。

SimPolicyResourceId

SIM 原則資源的參考。

SimState

SIM 資源的狀態。

SimStaticIpProperties

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

SliceResourceId

配量資源的參考。

StaticIp

要用於已定義網路範圍的 SIM 卡靜態 IP 組態。

AsyncOperationStatus

異步操作的目前狀態。

名稱 類型 Description
endTime

string

作業的結束時間。

error

ErrorDetail

如果有,作業錯誤的詳細數據。

id

string

異步操作的完整標識碼。

name

string

異步操作的名稱。

percentComplete

number

完成作業的百分比。

properties

object

在成功作業上由資源提供者傳回的屬性

resourceId

string

這個異步操作狀態與資源的完整標識符相關。

startTime

string

作業的開始時間。

status

string

作業狀態。

AttachedDataNetworkResourceId

鏈接數據網路資源的參考。

名稱 類型 Description
id

string

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

EncryptedSimUploadList

要上傳的 SIM。 SIM 認證必須加密。

名稱 類型 Description
azureKeyIdentifier

integer

用於加密上傳的 Azure SIM 卡上線公鑰標識碼。

encryptedTransportKey

string

用於加密 SIM 認證的傳輸金鑰,使用 SIM 卡上線公鑰進行加密。

signedTransportKey

string

使用 SIM 廠商私鑰簽署的加密傳輸金鑰。

sims

SimNameAndEncryptedProperties[]

要上傳的 SIM 清單,其中包含加密的屬性。

vendorKeyFingerprint

string

SIM 廠商公鑰的指紋。 私用對應專案用於簽署加密傳輸金鑰。

version

integer

上傳檔案格式版本。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱 類型 Description
info

object

其他資訊。

type

string

其他信息類型。

ErrorDetail

錯誤詳細數據。

名稱 類型 Description
additionalInfo

ErrorAdditionalInfo[]

錯誤其他資訊。

code

string

錯誤碼。

details

ErrorDetail[]

錯誤詳細資料。

message

string

錯誤訊息。

target

string

錯誤目標。

ErrorResponse

錯誤回應

名稱 類型 Description
error

ErrorDetail

錯誤物件。

ProvisioningState

目前的布建狀態。

名稱 類型 Description
Accepted

string

Canceled

string

Deleted

string

Deleting

string

Failed

string

Succeeded

string

Unknown

string

SimNameAndEncryptedProperties

SIM 名稱和加密屬性。

名稱 類型 Description
name

string

SIM 的名稱。

properties.deviceType

string

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

properties.encryptedCredentials

string

加密的 SIM 認證。

properties.integratedCircuitCardIdentifier

string

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

properties.internationalMobileSubscriberIdentity

string

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

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 廠商名稱。

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 中。